日常维护素材库：刷新、修复、备份和迁移数据库

素材库不是一次入库后就永远不变。你会在电脑里新增图片、删除文件、改名、替换内容，也可能需要换硬盘、搬电脑、清理空间或修复搜索异常。

完整维护路线是：查看数据库状态 → 文件变化后刷新 → 搜索异常时修复索引 → 观察后台任务 → 定期备份或迁移 → 数据库损坏时尝试修复文件。

1. 先看数据库状态

遇到图片数量不对、搜索按钮不可用、磁盘占用变大或结果异常时，先看数据库信息面板。

箭头指引：搜图工作台左侧「数据库」 → 图片数量右侧「更多」 → 打开数据库信息面板。

重点看三类信息：基本情况里的文件数和图片数；以图搜图、姿势、语义、人脸等特征数量；数据库所在硬盘的剩余空间。

第一次打开或刷新数据库信息时，面板上可能短暂显示「加载中」。这是在读取统计数据，等待完成后再判断数量是否异常。

如果某类特征数量为 0，对应搜索方式可能不可用。如果某些数量显示异常或不一致，先刷新数据库；仍然异常时再修复数据库索引。

2. 文件夹内容变了，用刷新数据库

当已入库文件夹里的文件新增、删除、改名、移动或内容被替换，软件不会凭空知道这些变化。需要用「刷新数据库」同步。

箭头指引：左侧数据库更多入口 → 选择「刷新数据库」 → 打开刷新窗口。

刷新适合处理“原文件变化”。例如你在资源管理器里新增了一批图片、删除了一批旧素材、替换了文件内容，或者某个目录被整理过。

如果只是想给已有图片补充新的搜索能力，例如补语义、姿势、人脸或颜色数据，刷新不一定够，通常需要重新添加对应功能或使用修复数据库。

3. 搜索异常，用修复数据库索引

当搜索结果明显不对、某类特征数量不一致，或者开启新策略后想给老图片补齐数据，可以用「修复数据库」重建索引。

箭头指引：左侧数据库更多入口 → 选择「修复数据库」 → 打开修复窗口。

修复数据库更偏向“重建搜索能力”，不是单纯扫描文件变化。它适合处理以图搜图、姿势搜图、语义搜图、人脸搜图等索引不完整、数量异常或结果异常的场景。

如果图库很大，修复会花时间。尽量在不用电脑处理紧急工作的时间段执行，并保持数据库所在磁盘空间充足。

4. 任务运行时看进度

刷新、修复、添加文件夹、人脸聚类等操作都会进入后台任务。任务运行时，部分按钮可能暂时不可用。

箭头指引：顶部任务进度区域 → 点击进度条 → 打开「后台任务」 → 查看每个任务的主进度和子进度。

关闭任务窗口不会停止任务。支持取消的任务会显示取消按钮；取消后可能要等当前批次处理完才会停止。

5. 定期备份或迁移数据库

如果图库是长期生产资料，建议在大批量整理、修复、迁移电脑或更换硬盘前备份数据库。

箭头指引：菜单栏「文件」 → 「数据库」 → 选择加载、迁移、新建或备份数据库。

备份用于保留当前数据库状态。迁移用于把数据库位置搬到新磁盘或新目录。新建数据库适合从空库重新开始。加载已有数据库适合切回历史库或迁移后的库。

不要手动删除数据库文件夹里的 database.db、缩略图、向量索引和缓存目录。需要腾空间时，优先使用软件里的瘦身、备份、迁移和刷新功能。

6. database.db 损坏时再修复文件

如果软件无法进入、无法切换数据库，或者明确提示 database.db 损坏，可以从工具菜单手动选择损坏的数据库文件尝试抢救。

箭头指引：菜单栏「工具」 → 「修复数据库文件」 → 选择 database.db → 等待修复任务完成。

这是异常处理流程，不是日常整理入口。平时搜索异常、数量不一致，优先用刷新或修复数据库索引；只有数据库文件本身打不开或损坏时，再修复 database.db 文件。

维护时怎么判断该用哪个功能

• 文件新增、删除、改名、替换：用刷新数据库。
• 单个文件异常或刚被替换：用单个文件重新解析。
• 搜索结果异常、特征数量不一致：用修复数据库索引。
• 数据库太大、删过很多数据：先看数据库信息，再考虑瘦身。
• 换电脑、换硬盘、重要整理前：先备份数据库。
• 原数据库文件打不开或损坏：用修复损坏的 database.db 文件。

常见情况

• 刷新后数量仍不对：确认文件后缀设置是否包含对应格式，文件是否仍在原路径，是否有读取权限。
• 修复时间很长：大图库或多策略修复会比较耗时，可以从任务进度查看状态。
• 某些搜索入口不可用：先看数据库信息面板里对应特征数量是否为 0。
• 磁盘空间紧张：瘦身只能回收 database.db 里的空闲空间，不能替代清理磁盘或迁移数据库。
• 迁移数据库后找不到素材：数据库记录的是原素材路径，原始素材也要保证路径可访问。