@xmwpoi

dsh-approval-center

Name: dsh-approval-center
Availability: InStock
Author: xmwpoi

DSH 0.1.7-rc.2 的 Windows 审批与主对话通知插件：批准/拒绝、本轮完成与异常提醒、SQLite 审计；子代理通知关闭。GitHub Releases 分发。

Stars: 2
Language: JavaScript
Created: Sep 25, 2026
Updated: Oct 4, 2026

Notify

GitHub repo Homepage

Introduction

dsh-approval-center

DeepSeek Harness（DSH）的 Windows 审批与主对话通知插件。

在 Windows 通知中心处理 DSH 的人工审批，并接收主对话本轮完成、出错、受阻和达到输出上限的提醒。子代理通知全部关闭，减少并行任务带来的提示音干扰。

插件只处理宿主已经要求审批的操作，不扩大工具权限，也不把“本轮回复结束”视为整个任务目标完成。

当前版本：0.4.0-rc.2，GitHub Latest 正式发布版，适配精确版本 DSH 0.1.7-rc.2。 通过 GitHub Releases 分发，未发布到 npm。Windows 11、100% 缩放的横幅和通知中心展开态已实测；其他环境的验证边界见下文。

下载

安装请选择 .tgz 附件。GitHub 自动生成的 Source code 压缩包是源码，不能替代已构建的安装包。

运行要求

组件	要求
系统	Windows，通知中心可用；本版实测 Windows 11 26100、100% 缩放
DSH	`0.1.7-rc.2`，精确版本
Node.js	≥24，需要 `node:sqlite`
插件管理器	PATH 上可用的 `pnpm`
通知脚本	Windows PowerShell 5.1；审批回传优先使用可用的 VBScript / wscript

0.1.5-rc.1 仅有观察性回归，不构成双版本支持。更旧 Windows 上 attribution 提示的兼容行为尚未实测。

功能与通知范围

类型	行为	默认
主对话审批	通知上点击批准或拒绝；展示任务、操作、原因、批准范围与超时动作	开启，匹配全部工具的审批请求
主对话完成	显示“本轮回复已完成”	开启，Windows 默认提示音
主对话异常	分别显示出错、受阻、达到输出上限	开启，Windows 默认提示音
主对话审批结果回执	审批结算后提醒	关闭
子代理通知	启动、完成、错误、审批及结果均不由本插件发送	始终关闭

旧开关 notifyOnSubagentStart / notifyOnSubagentEnd 即使设为 true 也无效。子代理审批交回宿主其他应答者处理，本插件不会因此自动批准或拒绝。宿主和其他软件自己的通知不受本插件控制。

任务通知默认使用 Windows 提示音，可显式设为 silent；审批通知及结果回执不受 taskNotificationSound 控制，审批当前没有独立静音开关。

安装

先检查环境，以下示例使用 web profile；其他 profile 请替换名称：

dsh --version
node --version
pnpm --version

固定 Release 安装

dsh plugin --profile web add https://github.com/xmwpoi/dsh-approval-center/releases/download/v0.4.0-rc.2/dsh-approval-center-0.4.0-rc.2.tgz

也可在 DSH Web 的“插件 → 添加插件”中填写同一个 .tgz URL。包内包含 lib/，无需克隆或手动编译。

本地校验后安装

下载 .tgz 与 SHA256SUMS.txt，对照清单核验文件名及完整 SHA256：

Get-FileHash -LiteralPath 'C:\Downloads\dsh-approval-center-0.4.0-rc.2.tgz' -Algorithm SHA256
dsh plugin --profile web add 'C:\Downloads\dsh-approval-center-0.4.0-rc.2.tgz'

安装会自动应用包中的 bundle patch。不要再手动添加 insert，否则会挂载两个实例。通常需停止旧宿主进程，再重新启动 dsh web；仅打开旧网页不算重启。

dsh --profile web --dump-config

在完整配置中确认 id: approval-center 只有一个。首次主审批会注册当前 Windows 用户的 dshapproval URI 与通知应用标识；同一用户的多个安装共享注册，避免并行改指向不同目录。

如果使用多个 DSH_HOME，安装前明确设置正确的 $env:DSH_HOME；默认安装不必设置。安装成功但没有效果时，首先排查 profile、DSH_HOME 与实际运行的宿主进程。

配置

安装 bundle 的出厂配置与 schema 默认值不同：出厂 timeoutSec: 60、queueMode: parallel；schema 为 30 秒、serial。

profile patch 的 config 是整体替换，不是深合并。 修改时使用 id 定向补丁，完整列出需要的字段，避免缺省字段回到 schema 默认值。以下与出厂行为一致，并显式写出审计目录选项：

# 目标 profile 的 cordis.patch.yml；不要另写 insert
- id: approval-center
  name: dsh-approval-center
  config:
    timeoutSec: 60
    timeoutAction: reject
    tools: ['*']
    queueMode: parallel
    notifyOnTurnEnd: true
    notifyOnTurnFailure: true
    taskNotificationSound: default
    taskNotificationShowTitle: true
    notifyOnApprovalResult: false
    dataDir: ''

