常見問題與排查
先確認版本和環境，再改設定：
anyy --version
anyy config
anyy status
anyy doctor
anyy gateway status
config 用於核對模型、認證資料引用和路徑；status 報告執行環境狀態。Doctor 只執行其實際檢查項，不代表替你驗證所有模型帳號或每一種通訊管道。
釐清基本概念
Anyy 就是本機模型嗎？ 不是。Anyy 是常駐個人助理，可以連線遠端服務，也可以使用相容的本機模型服務。
本機儲存是否意味著不連網？ 不是。模型、網頁、MCP 和訊息平台可能收到任務所需內容，見資料與隱私。
Profile、Role、Session 怎麼選？ 獨立資料與認證資料用 Profile；同一環境內不同助理身分用 Role；一個持續話題用 Session。Codemode 不透過 Role 切換開關。
工作階段歷史就是長期記憶嗎？ 不是。穩定事實和偏好有單獨的記憶規則；臨時工作進度不應自動變成個人資料。
能刪除一段對話嗎？ 底層 session.delete RPC 可以刪除符合空閒條件的工作階段，但 v0.1.107 的常用 CLI、TUI、Dashboard 還沒有通用的刪除入口。不要為刪除一段聊天而刪除整個 Profile，詳見工作階段。
安裝完成後仍無法使用
| 現象 | 先檢查什麼 |
|---|---|
找不到 anyy | 按安裝器的 Binary: 完整路徑驗證版本，再修 PATH |
| 空間不足 | 看錯誤指向臨時目錄還是 Home；緊湊模式會減少還原歷史 |
| 更新後介面仍是舊版 | 分別核對目前指令、Gateway、Dashboard 的版本和程序 |
| Dashboard 打不開 | anyy dashboard --status；確認本次位址、監聽範圍和 Gateway 狀態 |
| 舊權杖連結無法再次登入 | 領取登入狀態的權杖不是可永久重複使用連結；在同一已登入瀏覽器繼續，或獲取目前有效入口 |
模型或媒體不工作
先在 模型（Models） 頁面檢查服務商、協定、位址、模型 ID 和認證資料引用。不要假設同一個模型名在所有介面都可用。
Test connection 只檢查模型目錄連通性和模型是否在目錄中，不執行聊天產生。儲存設定後，在新工作階段中選擇目標並傳送一個簡短問題；若設定了備用模型，應確認回覆未改由其他目標提供，再把它當作這個模型的實際驗收。
圖片／影片理解、圖片產生、STT 和 TTS 不是同一條路由。聊天正常不代表語音或影像後端正常；檔案上傳成功也不代表它被辨識為後端需要的媒體型別。入口和限制見多媒體及語音。
切換模型或思考強度可能影響上下文和快取；不要只憑一次呼叫的費用判斷設定未生效。路由、重試和虛擬模型的邊界見服務商協定。
對話、佇列或歷史看起來不對
- 看不到舊工作階段：先對照 Dashboard 與
anyy config的 Profile、Home，切換環境不會遷移資料。 - 執行中傳送後沒有立即回覆：檢視輸入框上方佇列；若要引導目前任務，使用該項的 提前執行（Steer）。
- 希望中斷：按對話或 TUI的實際控制操作，不要把取消觀察當作撤回已接受輸入。
- 對話很長或想換歷史分支：看壓縮與分支，區分介面入口與僅 RPC 的操作。
- 系統通知重開後找不到：先核對工作階段和 Profile，再看通知；一般訊息和獨立通知有不同的儲存職責。
工具、Skills 和 MCP
工具找不到： 核對目前工作階段啟用的名稱、Profile 預設選擇、後端狀態與 MCP exposure。已註冊不代表目前已啟用；Codemode和工具搜尋也有自己的發現規則。
指令或檔案工具報錯： 檢視路徑、作業系統權限、工具輸出和執行限制。工具直接執行，不存在舊核准模式或 ChangePlan 等待流程；真正缺少資訊時仍可能提出澄清問題。
Skill 不顯示： 核對目前環境、啟用狀態和適用介面，執行 anyy skills reload 後在下一次提問重試，檢視目錄警告。代管安裝只支援本機 ZIP，不接受 GitHub 位址或目錄安裝。系統 Skill 的移除／切換開關規則與使用者 Skill 不同。
MCP 連線成功卻沒有工具： 分別核對伺服器是否啟用、是否確實提供工具、direct／codemode／deferred／hidden 暴露方式及目前發現能力。不要把 Probe、設定儲存或 OAuth 登入成功當作實際呼叫成功。
上下文引用被拒絕： 檢視上下文引用允許的來源、範圍和限制，縮小到必要內容；不要把認證資料、私有內部位址或未經檢查的敏感變更放進請求。
訊息平台和自動化
| 現象 | 處理順序 |
|---|---|
| 收不到訊息 | 帳號狀態／連線 → 平台訂閱或 Webhook 監聽 → 實際存取策略與配對 |
| 已傳送但操作回條未知 | 區分本機交付、平台接受和逐則確認；不是所有轉接器都支援 Ack |
| 陌生人可存取 | 停用帳號或收緊實際提供的策略、撤銷不需要的配對授權，再排查認證資料 |
| 定時任務沒有觸發 | 檢查啟用狀態、時區、計畫及 Gateway，再在建立任務的聊天中要求立即執行指定任務，核對最終歷史和投遞 |
| 任務一直等待 | 區分待執行、模型／工具執行、澄清和投遞階段，不要只看一個 Pending 標籤 |
| 背景工作不見了 | 核對來源環境和工作階段，按背景工作的對應介面查詢 |
每個平台的實際設定入口和限制以平台手冊為準。
備份和復原
復原目標必須是新的、不存在的目錄，不能覆蓋正在使用的 Profile。一般備份預設不額外收集代管的 secrets/ 和 mcp/oauth/ 目錄，遺漏的認證材料需要重新連線或從明確包含它們的受保護封存復原。設定和工作檔案中原有的內聯金鑰仍可能進入一般備份，不能據此認為封存沒有敏感內容。詳見備份與復原。
仍無法定位時，只收集版本、遮蔽敏感資訊後的環境資訊、準確操作、安全的錯誤文字和故障前的變更。不要公開存取權杖、API Key、OAuth Code、平台 Secrets、完整環境變數、私訊內容或未經檢查的備份。