AstrBot Plugin VITS Pro

实验性增强版 · 当前版本：v1.9.0
新增：加入了一些对文本的清洗选项。

目录

• 情绪调用说明
• 重要提示
• 功能概览
• 配置说明
• 音色与模型规则
• 常见问题 FAQ
• 支持的音色
• 命令使用参考
• 高级功能
• 使用说明
• 更新日志

情绪调用说明

默认不启用“情绪模式”。如果你需要让模型返回带情绪的语音，请在角色人设中加入以下硬性格式约束（不必担心前缀，插件会自动剔除）：

在你回复开始前，你必须表明你这次回复时的情绪，包括以下几种情绪：快乐（happy）、兴奋（excited）、悲伤（sad）、愤怒（angry），不存在的情绪禁止新创。
你回复的具体格式为：
happy emotion<|endofprompt|> / excited emotion<|endofprompt|> / sad emotion<|endofprompt|> / angry emotion<|endofprompt|> + 正文内容

示例：

happy emotion<|endofprompt|>这个问题我很清楚！
excited emotion<|endofprompt|>早安，今天也要元气满满哦！
sad emotion<|endofprompt|>对不起，这样做是不对的，我很伤心。
angry emotion<|endofprompt|>哇！你这个变态真是无药可救了！

约束：

• 每次回复只允许一种情绪
• 不要过度使用情绪
• 情绪需与上下文语境一致

重要提示

1. 不要开启原本内置的 TTS

2. 带 “@” 和“回复” 的消息会吞语音

请关闭相关自动行为

3. 可以正常开启分段回复

功能概览

• 基于硅基流动（SiliconFlow）API 的文本转语音
• 支持系统预置音色 + 自定义上传音色
• 支持：TTS 总开关、音色切换、播放速度、增益、概率控制
• 支持关键词过滤与智能跳过内容
• 支持 TTS 黑 / 白名单（v1.7.0 新增）
• 支持最大字符限制与参考模式（情绪接口调用）
• 支持状态持久化（重启后保留 TTS 开关状态）

配置说明

在插件面板中需要填写：

• URL（末尾必须加 /v1） → 示例：https://api.siliconflow.cn/v1
• API Key
• 模型名字（例如：FunAudioLLM/CosyVoice2-0.5B）
• 音色（格式见下文）
• 全局 TTS 状态保存（开启后重启保留）

界面示意：

音色与模型规则

音色（voice）前必须带模型名，并用英文冒号 : 分隔。
例如使用 FunAudioLLM/CosyVoice2-0.5B 模型的 alex 音色：

• name（模型名）填写：
  FunAudioLLM/CosyVoice2-0.5B
• voice（音色）填写：
  FunAudioLLM/CosyVoice2-0.5B:alex

常见问题 FAQ

支持的音色

系统预置音色

自定义音色

支持在硅基流动平台上传的自定义音色（按平台规则绑定模型）。

在线音色上传控制台：
🔗 https://voice.gbkgov.cn

命令使用参考

基础控制

音色相关

概率控制

音频参数

高级功能

智能过滤（自动跳过）：

• 包含网址（http / https）
• 图片消息
• 特定关键词（默认：astrbot、语音、音色、TTS、转换 等；可自定义）

黑 / 白名单控制（v1.7.0）

• 自定义哪些会话启用 / 禁用 TTS
• 精细化管理多会话场景

状态持久化

• 全局 TTS 开关记录在配置中
• 重启框架 / 重载插件保留状态

音频参数摘要

使用说明

1. 初次使用：填写 API / 模型 / 音色 → 输入 /vits 启用
2. 切换音色：/voice alex（可选）
3. 调整语速：/speed 1.2（可选）
4. 控制音量：/gain 2（可选）
5. 设置概率：/vits% 60（可选）
6. 查看状态：/vitsinfo（可选）
7. 加情绪：在角色提示词中加入格式规范（见前文）

更新日志

祝您使用愉快，如有bug或建议，欢迎通过QQ：1436198709 联系讨论。 🎧