DeepSeek Harness (DSH) 语音提醒插件介绍

前言¶

在 DSH 开发或使用智能体时，会话状态的变化（如任务完成或等待用户输入）可能悄无声息地发生。为了解决遗漏重要通知的问题，我们介绍 roger-yang-cn/dsh-voice-alert。这是一个 DSH 浏览器插件，旨在通过听觉和视觉反馈，帮助用户及时感知会话状态。

是什么¶

dsh-voice-alert 是一个由 Roger-Yang-CN 维护的客户端插件。它通过监听会话状态，在特定事件触发时提供语音提示、页面弹窗和系统通知。

核心功能¶

该插件提供以下能力：

1. 语音播放：当任意会话完成任务（回合结束）或请示用户时，播放指定的语音提示。
2. 顶部提示条：在页面顶部显示提示条，6秒后自动消失，支持点击关闭。
3. 系统通知：当页面失焦或最小化时，发送系统通知，点击可跳回 DSH。
4. 语音素材：内置「千织」语音。支持自定义替换，需保持文件名不变。

安装与启用¶

由于插件使用 file: 依赖，且 pnpm 对该类型的依赖不会自动刷新，需要手动同步插件副本。

1. 克隆仓库：将 roger-yang-cn/dsh-voice-alert 克隆到本地任意目录。
2. 配置依赖：编辑 DSH profile 的 package.json（如 ~/.dsh/profiles/web/package.json），添加依赖与 bundle 配置：

"dependencies": { "dsh-voice-alert": "file:<克隆到的绝对路径>" },
"dsh": { "profile": { "bundles": [ "...", "dsh-voice-alert" ] } }

3. 安装依赖：在 profile 目录执行 pnpm install。
4. 手动同步插件副本：将插件目录的 lib/、assets/ 复制到 node_modules/dsh-voice-alert/。
5. 重启：重启 DSH，页面出现提示条即生效。

典型用法¶

插件会自动监听会话状态，无需额外配置：

• 任务完成：当任意会话回合结束时，自动播放语音并弹出提示条。
• 请示用户：当任意会话触发 ask_user_question、审批或方案评审时，触发语音与提示条。
• 自定义语音：替换 assets/ 下的 任务已完成.wav 或 请求决策.wav，保持文件名不变即可生效。

适用场景与注意¶

• 权限要求：首次触发时浏览器会请求通知权限，需允许后失焦提醒才可用。
• 依赖机制：务必手动将插件的 lib/ 和 assets/ 复制到 node_modules，因为 pnpm 的 file: 依赖不会自动刷新。
• 许可证：目前未在资料中明确说明许可证，安装前建议检查源码。

总结¶

该插件通过语音和弹窗机制，帮助用户及时感知 DSH 会话状态变化。更多详情与源码请访问 GitHub。