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
