Communitygithub.com

film-crew

导演身边的剧组:拍片时用的四样工具——调模型、看进度、展示成片,一次安装全部就绪。

Qu'est-ce que film-crew ?

Film-crew est un ensemble de quatre outils complémentaires destinés aux workflows de génération vidéo et image avec des IA comme Wan 3.0, Seedance 2.5, MiniMax H3-Max ou OpenAI Images. Lorsqu'une scène ou un plan doit être généré à partir d'une fiche de travail (job sheet), film-crew gère l'envoi vers les API officielles (Alibaba Cloud Bailian, Volcano Ark, MiniMax, OpenAI), choisit le modèle en fonction de sa fiche de capacité (entrées, longueur, images de référence, prix, vitesse), affiche une page de progression en direct pendant la génération, puis produit une vitrine de visualisation avec chaque entrée et sortie, ainsi qu'un graphe de nœuds pouvant être exporté vers ComfyUI. Il permet aussi d'ouvrir chaque plan dans ComfyUI pour inspection manuelle sans regénération. Les formats d'échange (job sheet, manifeste des plans) sont normalisés et contrôlés par des scripts de validation. L'outil ne stocke jamais les clés API dans des fichiers, les lit uniquement depuis les variables d'environnement. Il fonctionne avec Python 3.10+ et n'utilise que la bibliothèque standard pour la plupart des tâches, sauf la vitrine (Pillow, ffmpeg). Chaque sous-composant possède sa propre documentation détaillée dans un fichier `overview.md`. Utilisez-le quand vous avez besoin de générer une vidéo ou une image à partir d'une fiche de travail, de visualiser la requête exacte avant envoi, de choisir un modèle selon ses capacités, de suivre la progression en direct, d'afficher ce qui a été envoyé et ce qui est sorti, ou d'exporter vers ComfyUI.

Compatible avec~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/memoryoffish/film-director-skill-plugin/tree/HEAD/plugins/film-crew

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait film-crew ?

En une phrase : la méthode de tournage gère le « comment filmer », ici ce sont les outils utilisés pendant le tournage — choisir le modèle, suivre la progression, montrer le résultat. Quatre blocs côte à côte, chacun avec son propre overview.md ; les chemins sont relatifs à ce répertoire.

Ce que gère chaque bloc

BlocGère quoiQuand l'utiliserÀ lire d'abord
backends/Fiche de travail en entrée, vidéo et image en sortiePour générer une vidéo ou un ensemble d'images ; pour voir d'abord ce qui sera envoyé ; pour choisir un modèlebackends/overview.md
viewer/Répertoire d'exécution → page web pour les humainsPendant le tournage, pour voir chaque génération (page de progression) ; après le tournage, pour voir ce qui a été donné à chaque plan et ce qui en est sorti (vitrine, graphe de nœuds)viewer/overview.md
comfyui/Chaque plan importé dans ComfyUIQuand un humain veut voir dans ComfyUI comment un plan a été réalisé, et récupérer les images clés et la vidéo pour les utiliser ensuitecomfyui/overview.md
formats/Format des deux fichiers d'échangePour écrire ou vérifier une fiche de travail ; pour transformer un répertoire d'exécution en manifeste des plansformats/overview.md

Les quatre blocs communiquent uniquement via deux fichiers : la fiche de travail (ce qui doit être généré en une fois) est envoyée au backend ; le manifeste des plans (ce que chaque plan d'un film a utilisé et produit) est donné aux deux visualiseurs.

Où ils interviennent pendant le tournage d'un film

  1. Début du tournage : la page de progression démarre dans tmux, puis chaque génération y est listée — python3 viewer/scripts/progress.py <répertoire de sortie> --jobs <projet>/clips --prices backends/cards/prices.json --every 60.
  2. Génération : chaque génération écrit une fiche de travail dans <projet>/jobs/ (vidéo) ou <projet>/jobs_img/ (image). D'abord python3 backends/scripts/filmgen.py request <fiche> pour voir ce qui sera envoyé, puis run. Le backend appelle les API officielles : 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). Le choix du modèle se fait via backends/cards/.
  3. Fin du tournage : dans le répertoire d'exécution, écrire un fichier de métadonnées meta.json (nom de chaque plan, temps de début et fin dans le montage final, quelle génération a été utilisée), puis lancer python3 formats/read_run.py <configuration> --out <répertoire du manifeste> pour générer le manifeste des plans, et python3 formats/check_manifest.py pour le valider.
  4. Montrer aux humains : la page web se lance avec python3 viewer/scripts/console.py <manifeste…> <répertoire de sortie> ; pour ouvrir dans ComfyUI, utiliser python3 comfyui/scripts/shots2comfy.py <manifeste…> --comfy <répertoire ComfyUI>. Le graphe de nœuds dans la page web reproduit le workflow ComfyUI ; pour l'obtenir, exécutez d'abord shots2comfy.py, puis ajoutez --workflows à console.py.

Prérequis : Python 3.10 ou supérieur. backends, formats, la page de progression et shots2comfy.py utilisent uniquement la bibliothèque standard (backends mesure la durée des vidéos avec ffprobe) ; la vitrine (console.py) nécessite en plus Pillow et ffmpeg ; send nécessite ssh et tmux sur la machine distante ; les nœuds ComfyUI s'exécutent dans leur propre environnement (avec Pillow, numpy fournis par ComfyUI).

Les paramètres de chaque étape et ce qu'il faut vérifier après exécution se trouvent dans le fichier overview.md de chaque bloc.

Règles

  • Les clés ne sont lues que depuis les variables d'environnement (DASHSCOPE_API_KEY, ARK_API_KEY, MINIMAX_API_KEY, OPENAI_API_KEY), jamais écrites dans un fichier, jamais affichées. Si une clé n'est pas définie, request fonctionne quand même.
  • Les visualiseurs sont en lecture seule : ils ne modifient pas le répertoire d'exécution, n'appellent pas les API de génération. Si un humain voit quelque chose à ajuster dans ComfyUI ou la page web, il le dit à l'agent, qui modifie et soumet à nouveau.
  • Voir avant d'envoyer : pour chaque fiche, faites d'abord request ; pour recommencer ou changer les paramètres, enregistrez-la sous un nouveau nom.
  • Les pages générées doivent être vérifiées par soi-même selon la façon dont l'humain les ouvre, avant de les transmettre.

Skills associés