esl-comic-video

star 23

将故事文本(txt/md)和音频转换成漫画风格视频。支持自动语音转录、AI图片生成、字幕烧录等功能。适用于ESL教学视频制作。

Leoyishou By Leoyishou schedule Updated 3/31/2026

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
Install via CLI
npx skills add https://github.com/Leoyishou/personal-ai-company --skill esl-comic-video
Repository Details
star Stars 23
call_split Forks 7
navigation Branch main
article Path SKILL.md
More from Creator