备份与恢复
区分数据库快照、配置包与凭据库秘密值。
概览
备份数据库包含配置和历史，但不包含系统凭据库中的秘密值。恢复到全新目录后，应重新录入秘密并重新审批。配置导入生成新资源标识，可用于独立副本；完整快照可能保留旧标识并引用同账号凭据库条目。
边界与检查
0.3.1 使用 schema 25、配置包格式 2，但不承诺旧版数据直接兼容。恢复前离线检查备份并保留原始副本；不要把完整诊断或数据库发到公开 Issue。
三种文件用途不同
| 文件 | 保存什么 | 恢复后要做什么 |
|---|---|---|
| 配置 JSON | 资源、连接参数、模板和普通参数，不含秘密或历史 | 追加导入会生成新标识；重新录入秘密并审批 |
| SQLite 一致性备份 | 配置、审批与历史、已过滤输出、PIN 验证材料及加密诊断，不含系统凭据库秘密值 | 只恢复到全新目录，重新配置秘密与授权 |
| 精简诊断 | 版本、状态计数与固定错误代码概览 | 用于排障，不是配置或数据备份 |
不包含凭据原文不代表可以公开：普通字段可能有内部地址、命令、业务参数和结果。不要把配置包、SQLite 文件或未检查的完整诊断附到公开 Issue。
配置迁移
在“设置 → 数据维护”导出 JSON；在目标设备先执行检查导入，核对数量与关系，再确认导入。导入只追加，不覆盖同名现有资源，也不会自动迁移授权与系统凭据库。目标机器上的程序路径、私有 CA、仓库目录和文件路径需要重新检查；跨平台路径不会自动转换。网络中断后对同一文件重新确认会返回原回执，别换文件反复尝试。
备份、预检、恢复
使用页面的“下载 SQLite 备份”获取包含已提交 WAL 变更的一致性快照，不要运行时只复制主数据库文件。通过页面或 secretbridge --inspect-backup 绝对文件路径 预检。当前 0.3.1 接受 schema 25、配置格式 2，不承诺兼容旧数据。
完整恢复必须先停止后台与桥接，为 SECRETBRIDGE_DATA_DIR 指定尚不存在的绝对目录，再执行 --restore-backup。恢复保留配置与历史，但凭据引用标为未配置、未完成任务中断、待批和已批授权撤销；重新录入秘密并申请新授权。恢复到同一系统账号时，旧 UUID 可能仍对应原凭据库条目，想要独立副本应优先选择配置导入。