Create Edu Video
根据课程主题和需求,全自动制作教学视频。
环境要求
⚠️ 安全提示:以下工具需由用户自行安装,本技能不会自动执行系统级安装命令。
必需工具
| 工具 | 用途 | 检查命令 |
|---|---|---|
| pnpm | Node.js 包管理器 | pnpm --version |
| Chromium | Remotion 渲染引擎 | which chromium-browser || which chromium |
| FFmpeg | 音视频处理 | ffprobe -version |
| edge-tts | 微软 TTS 配音 | edge-tts --list-voices | grep zh-CN |
必选配套技能
remotion-video-toolkit 是 Remotion 开发的必备参考手册,执行前请确认已安装:
# 检查技能是否存在
clawhub list | grep remotion-video-toolkit
# 如未安装,请用户授权后执行
clawhub install remotion-video-toolkit
项目依赖
创建新项目时,需在项目目录内安装 Node.js 依赖:
pnpm add @remotion/cli @remotion/player remotion react react-dom
pnpm add -D @types/react typescript
环境检查流程
在开始制作视频前,必须先检查环境,如有缺失应提示用户自行安装:
- 检查 pnpm:
pnpm --version - 检查 Chromium:
which chromium-browser || which chromium - 检查 FFmpeg:
ffprobe -version - 检查 edge-tts:
edge-tts --list-voices | grep zh-CN - 检查 remotion-video-toolkit 技能:
clawhub list | grep remotion-video-toolkit
如任何一项缺失,停止执行并提示用户安装,不要尝试自动安装。
工作流程
Step 1: 素材准备
- 阅读
remotion-video-toolkit技能作为视频制作指导 - 使用网络搜索(通过 tavily-search 子代理)查询:
- 课程设计最佳实践
- 相关图片和矢量图形资源
- 汇总素材,准备文档和资源文件
Step 2: 文案编写
- 根据课程主题确定教学风格(默认:可汗学院风格)
- 编写教学讲解文案
- 生成 SRT 字幕文件格式:
1 00:00:00,000 --> 00:00:03,000 第一句讲解内容 2 00:00:03,000 --> 00:00:06,500 第二句讲解内容 - 关键:单行字幕限制字数,确保不超出视频宽度
Step 3: TTS 配音生成
- 使用 edge-tts 生成配音:
edge-tts --text "讲解内容" --write-media output.mp3 --voice zh-CN-XiaoxiaoNeural - 运行
scripts/sync_srt_tts.py同步 SRT 时间轴与配音时长 - 验证字幕与配音对齐
Step 4: 视频脚本设计
分析 SRT 字幕,设计视频画面脚本(script.md):
## 场景 1 (00:00 - 00:05)
- 元素: 标题动画、背景渐变
- 镜头: 淡入
- 动效: 文字逐字出现
- 转场: 溶解
## 场景 2 (00:05 - 00:12)
- 元素: 图解动画、重点标注
- 镜头: 推进
- 动效: 图形绘制效果
- 转场: 滑动
Step 5: Remotion 项目开发
-
初始化项目:
pnpm create video --hello-world -
深度参考
remotion-video-toolkit技能 -
依据 SRT 和 script 开发 Remotion 代码:
- 设置视频尺寸(默认 1080x1920 竖屏)
- 设计排版布局
- 实现字幕组件
- 集成配音音轨
- 添加动效和转场
-
本地预览:
pnpm start
Step 6: 审查与修正
- 审查代码是否还原 script 设计
- 发现问题立即修复
- 导出预览版:
pnpm render --codec h264 --output preview.mp4
Step 7: 用户反馈循环
- 发送预览视频给用户
- 根据反馈修改:
- 简单修改:直接调整代码
- 复杂修改:从 Step 2 重新执行
- 重复直到用户确认
Step 8: 最终导出
用户确认后,导出最终成品:
pnpm render --codec h264 --quality high --output final.mp4
视频规格
| 参数 | 默认值 | 可选 |
|---|---|---|
| 尺寸 | 1080x1920 (竖屏) | 1920x1080 (横屏) |
| 帧率 | 30fps | 60fps |
| 编码 | H.264 | H.265, WebM |
| 配音 | zh-CN-XiaoxiaoNeural (女声) | 其他 edge-tts 语音 |
教学风格参考
详见 references/teaching-styles.md,包含:
- 可汗学院风格
- TED 演讲风格
- 白板教学风格
- 动画解说风格
脚本工具
scripts/sync_srt_tts.py
同步 SRT 字幕时间轴与 TTS 配音时长。
用法:
python scripts/sync_srt_tts.py --srt subtitles.srt --audio voice.mp3 --output synced.srt
功能:
- 分析音频实际时长
- 调整 SRT 时间戳对齐
- 处理段落间停顿