動畫分鏡 Forge 是做什麼的？

不是原稿頁面，而是以時間順序的鏡頭作為製作單位。不將漫畫的格子分割、翻頁與對話框挪用於影片的時間與演出。

作業步驟

確認使用者指定的劇本、片長、畫面比例、用途與素材。若未指定，暫時以 24fps、16:9、30 秒為假設，並明確記錄此假設後繼續進行。若已有現成樂曲或劇本的長度，則優先採用。不擅自帶入特定過去作品或角色。
讀取 references/format.md 與 assets/sample.storyboard.yaml，為每個作品建立 YAML 檔案。即使提供歌詞，若沒有實際音源，不視為已測量歌唱時機。
分配 duration_frames，使其總和等於 target_frames。鏡頭 ID 使用像 C001 這樣的穩定識別碼，重新排序時不重新命名。不手動輸入開始與結束時間，而交由腳本計算。
使用 python scripts/storyboard.py validate PROJECT.yaml 驗證資料。使用 build 產生暫定的分鏡表與各鏡頭圖片生成指示，確認結構與片長。
若需要圖片，使用可用的圖片生成工具或圖片生成技能。傳遞如 prompts/C001.txt 等指示與指定的角色、背景參考。一張圖片一個鏡頭，不將文字、台詞或表格框線嵌入圖片中。若需說明連續動作，在鏡頭內以文字描述關鍵姿勢，必要時分割成不同鏡頭。
實際打開生成的圖片，檢查取景、人物、動作、視線、畫面方向與連續性。使用實際工具輸出取得圖片，不以生成資料夾的「最新順序」推斷鏡頭。為每個鏡頭的 image 設定以 YAML 為基準的相對路徑或絕對路徑。若無法使用生成功能，仍完成分鏡表、指示與時間軸，並明確標示為未作畫。
執行 build --require-images，完成將圖片與演出/聲音指示分欄顯示的分鏡表。在瀏覽器等工具中確認顯示與列印分頁。必要時使用 animatic 建立 MP4，並透過 ffprobe 與播放確認片長與順序。
交付 YAML、HTML、CSV、timeline.json 與鏡頭圖片。依照使用者指定的儲存位置，在 Work 環境中遵循 Library 的儲存步驟。儲存必要檔案後回傳連結。簡潔報告總片長、未作畫鏡頭、未檢驗部分以及是否有真實聲音。

執行範例

腳本以技能根目錄為基準指定。需要 Python 3.10 以上與 PyYAML。若未安裝，使用 python -m pip install -r scripts/requirements.txt。日文顯示與 PDF 列印需要執行環境的日文字型。

python scripts/storyboard.py validate assets/sample.storyboard.yaml
python scripts/storyboard.py build assets/sample.storyboard.yaml --out /absolute/path/board-v1
python scripts/storyboard.py build PROJECT.yaml --out /absolute/path/board-v2 --require-images
python scripts/storyboard.py animatic PROJECT.yaml --out /absolute/path/animatic.mp4

build 在既有資料夾非空時會停止。修訂時輸出到不同資料夾。animatic 需要 ffmpeg，且所有鏡頭必須有真實圖片。若輸出 MP4 已存在則停止。不會自動傳送給外部 API 或 CLI。將提示與資料輸出的步驟與圖片生成工具作畫的步驟分開。

演出設計

每個鏡頭有一個主要目的。區分情境提示、動作、反應、賣點。
camera.framing 指定尺寸，angle 指定俯視/平視等，movement 指定 FIX、PAN、DOLLY 等。不混淆人物移動與攝影機移動。
台詞放入 dialogue，曲/音效放入 sound，畫面內文字放入 on_screen_text。靜音也明確記錄。
鏡頭內的演出時機以 cues 中的相對於開始與結束的幀區間 [start_frame, end_frame) 指定。由於圖片是靜止的，不將攝影機移動、舞蹈、嘴形同步視為已透過圖片驗證。
MV 需在 notes 與 cues 中保留段落、節拍與歌詞的對應。即使從 BPM 求得拍位置，音源的開頭與節奏變化仍需另行確認。
透過朗讀確認長台詞是否能在片長內完成，檢查想像線、視線、背景/服裝、小道具握持的連續性。
轉場目前版本僅支援硬切。淡出等效果以 notes 作為製作指示保留。動態分鏡僅為靜態圖片切換與無聲確認用，非完成影片。

部分修改

僅變更目標鏡頭的 YAML 與圖片，並重新建構到新的輸出資料夾。片長變更後需重新驗證整體總和。不一次性批次重新生成已確定鏡頭的圖片。

來源

從 sa-san10/rimochan-nyamuru-manga-forge 的「結構化設計→圖片生成→明確回收→檢驗」流程重新設計為影片用的衍生版本。參考來源 commit 為 e1f002cd1073ea01fe17965ea0a8b32f6b6e70e3。與漫畫用的 OMNY/OMAY 沒有直接相容性。程式碼與提示為影片用途全新實作。原始授權保留於 LICENSE 檔案中。範例使用獨創的人物與場景，不包含原始角色的圖片。

動畫分鏡 Forge