Communitygithub.com

manim

使用 Manim Community 渲染解說動畫和靜態插圖。當視覺呈現比文字更能解釋概念時(如數學、方程式、函數圖形、幾何、圖形/網路、表格、矩陣、3D、向量場),或用戶要求動畫、圖表或 Manim 場景時使用。

manim 是什麼?

此技能讓 AI 代理能運用 Manim Community v0.22.1 建立解釋性動畫與靜態圖表,特別適用於數學、幾何、圖形與資料視覺化等概念。安裝環境包含完整的 TeX Live 支援(方程式渲染)、用於旁白的 Chatterbox Turbo 神經語音合成,以及用於圖示的 Tabler Icons 和 Fluent Emoji 庫。代理會按照結構化工作流程操作:根據主題檔案選擇合適的範例、使用 Python 與 ManimCE API 撰寫場景、運用特定輔助函式(如 icon()、reading_time 檢查、narration.py、produced_by.py)來確保高品質輸出。執行程序包括低品質草稿渲染以檢查構圖與時機,最終以 1080p60 呈現,並將產出的 MP4 或 PNG 直接內嵌至支援媒體的介面中(如 T3 Code)。此技能在 Claude Code、Coder 或 Cursor 等基於終端機或網路的 AI 編碼代理中運作,利用其系統指令中定義的工具來產生與傳遞精緻的數學與技術動畫。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/logan-gatlin/manim-skill/tree/HEAD

在你喜歡的 AI 中提問

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

預覽

來自技能 README

title

說明文件

manim 是做什麼的?

安裝位置:Manim Community v0.22.1(manim 在 PATH 上,以 uv tool 安裝並帶有 typst 擴充),加上 TeX Live 和 dvisvgm 以支援 Tex/MathTex,以及 Chatterbox Turbo 用於旁白(在自有虛擬環境下的 CPU 安裝,位於 ~/.local/opt/chatterbox,由 narration.py 驅動)。場景檔案在工具自帶的 Python 環境中執行,該環境包含 numpy、scipy 和 networkx;其他匯入會失敗。僅使用 ManimCE API。3Blue1Brown 的 manimgl 是不同的函式庫,因此為它撰寫的程式碼無法在此執行。

風格

Manim 是一種以動態且有趣的方式呈現資訊的工具。 如果你的作品可以輕鬆地被製作成流程圖、試算表、點圖或投影片,那你就沒有正確使用 manim。 美麗更能吸引人,也更能令人難忘。 避免技術術語,保持你的簡報易於理解。 選擇一組主題並堅持使用它們——一個概念應該有統一的視覺呈現。 講述一個故事,從故事中間開始。 從基本原理開始介紹想法和問題

