前言¶
在 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 播放定制语音。
