DSH 需要你批准操作、回答提问或审批计划时,弹出 Windows 系统通知并播放提示音;原生通知失败时退回自绘卡片。
安装
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:Dvva/dsh-alert
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
DSH 授权 / 提问提醒插件 —— 当 DSH 停下来等你时,用 Windows 系统通知 + 提示音把你叫回来。
DSH 需要你批准操作、回答提问或审批计划时会静默等待。窗口不在前台时,你很可能完全不知道。 这个插件在那一刻弹出系统通知并播放提示音,避免任务卡在后台无人处理。
特性
| 会话事件 | 触发提醒 |
|---|---|
approval/asked |
DSH 需要你授权一个操作 |
tool/call = ask_user_question |
DSH 在等你回答问题 |
tool/call = exit_plan_mode |
计划审批 |
- 双通道:优先发 Windows 原生 Toast(走通知中心);发送失败时自动退回右下角自绘卡片,保证不漏。
- 提示音可换:默认用系统 wav,支持自定义路径或外部播放器。
- 可精细关闭:按触发类型、按通道(只响 / 只弹 / 都弹)单独开关。
- 零依赖:只用 Node 内置模块,不额外拉包。
安装
仅支持 Windows,需要 DSH 桌面端(内置 Electron)。插件运行在 DSH 宿主进程里,因此能正常发送系统通知。
第 1 步:注册系统通知身份(只需一次)
Windows 10 的 WinRT 通知要求未打包程序先有 AUMID,否则报 0x80073D54 no package identity。
把下面整段粘进 Windows PowerShell 5.1(不是 pwsh 7)执行:
$id = 'Dsh.Alert'
$dir = Join-Path $env:APPDATA 'Microsoft\Windows\Start Menu\Programs'
$lnk = Join-Path $dir 'DSH Alert.lnk'
# 1) 开始菜单占位快捷方式(通知身份需要它指到一个真实入口)
$ws = New-Object -ComObject WScript.Shell
$sc = $ws.CreateShortcut($lnk)
$sc.TargetPath = "$env:SystemRoot\System32\WindowsPowerShell\v1.0\powershell.exe"
$sc.Arguments = '-NoProfile -WindowStyle Hidden -Command "$null"'
$sc.Save()
# 2) 注册 AUMID
New-Item -Path "HKCU:\Software\Classes\AppUserModelId\$id" -Force | Out-Null
Set-ItemProperty -Path "HKCU:\Software\Classes\AppUserModelId\$id" -Name DisplayName -Value 'DSH 提醒'
Set-ItemProperty -Path "HKCU:\Software\Classes\AppUserModelId\$id" -Name IconUri `
-Value "$env:SystemRoot\System32\WindowsPowerShell\v1.0\powershell.exe"
第 2 步:装进 profile
# 方式 A:dsh 命令(link 安装,保留源码目录可编辑)
dsh plugin add --profile desktop link:<本仓库绝对路径>
# 方式 B:手工
# 把整个仓库目录复制到 %USERPROFILE%\.dsh\profiles\desktop\node_modules\dsh-alert
# 然后在该 profile 的 cordis.patch.yml 末尾追加:
# - insert:
# - id: dsh-alert
# name: dsh-alert
第 3 步:重启 DSH
插件在启动时合成,重启后生效。
配置
可选文件:$DSH_HOME/.dsh-alert.json(默认 %USERPROFILE%\.dsh\.dsh-alert.json)。
不写则全部使用默认值。
{
"enabled": true,
"mode": "toast",
"toast": true,
"fallbackPopup": true,
"sound": true,
"durationMs": 6000,
"triggers": { "approval": true, "question": true },
"sounds": {
"approval": "C:\\Windows\\Media\\Windows Exclamation.wav",
"question": "C:\\Windows\\Media\\Windows Notify.wav"
},
"playerCommand": "",
"minIntervalMs": 3000
}
| 字段 | 说明 |
|---|---|
enabled |
总开关 |
mode |
toast(系统通知,失败自动退回卡片)/ popup(只弹右下角卡片)/ sound(只响) |
toast |
是否尝试系统通知 |
fallbackPopup |
Toast 失败时是否弹卡片 |
sound |
是否播放提示音 |
durationMs |
卡片停留时长(毫秒) |
triggers.approval |
授权请求是否提醒 |
triggers.question |
提问 / 计划审批是否提醒 |
sounds.approval / sounds.question |
提示音 wav 路径 |
playerCommand |
改用外部播放器,%file% 为占位符,如 ffplay -nodisp -autoexit "%file%" |
minIntervalMs |
两次提醒的最小间隔,防轰炸(默认 3000) |
工作原理
DSH 会话事件
├─ approval/asked ─┐
├─ tool/call(ask_user_question)├─→ 节流 → 播放提示音 → WinRT Toast
└─ tool/call(exit_plan_mode) ─┘ └─ 失败 → 右下角卡片
- 通知由宿主进程(DSH 主进程)里的
powershell.exe(5.1)调用 WinRT 发送; - 沙箱内进程发不了系统通知(受限令牌),插件因此运行在宿主侧;
- 所有失败路径都退到自绘卡片,不会静默失败。
兼容性
| 项 | 要求 |
|---|---|
| 操作系统 | Windows 10 / 11 |
| DSH | 桌面端(Electron,宿主进程) |
| PowerShell | 系统自带 5.1(pwsh 7 缺少 WinRT 引用,插件已硬编码 5.1 路径) |
| Node | ≥ 20(仅开发/调试需要) |
常见问题
没看到通知 / 没声音?
- 确认
设置 → 系统 → 通知没有被关闭,且未开启「专注助手」; - 确认第 1 步 AUMID 已注册(注册表
HKCU\Software\Classes\AppUserModelId\Dsh.Alert存在); - 把
mode临时改成popup,排除 Toast 通道问题; - 检查是否命中
minIntervalMs节流。
提示音想换成自己的?
把 wav 路径填进 sounds.approval / sounds.question,或改用 playerCommand 调外部播放器。
会重复弹吗?
同一触发在 minIntervalMs 内只弹一次。
English
dsh-alert is a DSH plugin that pops a native Windows toast and plays a sound whenever the
harness pauses for your approval or an answer. It covers approval/asked, ask_user_question,
and exit_plan_mode. If the toast channel fails, it falls back to a custom corner card, so
you never miss a prompt. Windows-only, zero runtime dependencies, MIT licensed.
License
MIT © 2026 Chen HuaJing (Dvva)
链接
同类插件
xmanrui/dsh-im★ 3737
通过二维码或机器人凭据将 IM 机器人接入 DeepSeek Harness(支持飞书、微信、钉钉、企业微信、QQ、Slack、Telegram、Discord 和 WhatsApp 共 9 种渠道)。
shaobeichen/dsh-pocket★ 3092
手机远程访问 DSH Web 界面:扫码即用局域网或公网(cloudflared 隧道)访问,实时同屏、移动端适配布局,带设置页管理。
c1overzz/dsh-bili-scroll★ 1459
让你的 DSH 自己刷 B站 —— 读字幕原文挑内容、写日报,遇到值得看的会发评论 @ 你。
OpenPetsHQ/openpets#dsh★ 1399
将 DeepSeek Harness 的生命周期状态、错误与审批请求,桥接到本地运行的 OpenPets 桌面伙伴。
inclusionAI/Avernet#deepseek-harness-channel-bcn★ 608
通过 WebSocket V2 将 DeepSeek Harness 接入 Avernet Bot 协作网络,支持自动注册、Agent 会话隔离、工具调用事件和多 Bot 路由工具。
zaofan-make/dsh-qqbot★ 270
QQ 官方机器人通道(tencent-connect/dsh-qqbot 的增强 fork):群/私聊ai陪聊、富媒体收发、表情包打标入库+检索发图、入群审批/禁言/群发、定时唤醒、QQ 远程审批与提问卡、互动按钮卡、多账号多实例、扩展接口、群友记忆注入、按消息价值唤醒省token、上下文自动压缩、悬浮球设置面板。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。