SnowVoice TTS#

本地中文语音合成 Skill，基于 SnowVoice Studio (Qwen3-TTS)。

触发条件#

• "把这段话转成语音" / "用小烛的声音说你好"
• "克隆这个声音" / "设计一个温柔的女声"
• "生成一段配音" / "帮我朗读这段文字"

环境初始化#

首次使用前，必须确保 SnowVoice Studio 已安装。 Agent 应自动检测并引导安装。

检查环境#

bash

python3 scripts/init.py status

一键安装（推荐）#

bash

python3 scripts/init.py setup

这会自动完成：git clone → venv 创建 → 依赖安装 → 模型下载（约 3GB）

分步安装#

bash

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 存在也会被识别。

执行流程#

1. 检查环境：确认 snowvoice 可用（自动发现路径）
2. 识别意图：判断克隆/设计/列表
3. 提取参数：文字内容 + 音色（自然语言解析）
4. 构建并执行命令： python -m cli.app clone/design <args>（在 snowvoice 项目目录下）
5. 返回结果：音频文件完整路径

核心命令#

克隆（最常用）#

bash

# 在 snowvoice 项目目录下执行
python -m cli.app clone <persona_key> "要合成的文字"
python -m cli.app clone <persona_key> "文字" --tone "温柔" --emotion "Happy"

音色设计#

bash

python -m cli.app design <voice_name> "建模短句" --tone "描述"

音色列表#

bash

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。

注意事项#

1. 首次使用必须初始化： python3 scripts/init.py setup
2. 模型下载约 3GB：首次可能需要 10-30 分钟
3. 仅支持 macOS Apple Silicon（MPS 加速）
4. 执行超时：合成一条语音约 10-30 秒，已设 5 分钟超时
5. 输出路径：默认在 snowvoice 项目的 out/ 目录