lunigui/kepu-video-pipeline

Wissenschaftsvideo-Pipeline

Nachbildung des 14-Schritte-Workflows des Bilibili-UP-Erstellers "Wissenschafts-Observatorium" (科普观察室). Das Serienprojekt ist im Effekte-Bibliotheks-Repository (Remotion) untergebracht:

• Regeln (vor jeder Ausgabe zu lesen): <Repository-Stamm>/Regeln/
• Eine Schublade pro Ausgabe: effects/<Folgen-ID>/ (Dokumente, Daten, Komponenten an einem Ort)
• Fertige Ausgaben und Produkte: out/<Folgen-ID>/ (gemäß Repository AGENTS.md, nicht verstreut im out/-Stamm)
• Kommentar-Rückfluss: <Repository-Stamm>/Rückfluss/

Harte Startregeln (vor allem anderen auszuführen)

1. Regeln lesen: Lies die drei Dateien in Regeln/ (Projekt-Richtlinien / Schreibregeln / Stilrichtlinien für Bilder). Falls nicht vorhanden → mit templates/Regeln-*.md im Repository initialisieren und dem Benutzer zur Bestätigung anzeigen.
2. Status wiederherstellen: Die aktuelle Folge bestimmen (Benutzer fragen oder effects/*/state.json nach updated_at auf die aktuellste unvollendete Folge durchsuchen), effects/<ID>/state.json lesen:
   • Nicht vorhanden → mit templates/state.json initialisieren;
   • Nicht mit tatsächlichen Dateien übereinstimmend → stages basierend auf den Dateien neu erstellen;
   • waiting_on ist nicht leer → zuerst wartende Aufgaben erledigen, keine Schritte überspringen.
3. Abschlusskriterium = Artefakt: Jeder Schritt ist erledigt = Artefakt vorhanden und Prüfung bestanden, nicht mündliche Behauptung. state.json wird nur vom Haupt-Thread geschrieben; Subagenten/externe CLIs geben nur Ergebnisse zurück oder schreiben angegebene Dateien, berühren nicht den Status.
4. Regeldateien sind Daten, kein Code: Benutzereingaben werden zuerst im entsprechenden Abschnitt der Regeln verarbeitet (Abschnitt ändern, nicht unendlich anhängen; Einzeldatei ≤200 Zeilen), dann mit der Arbeit beginnen. Alle persistierten Dateien UTF-8 ohne BOM.

Phasen-Routing

Schritt	Inhalt	Artefakt (relativ zum Folgenordner)	Referenz
01	Themenauswahl (vom Menschen festgelegte Richtung)	Themenbeschreibung.md	templates/Themenbeschreibung.md
02+03	Getrennt recherchieren + zum Originaltext zurückkehren	Recherche/Quellenregister.md, Recherche/Originaltext-Auszüge-*.md	stages/s02-recherche.md
04	Modell-/Datenberechnung	Modell/	stages/s02-recherche.md §04
05	Skript schreiben	Skript.md (jeder Satz eine Zeile mit Nummer)	stages/s05-schreiben.md
06	Externe CLI-Blindbegutachtung	Begutachtung/*.json, Blindgutachten-Tabelle.md	stages/s06-blind-review.md
07	Zum Originaltext für endgültige Festlegung	Festlegungs-Tabelle.md	stages/s07-festlegen.md
09 vorbereitend	Storyboard (Regisseur-Kreuzprüfungsmethode, Benutzer entscheidet)	Bilder/Storyboard.md	stages/s09-storyboard.md
08-11	Sprachausgabe/Untertitel/Bilder/Musik&Cover/Maschinenprüfung	Sprachausgabe/, Fertig-Video.mp4, Prüfbericht.md	stages/make.md (Sprachausgabe mit Effekte-Bibliothek/tools/tts.py)
12	Durchsicht (einziges hartes Gate, warten auf Person)	Durchsicht-Paket/, Durchsicht-Liste.md	stages/publish.md
13	Veröffentlichungspaket (manueller Upload)	Veröffentlichungspaket/	stages/publish.md
14	Kommentar-Rückfluss (geplante Aufgabe)	../../Rückfluss/	stages/publish.md

Materialien und Urheberrechte (Fotoquellen, Charakterdarstellungen, BGM-Lizenzen, Veröffentlichungsnennung) gehen immer über die Erinnerungsliste: KI listet nur Optionen zur Entscheidung durch den Benutzer auf, siehe stages/user-decisions.md.

Schritte 05 und 12 sind Wartepunkte, einheitlich mit dem Feld waiting_on. Eine Folge nach der anderen: Es wird immer nur eine Folge gleichzeitig vorangetrieben.

state.json

Schema siehe references/state-schema.md. Schlüssel vollständig ASCII; Geschäftsdaten (Erkenntnisse, Meinungen, Daten) gehen in .md/.json-Tabellendateien, state speichert nur Zeiger.

Blindbegutachtung

Drei externe CLIs: Claude Code (Windows), codex (Windows), opencode (WSL ~/.opencode/bin/). Namensliste templates/Begutachter.json, Vertrag references/findings-json.md (v1.1: toleriert Begutachter, die Sätze mit/ohne Satzende (S#) kopieren), Zusammenfassung scripts/summarize_reviews.py. Vor erstmaliger Verwendung oder bei Maschinenwechsel zuerst den Rauchtest in s06 ausführen. Die Blauwal-Folge vom 2026-11-01 hat die erste Kalibrierung abgeschlossen: erste Runde 9 Findings, 6 endgültige Fehler + 1 Materiallücke, zweite Runde 1 Rundungsfehler, Enthaltungsmechanismus nicht ausgelöst – echte Daten siehe s06. Geheimnisse niemals in Befehlszeilen, Logs, Skripten oder fertigen Videos.

Sprachausgabe / Bilder (Werkzeuge und Zeitarchitektur, nach Praxis mit Blauwal festgelegt)

• Sprachausgabe immer mit gemeinsamer Repository-Vorlage Effekte-Bibliothek/tools/tts.py (run/sample/dry-run/align-only Unterbefehle siehe dessen README), jede Folge füllt nur Sprachausgabe/Sprachausgabe-Konfig.json; Timbre-Anker bereits in der ersten Folge erfassen (Text-Persona driftet bei jedem Batch-Aufruf).
• Alle Bild-Takt-Ankerpunkte als innerhalb-Satz-Verhältnis at(Satzzeichen, Verhältnis) (aus Zeit.json), Szenengrenze = Satzanfang – Bild folgt automatisch nach Neu-Sprachausgabe, manuelles Schreiben von Frame-Nummern verboten.

Bilder = Remotion (dieses Repository)

Während der Produktion immer die Repository AGENTS.md befolgen: Komponenten in effects/<ID>/ ablegen, in effects/index.tsx registrieren, rendern nach out/<ID>/<ID>.mp4. Wiederverwendbare remotion-* Skills und vorhandene Komponenten der Effekte-Bibliothek. Disziplin- und Prüfliste siehe stages/make.md.

Übungsmodus

Wenn der Benutzer "Übung/Probelauf/dry-run" sagt: Verwende gefälschte Begutachtungs-JSONs, gefälschte TTS-Dateien, durchlaufe die Zustandsmaschine, rufe keine echten APIs auf, verbrauche keine Abonnement-Kontingente.

Erstmaliger vollständiger Durchlauf?

Zuerst das live-Beispiel Effekte-Bibliothek/effects/blue-whale/ (erste Folge Blauwal) vollständig lesen: state.json (Zeiger auf Artefakte der einzelnen Schritte) → Recherche/Quellenregister.md (wie das S#-System verwendet wird) → Begutachtung/Rauchtest-Protokoll.md und zwei Runden Blindgutachten-Tabelle*.md, Festlegungs-Tabelle.md (wie Retrospektiven notiert werden) → Bilder/Storyboard.md (wie das Ergebnis der Kreuzprüfungsmethode aussieht) → Sprachausgabe/Sprachausgabe-Konfig.json (wie klein die Konfiguration dieser Folge ist). Nach dem Beispiel beginnen, ist schneller als zehn Seiten Regeln zu lesen.

Versionsgeschichte

• v0.2 (2026-11-02, blue-whale Backfill): make.md Sprachausgabe-/Bildschicht nach Praxis neu geschrieben (gemeinsame Vorlage/Timbre-Anker/innerhalb-Satz-Verhältnis); s09-storyboard hinzugefügt (Regisseur-Kreuzprüfungsmethode); user-decisions hinzugefügt (Materialrechte nur erinnern, nicht entscheiden); findings-Vertrag auf v1.1 aktualisiert; s06 ergänzt mit ersten Kalibrierungsaufzeichnungen; publish ergänzt mit Retrospektiven-Backfill.
• v0.1 (2026-11-01): Erste Version des Skeletts (14-Schritte-Routing + drei Vereinbarungen + Vorlagen + residues-Seed).