Files
ChildHood/docs/technical/level-v01-build-report.md
T
starmen1265 8011cb6472 docs(review): P-008交互系统程序设计质量门审查通过+美术调研+工作流完善
- P-008 交互系统技术设计审查通过,审查记录 docs/plans/reviews/P-008-review.md
- D-001 关卡执行案审查通过,审查记录 docs/plans/reviews/D-001-review.md
- 新增 AI 美术调研参考图(我的暑假/放学后少年/真实场景/美术风格)
- 新增关卡执行案、白模搭建指南和搭建报告
- 完善工作流技能:质量门审查、Agent记忆、需求分析
- 更新交互系统和角色控制系统技术设计文档
- 清理过时参考文档
2026-06-07 01:54:02 +08:00

10 KiB
Raw Blame History

v0.1 白模搭建报告 — 城郊小街

P-006 任务产出 — 搭建准备阶段 最后更新:2026-06-07


一、搭建概要

项目 值
关卡文件 Content/Maps/LVL_SuburbanV01.umap(需在 UE5 编辑器中创建)
搭建指南 docs/technical/level-v01-build-guide.md
场景尺寸 8000cm × 6000cm(80m × 60m)
区域数量 7 个(Z1-Z7)
预估总 Actor 数 ~195
BSP 资产包 Content/BlockingStarterPack/

各类别预估数量

类别 数量
结构体 (STR) ~80
布景 (PROP) ~45
交互物 (INTR) 10
收集品 (COLL) 10
边界 (BND) ~45
光源 (LGT) 5
合计 ~195

二、逐区域对照

Z1 家

条目 文档要求 实际方案 偏差
院墙高度 250cm Wall_400x300(300cm 高) 轻微:+50cm,视觉影响小
院门宽度 200cm WallDoor_200x300 ✅ 匹配
院门高度 220cm WallDoor_200x300 门洞约 100cm 开口 ⚠️ 需验证门洞实际开口高度
房屋尺寸 600×380×280 按偏移放置墙体围合 ✅ 匹配
旧自行车 Car01 缩放 50% Car01 缩放 20% 轻微:BSP Car01 默认较大,20% 更接近自行车尺寸
老式冰箱 Barrel 或 Cube Cube 缩放模拟方冰箱 轻微:Barrel 圆柱形不如 Cube 方形更像冰箱
交互物 3 个 I01/I02/I06 标记位置 ✅ 匹配
收集品 1 个 C10 猫眼弹珠 标记位置 ✅ 匹配

Z2 小卖部

条目 文档要求 实际方案 偏差
建筑尺寸 600×400×280 按偏移放置 ✅ 匹配
卷帘门 GarageDoorOpen_01 ✅ ✅ 匹配
遮阳棚 Floor_200x300 × 2 ✅ ✅ 匹配
玻璃柜台 Cube + MI_DevGlassWhite ✅ ✅ 匹配
零食货架 Fence_Small_400 竖放 × 2 Fence_Small_400 排列 ✅ 匹配
老式冰柜 Cube 缩放 + MI_DevWhite Container_Normal 缩小替代 轻微:Cube 方案更简单
招牌 Cube 薄片 + MI_DevBlue ✅ ✅ 匹配
交互物 2 个 I05/I07 标记位置 ✅ 匹配
收集品 1 个 C09 小弹力球 标记位置 ✅ 匹配

Z3 主街道

条目 文档要求 实际方案 偏差
街道尺寸 5000×500 Floor_1000x1000 × 5 平铺 ✅ 匹配
南墙 C 段 X=1600-4000, 2400cm 6 块 Wall_400x300 ✅ 匹配
南墙 D 段 X=4000-5000, 1000cm 2 块 Wall_400x300 + Wall_200x300 ✅ 匹配
北墙 A 段 X=0-2300, 2300cm 5 块 Wall_400x300 + 1 块 Wall_200x300 ✅ 匹配
北墙 B 段 300cm 开口 开放通行 ✅ 匹配
北墙 C 段 X=2600-3500, 900cm 2 块 Wall_400x300 + 1 块 Wall_100x300 ✅ 匹配
北墙 D 段 1500cm 开口 开放通行 ✅ 匹配
公用电话亭 Cube+Cylinder Cube 单体缩放 轻微:简化为单体
广告墙 DisplayPanels_400x200 ✅ ✅ 匹配
交互物 2 个 I04/I09 标记位置 ✅ 匹配
收集品 1 个 C08 透明冰花弹珠 标记位置 ✅ 匹配

