FooSnippets v1.5.10 数据修复手册

2026-02-19

问题说明

v1.5.10 版本存在一个数据库维护逻辑的缺陷，导致应用首次启动时会错误地删除 prompts 表中的所有记录。分类（categories）数据不受影响。

影响范围：所有从旧版本升级到 v1.5.10 的用户，首次启动应用后 snippets 数据会被清空。

数据是否可恢复：可以。SQLite 的 DELETE 操作不会立即擦除磁盘上的数据，只是将对应的数据页标记为可复用（freelist）。只要数据库文件没有被 VACUUM 过，原始数据仍然保留在文件中。

确保 FooSnippets 应用已完全退出（包括菜单栏图标）。

默认路径：

~/Library/Application Support/FooSnippets/snippets.db

如果你在设置中自定义了数据库路径，请使用你的自定义路径。

cp ~/Library/Application\ Support/FooSnippets/snippets.db ~/Desktop/snippets.db.backup

将以下脚本保存为 recover_db.py。

运行修复：

python3 recover_db.py ~/Library/Application\ Support/FooSnippets/snippets.db

脚本会在同目录下生成恢复后的数据库文件：

~/Library/Application Support/FooSnippets/snippets.db.recovered.db

sqlite3 ~/Library/Application\ Support/FooSnippets/snippets.db.recovered.db "SELECT COUNT(*) FROM prompts;"

确认记录数与你预期的 snippets 数量大致一致。

也可以抽查几条记录：

sqlite3 ~/Library/Application\ Support/FooSnippets/snippets.db.recovered.db "SELECT trigger_sequence, substr(content, 1, 50) FROM prompts LIMIT 10;"

确认恢复数据无误后，替换原数据库：

cp ~/Library/Application\ Support/FooSnippets/snippets.db.recovered.db ~/Library/Application\ Support/FooSnippets/snippets.db

v1.5.10 在执行完错误的清理后设置了一个 UserDefaults 标记。需要清除它，以便修复版本能正确执行规范化逻辑：

defaults delete me.afoo.FooSnippets didDeduplicateV1

如果提示 key 不存在，可以忽略。Bundle ID 也可能是其他值，可通过以下命令确认：
defaults find didDeduplicateV1

更新到 v1.5.11（或更高版本）后再启动应用，确认数据已恢复。

SQLite 执行 DELETE 时，被删除的数据所在的 B-tree 页面会被放入 freelist（空闲页面列表），但页面内容不会被清零。修复脚本的工作方式：

读取整个数据库文件的原始字节
逐页扫描所有页面（包括 freelist 中的页面）
在每个页面中尝试解析 SQLite 记录格式，匹配 prompts 表的 schema（9 列：id, title, content, category_id, tags, trigger_sequence, aliases, date_created, date_modified）
通过 UUID 格式验证和列类型校验过滤误匹配
对同一 trigger_sequence 的重复记录，保留 date_modified 最新的一条
将恢复的记录写入新的数据库文件，同时从原库复制 categories 表