DeepSeek Harness plugin

dsh-approval-notify

DeepSeek Harness plugin: Windows toast notification with sound when a session requests elevation approval — shows which session, why, and what is being elevated

Jump to install

Source facts

Repository
Uknown-wang/dsh-approval-notify
Latest update
Aug 18, 2026
Category
Memory
GitHub stars
0
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/Uknown-wang/dsh-approval-notify
Plugin: dsh-approval-notify
Author: Uknown-wang

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

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.patchdsh plugin add 会自动把它并入 profile 的 bundle 层栈;重启 dsh 后生效(或由 HMR 热加载)。

手动挂载(等价写法,加到 profile 的 cordis.patch.yml):

- insert:
    - id: approval-notify-windows
      name: dsh-approval-notify
      config: {}

配置 / Config

默认说明
dedupeMs1500同一会话的去重窗口(毫秒)
soundms-winsoundevent:Notification.DefaultWindows 通知音事件名;置 null 静音(仍弹 toast)
launchUrl环境变量 DSH_WEB_URL点击通知跳转的地址;置 null 关闭跳转
titlePrefix需要提权审批通知标题前缀(可改为英文等)
disabledfalsetrue 临时停用
appId / powershellPowerShell 经典 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(需要 approvalsessionTitle 服务,官方 profile 均提供)

社区市场 / Community marketplaces

本仓库若放在 GitHub 上并打上 dsh-plugin topic,会被 AwesomeHou/dsh-plugin-marketplace 等社区插件市场自动收录。

License

[MIT](./LICENSE)