dsh-minimax-tts

配置

装完在 DSH 的**「设置 → 插件」**里找到本插件改字段（keyed 插件设置页，不占通用设置入口； Config 的字段名与默认值见下），也可以 POST /dsh-minimax-tts/config 用 { patch } 浅合并（voices 是整体替换）。落盘在 $DSH_HOME/dsh-minimax-tts/config.json（0600，原子写； 首次变更前留一份 config.json.bak；文件损坏时优先回退 .bak，没有 .bak 就降级默认值并把损坏原文留作 .bak 证据）。

字段	默认	说明
baseUrl	https://api.minimax.cn	也可 api.minimaxi.com / api.minimax.io
apiKey	''	兜底顺序：config.apiKey → 环境变量 MINIMAX_API_KEY → ~/.dsh/.env
model	speech-2.8-hd	speech-2.8-hd / speech-2.8-turbo / 2.6 / 02 / 01 系列
voices	[{ id: 'female-shaonv', label: '', isDefault: true }]	isDefault 那条是默认音色
previewText	你好，这是一段语音合成测试，听到说明朗读功能已经正常工作了。	设置页「试听」的默认文本（客户端可持久化）；空串回落默认值，不进缓存 key
emotion	''	空 = 不传，由模型按文本自选；whisper 在 speech-2.8 系列不可用（上游 2013），fluent 不受限
speed / vol / pitch	1 / 1 / 0	区间 [0.5, 2] / (0, 10] / [-12, 12]
sampleRate	32000	8000/16000/22050/24000/32000/44100（不在集合里回退默认）
bitrate	128000	32000/64000/128000/256000（仅 mp3）
format	mp3	mp3/pcm/flac/wav/pcmu_raw/pcmu_wav/opus
channel	1	1 或 2
languageBoost	auto	MiniMax language_boost，设置页为下拉选框（40 种语言 + auto + 「不增强」）。auto＝模型自动识别语言；选「不增强」＝请求里不带该字段（官方默认 null＝不增强）；粤语音色必须 Chinese,Yue；speech-01/02 不支持 Persian/Filipino/Tamil
cleanup	{ days: 30, maxItems: 500, maxBytes: 524288000 }	三项任一超限即淘汰；填 0 = 该项不限制
advance	全 false / '' / []，outputFormat: 'hex'	装完只调一次，设置页默认折叠；v1 只会用到 pronunciationTone / latexRead 等文本侧开关
emotionTts	{ scope: 'off' }	灵动模式三态：off 两处都不注册 / preset 只有 preset 行注册 / global 全局行注册；非法值回落 off
role	full	行级角色（写在那一行的 config 里）：full 挂 9 条路由，skill-only 只挂技能与工具、不挂路由

音色怎么挑：内置默认音色 female-shaonv 一个，够用就直接用；想换或想加，就去官方试听页 听过、复制 voice_id，手填进 voices 列表（设置页或 POST /config 整体替换）， isDefault: true 的那条就是默认音色。设置页会拿账号音色目录给每条音色标一个中性的「目录内 / 目录外」， 但目录只作提示，绝不阻止加入、移除、设为默认或合成：官方试听页能听、能真实合成的音色，POST /v1/get_voice 未必返回（例如 Japanese_energetic_anime_girl_vv1），查错了算上游的，合成是否可用以真实朗读为准。

使用

客户端半边只做两件事：每条 assistant 消息上的朗读按钮，和「设置 → 插件」里的参数页。

• 朗读按钮是一颗按钮：未播放时是播放图标，播放中变成停止图标（点它即停），图标与尺寸照抄宿主 native MessageIconActions（28×28、--dsw-radius-sm、hover 只换底色不改圆角）；同一时刻只播一条， 播新的会自动停掉上一条。
• 设置页包括音色 / 模型 / 情绪 / 语速 / 音量 / 音高 / 格式 / 采样率 / 码率 / 声道 / 语言增强下拉 / 高级参数折叠区，以及试听：试听文本会持久化（重开设置页不重置），旁边有「恢复默认」； 「打开缓存目录」按钮直接调系统文件管理器打开缓存目录。音色行标出「目录内 / 目录外」（中性提示、不拦截任何操作）， 卡片标题行显示「上次检查：」（失败时为「检验失败：」并保留上一轮标记）， 「刷新音色目录」按钮在下面输入行、紧挨「加入列表」（同一不换行按钮组，不会被拆到两行）（见上文「音色怎么挑」）。

走本半边下面这些路由。宿主半边也能独立验证：

curl -s -X POST http://127.0.0.1:3080/dsh-minimax-tts/synthesize \
  -H 'content-type: application/json' \
  -d '{"text":"你好，这是一次试听。","preview":true}'