docs(workflow): 关卡设计工作流与关卡执行案体系

- Agent 文档新增关卡执行案产出规范与白模搭建工作流
- 开发流水线补充关卡执行案产出节点与白模搭建子任务(6a)
- 新增关卡执行案模板、BSP资产参考卡、关卡设计工作流规范
- 新增原型阶段设计文档索引 README
- .gitignore 补充 __pycache__ 规则

.claude/refs/blockout-asset-reference.md

@@ -0,0 +1,404 @@
+# BlockingStarterPack 资产参考卡
+
+> 供策划产出关卡执行案时引用 BSP 资产。策划只需引用资产**类别名和近似尺寸**（如 `Wall_400x300`），不需要写文件路径。程序负责最终映射到引擎中的具体资产。
+>
+> 所有尺寸以厘米（cm）为单位。资产路径前缀：`Content/BlockingStarterPack/Meshes/`
+
+---
+
+## 一、建筑模块（Architecture）
+
+### 1.1 墙体（Walls）
+
+**命名规律**：`SM_Wall_<宽>x<高>` — 宽度/高度均为 cm 单位
+
+| 资产名 | 尺寸（宽cm × 高cm） | 用途 |
+|--------|-------------------|------|
+| Wall_100x100 | 100 × 100 | 短墙、装饰墙段 |
+| Wall_100x300 | 100 × 300 | 标准宽度墙面 |
+| Wall_100x400 | 100 × 400 | 标准宽度高墙 |
+| Wall_200x100 | 200 × 100 | 矮墙、半墙 |
+| Wall_200x300 | 200 × 300 | **常用** — 标准墙面 |
+| Wall_200x400 | 200 × 400 | 高墙面 |
+| Wall_400x100 | 400 × 100 | 矮长墙 |
+| Wall_400x300 | 400 × 300 | **常用** — 大片墙面 |
+| Wall_400x400 | 400 × 400 | 大片高墙 |
+
+**含门洞的墙**：`SM_WallDoor_<宽>x<高>`
+
+| 资产名 | 尺寸 | 说明 |
+|--------|------|------|
+| WallDoor_200x300 | 200 × 300 | 单门洞墙 |
+| WallDoor_200x400 | 200 × 400 | 单门洞高墙 |
+| WallDoor_400x300 | 400 × 300 | 宽墙含单门洞 |
+| WallDoor_400x400 | 400 × 400 | 宽墙含单门洞（高） |
+| WallDoorDouble_400x300 | 400 × 300 | 宽墙含双门洞 |
+| WallDoorDouble_400x400 | 400 × 400 | 宽墙含双门洞（高） |
+| WallDoorGarage_400x300 | 400 × 300 | 车库门墙 |
+| WallDoorGarage_400x400 | 400 × 400 | 车库门墙（高） |
+
+**含窗户的墙**：`SM_WallWindow_<宽>x<高>`
+
+| 资产名 | 尺寸 | 说明 |
+|--------|------|------|
+| WallWindow_200x300 | 200 × 300 | 单窗墙 |
+| WallWindow_200x400 | 200 × 400 | 单窗墙（高） |
+| WallWindow_400x300 | 400 × 300 | 宽窗墙 |
+| WallWindow_400x400 | 400 × 400 | 宽窗墙（高） |
+| WallWindowDouble_400x300 | 400 × 300 | 双窗墙 |
+| WallWindowDouble_400x400 | 400 × 400 | 双窗墙（高） |
+| WallWindowSmall_200x300 | 200 × 300 | 小窗墙 |
+| WallWindowSmall_200x400 | 200 × 400 | 小窗墙（高） |
+
+**圆角墙**：`SM_WallRoundedCorner_<宽>x<高>_<角度>d`（角度 45d 或 90d）
+
+### 1.2 地板（Floors）
+
+**命名规律**：`SM_Floor_<宽>x<深>`
+
+| 资产名 | 尺寸（cm） | 用途 |
+|--------|-----------|------|
+| Floor_100x100 | 100 × 100 | 小面积填充 |
+| Floor_100x200 | 100 × 200 | 窄条地面 |
+| Floor_100x300 | 100 × 300 | 走廊地面 |
+| Floor_100x400 | 100 × 400 | 长走廊 |
+| Floor_200x150 | 200 × 150 | 不规则填充 |
+| Floor_200x200 | 200 × 200 | 中等面积 |
+| Floor_200x300 | 200 × 300 | **常用** |
+| Floor_200x400 | 200 × 400 | **常用** |
+| Floor_300x300 | 300 × 300 | 大面积 |
+| Floor_300x400 | 300 × 400 | 大面积 |
+| Floor_400x400 | 400 × 400 | 大面积 |
+| Floor_1000x1000 | 1000 × 1000 | **超大地砖** — 快速铺设大范围地面 |
+
+另有：FloorCorner（转角）、FloorRounded（圆角）、FloorTriangle（三角）、Floor 含 Trap（带活门开口）
+
+### 1.3 门（Doors）
+
+| 资产名 | 说明 |
+|--------|------|
+| DoorFrame | 单门框 |
+| DoorFrameDouble | 双门框 |
+| DoorFrameGarage | 车库门框 |
+| RotativeDoor_01 / 02 / 03 | 旋转门（三种样式） |
+| LateralDoor | 推拉门 |
+| LateralDoorFrame_150 / 300 | 推拉门框（150cm/300cm 宽） |
+| FakeDoor / FakeDoorDouble | 假门（装饰，不可开） |
+| GarageDoor_01 / 02 | 车库门（关闭） |
+| GarageDoorOpen_01 / 02 | 车库门（打开） |
+
+### 1.4 窗户（Windows）
+
+| 资产名 | 说明 |
+|--------|------|
+| WindowsFrame / WindowsGlass | 单窗框/玻璃 |
+| WindowsFrameDouble / WindowsGlassDouble | 双窗 |
+| WindowsFrameUp / WindowsGlassUp | 上开窗 |
+| FakeWindowsFrame / FakeWindowsFrameDouble / FakeWindowsFrameUp | 假窗（装饰） |
+
+### 1.5 楼梯（Stairs）
+
+| 资产名 | 说明 |
+|--------|------|
+| Stair_100 / Stair_200 | 直梯（100cm/200cm 高） |
+| StairPlane_100 / StairPlane_200 | 楼梯面（无侧板） |
+| StairRounded_300_45d / 90d | 圆弧梯 |
+
+### 1.6 栏杆/围栏（Barriers）
+
+**命名规律**：`SM_Barrier<类型>_<长度>cm`
+
+- Barrier01/02/03 — 三种样式（直线段，50/100/200/500cm）
+- BarrierAngle — 角度栏杆
+- BarrierBeam — 横梁栏杆
+- BarrierRounded01/02_45/90 — 圆弧栏杆（200-800cm）
+- BarrierStair — 楼梯栏杆
+- BarrierWall_200/400/600 — 实墙式栏杆（**常用作围墙**）
+- BarrierWallRoundedCorner — 实墙式圆角
+
+**独立围栏**：
+- Fence_Normal_100/200/300/400 — 普通围栏
+- Fence_Small_100/200/300/400 — 矮围栏
+
+### 1.7 飘窗（BayWindows）
+
+`SM_BayWindow<类型>_<宽>x<高>` — 宽度 100/200/400，高度 300/400
+- BayWindow — 纯飘窗
+- BayWindowDoor — 带门的飘窗
+- BayWindowDoorDouble — 带双门的飘窗
+
+### 1.8 横梁（Beams）
+
+| 资产名 | 说明 |
+|--------|------|
+| Beam_300 / Beam_400 | 直梁（300/400cm） |
+| RoundedBeam_300 / RoundedBeam_400 | 圆弧梁 |
+| Beam_400_45d / RoundedBeam_400_45d | 45 度转角梁 |
+
+---
+
+## 二、建筑整体（Buildings）
+
+### 2.1 小型建筑（SmallBuildings）
+
+| 资产名 | 说明 | 建议用途 |
+|--------|------|---------|
+| House_01 | 小房屋 A | 家、小卖部等单层建筑 |
+| House_02 | 小房屋 B | 居民平房 |
+| House_03 | 小房屋 C | 仓库/杂物间 |
+| House_04 | 小房屋 D | 另一种风格平房 |
+
+### 2.2 大型建筑（BigBuildings）
+
+| 资产名 | 说明 | 建议用途 |
+|--------|------|---------|
+| Building_01 | 大楼 A | 老居民楼（5-6层） |
+| Building_02 | 大楼 B | 办公楼/商场 |
+| Building_03 | 大楼 C | 工业建筑 |
+| Building_04 | 大楼 D | 另一种风格大楼 |
+
+---
+
+## 三、家具（Furnitures）
+
+| 资产名 | 说明 | 尺寸参考 |
+|--------|------|---------|
+| SimpleTable_01 | 简易桌 | ~120×60cm |
+| SimpleTable_02 | 简易桌 B | ~100×60cm |
+| DinnerTable_01 / 02 / 03 | 餐桌（三种） | ~120-150cm |
+| DiningChair_01 | 餐椅 | ~45cm 座高 |
+| OfficeChair_01 | 办公椅 | 带轮 |
+| Armchair_01 | 扶手椅 | 休闲用 |
+| Laptop | 笔记本电脑 | 小型桌面物件 |
+| Monitor_01 | 显示器 | ~50cm 宽 |
+| Keyboard | 键盘 | 桌面物件 |
+| Broom | 扫帚 | 靠墙放 |
+| Cushion | 坐垫 | 小型 |
+
+---
+
+## 四、卧室（Bedroom）
+
+| 资产名 | 说明 |
+|--------|------|
+| BedSingle | 单人床（含被褥） |
+| BedSingle_Empty | 单人床（空床） |
+| BedDouble | 双人床（含被褥） |
+| BedDouble_Empty | 双人床（空床） |
+
+---
+
+## 五、卫浴（Bathroom）
+
+| 资产名 | 说明 |
+|--------|------|
+| Toilet_01 | 马桶 |
+| ToiletClosed_01 | 马桶（盖关） |
+| Urinal_01 | 小便池 |
+| ToiletPaper_01 / 02 | 卫生纸 |
+
+---
+
+## 六、装饰小物件（Decorations）
+
+| 资产名 | 说明 | 用途 |
+|--------|------|------|
+| Bottle_01 / 02 / 03 | 饮料瓶/酒瓶 | 小卖部、街头散落 |
+| Books_01 / BooksOpen_01 | 书本 | 书桌、书架 |
+| Can_01 | 易拉罐 | 散落物、垃圾桶内 |
+| Flask_01 | 烧瓶 | 实验室场景 |
+| GlassFlask_01-04 | 玻璃瓶（四种） | 装饰、收集 |
+| Mug_01 | 马克杯 | 桌面物件 |
+| Plate_01 | 盘子 | 餐桌 |
+| WaterGlass_01 | 水杯 | 桌面物件 |
+| Bucket_01 | 水桶 | 院子、巷子 |
+| Padlock_01 / Padlock_Open / Padlock_Break | 挂锁（三种状态） | 门、箱子 |
+| SimplePlug_01 | 插头 | 墙面细节 |
+| SimpleSwitch_01 | 开关 | 墙面细节 |
+| SpikedBall_01 / 02 | 铁蒺藜 | 路障 |
+
+---
+
+## 七、载具（Vehicles）
+
+| 资产名 | 说明 |
+|--------|------|
+| Car01 / Car02 | 轿车（两种） |
+| Truck01 / Truck02 | 卡车（两种） |
+| TruckWithoutTrailer | 卡车（无挂车） |
+| HoodTruckWithoutTrailer | 皮卡 |
+| Bus_Big | 大巴 |
+| Boat_01 / Boat_02 | 船（两种） |
+| Plane_01 | 飞机 |
+| Metro_01 | 地铁车厢 |
+| Trailer_01 / 02 / 03 | 挂车（三种） |
+| SimpleWheel / SimpleRims | 车轮/轮毂 |
+| TruckWheel / TruckRims | 卡车轮 |
+| SimpleTire | 轮胎 |
+| SmallLocomotive | 小型机车 |
+| SmallWagon_Normal / SmallWagon_Large | 小型车厢 |
+| SmallRail_200-1000 | 小型铁轨 |
+| SmallRailTurn_45d / 90d | 小型铁轨转辙 |
+
+---
+
+## 八、道路设施（Roads）
+
+| 资产名 | 说明 |
+|--------|------|
+| BarricadeBlocks_100 / 200 | 水马路障 |
+| Barricade_200 / 300 / 400 | 栏式路障 |
+| BarricadeWall_100 | 矮路障墙 |
+| RoadCone_Big / Normal / Small | 锥桶（三种大小） |
+| SpeedBump_100/200/400/600 | 减速带 |
+| SpeedBumpWithEnds_200/400/600 | 减速带（含端头） |
+| SpeedBumpEnd | 减速带端头 |
+| MetalPost_01 | 金属路桩 |
+| RoadLamp_01 | 路灯 |
+| RoadLight | 道路照明灯 |
+
+---
+
+## 九、工业物件（Industrials）
+
+| 资产名 | 说明 | 用途 |
+|--------|------|------|
+| Barrel | 铁桶 | 巷子、工地散落 |
+| ExplosiveBarrel | 爆炸桶（红色） | 游戏交互物 |
+| WoodenBox_Small / Normal / Large | 木箱（三种大小） | 杂物堆、仓库 |
+| WoodenCrate_01 | 木条箱 | 搬运箱 |
+| WoodenPallet_01 / 02 | 木托盘 | 地面垫板 |
+| Container_Normal / Large | 集装箱 | 工地 |
+| ContainerClosed_Normal / Large | 集装箱（关闭） | 工地 |
+| ContainerDoor_Left / Right | 集装箱门 | 工地 |
+| ContainerShip_01 / ContainerShipEmpty_01 | 船运集装箱 | 港口场景 |
+| BigDumpster | 大垃圾箱 | 街道 |
+| Fence_Normal_100-400 / Fence_Small_100-400 | 围栏 | 场地分隔 |
+| Radiator | 散热器 | 室内墙面 |
+
+---
+
+## 十、垃圾（Trashs）
+
+| 资产名 | 说明 |
+|--------|------|
+| TrashCans_01 | 垃圾桶（盖着） |
+| TrashCansOpen_01 | 垃圾桶（打开） |
+| TrashCansLid_01 | 垃圾桶盖（单独） |
+
+---
+
+## 十一、灯光（Lights）
+
+| 资产名 | 说明 |
+|--------|------|
+| CeilingLight01 / 02a / 02b / 03a / 03b | 吸顶灯（多种） |
+| CeilingLightBulb / CeilingLightBulbBreak | 灯泡（正常/损坏） |
+| CeilingLightFlat02a / 02b | 平板灯 |
+| CeilingLightRotaryWarning | 旋转警示灯 |
+| SpotLight / SpotLight_Support | 射灯 |
+| FlamingTorch / FlamingTorchWithSupport / FlamingTorch_Support | 火把 |
+| FlashLight | 手电筒 |
+| RoadLamp_01 | 路灯 |
+| RoadLight | 道路灯 |
+
+---
+
+## 十二、基础体（Primitives）
+
+| 资产名 | 说明 | 用途 |
+|--------|------|------|
+| Cube | 立方体 | 万能替代，可缩放 |
+| Cylinder | 圆柱体 | 柱子、管道 |
+| Sphere | 球体 | 装饰 |
+| Cone | 圆锥体 | 装饰 |
+| Ramp | 斜坡 | 地形过渡 |
+| QuarterPipe | 四分之一管 | 装饰/地形 |
+| QuarterCylinder | 四分之一圆柱 | 角落装饰 |
+| CirclePlatform | 圆形平台 | 地面标记 |
+| SquarePlatform | 方形平台 | 地面标记 |
+| SphereOctant / SphereOctantInvert | 球体切片 | 装饰 |
+
+**弯曲基础体**（CylinderBend/RectangleBend/RectangleAngle，各种半径 150-450cm）
+
+---
+
+## 十三、其他（Extra）
+
+| 资产名 | 说明 |
+|--------|------|
+| Tree_01 | 树木（唯一的植被资产） |
+| Ladder_01_200 / Ladder_01_Unit | 梯子（两种） |
+| Ladder_02_200 / Ladder_02_Unit | 梯子 B（两种） |
+| SnowMan_01 | 雪人 |
+| Campfire | 营火 |
+| HumanMesh_01 / 02 | 人体参考网格 |
+| HumanCage / HumanCageWithFloor | 人体碰撞参考框 |
+| ArrowBody / ArrowHead / ArrowBack | 箭头组件 |
+| CameraPose_01-04 | 摄像机参考姿态 |
+| DisplayPanels_50x50 到 400x200 | 展示面板（8种尺寸） |
+
+---
+
+## 十四、标识色材质速查
+
+> 用于白模阶段区分不同区域/物体类型。命名规律：`MI_Dev<颜色>` 或 `MI_Dev<颜色>_TPLA/TPWA`（三平面变体）。
+
+| 材质名 | 颜色 | 推荐用途 |
+|--------|------|---------|
+| MI_DevRed | 红色 | 危险区域、交互热点、围墙 |
+| MI_DevBlue | 蓝色 | 水域、天空相关 |
+| MI_DevGreen | 绿色 | 植被、草地、可通行 |
+| MI_DevBrown | 棕色 | 泥土、木质结构 |
+| MI_DevGray | 灰色 | 水泥、混凝土、道路 |
+| MI_DevWhite | 白色 | 墙壁、室内 |
+| MI_DevBlack | 黑色 | 阴影区域、遮挡 |
+| MI_DevYellow | 黄色 | 警示、收集品标记 |
+| MI_DevOrange | 橙色 | 施工区域、路障 |
+| MI_DevPink | 粉色 | 角色/NPC 相关 |
+| MI_DevPurple | 紫色 | 特殊/隐藏区域 |
+| MI_DevSkyBlue | 天蓝 | 水面、天空 |
+| MI_DevFoliage | 草绿 | 植物、树木 |
+| MI_LightGreen | 浅绿 | 草地细节 |
+
+**特殊材质**：
+- `MI_DevGrid` — 带网格的灰色材质，用于地面
+- `M_DevMirror` — 镜面材质
+- `M_FullyBlack` — 纯黑材质，用于遮挡/剪影
+- `MI_DevGlassBlue/Green/Red/White` — 透明玻璃材质
+- `MI_DevLight_*` — 自发光材质（绿/蓝/橙/白/黄/红/天蓝）
+- `MI_StainDecalColor*` — 污渍贴花（黑/蓝/绿/红/天蓝/黄）
+
+---
+
+## 十五、中式城郊场景替代方案速查
+
+> 千禧年城郊结合区的许多物件在 BSP 中没有精确匹配，下表提供替代策略。
+
+| 场景物件 | BSP 替代方案 | 标识色建议 |
+|---------|-------------|-----------|
+| 红砖围墙 | Wall_400x300 组合 + MI_DevRed | 红 |
+| 绿色铁门/木门 | RotativeDoor_01 + MI_DevGreen | 绿 |
+| 小卖部招牌 | Cube 缩放为薄长条 + MI_DevBlue/Orange | 蓝/橙 |
+| 卷帘门 | GarageDoor_01 + MI_DevGray | 灰 |
+| 玻璃柜台 | Cube 缩放为扁长方体 + MI_DevGlassWhite | 透明白 |
+| 老式冰柜 | Container_Normal 缩小 + MI_DevWhite | 白 |
+| 金属货架 | Fence_Small 排列 + MI_DevGray | 灰 |
+| 公用电话亭 | Cube+Cylinder 组合 | 灰 |
+| 电线杆 | Cylinder 高缩放 + MI_DevGray | 灰 |
+| 晾衣杆 | Beam_300 + Cylinder 支撑 + MI_DevWhite | 白 |
+| 铁栏杆窗户 | WallWindow + Beam 细条前置 | 灰 |
+| 水泥路裂缝 | Floor + MI_DevGray + Decal 贴花 | 灰 |
+| 积水坑 | Floor 嵌入地面 + MI_DevGlassBlue | 天蓝 |
+| 水塘水面 | Floor_1000x1000 + MI_DevSkyBlue/GlassBlue | 天蓝 |
+| 芦苇/杂草 | 多个小 Cylinder 不同角度 + MI_DevFoliage | 草绿 |
+| 施工围挡 | BarricadeWall_200/400/600 + MI_DevBlue | 蓝 |
+| 垃圾桶 | TrashCans_01 + MI_DevGreen | 绿 |
+| 老式自行车 | Car01 缩小至 ~50% 或 Primitives 组合 | 黑 |
+| 弹珠/小物件 | Sphere 缩小至 ~2cm | 彩色 |
+| 老式冰箱 | Barrel 竖放或 Cube + MI_DevWhite | 白 |
+| 大脑袋电视 | Monitor_01 + MI_DevGray | 灰 |
+| 水塔/工业设备 | Cylinder + CylinderBend 组合 | 灰/棕 |
+| 平房屋顶 | Floor 覆盖 + MI_DevBrown | 棕 |
+| 台阶 | Stair_100 或 Ramp | 灰 |
+| 围墙门洞 | WallDoor_200x300 + RotativeDoor | 红 |