AI 搜索（以图搜图）

Sharp Stock 内置了完全在本地运行的 以图搜图（视觉搜索） 功能。您可以用一张参考图片找出视觉上相似的其他资产，非常适合查找风格相近的素材。

AI 搜索的所有处理（模型推理、索引、搜索）都只在本机进行，不需要联网，也不会把您的任何资产上传到服务器。

1. 首次使用：下载模型并创建索引

以图搜图依赖本地视觉搜索模型，并需要为当前资产库建立一次索引。首次使用时请按以下步骤操作：

点击左侧导航栏上方的 ⚙ 设置 图标，打开设置面板。
点击左侧的 AI 搜索 页签。
在「搜索模型」区域，选择下载源后点击 立即下载，等待视觉搜索模型下载完成。
在「当前资产库索引」区域，点击 创建索引。
- 首次创建索引会使用本地视觉搜索模型处理资产库中的全部资产，耗时取决于资产数量（数千个资产通常需要几分钟）。
- 创建过程中可以随时点击取消；取消后旧索引（如有）仍然可用。
- 索引创建完成后，即可开始使用以图搜图。

TIP

索引是保存在本机上的可重建缓存，不会修改您的资产、缩略图、描述或标签。

macOS 平台：在 macOS 14.0 (Sonoma) 及以上系统上，支持选择 CoreML 硬件加速 或 ONNX 引擎，默认使用 CoreML 硬件加速。使用 CoreML 时，系统会根据模型兼容性自动选用 Apple 硬件加速（CPU、GPU 或神经引擎）执行向量计算，速度更快且功耗更低；其中视觉模型使用 CPU 与 GPU 运行。对于 macOS 13 及更早版本，系统将自动采用 ONNX 引擎。
Windows 平台：默认自动采用 ONNX 引擎配合 DirectML GPU 硬件加速。

删除模型：模型可以随时删除，删除后需要重新下载才能继续使用 AI 搜索。已有的索引会被保留，仍可在设置页查看和删除。
完整重新索引：当资产库发生较大变化，或部分资产此前索引失败时，可点击 完整重新索引。它会重新处理全部资产并重试之前失败的项目；在完成之前，旧的索引会一直保留。
- 重新索引期间仍可正常导入、删除、移动、重命名资产，也可以修改描述和标签。Sharp Stock 会在新索引完成后自动补上这些变更，无需再次手动重新索引。
删除当前索引：会删除当前资产库的索引缓存。索引可以随时重新生成，不会影响任何资产。删除后该资产库的自动索引会关闭，防止下次启动时自动重建。
其他资产库索引：如果之前为其他资产库创建过索引，这里会列出它们及其占用空间，可单独删除以释放磁盘空间。

统一搜索框支持通过粘贴或拖入的方式设置参考图。任选以下方式设置参考图：

粘贴图片：复制一张图片（例如从图片编辑器或网页中复制），然后粘贴到搜索框中。
拖入文件/图片：将图片文件（PNG、JPG、WebP 等）或库内资产文件（如 FBX 3D 模型、Spine 动画等）直接拖入搜索框。若拖入的是库内非图片资产，系统会自动匹配并使用该资产已生成的缩略图作为参考图。
资产右键菜单：在任意资产上点击右键，选择 查找相似资产，会立即以该资产的预览图为参考进行搜索。

在搜索框中添加图片时，会自动清空原有文字并显示一个小缩略图。将鼠标移至缩略图上方可悬浮预览图片；缩略图右侧显示文件名（粘贴的图片则显示“剪贴板图像”）。随后点击搜索按钮即可开始搜索。结果按视觉相似度从高到低排列。点击搜索框内的 × 按钮可清除参考图。

NOTE

外部参考图片支持 PNG、JPG、WebP、BMP、GIF 格式，单张图片不超过 20 MiB；若拖入的是资源库内部已有的非图片资产（如 FBX 3D 模型、Spine 动画等），系统会自动关联其缩略图发起搜图。
使用资产右键菜单搜索或拖拽库内资产搜索时，不会对该资产做任何修改或重复导入。

模型未下载：会提示您前往「设置 → AI 搜索」下载模型。
索引未创建：会提示您前往「设置 → AI 搜索」创建索引。
索引损坏：AI 搜索会被禁用，并提示您重新索引，不会返回不完整的结果。
索引需要更新：更新到新的识别方式后，或有新增资产时，索引会显示“需要更新”。请前往「设置 → AI 搜索」执行“完整重新索引”。重新索引只更新本地搜索缓存，不会修改资产、缩略图、标签或描述，也不需要重新下载模型。普通资产导入或修改后，索引会在后台自动增量更新。

AI 搜索会联网吗？ 不会。模型下载完成后，搜索全程离线运行，不需要 API Key，也不会上传任何资产。
占用的磁盘空间有多大？ 模型占用空间取决于所选推理引擎；索引大小随资产数量增长（数千个资产通常为几十到几百 MiB）。可在「设置 → AI 搜索」中查看并删除模型与历史索引。
为什么创建索引很慢？ 首次索引需要逐批处理全部资产并生成向量，耗时与资产数量和电脑性能有关。这是只发生一次的过程，后续的增量更新会非常快。
删除索引会删除我的资产吗？ 不会。索引只是本机缓存，随时可以重新生成。