前言¶
在 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
