© mengzhishanghun · 原创文章
首发于 博客园 · 禁止未经授权转载
UE：如何让 AI 直接修改 DataAsset
前言
AI 正在深度介入游戏开发流程。让 LLM 生成关卡配置、用强化学习自动调平衡数值、通过 AI 迭代游戏参数——这些场景都有一个共同的前提：AI 必须能直接读写游戏数据。
在 UE 中，大量游戏数据以 DataAsset 的形式存在：技能表、角色属性、掉落表、AI 行为参数。但 DataAsset 本质是 UE 的序列化二进制文件（.uasset），外部工具无法直接处理。AI 生成的结果只能由人手动搬进编辑器——当 AI 的迭代速度越来越快时，人工搬运就成了瓶颈。
这篇文章记录了我解决这个问题的完整思路：从选择中间格式，到踩过的技术坑，到最终封装成一套自动化方案。即使你不打算用现成工具，这些经验对自己搭建类似管线也会有帮助。
为什么是 JSON
在 DataAsset 和外部工具之间架桥，需要一种双方都能处理的中间格式。CSV、XML、YAML 都能用，但综合考虑下来 JSON 是最务实的选择：
- 几乎所有编程语言和 AI 框架原生支持
- 人类可读，方便调试
- 支持文本 diff，代码审查时可以清晰看到每个字段的变化
- 结构灵活，能表达 UE 中常见的嵌套数据类型
UE 内置的 JSON 序列化能力
很多人不知道，UE 引擎内置了一套相当完善的 JSON 序列化机制。核心是 FJsonObjectConverter 这个工具类，提供了两个关键函数：
- UStructToJsonObject：将任意 UStruct（包括 DataAsset 的所有 UPROPERTY）序列化为 FJsonObject
- JsonObjectToUStruct：反向操作，将 FJsonObject 反序列化回 UStruct
它能处理绝大多数 UPROPERTY 类型：基本类型、FString、FName、枚举、嵌套 UStruct、TArray、TMap、TSet，甚至软引用（FSoftObjectPath）。
如果你只需要单向、手动触发的导出或导入，到这里就够了。 写个编辑器工具按钮，点一下导出 JSON，AI 改完再点一下导入，功能上完全可行。
但如果你需要自动化的双向同步——编辑器里改了 DataAsset 自动更新 JSON，AI 改了 JSON 也自动更新 DataAsset——事情就复杂得多了。
做双向同步会踩哪些坑
我在实现自动双向同步的过程中遇到了几个不太直觉的问题，逐个拆解。
浮点数精度丢失
这可能是最容易忽略、也最危险的问题。
UE 默认的 JSON 序列化对浮点数使用的格式化精度不够。编辑器里设置的 0.3，导出到 JSON 后可能变成 0.30000000000000004。对于数值敏感的游戏参数（伤害系数、概率权重、物理参数），这种精度漂移不可接受。
解法是自定义 JSON 的 PrintPolicy。对 float 使用 %.9f（9 位小数），对 double 使用 %.17g（17 位有效数字，IEEE 754 双精度的完整精度）。这样可以保证 DataAsset → JSON → DataAsset 的往返转换后数值完全一致。
属性名首字母大小写不一致
FJsonObjectConverter 在序列化时会将属性名的首字母转为小写——编辑器里的 MaxHealth 导出后变成 maxHealth。
这不只是美观问题。AI 读到 JSON 中的 maxHealth，再看编辑器里的 MaxHealth，字段名对不上会增加理解成本。更麻烦的是，如果 AI 按编辑器里看到的名字写了 MaxHealth 到 JSON，反序列化时可能匹配不上。
解决方案是在导出后递归遍历 JSON 对象的所有字段，将首字母还原为大写；导入前做反向转换。
循环触发
双向同步最经典的陷阱：
- 用户在编辑器里改了 DataAsset
- 监听到变化，自动导出写入 JSON
- 文件系统检测到 JSON 变化
- 监听到变化，自动导入更新 DataAsset
- 回到步骤 2，无限循环
要打破循环，需要两层防护：
- 全局同步标记：同步进行中设为 true，所有事件处理器在入口检查该标记，为 true 则跳过
- 自写入路径追踪：导出 JSON 时记录写入的文件路径；当文件系统报告变化时，如果路径在追踪列表中，跳过处理并移除记录
只用全局标记不够——因为文件系统的变化通知是异步的，可能在同步标记复位后才到达。自写入追踪才是杜绝循环的关键。
版本控制文件锁定
使用 Perforce 等版本控制系统的团队中，.uasset 文件默认只读。JSON 变了需要更新 DataAsset 时，不先 Checkout 写入会直接失败。
UE 提供了 ISourceControlModule 接口，可以在写入前自动执行 Checkout 操作，对 Perforce、Git、SVN 都适用。需要注意的是要先检查版本控制模块是否启用——不是所有项目都配了版本控制。
同步方向判断
编辑器启动时，DataAsset 和 JSON 可能都有变化（比如 AI 在编辑器关闭期间修改了 JSON）。需要判断「谁是最新的」。
比较可靠的方式是对比 .uasset 和 .json 的最后修改时间，谁更新就以谁为准。这在绝大多数场景下是正确的，因为通常只有一端在某个时间段内被修改。
其他工程细节
除了上面的核心问题，生产可用的同步机制还要处理不少边角：资产删除时清理对应 JSON、导出前比对内容避免无意义写入、JSON 导入包在 FScopedTransaction 里支持撤销重做、IDirectoryWatcher 的生命周期管理防止悬空回调……把这些加在一起，工作量已经不小了。
AIDataAsset：打包好的方案
如果你不想自己实现这些逻辑，可以试试我开发的 AIDataAsset 插件。它把上面提到的所有问题——浮点精度、属性名还原、循环防护、版本控制集成、智能写入——都封装成了开箱即用的方案。
使用方式很简单：在 Project Settings 中找到 AIDataAsset 分类，指定 JSON 存放目录，打开自动同步开关即可。所有 DataAsset 子类自动参与同步，无需编写代码。
在 Fab 搜索「AIDataAsset」即可获取。支持 UE 5.2+，Windows / macOS / Linux。
实际应用场景
AI 驱动的游戏数据迭代：让 LLM 或强化学习系统直接读写 JSON 来调整游戏参数。AI 改完 JSON，DataAsset 自动更新，编辑器中立即可以运行测试。一轮迭代从「AI 生成 → 人工搬运 → 测试 → 反馈」缩短为「AI 生成 → 测试 → 反馈」。
策划批量调参：策划导出 JSON 后用 Excel 或 Python 脚本批量修改，改完放回去自动同步。比在编辑器里逐个打开 DataAsset 手动改高效得多，尤其是涉及数十上百个资产的全局调整。
数据审查与版本对比：JSON 是文本文件，天然支持 Git diff。提交前可以清楚看到「这次改了哪些资产的哪些字段」，比审查 .uasset 的二进制变更直观得多。对于需要策划/程序交叉审核数据变更的团队尤其有用。
感谢阅读，欢迎点赞、关注、收藏，有问题可在评论区交流。
如果本文对你有帮助，点击这里捐赠支持作者。