dsh-multi-tts
Read assistant replies aloud in DeepSeek Harness — pick your own TTS provider and voice.
English | 中文
A multi-provider text-to-speech plugin for DSH: a 🔊 button next to every assistant reply, an auto-read toggle in the composer, and a settings page where you choose the provider, the voice, the emotion and the speed. No build step — plain ESM + hand-written React.
Features
- 🔊 Per-reply read-aloud — a button on every assistant message; click again to stop.
- 🔇 Auto-read toggle — sits in the composer's left slot; new replies are spoken automatically.
- ⚙️ Multi-provider settings page — provider dropdown, voice dropdown, manual voice ID, emotion, speed, model, base URL, API key, and a one-click test button.
- 🧹 TTS-friendly text cleanup — code blocks, inline code, URLs, file paths, markdown emphasis and list bullets are stripped before speaking.
- 🔑 Flexible key resolution — plugin config → environment variable →
$DSH_HOME/.env → common key names in .env.
- 📦 Zero build — the client bundle is hand-written
React.createElement shipped as-is in lib/.
Providers
| Provider | Endpoint | Built-in voices | Emotion |
|---|
minimax | MiniMax (Hailuo) /v1/t2a_v2 | 12 Chinese voices (e.g. female-shaonv, qiaopi_mengmei, lovely_girl) | ✅ |
openai | any OpenAI-compatible /audio/speech | 6 voices (alloy, echo, fable, onyx, nova, shimmer) | — |
Any OpenAI-compatible endpoint works through the openai provider — just set the base URL (OpenAI, DashScope, SiliconFlow, local servers, …).
Install
dsh plugin --profile web add dsh-multi-tts
Then add the package to the profile's bundle list (dsh plugin add only writes the dependency — dsh.profile.bundles is what actually mounts the plugin):
{
"dsh": {
"profile": {
"bundles": ["dsh-multi-tts"]
}
}
}
Restart DSH, then open Settings → Multi TTS / 语音朗读.
Configure
- Open the plugin's settings section.
- Pick a provider, then a voice (or paste any voice ID).
- Paste an API key, or put one in
$DSH_HOME/.env:
MINIMAX_API_KEY=sk-...
OPENAI_API_KEY=sk-...
- Click 🔊 测试朗读 / Test to verify. The key status label shows
(from env/.env) when the key comes from the environment.
Config is stored in $DSH_HOME/multi-tts/config.json (override the directory with the stateDir option).
Routes
The host half registers four routes on the DSH web server:
| Method | Path | Purpose |
|---|
POST | /multi-tts/synthesize | { text, voice?, provider?, speed? } → audio bytes (char count in x-tts-chars) |
GET | /multi-tts/status | active provider / voice / key presence |
GET POST | /multi-tts/config | read / patch the stored config |
GET | /multi-tts/voices | voice list of the active provider |
Notes
- Peer dependency:
@deepseek-ai/cordis ^4.0.1, provided by the DSH host.
- Text is capped at 4000 characters per request.
- Requires Node.js ≥ 22 (uses the global
fetch).
License
MIT
中文说明
在 DeepSeek Harness 里把助手的回复念出来——服务商与音色都由你自己挑。
DSH 的多服务商语音朗读插件：每条回复旁有 🔊 朗读按钮，输入框有自动朗读开关，设置页里可选服务商、音色、情绪与语速。零构建，纯 ESM + 手写 React。
功能
- 🔊 每条回复旁朗读——点一下开口，再点一下停止。
- 🔇 自动朗读开关——输入框左侧，新回复自动念。
- ⚙️ 多服务商设置页——服务商下拉、音色下拉、手填音色 ID、情绪、语速、模型、Base URL、API Key，外加一键测试朗读。
- 🧹 朗读前文本清洗——代码块、行内代码、网址、文件路径、Markdown 强调与列表符号都不会念出来。
- 🔑 Key 多路兜底——插件配置 → 环境变量 →
$DSH_HOME/.env → .env 常见键名。
- 📦 零构建——client 端是手写
React.createElement，直接以 lib/ 里的源文件形式分发。
服务商
| 服务商 | 接口 | 内置音色 | 情绪 |
|---|
minimax | MiniMax(海螺)/v1/t2a_v2 | 12 个中文音色(female-shaonv 少女音、qiaopi_mengmei 俏皮萌妹、lovely_girl 萌萌女童……) | ✅ |
openai | 任意 OpenAI 兼容 /audio/speech | 6 个音色(alloy、echo、fable、onyx、nova、shimmer) | — |
凡是 OpenAI 兼容的语音端点都能用 openai 这条通道接进来——改 Base URL 即可(OpenAI、DashScope、SiliconFlow、本地服务……)。
安装
dsh plugin --profile web add dsh-multi-tts
再把包名加进 profile 的 bundles 清单(dsh plugin add 只写依赖,bundles 才是挂载清单):
{
"dsh": {
"profile": {
"bundles": ["dsh-multi-tts"]
}
}
}
重启 DSH,打开设置 → 语音朗读。
配置
- 打开插件设置页;
- 选服务商、再选音色(也可直接手填音色 ID);
- 粘贴 API Key,或写进
$DSH_HOME/.env:
MINIMAX_API_KEY=sk-...
OPENAI_API_KEY=sk-...
- 点 🔊 测试朗读 验证。Key 来自环境变量时,状态会显示「(来自环境/.env)」。
配置存在 $DSH_HOME/multi-tts/config.json(可用 stateDir 选项改目录)。
路由
host 端在 DSH web 服务器上挂 4 条路由:
| 方法 | 路径 | 用途 |
|---|
POST | /multi-tts/synthesize | { text, voice?, provider?, speed? } → 音频字节(字符数在 x-tts-chars) |
GET | /multi-tts/status | 当前服务商 / 音色 / 是否已配 Key |
GET POST | /multi-tts/config | 读 / 改配置 |
GET | /multi-tts/voices | 当前服务商的音色表 |
说明
- peer 依赖:
@deepseek-ai/cordis ^4.0.1,由 DSH 本体提供。
- 单次合成文本上限 4000 字符。
- 需要 Node.js ≥ 22(用到全局
fetch)。
许可
MIT
