drama-forge

/drama-forge – Kurzserien-Video-Pipeline (One-Click)

Du bist ein Betreiber der Kurzserien-Produktionspipeline. Der Benutzer gibt den Seriennamen vor, und du führst den Orchestrator aus, der folgende Schritte automatisiert:

Skript → Video → Sprachausgabe → Zusammenschnitt → Qualitätsprüfung → Statusaktualisierung

Das Ergebnis ist ein veröffentlichungsfähiges vertikales Kurzvideo. Die Pipeline setzt automatisch die nächste Episode fort (Charakterkonsistenz und Handlungskontinuität werden durch die Zustandsdatei sichergestellt).

Auslöser

Der Benutzer ruft /drama-forge auf oder erwähnt es natürlichsprachlich:

/drama-forge Erstelle nächste Episode von "Su Wans Wiedergeburt"
/drama-forge Wiederhole Episoden 1-2 (letztes Mal waren Bilder doppelt)
/drama-forge Batch-Generierung von 3 Episoden, antike Wiedergeburt, Wohlfühl-Geschichte
/drama-forge Führe zuerst Selbsttest durch

Einzelner Befehl (immer zuerst ausprobieren)

cd <Skill-Verzeichnis>
python -X utf8 scripts/run_pipeline.py --series "Serienname" [Parameter]

Alle Schritte sind im Orchestrator-Code festgelegt; führe Skripte nicht manuell Schritt für Schritt aus.

Parameter	Zweck
--series NAME	Serienname (erforderlich)
--to-episode N	Erzeuge kontinuierlich bis Episode N
--force-episode N	Erzwinge Neuberechnung von Episode N (atomares Zurücksetzen + Bereinigung)
--with-bgm	Automatische KI-Hintergrundmusik (music-2.6)
--genre / --directive	Genre / zusätzliche Handlungsanweisungen
--dry-run	Nullkosten-Selbsttest, ruft keine kostenpflichtigen APIs auf
--workdir PATH	Arbeitsverzeichnis (wo sich series/ befindet)
--model ID	Überschreibt das LLM-Modell (Standard: abab6.5s-chat)

Unter Windows muss python mit -X utf8 ausgeführt werden, da die GBK-Konsole bei chinesischen Zeichen abstürzt.

Standard-Workflow

1. Selbsttest (nach Code-Änderungen, null Kosten): python -X utf8 scripts/run_pipeline.py --dry-run
2. Kontostand prüfen: --dry-run prüft den Kontostand nicht. Vor der Generierung eine minimale Chat-Anfrage senden (bei InsufficientBalanceError anhalten und Benutzer zum Aufladen auffordern – beachte: MiniMax-Video erkennt nur "Open-Platform-Guthaben", Token-Pakete können nicht für Videos verwendet werden).
3. Generieren: python -X utf8 scripts/run_pipeline.py --series X [--to-episode N] [--with-bgm]
4. Abnahme: Nach bestandener Qualitätsprüfung prüfe series/<Serienname>/episodes/epXXX.mp4 (Fertigungsvideo) + series/<Serienname>/.usage.json (Kostendetails).

Qualitätsprüfung (integriert, bricht bei Fehler ab)

Nach jeder Episode wird automatisch verify ausgeführt:

• Alle Segment-MD5-Hashes sind unterschiedlich (Schutz vor versehentlichen Duplikaten)
• Das fertige Video hat Video- und Audiospur, Dauer ≥ 10s
• Das Skript enthält einen Hook-Line (Text-Overlay im ersten Frame) + ungleichmäßige Szenenlängen (kein Metronom-Effekt)

Prüfung fehlgeschlagen = Status nicht aktualisieren, nächste Episode nicht starten, kein weiteres Geld ausgeben. Nach Fehlerbehebung mit --force-episode N neu ausführen.

Fortsetzungsmechanismus (Statusdateien nicht manuell ändern)

• Charaktere/Welt/Handlungsfäden/Zusammenfassung in series/<Serienname>/state.json
• Pro Episode: LLM liest Status → generiert Skript → schreibt nach Abschluss Status zurück (Zusammenfassung/Handlungsfäden hinzufügen/löschen/Charakterzustand aktualisieren)
• Erneutes Ausführen einer Episode nur mit --force-episode N erlaubt (automatisches Zurücksetzen + Bereinigung), keine manuellen Dateilöschungen
• Neue Charaktere: Lege ein Standbild (Front/Halbkörper/einfarbiger Hintergrund) in assets/characters/ ab und registriere es in state.json

Vollständige Details

• references/api-reference.md – alle getesteten API-Parameter (nicht "optimieren")
• references/pitfall-log.md – Vorfälle → Ursache → Abwehrmaßnahmen (vor jedem neuen Fehler zuerst hier nachschlagen)
• references/quality-gates.md – Erläuterung der Prüfpunkte für Qualitätssicherung und Selbsttest
• references/content-quality.md – 5-Akt-Dramaturgie/Hook-Syntax/Retentions-Prinzipien
• assets/state.schema.json – JSON-Schema für state.json
• assets/series-template.json – Initialisierungsvorlage für neue Serien