feat(tools): 白模关卡自动生成Python脚本——Level Builder

两阶段流水线:搭建指南Markdown → JSON → UE5 Actor
- 解析器:4种表格变体+范围展开+坐标表达式计算
- 配置:37种BSP资产映射+13种材质+7区域定义
- 验证:265个Actor全部通过,0错误
- Builder:UE5 Python API自动放置Actor+材质+Outliner
- 报告:自动生成搭建报告Markdown

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
2026-06-07 23:03:45 +08:00
parent 8011cb6472
commit 0f96b79dba
74 changed files with 10468 additions and 109 deletions
+17 -18
View File
@@ -20,7 +20,7 @@ memory: project
| 文档 | 路径 | 用途 |
|------|------|------|
| 技术设计方案 | `docs/technical/<system-name>-tech.md` | 回应执行文档每条规则的实现方案 |
| 技术设计方案 | `docs/technical/<系统名>-技术方案.md` | 回应执行文档每条规则的实现方案 |
| C++ 源码 | `Source/` | 引擎级系统、性能关键路径 |
| 蓝图资产 | `Content/Blueprints/` | 游戏逻辑、UI、交互 |
| DataAsset | `Content/Data/` | 数据驱动的配置资产 |
@@ -88,10 +88,10 @@ memory: project
```
**必须按序阅读的输入**:
1. 执行文档 (`docs/design/<stage>/<system-name>-execution.md`) — 行为规则细节
2. 系统设计文档 (`docs/design/<stage>/<system-name>.md`) — 全局上下文
1. 执行文档 (`docs/design/<stage>/<系统名>-执行案.md`) — 行为规则细节
2. 系统设计文档 (`docs/design/<stage>/<系统名>.md`) — 全局上下文
3. 配置表 (`GameConfig/`) — 可调参数
4. 概念文档 (`docs/design/concept.md`) — 方向参考(需要理解设计意图时查阅)
4. 概念文档 (`docs/design/概念草案.md`) — 方向参考(需要理解设计意图时查阅)
**技术设计文档**:按 `.claude/skills/requirements-analysis/` 中定义的需求分析 skill 产出。
@@ -124,14 +124,14 @@ memory: project
当版本开发涉及场景搭建时,白模搭建是 ⑥程序实现的首要子任务。
**输入**:
- `level-v<XX>-<name>-execution.md` — 关卡执行案(空间指南)
- `scene-v<XX>-<name>.md` — 场景设计案(氛围参考)
- `关卡-v<XX>-<名称>-执行案.md` — 关卡执行案(空间指南)
- `场景-v<XX>-<名称>.md` — 场景设计案(氛围参考)
- 系统执行案(交互物/收集品清单)
- `Content/BlockingStarterPack/` — BSP 资产
**输出**:
- `Content/Maps/LVL_<SceneName>V<XX>.umap` — 白模关卡文件
- `docs/technical/level-v<XX>-build-report.md` — 搭建报告(偏差记录)
- `docs/technical/关卡-v<XX>-搭建报告.md` — 搭建报告(偏差记录)
- **在对应任务 Issue 下以评论发布搭建报告**(包含偏差清单、资产替代、缩放记录、比例验证结果,使 PM 和策划能直接在 Issue 中查看)
**搭建流程**:
@@ -147,10 +147,10 @@ memory: project
**Outliner 结构**:按区域分文件夹(Z1_家/Structure/、Z1_家/Props/、...),Global/ 放边界和光照。
**搭建报告**:逐区域对照文档要求记录偏差,包含资产替代清单、缩放记录、未实现项、比例验证结果。**报告必须同时**:
1. 写入 `docs/technical/level-v<XX>-build-report.md`(本地文件)
1. 写入 `docs/technical/关卡-v<XX>-搭建报告.md`(本地文件)
2. 以评论形式发布到对应任务 Issue(内容与本地文件一致,供 PM 和策划直接查看)
**完整规范**:参见 `docs/design/prototype/level-design-workflow.md` 第四章。
**完整规范**:参见 `docs/design/prototype/关卡设计工作流.md` 第四章。
### 工作流 C:代码实现(步骤⑥子任务 6b-6f)
@@ -292,22 +292,21 @@ memory: project
## 关键文件路径
### 你产出和维护:
- `docs/technical/<system-name>-tech.md` — 技术设计文档
- `docs/technical/notes/*.md` — 架构决策、技术选型笔记、经验教训
- `docs/technical/<系统名>-技术方案.md` — 技术设计文档
- `docs/technical/笔记/*.md` — 架构决策、技术选型笔记、经验教训
- `Source/` — C++ 代码
- `Content/Blueprints/` — 蓝图
- `Content/Data/` — DataAsset 配置
### 你阅读:
- `.claude/refs/development-workflow.md` — 流水线定义、质量标准
- 项目管理工具 Issues — 查看分配给你的任务和流水线状态(参见 `.claude/skills/gitea-collab.md`)
- `docs/plans/<stage>-roadmap.md` — 版本划分、范围
- `docs/design/concept.md` — 游戏方向参考
- `docs/design/<stage>/<system-name>.md` — 系统设计概览
- `docs/design/<stage>/<system-name>-execution.md` — 行为规则(你的主要输入)
- `docs/plans/<阶段>-路线图.md` — 版本划分、范围
- `docs/design/概念草案.md` — 游戏方向参考
- `docs/design/<stage>/<系统名>.md` — 系统设计概览
- `docs/design/<stage>/<系统名>-执行案.md` — 行为规则(你的主要输入)
- `GameConfig/*.csv` / `*.json` — 可调参数
- `docs/plans/reviews/<task-id>-review.md` — PM 质量门审查结果
- `docs/art/style-guide.md` — 视觉方向参考(集成美术时阅读)
- `docs/plans/reviews/<任务ID>-审查记录.md` — PM 质量门审查结果
- `docs/art/美术风格指南.md` — 视觉方向参考(集成美术时阅读)
---