修复损坏的 database.db 文件

database.db 是软件数据库文件。正常情况下不需要手动处理它；只有在软件提示数据库损坏、无法打开数据库、切换数据库失败，或初始化数据库失败时，才使用这个修复入口。

操作步骤

1. 在桌面客户端顶部菜单栏打开「工具」。
2. 点击「修复数据库文件」。
3. 在弹窗里点击「选择 db 文件」。
4. 选择数据库文件夹中名为 database.db 的文件。不要选择 database_corrupt_日期.db 这类备份文件。
5. 确认路径后，点击「开始修复」。
6. 修复过程中不要关闭软件，也不要移动数据库文件夹。
7. 等进度条完成后，重新进入搜图工作台或重新初始化数据库。

修复会做什么

点击「开始修复」后，软件会先把原来的损坏文件备份为 database_corrupt_日期.db，再尽可能把能读取的数据迁移到新的 database.db 中。

如果损坏文件里仍能恢复部分数据，修复后可以继续使用这些数据；如果文件损坏严重，可能只能恢复一部分，甚至无法恢复。

自动弹出的修复窗口

有些场景不需要从菜单手动进入。比如进入首页、切换数据库或初始化数据库时，软件检测到当前 database.db 已损坏，会自动弹出同一个修复窗口，并显示损坏数据库所在路径。修复成功后，软件会自动重试刚才失败的操作。

注意事项

• 只选择名为 database.db 的主数据库文件。
• 不要把素材图片、表格、PDF 直接放进数据库文件夹。
• 不要手动删除 database.db、-wal、-shm、vector、thumb 等数据库相关文件。
• 修复前如果条件允许，可以先复制整个数据库文件夹作为额外备份。
• 修复完成后，如果搜索结果异常或特征数量不一致，再使用「修复数据库索引」补齐搜索特征。

常见情况

• 如果按钮提示需要先选择 db 文件，说明还没有选中 database.db。
• 如果选错了备份文件，软件会提示需要选择名为 database.db 的主文件。
• 如果修复失败，保留数据库文件夹和日志，联系技术支持时一起提供更容易排查。
• 如果只是搜索结果异常、图片数量不对，但软件能正常进入数据库，通常先用「刷新数据库」或「修复数据库索引」，不要直接修复损坏文件。