| name | tts |
| description | Unified TTS (Text-to-Speech) skill with pluggable providers (strategy pattern).
Supports: Edge TTS (free, no API key), Vertex AI Gemini TTS (Google).
Use for generating voiceovers, narration, dubbing.
Trigger: "配音", "生成语音", "TTS", "text-to-speech", "合成语音", "语音合成".
|
| allowed-tools | Bash(python3 */scripts/tts.py *) |
| aliases | ["配音","语音合成","TTS","合成语音"] |
| tags | ["Audio","Utility"] |
TTS — 语音合成技能
统一语音合成技能，基于策略模式，支持多个 TTS 后端切换。
脚本
用法
python3 ${SKILL_DIR}/scripts/tts.py "你好世界" -o hello.mp3
python3 ${SKILL_DIR}/scripts/tts.py "你好" --provider vertex-tts
python3 ${SKILL_DIR}/scripts/tts.py "旁白" --provider vertex-tts --voice Aoede
python3 ${SKILL_DIR}/scripts/tts.py "测试旁白" --preset yunjian
python3 ${SKILL_DIR}/scripts/tts.py "快速朗读" --rate +20%
python3 ${SKILL_DIR}/scripts/tts.py "你好" --json
参数
| 参数 | 说明 | 默认值 |
|---|
text | 要转换的文本（必填） | - |
--output, -o | 输出音频路径 | outputs/output.mp3 |
--provider, -p | TTS 后端 | 从 .env 读取 |
--voice, -v | 音色名称 | edge-tts: zh-CN-XiaoxiaoNeural / vertex-tts: Zephyr |
--preset | 中文预设（edge-tts） | - |
--language, -l | 语言代码 | - |
--rate, -r | 语速调整 | 0% |
--json, -j | JSON 格式输出 | 关 |
中文预设（edge-tts）
| 预设名 | Voice ID | 特点 |
|---|
xiaoxiao | zh-CN-XiaoxiaoNeural | 女声，温柔亲切（默认） |
xiaoyi | zh-CN-XiaoyiNeural | 女声，活泼可爱 |
yunjian | zh-CN-YunjianNeural | 男声，沉稳大气 |
yuxuan | zh-CN-YuxuanNeural | 女声，温柔知性 |
shimmer | zh-CN-ShimmerNeural | 女声，清亮甜美 |
guy | zh-CN-YunxiNeural | 男声，自然对话 |
xiaomeng | zh-CN-XiaomengNeural | 童声，萌系 |
zhiyu | zh-CN-ZhiyuNeural | 女声，情感丰富 |
Provider 切换
方式 1：修改 .env（永久切换）
编辑 ${SKILL_DIR}/.env：
DEFAULT_TTS_PROVIDER=edge-tts
# 或
DEFAULT_TTS_PROVIDER=vertex-tts
方式 2：命令行参数（单次覆盖）
python3 tts.py "text" --provider vertex-tts
方式 3：新增 Provider
- 在
scripts/providers/ 下新建 xxx_provider.py
- 继承
TTSProvider，实现 synthesize() 方法
- 在
registry.py 的 PROVIDERS 字典中注册
Provider 对比
| 维度 | edge-tts | vertex-tts |
|---|
| 费用 | 免费 | 需要 API Key |
| 音质 | 好 | 更好 |
| 中文支持 | 400+ 音色 | 30 音色 |
| 速度 | 快 | 较慢 |
| 语速控制 | 支持 | 暂不支持 |
| 依赖 | edge-tts CLI | ffmpeg |
API Key 配置
edge-tts
无需 API Key。
Vertex AI
读取优先级：
- 环境变量
VERTEX_API_KEY / GEMINI_API_KEY
${SKILL_DIR}/.env 中的 VERTEX_API_KEY=...- 项目根目录
.env
依赖
- Python 3（标准库 + edge-tts）
- ffmpeg（vertex-tts 需要，edge-tts 不需要）
