索引建立与等待

添加文件夹并设置好模型后，软件会自动开始建立索引。理解索引建立的过程，可以帮助你更好地规划使用时间。

索引建立的完整流程

索引按照固定顺序逐步建立，每个步骤都会在进度条上显示：

① 基础索引 → ② AI索引 → ③ 纹理索引 → ④ 人脸索引 → ⑤ OCR索引 → ⑥ 统计缓存

各阶段说明

阶段	进度文字	做了什么	是否可跳过
基础索引	基础索引	扫描所有图片，计算 MD5、文件大小、尺寸，生成哈希指纹	❌ 始终建立
AI 索引	AI索引	使用 CLIP 模型提取每张图片的语义向量	✅ 仅 AI 开启时
纹理索引	纹理索引	计算 LBP + Gabor + HSV 色彩特征	✅ 仅纹理开启时
人脸索引	人脸索引 / 加载人脸模型	YuNet 检测人脸位置 + SFace 提取人脸特征向量	✅ 仅人脸开启时
OCR 索引	文字索引	识别图片中的文字内容	✅ 仅 OCR 开启时
统计缓存	详情统计缓存	预计算统计面板所需的数据	❌ 始终建立

只开启需要的模型

未开启的模型对应的索引阶段会被 自动跳过，不会浪费时间。这就是为什么建议按需开启模型。

查看索引进度

进度条位置

软件底部状态栏会显示索引进度信息：

• 进度条：显示当前阶段的完成百分比
• 阶段文字：显示当前正在建立哪种索引（如 "AI索引"）
• 详情文字：显示 已处理/总数 和预计剩余时间（如 "120/500 (已用 2分15秒 剩余 6分)"）
• 当前文件夹：显示正在处理的文件夹名称

索引任务正在运行表格状态显示文件夹当前阶段，底部状态栏显示任务名称、已处理/总数和已用时间。阶段切换时进度可能短暂停留。

文件夹列表状态

在图库管理页面或侧边栏，每个文件夹会显示索引状态：

状态文字	含义
基础索引 24%	正在建立基础索引，进度 24%
AI索引 56%	正在建立 AI 索引，进度 56%
队列中	在等待前一个文件夹完成索引
处理中	该文件夹在多文件夹任务队列中，尚未开始
无状态显示	索引已完成

状态标签

软件左下角有一个索引任务状态标签（药丸形状），索引进行中显示，完成后自动隐藏。

⚠️ 重要提示：索引期间不要使用搜图

索引建立期间建议不要使用搜图功能

在索引建立过程中，建议不要使用搜图功能，原因如下：

1. 搜索结果不完整

如果索引只建了一半（比如 AI 索引建到了 300/1000），此时搜索只能搜到已建立索引的 300 张图片，结果不完整。

2. 可能出现卡顿

索引建立是 CPU 和磁盘密集型操作（尤其是 AI 和 OCR 模型），同时进行搜图会竞争系统资源，导致两者都变慢。

3. 搜索前预检机制

软件在搜图前会检查索引是否就绪。如果索引尚未建立，会 取消搜索 并提示：

• AI 模式："当前搜索范围没有真实可用的 AI/主体向量，已取消搜图。请先对需要搜索的文件夹执行'同步更新索引'。"
• 其他模式类似提示

4. 正确的做法

等待索引完全建立后再搜图。 你可以通过以下方式确认索引是否完成：

• 底部进度条消失
• 文件夹状态不再显示索引进度
• 左下角索引任务状态标签消失

索引任务队列

多文件夹排队

添加多个文件夹时，索引任务按顺序排队执行：

1. 第一个文件夹开始建立索引
2. 后续文件夹显示「队列中」
3. 前一个完成后，自动开始下一个

取消和重试

• 取消当前任务：改变文件夹的搜图模式设置时，该文件夹正在进行的索引任务会被取消并按新设置重新开始
• 超时处理：如果索引任务超过 3600 秒（1 小时）未完成，会自动终止并提示"安全索引超时，请分批添加文件夹或检查异常图片"

避免超时

如果图片数量很多（超过 5000 张），建议：

1. 只开启 AI 模型（不要全开）
2. 分批添加文件夹，每次添加一个
3. 等前一个索引完成后再添加下一个

关闭软件的注意事项

关闭软件时的警告

如果索引任务正在进行时关闭软件，会弹出警告对话框：

"当前仍有索引建立或补建任务正在进行。如果此时关闭软件，可能会造成部分图片索引缺失或增强索引不完整，影响下次搜图结果。软件会记录未完成任务，下次启动后自动继续建立索引。仍然要关闭软件吗？"

好消息：自动恢复

即使中途关闭软件，未完成的索引任务也会被 自动保存。下次启动软件时：

1. 自动读取未完成的任务列表
2. 重新加入索引队列
3. 状态栏提示 "已继续上次未完成的索引任务: N 个"
4. 从中断处继续建立索引（不需要从头开始）

索引完成后

索引建立完成后，你可以：

1. 开始搜图 → 开始使用搜图
2. 添加更多文件夹 → 添加图片文件夹
3. 追加搜图模型 → 搜图模型选择指导
4. 查看统计信息 → 图库管理页面查看图片数量和索引状态

常见问题

索引建立很慢怎么办？

1. 检查是否开启了过多模型 — 只开需要的
2. 检查图片数量 — 超过 5000 张建议分批添加
3. 检查电脑性能 — AI 索引受 CPU 和内存影响较大
4. 关闭其他占用资源的程序

索引建立到一半卡住了？

可能是遇到了异常图片（如超大图片、损坏图片）。等待超时后软件会自动终止。建议分批添加文件夹，隔离问题图片。

如何重建索引？

右键文件夹 →「重建基础索引」会删除该文件夹的基础索引并重新建立。增强索引（AI/纹理/人脸/OCR）可以通过「同步更新文件夹」来增量更新。