game-voice-packlisted
Install: claude install-skill yanghhu/miragea-voiceover-skills
# 游戏配音
「游戏配音」是一个把台词表批量变成语音包的 Agent 技能:CSV 每行一个编号、角色和台词,按角色用你自己的克隆音色生成,输出按编号命名的音频文件和清单,改一行只重配一行,本地无需显卡。
## 一句话定义
游戏配音 = 台词 CSV(id, role, text…)→ `game_voice.py build --map 角色=账号角色` → `角色/id.wav` 语音文件 + `manifest.csv`(id、文件、时长、台词)+ `report.txt`。
## 适用人群与场景
| 谁在用 | 典型场景 |
|---|---|
| 独立游戏开发者 | NPC 对白、任务提示,台词改动频繁,需要只重配改过的行 |
| 游戏策划 | 从策划表导出 CSV,按 id 对应到引擎里的台词键 |
| 视觉小说 / 互动叙事作者 | 多角色对白,每个角色一个音色 |
| 教学关卡 / 应用 | 新手引导旁白、界面提示语音 |
## 能力一览
| 项目 | 说明 |
|---|---|
| 输入 | UTF-8 CSV,表头至少 `id,role,text`;可选 `tag`(`capabilities` 允许的语气标签)、`speed`(0.25–4)、`lang`(语言提示)、`note`(备注,不朗读) |
| 角色映射 | `--map 村长=老者` 把剧中角色映射到账号里的角色名(可重复);未映射的角色用 `--voice` |
| 输出 | `OUT/角色名/id.wav`(`--layout flat` 时 `OUT/id.wav`)、`manifest.csv`、`manifest.json`、`report.txt` |
| 增量 | 每句按内容缓存在 `cache/`;改一行重跑只重配这一行;`--only id1,id2` 指定重配 |
| 校验 | `check` 离线统计角色、句数、粗估时长;id 只允许字母数字下划线横线点,重复 id 报错 |
| 长句 | 超过 120 字自动在标点处切开再拼回 |
| 本地依赖 | Python 3.9+ 标准库,无需显卡 |
## 快速开始
先离线试跑(不需要 Key、不联网):
```bash
python3 scripts/game_voice.py selftest
python3 scripts/game_voice.py check examples/lines.csv --map 村长=老者
python3 scripts/game_voice.py build examples/lines.csv -o pack --map 村长=老者 --voice 默认 --dry-run
python3 scripts/game_voice.py build examples/lines.csv -o pack_flat --layout flat --only npc_001,ui_ok --voice 默认 --dry-run
```
正式生成需要 Miragea 的 API Key 和账号里你自己的角色(https://miragea.ai):
```bash
export MIRAGEA_API_KEY=你的key # 在 https://miragea.ai/workspace/api 生成,只放环境变量,不要贴进聊天
python3 scripts/miragea_audio.py c