前言¶
在 DeepSeek Harness（DSH）裏調試智能體時，回覆往往很長：讀屏、切窗口成本高，也不適合一邊寫代碼一邊盯文本。瀏覽器自帶的朗讀能力音色有限，和對話產品綁定的 TTS 又很難接到自建 Harness 上。BreezeTTS 插件把 Breeze 的語音合成接到 DSH 對話界面：每條回覆可以點讀、可以自動朗讀，需要時還能讓模型通過工具指定音色和語氣。下面介紹插件 hangdingding/breezetts-dsh 的定位、安裝方式與典型用法。
這是什麼¶
breezetts-dsh 是面向 DeepSeek Harness 的 Breeze 語音插件（README 表述爲官方 BreezeTTS 插件）。維護者爲 hangdingding，在社區目錄中歸類爲模型推理。當前 package.json 版本爲 1.0.8。
插件解決的核心問題：把助手回覆轉成可播放的語音。合成路徑優先使用本機 Breeze CLI（breeze 命令，設備登錄、無需在插件裏粘貼 Key）；CLI 不可用時回退到 Breeze API（需 brz_ 前綴的 API Key）。
核心功能¶
對話界面朗讀¶
- 每條助手回覆提供朗讀按鈕，可隨時停止；
- 支持自動朗讀開關；
- 音色支持搜索、試聽與立即切換；
- 音色設計：用自然語言描述需求 → 生成 3 個預覽 → 保存並使用；
- 可調節語速、語言、發音指導；
- 設置面板中可查看餘額，並提供邀請與福利入口。
引擎策略¶
| 引擎 | 說明 |
|---|---|
| 自動（默認） | CLI 已登錄則優先 CLI，否則使用 API |
| CLI 優先 | 僅 CLI，失敗不降級 |
| API 優先 | 僅 HTTP API，需配置 brz_ Key |
CLI 憑據保存在 ~/.breeze/credentials.json；插件不讀取、不保存 Key。
模型工具 breeze_speak¶
插件向模型註冊工具 breeze_speak，簽名如下：
breeze_speak(text, voice_id?, instructions?, speed?)
當用戶要求用特定音色或語氣朗讀某段話時，模型可調用該工具。插件通過 Breeze CLI 合成音頻並放入待播隊列；回覆結束後瀏覽器播放這段定製音頻，而不是用設置裏的默認音色朗讀整段文字。
- 若本輪未調用工具，行爲與平時一致：自動朗讀 / 朗讀按鈕仍使用設置中的音色；
- 播放隊列爲全局隊列，適合單人使用；多會話併發時按先後順序播放。
安裝與啓用¶
README 給出的安裝方式有兩種：
- 通過 GitHub 源標識安裝（具體以你當前 DSH 版本的插件安裝命令爲準，源爲）：
github:hangdingding/breezetts-dsh
- 或將插件目錄複製/鏈接到 DSH 的插件目錄。
安裝前請自行查看倉庫源碼與許可證；插件以當前 dsh 進程權限運行，涉及 CLI 安裝腳本與網絡訪問，應在可信環境中操作。
第一次連接 Breeze¶
打開插件設置 → 「Breeze CLI」 卡片 → 點擊 連接 Breeze：
- 若本機未安裝 CLI，會執行官方安裝腳本；
- CLI 打開瀏覽器，在瀏覽器中完成授權；
- 插件輪詢登錄狀態，成功後顯示「已連接」。
無圖形界面的服務器可改用：
breeze login --no-browser
或爲進程設置環境變量 BREEZE_API_KEY（API 路徑）。
配置項¶
設置面板可改：API Key、音色、語速、語言、發音指導、引擎、CLI 路徑。其餘項見倉庫中的 cordis.patch.yml。
典型用法¶
手動聽回覆：在對話中點擊某條回覆的朗讀按鈕，或打開自動朗讀，用設置裏選好的音色播放。
讓模型定製朗讀：在對話中說明音色與語氣，例如要求用某暱稱版音色、溫柔一點念某段話；模型調用 breeze_speak 後，你會在回覆結束後聽到對應合成音頻。
只用 API：在設置中將引擎設爲「API 優先」，填寫 brz_ Key；或在無 CLI 環境下依賴 BREEZE_API_KEY。
適用場景與注意¶
適合在 DSH Web 客戶端中長期調試、希望少看長文本、或需要 Breeze 音色與設計能力的開發者。CLI 路徑適合本機已用 Breeze 生態、希望免 Key 登錄的場景；API 回退適合 CI、遠程無瀏覽器機器。
務必注意：社區插件目錄（如 SkillHub）爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；星標與版本以倉庫爲準，使用前核對 README 與 package.json。
結尾¶
breezetts-dsh 把 Breeze CLI 與 API 雙路徑接到 DSH，覆蓋按鈕朗讀、自動朗讀、音色設計與模型側 breeze_speak 定製播放。需要進一步瞭解分類與簡介時，可查看目錄頁與 GitHub 倉庫。
- 目錄頁：https://www.skillhub.cn/plugins/hangdingding/breezetts-dsh
- GitHub：https://github.com/hangdingding/breezetts-dsh
