Create Edu Video

根据课程主题和需求，全自动制作教学视频。

环境要求

⚠️ 安全提示：以下工具需由用户自行安装，本技能不会自动执行系统级安装命令。

必需工具

必选配套技能

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

环境检查流程

在开始制作视频前，必须先检查环境，如有缺失应提示用户自行安装：

1. 检查 pnpm：pnpm --version
2. 检查 Chromium：which chromium-browser || which chromium
3. 检查 FFmpeg：ffprobe -version
4. 检查 edge-tts：edge-tts --list-voices | grep zh-CN
5. 检查 remotion-video-toolkit 技能：clawhub list | grep remotion-video-toolkit

如任何一项缺失，停止执行并提示用户安装，不要尝试自动安装。

工作流程

Step 1: 素材准备

1. 阅读 remotion-video-toolkit 技能作为视频制作指导
2. 使用网络搜索（通过 tavily-search 子代理）查询：
   • 课程设计最佳实践
   • 相关图片和矢量图形资源
3. 汇总素材，准备文档和资源文件

Step 2: 文案编写

1. 根据课程主题确定教学风格（默认：可汗学院风格）
2. 编写教学讲解文案
3. 生成 SRT 字幕文件格式：

   1
   00:00:00,000 --> 00:00:03,000
   第一句讲解内容
   
   2
   00:00:03,000 --> 00:00:06,500
   第二句讲解内容
   

4. 关键：单行字幕限制字数，确保不超出视频宽度

Step 3: TTS 配音生成

1. 使用 edge-tts 生成配音：

   edge-tts --text "讲解内容" --write-media output.mp3 --voice zh-CN-XiaoxiaoNeural
   

2. 运行 scripts/sync_srt_tts.py 同步 SRT 时间轴与配音时长
3. 验证字幕与配音对齐

Step 4: 视频脚本设计

分析 SRT 字幕，设计视频画面脚本（script.md）：

## 场景 1 (00:00 - 00:05)
- 元素: 标题动画、背景渐变
- 镜头: 淡入
- 动效: 文字逐字出现
- 转场: 溶解

## 场景 2 (00:05 - 00:12)
- 元素: 图解动画、重点标注
- 镜头: 推进
- 动效: 图形绘制效果
- 转场: 滑动

Step 5: Remotion 项目开发

1. 初始化项目：

   pnpm create video --hello-world
   

2. 深度参考 remotion-video-toolkit 技能

3. 依据 SRT 和 script 开发 Remotion 代码：

   • 设置视频尺寸（默认 1080x1920 竖屏）
   • 设计排版布局
   • 实现字幕组件
   • 集成配音音轨
   • 添加动效和转场

4. 本地预览：

   pnpm start
   

Step 6: 审查与修正

1. 审查代码是否还原 script 设计
2. 发现问题立即修复
3. 导出预览版：

   pnpm render --codec h264 --output preview.mp4
   

Step 7: 用户反馈循环

1. 发送预览视频给用户
2. 根据反馈修改：
   • 简单修改：直接调整代码
   • 复杂修改：从 Step 2 重新执行
3. 重复直到用户确认

Step 8: 最终导出

用户确认后，导出最终成品：

pnpm render --codec h264 --quality high --output final.mp4

视频规格

教学风格参考

详见 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 时间戳对齐
• 处理段落间停顿