前言¶
在 DSH Web 裏用音色工坊做朗讀、試聽和播放時，如果只想換一家 TTS 供應商，往往需要自己對接 Base URL、鑑權、模型與音色目錄，還要和工坊裏的選擇與播放流程對齊。dsh-speech-provider-adapter 是社區維護的示例插件，演示如何把外部語音 API 掛進 音色工坊（dsh-xiaomi-tts），由適配器管連接與合成，由工坊管交互與播放。
這是什麼¶
dsh-speech-provider-adapter（倉庫 ppy-web/dsh-speech-provider-adapter）歸類爲模型推理相關能力，維護者爲 ppy-web。README 明確：本項目是 示例實現，提供接入思路與配置管理，不保證實際效果、供應商兼容或服務穩定；預設協議與音色不代表完整實測，費用與延遲以目標供應商爲準。
分工上，適配器負責供應商名稱、Base URL、API Key、協議、模型與音色目錄，並調用上游生成音頻；音色工坊負責模型與音色選擇、試聽、朗讀、播放控制、歷史、下載等。
核心功能¶
內置與示例供應商¶
當前 README 列出的示例適配包括：SenseAudio（商湯）、OpenAI compatible、MiniMax（稀宇科技）、SiliconFlow（硅基流動）、ElevenLabs、Fish Audio、Alibaba Cloud Bailian（阿里雲百鍊）、Tencent Cloud（騰訊雲），以及音色工坊內置的小米 MiMo TTS、豆包 Seed TTS（火山引擎）、Breeze Blue TTS，和 Custom local model（本地 OpenAI 風格 /audio/speech）。支持多套供應商配置、目錄查詢與手動補充、完整音頻與流式播放（各服務兼容情況需分別調試）。
部分要點（均來自官方 README，使用前請自行驗證）：
- 百鍊走 Qwen-Audio-TTS HTTP，需業務空間地址與同地域 API Key。
- 騰訊雲走 TextToVoice API 3.0，需 SecretId / SecretKey，當前僅完整音頻；測試連接與目錄刷新暫不可用，保存後建議用工坊試聽驗證。
- 自定義本地模型可在高級選項裏配置請求方法、路徑、頭、JSON 模板、編碼與取音方式，連接步驟支持探測本機端口。
管理界面與接管¶
管理頁爲原生 HTML、CSS、JavaScript，不引入 shadcn、Tailwind 或額外構建步驟。配置流程爲四步：連接供應商 → 配置模型列表 → 配置音色列表 → 保存與接管；支持供應商搜索、從接口拉取模型與音色（去重追加）或手動填寫，左側有全局接管按鈕（統一控制所有供應商，底色示意開/關）。首次運行接管默認關閉，需自行開啓並驗證合成效果。
安裝與啓用¶
環境要求：Node.js 24.9+ 與 DSH Web；package.json 中 engines 爲 node >= 24.9.0，dsh 爲 >=0.2.2-0 <0.3.0-0，並依賴 peer dsh-xiaomi-tts（>=5.2.0-next.0 <6）。當前 npm 包版本爲 0.1.1，許可證 MIT。
在同一宿主實例中先裝支持外部供應商的音色工坊，再裝適配器：
dsh plugin --profile web add dsh-xiaomi-tts@latest
dsh plugin --profile web add dsh-speech-provider-adapter@latest
安裝後在 DSH 插件管理中啓用供應商適配器組件，按宿主提示重啓或重新加載。更細的步驟見倉庫 usage.md。若曾用本地鏈接安裝，Windows 下可用倉庫內的 clear-local-links.cmd 清理適配器安裝記錄後再重裝（腳本會備份改過的配置，不刪源碼或供應商配置）。
典型用法¶
- 在 DSH 插件管理中打開供應商適配器的配置區，新增供應商並填寫連接信息、模型和音色。
- 設爲當前供應商，啓用接管並保存，再用短文本在音色工坊中試聽，確認實際合成與播放。
想快速試 API 時，README（2026-11-06 整理）提到 Fish Audio 的 s2.1-pro-free 對新賬號可能可在無餘額下調用，需在適配器中選對應協議、模型設爲 s2.1-pro-free 並填寫可用參考音色 ID；ElevenLabs、百鍊、騰訊雲等免費額度規則以各官方頁面爲準，有額度也不代表本插件已完成適配或實測。
適用場景與注意¶
適合誰：已在 DSH Web 使用音色工坊、希望切換或並列多套 TTS 供應商（含本地 OpenAI 兼容端點）的開發者；願意按官方文檔自行調試協議與音色的貢獻者也可通過 Issue / PR 擴展預設。
使用注意：
- 插件在 當前 DSH 進程權限 下運行，配置中會涉及 API Key 等敏感信息；安裝前建議查看源碼與 MIT 許可證，勿在 Issue 中提交真實密鑰。
- 目錄查詢成功不代表合成一定可用；雲廠商部分能力（如百鍊/騰訊的測試連接與目錄刷新）README 標明暫不可用，應以保存後的試聽結果爲準。
- 社區目錄頁 skillhub.cn 與 GitHub 爲獨立生態信息來源，與 DeepSeek / 幻方無官方從屬關係。
新增供應商或修復兼容性可參考 README 中的 Issue / PR 指引，提交時儘量附協議文檔、版本信息、脫敏日誌與復現步驟。
結尾¶
dsh-speech-provider-adapter 的價值在於把「接一家 TTS」拆成可配置的四步流程，並與音色工坊的播放鏈路對接，降低自建適配的樣板成本；實際音質、費用與穩定性仍需按目標供應商自行驗證。
