DeepSeek Harness（DSH）采用「一切皆插件」的架构。在 Agent 开发中，助手回复结束后的反馈往往被忽略，导致交互体验生硬。为了在对话结束时提供自然的听觉反馈，本地化生成提示音是一个可行的方案。该插件提供了一套完整的解决方案，无需依赖外部 API，即可在窗口右下角切换并试听音色。
插件简介¶
这是一个 DeepSeek Harness 完成提示音 Bundle，包含八种音色、右下角控制面板以及自动保存功能。插件维护者为 gkgy，采用 MIT 许可证。它主要解决 Agent 回复结束后缺乏提示音反馈的问题，通过本地预生成文件实现快速播放。
核心功能¶
- 八种音色：提供默认的「3号·逗趣男声」，以及低沉男声、清亮男声、沙哑大叔、温柔女声、活泼女声、卡通高音、电子机器人等七种音色。所有音色均为预生成文件，播放时无需加载语音模型或调用外部 API。
- 本地生成音频：音频完全本地化，通过预定义的 ID 查找文件。
- 右下角控制：在 Harness 窗口右下角提供音色选择和「测试提示音」按钮，操作直观。
- 持久化与生命周期：音色选择会自动保存。插件遵循 DSH 0.2.1 Session lifecycle，仅在
running → idle状态变化时触发，不会为历史回复、会话切换或失败请求播放声音。
安装与启用¶
推荐使用静态 Bundle 方式安装。首先克隆仓库并安装依赖：
git clone https://github.com/gkgy/dsh-plugin-laile-laodi.git
pnpm install
在 DSH 桌面 profile 的 package.json 中，将本包加入 dependencies 和 dsh.profile.bundles。保留已有插件和配置，将示例路径替换为克隆目录的绝对路径：
{
"dependencies": {
"dsh-plugin-laile-laodi": "link:/absolute/path/dsh-plugin-laile-laodi"
},
"dsh": {
"profile": {
"bundles": ["dsh-plugin-laile-laodi"]
}
}
}
在该 profile 目录使用包管理器安装依赖（如 pnpm install），然后重启 Harness。本包同时声明宿主和客户端入口，Bundle 会自动加载二者，请勿重复添加动态宿主，否则音频路由会冲突。
典型用法¶
安装完成后，在 Harness 窗口右下角 选择音色，点击 测试提示音。用户手势可以启用浏览器声音播放。之后助手正常回复结束时，会自动播放所选声音。
配置项¶
插件提供以下宿主配置：
audioPath：默认为包内assets/laile-laodi.mp3，用于无音色参数时的默认文件。route：默认为/laile-laodi.mp3，音频路由地址，修改时也需同步修改客户端 URL。
客户端通过 ?voice=chosen-3 等参数选择音色。只有预定义 ID 会被用于查找文件，URL 参数不会直接作为磁盘路径。
注意事项¶
- 播放限制：浏览器的声音策略、系统静音和输出设备仍可能影响播放。显示的“提示音已播放”仅表示播放器接受了请求，不代表声音实际发出。
- 硬件依赖：如需重新生成音频，需要 Apple Silicon、Python、MLX 和 FFmpeg。输出默认保存在
generated/目录，不会直接覆盖已发布音频。 - 安装冲突：不要同时启用静态 Bundle 和动态宿主。
- 音频来源：详细的音频来源、生成参数和哈希见
AUDIO_PROVENANCE.md。
