Windows 系统通知 LucienLL/dsh-win-toast

dsh-win-toast

DeepSeek Harness 的 Windows 原生通知插件：需要你确认 / 回答时、回合结束时，由 DSH 宿主进程直接弹系统通知（不依赖浏览器标签页在前台）。

曾用名 dsh-desktop-toast。该 npm 名称已由其他作者先占用（同功能、0.1.2），本项目改名 dsh-win-toast 发布，代码与仓库均为独立实现。

为什么放在宿主侧

DSH 的确认与提问是「浏览器端应答、宿主端永久等待」的模型：只要标签页不在前台，你就可能完全错过一个正在等你的弹窗。本插件不走浏览器 Notification，而是在宿主进程里观察事件、调用 Windows Toast API，所以标签页被切走、最小化、被浏览器冻结时依然会提醒。

插件能做的只有提醒本身：真正答复仍需要在 DSH 页面里点。

触发点

| 事件 | 默认 | 通知标题 |
| approval/request（工具执行需要确认） | 开 | DSH · 等待你确认 |
| user-questions/request（ask_user_question、计划确认） | 开 | DSH · 需要你回答 |
| turn/end 且 reason.kind === 'completed' | 开 | DSH · 回复完成 |
| turn/end 且为 error / aborted / blocked / max-tokens / interrupted | 开 | DSH · 回合中断 |

以下情况不提醒：

- 子智能体会话（header.origin === 'subagent' 或 delegationDepth > 0）——它们没有人类应答者，提醒只算噪声。
- turn/end 的 forked 原因——那是 fork 种子的记账事件，不是你看着结束的回合。
- 同类通知间隔小于 minIntervalMs 的重复（默认 1.5s），防止突发刷屏。

安装

从 npm（推荐）
dsh plugin --profile web add dsh-win-toast

或从本地检出
dsh plugin --profile web add <本目录路径>

然后重启 DSH web（插件是宿主侧插件，需要重新组合）。

同生态的替代实现（同样功能、不同作者）：dsh-desktop-toast、dsh-desktop-notify、dsh-notify-me。装之前建议只留一个，否则同一次确认会收到多条通知。

发送方身份（一次性，可选）

Windows 只认「与 AUMID 同名的开始菜单快捷方式」来决定通知的发送方名称与图标；没有快捷方式的 AUMID 会被 API 接受、然后被系统静默丢弃。所以：

- 不注册：默认使用 {1AC14E77-02E7-4E5D-B744-2EB1AE5198B7}\WindowsPowerShell\v1.0\powershell.exe（系统自带，已实测可达），但发送方显示为「Windows PowerShell」。
- 注册（推荐外观）：在开始菜单建一个带 AppID 的快捷方式，通知改显示为 DeepSeek Harness + DSH 图标。

powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts/register-aumid.ps1
-Aumid 'DeepSeek.Harness.Notify'
-TargetPath 'E:\Program Files\DeepSeek Harness\DeepSeek Harness.exe'
-IconPath 'E:\Program Files\DeepSeek Harness\DeepSeek Harness.ico'

撤销 powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts/register-aumid.ps1 -Aumid 'DeepSeek.Harness.Notify' -Unregister

注册后把配置里的 appId 设成同一个 AUMID；没注册就把 appId 留空/改回默认的 PowerShell AUMID。

配置项（Settings → Plugins）

| 键 | 默认 | 说明 |
| enabled | true | 总开关 |
| notifyApproval | true | 工具确认提醒 |
| notifyQuestion | true | 提问 / 计划确认提醒 |
| notifyTurnComplete | true | 回合完成提醒 |
| notifyTurnError | true | 回合异常提醒 |
| includeReason | true | 确认通知里是否附带工具给出的理由 |
| sound | true | 是否播放系统提示音 |
| minIntervalMs | 1500 | 同类通知最小间隔 |
| language | zh | zh / en |
| appId | PowerShell AUMID | 通知发送方身份 |

实现要点

- 监听 approval/request 与 user-questions/request 时以 { prepend: true } 注册，弹完通知原样 next() 交还给真正的应答者，绝不吞掉请求、绝不改变审批结果。所有回调都包在 try/catch 里：通知失败不能影响审批链路。
- 每次通知是一次短命的 powershell.exe -File lib/toast.ps1（约 0.3–0.6s）。必须用 Windows PowerShell 5.1——PowerShell 7 已移除 WinRT 投影，Windows.UI.Notifications 在 7 里不可用。
- 同一时刻只跑一个通知进程，后来的覆盖尚未启动的旧通知。
- lib/toast.ps1 是纯 ASCII：Windows PowerShell 5.1 会按当前 ANSI 代码页解析无 BOM 的 UTF-8 脚本，源码里的中文会把它弄坏；所有中文正文只经由参数（UTF-16 命令行）传入。

已知边界

- Windows 专注助手 / 勿扰模式、以及每个 AUMID 的通知开关拥有最终否决权，插件无法绕过。
- 通知正文只包含工具名、理由、会话标题，不含工具参数，避免把敏感内容推到锁屏界面。若不希望会话标题出现在通知里，可关闭对应开关。
- DSH 标签页完全关闭时，审批本身仍会 fail-closed 拒绝；通知只能起提醒作用。

验证

node --check lib/index.js
node test/notify.test.mjs # 纯逻辑单测（10 项）
node scripts/smoke-wiring.mjs # 假 ctx 跑通三条监听 + 瀑布委托，并实测发通知

smoke-wiring.mjs 结束后可以用 PowerShell 查 toast 历史，确认真正送达：

[void][Windows.UI.Notifications.ToastNotificationManager, Windows.UI.Notifications, ContentType=WindowsRuntime]
([Windows.UI.Notifications.ToastNotificationManager]::History.GetHistory('DeepSeek.Harness.Notify')).Count