缩略图生成与缓存机制 (Thumbnails)
缩略图是 Sharp Stock 提供极速浏览体验的技术基石。系统深度整合了主进程图像处理引擎与渲染视口的实时预览能力，为图像、视频、Spine 动画及 3D 模型等多种格式生成高清缩略图缓存。
1. 生成逻辑概述
- 异步任务队列：当您进入文件夹、导入新资产或刷新列表时，系统会自动将缺失预览的资源加入任务队列。静态图片由后台引擎统一执行缩放，并持久化写入库内的
thumbnails目录。 - 持久化本地缓存：缩略图一旦生成即永久存储于资产库目录中。即使关闭应用后再次开启，系统也能实现瞬间加载，无需重复解码原始大图。
- 视图关联生成：对于 Spine 动画、3D 模型及视频等复杂资产，系统采用“按需生成”策略，即仅对当前主视图网格可见区域内的资产卡片执行预览生成任务。
2. 分类型生成策略
针对不同特性的资产，系统采用了优化的处理流程：
通用位图 (PNG, JPG, WebP 等)
- 由主进程调用高性能图像库直接进行缩放处理，确保在低分辨率下依然保留资产的核心视觉特征。
视频资产 (MP4, MOV, WebM 等)
- 精准截帧：系统会自动定位至视频时长的约 10% 处（或前 1 秒内）截取关键帧并保存为缓存。
- 可见性优先：视频截帧仅针对当前屏幕内的条目。未滚动到的区域将暂时显示视频格式图标，待进入视野后自动触发。
- 解码限制提示：部分特殊编码（如旧版 AVI、WMV）可能受限于系统解码器而无法截帧。详情请参考 视频资产管理。
Spine 2D 骨骼动画
- 利用内置的专业 Spine 运行时环境，在渲染进程中加载骨架数据与图集，自动选取特征帧生成高保真预览。
3D 模型 (FBX, GLB, GLTF)
- 调用 3D 渲染引擎实时加载模型，从默认透视视角渲染快照并保存为缓存图片。
3. 手动维护与故障排查
若因外部文件替换或系统异常导致缩略图显示错误（如黑图、旧图），您可以通过以下方式进行修复。
缓存清理与重建
进入 [设置] → [维护与优化] → [重建缩略图]：
- 孤儿文件清理：系统将自动扫描并删除已不存在对应资产的冗余缓存文件。
- 自动补全：主进程将尝试为缺失预览的图片类资产重新生成缩略图；Spine 与 3D 模型等则将在您下次浏览网格视图时自动补齐。
4. 性能与浏览建议
- 排队机制：在大规模导入资源后，缩略图生成需要一定的处理周期。条目极多时，建议稍作等待以获得完整的视觉预览。
- 占位符说明：在快速滚动列表时，若卡片暂时显示为类型图标或加载动画，这代表该资产正在队列中等待处理或尚未进入可见生成批次。通常在轻微滚动或停留片刻后即可完成更新。
TIP
缩略图生成对 CPU 与磁盘 IO 有一定负载。在处理超大规模资源库时，后台生成过程可能会对系统响应速度产生轻微影响。