前言¶
DeepSeek Harness（DSH）在 Agent 调用工具前常会弹出审批。对话窗口在前台时，应用内审批框足够；一旦你把 DSH 切到后台，或同时开着多个会话，就容易错过授权，任务卡在「等待批准」上。社区插件 dsh-approval-toast（维护者 zy12342）面向 Windows，用系统 Toast 把待审批、完成、出错和 Agent 提问推到桌面，并在通知上提供「允许一次 / 拒绝」等操作；当前会话在前台时则不弹 Toast，仍走应用内审批，避免重复打扰。
这是什么¶
dsh-approval-toast 是 DSH 的客户端类插件：在 Windows 10 / 11 上注册本机通知与 dshnotify:// 协议处理，与 DSH 0.2.1 及以上版本配合工作。README 写明插件零依赖，不附带安装脚本、不发起网络请求、不采集遥测。非 Windows 环境不会弹出桌面通知，审批会回落到应用内流程。
核心功能¶
下面按 README 已列能力说明，均为插件自带行为，无需额外配置文件。
通知上审批¶
DSH 不在前台时，待授权会弹出 Windows 通知。通知顶部应用名为 DeepSeek Harness，正文展示「会话 / 工具 / 内容」，底部为「允许一次 / 拒绝」。点击后立即生效，无需切回 DSH 窗口。
长文本会在通知里按标点截断（会话约 60 字、工具约 40 字、内容约 160 字）；完整信息仍在应用内审批框中查看。
前台不打扰¶
当前正在查看的对话若需要授权，不弹桌面通知，只显示应用内审批框。
多对话与其它提醒¶
其它未打开的对话需要授权时，仍会照常 Toast。任务完成或出错时也会通知；Agent 提问时会通知，点「去处理」可跳到对应会话。
子代理与子会话¶
子代理、子会话上的授权、完成、错误不弹桌面通知；这类授权仅走应用内流程。
队列与超时¶
多条通知按顺序逐条弹出；审批类通知需你先点「允许一次 / 拒绝」后，才会显示下一条。若约 60 秒内无人处理，通知会撤回并回落到应用内审批框。
安装与启用¶
在 DSH 设置 → 插件 中搜索 dsh-approval-toast 安装，或使用命令行（<profile> 换成你的 DSH profile 名）：
dsh plugin --profile <profile> add dsh-approval-toast
安装完成后完全退出 DSH 再重新打开，插件才会完整加载。
环境要求（来自 README）：
- Windows 10 / Windows 11
- DeepSeek Harness 0.2.1 及以上（
package.json中 engines 为dsh:>=0.2.1-rc.1 <0.3.0-0） - 不需要管理员权限；仅在当前用户注册表（HKCU）写入协议与通知身份
典型用法¶
安装并重启 DSH 后，无需单独开关：在后台会话触发工具审批时，应出现带两个按钮的 Toast；在前台会话触发审批时，应只看到应用内框。可将 DSH 最小化，从通知完成一次「允许一次」或「拒绝」，确认任务是否继续或终止。
Agent 提问、回合结束或报错时，可观察是否收到对应通知；对提问通知点「去处理」，应跳转到相关对话。
安全与卸载¶
README 与仓库 SECURITY.md 说明：本机 HTTP 仅监听 127.0.0.1 的随机端口；token 一次性，并校验端口、rid、token 与决策参数后才接受请求。通知按钮经 dshnotify:// 调起 decision.ps1，非法输入直接退出、不发起请求。
在插件管理器中卸载后，需运行包内 uninstall.ps1，清理 dshnotify:// 协议与通知身份。
适用场景与注意¶
适合：主要在 Windows 上使用 DSH、经常多开对话或长时间让 Harness 在后台跑任务的开发者。
已知限制（README）：
- 仅 Windows；其它系统无 Toast，审批走应用内
- 通知横幅行数由系统决定；专注助手、免打扰可能拦截通知
- 点击通知按钮会短暂拉起 PowerShell，约 0.5～1 秒延迟
DSH 插件在当前 DSH 进程权限下运行。安装前建议浏览 GitHub 仓库 源码与 MIT 许可证；社区目录 skillhub.cn 插件页 为独立收录站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-approval-toast 把 DSH 的审批、完成、错误与提问提醒接到 Windows Toast，并在后台场景下支持通知内一键允许或拒绝，同时保留前台应用内审批与 60 秒超时回落。若你在 Windows 上常驻 DSH，可按上文命令安装并在卸载时执行 uninstall.ps1 清理注册项。
