桌面通知 Dax233/dsh-desktop-notify

dsh-desktop-notify

Windows 原生通知插件：任务完成、需要提问或出错时弹出 toast，并播放内置 ciallo 提示音。

安装

dsh plugin --profile desktop add github:Dax233/dsh-desktop-notify

安装后重启 DSH Desktop；通知样式与声音受 Windows 通知设置影响。

@local/dsh-desktop-notify

为 DSH 智能体提供 Windows 原生系统通知，并播放系统声音。

工作原理

- 宿主端（index.js + toast.js）：注册 notify 工具，直接通过 Windows PowerShell + WinRT（ToastNotificationManager）发送 toast。AppUserModelID 用 DSH 的 electron.app.DeepSeek Harness，从已安装的开始菜单快捷方式读取，因此 toast 显示的品牌名是 DeepSeek Harness。声音用 System.Media.SoundPlayer 显式播放（系统 WAV），所以即使通知声音被设为静音，提醒也不会哑掉。
- 为什么不用渲染进程的 Web Notification API：在目标机器上它什么都送不出去（连操作中心都收不到），而 WinRT toast 能进操作中心。也没有引入 node-notifier/SnoreToast（LGPL）依赖。

调研记录（2026-10-22）：DSH 没有插件级的通知 API（只有桌面主进程用 Electron Notification 做强制更新），插件也够不到主进程模块。现有开源智能体通知工具都是命令行钩子脚本（macOS osascript、PowerShell WinRT，或 node-notifier + SnoreToast），没有一个是 DSH 插件。渲染进程的 Web Notification 路径是这里零依赖的合适选择。

工具接口

notify({ title, body?, sound?, urgency?, tag?, action? })

| 字段 | 含义 |
| title | 短标题（必填） |
| body | 一两行上下文 |
| sound | 默认 true；false 发送静音 toast |
| urgency | info（默认）/ attention / blocked（blocked 使用 requireInteraction，一直停留到用户关闭） |
| tag | 相同 tag 的新 toast 会替换旧的 |
| action | send（默认）或 status |

给模型的用法指引：每次有意义的状态变化发一条通知——任务完成、卡在用户这里，或用户要求提醒。

测试

cd <repo>
node --test tests/notify-client.test.mjs tests/notify-host.test.mjs

客户端测试在 Node VM 里执行真实的 client.js，Notification 类用 mock 替代（覆盖授权、请求权限、拒绝三条路径，静音标志，往返结果）。宿主测试覆盖工具 schema（可直接上线的 JSON Schema）、status、空标题拒绝，以及假客户端往返。

要求 / 限制

- Windows toast 权限来自 DSH 桌面应用；如果 Windows 通知设置禁用了该应用，工具会报 permission is denied。
- 仅限桌面端（需要 DSH 桌面渲染进程及其 Web Notification 支持）。
- 音量与专注助手由 Windows 控制；插件只能选择静音还是默认声音。

详细设计与排障：见 docs/desktop-notify.md。