Erklärvideo
Ein fertiges Erklärvideo ist eine MP4-Datei, deren Bilder sich mit den Worten bewegen: Jede Animation beginnt, sobald der Sprecher den dazugehörigen Satz erreicht, und die Untertitel werden anhand der Zeitstempel der Stimme getaktet. Die Arbeit erfolgt als Pipeline in einem Projekt-Ordner: narration.py (das Skript), scenes.py (Manim-Szenen), video.json (Titel, Stimme), screens/ (Screenshots) und kit/ (das mitgelieferte Toolkit, ausgeführt als python -m kit <Befehl> vom Projektstammverzeichnis).
Jeder Schnitt (eine neue Version, eine verkürzte Bearbeitung, eine neue Stimme) erstellt einen neuen Projektordner mit scripts/new_project.py DEST --from OLD. Frühere Schnitte bleiben abspielbar und unverändert; synthetisierte Sätze werden inhaltsbasiert außerhalb des Projekts zwischengespeichert, sodass ein Schnitt nur für geänderte Sätze kostenpflichtig ist.
Der Schlüssel stammt aus der Umgebungsvariable ELEVENLABS_API_KEY. Führe Sprachbefehle über den vom Benutzer verwendeten Geheimnisverwalter aus (op run --, av inject +ELEVENLABS_API_KEY --, ein einfaches export); gib den Schlüssel niemals aus, protokolliere ihn nicht und schreibe ihn nicht.
Schritte
1. Faktenblatt
Sammle, was das Video möglicherweise behauptet – aus der Aufgabenstellung des Benutzers, seinen Repos und Konfigurationen sowie Rückfragen an ihn. Schreibe jede Behauptung als verifiziert (in Konfiguration, einem Screenshot oder den Worten des Benutzers gesehen) oder illustrativ (Platzhalter, Beispiel, konzeptionelles Layout). Lege die Zielgruppe, die angestrebte Länge und fest, was weggelassen werden muss.
Abgeschlossen, wenn jede geplante Bild- oder Sprachaussage auf eine verifizierte Zeile zurückgeführt werden kann und die illustrativen Aussagen für die Ergebnisnotizen aufgeführt sind. Lies references/script.md für die Behauptungen, die am häufigsten falsch sind.
2. Projekt
python3 <skill>/scripts/new_project.py DEST für ein neues Video oder --from OLD für einen neuen Schnitt. Installiere template/requirements.txt in einer venv (Manim benötigt Cairo, Pango und ffmpeg auf dem System). Setze name, title und voice in video.json.
Abgeschlossen, wenn python -m kit draft && python -m kit build --low das gebündelte Beispiel (oder den kopierten Schnitt) in out/ erstellt.
3. Skript
Schreibe narration.py: Szenen in Wiedergabereihenfolge, jede eine Liste von (id, caption, spoken)-Segmenten, ein bis drei Sätze lang. Kalkuliere etwa 150 gesprochene Wörter pro Minute Video; lass die echte Audiolänge die endgültige Länge bestimmen, anstatt die Stimme zu beschleunigen. Füge Aussprachen von Namen in pronunciations.json ein.
Zeige dem Benutzer das Skript als Tabelle (Szene, Erzählung, was auf dem Bildschirm zu sehen ist) und stelle die Fragen, die nur er beantworten kann. Abgeschlossen, wenn der Benutzer die Formulierung genehmigt hat: Synthese kostet Credits, Skriptbearbeitungen davor sind kostenlos.
4. Mit Entwurfsaudio animieren
python -m kit draft erstellt eine kostenlose Platzhalter-Erzählung mit gleichmäßigen Zeichen-zeitstempeln, sodass du Szenen anordnen kannst, bevor du für die Stimme bezahlst. Schreibe eine Narrated-Klasse (Diagramme) oder ScreenScene-Klasse (Screenshots) pro Szene in scenes.py und steuere jede Änderung mit say / until / done. Iteriere mit python -m kit build --low und betrachte die Einzelbilder.
Abgeschlossen, wenn jedes Segment ein Bild hat, das sich mit seinen Worten ändert, python -m kit timing keine stummen Lücken meldet und kein Einzelbild in der Low-Ansicht überlappenden Text oder eine leere Bühne aufweist. Lies references/animation.md bevor du Szenen schreibst; lies references/screens.md bevor du eine Live-App aufnimmst.
5. Stimme
Wenn keine Stimme ausgewählt ist, führe ein Vorsprechen durch: python -m kit voices, dann python -m kit audition ID1 ID2 ID3 mit einem Satz, der die schwierigen Namen enthält, und lass den Benutzer nach Gehör wählen. Dann python -m kit narrate --dry-run um die Zeichenkosten zu sehen, und python -m kit narrate.
Abgeschlossen, wenn narrate 0 zu synthetisierende Segmente meldet. Lies references/narration.md für Stimm-Einstellungen, geklonte Stimmen, Credits und Schlüsselberechtigungen.
6. Bauen und verifizieren
python -m kit build (volle Auflösung), dann python -m kit verify --speech. Überprüfe das Kontaktblatt in out/ und Einzelbilder in voller Auflösung aus jeder Szene und behebe, was du findest. Eine neue Stimme ändert das Tempo, daher bedeutet ein Stimmentausch immer einen vollständigen Neurender, niemals einen Austausch der Tonspur.
Abgeschlossen, wenn jede Prüfung in references/verify.md bestanden wird oder ihre Ausnahme erklärt ist.
7. Ausliefern
Melde die absoluten Pfade der MP4, SRT, des Skripts und des Kontaktblatts; die Dauer; Stimme und Modell; die Verifikationszahlen; die illustrative oder nicht verifizierte Liste aus Schritt 1; und die Neubau-Befehle. Bezeichne Entwurfsaudio niemals als fertige Erzählung: assemble verweigert einen endgültigen Build, solange ein Segment noch ein Entwurf ist.