备份与恢复

Anyy 备份会生成一份一致的 Profile 快照。恢复只能发布到尚不存在的新目录，绝不会覆盖正在使用的数据。

创建备份

anyy backup create

默认归档放在这个 Profile 的备份目录，并带时间戳。需要另存到安全位置时：

anyy backup create --output /secure/path/anyy-backup.tar.gz

Gateway 可连接时，由常驻运行时创建一致快照。Gateway 离线时，命令必须先取得 Profile 的独占所有权，才会读取可能变化的状态。

归档包含什么

备份可以包含 Profile 配置、Role 与 Skill 文件、Workspace 与 Memory、定时任务、渠道配置、数据库快照，以及被引用的持久对象或 Artifact。

临时运行文件不会进入归档。遇到符号链接时，Anyy 会拒绝，而不是跟随到 Profile 外部读取数据。

默认不包含 Secret

anyy backup create --include-secrets

该参数会加入 Profile Secret 以及支持的 MCP/OAuth 材料。

含 Secret 的备份就是凭据库

应当加密、严格限制访问，不要上传到普通网盘或 Issue。凭据可以重新连接时，优先使用不含 Secret 的普通备份。

查看已有备份

anyy backup list
anyy backup list --json

该命令列出 Profile 默认备份位置中可识别的归档。放在自定义路径的归档仍可通过完整路径恢复。

恢复到新 Profile

目标必须是一个尚不存在的目录：

anyy backup restore \
  --archive /secure/path/anyy-backup.tar.gz \
  --target-home /path/to/new-profile

发布目标前，Anyy 会检查 Manifest、文件哈希、剩余空间、路径和归档结构。内容先在目标旁边暂存，重建必要索引和审计状态后，再原子发布。

恢复后先检查：

anyy status --home /path/to/new-profile
anyy doctor --home /path/to/new-profile

确认无误后，再按照平时的 Profile 流程登记或选择这个目录。

恢复原则

• --target-home 绝不能选择当前 Profile；
• 不要选择已经存在的目录，覆盖恢复是明确禁止的；
• 新 Profile 通过 status 和 doctor 前，保留原始归档；
• 启用外发渠道或付费模型前，先重新连接未包含的凭据；
• 定期做一次真实恢复测试，未验证的归档只能算一次备份尝试。

常见问题

现象	原因与处理
离线备份被拒绝	仍有进程拥有 Profile；改走常驻备份，或停止该进程
恢复提示目标已存在	选择全新的路径，不允许覆盖恢复
Manifest 或哈希失败	不要绕过校验，换用已知正常的归档
恢复后模型无法认证	原备份很可能未含 Secret，需要重新连接凭据