dsh-approval-notify
DeepSeek Harness 插件：任意会话请求提权（审批）时，弹出 Windows 原生 toast 通知并播放系统提示音，告知是哪个会话、为什么、提权什么。
A DeepSeek Harness plugin: pops a native Windows toast with sound whenever a session requests elevation approval, showing which session, why, and what is being elevated.
通知内容 / Toast layout
需要提权审批 — <会话名> (<会话ID前8位>) [· 子代理#N]
路径: D:\your\workspace
工具 pwsh · 提权至 danger-full-access — 原因: <justification>
- 会话名优先显示标题，无标题时退回工作目录名；ID 放括号里作唯一标识
- 路径独立一行，不与会话名挤在一起换行
- 点击通知可跳转 Web UI（需配置
launchUrl）
- toast 不可用（如非交互会话）时退化为系统提示音
安装 / Install
dsh plugin --profile <profile> add dsh-approval-notify
包声明了 dsh.bundle.patch，dsh plugin add 会自动把它并入 profile 的 bundle 层栈；重启 dsh 后生效（或由 HMR 热加载）。
手动挂载（等价写法，加到 profile 的 cordis.patch.yml）：
- insert:
- id: approval-notify-windows
name: dsh-approval-notify
config: {}
配置 / Config
| 项 | 默认 | 说明 |
|---|
dedupeMs | 1500 | 同一会话的去重窗口（毫秒） |
sound | ms-winsoundevent:Notification.Default | Windows 通知音事件名；置 null 静音（仍弹 toast） |
launchUrl | 环境变量 DSH_WEB_URL | 点击通知跳转的地址；置 null 关闭跳转 |
titlePrefix | 需要提权审批 | 通知标题前缀（可改为英文等） |
disabled | false | 置 true 临时停用 |
appId / powershell | PowerShell 经典 toast AppId / powershell.exe | 高级项，一般无需改动 |
注意：DSH 组合补丁按行整段替换 config（不深合并），覆盖配置时请重写完整字段。
工作原理 / How it works
监听提交后的 session/event 事件流里的 approval/asked 审计事件（emit 模式、与注册顺序无关）。刻意不挂在 approval/request waterfall 上：UI 应答器先注册并认领请求（不调用 next()），后注册的监听器收不到事件；而 firehose 与顺序无关，且通知故障绝不会影响审批链路本身。toast 由 powershell.exe 经 WinRT ToastNotificationManager 发出，无需安装任何额外模块。
要求 / Requirements
- Windows 10 / 11（非 Windows 平台自动禁用）
- 任意官方 DeepSeek Harness profile（需要
approval 与 sessionTitle 服务，官方 profile 均提供）
社区市场 / Community marketplaces
本仓库若放在 GitHub 上并打上 dsh-plugin topic，会被 AwesomeHou/dsh-plugin-marketplace 等社区插件市场自动收录。
License
MIT