字段	说明
`timeoutSec`	待审批时长，单位秒
`timeoutAction`	`reject` 默认超时不放行；`approve` 为真实超时自动批准，请确认风险后才设置
`tools`	`['']` 匹配全部工具；支持 `bash` 等前缀模式，未匹配请求交回宿主
`queueMode`	`serial` 串行或 `parallel` 并行；并行最多 3 个活动审批
`notifyOnTurnEnd`	主对话本轮完成提醒
`notifyOnTurnFailure`	主对话出错、受阻、达到输出上限提醒
`taskNotificationSound`	`default` 默认使用系统提示音；`silent` 静音，仅控制任务通知
`taskNotificationShowTitle`	`true` 显示会话标题；`false` 显示会话短 ID
`notifyOnApprovalResult`	主对话审批结果回执，默认关闭
`dataDir`	留空使用 `$DSH_HOME/approval-center`，未设 DSH_HOME 时使用 `~/.dsh/approval-center`

工具名请以实际宿主为准，文件工具为 write / edit，不是 fs*。本插件优先认领匹配的主审批，未匹配或身份无法可靠确认时交回其他应答者。

审批卡片与结果含义

卡片固定写明“需要你审批 · 批准仅本次”，并显示“拒绝不执行；60秒后自动拒绝”等真实动作。任务、操作、原因分别最多 20 Unicode 码点（含省略号）；发生截断时显示独立的“（摘要，详情见 DSH）”。工具名不是完整命令，操作详情请回 DSH 核对。

批准仅允许本次请求，不是永久授权。完整原始审批原因保留于 SQLite 审计中；展示摘要不替代审计原文。

情况	处理
用户批准	`allowed-once`；审计 `approved`
用户拒绝	`rejected`；审计 `rejected`
真实超时	审计 `timeout`；按配置放行或不放行
请求方撤回	`cancelled`
插件卸载、非法输入或渠道故障	`unavailable`，不会谎报成用户拒绝

审计插入失败不弹审批；批准后审计结算失败降级为渠道不可用。划掉通知不等于拒绝，插件通常需等到超时才能结算。

任务通知的边界与隐私

“完成”表示主会话完成一轮实际执行的回复，不代表整个项目目标达成或所有后台代理已结束。主动取消不发送完成通知；出错、受阻与输出上限各有独立文案。

通知正文不包含回答全文、命令参数、提示词或原始错误堆栈。会话标题可能含用户自行输入的信息，锁屏展示由 Windows 控制；隐藏标题可设置 taskNotificationShowTitle: false。发送通知时优先读取宿主保存的最新标题，恢复会话、重载插件与用户改名均生效；宿主标题服务不可用时回退事件缓存，无标题时显示去除 session- 前缀后的短 ID。已发送的通知不会追溯修改。

任务通知不提供点击跳转；进程内有界去重，不承诺跨重启严格去重。热加载中途未观察到执行步骤的轮次不补发完成提醒，卸载丢弃待发通知，不补播历史。

升级、备份与回滚

处理未决审批，停止当前 DSH 实例，记录旧版本、安装来源与 profile。
备份 profile 的配置、package/lock/patch 文件与审计目录。停机复制 approvals.db，如存在 -wal / -shm，一并复制；运行中备份须使用 SQLite backup，不能只复制主 DB。
在正确 profile 卸载旧插件，安装新 .tgz，确认仅一个实例，重启宿主。
核验批准、拒绝、完成/异常提醒及审计终态，确认旧历史可读。
如需回滚，先停止新版并备份升级后的数据，再恢复旧 profile 与安装来源；不要直接让旧版打开尚未备份的审计库。

同一 dataDir 只允许一个活跃实例；多个 profile/宿主请配置独立数据目录。旧版 0.3.0 会把残留 pending 改为 timeout，回装前尤其需要备份。生产升级后完整回装演练尚未执行。

首次注册的 URI 与 AUMID 不随插件卸载自动删除。回滚后应核验注册指向有效安装；不要在运行中删除锁文件或清理其他实例的通知。

验证与已知限制

R11 运行代码的 Windows CI：282/282 单测、120/120 集成，零 fail/skip。
Windows 11 26100、100% 缩放：原失败输入在横幅及通知中心展开态均可见摘要提示；17 例横幅覆盖长度边界、长任务/工具、emoji/XML、自动批准文案与真实批准/拒绝/超时回传。
新包参数门 9/9、生产非法输入 4/4；非法输入 exit4、零副作用，不误报为用户拒绝。
确定性模型的真实主 AgentLoop→Windows 通道已有证据；它不代表生产模型体验。新包任务通知通道另做最小静音冒烟。
未测：125%/150% 缩放、更旧 Windows 的 attribution 行为、真实 child 委派、生产模型体验、20 路大批次实机及生产升级后回装演练。
系统关闭通知、勿扰/专注模式、权限限制或限流可能让通知不出现；提交成功不等于用户实际看到或听到。
VBS 不可用时走 PowerShell 回传，可能短暂闪现控制台窗口。
超时/撤回后通知会清理；进程强杀时依靠定向清理及过期时间兜底。不要点击已结束请求的旧按钮。

开发与反馈

git clone https://github.com/xmwpoi/dsh-approval-center
cd dsh-approval-center
npm ci
npm --prefix test/integration ci --ignore-scripts
npm test

自动集成使用 mock 发送通道，不投递通知。人工 npm run test:approval -- 60 会真实弹审批，需独占桌面并备份/恢复共享注册。源码目录安装前必须构建，安装后不要移动该目录。

请在 Issues 提供插件/DSH/Windows/Node 版本、缩放比例、安装方式、脱敏日志及复现步骤。不要上传 API key、完整生产 profile 或审批数据库。

许可证

MIT。本项目是 DSH 插件，非 Windows 或 DeepSeek 的官方通知客户端。