dsh-pet-plus

四、配置

首次运行后配置文件在：

C:\Users\\.dsh\dsh-pet-plus\main-config.jsonc

改完即时生效（每个请求重读），不用重启、不用重装。包内 assets/config.jsonc 是带完整注释的默认值， 想看所有可配项就看它。

语音音色（最常问的一个）

在 main-config.jsonc 里写 tts 段，然后让它说句话（或 /tts 你好呀）即可听效果：

{
  "tts": {
    "enabled": true,
    "provider": "edge",          // "auto"（Windows→系统语音）| "sapi" | "edge" | "stub"
    "voice": "zh-CN-XiaoyiNeural", // ← 音色名写这里
    "rate": 0,                   // 语速 -10~10
    "volume": 100
  }
}

音色名怎么选：

• provider: "sapi"（离线，系统自带）：音色名要写已安装的 Windows 语音名。列出本机已装的：

  Add-Type -AssemblyName System.Speech
  (New-Object System.Speech.Synthesis.SpeechSynthesizer).GetInstalledVoices() |
    ForEach-Object { $_.VoiceInfo.Name + '  [' + $_.VoiceInfo.Culture.Name + ']' }
  

  Windows 中文版通常只有 Microsoft Huihui Desktop（成年女声）。想要少女音/萝莉音，需要另外装 Windows 语音包，或者用下面的 Edge。

• provider: "edge"（联网，微软 Edge「大声朗读」接口，音色明显更好且免 key）：候选音色名包括 zh-CN-XiaoyiNeural（少女）、zh-CN-XiaoshuangNeural（童声/萝莉）、zh-CN-XiaoxiaoNeural（默认女声）、 zh-CN-XiaomengNeural、zh-CN-XiaohanNeural。 ⚠️ 这是未公开接口，随微软改动可能失效。为此做了三重保护：默认不用它、返回字节必须是合法 MP3 才采纳、 失败自动回落系统语音。所以最坏结果只是"Edge 没生效、退回系统语音"，不会更坏。 /tts status 会显示实际生效的提供方；应用日志里会写明是否发生过回落。

• provider: "stub"：只产出静音，用来验证链路（排查用，不出声）。

改设置页里那一行的名字

src/client/settings.ts 里 zh 字典的 nav 字段（以及 en 的），改完重新构建：

& '\resources\runtime\pnpm\bin\pnpm.mjs' run build

（仓库里 lib/ 是构建产物、不入库，所以要自己构建一次；详见第九节。）

---