前言¶
在 DeepSeek Harness（DSH）里运行多轮对话、等待智能体完成目标时，终端或网页常常不是唯一需要关注的窗口。dsh-notify 针对 DSH web 版提供对话完成通知：当应用处于后台时，用 Windows toast 和提示音提醒回合完成、出错、目标完成；当需要用户回答或审批时，始终提醒。下面介绍它的功能、安装方式和注意点。
这是什么¶
aokamoaki/dsh-notify 是 DSH 社区插件，由 aokamoaki 维护，采用 MIT 许可证。它适用于 DSH web 版，桌面壳可选。插件以当前 dsh 进程权限运行，因此安装前应检查源码、许可证和依赖来源。它与 DeepSeek 官方无关。
核心功能¶
下面按使用顺序列出主要能力：
- 会话头部提供铃铛：通知总开关和音量滑块，操作实时落盘。
- 完成类通知仅在后台触发：web 页面可见或桌面壳任一窗口聚焦时静默。
- 提问和审批通知始终提醒，不因前台而静默。
- 总开关关闭后，所有通知全部静默，重启仍生效。
- toast 文案跟随 Windows 显示语言，支持中文与 English。
- 零配置起步，配置文件热更新，无需重启。
- 同会话 5 秒内不重复打扰；回合完成仅在空闲时提醒，并有 800ms 去抖；subagent 内部会话不通知。
- 提供 HTTP API，可读取和更新配置，查询和上报前台状态，且仅接受同源请求。
- Windows toast 与提示音由本地执行，支持声音开关、弹窗开关和音量控制。
- 桌面壳可选，用于上报 shell 前台状态。
安装与启用¶
安装命令为：
dsh plugin --profile web add github:aokamoaki/dsh-notify
安装后重启 dsh web，插件即可生效。
如果是本地开发，可在 profile 的 package.json 中以 link 引入仓库，例如：
"dependencies": {
"dsh-notify": "link:C:/path/to/dsh-notify"
}
同时确保 dsh.profile.bundles 含 dsh-notify。
典型用法¶
安装并重启后无需额外配置。默认行为如下：
- 对话回合完成：后台时提醒。
- 对话回合出错：后台时提醒。
- 目标完成：后台时提醒。
- 提问：始终提醒。
- 审批：始终提醒。
想临时关闭通知时，点击会话头部铃铛即可静音；悬停铃铛可以调整音量。
配置文件位于：
~/.dsh/dsh-notify.json
会话头部铃铛的操作会实时写回该文件。
如果 dsh web 已在本机运行，可用下面命令做运行时 API 自检：
curl http://127.0.0.1:3080/dsh-notify/config
开发或修改插件时，可运行以下命令验证：
npm run check
npm test
npm run pack:check
适用场景与注意¶
该插件适合在 Windows 上使用 DSH web 的场景，并依赖 Node >=22.13。它通过 PowerShell 与 Windows 通知执行 toast 和提示音。
使用前注意：
- 插件以当前
dsh进程权限运行，安装前应检查源码、许可证和依赖来源。 - peerDependencies 要求
@deepseek-ai/cordis ^4.0.1。 - HTTP API 仅接受同源请求，非浏览器来源会被拒绝。
- 前台状态为内存态，不落盘；初始态为后台，避免上报链路故障时吞掉通知。
- 若
dsh-startup-guard检测到插件损坏，会自动禁用，并在cordis.patch.yml追加disabled: true。 lib/client.js必须是 DSH client-bundle 产物格式，禁止 import 与 JSX。
结尾¶
它把 DSH 的完成、出错、目标、提问和审批信号接到 Windows 通知上，适合后台等待 DSH 的任务流。目录页与仓库如下：
- 目录页：https://www.skillhub.cn/plugins/aokamoaki/dsh-notify
- GitHub：https://github.com/aokamoaki/dsh-notify
