跳至主要內容

用狀態檢查定位問題

排查問題時,先確認環境,再檢查健康狀態,不要看到一項警告就立即重啟:

anyy status
anyy doctor
anyy config

這些指令用於檢視和診斷,不修改產品設定。doctor 的部分 MCP 檢查會探測外部連線;它不是修復指令。

三個指令分別回答什麼​

指令主要內容
statusProfile、預設 Role、Home、時區及來源、Gateway 狀態與監聽、Cron、Heartbeat、儲存、MCP、Prompt Program 狀態
doctorHome/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 的遮蔽並不代表整份報告都適合公開。