Z4 空地

条目 文档要求 实际方案 偏差
地面高度 +10cm Floor Z=10 ✅ 匹配
东边界围挡 BarrierWall_600 × 2 ✅(需堆叠 2 层) ⚠️ BarrierWall_600 高仅 100cm,需堆叠
北边界围挡 BarrierWall_600 × 2 + BarrierWall_200 ✅(需堆叠) 同上
西边界矮墙 BarrierWall_200 × 6 ✅ ✅ 匹配
大梧桐树 Tree_01 ✅ ✅ 匹配
交互物 2 个 I03/I08 标记位置 ✅ 匹配
收集品 3 个 C01/C03/C04 标记位置 ✅ 匹配

Z5 巷子

条目 文档要求 实际方案 偏差
巷子宽度 300cm 实际约 260cm(2580-2300-20墙厚) 重大:宽度差 40cm,仅 87% 设计宽度
巷子长度 2000cm 墙体 Y=1300-3300 覆盖 ✅ 匹配
墙壁高度 300cm Wall_400x300(300cm) ✅ 匹配
老窗户 FakeWindowsFrame ✅ ✅ 匹配
交互物 1 个 I10 废纸箱 标记位置 ✅ 匹配
收集品 1 个 C02 红色花纹弹珠 标记位置 ✅ 匹配

Z6 水塘边

条目 文档要求 实际方案 偏差
水面高度 Z=-20cm ✅ ✅ 匹配
水面尺寸 1200×800 Floor 缩放覆盖 ✅ 匹配
岸边三面 各约 300cm Floor 覆盖 ✅ 匹配
芦苇丛 Cylinder × N ✅ ✅ 匹配
交互物 无 — ✅ 匹配
收集品 2 个 C05/C06 标记位置 ✅ 匹配

Z7 老居民楼

条目 文档要求 实际方案 偏差
建筑尺寸 1200×600×1800 Building_01 默认尺寸待验证 ⚠️ 需在编辑器中确认/缩放
碰撞围墙 阻止靠近 Wall_400x300 排列 ✅ 匹配
不可进入 无门洞 ✅ ✅ 匹配
晾衣杆 3 个 Beam_300 × 3 ✅ ✅ 匹配

三、资产替代清单

# 文档建议 实际使用 原因
1 BarrierWall_600/200(围挡) 建议改用 Wall_400x300 旋转 90° BarrierWall 高仅 100cm 需堆叠 2-3 层,Wall_400x300 高 300cm 一步到位更高效
2 Car01 缩放 50%(自行车) Car01 缩放 20% BSP Car01 默认尺寸(约 450cm 长)远大于自行车,20% 缩放至约 170cm 更接近
3 Barrel(冰箱) Cube 缩放 Barrel 为圆柱形,冰箱应为方形,Cube 更合适
4 Container_Normal(冰柜) Cube 缩放 同上,Cube 更简单直接
5 BarricadeWall_100(路障) 未使用 执行案未引用此资产(D-001 审查已修正)

四、缩放记录

