AssetLibrary 核心功能指南

本指南将深入介绍 AssetLibrary 的日常核心操作。

1. 资产导入与库管理

AssetLibrary 的库管理是基于本地文件系统的“非侵入式”管理。

• 选择根目录：首次运行或点击设置，选择您本地项目的文件夹作为“资产库”。应用会自动扫描并建立索引。
• 实时同步 (Live Sync)：当您通过系统资源管理器添加、删除或修改文件时，AssetLibrary 会自动感知并在界面上即时刷新。
• 全量重新扫描 (Deep Scan)：在设置菜单中，您可以执行深度扫描，以确保库中的缩略图和数据库状态与最新文件系统保持一致。

2. 标签系统 (Tag System)

通过标签系统，您可以打破传统的文件夹层级，实现跨目录的资产组织。

• 添加标签：
  • 在详情面板输入新标签名并回车，或在已有标签列表中勾选。
  • 批量标记：选中多个资产，通过详情面板一次性为它们应用相同的标签。
• 标签筛选：
  • 在中间视图区域的过滤面板中，可以通过点击标签来筛选包含这些标签的所有资产。
• AI 辅助标记 (AI Tagging)：
  • 选中 Spine 或图片资产，点击详情面板中的 AI 图标，应用将尝试识别资产内容并自动推荐合适的标签。

3. 高级搜索 (Advanced Search)

AssetLibrary 不仅支持文件名搜索，还提供了一套强大的搜索语法。

• 基础搜索：在顶部搜索框输入文件名。
• 类型搜索 (type:)：
  • type:spine - 查找所有 Spine 动画。
  • type:audio - 查找所有音频文件。
  • type:atlas - 查找所有纹理图集。
• 标签搜索 (tag:)：
  • tag:character - 查找标记为 "character" 的所有资产。
• 组合搜索：
  • type:spine tag:boss - 查找标记为 "boss" 的 Spine 动画。

4. 资产预览 (Deep Preview)

针对不同类型的游戏资产，AssetLibrary 提供了量身定制的预览方案。

• Spine 动画 (.skel)：
  • [占位符：Spine 预览器截图]
  • 支持皮肤 (Skins)、动画 (Animations) 的列表切换。
  • 播放/暂停控制，循环播放选项。
• 纹理图集 (.atlas, .plist)：
  • [占位符：图集预览器截图]
  • 直接在界面上平铺查看图集内容，并能查看子图的名称、位置和尺寸。
• 音频文件 (.mp3, .wav)：
  • [占位符：音频波形预览器截图]
  • 自动生成音频波形，支持实时播放。
• 常规图片 (.png, .jpg, .webp)：
  • 支持高清缩放预览，查看图片的分辨率和详细元数据。

---

TIP

资产库会定期清理无效的缩略图缓存，以节省您的磁盘空间。