这个项目能做什么

Unreal Engine 5 的 uasset-workbench 插件提供了一种由命令行驱动的工作流，使外部脚本和 AI 代理能够在不打开编辑器的情况下与二进制 .uasset 文件进行交互。它将引擎数据结构化为位于 Intermediate/UAssetExport 下的 JSON 文件，涵盖了 Blueprints、动画资产、控件布局、数据表、材质、纹理、Niagara 系统、行为树和关卡 Actor。操作被分为 Export、Import、Edit、Migrate 和 Audit 五组，每组都通过一个返回 0-3 状态码的统一合约进行访问。该插件可以在已打开的编辑器会话中运行，或者在编辑器关闭时启动 headless commandlet，其中仅限写入的操作组要求编辑器必须在场。导出的 JSON 包含版本和类型字段，并保留了节点连接、变量元数据、动画曲线、材质表达式链和控件树属性等细节。Import 和 Edit commandlets 接受一个 spec JSON 以修改或重建资产，而 Migrate 用于在重命名后修复引用重定向，Audit 则生成可作为提交门禁（commit gates）的只读报告。一个包装脚本简化了调用过程，可传递引擎路径、项目文件、运行名称、资产列表以及可选的超时时间。这种设计实现了可版本控制、可重现的更改，以及针对 AI 辅助开发流水线的 UE5 内容自动化审计。