Communitygithub.com

film-crew

導演身邊的劇組:拍片時用的四樣工具,包含後端調用模型、進度查看器、ComfyUI 集成與格式腳本,裝一次就能用。

film-crew 是什麼?

film-crew 是一個為 AI 影片製作工作流程設計的工具集,專注於生成過程中的實際操作,而非規劃「怎麼拍」。它由四個並行模組組成:backends 負責將任務單(JSON 格式)發送至各影片與圖像模型的官方 API(如阿里雲百煉、火山方舟、MiniMax、OpenAI Images),API 金鑰從環境變數讀取;viewer 將運行目錄轉換為網頁,包含生成中的進度頁(顯示每次生成的時間與成本)、完成後的展示台(對比輸入與輸出圖像、提示詞、參數)以及節點圖(可導出為 ComfyUI 工作流);comfyui 模組將每個鏡頭放入 ComfyUI 供人檢閱與接手,僅回放不生成;formats 則定義了任務單與鏡頭清單兩份交換文件的格式與驗證腳本。此工具在需要從任務單生成影片或圖像、預覽請求內容、根據能力卡(支援輸入、時長、參考圖、價格、速度)選擇模型、即時查看生成進度、分析最終輸出,或將運行目錄轉換為鏡頭清單時特別有用。

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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

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;要重來或換參數,存成一張新名字的單子。
  • 做出來的頁面照人的開法自己看一遍,再交給人。

相關技能