dsh-task-notify

DSH（DeepSeek Harness）Web 插件：Agent / 子代理 / 工作流任务完成时，以及 agent 停下来等你操作时（需要审批、向你提问、计划待确认、目标受阻），弹出真正的 Windows 系统通知（带提示音与 DeepSeek 图标），可选 PushPlus 微信推送。浏览器关闭也能收到。

特性

• 系统级通知：经 BurntToast（PowerShell 模块）调用 Windows 通知中心，播放系统提示音，无需网页授权；
• 手机推送：通过 PushPlus 同步推送到微信，电脑不在身边也能收到；
• 通知内容：会话名（沿父链回溯到根会话）、时间、状态（完成 / 失败 / 中止…）；
• 需要审批：agent 权限不足发起提权 / 越权执行审批时，通知「需要你的审批」（含工具名与原因）——审批策略为 ask 时提醒你去批准；
• 询问用户：agent 调用 ask_user_question 主动停下咨询时，通知「Agent 正在问你」（含问题文本）；
• 计划待确认：/plan 完成后 agent 调用 exit_plan_mode 提交计划、等待你确认执行时，通知「计划待你确认」（含计划标题与摘要，每条评审只提醒一次）；
• 目标受阻：goal 自动回合因持续阻塞而停止（模型上报或到达轮次上限）时，通知「目标受阻」（含阻塞原因），提醒你处理或清除；
• 分类开关：主回合 / 子代理 / 工作流 / 需要审批 / 询问用户 / 计划确认 / 目标受阻 独立开关，另有总开关一键关闭全部通知；
• 持久配置：配置存于 DSH settings（task-notify 命名空间），重启不丢；
• 布局自适应：配置面板逐帧（rAF）跟随 dsh-better-sidebar 面板让位，不遮挡。

界面

• 会话标题栏右侧铃铛按钮：总开关关 → 空心铃铛；总开关开 → 实心铃铛；总开关开且推送开 → 右上角白色手机剪影；
• 毛玻璃配置面板：总开关 / 提醒对象（主回合、子代理、工作流、需要审批、询问用户、计划确认、目标受阻）/ 手机推送，含保存、测试推送、测试通知。

环境要求

• DSH Web（profile 插件机制），Windows 10/11；

• PowerShell 7（pwsh）与 BurntToast 模块：

  Install-Module BurntToast -Scope CurrentUser
  

安装

1. 在 profile 的 package.json 中 dependencies 增加：

   "dsh-task-notify": "file:<本仓库路径>"
   

2. 在 dsh.profile.bundles 数组末尾追加 "dsh-task-notify"；

3. 在 profile 目录执行 pnpm install，重启 DSH。

宿主行由本包自带的 bundle 补丁（cordis.patch.yml）注入，不要再写入 profile 的 cordis.patch.yml，否则启动报 duplicate loader entry id: dsh-task-notify。

使用

1. 在 https://www.pushplus.plus 扫码登录，复制「一对一推送」token；
2. 点击标题栏铃铛 → 打开「手机推送（PushPlus）」开关 → 粘贴 token → 保存；
3. 用「测试通知」「测试推送」验证两条通道；
4. 「提醒对象」中按需开关：需要审批（agent 提权/越权审批，仅审批策略 ask 时提醒）、询问用户（agent 提问）、计划确认（/plan 完成后 agent 提交计划等你确认）、目标受阻（goal 因持续阻塞停止）。

注意：审批策略为 never（如 danger-full-access 权限预设）时审批会被自动拒绝、无需人工操作，因此不会发送审批提醒。

测试与验收

五类通知的触发方式与预期内容（实测环境：Windows 11 + DSH Web，桌面 toast 通道）：

通知	触发方式	预期内容
任务完成	agent 正常跑完一个回合（含子代理 / 工作流）	会话名、时间、状态（完成 / 失败 / 中止…）
需要审批	权限设为 read-only，agent 写文件被沙箱拒绝后申请提权（审批策略 ask）	工具名、提权原因
询问用户	agent 调用 ask_user_question 抛出问题后主动停下	问题文本
计划待确认	/plan 进入计划模式，agent 调用 exit_plan_mode 提交带 # 标题的计划	计划标题与摘要（每条评审只提醒一次）
目标受阻	创建注定无法完成的目标，跑满自动轮次上限或模型上报 blocked	阻塞原因

v1.2.0 已实测通过：任务完成 / 需要审批 / 询问用户 / 目标受阻。 计划待确认需先在会话中进入计划模式（/plan）后由 agent 调用 exit_plan_mode 触发，按上表操作即可验收。

构建

node build.mjs
# pnpm 对 file: 依赖按内容拷贝，改完后同步到 profile 再刷新页面 / 重启：
Copy-Item lib\*.js <profile>\node_modules\dsh-task-notify\lib\ -Force
Copy-Item deepseek.png <profile>\node_modules\dsh-task-notify\ -Force

说明：构建使用 DeepSeek Harness 自带的 esbuild 与 vendored schemastery/cosmokit（@deepseek-ai/dsh-* 保持外部引用）；harness 不在默认路径时用环境变量指定：

$env:DSH_HARNESS = 'D:\path\to\deepseek-harness'

wire 编解码为手写严格 schema，无额外运行时依赖。

许可

MIT

图标 deepseek.png 由 DeepSeek 品牌标识（deepseek.svg）转出，仅用作应用图标。