Was macht film-crew?
Ein Satz: Während die Drehmethode festlegt, wie gedreht wird, stellt dieser Skill die Werkzeuge bereit, die während des Drehs zum Einsatz kommen – Modelle auswählen, Fortschritt verfolgen, Ergebnisse präsentieren. Vier Blöcke, jeder mit eigener overview.md; alle Pfade relativ zu diesem Verzeichnis.
Die vier Blöcke auf einen Blick
| Block | Aufgabe | Wann verwenden | Zuerst lesen |
|---|---|---|---|
backends/ | Job-Sheet rein, Video/Bild raus | Wenn ein Video oder eine Bildserie generiert werden soll; die genaue Anfrage vor dem Versand sehen; ein Modell auswählen | backends/overview.md |
viewer/ | Ausführungsverzeichnis → Webseite für Menschen | Während des Drehs jede Generierung live verfolgen (Progress-Seite); nach dem Dreh sehen, was jeder Shot bekommen und geliefert hat (Showcase-Seite und Node-Graph) | viewer/overview.md |
comfyui/ | Jeden Shot in ComfyUI anzeigen | Wenn jemand in ComfyUI sehen möchte, wie ein Shot zusammengesetzt wurde, um Schlüsselbilder und Clips weiterzuverwenden | comfyui/overview.md |
formats/ | Format der beiden Austauschdokumente | Beim Schreiben oder Prüfen eines Job-Sheets; beim Einlesen eines Ausführungsverzeichnisses in ein Shot-Manifest | formats/overview.md |
Die vier Blöcke tauschen Daten ausschließlich über zwei Dateien aus: Job-Sheet (was generiert werden soll) → an das Backend; Shot-Manifest (was jeder Shot verbraucht und produziert hat) → an die beiden Viewer.
Wo sie beim Dreh einer Produktion zum Einsatz kommen
- Drehbeginn: Die Progress-Seite startet in einem tmux-Session – danach wird jede Generierung dort aufgelistet:
python3 viewer/scripts/progress.py <Ausgabeverzeichnis> --jobs <Projekt>/clips --prices backends/cards/prices.json --every 60. - Generierung: Jede Generierung schreibt ein Job-Sheet nach
<Projekt>/jobs/(Video) bzw.<Projekt>/jobs_img/(Bild). Zuerstpython3 backends/scripts/filmgen.py request <Sheet>um die Anfrage zu prüfen, dannrun. Das Backend verwendet die offiziellen APIs der Hersteller: Alibaba Cloud Bailian (Wan 3.0, HappyHorse 1.1), Volcano Ark (Seedance 2.5 / 2.0), MiniMax (H3-Max), OpenAI Images (gpt-image 2.6). Die Modellauswahl erfolgt anhand der Karten in backends/cards/. - Nach dem Dreh: Im Ausführungsverzeichnis wird eine Shot-Tabelle
meta.jsonerstellt (Name jedes Shots, Start- und Endsekunde im fertigen Clip, verwendeter Generierungsdurchlauf), dannpython3 formats/read_run.py <Konfiguration> --out <Manifest-Verzeichnis>um daraus ein Shot-Manifest zu lesen, undpython3 formats/check_manifest.pyzur Prüfung. - Präsentation: Die Webseite wird erzeugt mit
python3 viewer/scripts/console.py <Manifest…> <Ausgabeverzeichnis>. Für ComfyUI:python3 comfyui/scripts/shots2comfy.py <Manifest…> --comfy <ComfyUI-Verzeichnis>. Der Node-Graph auf der Webseite zeichnet den ComfyUI-Workflow nach; dafür muss zuerstshots2comfy.pylaufen undconsole.pymit--workflowsaufgerufen werden.
Erforderlich: Python 3.10 oder höher. backends, formats, die Progress-Seite und shots2comfy.py verwenden nur die Standardbibliothek (backends nutzt ffprobe zur Längenmessung der fertigen Clips); die Showcase-Seite (console.py) benötigt zusätzlich Pillow und ffmpeg; send erfordert ssh mit tmux auf dem Zielrechner; die ComfyUI-Node-Pakete laufen in der eigenen ComfyUI-Umgebung (mit deren Pillow, numpy).
Die genauen Parameter und Prüfschritte für jeden Schritt stehen in der overview.md des jeweiligen Blocks.
Regeln
- API-Keys nur aus Umgebungsvariablen (
DASHSCOPE_API_KEY,ARK_API_KEY,MINIMAX_API_KEY,OPENAI_API_KEY), nie in Dateien schreiben, nie ausgeben. Ohne gesetzten Key funktioniertrequestdennoch. - Viewer sind schreibgeschützt: Sie ändern weder das Ausgabeverzeichnis noch rufen sie Generierungsschnittstellen auf. Wenn jemand in ComfyUI oder auf der Webseite Anpassungen vornimmt, wird der Agent informiert, der die Änderungen vornimmt und den Auftrag erneut einreicht.
- Erst prüfen, dann senden: Jedes Job-Sheet zuerst mit
requestprüfen. Bei Wiederholung oder Parameteränderung als neues Sheet mit neuem Namen speichern. - Die erzeugten Seiten vor der Übergabe an den Benutzer selbst ansehen.