资料核验日期：2026-10-10。公开版保留整理正文与必要证据；原始资料通过来源链接回查。验证范围在正文中分别说明。
Aipcg：Agent 辅助 TA 开发案例
核验日期：2026-10-10。主线是自然语言布局进入工程数据和 UE 场景的开发方式；详细问题选择有完整输入与代码依据的“建筑中心与轴心换算”。历史迭代背景与本次发现分别标注，不补造开发对话或前后性能。
1. TA 目标转成工程条件
风格、道路关系、地块布局、建筑尺寸和编辑器可用性属于不同质量要求。场景描述可交给模型组织；可计算的边界、碰撞和数据一致性由代码检查；真实网格尺寸来自 UE；视觉构图仍需人工评审。
| TA 要求 | 工程表达 | 接受方式 |
|---|---|---|
| 建筑不能重叠 | 旋转占用形状与间距 | 几何审计及失败样本 |
| 放置现有资产 | AssetKey、Mesh、真实包围盒 | 资产查询与引用检查 |
| 道路与河流关系合理 | 曲线、类别、地块约束 | 数据审计加视觉检查 |
| 地图可编辑 | DataTable、PCG 图、地图保存 | UE 实际导入与打开 |
| 风格符合目标 | 参考图、描述与比较项 | 人工判断，记录原因 |
仅写“生成漂亮村庄”无法提供稳定工程反馈。也不能为了可量化，擅自把所有美术要求改成面积比例。
2. 两类 Agent 的职责
开发 Agent 读取代码、定位接口、修改实现、运行检查并交付；运行时 Codex 根据场景描述产生结构化数据，随后由 Python 和 UE 接续。前者改工具，后者使用工具产生内容。两者都需要上下文，但访问对象和完成标准不同。
开发时应提供项目导读、真实资产样例、失败数据和检查方法。运行时应提供提示、schema、配置与必要资产信息。模型产出 JSON 不等于全部场景开发完成，也不等于 PCG 已经执行。
3. 准备版本一致的上下文
本版本保留当前代码、副本哈希、历史运行与旧学习资料。历史运行为 10021958_prompt_no_reference，相关地图报告另来自 10021941_wuzhen_prompt，两者不能直接认定是同一地图；可以核对它们各自记载的 23 建筑数量，并注明来源不同。
当前 policy 与历史 manifest 的尝试上限不同，源码工作区也有未提交变化。给 Agent 的任务说明必须指明要解释当前实现，还是复盘旧运行。源码与资产数据缺失时，先查询事实，不能凭模型经验补出资产大小。
4. 拆分改动与接口
可以把链路分成结构化输出、确定性规划、数据导出、引擎导入四项。每项都有输入、输出和失败协议。先定义字段单位与标识，再分别实现；导出与导入共享的 schema 要同步检查，避免一端改名而另一端仍读取旧列。
现有实现的关键选择是模型提出布局、程序处理几何、真实资产约束规划、PCG 构建实例。这样可将许多失败归到具体数据环节，而不是不断修改自然语言提示。历史开发复盘支持这种方向，但没有完整逐次耗时记录，本章不评估绝对开发速度。
5. 具体问题：直接比较坐标为何不一致
本次整理中，先用纯坐标函数将 CSV 的 PixelX／PixelY 换算为世界厘米，直接与 WorldX／WorldY 比较，最大差值为 94.62943195486332 cm。这一现象并不是已证实的引擎缺陷；它暴露了核对方法中的错误假设。
依次检查单位、Y 方向、Yaw、Scale 和资产包围盒。代码显示图片坐标是占用中心，World 位置是模型轴心。资产的局部 BoundsCenter 不必等于零；旋转后中心偏移会改变轴心位置。
设图片换算后的世界中心为 C，局部包围盒中心为 c=(cx,cy)，缩放为 s，旋转为 θ：
R(θ)c = (cx cosθ − cy sinθ, cx sinθ + cy cosθ)
WorldPivotXY = C − s × R(θ)c
检查时使用 BoundsCenter、Yaw 和 Scale 修正，23 条记录最大误差为 0.0 cm；脚本容差设为 0.0001 cm。plan 与 CSV 的 WorldXYZ／Yaw／Scale 及资产引用也全部一致。这是本次实际执行的离线数据核对，不是修复了 UE 放置代码。
| 对照 | 输入与方法 | 本次结果 |
|---|---|---|
| 初始核对 | 把中心当轴心直接比较 | 最大差值约 94.63 cm |
| 正确核对 | 加入旋转后的局部中心偏移 | 最大误差 0.0 cm |
| 数据交接 | plan 与 CSV 同名实例比较 | 数值误差 0.0，引用一致 |
源码依据：坐标函数、建筑规划、导出审计。复现：整理案例证据.py 与 结果。
6. 分层证明可用性
结构检查证明字段和类型；几何检查证明指定空间规则；资产检查证明引用与尺寸；引擎执行证明导入和图生成；地图保存证明产物落盘；视觉检查证明目标效果。这六层可以有不同结论。
历史报告记载地图核验通过，但本次没有启动 UE；当前复制 policy 关闭视觉审计，不能声称本次完成自动视觉验证。历史只读 commandlet 记录含退出码异常，不能用“读取资产成功”覆盖进程失败。所有状态保留在 历史核验。
7. 历史结果怎样用于复盘
历史 buildings.csv 的 23 条记录可用于字段追踪；地图报告中的 Buildings 23、Terrain 6、Vegetation 631 用于说明历史检查内容。跨运行相同计数不证明文件身份相同，若要审计地图与 CSV 的一一对应，仍需同次运行标识、地图路径和实例明细。
改进评价应记录前后同条件任务、人工调整、失败次数和维护成本。用户材料中的生成耗时或批量提示数量属于历史经验，没有足够计时日志支撑本次复算；本章只提炼“结构化接口和可执行审计降低模糊性”的设计认识。
8. 迁移任务模板
下一项 TA 任务可以写：为建筑落地高度增加审计；读取该版本 BoundsMinZ、地形高度与导入约定；提交只读报告；检查至少一个非零轴心资产和一个坡地样本；真实 UE 运行单独记录。不得仅靠公式检查宣布视觉落地成功。
完整模板见 任务与交接。最小任务包包含需求、版本、样例、可修改范围、关键字段、检查方法、交付文件与未验证项。工程条件跨模型、算法、引擎交接时，保持同一个字段含义。
练习与验收
选择一条建筑记录，手算旋转中心偏移并用脚本复查。提交现象、错误假设、代码依据、正确公式和结果。另写一份完整案例卡，分开本次数据检查与历史引擎证据，并指出地图身份仍需怎样证明。
配套 18 页演示稿。该章是可追溯材料复盘和离线核对，不包含新生成的 UE 场景。