Dawn388887/dsh-notify

dsh-notify

DeepSeek Harness（DSH）插件：当根会话代理任务完成、出错或需要用户回答时，弹出 Windows 桌面通知；远程设备（平板/手机通过 LAN 或 VPN 访问 DSH Web）则弹出浏览器通知。

功能

- 当前查看的根会话代理 running → idle 时通知「任务完成」
- 代理出错时通知（同轮同步骤去重，最多记住 64 条）
- Host 端在 ask_user_question 实际进入等待用户回答时通知（按工具调用去重；启动即失败不误报）
- 在 DSH 0.1.2 中，任意前台或后台根会话出现需要用户处理的 question 或 plan-review 时，都弹出浏览器通知
- /notify 命令：/notify 查看状态，/notify on|off 开关，/notify test 试弹
- 设置页「远程通知」选项卡开关，与 /notify 共用同一个全局开关（持久化在 ~/.dsh/notify-state.json）
- 只通知用户直接面对的根会话，子代理静默

安装

这是纯本地插件（不 import 任何 @deepseek-ai 包），可安全使用 link: 依赖：

假设插件放在 ~/.dsh/plugins/dsh-notify
dsh plugin --profile web add ~/.dsh/plugins/dsh-notify

或在 Cordis 组合补丁中插入一行：

- insert:
- id: notify
name: dsh-notify
inject: [webServer]   # 必须：等待 webServer 服务就绪后再注册路由

改完组合后重启 dsh web。

使用

- 桌面：任务完成、出错或等待你回答问题时，弹出带默认提示音的 WinRT 原生 Toast
- 远程设备（浏览器）：页面通过 Service Worker（/dsh-notify/sw.js）通知。任务完成和错误跟随当前查看会话；question / plan-review 等待则覆盖所有前台、后台根会话。
- 权限：首次使用时浏览器会请求通知权限；若曾拒绝，需要在站点设置中重新开启。
- 开关：设置页 → 远程通知；或 /notify off（远程页面会在标签重新可见时同步开关状态）

兼容性

- 桌面 Toast 依赖 Windows + WinRT
- 开发和测试环境：DSH 0.1.2-rc.1
- 全会话等待交互监听使用 DSH 0.1.2 的 uiSession.pendingInteractions API

测试

三项测试均为离线 mock，不需要运行 DSH Web：

node test/notify-client-test.mjs
node test/notify-events-test.mjs
node test/notify-state-test.mjs

- notify-client-test.mjs：34 项，覆盖 DSH 0.1.2 全会话 question / plan-review、去重、当前会话完成/错误以及清理逻辑
- notify-events-test.mjs：9 项，覆盖 Host ask_user_question 等待识别、调用去重、无关工具及仅根会话通知
- notify-state-test.mjs：17 项，覆盖 GET/POST /dsh-notify/state、持久化、参数校验、同源处理、405/413 与 sw.js

赞助

如果这个插件帮你省了时间或麻烦，欢迎请我喝杯咖啡：

- PayPal：paypal.me/dawn388887

许可

MIT © 2026 Dawn388887