V-Reason/dsh-task-notify

dsh-task-notify

| English

Agent 停下来的那一刻，让 Windows 通知你。

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

任务完成系统通知：标题「Agent任务完成」，正文为会话名、时间与状态

桌面通道实拍：标题 + 会话名 / 时间 / 状态，带 DeepSeek 图标与系统提示音。

version
license
platform
DSH

特性

| 能力 | 说明 |
| --- | --- |
| 🔔 系统级通知 | 经 BurntToast（PowerShell 模块）调用 Windows 通知中心，播放系统提示音，无需网页授权 |
| 📦 依赖免装 | BurntToast 缺失时插件自动安装（当前用户范围，免管理员）；已装机器上零打扰 |
| 🌐 中英双语 | 面板头部滑块热切换，通知与面板文案即时切换；语言跟随 DSH 的「设置 → 通用 → 语言」，默认中文 |
| 🖼️ 图标热更新 | 图标取自包内 deepseek.png（按内容指纹缓存），替换后下一条通知立即换新，无需重建或重启 |
| 📱 手机推送 | 可选 PushPlus 推送，电脑不在身边也能收到 |
| ⏸️ 等你操作就提醒 | 审批请求、agent 提问、计划待确认、目标受阻——agent 停下的每一类场景都有独立通知 |
| 🎛️ 即改即存 | 总开关 + 7 个分类开关，改动立即落盘到 DSH settings，重启不丢 |
| 📐 布局自适应 | 配置面板逐帧跟随 dsh-better-sidebar 的右侧 / 底部面板让位，不遮挡 |

通知一览

| 通知 | 触发时机 |
| --- | --- |
| Agent任务完成 | 主回合 / 子代理 / 工作流结束 |
| 需要你的审批 | agent 权限不足发起提权、越权执行审批（审批策略 ask） |
| Agent 正在问你 | agent 调用 ask_user_question 主动停下咨询 |
| 计划待你确认 | /plan 后 agent 调用 exit_plan_mode 提交计划、等待确认 |
| 目标受阻 | goal 自动回合因持续阻塞而停止 |

每条通知携带会话名（沿父链回溯到根会话）、时间与状态（完成 / 失败 / 中止 / 阻塞…）。
完整的触发条件、内容格式与状态文案见 通知类型与触发时机。

快速开始

1. 装依赖——Windows 10 / 11。BurntToast 已由插件自动安装（当前用户范围，免管理员）；
如需手工安装：

Install-Module BurntToast -Scope CurrentUser

2. 装插件——DSH ≥ 0.1.6-alpha.1，安装后自动 reconcile dsh.profile.bundles：

dsh plugin --profile web add git+https://github.com/V-Reason/dsh-task-notify.git

3. 验证——重启 DSH，点击会话标题栏铃铛 →「通知类型」层 →「测试 Windows 通知」，
应听到系统提示音并弹出带 DeepSeek 图标的 toast。

4. 切语言（可选）——面板头部滑块在「中文 / English」之间热切换，通知与面板文案即时生效；
它写的就是 DSH 自己的语言偏好，与「设置 → 通用 → 语言」同步。

手机推送（可选）：在 https://www.pushplus.plus 扫码取「一对一推送」token → 展开「手机推送」层粘贴并
保存 → 点「测试手机推送」。

本地 file: 安装、升级方式与故障排查见 安装与升级；
面板交互与全部设置项见 配置与使用。
升级 DSH 后插件失效时，先跑一次 npm run verify 定位平台契约变更；
排查方法与通用套路见 DSH 升级后插件失效的排查手册。

文档

| 文档 | 内容 |
| --- | --- |
| 安装与升级 | 环境要求、git 源 / 本地 file: 安装、重复注入与构建脚本故障排查 |
| 配置与使用 | 铃铛与面板交互、设置项总表（含默认值）、PushPlus 接入 |
| 通知类型与触发时机 | 7 类通知触发条件、内容构成、状态文案、通知通道与图标热更新 |
| 测试与验收 | 逐条验收表、契约校验脚本与实测记录 |
| DSH 升级后插件失效的排查手册 | 失效形态判定、证据来源、案例复盘、高频破坏点与排查清单 |
| 构建与开发 | 目录结构、构建与同步流程、实现要点与已知限制 |
| 版本历史 | 1.1.0 → 1.8.1 全部变更 |

许可
以 MIT 许可发布。通知图标 deepseek.png 由 DeepSeek 品牌标识（deepseek.svg）转出，
仅用作应用图标。