Communitygithub.com

Syammon02/VideoUse

使用 Manim Community Edition 製作數學與技術動畫的生產流程。可產出 3Blue1Brown 風格的解說影片、演算法視覺化、方程式推導、系統架構圖與資料故事。

VideoUse 是什麼?

這是一套完整的 Manim 影片生產流程,專為製作高品質的數學與技術動畫而設計。它提供了一個結構化的六步驟管線(規劃、編碼、渲染、拼接、音訊、審查),並強制執行嚴格的創意標準,例如幾何優先於代數、不透明的分層與呼吸空間。該技能支援七種模式(概念解說、方程式推導、演算法視覺化、資料故事、架構圖、論文解說、3D 視覺化),每種模式都有對應的參考文件。它依賴於 Manim Community Edition、LaTeX、ffmpeg 和可選的 TTS 服務。核心強制要求包括:統一的色彩主題(提供四種色板)、定義清晰的動畫速度與字型排版比例、場景間的變化以保持視覺趣味,以及使用原始字串與足夠邊距等關鍵實作細節。它還提出了「創意分歧」策略(SCAMPER 與假設逆轉),用於在標準解釋方法無法滿足需求時,進行實驗性與非傳統的視覺化。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Syammon02/VideoUse/tree/HEAD/skills/manim-video

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Manim 影片生產流程

創意標準

這是教育電影。每一幀都在教學。每一個動畫都在揭示結構。

在撰寫任何程式碼之前,先闡明敘事弧線。它要糾正什麼誤解?「頓悟時刻」是什麼?什麼樣的視覺故事能帶領觀眾從困惑走向理解?使用者的提示只是一個起點——要用教學野心來解讀它。

幾何先於代數。 先展示形狀,再展示方程式。視覺記憶的編碼速度快於符號記憶。當觀眾在看到公式之前先看到幾何模式時,方程式會感覺是應得的。

首次渲染就要達到卓越,這是沒得商量。 輸出必須在視覺上清晰且在美學上連貫,無需修改回合。如果有些東西看起來雜亂、時間控制不佳,或像是「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/Offmpeg場景拼接、格式轉換、音訊混流
語音ElevenLabs / Qwen3-TTS(可選)旁白配音

管線

規劃 --> 編碼 --> 渲染 --> 拼接 --> 音訊(可選) --> 審查
  1. 規劃 — 撰寫 plan.md,包含敘事弧線、場景列表、視覺元素、色板、旁白腳本
  2. 編碼 — 撰寫 script.py,每個場景一個類別,每個類別可獨立渲染
  3. 渲染 — 草稿用 manim -ql script.py Scene1 Scene2 ...,正式版用 -qh
  4. 拼接 — 使用 ffmpeg 將場景片段串聯成 final.mp4
  5. 音訊(可選) — 透過 ffmpeg 加入旁白和/或背景音樂。請參閱 references/rendering.md
  6. 審查 — 渲染預覽靜止畫面,對照規劃進行驗證,調整

專案結構

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("傅立葉級數", 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("為什麼這行得通?", font_size=48, color=PRIMARY, weight=BOLD, font=MONO)
        self.add_subcaption("為什麼這行得通?", 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("文字", duration=N) 或 self.play() 上的 subcaption="文字"
  • 共享的顏色常數 放在檔案頂部,以實現跨場景一致性
  • self.camera.background_color 在每個場景中設定
  • 乾淨的退出 — 在場景結束時 FadeOut 所有 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))  # 然後才能執行動畫

效能目標

品質解析度FPS速度
-ql(草稿)854x480155-15 秒/場景
-qm(中等)1280x7203015-60 秒/場景
-qh(正式版)1920x10806030-120 秒/場景

始終使用 -ql 進行迭代。只在最終輸出時使用 -qh 渲染。

參考資料

檔案內容
references/animations.md核心動畫、速率函數、組合、.animate 語法、時間控制模式
references/mobjects.md文字、形狀、VGroup/Group、定位、樣式化、自訂 mobject
references/visual-design.md12 個設計原則、不透明度分層、佈局範本、色板
references/equations.mdManim 中的 LaTeX、TransformMatchingTex、推導模式
references/graphs-and-data.md軸、繪圖、BarChart、動畫資料、演算法視覺化
references/camera-and-3d.mdMovingCameraScene、ThreeDScene、3D 曲面、相機控制
references/scene-planning.md敘事弧線、佈局範本、場景轉場、規劃範本
references/rendering.mdCLI 參考、品質預設、ffmpeg、旁白工作流程、GIF 匯出
references/troubleshooting.mdLaTeX 錯誤、動畫錯誤、常見錯誤、除錯
references/animation-design-thinking.md何時動畫化 vs 顯示靜態、分解、節奏、旁白同步
references/updaters-and-trackers.mdValueTracker、add_updater、always_redraw、基於時間的 updater、模式
references/paper-explainer.md將研究論文轉化為動畫 — 工作流程、範本、領域模式
references/decorations.mdSurroundingRectangle、Brace、箭頭、DashedLine、Angle、註解生命週期
references/production-quality.md編碼前、渲染前、渲染後檢查清單、空間佈局、顏色、節奏

創意分歧(僅在使用者要求實驗性/創意性/獨特輸出時使用)

如果使用者要求創意性、實驗性或非傳統的解說方法,請在設計動畫之前選擇一個策略並進行推理。

  • SCAMPER — 當使用者想要對標準解說進行全新詮釋時
  • 假設逆轉 — 當使用者想要挑戰某個主題的典型教學方式時

SCAMPER 轉換

對標準的數學/技術視覺化進行轉換:

  • 替代:替換標準的視覺隱喻(數線 → 蜿蜒路徑,矩陣 → 城市網格)
  • 結合:合併兩種解說方法(代數 + 幾何同時進行)
  • 逆向:反向推導 — 從結果開始,解構到公理
  • 修改:誇大某個參數以顯示其重要性(10 倍的學習率,1000 倍的樣本大小)
  • 消除:移除所有符號 — 純粹透過動畫和空間關係來解釋

假設逆轉

  1. 列出關於這個主題如何被視覺化的「標準」做法(從左到右、2D、離散步驟、正式符號)
  2. 選擇最根本的假設
  3. 將其逆轉(從右到左的推導、2D 概念的 3D 嵌入、連續形變而非步驟、零符號)
  4. 探索逆轉揭示了哪些標準方法所隱藏的東西

相關技能