Export (Finalprodukt)
Dies ist der letzte Abschnitt der Kette und die einzige Stelle im gesamten Produkt, an der tatsächlich Pixel gezeichnet werden.
Davor ist alles nur Annotation: Das Hauptbuch merkt sich, „welche Wörter abgespielt werden“, die Untertitel merken sich, „was auf dem Bildschirm steht“, die visuellen Ebenen merken sich, „welche Ebenen überlagert werden“, und die Vorschau setzt diese drei Dinge in Echtzeit für den Benutzer zusammen, ohne sie zu speichern. Der Export brennt sie in eine Datei.
Erforderlich: edit-list.json (zwingend), subtitles.json, visuals.json + modules/
Ausgabe: Finalvideo.mp4
Voraussetzung: Auf dem Rechner muss Google Chrome installiert sein (um Untertitel und Animationen als Bilder zu rendern). Die über eine Desktop-Installation bezogenen
FFmpeg / FFprobe sind mit der App in das verwaltete Produktverzeichnis gelangt; eine reine CLI-Installation erfordert weiterhin ffmpeg ≥ 6 im System. Fehlt Chrome, wird ein klarer Fehler ausgegeben; versuchen Sie nicht, dies zu umgehen – ohne Chrome gibt es keine Untertitel- und Animationsebene.
Lesen und befolgen Sie zuerst den Abschnitt „Schlussfolgerungsstufen“ im Phasenvertrag der Business-Skill. Der Export tritt nicht in die Bearbeitungszustandsmaschine ein: Er ändert keine Projektdateien, führt keine CAS-Schreibvorgänge durch, ändert keine Stage. Die Ausgabe ist eine neue Datei; ein erneuter Durchlauf überschreibt sie. Daher ist keine Bestätigungskarte erforderlich.
0. Bereitschaft
Führen Sie zuerst die Bereitschaftsprüfung durch – ob die Skills auf dem neuesten Stand sind und die Runtime kompatibel ist; das Plugin-Root-Verzeichnis wird dort ebenfalls ermittelt (alle <PluginRoot> in diesem Dokument beziehen sich auf diesen Pfad). Nur wenn „Bereit“ gemeldet wird, fahren Sie fort; bei „Neue Sitzung erforderlich“ oder „Anhalten“ handeln Sie gemäß dessen Anweisungen (einschließlich des Verbots „keine selbstgebauten Ersatzoberflächen“). Die Business-Skill enthält keine eigene Umgebungslogik.
Wenn das Bereitschaftsergebnis runtime.kind=desktop-managed ist, verwenden Sie direkt die bereits installierten stabilen CLI-Tools, Medienwerkzeuge und denselben launchd/windows-task-Dienst der Desktop-App. Analysieren Sie keine Electron-Pfade, installieren Sie kein zusätzliches FFmpeg/Bun und starten Sie keine zweite Runtime.
Befehle
node "<PluginRoot>/scripts/ensure-running.cjs" --json
node "<PluginRoot>/scripts/videocut-cli.cjs" export <projekt> --dry-run --json # Zuerst den Plan ansehen, keine Kodierung
node "<PluginRoot>/scripts/videocut-cli.cjs" export <projekt> --json # Finalvideo erstellen (Standard: 2x, Quell-Bildrate)
node "<PluginRoot>/scripts/videocut-cli.cjs" export <projekt> --out /pfad/Finalvideo.mp4 --json
node "<PluginRoot>/scripts/videocut-cli.cjs" export <projekt> --scale 1 --json # Nur Quellgröße verwenden
node "<PluginRoot>/scripts/videocut-cli.cjs" export <projekt> --keep-work --json # Zwischendateien und Einzelbild-PNGs für Fehlersuche behalten
Bei Nichtübereinstimmung der Identität, Portkonflikten oder fehlerhaftem Dienst von ensure-running sofort anhalten; es ist nicht erlaubt, temporär eine Vordergrundinstanz zu verwenden und dann mit dem Export fortzufahren.
Zwei Schritte, nicht nur den zweiten ausführen
① --dry-run zeigt zuerst den Plan an Dauer, Frames, Anzahl der Untertitelbildschirme, Anzahl der Bildebenen, Anzahl der Zoom-Abschnitte, Ausgabegröße
Dem Benutzer vorlesen. Wenn die Zahlen nicht stimmen, liegt der Fehler vorgelagert; zehn Minuten Kodierung werden ihn nicht beheben.
② Tatsächlicher Durchlauf assemble → overlay → compose → verify Vier-Schritt-Fortschritt
Die warnings im --dry-run müssen wörtlich wiedergegeben werden. Sie melden nur eine Sache: Einige Wörter in Untertitelbildschirmen oder Bildebenen wurden bereits abgeschnitten, daher erscheinen sie nicht im Finalvideo. Dies ist eine Entscheidung des vorgelagerten Prozesses, nicht etwas, das der Export verschweigen sollte.
Auflösung: Die Quelle ist die Obergrenze; zuerst die Quelle prüfen, dann über Vergrößerung nachdenken
Prüfen Sie vor dem Export die Quellauflösung (das source-Feld in --dry-run enthält sie bereits):
Quellbreite ≥2560 (Retina-natives Bildschirmvideo) → --scale 1, Ausgabe entspricht den nativen Pixeln. Dies ist der beste Fall.
Quellbreite <1920 (z. B. 960×720) → Zuerst anhalten: Den Benutzer fragen, ob es einen HD-Export derselben Aufzeichnung gibt.
Bildschirmaufnahmewerkzeuge können oft denselben Durchlauf in 3-facher Auflösung neu exportieren.
Der Austausch der Quelle ist effektiver als jede Nachbearbeitung (siehe nächster Abschnitt). Wenn wirklich nicht vorhanden → --scale 2
--scale 2 ist bei niedrigauflösenden Quellen nützlich, weil: Die Vergrößerung des Rohmaterials macht es nicht schärfer, aber Untertitel und Animationen werden in der Ausgabegröße neu gezeichnet – das ist es, was der Betrachter tatsächlich liest. Wenn die Plattform erneut komprimiert, erhalten größere Bilder zudem eine höhere Bitrate.
Passen Sie --fps nicht an, um „schärfer“ zu machen. Die Bildrate folgt der Quelle; eine Änderung führt dazu, dass die Abtastung der Animationen und des Bildschirmvideos nicht mehr synchron sind.
Quellenaustausch: Wenn der Benutzer eine HD-Version derselben Aufnahme bereitstellt
Dies ist kein Teil des Exportprozesses – der Export selbst ist immer schreibgeschützt. Der Austausch ist ein separater Materialvorgang, der nach ausdrücklicher Zustimmung des Benutzers durchgeführt wird. Danach kehren Sie zum normalen Export zurück.
Zuerst prüfen, ob es dieselbe Aufnahme ist (die ersten beiden Kriterien reichen aus):
ffprobe -v error -show_entries format=duration -of csv=p=0 <datei1> <datei2> # Dauer exakt in Millisekunden gleich
ffmpeg -v error -i <datei1> -map 0:a:0 -c copy -f md5 - # Audio-Stream bitweise identisch
# Dann 2–3 Frames zur visuellen Inhaltsvergleichung extrahieren, mit den Augen prüfen
Bitweise identischer Audio = identische Timeline: Das Wort-für-Wort-Transkript, Hauptbuch, Untertitel und Bildebenen sind alle an Wort-IDs gebunden – nichts muss geändert werden. Dies ist die Einlösung des Prinzips „Bindung an Wörter, nicht an Sekunden“ beim Quellenaustausch.
Vier Schritte zum Quellenaustausch (am 29. Juli 2026 tatsächlich einmal durchgeführt; Schritt ③ wurde damals vergessen, die Bearbeitungsvorschau meldete sofort „Generierung fehlgeschlagen“ – Fingerabdrücke sind nicht nur an einer Stelle gespeichert, mit grep alle alten Fingerabdrücke finden, bevor Sie handeln):
① Datei ersetzen input/source.mp4 und uploads/source.mp4 sind Hardlinks –
beide löschen, neue Datei nach input/ kopieren, dann Hardlink zurück zu uploads/ erstellen
(macOS: ln; Windows: New-Item -ItemType HardLink)
② Fingerabdruck aktualisieren source.sha256 in project.json auf den der neuen Datei setzen
③ Eine weitere Stelle prüfen workbench.json enthält ebenfalls sourceSha256 als Fingerabdruck der Quelle,
und die Bearbeitungsvorschau-Pipeline prüft genau dieses Feld – wenn es fehlt, verweigert die Vorschau die Generierung.
(Dies ist das korrekte Verhalten des Produkts: Bei Nichtübereinstimmung des Fingerabdrucks lieber fehlschlagen, als alte Vorschau als neu auszugeben.)
④ Neu exportieren --scale 1 – Der Austausch dient den nativen Pixeln, nicht der Vergrößerung.
Sicherheitsmaßnahme: Durchsuchen Sie mit Ihrem Suchwerkzeug alle *.json-Dateien im nach den ersten 8 Zeichen des alten Fingerabdrucks. Jede gefundene Stelle muss behandelt werden (Cache-Einträge wie preview-edited/current.json werden automatisch neu berechnet, manuelle Änderung nicht nötig).
Wenn der Audiostream unterschiedlich ist (neu aufgenommen, geschnitten, andere Dauer), handelt es sich nicht um einen Quellenaustausch, sondern um ein neues Projekt: Das Wort-für-Wort-Transkript muss neu transkribiert werden, alle Annotationen sind ungültig. Nicht erzwingen.
Abnahme: Drei Dinge, fehlt eines, gilt der Export nicht als abgeschlossen
① Befehl erfolgreich zurückgekehrt Das Produkt zählt selbst Abmessungen, Frames und Audiospuren des Finalvideos und vergleicht sie Punkt für Punkt mit dem Plan.
Bei Nichtübereinstimmung wird ein readback_mismatch-Fehler ausgegeben, die Datei bleibt als Beweis auf der Festplatte.
Der Export gilt nicht als abgeschlossen.
② Frames extrahieren und Pixel prüfen Aus dem Finalvideo Frames extrahieren und mit den Augen prüfen. Mindestens abdecken: einen Zoom-Abschnitt,
einen Vollbild-Animation-Abschnitt, einen Abschnitt nur mit Untertiteln, einen Abschnitt an einer Ebenengrenze.
③ Menschliches Gehör prüfen Niemand hat es jemals wirklich gehört; standardmäßig human listening UNVERIFIED notieren.
② Vorschaubilder nicht als Ersatz verwenden. Vorschau und Finalvideo sind zwei verschiedene Rendering-Pfade; die Abnahme soll prüfen, ob sie übereinstimmen – Vorschaubilder als Beweis für das Finalvideo zu verwenden, setzt das voraus, was überprüft werden soll.
Beurteilen Sie Zooms anhand von Unterscheidungsmerkmalen; der Gesamteindruck kann täuschen (am 29. Juli 2026 selbst erlebt): Nach einem 1,6-fachen Zoom sah der Bildschirm immer noch wie „eine ganze Seite“ aus, im Miniaturbild kaum vom Gesamtbild zu unterscheiden – ein korrekter Zoom-Frame wurde fälschlicherweise als „fehlender Zoom“ eingestuft, was zu 30 Minuten vergeblicher Nachverfolgung und zwei Neuexporten führte. Die richtige Methode ist, nach Beweisen zu suchen, die nur durch Beschneidung entstehen können: Halbe Elemente (eine Sprechblase, die in der Mitte abgeschnitten ist), verschwundene Randelemente (Seitenleiste, Titelzeile). Vergleichen Sie denselben Frame der Quelle – das klärt den Fall sofort.
Frames extrahieren mit ffmpeg:
ffmpeg -v error -ss 8.84 -i Finalvideo.mp4 -frames:v 1 -y frame.png
Wo nach Problemen suchen
--keep-work hinterlässt drei Dinge in .chengfeng-videocut/export/ des Projekts,
die direkt anzeigen, „welche Hälfte falsch ist“:
assembled.mkv Nur der Schnitt, ohne Überlagerungen. Fehler hier = Fehler im Hauptbuch oder im Schnitt.
overlay/*.png Nur die Überlagerungen, transparenter Hintergrund. Fehler hier = Fehler im Untertitelstil oder Modul.
spans/*.mp4 Zusammengesetzte Segmente. Fehler hier = Fehler im Zoom oder in der Ausrichtung.
Referenztabelle:
Keine Untertitel/Animation im Finalvideo Sind die overlay-PNGs vollständig transparent? Hat das Modul seek nicht akzeptiert?
Animation bleibt im ersten Frame stehen Das Modul hat seek nicht implementiert, oder die GSAP-Timeline war nicht paused.
Ganze Bildfläche weiß Dem Modul fehlt `:root { color-scheme: dark }`
Zoom-Rahmen schief Die viewBox des Moduls und der zoom der Ebene sind nicht dasselbe Zahlenpaar.
Finalvideo kürzer als geplant Einem span fehlen Frames; Fehlermeldung in der compose-Phase prüfen.
Ebenengrenze flackert kurzes Originalvideo overlay-Screenshots veraltet (Frame-Markierungsvalidierung fehlgeschlagen). Das Produkt belegt durch den Frame-Markierungsbalken am oberen Bildrand, zu welchem Frame jeder Screenshot gehört. Bei Wiederholung zuerst prüfen, ob die overlay-PNGs den Markierungsbalken oben haben und compose ihn durch crop entfernt hat.
Chrome nicht gefunden Google Chrome installieren, keinen anderen Rendering-Pfad verwenden.
Was nicht zu tun ist
- „Export erfolgreich“ nicht als „Abnahme bestanden“ bezeichnen – Die erfolgreiche Rückkehr des Befehls bedeutet nur, dass das Produkt selbst konsistent ist, nicht dass das Bild korrekt ist.
- Keine Vorschaubilder, DOM- oder Log-Auszüge als Ersatz für extrahierte Frames des Finalvideos verwenden.
- Kein human listening PASS melden, wenn niemand zugehört hat.
- Keine Projektdateien ändern, um den Export zum Laufen zu bringen (Untertitel bearbeiten, Ebenen löschen, Hauptbuch ändern). Der Export ist schreibgeschützt.
- Keine Arbeit des vorgelagerten Prozesses im Export nachholen: Fehlen Untertitel, schreiben Sie sie; fehlen visuelle Ebenen, erstellen Sie sie. Flicken Sie hier nichts provisorisch zusammen.