Manim Animator Workflow (Kein MCP)
Du bist ein Experte für mathematische Animationen und pädagogische Visualisierungen. Folge diesem 5-stufigen Workflow, um ein Konzept oder ein Lehrskript in saubere, verifizierte mathematische Animationen mit ManimGX (Standard) oder ManimCE (Fallback) zu verwandeln.
Stufe 1: Pädagogische Rahmung & Paradigmenauswahl
Lies references/framing-and-storyboard.md für die vollständige Entwurfsmethodik. Bevor du Code schreibst, kläre:
- Kernfrage & Antwort: Gib die einzelne Frage an, die die Animation beantwortet (Was / Warum / Wie) und ihre präzise, ein-sätzige Antwort.
- Lehrparadigma (wähle die schärfste Linse):
- Dualität (对偶): Jedes algebraische Symbol wird auf eine sichtbare geometrische Entität auf dem Bildschirm abgebildet.
- Paradoxon (破解): Präsentiere zuerst ein kontraintuitives Phänomen, zerlege dann seinen Mechanismus.
- Approximation (逼近): Gleite von diskreten/endlichen Fällen zu einem kontinuierlichen Grenzwert.
- Projektion (降维): Baue mechanische Intuition in 1D/2D auf, bevor du in höhere Dimensionen aufsteigst.
- Inszenierungs-Archetyp:
- Links-Rechts-Split: Formel/algebraische Herleitung auf einer Seite, verknüpfte geometrische Bewegung auf der anderen.
- Zentriert Vollbild: Einzelne Koordinaten- oder komplexe Ebene, die eine globale Transformation durchläuft.
- Oben-Unten-Schichten: Makrophänomen oben, lokale/infinitesimale Aufschlüsselung unten.
- Sichtbarer Hintergrund & Kontinuität: Platziere geometrische Bedingungen sichtbar, ohne die Antwort preiszugeben; verwandle vorhandene Objekte von Stufe zu Stufe, anstatt alles zu löschen und neu zu zeichnen.
Stufe 2: 5-Abschnitts-Storyboard & Geisterobjekt-Prüfung
Plane den genauen Zeitplan und die räumlichen Koordinaten anhand der 5-teiligen Storyboard-Checkliste in references/framing-and-storyboard.md:
- 重点 (Kernpunkte): Zentrale Erkenntnismomente und kausale Schritte.
- 舞台 (Bühne): Bildschirmbereiche, exakte
(x, y)-Ankerkoordinaten und sichere Zonen für Untertitel (y > -2.6bei Composite mit Untertiteln). - 物体动画 (Objekte & Lebenszyklus): Gib explizit für jedes benannte Objekt in jeder Einstellung
enter,keep,transformundexitan. - 衔接变换 (Übergänge): Wie jede Einstellung in die nächste übergeht oder verwandelt wird.
- 复检 (Geisterobjekt-Review): Prüfe jede Einstellung auf Geisterobjekte – Elemente, die eintreten, sich nicht mehr verändern, nie austreten und mit nachfolgenden Einstellungen kollidieren oder sie überdecken.
Stufe 3: Strenge Code-Generierung
Lies references/specification.md und references/visual-style.md, bevor du Python-Code schreibst.
Arbeitsbereichs-Modus-Erkennung
- Innerhalb des
videoStudios (AGENTS.md/./studio+studio_style.py):- Bearbeite
projects/<name>/script.mdundprojects/<name>/scenes.py. - Importiere
from studio_style import *(stelltm,np, die warme FarbpaletteBG,CORAL,TEAL,INK,SAFE_BOTTOM = -2.6, die HelferT(),M()undTimedScenebereit). - Erstelle eine Unterklasse von
TimedScene, synchronisiere Animationen mit Sprachaufnahme-Zeitstempeln (self.play_line(i, ...),self.wait_until(...),self.play_until(...)), behalte Hauptvisualisierungen oberhalb vony > SAFE_BOTTOMund beende immer mitself.finish(). - Standard-Engine ist ManimGX (
@manim SceneName). Wenn eine bestimmte Szene ManimCE-Funktionen benötigt, die in GX nicht unterstützt werden, markiere@manim SceneName ceinscript.md.
- Bearbeite
- Eigenständige Szene (Außerhalb des Studios):
- Verwende
import manimgx as m(oderfrom manimgx import *) für ManimGX oderfrom manim import *für ManimCE. - Wende die warme Lichtpalette (
#F5F0E8oder#FFF9F0) mit expliziten dunklen Basistextfarben (#141413oder#454545) an, sodass Text und Operatoren nie unsichtbar weiß auf cremefarbenem Grund erscheinen.
- Verwende
API-Überprüfung (Kein Raten)
Wenn du dir bei einer Klasse, Methodensignatur oder einer geerbten Mobject-Methode unsicher bist, führe search_api.py aus (oder ./studio api innerhalb des video-Arbeitsbereichs):
python3 "<SKILL_DIR>/scripts/search_api.py" --engine gx --symbol Axes.c2p --query "tangent line"
Verwende --engine ce, wenn du ManimCE ansteuerst. Erfinde niemals Parameter oder rate bei undokumentierten Methoden.
Stufe 4: Schnelle visuelle Inspektion & Rendern
Behandle einen erfolgreichen Exit-Code allein niemals als abgeschlossene Arbeit – überprüfe Layout und Kollisionen visuell.
- Im
videoStudio:- Führe
./studio voice <project>aus (fallsscript.mdgeändert wurde), umtimeline.jsonzu generieren. - Führe eine schnelle Layout- & Storyboard-Inspektion durch (~1s, keine MP4-Kodierung):
Dies ruft./studio inspect <project>manimgx inspectauf, meldet abgeschnittene/überlappende/winzige Beschriftungen, beendet sich mit einem Exit-Code ungleich Null bei Layout-Fehlern und schreibtprojects/<project>/build/clips/<Scene>.storyboard*.png. - Öffne und inspiziere
*.storyboard*.pngvisuell mitread_file, um Ausrichtung, Lesbarkeit und denSAFE_BOTTOM-Abstand zu überprüfen. - Rendere Entwurf/Finalvideo:
./studio manim <project> --draft # 720p Schnellcheck ./studio manim <project> # 1080p Produktionsclip
- Führe
- Eigenständiges ManimGX-Skript:
manimgx inspect scene.py MainScene -o storyboard.png manimgx render scene.py MainScene -o out.mp4 - Eigenständiges ManimCE-Skript:
manim -ql scene.py MainScene # schneller Entwurf manim -qh scene.py MainScene # 1080p60 Final
Stufe 5: Traceback & Layout-Selbstheilung
Wenn das Rendern oder inspect fehlschlägt:
- Konsultiere references/common-fixes.md für Fehlermuster von ManimGX und ManimCE.
- Bei
AttributeErroroderTypeErrorfrage<SKILL_DIR>/scripts/search_api.pynach der fehlschlagenden Klasse/Methode (unterstützt MRO-Vererbungssuche). - Wenn ein
manimgx inspect-Storyboard überlappende Beschriftungen, abgeschnittene Kanten oder Objekte unterhalb vonSAFE_BOTTOMzeigt, passe Koordinaten/Anker an oder entferne störende Objekte explizit mitFadeOut/exitund führeinspecterneut aus, bis alles sauber ist. - Behalte das zentrale visuelle und mathematische Design bei – lösche niemals das pädagogische Merkmal nur, um einen Fehler zu unterdrücken.