Blender 區塊模型 Pawns → AI 影片前期預覽
這個技能做兩件事:
- 在 Blender 中重現 Ido 的參考前期預覽外觀:純粹的 pawn 角色(一個方塊軀幹和一個球體頭部,沒有四肢、沒有臉、沒有其他裝飾)放在純色原始場景中。
- 將每個場景匯出為 AI 影片的參考套件:一個 MP4、第一幀和最後一幀、關鍵幀截圖以及 .blend 檔。
渲染使用 Workbench(視埠風格),因此速度足夠快,適合製作動態腳本。
設定(請根據您的機器調整路徑)
- Blender 5.2 位於
<BLENDER_EXE>。使用者環境變數BLENDER_PATH指向它。 - 工具包檔案位於
<BLOCKOUTS_DIR>\_kit\blockout_kit.py。它包含與下方 KIT 部分相同的程式碼。如果遺失或過時,請將 KIT 部分寫回該路徑。 - 輸出根目錄為
<BLOCKOUTS_DIR>\<SceneName>\。資料夾<BLOCKOUTS_DIR>必須連線到工作階段。如果尚未連線,請使用device_request_folder_access要求存取。 - 場景腳本放在
<BLOCKOUTS_DIR>\_scripts\<SceneName>.py。
執行模式 — 預設使用 A
A. 背景執行(已驗證可行;Blender 不需要開啟)
- 將場景腳本寫入容器。它應以以下內容開頭:
然後加入建構呼叫,接著是import math exec(open(r'<BLOCKOUTS_DIR>\_kit\blockout_kit.py', encoding='utf-8').read())r = export_for_ai()或render_still(),最後是print("RESULT", r)。 - 將腳本複製到
_scripts\<SceneName>.py。將其暫存到/mnt/user-data/outputs/,然後使用device_commit_files。 - 透過 PC 上的 Desktop Commander shell 執行它:
& '<BLENDER_EXE>' --background --factory-startup --python '<BLOCKOUTS_DIR>\_scripts\<SceneName>.py' 2>&1 | Select-String 'RESULT|Error|Traceback'使用約 300 秒的超時時間。一個 5 秒的 720p 鏡頭渲染時間遠低於一分鐘。 - 使用
device_stage_files拉回preview.png或first.png/last.png,並使用Read查看它們。然後迭代。
Blender 連接器的 execute_blender_code_for_cli 會讀取 BLENDER_PATH。它只有在 Claude 桌面應用程式在設定該變數後重新啟動才能運作。如果顯示找不到可執行檔,請使用上面的 shell 途徑。
B. 即時執行,在已開啟的 Blender 內部(連接器的 execute_blender_code,搭配 MCP 附加元件伺服器執行)。當 Ido 想要在視埠中觀看或調整時使用此模式。
- 在第一次呼叫中,執行
exec(open(r'<BLOCKOUTS_DIR>\_kit\blockout_kit.py', encoding='utf-8').read()),然後執行建構呼叫。 new_scene()總是建立一個新場景,因此 Ido 自己的場景永遠不會被觸及。- 如果後續呼叫引發
NameError,請再次執行exec行。
兩種外觀
look="previs"(預設) | look="toy" | |
|---|---|---|
| 感覺 | 柔和灰濛的粉彩色。每個物體都是不同的顏色 | 飽和的團隊色彩,像棋盤遊戲棋子 |
| 頭部 | 光滑的球體,浮在軀幹上方約 6 公分處 | 低多邊形球體(16×10),放在 / 略微沉入軀幹 |
| 顏色 | 頭部顏色與軀幹顏色不同 | 頭部和軀幹共用一種團隊顏色(白色/黑色/紅色/藍色/黃色/橙色/綠色) |
| 燈光 | 棚燈,無陰影,柔和的世界環境凹陷 | 棚燈加上柔和投影,無環境凹陷(環境凹陷會在低多邊形頭部畫出網格線) |
| 典型場景 | 房間,帶有深李子色天花板、床、書桌和門;底座上的模型 | 大廳、圓形毛氈桌、椅子、欄杆;按角色區分顏色的人群 |
| 曝光值 | +0.45 | +0.75 |
Pawn 身體為 0.48 寬 × 0.40 深 公尺,含頭部的標準高度為 1.86 公尺。小孩約 1.2 公尺,巨人約 3 公尺。seated=True 會給予較矮的軀幹並抬高到坐姿高度,以搭配 chair()。Ido 的規則:保持 pawn 純粹。 只能改變顏色、height= 和 seated=True。永遠不要添加鼻子、四肢、帽子或附加的道具。
當 Ido 沒有特別說明時,使用 previs。當他提到團隊、賭場、遊戲、人群或強烈顏色時,使用 toy。
建立一個鏡頭
- 呼叫
new_scene(name, look, aspect="16:9")。長寬比選項:16:9=1280×720,9:16=720×1280(Reels/TikTok),1:1,4:5,21:9。請與您正在製作的 AI 影片長寬比相符。 - 使用
room()建構場景,然後使用block()、bed()、table()、chair()和cylinder()放置家具。使用 10–40 個物體;這種外觀只需要很少的細節。使用open_walls=(1,)以便相機可以放置在房間內部。 - 使用
character()添加 pawns。使用move()讓它們動起來,這會讓它們滑行並在角落轉彎。規劃繞過道具的路徑,因為 pawns 會直接穿過家具。 - 使用
camera(loc, look_at, lens=20–28)在視線高度 1.5–1.7 公尺處添加相機,稍微偏離軸線,就像手持前期預覽相機一樣。另外兩種構圖:從高處 3/4 視角向下看模型,或在兩個 pawns 身後進行過肩鏡頭。對於相機移動,在起始和結束幀對cam.location和cam.rotation_euler設定關鍵幀。保持移動簡單(推近、平移、環繞),因為 AI 模型最能複製簡單的移動。 - 設定長度。一個鏡頭通常是 5–10 秒:
KIT["scene"].frame_end = 120(24 fps 下為 5 秒)。move()已經會為了涵蓋行走路徑而延長frame_end。 - 呼叫
render_still()並檢視結果。當構圖正確時,呼叫export_for_ai()。 - 回報場景名稱、輸出資料夾以及第一幀和最後一幀。
取自參考影片的構圖規則
- 牆壁、地板和天花板各有自己的顏色。在 previs 中,天花板是非常深的李子色(#3A3442),因此在畫面上方形成一條暗色帶。
- 相機通常放置在房間內部。使用
open_walls來移除相機後方的牆壁。 - 門是半開的薄板。
room()的door=參數會切出開口並添加門板。 - 雜物由扁平薄盒子構成,例如散落在桌上的紙張或牆上的便利貼(隨機粉彩色的 0.15 × 0.01 × 0.2 盒子)。
- 人群:將 pawns 圍繞桌子排成圓圈,在櫃檯後排成直線,或成對作為警衛。在 toy 外觀中,按角色分配顏色。
- 道具與 pawn 的比例一致,例如 pawn 的頭部大約與門的上三分之一處齊平。
AI 影片交接
export_for_ai(every=24) 將這些檔案寫入 Videos\Blockouts\<Scene>\:
<Scene>.mp4是動作和結構參考。它用於影片到影片、動作控制,或作為 Seedance 或 idoGen 中的「參考影片」輸入。first.png和last.png是構圖輸入。對於寫實作品,它們提供給建立真實起始/結束幀的影像模型(請參閱下方的覆寫規則);僅在草稿測試時直接使用它們。keys/key_####.png是每秒一張的靜態圖片。將它們用於全方位參考多圖(@Image1…)或分鏡腳本。<Scene>.blend是場景檔,保留以供後續編輯。
在編寫生成提示詞時,告訴模型保持參考中的佈局、區塊和相機移動。然後描述最終的外觀:取代 pawns 的真實人物,以及材質、燈光和服裝。將每個 pawn 顏色對應到一個角色,例如「粉紅色身體的人物 = 穿紅色裙子的女人」。對於多圖 Seedance 提示詞,請交接給 seedance-25 技能。
寫實 AI 影片交接:劇本覆寫規則(2026-10-06)
上述外觀適用於動態腳本。當片段是用於寫實 Seedance 2.5 / idoGen 的控制片段時,Ido 前期預覽劇本中的這些規則優先(完整細節:idogen-video-brain → references/previs-to-seedance-playbook.md;鏡頭選擇:cinematography → references/camera-directing-playbook.md):
- 中性灰色場景。 有顏色的牆壁/天花板的色調會滲入生成結果 [field]。僅在主要 pawns 和故事道具上保留純色。
- 每個替身可透過兩個線索識別(顏色 + 高度/形狀/位置);僅用顏色對應是不可靠的 [field]。如果 pawn 顏色可能滲入服裝,請將 pawn 塗成服裝顏色 [unverified]。
- 故事關鍵道具(瓶子、托盤、眼鏡)獲得自己的簡單基本幾何形狀。
- 真實比例,存在地板,不應該移動的東西不要移動,沒有疊加層(路徑、裝置、網格、幀計數器、文字)且沒有音軌。
- 每個鏡頭一個主相機移動,每個片段一個鏡頭。 僅烘焙慢速的肩部浮動;快速晃動請在文字中要求或在剪輯中添加。
- 鏡頭是電影攝影的決策,不是固定的 20–28 毫米預設值:它被烘焙到片段中。對於 9:16,將感測器設定為 36.7 毫米(旋轉的 ALEXA Mini LF 片門)以便 Blender 的毫米等於真實世界的毫米。
- 片段規格: 24 fps,輸出長寬比,整秒數,≥4 秒(Seedance 最低要求),片段長度 = 生成長度,並在可用部分之後保留真實動畫的尾巴。
first.png不是開始幀。 它是提供給影像模型的構圖輸入,影像模型會與視覺參考一起建立寫實的開始幀。僅在草稿測試時直接使用它。- 同時為每個相機方向匯出一張空場景靜態圖片,以及一張俯視圖(位置平面圖)。
KIT — blockout_kit.py 的內容
# ---- BLOCKOUT KIT (每個工作階段貼上一次,然後呼叫輔助函式) ----
import bpy, math, random, os, glob
from mathutils import Vector
OUT_ROOT = os.path.join(os.path.expanduser("~"), "Videos", "Blockouts")
ASPECTS = {"16:9": (1280, 720), "9:16": (720, 1280), "1:1": (1080, 1080), "4:5": (1080, 1350), "21:9": (1680, 720)}
PREVIS = ["#9C7393", "#8DB59A", "#88BDB0", "#C48DAA", "#ADB277", "#88A2B5",
"#8E78AA", "#BFAE94", "#7FA393", "#B28AA1", "#A2C0AA", "#D6A9B8",
"#B3A28A", "#7E5A70", "#9FA6C2"]
TOY = {"white": "#E8E8E2", "black": "#0B0C0E", "blue": "#1667A8", "yellow": "#C9A20E",
"red": "#B0122E", "orange": "#C27A12", "green": "#2E6B4A", "felt": "#2A6A48",
"cream": "#E6DDC4", "wood": "#5A3218", "brass": "#9C8240", "floor": "#E3D2B0",
"wall_teal": "#4E7468", "wall_wine": "#5C3740", "wall_taupe": "#6B5E4C"}
KIT = {"look": "previs", "rng": random.Random(7), "col": None}
def _rgba(h):
h = h.lstrip("#"); c = [int(h[i:i+2], 16) / 255 for i in (0, 2, 4)]
lin = [x / 12.92 if x <= 0.04045 else ((x + 0.055) / 1.055) ** 2.4 for x in c]
return (*lin, 1.0)
def _mat(hexcol, rough=0.85):
name = "BK_" + hexcol.lstrip("#")
m = bpy.data.materials.get(name)
if m: return m
m = bpy.data.materials.new(name); m.diffuse_color = _rgba(hexcol); m.roughness = rough
m.use_nodes = True
b = m.node_tree.nodes.get("Principled BSDF")
if b: b.inputs["Base Color"].default_value = _rgba(hexcol); b.inputs["Roughness"].default_value = rough
return m
def _pick(color):
if color is None:
return KIT["rng"].choice(PREVIS) if KIT["look"] == "previs" else TOY["cream"]
return TOY.get(color, color)
def _link(ob):
for c in ob.users_collection: c.objects.unlink(ob)
KIT["col"].objects.link(ob); return ob
def new_scene(name="Blockout", look="previs", seed=7, fps=24, aspect="16:9", res=None):
"""look: 'previs' (影片 1-2:Workbench,柔和隨機粉彩,無投影)
'toy' (影片 3:飽和團隊色彩,柔和陰影,低多邊形頭部)"""
KIT["look"] = look; KIT["rng"] = random.Random(seed)
sc = bpy.data.scenes.new(name); KIT["scene"] = sc
if bpy.context.window: bpy.context.window.scene = sc
col = bpy.data.collections.new(name + "_SET"); sc.collection.children.link(col); KIT["col"] = col
sc.render.fps = fps; sc.render.resolution_x, sc.render.resolution_y = res or ASPECTS[aspect]
sc.render.resolution_percentage = 100; sc.frame_start = 1; sc.frame_end = 1
sc.render.engine = "BLENDER_WORKBENCH"
sh = sc.display.shading
sh.light = "STUDIO"; sh.show_specular_highlight = False
if look == "previs":
sh.color_type = "MATERIAL" # 色盤已烘焙到材質中(跨渲染穩定)
sh.show_shadows = False; sh.show_cavity = True
sh.cavity_type = "WORLD"; sh.cavity_ridge_factor = 0.3; sh.cavity_valley_factor = 0.6
sh.show_object_outline = False
else:
sh.color_type = "MATERIAL"; sh.show_shadows = True; sh.shadow_intensity = 0.35
sc.display.shadow_focus = 0.6; sc.display.light_direction = (0.35, -0.45, 0.82)
sh.show_cavity = False # 環境凹陷會在分面頭部畫出網格線
sc.view_settings.view_transform = "Standard"
sc.view_settings.exposure = 0.45 if look == "previs" else 0.75 # 與參考幀亮度匹配
return sc
def block(name, size, loc, color=None, rot_z=0.0, bevel=0.0):
"""軸對齊盒子。size=(x,y,z) 單位為公尺,loc = BOTTOM 面的中心。"""
bpy.ops.mesh.primitive_cube_add(size=1, location=(loc[0], loc[1], loc[2] + size[2] / 2))
ob = bpy.context.active_object; ob.name = name; ob.scale = size; ob.rotation_euler.z = rot_z
bpy.ops.object.transform_apply(scale=True)
if bevel:
m = ob.modifiers.new("Bevel", "BEVEL"); m.width = bevel; m.segments = 3
bpy.ops.object.shade_auto_smooth(angle=math.radians(35))
ob.data.materials.append(_mat(_pick(color))); return _link(ob)
def cylinder(name, r, h, loc, color=None, verts=32):
bpy.ops.mesh.primitive_cylinder_add(radius=r, depth=h, vertices=verts, location=(loc[0], loc[1], loc[2] + h / 2))
ob = bpy.context.active_object; ob.name = name; ob.data.materials.append(_mat(_pick(color))); return _link(ob)
def room(name="Room", w=6, d=5, h=2.8, t=0.1, ceiling=True, door=None, floor_color=None, wall_colors=None, open_walls=()):
"""每面牆都是自己的物件,因此每面牆都有自己的顏色。
door=(牆面索引 0..3, 沿牆偏移量, 寬度, 高度) 會透過分割該牆面來切出開口。"""
fc = floor_color or ("#8EBFAE" if KIT["look"] == "previs" else TOY["floor"])
block(name + "_floor", (w, d, t), (0, 0, -t), fc)
if ceiling: block(name + "_ceiling", (w, d, t), (0, 0, h), "#3A3442" if KIT["look"] == "previs" else "#5A5650")
specs = [((w, t), (0, d / 2)), ((w, t), (0, -d / 2)), ((t, d), (w / 2, 0)), ((t, d), (-w / 2, 0))]
for i, ((sx, sy), (x, y)) in enumerate(specs):
if i in open_walls: continue # 0=+Y 後,1=-Y 前,2=+X 右,3=-X
…
[已截斷以利翻譯]