---
name: level-builder-bugfix-v01
description: v01白模关卡8个问题的诊断和修复记录，包括搭建指南/解析器/构建器的修改
metadata:
  type: project
---

# v01 白模关卡问题修复记录（2026-06-08）

## 修复的文件

| 文件 | 修改内容 |
|------|---------|
| `docs/technical/关卡-v01-搭建指南.md` | 修复6个问题：全局地面、Z1双Floor、西边界旋转统一、东边界改Wall_400x300、Z1房屋墙旋转、院门改WallDoorDouble、南边界Z7去重 |
| `tools/level-builder/parsers/build_guide_parser.py` | 新增 `_deduplicate_actors()` 去重；`_parse_phase_ground` 缩小范围到B1段；支持 `旋转 (P,Y,R)` 列名；支持全局地面标题 |
| `tools/level-builder/builder/scene_builder.py` | `load_asset` 失败时用 Cube 占位 + `[MISSING]` 前缀 + MI_DevPink 标记 |
| `tools/level-builder/config/asset_mapping.py` | 新增 `WallDoorDouble_400x300` 资产映射 |
| `tools/level-builder/parsers/markdown_table.py` | `parse_rotation` 增加箭头注释处理说明 |

## 诊断结论

- 8个问题中6个源头在**搭建指南**，2个涉及执行案
- 解析器有双重解析bug（地面段解析了边界表格）已修复
- 构建器有静默fallback已改为醒目标记

## Why: 用户检查生成的白模关卡发现多处明显错误，需要追溯源头并修复
## How to apply: 重新生成关卡时使用修复后的 JSON（238 Actor）。如再出问题，先查搭建指南再查解析器。