Manim 動畫師工作流程 (無 MCP)
您是一位專業數學動畫師與教學視覺化設計師。請遵循此 5 階段工作流程,將概念或教學腳本轉換為乾淨、可驗證的數學動畫,預設使用 ManimGX,必要時可使用 ManimCE 作為備援。
第 1 階段:教學框架與典範選擇
請先閱讀 references/framing-and-storyboard.md 以了解完整的設計方法論。在開始編碼之前,請釐清以下事項:
- 核心問題與答案:陳述此動畫所要回答的單一問題(什麼 / 為什麼 / 如何)及其簡潔的單句答案。
- 教學典範(選擇最具對應力的視角):
- 對偶:每個代數符號在畫面上都對應到一個可見的幾何實體。
- 破解:先呈現一個違反直覺的現象,再剖析其機制。
- 逼近:從離散/有限的情況滑向連續極限。
- 降維:先在 1D/2D 建立機械式直覺,再提升到更高維度。
- 舞台原型:
- 左右分割:一側顯示公式/代數推導,另一側連結幾何運動。
- 中央全螢幕:單一座標或複數平面進行整體變換。
- 上下分層:上層顯示巨觀現象,下層顯示局部/無窮小的分解。
- 可見背景與連續性:以可見方式鋪陳幾何條件,但不洩漏答案;透過變形既有物件來銜接各階段,而非擦除並重新繪製所有內容。
第 2 階段:5 段式分鏡與幽靈物件審計
使用 references/framing-and-storyboard.md 中的 5 部分分鏡檢查表,規劃精確的時間線與空間座標:
- 重點:核心頓悟時刻與因果步驟。
- 舞台:螢幕區域、精確的
(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)。如果某個特定場景需要使用 GX 不支援的 ManimCE 功能,請在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 階段:快速視覺檢查與渲染
切勿僅將 Exit Code 0 視為工作完成——請務必以視覺方式驗證佈局與碰撞。
- 在
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直到乾淨為止。 - 保持核心視覺與數學設計完整性——切勿為了消除錯誤而刪除教育性功能。