MangoTart 提供两种备份路径：由你主动下载的 Hermes 手动导出，以及可选的加密云端灾难备份。两者保护相近的 agent 状态，但用于不同场景。
两种备份的区别
| 手动导出 | 云端灾难备份 | |
|---|---|---|
| 适合场景 | 迁移和自主管理副本 | 设备丢失或硬件损坏后的恢复 |
| 如何触发 | 你点击导出 | 开启后每天自动运行，也可立即备份 |
| 存放位置 | 由你下载保存 | MangoTart 管理的对象存储中的加密文件 |
| 加密 | 导出包本身含可读敏感资料，需要你自行保护 | 离开设备前已加密 |
| 密码 | MangoTart 不额外添加密码 | 必须设置；只显示一次，不上传云端 |
| 保留 | 由你管理下载副本 | 按日、周、月滚动保留 |
两种路径都不备份浏览器 profile 和网站登录 session。
Hermes 备份包含什么
支持的备份包括：
- 记忆、用户画像和 persona 文件；
- 技能与 agent 配置；
- 聊天状态与历史；
- 定时任务和受支持设置；
- Hermes 状态中的模型、消息与工具凭证。
不包括：
- Chromium profile、Cookie 或网站登录；
- MangoTart 设备身份、注册信息或 Tailscale 身份；
- 操作系统和可重新安装的程序；
- Hermes 支持范围外的无关文件。
手动导出包含敏感资料
把下载导出包当作密码库保护。里面可能有 API key、登录凭证和聊天历史，不要随意用普通邮件发送，也不要长期留在共享下载目录。
创建手动导出
- 在本地管理台打开系统 → 备份与迁移。
- 选择导出备份。
- 等待导出完成。
- 下载文件并移到可信存储。
导出使用 Hermes 支持的备份路径，可以在 agent 运行期间创建。MangoTart 本机只保留最近一次可下载导出，因此真正长期保存的是你下载的副本。
开启云端灾难备份
- 打开系统 → 云端灾难备份。
- 生成密码，或输入至少八位的自定义密码。
- 密码显示时立即复制，保存在 MangoTart 之外的安全位置。
- 开启自动备份（每天）。
- 想立即生成第一份时，选择立即备份。
文件在 MangoTart 本机完成加密后才上传。存储端只有密文，MangoTart 不保存或返回密码。
设备关机而错过正常备份时间时，持久 timer 会在下次启动后补跑。系统页面会显示最近一次成功或错误。
云端保留策略
云端备份使用滚动 GFS 历史：
- 最近 7 天，每个自然日保留最新一份；
- 最近 13 周，每个自然周保留最新一份；
- 最近 12 个月，每个自然月保留最新一份。
三组会重叠，因此持续每日备份的设备最终约稳定在 28 份，而不是 32 份。较旧的每日副本会逐渐稀释为周和月恢复点。
解绑设备会永久删除全部云端备份，解绑前先下载需要保留的文件。
设备损坏后下载云端备份
- 使用设备机主邮箱登录
mangot.art。 - 打开用户面板并选择设备。
- 在云端备份中选择一个日期的加密文件并下载。
- 保存
.zip.enc文件，以及之前保存的对应密码。
网站可以列出和下载密文，但无法替你解密。
在 MangoTart 上恢复
恢复前先更新目标 MangoTart，确保软件版本不低于创建备份的设备。
- 在目标设备打开系统 → 从备份恢复。
- 选择普通 Hermes 导出包或加密云端备份。
- 加密文件需要输入云端备份密码。
- 确认覆盖。
- 等待 MangoTart 停止 agent 服务、导入状态并重启。
恢复会覆盖目标设备现有 Hermes 记忆和设置，过程中活跃对话会暂停。
恢复后：
- 重新登录内置浏览器中的网站；
- 测试模型供应商和消息平台；
- 检查定时任务、技能和命令审批；
- 正式使用前让旧设备下线，避免两台设备使用相同 bot/token 抢消息。
迁移到另一台 MangoTart
MangoTart 到 MangoTart 是正式支持路径：
- 更新两台设备。
- 从旧设备导出。
- 在新设备导入。
- 重新登录网站。
- 测试 agent 和消息平台。
- 新设备确认正常后，再关闭并恢复出厂旧设备。
导入其他运行开源 Hermes 的电脑可能可行，但属于 best-effort；产品承诺覆盖的是两台 MangoTart 之间迁移。
密码遗失时
没有密码就无法打开加密云端备份。因为密码不保存在云端，MangoTart 支持也无法重设、找回或绕过。修改设备上的密码不会重新加密旧备份，因此旧文件仍要保留旧密码。
备份或恢复失败
- 云端上传／下载需要正常互联网连接。
- 查看系统页面显示的最近备份错误。
- 确保目标设备软件版本足够新。
- 确认密码与该日期的加密文件对应。
- 不要对含有未保存新状态的设备反复导入。
- 如果重要数据可能只存在本机，在恢复出厂或解绑前联系 hello@mangot.art。
更多步骤见故障排查。