astrbot_plugin_GPT_SoVITS 用于把 AstrBot 文本输出转换成语音输出，底层调用 GPT-SoVITS 的 API。

支持三种调用方式：

1. 指令转语音：手动输入命令立即合成语音。
2. 自动转语音：Bot 正常回复文本时，按概率自动转成语音发出。
3. 工具调用：LLM 工具调用时，GPT-SoVITS 会作为 LLM 工具的 TTS 接口。

此外还支持情绪参数切换（按关键词或 LLM 判别情绪），实现不同语气/语速的播报效果。

请先完成 GPT-SoVITS 本体部署：

• 官方仓库：RVC-Boss/GPT-SoVITS
• 参考指南：GPT_SoVITS 指南

在 AstrBot 插件市场搜索 astrbot_plugin_GPT_SoVITS 并安装。

Windows 示例（在 GPT-SoVITS 根目录新建 start_api.bat）：

runtime\python.exe api_v2.py
pause

或直接命令行启动：

python api_v2.py
# 或
python3 api_v2.py

路径：插件管理 -> astrbot_plugin_GPT_SoVITS -> 操作 -> 插件配置

至少确认以下三项：

1. client.base_url：GPT-SoVITS API 地址，默认通常是 http://127.0.0.1:9880
2. default_params.ref_audio_path：参考音频路径（必填，建议先用插件默认值）
3. enabled：总开关打开

在聊天中发送：

说 你好，我是语音测试

若收到语音消息，说明链路已打通。

插件支持两种情绪参数匹配方式：

1. 关键词匹配：当文本包含某个情绪条目的任一关键词时，使用该条目的语音参数。
2. LLM 判别：开启 judge.enabled_llm 后，先让 LLM 判断情绪，再映射到对应条目。

优先级：

1. 若开启 LLM 判别，则优先使用 LLM 结果；
2. 若 LLM 不可用或未匹配成功，则回退到关键词匹配。

首次加载时会自动导入内置情绪条目（如“温柔 / 开心 / 生气”）到 entry_storage。

这些参数会作为每次请求 /tts 的默认值：

插件通过 LocalDataManager 统一管理本地音频数据：

1. 本地音频文件名：gsv_<参数哈希>.<ext>。
2. 哈希由完整请求参数生成（排序后 JSON + SHA256 截断），确保“参数一致 -> 命中同一文件”。
3. 音频扩展名来自 media_type（仅支持 wav/mp3/ogg，异常值回退为 wav）。
4. 当 cache.enabled=true 时，请求前先查缓存；命中则直接发送本地缓存文件，未命中才请求 GPT-SoVITS。
5. 请求成功后会按同一参数规则写入本地目录，供后续直接复用。
6. cache.expire_hours=0 时缓存永不过期；大于 0 时，过期缓存会在读取时自动删除。

优先检查：

1. GPT-SoVITS API 是否已启动；
2. client.base_url 是否正确；
3. default_params.ref_audio_path 文件是否存在；
4. GPT-SoVITS 控制台是否有报错信息。

常见原因：

1. tts_prob 太低；
2. 回复文本超过 max_msg_len；
3. 回复里包含图片/语音等非纯文本片段；
4. only_llm_result=true 且该消息不是 LLM 输出。

1. 若使用关键词模式，确认关键词确实出现在回复文本中；
2. 若使用 LLM 模式，确认 judge.provider_id 可用且返回格式正确；
3. 确认目标情绪条目名称存在于 entry_storage。

• 🌟 Star 这个项目！（点右上角的星星，感谢支持！）
• 🐛 提交 Issue 报告问题
• 💡 提出新功能建议
• 🔧 提交 Pull Request 改进代码

• 本插件优先兼容 GPT-SoVITS 官方实现与常见整合包。若使用第三方魔改版本，请以其 API 实际行为为准。
• 想第一时间得到反馈的可以来作者的插件反馈群（QQ群）：460973561（不点star不给进）

GPT-SoVITS， 1 min voice data can also be used to train a good TTS model! (few shot voice cloning)