前言¶
在 DeepSeek Harness（DSH）里跑 agent 时，界面里往往同时有思考、工具调用、读文件、执行命令等步骤。眼睛要盯日志或时间线，长时间盯屏容易累，也不方便在旁边做别的事时掌握进度。
常见做法是事后翻对话记录，或自己盯着 UI 看状态变化。dsh-live-narrator（社区里也叫「小嘴 · 实时解说」）走的是另一条路：不调用模型，只用浏览器自带的语音合成，在 agent 每进入一个新动作时，用一句短话把「正在发生什么」念出来。下面介绍它是什么、能做什么，以及如何在本机安装与使用。
这是什么¶
dsh-live-narrator 是 DSH 的 Web 客户端插件，由维护者 yinque91 发布，在 SkillHub 插件目录 中归类为「客户端」。它挂在对话输入框正下方，不占对话主区域；不负责推理或工具执行，只把 agent 侧可见的动作翻译成口语并播放。
插件当前包名为 @local/live-narrator（本机私有链接写法），版本 0.1.0，许可证 MIT。Host 侧 index.js 的 apply() 为空，逻辑全部在浏览器侧的 client.js。
核心功能¶
以下能力均来自项目 README，可按需对照源码核实。
- 常驻横条：贴在输入框下方，不挤占消息列表。
- 开关与记忆：点击即可开/关；状态写入
localStorage，刷新页面后仍保留。 - 实时解说：agent 每进入一个新动作（思考、调用工具、读文件、跑命令等），生成一句短话并朗读，而不是把整个回答从头到尾读一遍。
- 音色选择：下拉列出系统可用语音，选中后会播放一句示例。
- 可视化反馈：朗读时头像嘴部有动画，右侧有电平跳动。
- 零后端：无独立服务端、无额外网络请求、无需 API key。
安装与启用¶
官方文档给出两种方式。生产环境若要从 npm 或 dsh plugin add 分发，需先把 package.json 的 name 从 @local/live-narrator 改成例如 dsh-live-narrator 再发布；下文以 README 中的本地开发安装为准。
本地链接安装（开发用）¶
将插件目录放到本机后，在对应 profile 下执行（路径换成你的实际目录；示例为 Windows 路径写法）：
dsh plugin --profile desktop add link:C:\path\to\live-narrator
执行后需要 重启一次 DSH，bundle 层才会重新组装并加载插件。
手动挂载¶
- 把整个插件目录放到任意位置。
- 编辑
~/.dsh/profiles/<profile>/package.json，在dsh.profile.bundles中加入包名。 - 用
link:依赖指向该本地目录。
包名在默认配置下为 @local/live-narrator。
配置与存储¶
插件不在 DSH host 侧提供配置项；浏览器本地只使用两个键：
| 键 | 含义 |
|---|---|
dsh.live-narrator.enabled |
是否开启解说（1 / 0） |
dsh.live-narrator.voice |
选中的语音 URI；空表示系统默认 |
界面上的开关与音色下拉会读写上述键，一般无需手改。
典型用法¶
- 按上一节完成安装并重启 DSH，打开 Web 客户端对话页。
- 在输入框下方找到「小嘴」横条，点开开关启用解说。
- 在音色下拉中选一个系统语音，听示例句确认效果。
- 正常发起对话，让 agent 执行带工具调用的任务；每进入新动作时应听到一句短解说，而不是整段回复的朗读。
- 不需要语音时再次点击开关即可关闭，状态会保留到下次访问。
改 client.js 时，若本地正在跑 pnpm run dev:web，客户端模块可热加载；否则刷新页面即可看到变更。
适用场景与注意¶
适合谁：需要在 DSH Web 界面里「听进度」的开发者；希望 agent 跑长任务时少盯屏、用耳朵跟进思考与工具步骤的场景。
技术边界：解说内容来自客户端能观察到的 agent 动作，质量取决于 Web Speech API 与系统语音包；不同浏览器、操作系统下可用音色不一致。
安全与权限：与 DSH 生态中其他插件一样，客户端插件随当前 DSH 会话在浏览器中运行；安装前请阅读 GitHub 仓库 源码与 MIT 许可证，确认符合你的使用环境。SkillHub 为社区目录站点，与 DeepSeek / 幻方无官方从属关系，本文安装步骤以仓库 README 为准。
结尾¶
dsh-live-narrator 用输入框下的一条小横条，把 agent 的动作变成短句语音，不增加模型调用和后端依赖。若要在本机试用，可从目录页了解概况，并按 README 用 link: 方式挂到 profile 后重启 DSH。
