UeToolkit使用文档

快速开始

工程管理

• 集中式扫描：自动检索本地磁盘所有虚幻引擎项目，实现多版本工程的一站式导航与快速启动。

• 无损重命名：支持蓝图工程的一键重命名逻辑，通过自动化处理路径关联，确保重命名后不影响打包与部署（C++ 工程支持开发中）。

资产管理

• 多维资产支持：支持 CONTENT（资产包）、PLUGIN（插件）、PROJECT（完整工程）以及 OTHERS（通用多媒体）四种包装结构的统一入库。

• 自动元数据识别：入库时自动分析资产结构，识别其对应的虚幻引擎版本及资产类型，减少人工维护成本。

• 资源整理优化：内置智能过滤机制，支持自动解压、去重及广告文件过滤，保持资产库纯净。

AI助手

• 逻辑审计：利用 AI 对库内资产进行深度解析，支持针对单个资产或整个资产库的结构化分析。
• 蓝图分析 (UE 5.4)：基于 Socket 通信与 UE 插件联动，支持对 5.4 版本蓝图进行只读模式的逻辑分析与故障诊断。

配置工具

• 配置镜像化：支持对项目的个人偏好 (User Preferences) 及项目设置 (Project Settings) 进行快照保存。
• 一键同步：实现配置在不同工程间的快速应用，目前已完美适配 UE4 环境的开发流。

1. 工程管理

首次打开工具箱时会扫描工程，加载会慢一些，扫描完成后如图：

右键菜单支持功能如下：

2. 资产管理

2.1 添加资产

支持拖入添加和通过工具箱添加，添加资产支持两种格式：压缩包和文件夹，这两种格式工具箱都会自动识别资产类型，可识别的类型有资产包、插件、项目、模型、其他资源。

不论是压缩包或者文件夹，都会智能识别资产类型，省去了添加资产时需要手动的解压调整到合适的结构才可以导入的麻烦。

添加时如果勾选创建说明文档，则会在添加时自动创建一个说明文档，鼠标左键单击资产卡片即可打开，如果没有勾选，后续想创建则可以通过鼠标左键单击资产卡片创建。

添加成功后会出现添加的资产卡片（注：现在资产还是没有缩略图的，后面会介绍如何设置缩略图）。

2.2 预览资产

预览资产首先需要创建预览工程并设置。

首先创建一个预览工程：

创建好预览工程后，打开工具箱的设置->资产设置->添加预览工程：

设置好之后回到资产库界面，点击资产卡片中的预览资产：

选择要使用的预览工程：

可以看到这是预览的资产包：

打开资产没有损坏和其他问题，可以正常预览：

2.3 设置资产缩略图

目前只支持资产包与项目资产的缩略图设置。

首先预览想要设置缩略图的资产。

有两种设置缩略图的方式：

• 第一种是预览时调整到合适的位置，直接退出，会自动设置缩略图，这种设置方式每次预览资产的时候缩略图都会变
• 第二种是永久缩略图，接下来介绍如何设置永久缩略图

预览资产后将其调整到合适的角度，进行高分辨率截图，然后关闭工程，即可设置永久缩略图：

可以看到缩略图已经设置成功：

2.4 导入资产

导入资产时点击资产卡片上的导入图标会打开工程选择界面，会自动筛选可以使用当前资产的工程：

点击导入工程按钮即可成功导入。

3. AI助手

3.1 AI助手配置

AI助手支持现在主流的模型供应商配置和BYOK自定义供应商配置、ollama，只需输入密钥即可，自定义配置需要输入URL。

打开设置->AI助手，输入密钥，然后保存配置即可：

简单的测试一下：

可以看到对资产进行了详细的分析。

3.2 蓝图分析

蓝图分析（目前只支持UE5.4）

蓝图分析需要配合插件使用，首先将插件放在工程的Plugins文件夹下，如果是C++工程，将插件放好之后编译一下，如果是蓝图工程，将插件放好后右键工程文件，点击如图所示的选项对插件进行编译：

4. 配置工具

配置工具可以提取已有工程的配置将其应用到其他工程，可以提取的配置包括两类：项目配置和编辑器偏好设置。

添加好配置后鼠标左键单击，即可选择要应用的工程，应用时注意版本：

应用时可以选择备份原来的配置，如果出现问题可以进行回滚：

5. 问题反馈

如果有问题可以点击工具箱左下角的问题反馈按钮进行反馈，或者加入官方交流群@群主

QQ群：1048699469