{
  "_comment": "dsh-plugin-voice 配置示例。配置优先级：settings.yaml 的 voice 分区（面板）> config.json > 默认值。本文件用于补齐面板没有的高级参数（roles/scenes/cloud 音质参数等）。路径：~/.dsh/voice/config.json",
  "engine": "auto",
  "_engine_comment": "engine（默认 auto）：auto = 有 MiMo Key 用 MiMo，否则火山，否则 SAPI；也可显式设 volcano / mimo / windows-sapi。未配对应 Key 时自动降级下一个引擎，不报错",
  "cloud": {
    "provider": "volcano",
    "apiKey": "${VOLCANO_API_KEY}",
    "_apiKey_comment": "火山引擎 X-Api-Key，支持 ${ENV_VAR} 引用避免明文落盘（默认值里的 ${VOLCANO_API_KEY} 也会被解析）。未配置则回退 SAPI 离线语音",
    "voice": "zh_female_daimengchuanmei_moon_bigtts",
    "resourceId": "seed-tts-1.0",
    "format": "pcm",
    "sampleRate": 24000,
    "silenceDuration": 400,
    "pauseControl": true,
    "pauseSentenceMs": 400,
    "pauseCommaMs": 200,
    "timeout": 30000,
    "nlpPara": {
      "punctuationBias": 0,
      "inequalityChoose": 0
    },
    "_nlpPara_comment": "音质增强（seed-tts-1.0）：punctuationBias=标点偏向 0-6（纠正长句/无标点文本断句）；inequalityChoose=不等号等特殊字符读法 0/1",
    "energyRate": 0,
    "_energyRate_comment": "能量增益 -50~100，提升响度感知（与 loudness_rate 叠加）",
    "retries": 1,
    "_retries_comment": "网络瞬时故障重试次数（业务错误如 Key 失效/资源未开通不重试）"
  },
  "mimo": {
    "provider": "mimo",
    "apiKey": "${MIMO_API_KEY}",
    "_apiKey_comment": "小米 MiMo V2.5-TTS 的 API Key（mimo.mi.com 控制台获取，OpenAI 兼容 Bearer 鉴权）。未配置则回退 SAPI 离线语音",
    "voice": "mimo_default",
    "_voice_comment": "MiMo 预置音色：mimo_default / 冰糖（中文·女）/ 茉莉（中文·女）/ 苏打（中文·男）/ 白桦（中文·男）/ Mia / Chloe / Milo / Dean（英文）",
    "format": "pcm",
    "pauseControl": true,
    "pauseSentenceMs": 400,
    "pauseCommaMs": 200,
    "timeout": 30000,
    "retries": 1
  },
  "rate": 200,
  "volume": 1.3,
  "_volume_comment": "服务端音量 1.3 = +30%，替代系统音量增强（无 Python 依赖）",
  "sceneSounds": {
    "task_start": "light",
    "task_complete": "bright",
    "task_error": "melodious",
    "need_interaction": "ding_ding",
    "milestone": "gift"
  },
  "textClean": true,
  "maxTextLength": 200,
  "roles": [],
  "scenes": {
    "task_start": {
      "voice": "zh_female_daimengchuanmei_moon_bigtts",
      "rate": 190,
      "volume": 1.3,
      "emotion": "calm"
    },
    "task_complete": {
      "voice": "zh_female_daimengchuanmei_moon_bigtts",
      "rate": 220,
      "volume": 1.3,
      "emotion": "happy"
    },
    "task_error": {
      "voice": "zh_female_daimengchuanmei_moon_bigtts",
      "rate": 210,
      "volume": 1.3,
      "emotion": "angry"
    },
    "need_interaction": {
      "voice": "zh_female_daimengchuanmei_moon_bigtts",
      "rate": 200,
      "volume": 1.3,
      "emotion": "calm"
    },
    "milestone": {
      "voice": "zh_female_daimengchuanmei_moon_bigtts",
      "rate": 210,
      "volume": 1.3,
      "emotion": "happy"
    }
  }
}