Windows 审批通知 DEVVE-1/dsh-windows-approval-notify

Windows 消息通知（DSH 插件）

DSH 需要提权、等待你授权，或一轮任务正常结束时，弹出一条 Windows 通知（显示为 DeepSeek Harness）。
只有 DSH 不是当前前台程序 时才弹：你正盯着 DSH 界面时不打扰。
插件只做转发：不参与授权决策，不改变审批结果，也不做其它任何事情。

触发条件

| 触发 | 来源 | 标题 |
| 有操作请求授权 | approval/request（兜底 approval/asked） | DSH 需要提权 |
| 一轮任务正常结束 | session/event 的 turn/end，且 reason.kind === 'completed' | DSH 任务完成 |

- 只有主会话才会提示任务完成；子代理（header.parentSession / origin: 'subagent'）的会话不提示。
- turn/end 的原因不是 completed（中止、报错、被拦截、超长截断等）时不提示，也不把中止说成“完成”。
- 前台抑制对两类通知都生效：前台窗口标题包含 DeepSeek Harness 时直接跳过，判定逻辑在 foreground.ps1。

实现

- 常驻一个 PowerShell 通知宿主，插件激活即预热；之后每条通知只写一行 JSON。
- PowerShell 侧先读前台窗口标题判断是否前台（Win32 GetForegroundWindow + GetWindowText），需要真正弹窗时才加载 WinRT Toast API。
- 弹窗延迟：预热后约 5–10ms；进程被回收/被杀时退化为一次性弹窗并退避重启宿主。
- 通知标签：授权 dshApproval、完成 dshTaskDone，同组 dshNotify；同类通知互相替换，不同类各自保留一条。

文案

- 授权正文优先用 DSH 自己的 displayReason（优先中文），其次 reason；都没有时显示 <工具名> 正在请求你的授权。
- 完成正文为 「<会话标题>」已完成，没有标题时显示 当前会话的这一轮任务已完成。
- 正文最多 220 字符，超出截断。

环境要求

- Windows 10/11，系统通知未关闭。
- powershell.exe（Windows 自带）。
- 通知宿主以 com.deepseek.dsh（DSH 桌面端的 AppUserModelID）发布，所以通知卡片显示为 DeepSeek Harness。

文件

| 文件 | 作用 |
| index.js | Host 插件：事件监听 + 通知通道（常驻进程、失败退避重启、一次性兜底） |
| notify-host.ps1 | 纯 ASCII 的 PowerShell 通知宿主，从 stdin 逐行读取 JSON，按需弹 Toast |
| foreground.ps1 | 前台窗口标题匹配（判断 DSH 是不是当前主程序） |
| cordis.patch.yml | 插入 windows-approval-notify 行 |
| locale/{en,zh}.json | 插件管理器的标题/描述 |
| icon.svg | 插件图标 |

安装

把本仓库克隆（或解压发布包）到任意目录，在 DSH 里执行：

plugin_manager install_bundle target = <本目录的绝对路径>

例如：

plugin_manager install_bundle target = D:\plugins\dsh-windows-approval-notify

安装后插件行立即生效，无需重启 DSH。卸载：

plugin_manager remove_bundle target = dsh-windows-approval-notify

License

MIT，见 LICENSE。