初始化設定

安裝僅將程式安裝到裝置上。要開始對話，還需要為所選 Profile 設定模型連線。建議先設定一個模型，驗證一般對話，再加其他能力。

選對要修改的環境

預設環境：

anyy setup

已有多個 Profile 或自訂 Home 時：

anyy --profile work setup
anyy setup --home /path/to/anyy-home

全域 --profile 放在指令前；子指令的 --home 放在後面。執行 anyy config 可核對目前解析到哪一個 Home。

在互動式終端機執行精靈，選擇 Quick setup，完成：

沒有確認 Write these changes? 時，收集的設定不會作為這次設定寫入；確認後的通訊管道操作會透過 Gateway 直接執行，結果和連線診斷分別報告。

如果主動發起掃描 QR Code 或其他登入，認證過程會在設定提交前聯絡對應服務。這和最後儲存整份設定是不同的操作。

API Key、ChatGPT／Claude Code 訂閱登入、本機 Ollama／LM Studio、相容介面，都以目前版本精靈實際列出的組合為準。完整的協定與模型介面說明可以避免把服務商名稱誤當成原生協定支援。

備用模型要求已有主模型。它是按順序嘗試的路由鏈，不會修復錯誤認證資料；重試與 fallback 的邊界見服務商協定。

如果 Gateway 已可連線，確認寫入模型設定後會請求重新載入；否則下次啟動時讀取儲存的設定。

anyy setup channel 是互動入口。帶上實際 CHANNEL 後，使用的是非互動動作介面，並不表示預選平台的精靈：

anyy setup channel CHANNEL [--home PATH]   [--set INPUT=VALUE]   [--sensitive-fd INPUT=FD]   [--external-locator-fd INPUT=FD]

只使用該平台實際釋出的輸入欄位；敏感值透過檔案描述符傳入，避免放到指令歷史或程序參數。請勿根據其他平台的教學推測欄位名稱。

不同平台的存取策略、配對和連線方式以對應平台手冊為準。Webhook 平台還需要 Gateway 的獨立監聽設定和可連線的 HTTPS 路徑，不是儲存帳號後執行 reload 就會自動開放監聽。

完整精靈還可設定影像／影片理解、圖片產生、語音辨識與合成、網頁搜尋以及 MCP。每一項都可以跳過，稍後在 Dashboard 或對應工具設定中單獨完成。

這些後端的輸入和認證各有條件。設定了影片理解不代表任意介面上傳的檔案都會自動作為影片輸入；實際見多媒體。MCP 的儲存、認證、連線和實際工具呼叫也要分別核對。

anyy config
anyy status
anyy dashboard

先檢查 Home、模型、位址和認證資料引用，再傳送一個小問題。不要只看「儲存成功」。設定外部服務會使用它的網路、帳號額度和資料處理規則。

主要資料位置：

內容	位置
模型、路由及能力設定	`<PROFILE_HOME>/config.yaml`
由 Anyy 管理的 Provider／MCP 認證資料檔案	`<PROFILE_HOME>/secrets/`
通訊管道帳號、加密認證資料、工作階段與執行狀態	`<PROFILE_HOME>/state.db`

認證資料檔案與設定內容分開，檔案權限為 0600。anyy config 報告認證資料引用是否有效，不輸出金鑰原文。