用狀態檢查定位問題
排查問題時,先確認環境,再檢查健康狀態,不要看到一項警告就立即重啟:
anyy status
anyy doctor
anyy config
這些指令用於檢視和診斷,不修改產品設定。doctor 的部分 MCP 檢查會探測外部連線;它不是修復指令。
三個指令分別回答什麼
| 指令 | 主要內容 |
|---|---|
status | Profile、預設 Role、Home、時區及來源、Gateway 狀態與監聽、Cron、Heartbeat、儲存、MCP、Prompt Program 狀態 |
doctor | Home/Profile、設定和時區有效性、Gateway 監聽設定狀態、Cron、Heartbeat、MCP 和狀態庫等檢查項 |
config | 設定檔與相關路徑、provider/model、Endpoint、認證資料引用等設定概況 |
status 會嘗試補充 Gateway 即時狀態;離線也能檢視本機資訊,而且不會為檢查建立缺失的狀態資料庫。不要把它當作完整模型、認證資料或各通訊管道的線上測試。doctor 的輸出為 ok、warn、fail、info 加說明;沒有某項失敗不代表該模型已成功回答。
先指定正確的 Profile
anyy --profile work status
anyy --profile work doctor
anyy doctor --config /path/to/config.yaml
--config 只選擇本次診斷檔案,不安裝它。CLI 與 Dashboard 結果不同,到 Dashboard About 對照 Home 和執行中的建置。
依故障類型繼續檢查
- Gateway 無法連線:先
anyy gateway status,需要時再啟動或重啟對應 Profile。 - 模型呼叫失敗:進入 Models 檢查選擇與認證資料,用該頁測試;
config只能反映設定。 - 某個訊息通訊管道異常:執行
anyy channel doctor CHANNEL並檢視對應通訊管道詳情。 - 儲存或狀態庫異常:先做備份,再選擇支援的維護操作。
- MCP 異常:根據實際 transport、process 或認證資料引用檢查項處理,再複查。
需要給腳本讀取時使用:
anyy status --json
anyy doctor --json
JSON 有助於儲存檢查結果;對外傳送前仍應檢查私人路徑、使用者內容和環境細節,已知 Secret 的遮蔽並不代表整份報告都適合公開。