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。
