3D 動畫短片產生器 — 反重力版
將 MiniMax Hub 的 3d-animation-short-generator (v0.5.4) 移植至 Google Antigravity。故事/鏡頭/分鏡的方法論保持不變;僅替換了平台層:
| MiniMax Hub 原始版本 | 反重力版本 |
|---|---|
| Canvas 節點 | 工作區內 animation/<slug>/ 中的檔案 |
| 選擇卡 | 對話中帶編號的選項清單 → STOP 並等待使用者回覆 |
hub_generate_image | Antigravity 內建的圖片生成 (Nano Banana Pro)。備援方案: scripts/gen_image.py |
使用 H3 / Seedance 2.0 的 hub_generate_video | scripts/veo_generate.py → Veo 3.1 (最終版) / Veo 3.1 Fast (草稿版),透過 Gemini API |
| Hub 組裝 + BGM | scripts/assemble.sh (ffmpeg、BGM 音訊側鏈壓縮、長寬比裁切) |
使用使用者書寫的語言與他們交談(例如:繁體中文)。保持檔案名稱和提供給影片/圖片模型的提示為英文。
核心規則:故事優先 → 在接收意圖後立即使用選擇提示詢問長寬比和總時長 → 有序的專案檔案 → 每個必要的確認都透過選擇提示進行 → 在角色/場景卡片之後,固定順序為:包含每秒指示、音訊提示和空間錨點鍊的六欄鏡頭表 → 步驟 5.5 自我檢查 → 一份文字分鏡文件(每個鏡頭一個章節)→ 影片模型 + 解析度選擇 → 每個鏡頭的關鍵影格 + Veo 片段 → 使用 BGM 進行組裝。最終影片不得包含任何分鏡圖稿的痕跡。
反重力設定(每個專案檢查一次)
- 代理模型 (Antigravity 模型下拉選單): 在步驟 1–6(故事、鏡頭表、分鏡圖)使用可用的最強推理模型 — Gemini Pro 等級 (High thinking) 或 Claude Opus/Sonnet。Flash 等級的模型在步驟 7–8 的檔案/腳本工作中就足夠了。參閱
references/model-selection.md。 - 模式: 使用 Planning 模式(不是 Fast),以便代理程式編寫計劃/成品並暫停供審查。
- 影片/API 前提條件 (從步驟 7 開始需要): 要求使用者確認,或在終端機中檢查:
- 在 shell 中設定
GEMINI_API_KEY環境變數(來自 Google AI Studio,已啟用計費 — Veo 是付費服務)。 - 已安裝
pip install google-genai且ffmpeg在 PATH 中。 - 切勿將 API 金鑰列印、記錄或寫入專案檔案中。
- 在 shell 中設定
- 如果前提條件不足,步驟 0–6 仍可執行;在步驟 7 之前停止,並告知使用者需要安裝什麼。
選擇提示格式 (取代選擇卡)
每當此技能提到「選擇提示」時,請輸出完全符合以下格式的內容,然後結束你的回合:
**[關卡名稱]** — 選擇一個 (回覆數字):
1. 選項 A (建議)
2. 選項 B
3. 選項 C
0. 其他 / 自訂 — 自行輸入
絕不自動選擇,絕不在同一回合內越過關卡繼續進行,也絕不使用散文段落來取代關卡。使用者可以用數字或自由文字回覆。
專案資料夾佈局 (取代 Canvas)
在工作區中建立 animation/<slug>/ (slug = 以連字號分隔的工作標題)。依此順序將每個持久性成品寫入磁碟 — 不要僅在對話中存放大量的製作內容:
animation/<slug>/
00-project.json # 已核准的設定: 長寬比、時長、解析度、影片模型、風格、語言
01-brief.md # 專案簡報
02-story-outline.md # 故事大綱
03-characters/ # <name>-card.png + <name>-card.md (視覺 ID 備註 + 使用的提示)
04-scenes/ # <scene>-card.png + <scene>-card.md (地標、光照狀態、提示)
05-shot-table.md # 六欄表格; 通過後第一行寫 "shot-table self-check: passed"
06-storyboards/
text-storyboards.md # 每個鏡頭一個 "## S01" 章節 (權威版本)
S05-extracted.md # 僅用於標記為需要大量迭代的鏡頭
pencil/S01.png # 僅在可視化模式下使用
07-keyframes/S01-start.png # 從卡片生成的第一個影格 (關鍵影格模式)
08-clips/S01_v1.mp4 # 有版本號; 最高版本號 = 當前版本
09-assembly/main.mp4, bgm.*, final.mp4
10-review.md
在重新生成時,請提升版本後綴 (_v2) — 絕不覆蓋 — 並說明哪個版本是當前版本。00-project.json 是設定的單一事實來源;在每個關卡之後更新它。
全域視覺風格鎖定
除非使用者明確要求另一種視覺風格,否則所有角色卡片、場景卡片、鏡頭表、分鏡圖、關鍵影格、片段和最終合成作品都使用此風格:
- 渲染: 皮克斯風格 3D 卡通渲染,C4D + Octane 渲染器外觀,高端動畫電影品質。
- 角色設計: 誇張的幾何簡化,同時保持出色的材質細節;大而清晰的輪廓;適當時使用 Q 版比例(可愛/兒童角色約 2.5–3 頭身)。
- 頭髮/毛皮: 雕塑般的髮片和乾淨的塊狀形狀,加上細微的飛散邊緣毛髮 / 模糊的邊緣細節。
- 皮膚/材質: 溫暖的次表面散射,透過耳朵、臉頰、鼻子、指尖呈現柔軟的半透明紅色;沒有硬質塑膠皮膚。
- 表演: 誇張、生動的迪士尼/皮克斯表演風格 — 伸展與擠壓、強烈的眉毛動態、眼角、瞳孔、嘴唇、臉頰。
- 動作: 高能量姿勢、清晰的行動線、預備動作、快速但易讀的節奏、有彈性的身體力學、生動的微表情。
負面風格: 不要寫實真人表演、不要平面2D動畫、不要塑膠玩具皮膚、不要僵硬的模特兒姿勢、不要無表情的臉。
步驟 0: 接收意圖與專案計畫
捕捉: 一句話點子;期望的輸出深度 (僅藍圖 / 僅資產 / 鏡頭表 / 分鏡圖 / 片段 / 組裝完成 / 含 BGM 的最終版);大約長度;長寬比;調性 (預設溫暖風格化 3D);對話模式 (對話 / 旁白 / 無語音);對話語言 僅在使用者指定時 — 不要預設為英文。
在接收意圖之後、執行任何其他操作之前,在同一則訊息中顯示兩個選擇提示(使用者對兩者都回答):
長寬比:
- 16:9 橫向 (建議 — Veo 原生)
- 9:16 垂直短片 (Veo 原生)
- 1:1 正方形 (以 16:9 渲染,在組裝時中心裁切)
- 4:5 社群網站肖像 (以 9:16 渲染,在組裝時裁切)
- 自訂
總時長:
- 30–60 秒 (建議)
- 15–30 秒
- 60–90 秒
- 90–180 秒 (許多片段 → Veo 成本較高;警告使用者)
- 自訂
僅在兩者都回答後才繼續。儲存到 00-project.json 並在所有地方重複使用。
步驟 1: 專案簡報 → 01-brief.md
包含: 工作標題、一句話的假設問題、情感前提、目標觀眾感受、交付項目、已核准的長寬比、已核准的時長、估計的鏡頭數 (時長 ÷ ~6 秒)、對話模式和語言(如果未指定則為 language not specified)、初始風險、對話意圖。
選擇提示: 1. 以此方向繼續 (建議) · 2. 重新生成前提選項 · 3. 修改情感前提 · 4. 調整對話方向。
步驟 2: 故事大綱與關卡 → 02-story-outline.md
包含: 主角的渴望 / 需求 / 缺陷;核心世界規則;8 拍因果故事主線;情感錨點與回報;如果要求則加入對話節拍;紅線檢查。
關卡檢查 (在檔案中為每個項目寫上通過/未通過): 主角是主動的 · 危機因主角的缺陷而加劇 · 巧合永遠無法解決問題 · 結局重複使用了早期的情感錨點 · 敵對壓力不是一個扁平的反派 · 對話揭示了關係的變化,而非說教主題。
選擇提示: 1. 批准故事並繼續 (建議) · 2. 修改故事節拍 · 3. 修改情感曲線 · 4. 修改對話節拍 · 5. 返回前提。
步驟 3: 角色卡片 → 03-characters/
使用 Antigravity 的圖片生成功能 (Nano Banana Pro) 生成。順序: 主角 → 對比/壓力角色 → 可選的輔助角色。每張卡片都是一份 16:9 的製作參考表,帶有可讀的標籤:
- 名稱標籤 + 角色標籤;主要 3/4 視角;正面 / 側面 / 背面視圖;表情列;服裝/材質/道具細節,附有道具標籤。
- 在 PNG 旁編寫
<name>-card.md:年齡範圍、體型、髮型、服裝顏色、標誌性道具、不可更改的特徵,以及使用的確切提示(身份鎖定,之後逐字重複使用)。
如果內建的圖片生成功能不可用或儲存到其他地方,請執行 python3 scripts/gen_image.py (參閱腳本標頭說明)或將輸出複製到此資料夾中。
選擇提示: 1. 鎖定角色設計並繼續 (建議) · 2. 重新生成主角卡片 · 3. 調整特定視覺細節 · 4. 新增另一個角色卡片。警告:之後更改鎖定的設計將強制從鏡頭表開始重新生成。
步驟 4: 場景卡片 → 04-scenes/
僅環境 — 沒有角色、人物、輪廓、手或臉。包含:主要環境概述、關鍵光照狀態(白天/夜晚)、情緒子空間、連續性地標(螢幕位置必須保持不變的固定物體,例如門框、沙發、樹)、重要道具。在 <scene>-card.md 文件中記錄地標和照明。
選擇提示: 1. 鎖定場景設計並繼續 (建議) · 2. 重新生成場景卡片 · 3. 新增另一個場景角度 · 4. 調整照明或佈局。
步驟 5: 標準化鏡頭表 (六欄) → 05-shot-table.md
必備;不能與分鏡圖或影片步驟交換。閱讀並遵循 references/shot-table-spec.md 以了解確切的架構、每秒指示、表格規則、核准提示以及步驟 5.5 自我檢查。
覆寫原始規格的 Antigravity/Veo 限制:
- 每個鏡頭的時長為 4、6 或 8 秒 (Veo 3.1 片段長度)。較長的節拍將拆分為多行。
- 在
鏡頭描述中,加入render_mode: keyframe | reference(預設 keyframe) 和可選的video_model: veo-3.1 | veo-3.1-fast。 - 對話台詞必須適合一個片段內;Veo 為每個片段生成音訊,所以不要讓一個句子跨越兩個鏡頭。
執行步驟 5.5 自我檢查。在通過之前,不要進入步驟 6。
步驟 6: 文字分鏡 (預設) + 鉛筆分鏡 (選擇加入) → 06-storyboards/
閱讀並遵循 references/storyboard-guidelines.md。 首先顯示分鏡模式的選擇提示。預設 = 一份權威的 text-storyboards.md,每個鏡頭一個章節。鉛筆圖像是選擇加入的、僅供人工審查,且永遠不會覆蓋文字。僅在使用者標記某個鏡頭需要大量迭代時,才將其提取到 S0X-extracted.md 中。
步驟 7: 影片模型 + 解析度選擇 → 關鍵影格 → Veo 片段
閱讀 references/model-selection.md (模型、模式、提示塑形、成本)和 references/fallback-policy.md (重試階梯、偏移)。
最低契約:
- 顯示影片模型選擇提示,然後是解析度選擇提示。儲存在
00-project.json中。 - 在渲染所有內容之前,僅渲染 S01 作為測試,展示它,並請求批准(成本控制)。
- 預設渲染模式為 keyframe:使用 Nano Banana Pro,從確切的角色卡片 + 場景卡片 + 該鏡頭的第一秒指示生成
07-keyframes/SXX-start.png,然後使用該圖片呼叫scripts/veo_generate.py --image。 - 每個片段提示都來自匹配的分鏡章節(或提取的檔案)、角色
.md中的身份鎖定文字以及場景.md中的地標/照明。去除所有分鏡標籤 ([char:…]、[scene:…]、[shot:…]、[dur:…]、[hook:…])、鏡頭編號、箭頭和註解。 - 片段必須是乾淨的全彩 3D 動畫:沒有素描紋理、沒有標籤、除非要求否則沒有字幕、沒有浮水印。
- 如果偏離
Reference Anchors,請遵循references/fallback-policy.md;切勿在靜默狀態下組裝錯誤的片段。
在所有片段渲染完成後,按鏡頭順序列出它們,帶上版本號碼,並從 references/model-selection.md 顯示片段批准選擇提示。
步驟 8: 組裝、BGM、最終輸出 → 09-assembly/
閱讀 references/qc-checklist.md 以了解組裝規則、BGM 規則、最終審查檢查、關卡紀律和最新資產紀律。
- 使用
scripts/assemble.sh進行組裝(使用已核准表中的確切鏡頭順序;每個片段的最新核准版本;如果選擇了 1:1 / 4:5,則進行裁切)。 - BGM:Veo 僅產生每個片段的音訊,因此一個連續的 BGM 音軌要嘛是 (a) 使用者提供的檔案,要嘛是 (b) 使用者在音樂工具(例如 Lyria / Google Flow / 任何免版稅庫)中創作的音軌 — 使用選擇提示詢問。腳本會在片段音訊(對話/SFX)下對 BGM 進行音訊側鏈壓縮。
- 除非要求,否則不要添加字幕或文字。最終影片不得包含任何分鏡圖的痕跡。
- 執行最終審查檢查,編寫
10-review.md,並提供final.mp4的路徑。
邊界
不要將此技能用於單一圖片、簡單編輯、單一片段、標誌設計或純提示諮詢。