Communitygithub.com

film-crew

导演身边的剧组:拍片时用的四样工具——调模型、看进度、拍完展示。装一次全有,后端用官方接口出片出图,查看器把运行目录做成网页。

film-crew란 무엇인가요?

film-crew 是一个专为 AI 视频与图像生成场景设计的工具集,围绕「一次拍片运行」提供完整的辅助工具链。它包含四个并排模块:backends 负责将任务单(描述一次生成要什么的JSON)通过环境变量中的 API Key 发送到阿里云百炼、火山方舟、MiniMax 和 OpenAI Images 等官方接口,每个模型配有独立的能力卡供选择;viewer 将运行目录转换为三个网页视图——实时进度页(每次生成的花费与时间)、展示台(每镜的输入图、首尾帧、参考图、prompt、参数与成片对照)和节点图(每镜的输入输出关系,可导出 ComfyUI 工作流);comfyui 模块将每镜放入 ComfyUI 供人查看和接续,只回放不生成;formats 模块提供任务单和镜头清单的格式与校验脚本。该工具适用于需要从任务单生成视频/图像、在发送前预览请求内容、根据能力卡选模型、实时观察生成进度、展示每次生成的输入输出、生成节点图、将镜头导入 ComfyUI 工作流、或将运行目录转为镜头清单的场景。所有模块仅通过两份文件(任务单和镜头清单)通信,保持轻量和模块化。

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

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

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;要重来或换参数,存成一张新名字的单子。
  • 做出来的页面照人的开法自己看一遍,再交给人。

관련 스킬