资产管理工具

简介

资产管理工具是一套用于管理游戏资产的功能，包括迁移资产到新位置、创建和管理资产链接文件、以及资产优化等操作。

注意：

在使用本工具前，请先阅读引擎的链接文件相关功能介绍： 链接文件 。

重复资产

本工具仅在用户文件夹与游戏文件夹一致时可用，因此所有操作都会直接作用于现有文件。通常，开发者用于对资产去重，对于 mod 制作需求较少。

添加文件

你可以手动添加想要移动到通用 /assets 文件夹的文件，如果当前列表中能找到其他重复项（通过内容哈希判定），它们会被合并到对应的重复项之下。但我们**推荐使用“搜索全游戏重复文件”**来自动生成这一列表，因为这样能够找到游戏内的所有重复项。

保存列表

将当前重复文件列表保存，以便之后处理。注意：该列表在资产发生移动/删除/新增时不会自动更新，只反映扫描当时的文件和哈希。如果你更新了 svn，这份列表可能与硬盘内容不一致，因此需要重新扫描和生成。

加载列表

从本地加载重复资产列表（会清空当前的列表）。

清空列表

清除当前的重复资产列表（不会删除本地已有的列表，你随时可以再次加载。如果想连本地列表一起清除，清空后请再点击“保存列表”）。

搜索全游戏重复文件 - ［推荐的去重方法］

此操作将在所有游戏数据文件夹中，查找所选文件类型的所有重复资产。过程较耗时，因为会为整个游戏的每个资产计算内容哈希，再比较、汇总重复项。

在指定文件夹中查找列表内资产的重复项

此操作会在特定文件夹（如/ art 等）中，为列表里已有的资产查找其重复项。例如你的列表已有 42 项，选择某个文件夹扫描这些项的重复文件，若找到重复项，则会自动加入到列表中。

开始迁移

点击后将启动资产迁移和去重流程。操作首先会在各个重复文件当前位置生成一个 .link 链接文件，然后将第一个（列表顶部）的原文件复制到你指定的新路径（通常在 /assets 文件夹中），其余重复项全部删除，最终只保留 /assets 下的一个实际文件和其它位置的 .link 链接文件。

跳过未指定目标路径

勾选后，会跳过那些目标路径为 UNDEFINED 的记录（即用户尚未为其设置目标路径的项）。如未勾选，则发现有任何记录目标路径为 UNDEFINED 就会中止迁移流程，并弹出错误提示。

设置目标文件夹路径

你可以批量选中列表中的多条记录，然后一次性设置它们的目标文件夹路径。例如选中了多张贴图资源，想让它们都移入 /assets/textures/bricks，此时就在输入框中填写该路径并点击按钮。此操作仅会替换所有所选项目目标路径中的“文件夹”部分，保留各自的文件名不变。

链接检查器

链接检查器标签页

检查无效链接

会在所有游戏文件夹内扫描并检测无效的链接文件。无效链接是指，它们所指向的目标资产路径已经不存在。

删除所有无效链接文件

对那些指向无效目标资源路径的链接文件（物理硬盘上的 .link 文件）进行批量删除。

尝试修复无效链接

会遍历 /assets 文件夹下的所有资产，通过哈希比对与链接文件保存的哈希值。如匹配成功，则自动修复该 .link 文件中存储的目标路径。

命名检查器

命名检查器标签页

该工具用于批量扫描和检查无效的文件名。命名规则为：仅允许小写字母、数字和下划线。工具会根据规则建议一个合规的新文件名，你可以一键复制推荐名并手动重命名（注意避免正在被 mod 或其他内容引用的资源直接改名）。

默认扫描路径为 /assets，你也可以选择其他文件夹进行检查。

解链工具

解链器标签页

解链工具会递归地在指定文件夹中，将链接文件所指向的真实文件复制到对应的链接文件旁边（与链接文件同目录，同名但无 .link 后缀）。这样在加载资源时，实际文件会优先生效，链接文件则会被忽略。通过这种方式，你可以方便地发送关卡或 mod，不必担心链接指向的外部文件，所有内容现在都本地化于该文件夹中。

解链工具不会删除链接文件，因为没有必要，资源引擎加载时会优先加载它们旁边的同名实际文件（不带 .link 扩展名）。

这些链接文件将被重链工具使用。重链工具会删除链接文件旁边的实际资产文件，使链接重新生效成为优先加载项。

如果在执行解链项操作时，发现无法找到需要复制到链接文件旁边的资产路径，该项操作会失败，并以红色“FAILED”标记。

重链工具

重链器标签页

重链工具会递归扫描指定文件夹，删除所有在链接文件旁边找到的实际资产文件，从而恢复链接文件为优先生效（即使用链接内记录的内部路径）。

为防止意外问题，被删除的资产文件会存储到游戏根目录下的 __relinkN 文件夹（N 为过程计数，每次重链自增），并保持它们原有路径结构。这样不会丢失任何资产，用户可以自主删除这些文件夹，或在需要时恢复旧文件（比如要取回被修改过的版本）。采取这种措施是出于数据安全考虑，避免完全不可逆的破坏性操作。

重链操作可能出现失败，例如磁盘空间不足、无法复制文件到备份文件夹、或无法删除链接旁的资产文件。出现失败时会以红色“FAILED”状态提示。