Actor 资产 默认尺寸 缩放 实际尺寸 用途
自行车 Car01 ~450×180×150 (0.2, 0.2, 0.2) ~90×36×30 旧自行车
冰箱 Cube 100×100×100 (0.3, 0.3, 1.6) 30×30×160 老式冰箱
门垫 Cube 100×100×100 (0.6, 0.4, 0.02) 60×40×2 扁薄长方体
日历 Cube 100×100×100 (0.3, 0.02, 0.4) 30×2×40 墙面薄片
玻璃柜台 Cube 100×100×100 (2, 0.6, 0.9) 200×60×90 扁长方体
招牌 Cube 100×100×100 (3, 0.05, 0.4) 300×5×40 薄长条
积水坑 Cube 100×100×100 (1.2, 0.8, 0.01) 120×80×1 扁平水面
电话亭 Cube 100×100×100 (0.8, 0.8, 2.2) 80×80×220 方形亭
电线杆 Cylinder ~100Ø×100 (0.04, 0.04, 12) ~Ø4×600 高细圆柱
支撑柱 Cylinder ~100Ø×100 (0.05, 0.05, 3.6) ~Ø5×180 晾衣杆柱
花盆 Cylinder ~100Ø×100 (0.2, 0.2, 0.25) ~Ø20×25 窗台小花盆
青蛙 Cube 100×100×100 (0.05, 0.05, 0.04) 5×5×4 微型
荷叶 CirclePlatform ~100Ø (0.06, 0.06, 0.01) ~Ø6 水面小圆
弹珠圈 CirclePlatform ~100Ø (0.16, 0.16, 0.01) ~Ø16 地面圆圈
下水道盖 CirclePlatform ~100Ø (0.12, 0.12, 0.02) ~Ø12 路面小圆
芦苇 Cylinder ~100Ø×100 (0.08, 0.08, 2) ~Ø8×200 细长植物

五、未实现项

# 项目 原因 建议处理
1 .umap 关卡文件 无法在 CLI 中创建二进制 UE5 关卡文件,需在 UE5 编辑器中操作 用户根据搭建指南在编辑器中创建
2 交互物逻辑 交互物仅放置占位标记,不包含交互逻辑代码 6b-6f 子任务实现
3 收集品逻辑 收集品仅放置占位标记,不包含拾取逻辑 6b-6f 子任务实现
4 物理碰撞设置 边界和墙体需启用碰撞,需在编辑器中设置 搭建时设置 Collision Preset = BlockAll
5 材质实例覆盖 部分材质需要在编辑器中创建动态材质实例(MI) 搭建时在 Details 面板设置
6 Outliner 文件夹分组 需在编辑器中手动拖拽 Actor 到对应文件夹 搭建时组织

六、比例验证结果

E1 角色比例检查(待编辑器中执行)

检查项 预期结果 状态
Z1 院门可通过 门洞 200cm 宽,主角 120cm 身高 ⬜ 待验证
Z1 房屋门可通过 WallDoor_200x300 门洞 ⬜ 待验证
Z2 卷帘门可通过 400cm 开放门洞 ⬜ 待验证
室内摄像机不穿墙 净高 280cm,摄像机 100cm ⬜ 待验证
窗台高度 WallWindow 窗台约 100cm ⬜ 待验证
桌面高度 SimpleTable_01 ~75cm ⬜ 待验证

E2 流线通行检查(待编辑器中执行)

路径 状态
Z1 院门 → Z3 街道 ⬜ 待验证
Z3 → Z2 小卖部 ⬜ 待验证
Z3 → Z4 空地 ⬜ 待验证
Z3 → Z5 巷子 ⬜ 待验证
Z5 → Z6 水塘边 ⬜ 待验证
Z7 不可到达 ⬜ 待验证

E3 已知尺寸偏差(搭建前识别)

# 偏差 等级 说明
1 Z5 巷子实际宽度约 260cm vs 设计 300cm 重大 Wall 厚度 20cm 占用空间。建议:将东墙东移至 X=2600+20=2620,或接受 260cm 宽度
2 BarrierWall 高度仅 100cm vs 设计围挡 200cm 轻微 需堆叠 2 层,或改用 Wall_400x300 旋转 90°
3 Building_01 默认尺寸待确认 vs 设计 1200×600×1800 轻微 需在编辑器中测量并按需缩放
4 Z3 北墙偏移 480cm vs 区域深度 500cm(PM 审查残留) 轻微 20cm 差异在 500cm 深度中影响极小
5 第五章南边界汇总表 "BarricadeWall" 应为 "BarrierWall"(PM 审查残留) 轻微 泛指文本,不影响搭建

七、下一步

  1. 用户在 UE5 编辑器中按搭建指南操作:创建关卡文件 → 按 Phase B→C→D→E 顺序放置 Actor
  2. 验证阶段:执行 E1/E2/E3 检查清单,记录实际验证结果
  3. 更新本报告:将编辑器中的实际偏差补充到报告
  4. PM 验收门审查:搭建完成后通知 PM 执行 ⑥程序实现验收门审查