Kurzvideo-Pipeline (themenneutral)
Eine Edit-Liste (<short>/edl.json) plus ein Voice-Over ergibt ein fertiges Video: bewegte Clips in einem thematischen Foto-"Fenster", Wort-
Untertitel, ein Haken-Plate, ein Heldenkreis, ein Cover, eine SFX-Cue-Liste und schließlich eine Audiomischung bei -14 LUFS.
Alles, was kanalspezifisch ist (Thema, Sprachen, Zielgruppe, Inhaltsregeln, Look, Stimme, Credits, Veröffentlichungsplan), befindet sich in der
CHANNEL.md des Projekts. Lesen Sie sie zuerst und befolgen Sie sie vor den unten stehenden Standardwerten. Wenn sie fehlt oder leere Abschnitte enthält, fragen Sie den Besitzer (oder kopieren Sie engine/templates/CHANNEL.md und füllen Sie sie gemeinsam aus), bevor Sie etwas produzieren.
Verwandte Fähigkeiten: shorts-script-voice (Thema, Skript, Stimme) und shorts-packaging (fertige Dateien, Upload-Texte).
Vor allem anderen
- Kit-Skripte (
setup.sh,shorts-init.sh,doctor.sh,install-codex.sh) befinden sich imscripts/-Ordner des Kits: dem Plugin-Ordner oder$SHORTS_HOME/kit/scripts/(setup.shundinstall-codex.shbehalten dort eine Kopie). - Arbeiten Sie in einem Projektordner, der
_pipeline/,_tools/,_fonts/,CHANNEL.mdenthält (erstellen Sie einen mitscripts/shorts-init.sh <verz>). Jeder folgende Befehl wird vom Stammverzeichnis dieses Ordners aus ausgeführt. - Führen Sie
scripts/doctor.sh <projekt-verz>einmal pro Maschine aus. Es überprüft alle Abhängigkeiten (Systemprogramme, Python-Pakete, Modelle, freien Speicherplatz) und muss mit "Alles in Ordnung." enden. Wenn nicht:scripts/install-system-deps.shfür ffmpeg/Python/curl,scripts/setup.shfür den Rest. Die vollständige Liste finden Sie inDEPENDENCIES.mddes Kits. SHORTS_HOME(Standard~/.shorts-studio) enthält die Python-Venv und die Sprachmodelle. Exportieren Sie es, wenn Sie es woanders ablegen.- Lesen Sie
_pipeline/README.md(Engine-Referenz) undreferences/edl-notes.md, bevor Sie eine Edit-Liste schreiben.
Der Workflow (jeder Schritt hat seine eigene Überprüfung)
| # | Schritt | Befehl / Ausgabe | Überprüfung |
|---|---|---|---|
| 1 | Thema + Skript | Fähigkeit shorts-script-voice | Eine Behauptung, Quellen angegeben, Besitzer einverstanden, wenn das Profil dies verlangt |
| 2 | Stimme | $SHORTS_HOME/venv/bin/python _tools/build_vo.py <short>/vo/beats.json, dann _tools/words.py <short>/vo | Lesen Sie vo/words.json: jedes Wort richtig |
| 3 | Filmmaterial | _tools/grab.py <thema> '<url>' <start> <ende> --tag NAME (protokolliert _footage/SOURCES.md), oder Ihre eigenen Aufnahmen | Kontaktbogen jedes Clips; Richtlinie aus CHANNEL.md |
| 4 | Edit-Liste | Kopieren Sie references/edl-template.json, ändern Sie den Inhalt | build.py <edl> --words zeigt Untertitel-Tokens |
| 5 | Rendern | python3 _pipeline/build.py <short>/edl.json --theme <theme> (3-10 Min; 4K60 ist langsam) | Kein Fehler; die Datei ist neuer als die edl |
| 6 | Cover | ... build.py <edl> --cover | "Safe-Zone-Verstöße: keine", lesbar bei 180 px Breite |
| 7 | Überprüfen | python3 _pipeline/check.py <short>/<name>-<theme>-silent.mp4 <short>/edl.json | Gibt ALLE PRÜFUNGEN BESTANDEN aus; Sie haben jeden Kontaktbogen angesehen |
| 8 | Ton | $SHORTS_HOME/venv/bin/python _pipeline/sound/mix.py <short> --theme <theme> --music <name> --strict | -14,0 +/-0,5 LUFS, wahrer Spitzenwert <= -1,0 dBTP, Worterkennungsfehler nahe 0 |
| 9 | Verpacken | Fähigkeit shorts-packaging | Datei + Cover + Upload-Block in ready/ |
Kontaktbogen eines Quellclips: ffmpeg -ss <t> -i <datei> -t <d> -vf "fps=2,scale=320:-1,tile=7x4" -frames:v 1 out.png
(PNG schreiben: JPEG-Ausgabe einiger Quellen schlägt fehl mit "non full-range YUV"). Schnittgrenzen:
ffmpeg -i <datei> -vf "scale=320:180,select='gt(scene,0.25)',showinfo" -an -f null - 2>&1 | grep -o "pts_time:[0-9.]*".
Themen: case-file (Aktenpapier), panel-heist (Comicseite), vice-dusk (Neon-Dämmerung), classic; das Profil wählt eines aus.
Wie ein gutes Kurzvideo aussieht (Standardeinstellungen; das Profil überschreibt sie)
- 18-45 s, ein Argument vom Haken bis zum Höhepunkt, ein Schnitt alle 1,5-3 s, jede Einstellung bewegt sich, der Haken-Plate ist ab Frame 0 sichtbar
(
hook.y1170 hält es frei von der Ausstellungsbeschriftung), ein Heldenmoment mit einem roten Kreis auf etwas, das der Rahmen wirklich zeigt. - Das Bild folgt den Worten. Untertitel sind 2-3-Wort-Phrasen (
break_before); Namen bleiben in einer Gruppe. - Die letzte Einstellung schneidet zurück zum ersten Frame (das Video looped).
- Der gesamte lesbare Text bleibt in der Smartphone-Safe-Zone: y 300-1580, x 130-950 (x <= 860 für y 1000-1600). check.py setzt dies durch.
- Hohes Fenster für Fotos
"aspect": "3:4"(900x1200) bei Clips ab 1080p; 720p oder Letterbox-Quellen können es nicht füllen.
Hart erkämpfte Lektionen (Details in references/lessons.md)
- Die edl ist neuer als das Rendering? Das Rendering ist veraltet. Erstellen Sie es neu, bevor Sie check.py beurteilen.
- Eingefrorene Standbilder (aufeinanderfolgende Frames unterscheiden sich für > 0,3 s kaum) führen zu Fehlern in check.py. Statische Bildschirme, einfarbige Flächen und unbewegte Motive
benötigen eine gleichmäßige Bewegung:
"move_ease": "linear", einen Zoom-Bereich von 0,15-0,4 und einen Schwenk von 150+ Quell-Pixeln.floatallein reicht nicht (der Sinus verlangsamt sich an seinen Wendepunkten auf Null). - Zoom-Grenzen: 4K-Quellen <= 1,00, 1080p <= 1,25, 720p <= 1,0 (check.py gibt den Grenzwert pro Clip aus).
- Creator-Overlays (Wasserzeichen, Facecam, unteres Drittel, Untertitel, stilisierte Banner) dürfen nie das Bild erreichen: Beschneiden Sie mit dem
top-level
sources-Bild-Override, verschieben Sie den Beschnitt oder wählen Sie andere Frames. Betrachten Sie jeden Schnitt-Frame. - Ehrlichkeit: Beschriftungen, Kreise und Untertitel sagen nur, was der Frame zeigt; schreiben Sie Fakten ihrer Quelle in der Stimme zu.
- Cover: Ein randloser Beschnitt eines Quell-Frames; der Plate sitzt bei
tab_y(330) und verdeckt den oberen Teil des Bildes. Bei einem Motiv nahe der Oberseite setzen Sietab_yauf etwa 1090 undstamp_yauf etwa 410. - Ein Rendering nach dem anderen (ein 4K60-Rendering verwendet alle Kerne); starten Sie nie ein zweites Rendering desselben Ordners.
Delegieren einer Bearbeitung an einen Sub-Agenten
Geben Sie dem Agenten BRIEF.md (erstellt von shorts-init aus references/editor-brief.md) plus das Skript, die Sprachdateien und die
Clips-Liste. Die Hauptsitzung schreibt das Skript und die Stimme, überprüft jeden Frame selbst und macht den Ton-Mix: Ein Agentenbericht ist eine Behauptung, kein Beweis. Überprüfen Sie Dateizeiten (stilles mp4 neuer als edl, Prüfprotokoll neuer als das mp4), bevor Sie akzeptieren.