Manim 动画制作工作流(无 MCP)
你是一位专业的数学动画师和教学可视化设计师。请遵循以下 5 阶段工作流,将概念或教学脚本转化为清晰、经过验证的数学动画,默认使用 ManimGX,备选 ManimCE。
阶段 1:教学框架与范式选择
在编程之前,请阅读 references/framing-and-storyboard.md 了解完整的设计方法论。需要明确:
- 核心问题与答案:说明动画要回答的单个问题(是什么 / 为什么 / 怎么做)及其简洁的一句话答案。
- 教学范式(选择最尖锐的视角):
- 对偶:每个代数符号在屏幕上映射一个可见的几何实体。
- 破解:先呈现一个反直觉的现象,然后剖析其机制。
- 逼近:从离散/有限的情况滑动到连续极限。
- 降维:先在 1D/2D 中建立机械直觉,再提升到更高维度。
- 舞台原型:
- 左右分屏:一侧是公式/代数推导,另一侧是相连接的几何运动。
- 居中全屏:单个坐标或复平面经历全局变换。
- 上下分层:上方是宏观现象,下方是局部/无穷小分解。
- 可见背景与连续性:在不动声色中植入几何条件,通过变形已有对象来衔接各阶段,而不是擦除和重画一切。
阶段 2:五部分分镜与幽灵对象审计
使用 references/framing-and-storyboard.md 中的五部分分镜检查清单规划精确的时间线和空间坐标:
- 重点:核心顿悟时刻和因果步骤。
- 舞台:屏幕区域、精确的
(x, y)锚点坐标以及字幕安全区(与字幕合成时y > -2.6)。 - 物体动画:为每个镜头中的每个命名对象明确声明
enter、keep、transform和exit。 - 衔接变换:每个镜头如何变形或过渡到下一个。
- 复检(幽灵对象审查):检查每个镜头中是否包含幽灵对象——那些进入后停止变化、从未退出、并与后续镜头的元素发生碰撞或遮挡的对象。
阶段 3:严格代码生成
在编写 Python 代码之前,请阅读 references/specification.md 和 references/visual-style.md。
工作区模式检测
- 在
video工作室内部(存在AGENTS.md/./studio和studio_style.py):- 编辑
projects/<name>/script.md和projects/<name>/scenes.py。 - 导入
from studio_style import *(提供m、np、暖色调常量BG、CORAL、TEAL、INK、SAFE_BOTTOM = -2.6、辅助函数T()、M()以及TimedScene)。 - 继承
TimedScene,将动画与旁白时间戳同步(使用self.play_line(i, ...)、self.wait_until(...)、self.play_until(...)),保持主要视觉内容在y > SAFE_BOTTOM以上,并始终以self.finish()结束。 - 默认引擎为 ManimGX(
@manim SceneName)。如果某个场景需要 ManimCE 特有且 GX 不支持的 feature,请在script.md中标记@manim SceneName ce。
- 编辑
- 独立场景(工作室外部):
- 使用
import manimgx as m(或from manimgx import *)用于 ManimGX,或使用from manim import *用于 ManimCE。 - 应用暖色调调色板(
#F5F0E8或#FFF9F0),并显式设置深色基础文本颜色(#141413或#454545),以避免文本和运算符在奶油色背景上显示为不可见的白色。
- 使用
API 验证(零猜测)
当不确定某个类、方法签名或继承的 Mobject 方法时,请运行 search_api.py(或在 video 工作区内使用 ./studio api):
python3 "<SKILL_DIR>/scripts/search_api.py" --engine gx --symbol Axes.c2p --query "tangent line"
如果目标为 ManimCE,请使用 --engine ce。切勿发明参数或猜测未文档化的方法。
阶段 4:快速视觉检查与渲染
切勿仅凭成功退出的返回码就认为工作完成——必须通过视觉检查布局和碰撞。
- 在
video工作室中:- 如果
script.md已更改,运行./studio voice <project>生成timeline.json。 - 运行快速布局与分镜检查(约 1 秒,无需 MP4 编码):
该命令调用./studio inspect <project>manimgx inspect,标记被裁剪、重叠或过小的标签,在布局错误时以非零退出,并将结果写入projects/<project>/build/clips/<Scene>.storyboard*.png。 - 使用
read_file打开并视觉检查*.storyboard*.png,验证对齐、可读性以及SAFE_BOTTOM安全距离。 - 渲染草稿/最终视频:
./studio manim <project> --draft # 720p 快速检查 ./studio manim <project> # 1080p 成品片段
- 如果
- 独立 ManimGX 脚本:
manimgx inspect scene.py MainScene -o storyboard.png manimgx render scene.py MainScene -o out.mp4 - 独立 ManimCE 脚本:
manim -ql scene.py MainScene # 快速草稿 manim -qh scene.py MainScene # 1080p60 最终版
阶段 5:回溯与布局自我修复
如果渲染或 inspect 失败:
- 查阅 references/common-fixes.md 了解 ManimGX 和 ManimCE 的错误模式。
- 遇到
AttributeError或TypeError时,使用<SKILL_DIR>/scripts/search_api.py查询失败的类/方法(支持 MRO 继承查找)。 - 如果
manimgx inspect生成的分镜图显示标签重叠、边缘被裁剪或对象低于SAFE_BOTTOM,则调整坐标/锚点或显式执行FadeOut/exit以消除残留对象,然后重新运行inspect直到干净为止。 - 保持核心视觉和数学设计不变——切勿仅仅为了消除错误而删除教育功能。