资产导入与导出

AssetLibrary 提供了一套极简且符合直觉的导入导出系统，旨在无缝连接您的操作系统、设计软件及版本控制工具。

1. 资产导入

将外部资源引入资产库主要通过拖拽 (Drag & Drop) 方式实现，系统会自动根据目标位置决定操作逻辑。

操作方式

• 拖入网格区：将文件从资源管理器拖入中间的资产网格。
  • 结果：文件将以复制 (Copy) 模式导入到当前选中的文件夹下。
• 拖入文件夹树：将文件或文件夹拖入左侧特定的目录节点。
  • 结果：文件将以复制模式存入该指定目录。

导入流程与细节

1. 路径解析：系统会自动获取拖入文件的绝对路径。
2. 过滤内部资产：如果拖入的文件已经是资产库内的文件，系统会将其视为“内部移动”而非“重复导入”。
3. 元数据生成：导入完成后，系统会自动触发全量或局部扫描：
   • 提取文件基本信息。
   • 自动生成高清缩略图。
   • 如果是图像，自动解析分辨率。
4. 刷新视图：界面会立即更新，新导入的资产将出现在列表顶部（取决于排序设置）。

[App截图：从 Windows 资源管理器将图片拖入 AssetLibrary]

---

2. 资产导出

导出功能允许您将库中的资源快速同步到其他工作软件中，无需手动去磁盘路径寻找。

操作方式

• 原生拖拽导出：在资产网格中选中一个或多个资产，按住左键直接拖出 AssetLibrary 窗口。
• 目标支持：
  • 资源管理器：在文件夹中释放，即完成文件的物理复制/移动。
  • 专业软件：支持直接拖入 Photoshop、Cocos Creator、Unity 等软件。
  • 聊天工具：支持拖入飞书、钉钉等作为附件发送。

导出逻辑

• 当您开始拖拽时，AssetLibrary 会在系统中注册选中的物理文件路径。
• 对于某些特定合集（如 Sprites），导出时会自动处理关联的所有帧文件。

[App截图：拖拽 Spine 资产到 DCC 软件中]

---

3. 支持的文件类型与结果

类型	导入支持	操作结果说明
通用图像	PNG, JPG, WebP	复制到目标目录，生成缩略图，解析宽高。
Spine 动画	.skel, .json, .atlas	自动识别关联文件，整体移动，并尝试进行 Spine 运行时预览。
音频文件	WAV, MP3	提取时长信息，导入后可在预览区播放。
文件夹	任何目录	递归复制文件夹内所有受支持的资源，保持原有层级结构。
3D 模型	FBX, GLB, GLTF	导入并准备 3D 交互预览。

---

4. 注意事项

• 内部移动 vs 外部导入：
  • 在文件夹树之间拖拽文件夹/资产属于移动 (Move)，会改变文件在磁盘上的真实存储层级。
  • 从外部软件/资源管理器拖入则属于复制 (Copy)。
• SVN 状态：导入新文件后，如果是受 SVN 管理的库，该文件会自动处于“未版本化 (Unversioned)”状态，图标会显示对应的绿色加号。
• 命名规范：建议导入前确保文件名不包含系统非法字符，AssetLibrary 在导入过程中会尝试自动规范化文件名。

TIP

如果您一次性导入了大量资源，建议点击左侧顶部的“手动扫描”按钮，确保数据库和缩略图缓存完全同步。