数据备份与恢复

CrossPilot 的数据都在本地——这意味着备份是你自己的责任，也是你自己的自由。本页讲怎么备份、恢复、校验数据库。

为什么要备份

数据 local-first，没有云端自动兜底
换电脑、重装系统、误删前，先备份
数据库出问题时，有备份才能回滚

备份

一键导出备份文件，包含本地业务数据
备份带 HMAC 完整性校验，防篡改 / 防损坏
备份文件由你自己保管（本地磁盘 / 自己的网盘 / NAS）

恢复

从备份文件恢复数据到本地
恢复前会校验完整性，损坏 / 被篡改的备份不会被误用
恢复在本地完成，不经任何云

数据库完整性检查

内置 DB 完整性检查，排查数据库是否损坏
启动异常、数据显示错乱时，先跑一次完整性检查
配合 WAL 模式与 busy_timeout，降低并发写入损坏风险

数据目录

备份 / 排障时你可能需要直接定位数据目录：

平台	路径
Windows	`%APPDATA%\com.agilefr.crosspilot\`
macOS	`~/Library/Application Support/com.agilefr.crosspilot/`
Linux	`~/.local/share/com.agilefr.crosspilot/`

卸载前先备份

卸载 CrossPilot 不会自动删除数据目录，但重装 / 换机前仍建议先导出备份，避免意外丢数据。

建议的备份节奏

场景	建议
日常	定期手动备份，关键操作（大批量改动）前先备
换机 / 重装	迁移前导出，新机恢复
升级大版本	升级前备份一份，出问题可回退

相关章节