前言¶
在 DeepSeek Harness（DSH）裏調試智能體時，長回覆往往要掃一眼文字才能跟上節奏；若希望邊聽邊改 prompt、或在不方便盯屏的環境裏跟進對話，就需要把模型輸出轉成語音。瀏覽器自帶的朗讀或外接 TTS 服務可以湊合，但密鑰管理、音色切換和「按句停止」往往要另搭一層。下面介紹維護者 hangdingding 提供的 BreezeTTS 插件（社區目錄條目 hangdingding/breezetts-dsh-0.2-archive，package 名 breezetts-dsh，當前資料中版本爲 0.2.3）：面向 DSH 的官方 Breeze 語音集成，優先走 Breeze CLI 設備登錄，CLI 不可用時回退 Breeze API。
這是什麼¶
BreezeTTS for DSH 是 DeepSeek Harness 上的 Breeze 語音插件：把助手回覆朗讀出來。README 說明其優先使用 Breeze CLI（breeze 命令，設備登錄、無需在插件裏粘貼 Key）；CLI 不可用時回退 Breeze API（需 brz_ 前綴的 Key）。分類歸屬爲模型推理；源碼與說明見 GitHub 倉庫，目錄頁見 SkillHub 插件頁。
核心功能¶
經 README 覈實，插件在 Web 客戶端注入對話 UI，主要能力包括：
- 每條回覆旁的朗讀按鈕，可隨時停止；
- 自動朗讀開關；
- 音色搜索、試聽與即時切換；
- 音色設計：用描述生成 3 個預覽，保存後使用；
- 語速、語言、發音指導等參數；
- 餘額顯示，以及邀請與福利入口。
引擎可在設置中切換：自動（默認）（CLI 已登錄則優先 CLI，否則 API）、CLI 優先（失敗不降級）、API 優先（僅 HTTP API，需 brz_ Key）。CLI 憑據存放在 ~/.breeze/credentials.json，插件不讀取、不保存 Key。
此外插件向模型註冊工具 breeze_speak，供助手在合適時主動合成定製語音（見下文典型用法）。
安裝與啓用¶
DSH 生態裏插件通常通過 Harness 的安裝入口添加；本插件 README 給出的 GitHub 安裝標識如下（勿自行改倉庫名拼接）：
github:hangdingding/breezetts-dsh
也可以將插件目錄拷貝進 DSH 的插件目錄完成本地安裝。
第一次連接 Breeze¶
打開插件設置 → 「Breeze CLI」卡片 → 點 連接 Breeze：
- 若未安裝 CLI，會自動執行官方安裝腳本；
- CLI 打開瀏覽器，在瀏覽器中完成授權；
- 插件輪詢登錄狀態，成功後顯示「已連接」。
無圖形界面的服務器上，可使用 breeze login --no-browser，或爲進程設置環境變量 BREEZE_API_KEY。
配置項¶
設置面板可改：API Key、音色、語速、語言、發音指導、引擎、CLI 路徑。其餘項在 cordis.patch.yml 中維護。
典型用法¶
界面朗讀¶
啓用自動朗讀，或在單條回覆上點朗讀；需要靜音時點停止即可。音色與語速在設置裏調整，與設計好的「音色設計」流程配合使用。
模型調用 breeze_speak¶
插件註冊模型工具：
breeze_speak(text, voice_id?, instructions?, speed?)
當用戶要求用特定音色或語氣念某段話時，模型可調用該工具。插件通過 Breeze CLI 合成音頻並放入待播隊列；回覆結束後瀏覽器播放這段定製音頻，而不是用默認音色朗讀整段文字。若工具未被調用，行爲不變：自動朗讀與朗讀按鈕仍使用設置裏的音色。README 註明隊列爲全局隊列，適合單人使用；多會話併發會按先後順序播放。
適用場景與注意¶
適合在 DSH Web 對話裏需要聽讀助手輸出、或希望模型通過 breeze_speak 輸出定製語音的場景。CLI 路徑適合本機已裝 Breeze、希望免 Key 登錄的情況；純 API 或 headless 環境需準備 brz_ Key 或 BREEZE_API_KEY。
插件與當前 DSH 進程同權限運行，安裝前應自行查看倉庫源碼與許可證（資料中未單獨列出許可證字段，以倉庫爲準）。DeepSeek Harness 社區插件目錄（如 SkillHub）爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；本文事實以倉庫 README 與 package 元數據爲準。
鏈接¶
- 目錄頁：https://www.skillhub.cn/plugins/hangdingding/breezetts-dsh-0.2-archive
- GitHub：https://github.com/hangdingding/breezetts-dsh-0.2-archive
經過上面的步驟，你可以在 DSH 裏用 Breeze 把回覆讀出來，並在需要時讓模型通過 breeze_speak 播放定製語音。
