前言¶
用 DeepSeek Harness（DSH）跑复杂任务时，常见情况是命令和工具调用连续刷屏，正文却迟迟不出现。你能看出代理还在跑，但不知道做到哪一步、下一步打算做什么。社区插件 过程播报（jevonhou/dsh-progress-narration，npm 包名 dsh-plugin-progress-narration）通过在工作流里插入「该说两句了」的提醒，引导模型在关键节点用正文简短说明进度，而不是憋到最后一次性汇报。
这是什么¶
过程播报 是维护者 jevonhou 发布在 SkillHub「工作流」分类下的 DSH 插件。源码版本为 0.2.11，许可证 MIT。它不改变 DSH 的执行能力，而是在会话侧按你选的档位，检测模型是否连续只调用工具；达到阈值时，在后续请求里带上简短提醒，促使代理用自然语言同步进展（例如「找到问题了，我先修这儿」或「改好了，我跑一下测试」）。
核心功能¶
三档播报频率¶
在会话输入框右侧通过气泡图标打开面板，可选择或拖动「胶囊」设置档位，松手后生效；也可用方向键选档，Esc 关闭。图标会反映当前已保存的档位，面板右上角圆形箭头可恢复默认。
| 档位 | 建议的播报节奏 |
|---|---|
| 克制 | 开始前和关键节点简短说明 |
| 标准（默认） | 大约每两三步同步一次 |
| 话多 | 尽量在每个步骤完成后同步 |
触发逻辑（服务端）¶
index.js 按档位统计模型是否连续只调用工具。克制、标准、话多分别在连续 6、3、2 步工具调用后，下一次请求会附带简短提醒。默认仅对主代理启用播报提醒；档位越高，模型输出 token 通常越多。
界面与客户端¶
client.js 负责气泡图标与播报频率面板；插件以 JavaScript 在 Harness 内直接运行，无需单独构建。界面约定见仓库内 DESIGN.md。
安装与启用¶
需要 DeepSeek Harness 0.2.2-rc.1 或更新版本。README 写明已在 macOS 上验证，其他平台尚未实测。
- 打开「设置 → 插件」，点击「添加插件」。
- 输入 GitHub 仓库地址
https://github.com/jevonhou/dsh-progress-narration，按提示安装当前源码版本；安装入口也接受该仓库的本地绝对路径。 - 若要用 npm 已发布版本，在添加插件时输入包名
dsh-plugin-progress-narration（版本以 npm 徽章为准）。 - 回到会话，确认输入框右侧出现带点的气泡图标。
卸载：在「设置 → 插件 → 过程播报」中选择「卸载」。
典型用法¶
安装并确认气泡图标出现后，无需改配置文件即可使用。根据任务长度与你对「废话率」的容忍度选档即可：
- 长链路排障、希望少打断：克制。
- 日常协作、希望每隔几步有一句正文：标准（默认）。
- 需要逐步跟读代理思路：话多。
档位会持久保存；修改后图标状态会随之更新。
适用场景与注意¶
适合谁： 经常让 DSH 多步调用工具、又希望在对话正文里看到阶段性说明的开发者；归类为工作流类插件，侧重交互节奏而非新工具能力。
运行与权限： 插件与当前 DSH 进程同权运行。安装前建议浏览 GitHub 仓库 源码与 MIT 许可证，确认来源与行为符合你的环境策略。
平台： 官方说明仅 macOS 实测；Linux / Windows 需自行验证。
生态说明： DSH 奉行「一切皆插件」；SkillHub 目录页 为社区站点，与 DeepSeek / 幻方无官方从属关系，并非官方应用商店。
结尾¶
过程播报解决的是「工具一直在动、正文一言不发」的可见性问题：用可调档位在主代理连续工具调用时插入提醒，让进度回到对话正文里。需要安装步骤与源码时，见目录页 https://www.skillhub.cn/plugins/jevonhou/dsh-progress-narration 与 GitHub https://github.com/jevonhou/dsh-progress-narration。
