跳至主要內容

安裝

安裝的驗收點是：目前終端機可以執行正確的 anyy --version。模型設定和常駐服務屬於後續步驟，安裝腳本不會替你選擇服務商。

你的裝置適用哪個安裝套件？​

v0.1.107 釋出以下四個平台的原生執行檔：

系統架構
macOSApple Silicon 的 arm64、Intel 的 amd64
Linuxarm64／aarch64、amd64／x86_64

原生安裝器不支援 Windows，也不提供 arm32 套件。發行程式使用 Go 建置；執行 Anyy 本身不要求安裝 Go 或 Node.js。外部 MCP 伺服器和工具可能另有依賴。

準備可以存取 anyy.ai 的網路，以及 sh、curl、tar、gzip、awk、sed、mktemp、readlink 和 sha256sum／shasum。一般使用者可以安裝到自己的目錄，不必切到 root。

執行安裝​

curl -fsSL https://anyy.ai/install.sh | sh
anyy --version

腳本會選擇系統和架構，下載發行套件與校驗檔案，確認 SHA-256 和封存路徑合法，再把程式放入獨立版本目錄並原子切換 current。同一個 Home 的安裝／更新有鎖，不能併發切換。

希望先閱讀腳本時，直接檢視 install.sh。版本來自最新發布指標，本手冊對應 v0.1.107。

成功輸出會包含 Installed Anyy ...。Gateway: 只是目前狀態報告，不表示安裝器啟動了服務；新安裝出現 Gateway: status unavailable 時，應先單獨確認 --version 正常。

指令找不到時，先看安裝輸出​

安裝器顯示 Binary: 時，使用後面的完整路徑執行 --version，再按輸出提示新增 PATH。一般使用者的入口通常是：

$HOME/.local/bin/anyy

腳本不修改 Shell 啟動檔案，也不覆蓋所屬不明的同名指令。不要在沒有核對來源時刪除另一個 anyy 檔案。

程式和資料分別在哪裡？​

情況Home對外指令入口
一般使用者預設安裝$HOME/.anyy$HOME/.local/bin/anyy
root 預設安裝/root/.anyy/usr/local/bin、/opt/homebrew/bin、/usr/bin 中首個可寫目錄
設定 ANYY_HOME你指定的目錄仍按執行身分選擇入口，指回該 Home

核心程式佈局：

<ANYY_HOME>/
  releases/<version>/anyy
  current -> releases/<version>
  bin/anyy -> ../current/anyy
  .install/source.json
  .install/previous    # 有上一个活动版本时

安裝器也準備 memory/、skills/、workspace/、secrets/、logs/、cache/、backups/ 等資料目錄。準備佈局時，Home 和列出的代管目錄會設為 0700，包括已存在的這些目錄；不會遞迴修改目錄內所有檔案。安裝來源標記使用 0600。

config.yaml 來自後續設定，state.db 和 objects/ 由實際執行環境按需建立。工作階段和個人資料不在發行壓縮包裡。

固定版本或更換目錄​

環境變數放在管道右側，作用於執行腳本的 sh：

curl -fsSL https://anyy.ai/install.sh | VERSION=v0.1.107 sh
curl -fsSL https://anyy.ai/install.sh | ANYY_HOME="$HOME/.local/share/anyy" sh

希望跟隨最新發布時，省略 VERSION；不要寫 VERSION=latest。版本必須是釋出源實際提供的標籤。

自訂鏡像來源使用 ANYY_RELEASE_BASE_URL。它同時提供程式和校驗檔案，所以不是獨立的校驗機構，應只使用你控制或信任的來源。

空間不足時​

臨時目錄需要放下載套件，Home 需要容納新版二進位執行檔並預留安全空間。優先釋放對應位置的空間；接受減少還原記錄時才選：

curl -fsSL https://anyy.ai/install.sh | ANYY_INSTALL_COMPACT=1 sh

緊湊模式保留目前活動版本，可能清理非活動版本；只有仍無法通過空間檢查時，才會進一步移除上一個還原目標。

完成安裝後​

anyy setup
anyy dashboard

先用精靈設定一個模型，再按 Dashboard 提示啟動 Gateway。繼續看快速開始或初始化設定。

同一版本已安裝時，重複安裝會修復入口，不重新替換該版本。日常升級使用 anyy update --check 和 anyy update，詳見更新與解除安裝。

常見安裝失敗​

提示該怎麼做
不支援系統或架構使用表中四個目標之一，不能拿另一種架構的套件強行安裝
缺少指令安裝輸出中點名的工具後重試
空間預檢失敗檢查報錯指向臨時目錄還是 Home；確認可接受後再用緊湊模式
同一 Home 已有安裝／更新等持鎖操作結束，不併發修改版本目錄
checksum 不匹配從可信源重新下載，不繞過驗證
同名入口未替換先用顯示的完整二進位路徑，自己核對那個入口的所屬
No release was activated.本次未切換到候選版本，先處理前面的實際錯誤