操作说明搜图工作台

修复数据库索引

当搜索结果异常、统计数量不一致,或需要为已有图片重新生成图搜图、姿势、语义、人脸等特征时,使用修复数据库重建索引。

选图汪本机搜图团队2026-09-156 分钟阅读
修复数据库索引

当搜索结果异常、统计数量不一致,或需要为已有图片重新生成图搜图、姿势、语义、人脸等特征时,使用修复数据库重建索引。

修复数据库用于检查已有素材的搜索数据和索引一致性。它适合排查图片已经在库里但搜索异常、特征备份与索引不一致等情况。不同策略的修复范围不同,不能把修复完成当作所有缺失特征都已补齐。

数据库菜单中的修复数据库入口
数据库菜单中的修复数据库入口

操作步骤

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

该选哪个数据库

  • 「图数据库」:修复以图搜图相关能力,包括全局、全局·主体、全局·颜色、局部·点集等策略。
  • 「语义数据库」:修复用文字描述搜图所需的语义特征。
  • 「人脸数据库」:修复人脸检测、人脸特征和人脸搜索所需的数据。
  • 「姿势数据库」:修复人体骨架、姿势记录和姿势搜索所需的数据。

一次修复只选择一种数据库。如果多个搜索入口都有异常,可以分几次修复。

图数据库策略怎么选

修复「图数据库」时,窗口下方显示的策略来自「添加文件」里的策略配置。修复会围绕这些策略检查已有数据;其中「局部·点集」只对齐已保存的点集特征与搜索索引,不会为已有图片首次提取点集,也不会按新参数重新提取。

  • 「全局」适合大多数整图找相似图场景,通常建议保留。
  • 「全局·主体」适合主体明确的商品、人物、物体图片。
  • 「全局·颜色」用于按主色和配色查找图片。
  • 「局部·点集」用于恢复已有点集数据的索引一致性。旧图片从未解析点集时,需要开启该策略后重新解析文件;修改点集解析参数后也需要重新解析。

和刷新数据库有什么区别

刷新数据库主要处理文件夹里的文件变化,例如新增、删除、改名、同名文件被替换。

修复数据库主要处理已经入库的数据是否完整、特征索引是否一致。重新解析则会再次读取原文件生成数据。补提点集前,在「设置 → 添加文件」保留需要的解析功能,并勾选「局部·点集」,先对少量文件右键选择「重新解析文件」。完成后打开数据库详情刷新统计,再重新打开搜图窗口检查策略是否可选。重新解析可能影响已有图片的收藏关联等记录,处理重要图库前先备份数据库,不要直接全库重跑。

常见情况

  • 如果点击「开始」时提示「请选择一个数据库」,先选择图数据库、姿势数据库、语义数据库或人脸数据库。
  • 修复耗时取决于数据量及实际需要补齐的内容。点集修复很快结束,也可能只是已有索引无需调整,不代表完成了首次解析。
  • 如果修复后某个能力仍然没有数据,确认入库或修复时是否选择了对应功能;例如语义搜图需要语义数据库数据,姿势搜图需要姿势数据库数据,人脸搜图需要人脸数据库数据。
  • 如果数据库文件本身损坏,普通修复数据库可能无法解决,需要使用「修复损坏的 database.db 文件」。

判断数量异常前,先等后台任务完成并刷新统计。多主体解析可能让主体记录数大于图片数,这本身不代表损坏,不要仅凭这两个数不等就反复修复。