dsh-blocker-notify

English | 简体中文

DeepSeek Harness（DSH）阻塞提醒插件：当 Agent 在工作中被卡住、需要用户介入时，在网页端实时提醒，让你不用一直盯着屏幕等待操作。

触发提醒的三类"阻塞"信号：

信号	说明
提权 / 审批（approval/request）	Agent 请求提升沙箱权限、或需要审批时（如 read-only 下 write 提权）
沙箱拒绝（FS_SANDBOX_DENIED）	write/edit 在 read-only / workspace-write 模式下被拒
等待用户交互（question / plan-review）	Agent 在等你回答提问、审阅计划

即使审批策略是 never（审批被静默拒绝），沙箱拒绝仍然会产生提示——本插件在那种配置下也有效。

两种提醒方式

方式	效果
全局消息（横幅）	右上角琥珀色横幅，列出所有被阻塞的会话；点击条目跳转对应会话；显示工具名与原因；可手动关闭（✕），阻塞集合变化后重新出现
工作区条目标黄并闪烁	左侧工作区会话条目上的黄色状态点 1.1s 闪烁——黄色标记是 DSH 自带的（"等待用户"状态），本插件加上闪烁动画；阻塞解决后自动停止

怎么用

方式一：动态插件（快速启用，5 分钟，推荐先试）

不需要安装任何东西，不需要重启 DSH。缺点：进程内存态，DSH 重启后需重新启用。

1. 获取本仓库源码：git clone https://github.com/Frost-Reed/blocker-notify（或直接在 GitHub 页面下载）。

2. 打开任意会话（建议 cordis / 创造模式），把下面这段指令发给 Agent（把 `` 换成你本地克隆的路径）：

   请把 dsh-blocker-notify 启用为动态插件：
   1. 用 read 工具读取 /dynamic/host.js 和 /dynamic/client.js（分别是 code.host 与 code.client 的函数体，直接使用文件内容）。
   2. 调用 cordis_define：plugin: { kind: "new", idPrefix: "ntfy" }；name: "blocker-notify"；purpose 一句话；code.host = host.js 内容；code.client = client.js 内容。
   3. 用 cordis_define 返回的 pluginId/packageId 调用 cordis_run（mode: "run"）。
   4. 运行请求可能需要用户在网页端批准 Client 半；等待批准结果，不要重复请求。
   5. 完成后用 cordis_inspect_self(pluginId, packageId) 确认 host/client 均为 running。
   

3. 在网页端批准 Client 半的运行请求（一次即可）。

4. 立即验证（见下文"验证"）。

方式二：正式 bundle 安装（持久生效，v0.2.0）

按 DSH 的正式插件规范打包（dsh.bundle + dsh.client），安装后跨重启生效。

从 GitHub 安装（已发布，推荐）：