1
   00:00:00,000 --> 00:00:03,000
   第一句讲解内容

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

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

创建教育视频

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

环境要求

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

必需工具

工具	用途	检查命令
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 开发的必备参考手册，执行前请确认已安装：
bash

检查技能是否存在

clawhub list | grep remotion-video-toolkit

如未安装，请用户授权后执行

clawhub install remotion-video-toolkit

项目依赖

创建新项目时，需在项目目录内安装 Node.js 依赖：
bash
pnpm add @remotion/cli @remotion/player remotion react react-dom
pnpm add -D @types/react typescript

环境检查流程

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

1. 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

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

工作流程

步骤 1：素材准备

1. 1. 阅读 remotion-video-toolkit 技能作为视频制作指导
2. 使用网络搜索（通过 tavily-search 子代理）查询：

- 课程设计最佳实践 - 相关图片和矢量图形资源

1. 3. 汇总素材，准备文档和资源文件

步骤 2：文案编写

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

1
00:00:00,000 --> 00:00:03,000
第一句讲解内容

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

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

步骤 3：TTS 配音生成

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

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

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

步骤 4：视频脚本设计

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

markdown

场景 1 (00:00 - 00:05)

• - 元素：标题动画、背景渐变
• 镜头：淡入
• 动效：文字逐字出现
• 转场：溶解

场景 2 (00:05 - 00:12)

• - 元素：图解动画、重点标注
• 镜头：推进
• 动效：图形绘制效果
• 转场：滑动

步骤 5：Remotion 项目开发

1. 1. 初始化项目：

bash pnpm create video --hello-world

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

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

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

1. 4. 本地预览：

bash pnpm start

步骤 6：审查与修正

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

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

步骤 7：用户反馈循环

1. 1. 发送预览视频给用户
2. 根据反馈修改：

- 简单修改：直接调整代码 - 复杂修改：从步骤 2 重新执行

1. 3. 重复直到用户确认

步骤 8：最终导出

用户确认后，导出最终成品：
bash
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/syncsrttts.py

同步 SRT 字幕时间轴与 TTS 配音时长。

用法：
bash
python scripts/syncsrttts.py --srt subtitles.srt --audio voice.mp3 --output synced.srt

功能：

• - 分析音频实际时长
• 调整 SRT 时间戳对齐
• 处理段落间停顿