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
@@ -21,10 +21,10 @@ description: >
按序阅读以下文档,获取完整的上下文信息:
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`) — 方向参考(需要理解设计意图时查阅)
---
@@ -134,7 +134,7 @@ description: >
## 输出
最终产出为技术设计文档,保存到 `docs/technical/<system-name>-tech.md`。
最终产出为技术设计文档,保存到 `docs/technical/<系统名>-技术方案.md`。
文档必须遵循 `references/output-template.md` 中定义的标准模板结构。8 步分析的结果整合到模板的对应章节中,同时保留现有的必要章节(美术资源需求、数据流、可调参数汇总、文件结构)。
@@ -280,11 +280,11 @@ flowchart TD
### 3.3 项目实际案例参考
**需要时序图的特性**(从现有 `interaction-system-tech.md` 提取):
**需要时序图的特性**(从现有 `交互系统-技术方案.md` 提取):
- 完整交互流程(Enter → AnimLock → Active → Exit)
- 拾取流程(交互系统 → 物品系统 → 收集系统)
**不需要时序图的特性**(从现有 `player-controller-tech.md` 提取):
**不需要时序图的特性**(从现有 `玩家控制器-技术方案.md` 提取):
- SpringArm 参数配置(纯构造函数设置)
- CMC 移动参数调整(纯配置)
@@ -8,9 +8,9 @@
| 示例 | 来源文档 |
|------|---------|
| 交互系统 | `docs/technical/interaction-system-tech.md` |
| 角色控制 | `docs/technical/player-controller-tech.md` |
| 收集系统 | `docs/technical/collection-system-tech.md` |
| 交互系统 | `docs/technical/交互系统-技术方案.md` |
| 角色控制 | `docs/technical/玩家控制器-技术方案.md` |
| 收集系统 | `docs/technical/收集系统-技术方案.md` |
---
@@ -10,7 +10,7 @@
# <系统名称> 技术设计文档(<版本号> <阶段>)
> 任务ID: <任务编号>
> 对应执行案: `<执行案文件路径>`
> 对应执行案: `docs/design/<stage>/<系统名>-执行案.md`
> 关联系统: <上游/下游/平行系统列表>
> 阶段: 原型 / 批量生产 / 测试
> 日期: <YYYY-MM-DD>