film-crew は何をしますか?
一句話:拍片的方法管「怎麼拍」,這裡是拍的時候用的工具——調模型、看進度、拍完給人看。四塊並排,各有自己的 overview.md;路徑都相對本目錄。
四塊各管什麼
| 塊 | 管什麼 | 什麼時候用 | 先讀 |
|---|---|---|---|
backends/ | 任務單進,片子和圖出 | 要生成一段影片或一組圖;想先看會發什麼請求;要選模型 | backends/overview.md |
viewer/ | 執行目錄 → 給人看的網頁 | 拍片進行中看每一次生成(進度頁);拍完看每一鏡餵了什麼、出了什麼(展示台、節點圖) | viewer/overview.md |
comfyui/ | 每一鏡放進 ComfyUI | 人想在 ComfyUI 裡看一鏡是怎麼做出來的,把關鍵幀和片拿去接著用 | comfyui/overview.md |
formats/ | 兩份交接文件的格式 | 寫或查任務單;把執行目錄讀成鏡頭清單 | formats/overview.md |
四塊之間只靠兩份文件來往:任務單(一次生成要什麼)交給後端;鏡頭清單(一部片每一鏡用了什麼、出了什麼)交給兩個檢視器。
拍一部片時它們在哪出場
- 開拍:進度頁起在 tmux 裡,之後每一次生成出來它都會列上——
python3 viewer/scripts/progress.py <輸出目錄> --jobs <專案>/clips --prices backends/cards/prices.json --every 60。 - 生成:每一次生成寫一張任務單放進
<專案>/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/。 - 拍完:在執行目錄裡寫一份鏡頭表
meta.json(每一鏡叫什麼、在成片裡從第幾秒到第幾秒、用的哪條生成),再python3 formats/read_run.py <配置> --out <清單目錄>讀成鏡頭清單,python3 formats/check_manifest.py查一遍。 - 給人看:網頁是
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;要重來或換參數,存成一張新名字的單子。 - 做出來的頁面照人的開法自己看一遍,再交給人。