Tutor - 数学教学视频制作

一对一辅导老师技能，用于解答数学题，生成 HTML 讲解文档和带配音的 Manim 动画视频。

⚠️ 重要：v1.1.0 修复了音画同步问题，请确保使用最新版本

📦 GitHub 仓库: https://github.com/aotian/openclaw-tutor-skill

快速开始

安装

# 方法1: Git 克隆（推荐，方便更新）
cd ~/.openclaw/workspace/skills
git clone https://github.com/aotian/openclaw-tutor-skill.git tutor

# 方法2: 下载 ZIP
# 访问 https://github.com/aotian/openclaw-tutor-skill/releases

核心工作流

1. 数学分析 → 推导数学事实，建立几何模型
2. HTML 可视化 → SVG 画图形，展示画图过程
3. 分镜脚本 → 定义幕结构，设计画面/字幕/读白
4. TTS 音频 → 生成配音文件
5. 验证更新 → 填充音频时长
6. 脚手架 → 生成 Manim 代码框架
7. 实现代码 → 根据分镜实现动画
8. 渲染验证 → 生成最终视频

更新 Skill

cd ~/.openclaw/workspace/skills/tutor
git pull

关键特性

音画同步（v1.1.0 重要更新）

• ✅ 强制启用音频：self.add_sound() 不再允许注释
• ✅ 字幕整句同步：使用 show_subtitle_synced() 方法
• ✅ 禁止逐行迭代：避免 for line in lines: wait() 导致脱节

查看 QUICKREF.md 获取快速参考。

目录说明

• scripts/ - TTS 生成、音频验证、代码检查、渲染等脚本
• templates/ - Manim 脚手架模板
• references/ - 分镜脚本示例
• sample/ - 早期探索示例，可以作为参考

使用方式

# 生成 TTS 音频
python scripts/generate_tts.py audio_list.csv ./audio

# 验证音频并更新分镜
python scripts/validate_audio.py 分镜.md ./audio

# 检查代码结构
python scripts/check.py

# 渲染视频
python scripts/render.py

文档

• INSTALL.md - 详细安装指南