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

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

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

1. 先看数据库状态

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

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

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

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

如果某类特征数量为 0，对应搜索方式可能不可用。文件、图片和特征记录的单位不同，数量不必相等；加载失败或缺失的统计也不等于 0。结合任务错误和实际搜索确认缺少哪项能力，再补齐相应数据。

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

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

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

刷新适合处理“原文件变化”。例如你在资源管理器里新增了一批图片、删除了一批旧素材、替换了文件内容，或者某个目录被整理过。同名文件内容被替换时，需要启用文件变更检测；刷新不能自动找回任意迁移后的原路径。

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

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

先核对参考图、策略、范围和对应解析数据。修复可以检查已有数据和索引，但不同策略处理范围不同：已有图片首次补点集或采用新的点集解析参数，需要开启该策略后重新解析，点集修复只整理已有特征与索引。先备份重要图库并试少量文件，重新解析可能影响收藏关联等记录。结果不理想或统计不相等本身不代表索引损坏。

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

修复数据库更偏向“重建搜索能力”，不是单纯扫描文件变化。它适合处理以图搜图、姿势搜图、语义搜图、人脸搜图等已确认数据缺失、需要补齐对应能力的场景。

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

4. 任务运行时看进度

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

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

关闭任务窗口不会停止任务。支持取消的任务会显示取消按钮；发出取消请求后仍需等待任务确认停止，已完成的处理不会回滚。

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

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

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

新建、迁移和备份选择父目录，软件在其下使用 database 子目录；加载选择直接含 database.db 的目录。原始素材需单独备份，迁移后应实际打开来源文件核对路径。备份用于保留当前数据库状态。迁移用于把数据库位置搬到新磁盘或新目录。新建数据库适合从空库重新开始。加载已有数据库适合切回历史库或迁移后的库。

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

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

无法进入软件或切库失败不等于数据库损坏，先核对服务、路径、权限和日志。确认 database.db 损坏后，先保留副本，再从工具菜单选择损坏文件尝试抢救。

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

这是异常处理流程，不是日常整理入口。文件变化用刷新；确认缺少搜索数据时才补齐相应索引；确认文件损坏后再修复 database.db。

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

• 文件新增、删除、改名、替换：用刷新数据库。
• 单个文件异常或刚被替换：用单个文件重新解析。
• 确认缺少某项搜索数据：选择对应索引修复。
• 数据库太大、删过很多数据：先看数据库信息，再考虑瘦身。
• 换电脑、换硬盘、重要整理前：先备份数据库。
• 确认原数据库文件损坏：保留副本后尝试修复 database.db。

常见情况

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

空间不足时先核对具体磁盘

系统盘、数据库盘和导出目标盘都可能导致操作失败。先看提示所指路径，再核对剩余空间；不要直接删除 database.db 或不认识的索引文件。处理步骤见「提示磁盘空间不足：应该清理哪块盘」。