将故事文本(txt/md)和音频转换成漫画风格视频。支持自动语音转录、AI图片生成、字幕烧录等功能。适用于ESL教学视频制作。
将英语学习故事转换成白板简笔画风格的教学视频。
# 最简用法 - 只需提供故事文本
python ~/.claude/skills/esl-comic-video/scripts/make_video.py --story story.txt
# ESL 学习者推荐 - 0.75 倍速慢放
python ~/.claude/skills/esl-comic-video/scripts/make_video.py --story story.txt --speed 0.75
自动化功能：
| 参数 | 说明 | 示例 |
|---|---|---|
--story | 故事文本文件 | --story lesson.txt |
--text | 直接输入文本 | --text "Hello world..." |
--audio | 已有音频文件 | --audio lesson.mp3 |
--speed | 播放速度 | --speed 0.75 (慢放) |
--output | 输出目录 | --output ./videos |
--name | 项目名称 | --name lesson01 |
| 速度值 | 效果 | 适用场景 |
|---|---|---|
0.75 | 慢放 75% | ESL 初学者 |
0.85 | 慢放 85% | ESL 中级 |
1.0 | 原速（默认） | 正常学习 |
1.25 | 加速 125% | 复习回顾 |
默认使用 --tts auto，自动检测：
# 强制使用 Edge TTS
python make_video.py --story story.txt --tts edge
# 强制使用 ElevenLabs
python make_video.py --story story.txt --tts elevenlabs
位置：/Users/liuyishou/usr/projects/inbox/ESL-video/.env
ELEVENLABS_API_KEY=sk_xxx
ELEVENLABS_VOICE_ID=kPzsL2i3teMYv0FxEYQ6
白板简笔画教学风格：
| 参数 | 说明 | 默认 |
|---|---|---|
--no-images | 跳过图片生成 | 开启 |
--no-subtitles | 跳过字幕烧录 | 开启 |
--no-polish | 跳过音频优化 | 开启 |
--motion | 启用平移缩放动效 | 关闭 |
output/{name}/
├── final/
│ ├── {name}.mp4 # 原速视频
│ ├── {name}_0_75x.mp4 # 慢放视频（如有）
│ └── {name}.srt # 字幕文件
├── intermediate/
│ └── frames/ # 漫画图片
└── story.mp3 # TTS 音频
直接用自然语言描述需求：
把这段文字做成漫画视频：My friend Julia called me...
帮我用 story.txt 生成 ESL 学习视频，0.75 倍速
把这个音频转成漫画视频：~/Downloads/lesson.mp3
# 生成完整 ESL 教学视频（0.75 倍速）
python ~/.claude/skills/esl-comic-video/scripts/make_video.py \
--story ~/Documents/stories/coffee_morning.txt \
--output ~/Videos/ESL \
--name coffee_lesson \
--speed 0.75
# 试运行（不执行，只显示命令）
python ~/.claude/skills/esl-comic-video/scripts/make_video.py \
--story story.txt --dry-run
| 问题 | 解决方案 |
|---|---|
| TTS 失败 | 检查网络连接；ElevenLabs 失败会自动回退到 Edge TTS |
| 图片生成失败 | 检查 OPENROUTER_API_KEY |
| ffmpeg 未找到 | brew install ffmpeg |
| 速度调整失败 | 确保 ffmpeg 版本 >= 4.0 |
/Users/liuyishou/usr/projects/inbox/ESL-video/make_comic_video.py~/.claude/skills/esl-comic-video/scripts/make_video.py/Users/liuyishou/usr/projects/inbox/ESL-video/.env