Billfish数据库损坏时应先关闭软件并检查library.db文件状态，优先用library.db.backup自动或手动恢复；无备份则重置索引后重新扫描素材路径。
Billfish提示数据库损坏时，软件无法正常读取索引文件或素材元数据，界面可能卡死、重复扫描失败、素材列表空白或报错“索引异常”“无法加载库”。这通常不是MySQL底层损坏，而是Billfish自建的SQLite本地数据库文件（如library.db）发生写入中断、磁盘异常或版本升级冲突所致。
确认损坏来源是否为Billfish自身数据库
第一步：关闭Billfish，进入素材库所在目录（默认为C:\Users\用户名\Documents\Billfish\Library），查看是否存在library.db及其对应的library.db-journal临时文件。若library.db文件大小为0KB、无法用SQLite浏览器打开，或修改时间停留在某次异常退出前，基本可判定是该文件损坏。
第二步：不要手动删除或重命名library.db——【这是唯一可逆恢复的前提】。Billfish 2.8.0+ 版本会在首次启动时自动检测并尝试从library.db.backup恢复（如有），而该备份文件通常在同目录下，生成于每次成功索引后。
优先使用内置备份恢复
方法一：直接重启触发自动恢复
关闭Billfish → 删除library.db-journal（仅临时日志，删掉无风险）→ 重新打开Billfish。软件启动时若检测到library.db异常，会自动查找并还原最近一次的library.db.backup，耗时约3～15秒，期间界面显示“正在初始化素材库”。
方法二：手动替换备份文件
若自动恢复未触发，进入Library目录，将library.db.backup复制一份 → 粘贴并重命名为library.db（原损坏文件先重命名为library.db.corrupt留档）→ 启动Billfish。这一步操作起来很简单，直接把文件拖进去就行。
重建索引（无可用备份时）
第一步：备份当前素材文件夹路径
打开Billfish → 左上角点击「本地素材库」→ 记录顶部显示的「当前索引路径」，例如D:\Design\Assets。这一步不能跳过，否则重建后找不到原始文件位置。
第二步：清空现有索引
点击左上角菜单 → 「设置」→ 「数据库」→ 「重置素材库」→ 勾选「清除所有索引记录（不删除原始文件）」→ 点击「确定」。注意：【此操作不可撤销，但原始图片不会被删除】。
第三步：重新添加路径并扫描
回到「本地素材库」→ 「添加文件夹」→ 粘贴刚才记下的路径 → 勾选「深度扫描子文件夹」→ 点击「开始扫描」。扫描时间取决于素材总量，万级文件约需2～8分钟。
