缩略图生成

缩略图是 AssetLibrary 提供极速浏览体验的核心保障。系统内置了一套多线程、多协议的缩略图生成引擎，能够自动处理从普通图片到复杂 3D 骨骼动画的预览需求。

1. 缩略图生成机制

• 全自动异步处理：当您进入一个文件夹或导入新资产时，系统会启动后台扫描任务。对于没有有效缩略图的资产，引擎会自动将其加入生成队列。
• 持久化缓存：生成的缩略图文件（通常为 256x256 像素）会持久化存储在系统特定的缓存目录中。即使您关闭应用，下次打开时也能瞬间加载，无需重新计算。
• 增量更新：如果资产文件的修改时间 (mtime) 发生变化，引擎会自动识别并重新生成该资产的缩略图。

---

2. 专项生成策略

不同类型的资产采用不同的渲染方案：

通用图像 (PNG, JPG, WebP)

• 系统直接调用高效的图像处理器，提取原始图片并按比例缩小。
• 画质优先：即使是极小的缩略图也会进行平滑处理，确保美术细节可见。

Spine 2D 骨骼动画

• 这是 AssetLibrary 的特色功能。系统内置了一个轻量级的 Spine 渲染环境。
• 它会加载 .skel / .json 文件及对应的图集，寻找默认皮肤和第一个有效动作。
• 自动抓取 Spine 动画的第一帧（或指定帧）作为预览图。

图集与 PList

• 提取合图的主图片，通过智能算法选取能够代表图集内容的区域作为缩略图。

3D 模型

• 加载 FBX / GLB 模型，通过默认摄像机角度捕获模型的静态外观。

[App截图：Spine 缩略图自动生成的网格效果预览]

---

3. 手动维护与故障排查

虽然过程是自动的，但某些极端情况下（如显卡驱动异常、磁盘文件移动）可能出现缩略图损坏或黑色方块。

一键清理与补全

进入 「设置 -> 资产库管理 -> 清理缩略图」。

• 系统会对比数据库与磁盘缓存，清理掉那些已被删除资产留下的“孤儿”缩略图。
• 强制重新验证并补全当前所有可见资产的缩略图。

强制更新

如果某个 Spine 动画更新了动作，但缩略图停留在旧版本，您可以右键该资产 -> 选择「重新生成预览图」。

---

4. 性能优化提示

• 扫描深度：生成大批量 Spine 缩略图时会占用一定的 GPU 资源。建议在首次加载大型资源库时，给系统一些处理时间。
• 存储空间：数万个资产的缩略图可能会占用几百 MB 的磁盘空间。如果您的 C 盘空间紧张，可以定期在设置中执行「清理」。

TIP

缩略图的生成状态会实时反映在资产卡片上。如果看到旋转的加载图标，说明它正在排队等待处理。