前言¶
用 DeepSeek Harness（DSH）跑长任务时，窗口往往会被切到 IDE、浏览器或文档里。任务在后台完成、等你点批准、等你补一句上下文，或者执行失败，如果没有任何反馈，只能反复切回 DSH 看状态。系统自带的焦点切换也帮不上忙——你并不缺「通知能力」，缺的是和 DSH 会话绑定的、一点就能回到对应任务链路的提醒。
下面介绍社区插件 dsh-donevoice（DoneVoice）：在 Windows 桌面版 DSH 上，由宿主进程在任务进入几种关键状态时发出提醒，并支持从通知直接回到会话。
这是什么¶
dsh-donevoice 是 DSH 的完成与待办提醒插件，维护者为 zywnb-2。它在 README 中的定位是「DSH 的完成提醒官」：当任务完成、等待许可、需要回答或执行失败时，通过页内卡片、整屏流光边框加顶部卡片，或 Windows 系统通知（视设置与当前是否聚焦 DSH 而定）加上提示音提醒你；点击通知可回到对应会话，若 DSH 未运行则会尝试启动。
插件归类为 客户端，在 DSH 生态里属于「一切皆插件」思路下的桌面增强；社区目录 SkillHub 上的条目 与 GitHub 仓库相互独立，并非 DeepSeek 或幻方官方应用商店。
核心功能¶
提醒覆盖四类事件，内容与 README 中的说明一致：
| 场景 | 通知要点 |
|---|---|
| 任务完成 | 「任务完成」、会话名、本次耗时 |
| 等你审批 | 「等待你的许可」、工具名、理由 |
| 等你回答 | 「需要你的回答」、第一个问题 |
| 执行失败 | 「执行失败」、错误摘要；失败提示音为下行调，便于与成功区分 |
行为上的几个要点：
- 点击通知回到会话；DSH 未在跑时会帮你启动。
- DSH 最小化、切走、标签被冻住时仍可收到；正看着 DSH 时不弹系统通知，切走之后才弹。
- 子代理不单独提醒（避免刷屏），由主管会话统一提醒一次。
两种提醒形态¶
在设置里可随时切换，默认「页内卡片」，两种形态是替代关系，不是叠加：
| 你的状态 | 页内卡片（默认） | 顶部提醒 |
|---|---|---|
| 正看着 DSH | 右下角弹卡片（可堆叠） | 整屏彩色边框 + 屏幕上方中间弹卡片 |
| 切走 / 最小化 | 系统通知 + 音效 | 整屏彩色边框 + 顶部卡片 + 音效 |
「顶部提醒」模式下，边框可调 羽化 / 浓度 / 流速；亮屏时长跟随提示音，更换音效会改变时长。自带提示音来自 Pixabay，MIT 许可下可免费商用、无需署名（见仓库 LICENSE 与 sounds/SOURCES.md）。
安装与启用¶
环境：仅 Windows 10 / 11；DSH 桌面版 0.2.0-rc.2（DoneVoice 1.3.1 与之对应）；不需要管理员权限。Node 引擎要求 >=20（见 package.json）。
1. 安装
在 DSH 中打开 设置 → 插件 → 添加插件，粘贴官方安装串（版本号不要删，# 后锁定发布 tag）：
github:zywnb-2/dsh-donevoice#v1.3.1
不写 #v1.3.1 会跟随可能变动的 main 分支。
2. 重启 DSH。
3. 打开「设置 → 提醒 → 总开关」
默认是 关 的；「装了没反应」常见原因是未打开总开关。
4. 验证
切到别的窗口，让 DSH 跑一个任务，观察完成或待办时的提醒。第一次提醒可能慢约 2 秒（加载提示音），之后接近瞬时。
升级：在插件页卸载旧版 → 修改安装串中 # 后的版本 → 重新添加 → 重启 DSH。
卸载：在内置插件列表移除该插件后重启 DSH。
典型用法¶
没有单独的 CLI；用法就是安装、打开提醒总开关，然后在日常使用 DSH 时把窗口切走或最小化，依赖后台任务触发提醒。
建议流程：
- 安装并重启后，确认 设置 → 提醒 → 总开关 已开。
- 在 设置 → 提醒（或插件相关设置）里选择「页内卡片」或「顶部提醒」，并按需调节顶部模式的边框参数。
- 发起一条会跑较久的 agent 任务，切换到其他应用，等待完成或出现「等待许可 / 需要回答 / 执行失败」之一。
- 点击系统通知或页内卡片，确认是否跳回对应会话。
正聚焦 DSH 时以页内或顶部卡片为主；切走后才会配合 Windows 系统通知（页内卡片模式下）。
适用场景与注意¶
适合谁：在 Windows 上用 DSH 桌面版做长任务、多会话并行，且经常切到其他窗口的开发者；需要审批工具调用或及时回复提问时，提醒能减少空等。
平台限制：README 明确仅 Windows；Linux / macOS 用户当前不应指望同一套原生通知与 overlay 行为。
安全与信任：插件以当前 DSH 进程权限运行，会通过 Cordis patch（cordis.patch.yml）与宿主、客户端脚本（client.js、win-native.js 等）协作。安装前可在 GitHub 仓库 阅读源码与 MIT 许可证，自行判断是否纳入工作流。
与目录简介的差异：SkillHub 简介提到「可自定义上传音效」；当前抓取的 README 未描述上传自定义音效的步骤，正文以 README 中的内置音效与顶部模式时长说明为准。若后续版本补充上传能力，以仓库 CHANGELOG 为准。
结尾¶
dsh-donevoice 把「任务完成 / 待审批 / 待回答 / 失败」四类状态绑到桌面级提醒上，并支持一键回到会话，适合 Windows 上长时间后台跑 DSH 的场景。安装时记得版本 pin 与提醒总开关。
