dsh-approval-notify

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