前言¶
在 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」拆成可配置的四步流程，并与音色工坊的播放链路对接，降低自建适配的样板成本；实际音质、费用与稳定性仍需按目标供应商自行验证。