步驟

  1. 選擇輸出格式。 對於靜態圖片(如標示圖、圖表、表格或公式),使用靜態 PNG。當重點在於變化或序列(如逐步推導、移動的點、變換)時,使用 MP4。僅在目標位置無法播放影片時才使用 GIF。

  2. 尋找最接近的範例。 打開下方的主題檔案,掃描頂端的索引,然後閱讀最接近你需求的 1-3 個範例。透過改編這些範例來建立你的場景:它們的 API 用法已知可在這個版本上執行。

  3. 撰寫場景 到 /tmp/manim/<slug>/scene.py,除非使用者指定了其他位置。以 from manim import * 開頭,並定義一個 Scene 子類別(當範例使用時,可為 MovingCameraScene / ThreeDScene / ZoomedScene)。

    每個物體的圖片(如雲端、伺服器、掛鎖、旗幟、人物、文件)都是來自此技能庫的圖示,直接使用即可:將 icons.py 複製到場景旁,透過在此技能目錄中執行 grep -iw <單詞> assets/index.tsv 來尋找 ID(如果找不到,可嘗試同義詞),然後使用 icon(id, color=..., height=...) 來載入它。tabler/outline/* 和 tabler/filled/* 是使用 color 繪製的單色線條和實心圖示(Tabler Icons);fluent/* 是保留自身顏色的全彩表情符號(Fluent Emoji,扁平風格)。僅使用 Manim 的形狀(如方塊、箭頭、線條、軸、圖形和標籤)來繪製圖表的結構。為每個概念指定一個圖示並重複使用它,作為其中一個主題。

    MP4 或 GIF 若包含文字,必須為觀眾提供閱讀時間,並且有檢查機制會強制執行。將 reading_time.py 複製到場景旁,使用 from reading_time import ReadingTime 匯入,並將 mixin 放在場景基底類別之前:class SceneName(ReadingTime, Scene)。在每次隱藏、替換或淡化文字的 play 之前呼叫 self.wait_to_read()。它會保持等待,直到每個可見文字已顯示在螢幕上至少 1 秒,再加上以每分鐘 150 字計算其字數所需的時間,且所有由一個 play 揭示的文字會被一起計算。應以新的 mobject(FadeIn、ReplacementTransform)顯示新文字,而不是使用 become(),這樣它的計時才會重新開始。動畫可以在等待期間繼續進行:將 self.wait_to_read() 放在文字顯示期間播放的動畫之後。

    MP4 若包含字幕解說,也會有旁白:會有語音朗讀。將 narration.py 複製到場景旁,並將其放在 ReadingTime 之前:class SceneName(Narration, ReadingTime, Scene)。self.speak(text) 會等待前一段語音完成,然後開始下一段,之後的動畫會在語音播放的同時進行。將其放在顯示它朗讀的字幕的 play 之前。字幕會逐字顯示朗讀的句子,每個朗讀的句子都有對應的字幕:每個句子只寫一次,並將相同的字串傳遞給 speak 和字幕的 Text。當語音需要螢幕上不顯示的重新拼寫時(例如將 "20" 讀作 "twenty"),請將其放入場景的 pronounce 字典中,這只會改變發聲的內容。在有旁白的場景中,語音會取代字數來設定停留時間:在朗讀句子時出現的文字必須保持顯示,直到旁白者說完並加上 0.5 秒的暫停,而 self.wait_to_read() 會剛好等待那麼久才會進行下一次變更(在靜默期間顯示的文字則遵循字數規則)。語音是一個平靜男性旁白(Chatterbox Turbo)的神經複製,專為逐步講解技術圖表而調整。每一行新的台詞大約需要 1-3 倍其朗讀長度的時間來合成(包括草稿靜態畫面),並快取在 media/voice 目錄下,因此後續渲染只會對修改過的行進行語音合成。撰寫每一行時,要讓它聽起來自然,而不是被閱讀。像 API、TLS 和 HTTP 這樣的縮寫可以直接朗讀,而 narration.py 已經會自動拼出數字後的單位(200 ms)、帶點號的版本號(2.4.1)和 k8s。請以旁白者的方式說出其他機器字串,同樣透過 pronounce:例如說 "seventeen eleven",而不是 "2026.11.1711"。描述路徑和分支名稱時應說明而非逐字朗讀(例如 "an auto patches release branch"),並透過場景的 pronounce 字典修正任何語音念錯的單詞(例如 {"edgeworker": "edge worker"})。

    每個 MP4 或 GIF 的最後會有一個製作者卡片,顯示製作的模型名稱。將 produced_by.py 複製到場景旁,並將 mixin 放在所有其他 mixin 之前:class SceneName(ProducedBy, Narration, ReadingTime, Scene)(對於沒有文字的場景則為 class SceneName(ProducedBy, Scene)),並將 produced_by 設定為你的系統提示所給的模型名稱(例如 produced_by = "Claude Opus 5.5")。如果你的指示沒有指定模型名稱,請詢問使用者。當場景、其旁白和閱讀時間檢查都完成後,mixin 會淡化場景並在最後 0.5 秒顯示卡片。靜態渲染會跳過此步驟。

  4. 草稿與檢查。 渲染低品質的靜態畫面並查看 PNG:

    cd /tmp/manim/<slug> && manim render -ql -s --media_dir media -o draft scene.py SceneName
    # -> media/images/scene/draft.png
    

    對於動畫,也要檢查關鍵時刻:-s -n 0,K 會在動畫 K(從 0 開始;每個 self.play 和每個 self.wait 算一個)之後停止並儲存該影格。影格大小約為 14.2 × 8 單位,以原點為中心。修正並重新渲染,直到你檢查的每個影格都顯示所有元素在影格內、沒有重疊的標籤,並且文字清晰可讀。

    如果場景過早移除文字,會觸發 ReadingTimeError,其中會列出每個文字、出現時間、實際顯示時間以及所需時間。在每個列出的變更之前添加 self.wait_to_read()。要在時間校正之前查看草稿影格,請在指令前加上 MANIM_READING_TIME=warn。最終渲染時不會有這個設定,且必須通過。

  5. 最終渲染。 使用 -qm(720p30)。3D 場景在 Cairo 渲染器上速度較慢,因此請使用 -ql 進行草稿。

    manim render -qh --media_dir media -o final scene.py SceneName
    # -> media/videos/scene/1080p60/final.mp4   (若為 GIF 則加上 --format gif;若為 PNG 則加上 -s,產出為 media/images/scene/final.png)
    
  6. 傳遞。 當你的介面可以顯示輸出時(即你的指示說明 Markdown 圖片語法可以嵌入圖片或影片時,例如 T3 Code),直接內嵌顯示它。將輸出檔案複製到工作目錄中,然後使用其絕對路徑從那裡嵌入(![title](/abs/path/out.mp4);這對 MP4 和 PNG 都有效)。T3 Code 只會內嵌顯示來自工作目錄的媒體,因此指向 /tmp 的嵌入會顯示為純文字連結。在僅顯示文字的介面(如純終端機)中,則改為提供輸出檔案的絕對路徑。無論哪種方式,也要提供場景檔案的路徑,以便使用者調整。

    每個迭代都以傳遞結束。 每當你修改場景時,無論是為了使用者的反饋還是你自己的修正,都要以最終品質重新渲染集合中的每個影片(即使你未修改的也要),並按照步驟 6 傳遞每個影片。靜態圖片和影格抓取有助於你檢查作品,但它們不能取代影片。為每一輪賦予自己的檔案名稱(<name>-v2.mp4、<name>-v3.mp4),以便先前的訊息繼續顯示它們所描述的版本。

主題檔案

每個檔案都包含經過渲染測試的範例,除非檔案另有說明,否則內容直接取自 v0.22.1 文件,頂端有索引。

  • references/basics.md:定位、樣式設定、分組/排列、.animate、Transform、自訂動畫。
  • references/text-and-math.md:Text/MarkupText、Tex/MathTex、Typst 數學、公式部分著色、方程式重排、項目符號列表、標題、程式碼區塊、大括號、動態數字。
  • references/plots-and-axes.md:Axes 圖形、面積與黎曼和、導數/割線、隱函數/參數/極座標曲線、對數軸、數據折線圖、數線與數平面、複數平面、長條圖。
  • references/diagrams-and-geometry.md:箭頭、標示的線/點/形狀、角度、直角、高亮(包圍框、底線、叉號)、文氏圖/布林形狀、多邊形、虛線輪廓。
  • references/code.md:語法高亮程式碼:鍵入、高亮行、選取標記、將一個版本轉換為下一個。
  • references/graphs-tables-matrices.md:節點連結 Graph/DiGraph、樹狀圖、神經網路層、匯入 networkx、佈局變更、表格、矩陣、行列式、平面的線性變換。
  • references/animation-and-motion.md:更新器、ValueTracker、always_redraw、軌跡路徑、變換變體、MoveToTarget/Restore、Succession/LaggedStart 時序、強調效果(Indicate、Circumscribe、Flash)、增長/淡入出場、速率函數。
  • references/camera-3d-fields.md:移動/縮放攝影機、縮放插圖、ThreeDScene 攝影機控制、3D 曲面與曲線、向量場與流線。
  • references/complete-scenes.md:兩個較長的場景,展示如何安排多步驟解釋的節奏。

查閱 API

已安裝的原始碼,包含完整的 docstring,位於 ~/.local/share/uv/tools/manim/lib/python3.13/site-packages/manim/。在猜測關鍵字參數之前,請使用 grep 搜尋類別或方法的簽名和選項。

注意事項

  • 將 LaTeX 字串寫為原始字串(r"\frac{a}{b}")。LaTeX 錯誤會輸出 .tex 日誌,問題行通常靠近結尾。
  • xelatex 未安裝,因此需要它的 TexTemplateLibrary 模板(如 ctex)會失敗。對於中日韓(CJK)文字,請使用 Text/MarkupText,它們透過 Pango 和系統字型(fc-list 顯示)進行渲染。
  • Typst / MathTypst 是 Tex / MathTex 的更快替代方案,且不需要 LaTeX。
  • 使用 icon() 載入圖示,它會重新著色 Tabler 圖示:它們的檔案使用 currentColor 繪製,而純 SVGMobject 會將其讀為黑色。
  • 以黑色繪製的 Fluent 圖示(fluent/black-flag、fluent/black-cat)會在黑色背景上消失;請選擇其他圖示,或將其放在淺色形狀上。
  • Tabler 線條圖示會遺失繪製為零長度線條的點,例如 tabler/outline/server 上的指示燈。

相關技能