前言¶
在 DeepSeek Harness（DSH）里跑智能体任务时，常见情况是：你切到别的窗口写代码、查文档，DSH 在后台继续跑；任务结束时没有明显信号，需要你点「批准」工具调用时也不会主动找你。Codex、WorkBuddy 一类产品会在系统层弹出提醒，把注意力拉回会话。DSH 本身不自带这类跨窗口通知，社区插件 dsh-reminder（维护者 Aisland-SJL）补的就是这一块：任务完成或等待审批时，在任意窗口弹出提醒，点击即可回到对应会话。
这是什么¶
dsh-reminder 是面向 DSH Web 端的跨窗口提醒插件，分类为「工作流」。它在任务轮次结束或出现待审批工具调用时，通过浏览器 Notification API 弹出右下角卡片，并播放短促提示音；只提醒、不代你批准。插件以 MIT 许可证发布，当前版本 0.1.0，GitHub 仓库约 12 stars（截至资料抓取时）。
架构上，一个 npm 包同时包含 host（Cordis 插件，注册设置命名空间与 Typert Remote）和 client（订阅会话列表与对话快照，监听 turn/end、approval/requested 等 mux 流事件）。插件为只读设计，不修改 DSH 核心行为。
核心功能¶
下面按事件类型说明已核实的能力。
任务完成提醒¶
每轮对话结束时弹出绿色「Task completed」通知，展示会话信息与耗时，带绿色勾选图标。
审批等待提醒¶
出现待审批工具调用时弹出琥珀色「Waiting for your approval」通知，展示工具名称与警示图标。
跨窗口与交互¶
- 在其他应用窗口工作时也会弹出，不局限于 DSH 标签页在前台。
- 点击通知会聚焦 DSH 窗口并打开对应会话。
- 通知 3–5 秒后自动消失（时长可调）。
- 播放 D4→A4 两音柔和提示音；同一事件去重，不会重复弹出。
- 插件不会代替用户点击批准。
设置项¶
在 DSH 设置 → Reminders 中可配置：
| 设置项 | 默认值 | 说明 |
|---|---|---|
| Notification permission | 未设置 | 一键授权并发送测试弹窗 |
| Approval reminders | 开启 | 关闭后不弹审批提醒 |
| Completion reminders | 开启 | 关闭后不弹完成提醒 |
| Duration | 3–5 s | 自动消失前的秒数 |
| Failure alerts | 关闭（预留） | 计划在 v0.3 提供 |
安装与启用¶
先做插件安装，再在 Web 配置里注册并重启进程。
1. 安装插件¶
通过 DSH CLI 安装（Web profile）：
dsh plugin --profile web add <dsh-reminder>
也可使用 npm：
npm i dsh-reminder
2. 注册并重启¶
在 profile 的 bundle 列表中注册 dsh-reminder，然后重启 DSH Web 进程，使 host 与 client 生效。
典型用法¶
安装并重启后，按下面步骤完成授权与验证。
- 打开 DSH 设置 → Reminders。
- 点击 Enable & test notifications，在浏览器权限对话框中选择允许；应立即收到一条测试弹窗。
- 切到其他窗口继续工作。当智能体完成一轮或等待你批准工具调用时，右下角会弹出对应通知；点击即可回到会话。
提示音受浏览器自动播放策略限制，首次需在页面内有一次点击后才会解锁。
适用场景与注意¶
适合谁： 长时间让 DSH 在后台跑任务、经常切窗口的开发者；需要及时响应工具审批、又不想反复手动切回 DSH 标签页的用户。
使用注意：
- 通知权限必须由用户手势触发（浏览器策略），设置页的测试按钮即为此设计。
- Chrome 页面通知不支持
actions按钮，只能通过自动关闭或悬停关闭；持久化带 actions 的通知需 Service Worker，本插件未采用该路径。 - Failure alerts 当前为预留项，默认关闭。
- 插件随当前 DSH 进程权限运行。安装前请阅读 GitHub 源码 与 MIT 许可证，确认符合你的安全与合规要求。
社区目录 SkillHub 为独立站点，与 DeepSeek / 幻方无官方从属关系；插件信息以仓库 README 为准。
结尾¶
dsh-reminder 把「任务完成」和「等待审批」两类事件做成跨窗口提醒，点击即可回到会话，改动范围限于通知层，不碰 DSH 核心逻辑。若你已在用 DSH Web 端并希望减少「切回去看一眼」的频率，可以按上文步骤安装试用。
