操作说明搜图工作台
修复数据库索引
当搜索结果异常、统计数量不一致,或需要为已有图片重新生成图搜图、姿势、语义、人脸等特征时,使用修复数据库重建索引。
选图汪本机搜图团队2026-09-156 分钟阅读

当搜索结果异常、统计数量不一致,或需要为已有图片重新生成图搜图、姿势、语义、人脸等特征时,使用修复数据库重建索引。
修复数据库用于检查已有素材的搜索数据和索引一致性。它适合排查图片已经在库里但搜索异常、特征备份与索引不一致等情况。不同策略的修复范围不同,不能把修复完成当作所有缺失特征都已补齐。

操作步骤
- 进入搜图工作台后,确认左侧处于「文件」页签。
- 在左侧「数据库」标题旁点击三点按钮。
- 在菜单中点击「修复数据库」,打开修复窗口。
- 在「请选择数据库」里选择要修复的数据类型。
- 如果选择「图数据库」,确认下方「选择策略」里的策略是否符合本次要修复的能力。
- 点击「开始」。窗口关闭后,顶部任务区域会显示修复进度。
- 等任务完成后,再查看数据库统计信息或重新搜索确认结果。

该选哪个数据库
- 「图数据库」:修复以图搜图相关能力,包括全局、全局·主体、全局·颜色、局部·点集等策略。
- 「语义数据库」:修复用文字描述搜图所需的语义特征。
- 「人脸数据库」:修复人脸检测、人脸特征和人脸搜索所需的数据。
- 「姿势数据库」:修复人体骨架、姿势记录和姿势搜索所需的数据。
一次修复只选择一种数据库。如果多个搜索入口都有异常,可以分几次修复。
图数据库策略怎么选
修复「图数据库」时,窗口下方显示的策略来自「添加文件」里的策略配置。修复会围绕这些策略检查已有数据;其中「局部·点集」只对齐已保存的点集特征与搜索索引,不会为已有图片首次提取点集,也不会按新参数重新提取。
- 「全局」适合大多数整图找相似图场景,通常建议保留。
- 「全局·主体」适合主体明确的商品、人物、物体图片。
- 「全局·颜色」用于按主色和配色查找图片。
- 「局部·点集」用于恢复已有点集数据的索引一致性。旧图片从未解析点集时,需要开启该策略后重新解析文件;修改点集解析参数后也需要重新解析。
和刷新数据库有什么区别
刷新数据库主要处理文件夹里的文件变化,例如新增、删除、改名、同名文件被替换。
修复数据库主要处理已经入库的数据是否完整、特征索引是否一致。重新解析则会再次读取原文件生成数据。补提点集前,在「设置 → 添加文件」保留需要的解析功能,并勾选「局部·点集」,先对少量文件右键选择「重新解析文件」。完成后打开数据库详情刷新统计,再重新打开搜图窗口检查策略是否可选。重新解析可能影响已有图片的收藏关联等记录,处理重要图库前先备份数据库,不要直接全库重跑。
常见情况
- 如果点击「开始」时提示「请选择一个数据库」,先选择图数据库、姿势数据库、语义数据库或人脸数据库。
- 修复耗时取决于数据量及实际需要补齐的内容。点集修复很快结束,也可能只是已有索引无需调整,不代表完成了首次解析。
- 如果修复后某个能力仍然没有数据,确认入库或修复时是否选择了对应功能;例如语义搜图需要语义数据库数据,姿势搜图需要姿势数据库数据,人脸搜图需要人脸数据库数据。
- 如果数据库文件本身损坏,普通修复数据库可能无法解决,需要使用「修复损坏的 database.db 文件」。
判断数量异常前,先等后台任务完成并刷新统计。多主体解析可能让主体记录数大于图片数,这本身不代表损坏,不要仅凭这两个数不等就反复修复。