缩略图生成与缓存机制 (Thumbnails)
缩略图是 Sharp Stock 提供极速浏览体验的技术基石。系统深度整合了主进程图像处理引擎与渲染视口的实时预览能力，为图像、视频、音频、Spine 动画及 3D 模型等多种格式生成高清缩略图缓存。
1. 生成逻辑概述
- 增量自动生成：当您向资产库中导入新资产（或从剪贴板粘贴图像）时，系统会自动为这部分新增或变更的资源生成元数据与缩略图。
- 启动与手动扫描：系统提供“启动自动扫描”与“设置内全量扫描”。启动自动扫描会快速补充缺失的字段及缺失的缩略图；您也可以在“设置”中手动执行深度全量扫描，以彻底重新构建元数据并完整补齐所有缩略图。
2. 分类型生成策略
针对不同特性的资产，系统采用了优化的处理流程：
通用位图 (PNG, JPG, WebP 等)
- 由主进程调用高性能图像库直接进行缩放处理，确保在低分辨率下依然保留资产的核心视觉特征。
视频资产 (MP4, MOV, WebM 等)
- 精准截帧：系统会自动定位至视频时长的约 10% 处（或前 1 秒内）截取关键帧并保存为缓存。
- 生成时机：视频截帧同样在资产导入或启动/手动扫描阶段预先生成，避免在浏览滚动时动态截帧造成系统卡顿。
- 解码限制提示：部分特殊编码（如旧版 AVI、WMV）可能受限于系统解码器而无法截帧。详情请参考 视频资产管理。
Spine 2D 骨骼动画
- 利用内置的专业 Spine 运行时环境，在导入或扫描阶段通过后台渲染队列自动解析骨架数据与图集，并选取特征帧生成高保真预览。
3D 模型 (FBX, GLB, GLTF)
- 调用 3D 渲染引擎实时加载模型，在导入或扫描阶段通过后台渲染队列从默认透视视角渲染快照并保存为缓存图片。
音频资产 (WAV, MP3, OGG, M4A, FLAC, AAC 等)
- 波形可视化：系统解码音频并提取波形特征，渲染为波形缩略图并保存为 PNG 缓存。
- 生成时机：与视频、3D 模型类似，在资产导入或启动/手动扫描阶段通过后处理队列预先生成，避免滚动浏览时动态解码造成卡顿。
- 详情请参考 音频资产管理。
3. 手动维护与故障排查
若因外部文件替换或系统异常导致缩略图显示错误（如黑图、旧图），您可以通过以下方式进行修复。
缓存清理与重建
进入 [设置] → [维护与优化] → [重建缩略图]：
- 孤儿文件清理：系统将自动扫描并删除已不存在对应资产的冗余缓存文件。
- 自动补全：系统将尝试为缺失预览的图片与视频类资产重新生成缩略图；音频波形、Spine 与 3D 模型等元数据和缩略图也将通过后处理队列自动生成并补齐。
4. 性能与浏览建议
- 预生成机制：由于缩略图和元数据均采用预生成机制，因此在海量导入资源或首次扫描时，系统需要一定的处理周期。您可以通过界面上的进度提示了解处理进度，建议等待其处理完毕以获得完整的视觉预览。
- 占位符说明：如果卡片暂时显示为类型图标，代表该资产的缩略图尚未生成（例如在导入过程中排队，或在外部手动放入文件尚未执行扫描）。您可以执行“启动扫描”或点击“设置”中的扫描按钮来重新补全缩略图。
TIP
缩略图生成对 CPU 与磁盘 IO 有一定负载。在处理超大规模资源库时，后台生成过程可能会对系统响应速度产生轻微影响。