Math Concept Film

math-concept-film · 数学概念短片生成器

**你说一个概念，AI 还你一部带旁白的数学动画短片。**

这是一个给 AI 编程助手（Claude Code /codex/ Workbuddy 等）用的技能（skill）。 装好之后，你只需要对你的 AI 说一句：

“帮我用视频讲清楚傅里叶级数” “把泰勒公式做成动画” “我想看懂特征值到底在干嘛”

几分钟后，你会得到一部 **2~4 分钟、纸墨手账质感、中文配音、带字幕** 的 `final.mp4`。

b站视频展示例子： https://www.bilibili.com/video/BV1ws4R6fEHh/

---

它做出来的片子长什么样？

• 📜 宣纸暖底、墨色笔触——像一本会动的数学手账，不是炫酷科技风
• 🎙️ 中文旁白——微软云扬声线（可换晓晓/云希），语速 +15%，不催眠
• 🧮 公式白话化——每个符号出现前，先用大白话把主意喊出来
• 🎬 镜头会讲课——讲局部就推近，讲完拉回全景，逐项巡讲公式 ，基于Manim技术
• ✅ 数学保真——画面上每个数字都经过验算，每个"所以"都有前因

内置成片实例：《方波的和声》（傅里叶级数，89 秒）、泰勒公式预告片等。

怎么用

在codex/workbuddy等安装好skill， 对 AI 助手说人话就行。AI 会自动走完这条流水线：

你的概念 ──▶ 写台词 ──▶ AI 配音 ──▶ 量出每句时长
                                          │
        final.mp4 ◀── 音画合成 ◀── 渲染动画 ◀── 按真实时长设计画面

AI 干活期间你唯一要做的事：**验收**。它会给你 `final.mp4`， 不满意就指出"第 X 秒那里节奏太快"，它会返工。

目录里都是什么

math-concept-film/
├── README.md            ← 你正在看的：给人读的说明书
├── SKILL.md             ← 给 AI 读的"操作宪法"（触发词、工作流、风格规范）
├── requirements.txt     ← 一条 pip 命令装齐的依赖清单
├── references/          ← AI 的进阶教材
│   ├── cinematography-grammar.md   镜头语言手册
│   ├── scene-contract.md           画面质量自查清单
│   └── pitfalls.md                 已知坑与解法（血泪史合集）
├── templates/
│   └── film_skeleton.py            新片起点（可直接渲染的样板工程）
└── scripts/
    ├── doctor.py                   环境体检：缺啥装啥，一步到位
    └── tts_lines.py                台词 → 配音 + 时间轴

常见问题

**Q：一定要联网吗？** 配音环节要（微软在线 TTS，免费）。渲染不需要。

**Q：能换音色吗？** 能。`python scripts/tts_lines.py --list-voices` 列出全部中文声音， `--voice zh-CN-XiaoxiaoNeural` 换成晓晓。

**Q：能出 1080p 吗？** 能。渲染时把 `-ql` 换成 `-qh`（慢一些，1080p60）。

**Q：英文内容支持吗？** 技术上可以（换英文音色+英文台词），但风格的措辞、韵律都是按中文调校的， 英文属于"能跑但没调过味"。

**Q：视频是竖屏能做吗？** 画面尺寸由 manim 分辨率参数决定，改配置即可，但版式是按 16:9 横屏设计的， 竖屏需要自己调构图。

**Q：体检报错怎么办？** `python scripts/doctor.py` 的输出会精确告诉你缺什么、复制哪条命令能装上， 照做即可。绝大多数问题一条 `pip install` 解决。

---

特别感谢

https://linux.do 社区支持

*本技能有参考学习 Math-To-Manim 项目