更新與解除安裝

先確認要操作哪一套 Anyy，再決定更新還是解除安裝。原生 resident 安裝支援自更新；容器、套件管理員和原始碼建置應使用各自的釋出方式。

操作前核對環境

anyy --version
anyy config
anyy update --check

檢查目前版本、Home、安裝來源、目標版本及空間預檢。--check 不切換發行版，也不停止 Gateway。

本手冊對應 v0.1.107。舊階段體驗目錄不屬於正式 resident 目錄結構；不能對它偽造安裝標記來使用自更新。開發資料需要單獨保全，別用建立的空目錄覆蓋已有工作階段和認證資料。

anyy update

更新器取得對應 Home 的鎖，下載平台發行套件與校驗檔案，驗證 SHA-256 和封存內容，把候選程式放入獨立版本目錄，再透過 anyy --version 檢查候選。成功後原子切換 current，並記錄原活動版本。

若原 Gateway 服務正在執行，更新過程會停服務、更新定義並重新啟動，等待新版就緒。手工啟動的 Gateway 不會被擅自轉為系統服務；按指令輸出處理它的狀態。

需要指定一個實際存在的版本時：

anyy update --version v0.1.107

預設跟隨釋出源報告的最新版本。需要可信鏡像來源時才使用 --base-url URL；發行套件和校驗值都來自這個鏡像來源，因此它也是信任邊界。

優先釋放臨時目錄與 Home 空間。可以接受減少還原記錄時再執行：

anyy update --compact

緊湊模式保留目前活動版本，先處理非活動版本；只有空間仍不足時才可能移除上一個還原目標。它不刪除個人資料，但不能保證保留所有舊二進位。

程式更新不刪除 Profile 的設定、認證資料、工作階段、記憶、Skills、MCP 設定和工作區。發生資料庫遷移時，只換回舊二進位無法撤銷資料變化。

重要調整前應另存可復原的備份：

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

預設不額外收集代管的 secrets/ 和 mcp/oauth/ 目錄；需要這些材料時再選擇 --include-secrets。但設定和工作檔案會按原樣備份，使用者直接寫在其中的金鑰仍可能進入一般備份壓縮檔。所有備份都應作為敏感資料保管，詳見備份與復原。

anyy --version
anyy gateway status
anyy status
anyy doctor
anyy dashboard

確認版本與 Gateway 狀態一致，再進行一次小對話。Dashboard 是獨立程序，舊介面程序不會僅因磁碟上的程式已更新就自動替換。服務復原失敗時，更新指令會報告非零結果；先修復輸出中的原因，再明確啟動或重啟服務。

anyy uninstall

互動流程會展示計畫並讓你確認。非互動方式必須寫清保留資料還是完整解除安裝：

anyy uninstall --keep-data --yes
anyy uninstall --full --yes

選擇	程式和服務	個人資料
`--keep-data`	移除所選安裝的程式、指令入口與服務	保留設定、工作階段、記憶等資料
`--full`	移除程式、入口與服務	刪除所選 Home 範圍內的設定、認證資料、工作階段、記憶、Skills 和工作區等

--yes 不能單獨使用。完整解除安裝前先確認備份和 Home；這不會替你搜尋、刪除其他專案或外部共享的 Skills 目錄。指令只移除所屬該安裝的入口，不應覆蓋或刪除別的同名指令。

解除安裝指令只支援原生 resident 目錄結構。自編譯、容器或套件管理員安裝，按它們的管理方式移除。獨立 Dashboard 也需要按其生命週期停止，不可將停止 Gateway 當成所有介面都已結束。

提示或現象	處理方式
不支援自更新／解除安裝	核對安裝來源與 `--home`，不要偽造 resident 目錄結構
同一 Home 已有更新操作	等持鎖操作完成，不併發切換版本
空間預檢失敗	釋放相應目錄空間；僅在接受減少還原歷史時使用緊湊模式
校驗失敗	從可信釋出源重試，不跳過校驗或手動啟用不完整的壓縮檔
更新後仍顯示舊版本	分別檢查目前指令、Gateway 和 Dashboard 程序，不只檢查磁碟檔案
服務沒有復原	看 `anyy gateway status` 和更新錯誤，修復後明確執行 start／restart