Manim 视频制作管线
使用时机
当用户请求:动画解释、数学动画、概念可视化、算法演示、技术讲解、3Blue1Brown 风格视频或任何包含几何/数学内容的程序化动画时使用。使用 Manim Community Edition 创建 3Blue1Brown 风格的解释视频、算法可视化、方程推导、架构图和数据故事。
创意标准
这是教育电影。每一帧都在教学。每一个动画都揭示结构。
在编写一行代码之前,先阐明叙事弧线。它纠正了什么误解?什么是“顿悟时刻”?什么视觉故事将观众从困惑引向理解?用户的提示是一个起点——要用教学抱负去诠释它。
几何先于代数。 先展示形状,再展示方程。视觉记忆比符号记忆编码更快。当观众在公式之前看到几何模式时,这个方程就显得理所当然。
首次渲染的品质不容妥协。 输出必须在视觉上清晰且美学上协调,无需修改轮次。如果某些内容看起来杂乱、时机不当或像“AI 生成的幻灯片”,那就是错的。
不透明度分层引导注意力。 永远不要将所有元素以全亮度显示。主要元素为 1.0,上下文元素为 0.4,结构元素(轴、网格)为 0.15。大脑分层处理视觉显著性。
留有呼吸空间。 每个动画后都需要 self.wait()。观众需要时间吸收刚刚出现的内容。切勿仓促地从一个动画跳到下一个。在关键揭示之后停顿 2 秒钟绝非浪费。
连贯的视觉语言。 所有场景共享色彩搭配、一致的字体大小、匹配的动画速度。一个技术上正确但每个场景都使用随机不同颜色的视频在美学上是失败的。
先决条件
运行 scripts/setup.sh 以验证所有依赖项。需要:Python 3.10+、Manim Community Edition v0.20+ (pip install manim)、LaTeX(Linux 上为 texlive-full,macOS 上为 mactex)和 ffmpeg。参考文档已在 Manim CE v0.20.1 上测试通过。
模式
| 模式 | 输入 | 输出 | 参考 |
|---|---|---|---|
| 概念解释 | 主题/概念 | 带有几何直觉的动画解释 | references/scene-planning.md |
| 方程推导 | 数学表达式 | 分步动画证明 | references/equations.md |
| 算法可视化 | 算法描述 | 数据结构的分步执行 | references/graphs-and-data.md |
| 数据故事 | 数据/指标 | 动画图表、比较、计数器 | references/graphs-and-data.md |
| 架构图 | 系统描述 | 组件逐步构建并连接 | references/mobjects.md |
| 论文讲解 | 研究论文 | 主要发现和方法动画化 | references/scene-planning.md |
| 3D 可视化 | 3D 概念 | 旋转曲面、参数曲线、空间几何 | references/camera-and-3d.md |
技术栈
每个项目单个 Python 脚本。无需浏览器、无需 Node.js、无需 GPU。
| 层级 | 工具 | 用途 |
|---|---|---|
| 核心 | Manim Community Edition | 场景渲染、动画引擎 |
| 数学 | LaTeX (texlive/MiKTeX) | 通过 MathTex 渲染方程 |
| 视频 I/O | ffmpeg | 场景拼接、格式转换、音频混合 |
| 语音合成 | ElevenLabs / Qwen3-TTS (可选) | 配音旁白 |
管线
规划 --> 编码 --> 渲染 --> 拼接 --> 音频 (可选) --> 审查
- 规划 (PLAN) — 编写
plan.md,包含叙事弧线、场景列表、视觉元素、色彩搭配、旁白脚本 - 编码 (CODE) — 编写
script.py,每个场景一个类,可独立渲染 - 渲染 (RENDER) — 使用
manim -ql script.py Scene1 Scene2 ...生成草稿,-qh生成成品 - 拼接 (STITCH) — 使用 ffmpeg 将场景剪辑拼接成
final.mp4 - 音频 (AUDIO) (可选) — 通过 ffmpeg 添加旁白和/或背景音乐。详见
references/rendering.md - 审查 (REVIEW) — 渲染预览静态帧,对照计划验证,进行调整
项目结构
project-name/
plan.md # 叙事弧线、场景分解
script.py # 所有场景在一个文件中
concat.txt # ffmpeg 场景列表
final.mp4 # 拼接后的输出
media/ # 由 Manim 自动生成
videos/script/480p15/
创意指导
色彩搭配
| 搭配 | 背景色 | 主色 | 辅色 | 强调色 | 用途 |
|---|---|---|---|---|---|
| 经典 3B1B | #1C1C1C | #58C4DD (蓝色) | #83C167 (绿色) | #FFFF00 (黄色) | 通用数学/计算机科学 |
| 暖色学术 | #2D2B55 | #FF6B6B | #FFD93D | #6BCB77 | 平易近人 |
| 霓虹科技 | #0A0A0A | #00F5FF | #FF00FF | #39FF14 | 系统、架构 |
| 单色 | #1A1A2E | #EAEAEA | #888888 | #FFFFFF | 极简主义 |
动画速度
| 上下文 | run_time | 后面的 self.wait() |
|---|---|---|
| 标题/介绍出现 | 1.5秒 | 1.0秒 |
| 关键方程揭示 | 2.0秒 | 2.0秒 |
| 变换/变形 | 1.5秒 | 1.5秒 |
| 支撑性标签 | 0.8秒 | 0.5秒 |
| FadeOut 清理 | 0.5秒 | 0.3秒 |
| “顿悟时刻”揭示 | 2.5秒 | 3.0秒 |
排版比例
| 角色 | 字号 | 用法 |
|---|---|---|
| 标题 | 48 | 场景标题、开场文字 |
| 标题 | 36 | 场景内的章节标题 |
| 正文 | 30 | 解释性文字 |
| 标签 | 24 | 注释、坐标轴标签 |
| 说明 | 20 | 字幕、细节信息 |
字体
所有文本使用等宽字体。 Manim 的 Pango 渲染器在任何大小下使用比例字体时都会产生错误的字距调整。完整建议请参见 references/visual-design.md。
MONO = "Menlo" # 在文件顶部定义一次
Text("Fourier Series", font_size=48, font=MONO, weight=BOLD) # 标题
Text("n=1: sin(x)", font_size=20, font=MONO) # 标签
MathTex(r"\nabla L") # 数学 (使用 LaTeX)
最小 font_size=18 以保证可读性。
每个场景的变化
切勿为所有场景使用相同的配置。每个场景应:
- 使用色彩搭配中的不同主色
- 使用不同的布局 — 不要总是将所有内容居中
- 使用不同的动画入场方式 — 交替使用 Write、FadeIn、GrowFromCenter、Create
- 具有不同的视觉重量 — 有些场景密集,另一些稀疏
工作流程
步骤 1:规划 (plan.md)
在任何代码之前,编写 plan.md。完整模板请参见 references/scene-planning.md。
步骤 2:编码 (script.py)
每个场景一个类。每个场景可独立渲染。
from manim import *
BG = "#1C1C1C"
PRIMARY = "#58C4DD"
SECONDARY = "#83C167"
ACCENT = "#FFFF00"
MONO = "Menlo"
class Scene1_Introduction(Scene):
def construct(self):
self.camera.background_color = BG
title = Text("Why Does This Work?", font_size=48, color=PRIMARY, weight=BOLD, font=MONO)
self.add_subcaption("Why does this work?", duration=2)
self.play(Write(title), run_time=1.5)
self.wait(1.0)
self.play(FadeOut(title), run_time=0.5)
关键模式:
- 每个动画添加字幕:
self.add_subcaption("text", duration=N)或在self.play()中使用subcaption="text" - 文件顶部共享颜色常量 确保场景间的一致性
- 每个场景设置
self.camera.background_color - 干净退出 — 场景结束时许所有 mobject:
self.play(FadeOut(Group(*self.mobjects)))
步骤 3:渲染
manim -ql script.py Scene1_Introduction Scene2_CoreConcept # 草稿
manim -qh script.py Scene1_Introduction Scene2_CoreConcept # 成品
步骤 4:拼接
cat > concat.txt << 'EOF'
file 'media/videos/script/480p15/Scene1_Introduction.mp4'
file 'media/videos/script/480p15/Scene2_CoreConcept.mp4'
EOF
ffmpeg -y -f concat -safe 0 -i concat.txt -c copy final.mp4
步骤 5:审查
manim -ql --format=png -s script.py Scene2_CoreConcept # 预览静态帧
关键实现说明
LaTeX 使用原始字符串
# 错误: MathTex("\frac{1}{2}")
# 正确:
MathTex(r"\frac{1}{2}")
边缘文本的 buff >= 0.5
label.to_edge(DOWN, buff=0.5) # 绝不能 < 0.5
替换文本前先 FadeOut
self.play(ReplacementTransform(note1, note2)) # 而不是在上面 Write(note2)
切勿动画尚未添加的 Mobject
self.play(Create(circle)) # 必须先添加
self.play(circle.animate.set_color(RED)) # 然后才动画
性能目标
| 质量 | 分辨率 | 帧率 | 速度 |
|---|---|---|---|
-ql (草稿) | 854x480 | 15 | 5-15秒/场景 |
-qm (中等) | 1280x720 | 30 | 15-60秒/场景 |
-qh (成品) | 1920x1080 | 60 | 30-120秒/场景 |
始终在 -ql 质量下迭代。仅对最终输出渲染 -qh。
参考
| 文件 | 内容 |
|---|---|
references/animations.md | 核心动画、缓动函数、组合、.animate 语法、定时模式 |
references/mobjects.md | 文本、形状、VGroup/Group、定位、样式、自定义 mobject |
references/visual-design.md | 12 条设计原则、不透明度分层、布局模板、色彩搭配 |
references/equations.md | Manim 中的 LaTeX、TransformMatchingTex、推导模式 |
references/graphs-and-data.md | 坐标轴、绘图、BarChart、动画数据、算法可视化 |
references/camera-and-3d.md | MovingCameraScene、ThreeDScene、3D 曲面、相机控制 |
references/scene-planning.md | 叙事弧线、布局模板、场景过渡、规划模板 |
references/rendering.md | CLI 参考、质量预设、ffmpeg、配音工作流、GIF 导出 |
references/troubleshooting.md | LaTeX 错误、动画错误、常见错误、调试 |
references/animation-design-thinking.md | 何时动画 vs 静态展示、分解、节奏、旁白同步 |
references/updaters-and-trackers.md | ValueTracker、add_updater、always_redraw、基于时间的更新器、模式 |
references/paper-explainer.md | 将研究论文转换为动画——工作流、模板、领域模式 |
references/decorations.md | SurroundingRectangle、Brace、箭头、DashedLine、Angle、注释生命周期 |
references/production-quality.md | 编码前、渲染前、渲染后检查清单、空间布局、颜色、节奏 |
创意发散(仅在用户请求实验性/创造性/独特输出时使用)
如果用户要求创造性、实验性或非传统的解释方法,请在设计动画之前选择一种策略并阐述其理由。
- SCAMPER — 当用户希望为标准解释带来新鲜视角时
- 假设反转 — 当用户想要挑战某事物通常的教学方式时
SCAMPER 转换
以标准数学/技术可视化为基础进行转换:
- 替代 (Substitute):替换标准的视觉比喻(数轴 → 蜿蜒路径,矩阵 → 城市网格)
- 组合 (Combine):合并两种解释方法(代数 + 几何同时进行)
- 逆向 (Reverse):反向推导——从结果开始,解构到公理
- 修改 (Modify):夸大某个参数以显示其重要性(10 倍的学习率,1000 倍的样本量)
- 消除 (Eliminate):移除所有符号——仅通过动画和空间关系进行解释
假设反转
- 列出关于该主题可视化的“标准”方式(从左到右、2D、离散步骤、正式符号)
- 选择最根本的假设
- 反转它(从右到左推导、2D 概念的 3D 嵌入、连续变形代替步骤、零符号)
- 探索反转所揭示的、标准方法所隐藏的内容