PCG-01 · Aipcg
01 / 18
Aipcg：让 Agent 学习已有项目
沿 C++、Python、数据与 PCG 追踪自然语言需求怎样成为场景。
- 定位模块职责和当前调用链。
- 解释数据字段、单位与资产轴心。
- 区分当前源码、历史报告和本次离线核对。
PCG-01 · Aipcg
02 / 18
项目整体逻辑架构
PCG-01 · Aipcg
03 / 18
输入输出与使用场景
输入事实
- 自然语言场景目标与结构约束。
- 真实网格路径、尺寸和包围盒。
- 模板地图、DataTable 与 PCG 子图。
交付对象
- scene / layout、分类图和规划 CSV。
- 导入报告、地图与质量报告。
- 地图存在仍需几何与视觉验收。
PCG-01 · Aipcg
04 / 18
历史路线与资料版本
| 材料 | 所属范围 | 本章处理 |
|---|---|---|
| Houdini、Python、模型 API、Codex | 项目历史演进 | 不混成一条当前实现 |
| 当前源码与 policy | 2026-10-10 文件副本 | 按哈希定位工作区变化 |
| 2026-10-02 运行产物 | 历史执行 | 不当作本次 UE 实测 |
| 学习 V2.0 | 教材交付版本 | 不等同 Aipcg 的版本号 |
PCG-01 · Aipcg
05 / 18
目录职责
| 模块 | 职责 |
|---|---|
| EditorModule / run.py | 发起任务与阶段编排 |
| coordinates / raster / geometry | 单位、分类图和几何 |
| village_layout / plan adapter | 建筑规划、审计与 CSV |
| import_demo02_unreal.py | DataTable、PCG 与地图导入 |
PCG-01 · Aipcg
06 / 18
C++ 入口与 Python 编排
01
编辑器按钮准备请求并启动外部 Python。
02
运行目录保存输入、进度与结果。
03
Python 组织结构生成、规划、审计和导入。
04
C++ 轮询结果中的 ue_map_ready，更新界面状态。
PCG-01 · Aipcg
07 / 18
结构化场景与布局
- Codex 生成 scene / layout，结构需符合约束。
- 场景语义与空间计划分别交接。
- 分类 PNG 由确定性栅格程序计算。
- 当前链路中的分类图不是图像生成模型直接产物。
PCG-01 · Aipcg
08 / 18
几何、建筑规划与约束
| 计算 | 服务的目标 | 检查内容 |
|---|---|---|
| 曲线与闭合轮廓平滑 | 道路、水域和地块 | 边界与类别关系 |
| 分组与候选选择 | 建筑位置规划 | 连通、容量与条件 |
| 旋转占用与碰撞 | 真实资产放置 | 包围盒、间距和越界 |
容量 witness 证明可容纳候选，不保证最终每块放置同样数量。
PCG-01 · Aipcg
09 / 18
数据格式与坐标
1024 px ↔ 20000 cm
1 px = 19.53125 cm
X = (PixelX - 512) × 19.53125
Y = (PixelY - 512) × 19.53125
(768,256) → (5000,-5000) cm- 当前设置中图片向下与世界 Y 增大一致。
- 函数也支持另一方向，要记录参数。
- 建筑中心换算后，还要处理轴心偏移。
PCG-01 · Aipcg
10 / 18
UE 导入、PCG 与场景结果
程序已确定
- 建筑资产、XY、Yaw 与 Scale。
- 几何数据和导入表字段。
- 数据审计与阶段产物。
引擎接续
- Terrain 构建动态网格。
- Buildings 实例化规划结果。
- Vegetation 使用采样与噪声规则。
PCG-01 · Aipcg
11 / 18
状态和依赖
- 模型、规划导出、导入保存和验收各有状态。
- 依赖 Codex CLI、提示、schema 与 Python 工具。
- UE 还依赖真实资产、模板地图和 PCG 图。
- 复制源码可学习算法，不代表完整可运行工程。
PCG-01 · Aipcg
12 / 18
完成状态与质量验证
| 状态 | 需要的证据 | 不能替代 |
|---|---|---|
| 结构生成 | schema 与字段 | 几何正确 |
| 规划完成 | 越界、碰撞、引用 | 引擎导入 |
| 地图就绪 | UE 执行与保存 | 视觉质量 |
| 质量接受 | 几何与视觉评审 | 其他版本也通过 |
PCG-01 · Aipcg
13 / 18
历史运行追踪
23
历史建筑 CSV 记录
6
历史 Terrain 动态网格组件
631
历史 Vegetation 实例
- 地图报告也记载 Buildings 23 个实例。
- CSV 与地图报告来自不同运行目录，不能仅凭数量认同身份。
- 这些是旧报告，本次没有启动 UE。
PCG-01 · Aipcg
14 / 18
Agent 代码阅读路线
01
从编辑器入口追到 run.py 的阶段。
02
读取字段、坐标约定与真实资产 bounds。
03
追踪一个 AssetKey 从 plan 到 CSV。
04
核对导入与报告范围，说明仍缺少的引擎证据。
PCG-01 · Aipcg
15 / 18
项目导读模板
| 导读项 | 要写的事实 |
|---|---|
| 版本与入口 | HEAD、哈希、工作区和调用位置 |
| 数据合同 | 字段、单位、轴心与默认值 |
| 执行环境 | Python、UE、资产和图依赖 |
| 结果与边界 | 完成状态、检查、历史与未实测 |
PCG-01 · Aipcg
16 / 18
练习与验收
- 选择一个建筑，解释图片位置到世界轴心的过程。
- 提交字段追踪表与可回查源码位置。
- 每条架构连线都有调用或数据交接依据。
- 明确实例统计来自哪次报告、哪些没有重新运行。
PCG-01 · Aipcg
17 / 18
项目学习思维导图
PCG-01 · Aipcg
18 / 18