Skills text-to-speech

文本转语音工具 - 支持脚本解析、情绪标记和后处理，基于 Edge TTS

install

source · Clone the upstream repo

git clone https://github.com/wlzh/skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/wlzh/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/text-to-speech" ~/.claude/skills/wlzh-skills-text-to-speech && rm -rf "$T"

manifest: text-to-speech/SKILL.md

source content

Text-to-Speech Skill

将文本转换为语音，支持播客脚本解析、情绪标记处理和 voice-changer 后处理。

使用说明

当用户请求将文本转换为语音时，使用以下命令：

# 基本用法
python3 ~/.claude/skills/text-to-speech/scripts/text_to_speech.py <文本文件>

# 指定输出文件
python3 ~/.claude/skills/text-to-speech/scripts/text_to_speech.py script.txt -o output.mp3

# 指定声音
python3 ~/.claude/skills/text-to-speech/scripts/text_to_speech.py script.txt -v zh-CN-XiaoxiaoNeural

# 启用后处理（voice-changer）
python3 ~/.claude/skills/text-to-speech/scripts/text_to_speech.py script.txt --post-process

# 列出所有可用声音
python3 ~/.claude/skills/text-to-speech/scripts/text_to_speech.py --list-voices

核心功能

1. 脚本解析

自动识别并移除播客脚本中的注释和标记：

时间戳：
```
(00:00)
```
BGM 注释：
```
[BGM渐入：...]
```
舞台指示：
```
(主播声音：...)
```
```
(停顿 1秒)
```
情绪标记：
```
(语速放慢，加重语气)
```
Markdown 标记：
```
**文本**
```

2. 多种声音支持

支持 18+ 种中文声音，包括：

男声：YunyangNeural（新闻播音）、YunxiNeural（年轻活力）、YunjianNeural（成熟稳重）
女声：XiaoxiaoNeural（温柔亲切）、XiaoyiNeural（活泼开朗）、XiaoyanNeural（新闻播音）

3. 语音参数调整

语速调整：
```
--rate "+20%"
```
或
```
--rate "-10%"
```
音调调整：
```
--pitch "+5Hz"
```
或
```
--pitch "-3Hz"
```
音量调整：
```
--volume "+20%"
```
或
```
--volume "-10%"
```

4. 后处理集成

可选集成 voice-changer skill 进行变声处理。

配置文件

配置文件位于：

~/.claude/skills/text-to-speech/config/tts_config.json

主要配置项

{
  "edge_tts": {
    "voice": "zh-CN-YunyangNeural",
    "rate": "+0%",
    "pitch": "+0Hz",
    "volume": "+0%"
  },
  "script_parsing": {
    "enabled": true,
    "remove_timestamps": true,
    "remove_bgm_notes": true,
    "remove_stage_directions": true,
    "remove_markdown": true
  },
  "emotion_processing": {
    "enabled": true,
    "use_ssml": true
  },
  "output": {
    "format": "mp3",
    "default_output_dir": "same_as_input",
    "filename_suffix": "_tts"
  },
  "post_processing": {
    "enabled": false,
    "voice_changer": {
      "enabled": false,
      "voice_type": "female_1",
      "pitch_shift": 0
    }
  }
}

工作流程

输入文本/文件
    ↓
脚本解析（移除注释和标记）
    ↓
情绪标记处理（可选）
    ↓
Edge TTS 语音合成
    ↓
后处理（voice-changer，可选）
    ↓
输出 MP3 文件

依赖安装

# 安装 Edge TTS
pip install edge-tts

# 如果需要后处理，确保 voice-changer skill 已安装

使用示例

示例 1：转换播客脚本

python3 ~/.claude/skills/text-to-speech/scripts/text_to_speech.py podcast_script.txt

脚本会自动：

移除时间戳和 BGM 注释
移除舞台指示
只保留实际要朗读的文本
生成
```
podcast_script_tts.mp3
```

示例 2：使用女声并调整语速

python3 ~/.claude/skills/text-to-speech/scripts/text_to_speech.py script.txt \
  -v zh-CN-XiaoxiaoNeural \
  --rate "+10%"

示例 3：启用后处理

python3 ~/.claude/skills/text-to-speech/scripts/text_to_speech.py script.txt \
  --post-process

会先生成语音，然后调用 voice-changer 进行变声处理。

注意事项

网络要求：Edge TTS 需要网络连接
文本长度：建议单次转换不超过 10000 字
脚本格式：支持纯文本和带注释的播客脚本
后处理：需要先安装 voice-changer skill

技术实现

TTS 引擎：Microsoft Edge TTS（免费、高质量）
脚本解析：正则表达式匹配
音频格式：MP3（默认）
后处理：可选集成 voice-changer

性能参考

1000 字文本：约 10-20 秒
5000 字文本：约 30-60 秒
网络速度影响较大

许可

MIT