備份與復原

遷移電腦、刪除 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，否則目標存在，復原會拒絕。

來源壓縮檔至少保留到新環境驗證通過。重連遺漏認證資料後，再啟用對外傳送的通訊管道或付費模型。雜湊／清單失敗時換用已知正常封存；所有權衝突時先停止對應的正確執行環境。定期試復原比只確認檔案存在更可靠。