DeepSeek Harness 语音播报插件：自动提醒与音效库

前言¶

DeepSeek Harness (DSH) 侧重于智能体开发与编排。在调试或运行过程中，开发者需要明确的反馈来确认任务状态。现有的命令行工具往往缺乏听觉反馈。DSH 语音播报插件通过在对话轮次结束或出错时自动发声，解决了这一反馈缺失的问题。

它是什么¶

这是一个 DSH 对话语音播报插件。当对话轮次结束时，它会自动提醒；当出现错误或工具失败时，它会播报失败提示。插件内置 20 个音效（提醒 10 个 + 大自然 10 个），零配置即可开箱即用。同时，它支持通过火山「声音复刻」功能克隆自己的音色。

核心功能¶

1. 自动播报
   每个对话轮次结束时自动播报「完成」语音。当 turn 内出现错误（agent/error 或工具 isError）时，播报「失败」语音。

2. 内置音效
   零配置开箱即用，内置 20 个音效（提醒 10 个 + 大自然 10 个），无需 API Key。

3. 音色克隆
   支持使用火山「声音复刻」功能克隆音色。

4. 播放兼容性
   默认使用 waveOut/WAV 播放内核。实测不吞第一声、不打断蓝牙耳机上正在播放的音乐。绝不改动系统音量或静音状态。

5. 日志
   提供毫秒级阶段日志。

典型用法¶

1. 零配置使用
   直接使用默认的内置音效，无需任何 API Key 或音频文件。

2. 自定义音色
   使用火山「声音复刻」克隆自己的音色，填入 ID 和 Key。

3. 蓝牙耳机适配
   调整系统音量唤醒蓝牙耳机。设置 prewarmMs: 0 以避免打断蓝牙音乐。

安装与启用¶

通过插件目录安装。访问 DSH 插件目录 找到该插件，或通过 GitHub 仓库 loyalchiiina/dsh-voice-alert 获取源码。

适用场景与注意¶

适合需要在对话过程中获得听觉反馈的开发者与用户。播放失败会全线静默降级，不会影响 DSH 的正常运行。安装前应检查源码与许可证。

结尾¶

该插件通过自动语音播报和音效提醒，为 DSH 提供了直观的状态反馈能力。更多细节可参考 插件目录 或 GitHub 仓库。