movie-recap-ai-voiceoverlisted
Install: claude install-skill yanghhu/miragea-voiceover-skills
# 电影解说配音
「电影解说配音」是一个给电影、电视剧、短剧和动漫解说号做配音的 Agent 技能:解说稿、分镜表或 SRT 字幕进,解说旁白和角色台词各用你克隆的音色逐句配音,按画面时长对轨并提示超时句,输出整段配音、旁白 / 台词分轨、SRT 字幕和逐句计划表,本地无需显卡。
## 沙箱 / 离线快速验证(不需要 API Key,不联网)
解压后在技能目录里依次运行,每条命令都能直接跑通(只用 Python 3.9+ 标准库):
```bash
python3 scripts/recap_dub.py selftest # 内置自检:解析、对轨、超时报告、分轨、无 Key 拦截、全部示例
python3 scripts/recap_dub.py check examples/example.md # 逐句看识别成旁白还是台词、什么语气、预计时长
python3 scripts/recap_dub.py build examples/example.md -o out --dry-run # 解说稿 → 整段配音 + 分轨 + SRT + 计划表
python3 scripts/recap_dub.py build examples/timed_script.txt -o out_timed --dry-run # 带时间码的稿件:按画面对轨,报告超时句
python3 scripts/recap_dub.py build examples/storyboard.csv -o out_board --dry-run # 分镜表输入
python3 scripts/recap_dub.py build examples/sample_srt.txt -o out_srt --dry-run # SRT 字幕输入(.srt 或存成 .txt 都行)
python3 scripts/recap_dub.py cast examples/storyboard.csv # 列出说话人,打印待填写的音色表
python3 scripts/voiceover.py check # 环境检查:Python、Key 是否已设置、服务地址
```
实际输出(`--dry-run` 用占位提示音、按每秒约 4.5 字估算时长,不调用接口):
```text
$ python3 scripts/recap_dub.py selftest
PASS 解析解说稿:3 句、旁白/台词分轨、语气、时间码
...
selftest 通过:16/16 通过(未使用 API Key,未联网)
$ python3 scripts/recap_dub.py build examples/example.md -o out --dry-run
完成:out/voiceover.wav(39.2 秒,9 句,顺排)+ stems/narration.wav + stems/dialogue.wav + voiceover.srt + cues.csv + report.md [dry-run:占位音,未调用接口]
$ python3 scripts/recap_dub.py build