备份与恢复

迁移机器、删除 Profile 或维护数据库前，先备份一套完整环境。一次归档针对一个 Profile；不会同时打包同级 Profile 或已安装的程序。

把归档保存在哪里

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

不指定 output 时使用当前 Profile 的 backups 目录和时间戳名称，list 读取这个默认位置；自定义位置仍可按完整路径恢复。归档可包含配置、Roles／Skills、Workspace、Memory、定时和渠道配置、数据库快照、被引用的持久对象和 Artifact。

Gateway 在线时由常驻运行时取得一致快照，离线时必须取得 Profile 独占所有权。临时运行文件排除在外；采集路径出现符号链接会拒绝，不跟随读取其他目录。

分清托管凭据与文件内容

默认跳过托管的 secrets/、mcp/oauth/ 目录。要额外带上其中的 Profile Secret 和支持的 MCP／OAuth 材料，明确使用：

anyy backup create --include-secrets

这个参数只控制上述托管目录，不会扫描所有文件并脱敏。config.yaml 和用户文件按内容进入归档；例如内联在 MCP env／headers 中的凭据、Workspace 或其他采集文件里的秘密，即使不加参数也可能被备份。不能把默认备份当作无秘密归档。

所有备份都应按敏感数据加密、限制访问，不要上传到公开 Issue 或普通共享位置。恢复后，需要重新连接未包含的托管凭据或当前不可用的凭据引用。

恢复时不要先创建 Profile

恢复要求 target-home 完全不存在，不能覆盖当前环境，也不能使用已经创建的空目录：

anyy backup restore --archive /secure/path/anyy-backup.tar.gz --target-home /path/to/restored-home

恢复先检查清单、哈希、空间和路径结构，在目标旁暂存并重建必要索引／审计状态，最后原子发布。之后先验证：

anyy status --home /path/to/restored-home
anyy doctor --home /path/to/restored-home

选用恢复后的目录

没有任意目录 import/register 命令。可以一直显式使用 Home：

anyy --home /path/to/restored-home
anyy dashboard --home /path/to/restored-home

若要作为具名 Profile，恢复目标直接选尚不存在的 BASE_HOME/profiles/NAME，检查后运行 anyy --profile-root BASE_HOME profile use NAME。不要先运行 profile create NAME，否则目标存在，恢复会拒绝。

源归档至少保留到新环境验证通过。重连遗漏凭据后，再启用外发渠道或付费模型。哈希／清单失败时换用已知正常归档；所有权冲突时先停止准确对应的运行时。定期试恢复比只确认文件存在更可靠。