SnowVoice TTS
本地中文语音合成 Skill，基于 SnowVoice Studio (Qwen3-TTS)。
触发条件
- "把这段话转成语音" / "用小烛的声音说你好"
- "克隆这个声音" / "设计一个温柔的女声"
- "生成一段配音" / "帮我朗读这段文字"
环境初始化
首次使用前，必须确保 SnowVoice Studio 已安装。 Agent 应自动检测并引导安装。
检查环境
python3 scripts/init.py status
一键安装（推荐）
python3 scripts/init.py setup
这会自动完成：git clone → venv 创建 → 依赖安装 → 模型下载（约 3GB）
分步安装
python3 scripts/init.py install # 仅安装软件
python3 scripts/init.py download-model Base-1.7B # 下载克隆模型
python3 scripts/init.py download-model VoiceDesign-1.7B # 下载设计模型
安装路径
默认安装到 ~/.snowvoice-studio。如果开发者路径 ~/Desktop/personal/tts 存在也会被识别。
执行流程
- 检查环境：确认 snowvoice 可用（自动发现路径）
- 识别意图：判断克隆/设计/列表
- 提取参数：文字内容 + 音色（自然语言解析）
- 构建并执行命令：
python -m cli.app clone/design <args>（在 snowvoice 项目目录下） - 返回结果：音频文件完整路径
核心命令
克隆（最常用）
# 在 snowvoice 项目目录下执行
python -m cli.app clone <persona_key> "要合成的文字"
python -m cli.app clone <persona_key> "文字" --tone "温柔" --emotion "Happy"
音色设计
python -m cli.app design <voice_name> "建模短句" --tone "描述"
音色列表
python -m cli.app voice list
音色速查
| 简称 | persona_key | 说明 |
|---|---|---|
| 顾栖月 | gu_qiyue | 默认音色 |
| 小烛 | candy | 小烛原版 |
| 小烛傲娇 | candy_cool | 傲娇大小姐 |
| 小烛腹黑 | candy_mischievous | 腹黑小恶魔 |
| 王爷沉稳 | 王爷-儒武沉稳 | 儒武风格 |
| 王爷冷峻 | 王爷-冷峻锋压 | 冷峻风格 |
| 星栀 | 星栀-暧昧撩人 | AI女友 |
| 夜棠 | 夜棠-午夜耳语 | AI女友 |
| 朝朝 | 朝朝-元气阳光 | AI女友 |
| 宁观尘 | ning_guanchen | 男声 |
| 江湖老人 | jianghu_laoren | 老年男声 |
| 搞笑男 | zhou_xingchi | 港式无厘头 |
完整列表运行 snowvoice voice list 查看。自然语言映射见 scripts/tts_skill.py 的 PERSONA_MAP。
注意事项
- 首次使用必须初始化：
python3 scripts/init.py setup - 模型下载约 3GB：首次可能需要 10-30 分钟
- 仅支持 macOS Apple Silicon（MPS 加速）
- 执行超时：合成一条语音约 10-30 秒，已设 5 分钟超时
- 输出路径：默认在 snowvoice 项目的
out/目录