name: esl-comic-video description: 将故事文本(txt/md)和音频转换成漫画风格视频。支持自动语音转录、AI图片生成、字幕烧录等功能。适用于ESL教学视频制作。 allowed-tools: Bash(python:), Bash(edge-tts:), Bash(ffmpeg:*), Read, Write
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
自动化功能:
- 自动检测 ElevenLabs API Key(已配置)
- 自动生成高质量 TTS 配音
- 自动生成简笔画图片 + 词汇标注
- 自动烧录字幕
- 自动调整播放速度
- 完成后自动打开视频
核心参数
| 参数 | 说明 | 示例 |
|---|---|---|
--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 配置
自动模式(推荐)
默认使用 --tts auto,自动检测:
- 有 ElevenLabs Key → 使用 ElevenLabs(更自然)
- 无 Key → 使用 Edge TTS(免费)
手动指定
# 强制使用 Edge TTS
python make_video.py --story story.txt --tts edge
# 强制使用 ElevenLabs
python make_video.py --story story.txt --tts elevenlabs
已配置的 API Keys
位置:/Users/liuyishou/usr/projects/inbox/ESL-video/.env
ELEVENLABS_API_KEY=sk_xxx
ELEVENLABS_VOICE_ID=kPzsL2i3teMYv0FxEYQ6
图片风格
白板简笔画教学风格:
- 纯白背景 (#FFFFFF)
- 黑色线条画
- 每帧标注 2-3 个关键词汇
- 箭头指向对应物体/动作
功能开关
| 参数 | 说明 | 默认 |
|---|---|---|
--no-images |
跳过图片生成 | 开启 |
--no-subtitles |
跳过字幕烧录 | 开启 |
--no-polish |
跳过音频优化 | 开启 |
--motion |
启用平移缩放动效 | 关闭 |
输出结构
output/{name}/
├── final/
│ ├── {name}.mp4 # 原速视频
│ ├── {name}_0_75x.mp4 # 慢放视频(如有)
│ └── {name}.srt # 字幕文件
├── intermediate/
│ └── frames/ # 漫画图片
└── story.mp3 # TTS 音频
在 Claude Code 中使用
直接用自然语言描述需求:
把这段文字做成漫画视频: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