回合完成通知 XEsx630/dsh-turn-notify

dsh-turn-notify

DeepSeek Harness 每轮任务结束时，弹出一条真正的 Windows 系统通知（Toast + 提示音）。

Windows 系统通知

功能

- 任务结束才通知：监听 UI 的 uiSession.sessionStatus，在该轮 running 从 true 变为 false 时触发；不是每条消息、每次工具调用，也不是插件启动时。
- 真正的系统 Toast：由 Host 进程通过 PowerShell WinRT 发出，进入 Windows 通知中心；不依赖浏览器 Notification 权限，也不受 DSH 每次启动随机回环端口的影响。
- 窗口不在前台也能看到：DSH 最小化或被其他应用盖住时，Toast 仍显示在最上层。
- 每轮都通知：包括当前正在查看的会话；跳过子代理会话和空白会话。
- 提示音：应用内 WebAudio 播放两声短音，不依赖 Windows 通知音设置。
- 设置页：设置 → 通知，可开关，也可发送一条测试通知。

通知设置

安装

需要 Windows 上的 DeepSeek Harness Desktop（在 0.2.1-rc.2 上开发并测试）。

从 GitHub 直接安装：

dsh plugin --profile desktop add github:XEsx630/dsh-turn-notify

或克隆后从本地目录安装：

git clone https://github.com/XEsx630/dsh-turn-notify.git
dsh plugin --profile desktop add .\dsh-turn-notify

安装后如果设置里暂时没有“通知”，重启一次 DSH。

使用

1. 打开 设置 → 通知，确认“任务完成”开关为开启状态。
2. 点“发送测试通知”，应看到 Windows 系统 Toast（即使 DSH 不在前台）。
3. 之后每轮任务完成时都会收到通知：标题为会话名，正文为“任务已完成 · 点击返回会话”。

实现

插件分两半：

- Client（client.js）：订阅 uiSession.sessionStatus，检测每轮完成；播放提示音，并调用 Host 的 /dsh-turn-notify/notify。
- Host（index.js）：在本机回环路由上接收请求，用 PowerShell 的 WinRT 投影直接发送 Windows Toast。Toast 本身静音，声音由 Client 播放，避免重复。

这样做的原因：渲染进程的 Notification 权限绑定在 DSH 的随机回环端口上，每次重启都会丢失；Host 直接发 Toast 则不受影响。

开发

无需安装依赖，测试使用 Node 内置模块：

node test/simulate.cjs

已知限制

- 仅支持 Windows；Toast 依赖 electron.app.DeepSeek Harness 这个 AppUserModelID，DSH 桌面端更新后如改动 AUMID，需要同步修改 index.js。
- DSH 窗口可以最小化或处于其他应用后面，但需要保持运行；完全退出 DSH 后无法检测任务完成，也就不会通知。
- 提示音由渲染进程播放；如果渲染进程被销毁，Host Toast 仍可能显示，但不会有提示音。

License

MIT