SoTool AI 智能图搜图系统

第1章 产品介绍

1.1 功能概述

SoTool 是一款基于 AI 视觉大模型的本地化以图搜图工具，支持从本地图片库中快速检索相似或相关图片，广泛适用于电商商品管理、图库归档、监控系统等多种应用场景。

1.2 系统要求

第2章 安装与激活

2.1 安装软件

1. 双击安装包 SoTool_Setup_v1.0.0.exe，打开安装向导。
2. 选择安装路径（默认推荐路径），点击「下一步」。
3. 根据需要勾选「创建桌面快捷方式」，点击「安装」。
4. 安装完成后，勾选「立即启动 SoTool」，点击「完成」。

2.2 激活授权

首次启动软件后会弹出登录对话框。您可以通过以下方式激活：

第3章 图片管理

3.1 导入文件夹

将本地文件夹中的图片批量导入图片库，同时完成特征向量索引建立。

1. 点击底部操作区的「导入文件夹」按钮。
2. 在弹出的文件选择对话框中，选择包含图片的文件夹（支持 jpg、png 等格式）。
3. 系统开始扫描并逐张处理图片，底部进度条显示导入进度。
4. 导入完成后，图片库区域显示所有入库图片缩略图。

3.2 USB 摄像头截取

直接通过 USB 摄像头实时截取画面，加入图片库。

1. 点击底部操作区的「摄像头截取」按钮。
2. 弹出摄像头预览窗口，实时显示摄像头画面。
3. 点击「截图」按钮，截取当前画面并添加到图片库。
4. 点击「关闭」退出摄像头窗口。

3.3 Excel 批量导入

通过 Excel 文件批量导入图片，支持关联图片路径与扩展字段信息（SKU、规格、颜色、品牌、仓库位置等）。

1. 点击底部操作区的「Excel导入」按钮。
2. 系统弹出文件选择对话框，选择 Excel 文件（支持 .xlsx 格式）。
3. 系统读取 Excel 内容，显示导入预览。
4. 确认无误后，点击「确认导入」，系统开始处理。

3.4 图片信息编辑

入库后的图片支持查看和编辑扩展字段信息。选中图片后点击「编辑详情」按钮，可弹出详情编辑面板进行修改。

1. 在图片库中点击选中某张图片。
2. 点击右侧操作区的「编辑详情」按钮。
3. 弹出详情编辑窗口，可编辑标签、描述及所有扩展字段。
4. 编辑完成后，点击「保存」按钮同步到数据库。

第4章 以图搜图

4.1 发起搜索

1. 在左侧搜索区域，点击「上传图片」按钮，选择待搜索的图片。
2. 图片上传后，搜索区域显示图片预览。
3. 点击「开始搜图」按钮，系统自动提取图片特征并搜索相似图片。
4. 搜索完成后，中间区域显示搜索结果，按相似度从高到低排列。

4.2 查看搜索结果

搜索结果区域显示所有相似图片，每张图片下方标注相似度分值。

• 点击任意结果图片，可放大查看高清图。
• 点击图片旁的「查看详情」可查看扩展字段信息。
• 点击「导出结果」可将本次搜索结果导出为 Excel 表格。

第5章 增量更新索引

5.1 增量更新说明

当图片库中新增或删除了图片后，无需全量重建索引，可使用增量更新功能快速同步索引文件，保持搜索结果与图片库一致。

5.2 操作步骤

1. 点击底部操作区的「执行增量更新」按钮。
2. 系统自动扫描图片库与索引文件的差异。
3. 若有新增图片，系统提取特征向量并追加到索引文件。
4. 若有已删除图片，系统从索引中移除对应记录。
5. 更新完成后，底部状态栏显示索引同步完成提示。

第6章 API 接口服务

⚠️ API 服务为定制服务，需联系开发商开通。

6.1 启动 API 服务

SoTool 内置 HTTP API 服务，允许第三方系统通过 HTTP 请求调用以图搜图能力。

1. 点击底部操作区的「启动 API 服务」按钮。
2. 系统显示服务启动状态和访问地址，例如：http://localhost:8880
3. 服务启动后，保持 SoTool 主程序在后台运行。

6.2 接口调用示例

curl -X POST -F "image=@test.jpg" http://localhost:8880/api/search

{
  "code": 0,
  "results": [
    {"path": "C:/images/001.jpg", "score": 0.95, "label": "商品图"}
  ]
}

第7章 常见问题