资产定位和路径管理
AssetLibrary 的工作核心是高效管理文件在磁盘上的物理位置与逻辑关联。理解系统的路径管理逻辑有助于您更稳健地维护大型资源库。
1. 相对路径 vs 绝对路径
- 绝对路径 (Absolute Path)：指文件在计算机上的真实位置，例如
D:\Projects\GameA\assets\characters\hero\run.skel。 - 相对路径 (Relative Path)：指资产相对于您的「资产库根目录 (Library Root)」的路径。例如在上述例子中，相对路径为
characters/hero/run.skel。
AssetLibrary 的设计准则：数据库中优先存储相对路径。这意味着只要您保持库内部的目录结构不变，将整个库文件夹从 D盘 移动到 E盘，重新选择库根后，所有的标签和描述依然能自动对应上。
2. 资产定位工具
为了让您在海量层级中不迷失，多处提供了定位功能：
视图联动定位 (Locate)
- 操作：在资产网格中右键资产 -> 定位到文件夹 (快捷键 Ctrl + G)。
- 效果：系统会驱动左侧树形文件夹自动展开所有层级，并将视图滚动到目标位置，最后高亮显示该文件夹。
外部资源管理器定位
- 操作：右键资产 -> 在资源管理器中显示。
- 效果：立即打开 Windows 资源管理器窗口并选中对应的物理文件。这对于后续的重命名、压缩、发送给他人非常有用。
[App截图：定位功能在主界面中的位置]
3. 路径剪贴板功能
资产右键菜单提供了多种路径复制格式，满足开发、策划及交流的不同需求：
| 功能 | 格式示例 | 适用场景 |
|---|---|---|
| 复制资产链接 | assets/hero.png | 内部引用、代码配置、逻辑指向。 |
| 复制磁盘路径 | D:\Project\assets\hero.png | 文件发送、外部软件直接打开、脚本批处理。 |
| 跳转协议链接 | sharp-stock://hero.png | 企业微信/钉钉/飞书文档，点击直接调起应用跳转。 |
4. 路径变更处理
当您在 AssetLibrary 外部执行文件系统操作时，可能会产生以下结果：
- 文件删除：扫描后，数据库中该路径的记录会被标记为失效。
- 文件重命名/移动：系统会将其视为“一个资产消失，另一个新资产出现”。
- 建议：为了保留标签和描述，请务必在 AssetLibrary 内部进行重命名或移动操作。在应用内拖拽资产到其他文件夹，系统会智能更新路径并保留所有关联的元数据。
5. FAQ：如果我的路径显示为红色？
如果资产列表中的路径或名称显示异常，通常是因为该文件在磁盘上已不存在但在数据库中仍有记录。此时请执行一次「资产库管理 -> 扫描资产库」来更新索引。