Communitygithub.com

film-crew

导演身边的剧组:四块工具——后端、查看器、ComfyUI、格式——一起搞定视频生成中的选模型、看进度、看结果和交接文件。

¿Qué es film-crew?

film-crew 是一个为 AI 视频和图像生成工作流设计的工具集,专供“拍片”场景使用。它包含四个并行的模块:`backends` 负责将任务单(JSON)发送到阿里云百炼、火山方舟、MiniMax 和 OpenAI Images 等官方 API,并通过环境变量管理密钥,每个模型配有独立的“能力卡”说明其支持的功能、价格和速度;`viewer` 将运行目录转化为可视化网页,包括实时进度页(显示每次生成的耗时和费用)、作品展示台(对比每镜的输入图、参考图、提示词、参数和成片)以及节点图(展示每镜的输入输出关系,可导出为 ComfyUI 工作流);`comfyui` 模块将每一镜的生成过程放入 ComfyUI 供用户查看和接手,但仅回放而不重新生成;`formats` 定义了两个交接文件(任务单和镜头清单)的格式、检查脚本以及将运行目录读成清单的脚本。该工具集适用于需要从任务单生成视频或图像、在发送前预览精确请求、根据能力卡选择模型、在生成过程中查看实时进度、生成后查看每镜的输入输出、在 ComfyUI 中打开工作流或把运行目录转换为镜头清单的场景,所有模块只需一次安装即可使用。

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace film-crew?

一句话:拍片的方法管「怎么拍」,这里是拍的时候用的工具——调模型、看进度、拍完给人看。四块并排,各有自己的 overview.md;路径都相对本目录。

四块各管什么

块管什么什么时候用先读
backends/任务单进,片子和图出要生成一段视频或一组图;想先看会发什么请求;要选模型backends/overview.md
viewer/运行目录 → 给人看的网页拍片进行中看每一次生成(进度页);拍完看每一镜喂了什么、出了什么(展示台、节点图)viewer/overview.md
comfyui/每一镜放进 ComfyUI人想在 ComfyUI 里看一镜是怎么做出来的,把关键帧和片拿去接着用comfyui/overview.md
formats/两份交接文件的格式写或查任务单;把运行目录读成镜头清单formats/overview.md

四块之间只靠两份文件来往:任务单(一次生成要什么)交给后端;镜头清单(一部片每一镜用了什么、出了什么)交给两个查看器。

拍一部片时它们在哪出场

  1. 开拍:进度页起在 tmux 里,之后每一次生成出来它都会列上——python3 viewer/scripts/progress.py <输出目录> --jobs <项目>/clips --prices backends/cards/prices.json --every 60。
  2. 生成:每一次生成写一张任务单放进 <项目>/jobs/(视频)、<项目>/jobs_img/(图)。先 python3 backends/scripts/filmgen.py request <单子> 看会发什么,再 run。后端调的是各家的官方接口:阿里云百炼(Wan 3.0、HappyHorse 1.1)、火山方舟(Seedance 2.5 / 2.0)、MiniMax(H3-Max)、OpenAI Images(gpt-image 2.6)。选哪个模型看 backends/cards/。
  3. 拍完:在运行目录里写一份镜头表 meta.json(每一镜叫什么、在成片里从第几秒到第几秒、用的哪条生成),再 python3 formats/read_run.py <配置> --out <清单目录> 读成镜头清单,python3 formats/check_manifest.py 查一遍。
  4. 给人看:网页是 python3 viewer/scripts/console.py <清单…> <输出目录>;要进 ComfyUI 是 python3 comfyui/scripts/shots2comfy.py <清单…> --comfy <ComfyUI 目录>。网页上的节点图照 ComfyUI 那份工作流画,要它就先跑 shots2comfy.py,再给 console.py 加 --workflows。

要装的:Python 3.10 以上。backends、formats、进度页和 shots2comfy.py 只用标准库(backends 量成片时长时用 ffprobe);展示台(console.py)另要 Pillow 和 ffmpeg;send 要 ssh,对面机器上要有 tmux;ComfyUI 节点包在 ComfyUI 自己的环境里跑(用它带的 Pillow、numpy)。

每一步的参数、做完查什么,在那一块的 overview.md 里。

规矩

  • key 只从环境变量读(DASHSCOPE_API_KEY、ARK_API_KEY、MINIMAX_API_KEY、OPENAI_API_KEY),不写进任何文件,不打印。没设 key 时 request 照样能用。
  • 查看器只读:不改运行目录,不调生成接口。人在 ComfyUI 或网页上看到要调整的,告诉 agent,agent 改完再交一次。
  • 先看再发:每张单子先 request;要重来或换参数,存成一张新名字的单子。
  • 做出来的页面照人的开法自己看一遍,再交给人。

Skills relacionados