备份与恢复
迁移部署或进行重要修改前，导出完整账本；需要恢复时先了解替换范围。
完整备份是一个 JSON 文件。把它导入到一个全新的部署，可恢复订阅、支付方式、人员、设置和汇率。迁移部署方式（比如从 Docker 换到 Cloudflare）、换服务器，都靠它。
- 打开「设置 → 数据」，点「导出完整备份」。
- 保存下载的
calends-backup-YYYY-MM-DD.json，确认文件存在并妥善保管。
| 包含 | 不包含 |
|---|---|
| 全部订阅，包括阶段、价格历史、扣款记录、合租成员与收款、代付记录 | 登录密码和 Passkey |
| 支付方式，包括余额和充值记录 | 登录会话 |
| 人员名册 | MCP 令牌（属于凭据，新部署应重新生成） |
| 设置，包括通知渠道、日历订阅令牌、分类表和头像 | 内置助手的 DeepSeek API Key 和聊天记录 |
| 当前汇率和全部历史汇率 | 提醒发送记录、界面偏好（视图、排序、主题等） |
- 先导出当前账本的完整备份。
- 在「设置 → 数据」点「从备份恢复」，选择要导入的 JSON 文件。
- 核对备份时间、格式和订阅、支付方式数量，再点「替换当前账本」。
- 检查订阅、钱包、人员与通知设置；迁到新部署时重新生成 MCP 令牌。
恢复是整体替换：
- 订阅、支付方式、人员名册、设置都替换成备份里的内容；只要备份包含非空设置，缺失项回到默认值；完全不含设置的旧备份保留当前设置。
- 历史汇率按日期合并，同一天以备份为准。
- 登录密码、Passkey、登录设备、MCP 令牌保持不变。
恢复无法撤销。建议先导出一份当前的备份。
早期版本导出的备份也能导入，界面会标注「旧版备份：只含订阅与支付方式」。没有人员名册的备份，恢复后会按合租成员、代付对象的称呼重新建档。比当前版本更新的备份格式会被拒绝，请先升级 Calends。
Calends 不会自动备份。Cloudflare 部署可以使用 D1 自带的 Time Travel 按时间点恢复数据库；Docker 部署可以定期备份数据卷，见 Docker。