第二十節 錯誤訊息
[!ref] 詳解見使用者手冊「故障排查與常見問題」節。
下表收錄使用者最常見的提示文案及其含義與處置建議。
| 提示文案 | 含義 | 處置 |
|---|---|---|
| 服務未就緒 | 背景子程序仍在初始化 | 等待 30 秒；超時則檢視錯誤抽屜 |
| 工具呼叫被拒絕 | 工具被設為停用 / 被簽核拒絕 / 路徑越權 | 檢查工具權限政策與路徑範圍 |
| 模型超時 | LLM 長時間沒有回應 | 重發；或切到備用 Provider |
| 模型傳回為空 | LLM 輸出長度為 0 | 多見於觸發攔截；嘗試改寫 prompt |
| 上下文超長 | 接近模型 context 上限 | 觸發折疊或開新會話 |
| 工作區已鎖定 | 該工作區已有程序持有 | 等待或重新啟動應用 |
| 憑證已過期 | 登入 token 失效 | 重新登入 |
| 點數不足（HTTP 402） | 帳號點數耗盡 | 「前往購券」（購券口徑，與帳號用量 / 伺服器端計費一致，不用「儲值 / 重設 / 餘額」；不再當成可重試錯誤反復重試） |
| 方案額度已用盡（HTTP 429） | 方案配額耗盡 | 「等配額重新整理或升級方案」（不再誤判成限流） |
| 驗證失敗（HTTP 401 / 403） | 需要登入 / Key 失效 | 「重新登入或重發 key」（不再讓你去查配置） |
| 當前模型暫無可用通道（HTTP 503） | 通道全部不可用 | 稍後重試或切換模型 |
| 上游服務例外（HTTP 502 / 529 / overloaded） | 上游問題 | 如實說明是上游；上游驗證失敗時不再誤導你去查自己的 key |
Provider 端點不存在（HTTP 404，endpoint_not_found_error） |
URL 路徑寫錯 | 檢查 Provider Base URL；與"API JSON 傳回的 404 模型不存在"分流 |
| macOS App Translocation | 應用在只讀臨時鏡像執行（未拖進"應用程式"） | 「結束應用 → 拖進『應用程式』→ 重新開啟 → 再檢查更新」 |
| 通道斷開 | IM 通道掉線 | 自動重試；30 秒後仍失敗請重新掃碼 |
| 綁定碼無效 | 6 位碼錯誤或過期（10 分鐘） | 重新生成 |
| 升級簽章無效 | 升級套件簽章校驗失敗 | 自動復原；手動通過應用內升級再試 |
| 技能簽章無效 | 技能包簽章校驗失敗 | 拒絕執行；聯絡發佈方 |
| 背景任務上限 | 在跑背景任務達到 64 | 等待回收或主動終止 |
| 選到不可用的模型 | 為會話選中的模型實際不可用 | 按 路由策略 → 自動修復 處理：關閉 = 報錯；詢問後切換 = 彈「切換備用模型?」確認條（彈不了確認條的場景直接報錯並說明原因）；自動切換 = 改用同名模型的其他 provider 並提示。不會靜默把整個會話降級到別的模型 |
| 無法確定這一輪使用的模型 | 發送前解析模型失敗 | 檢查服務提供方與模型是否啟用；或在模型選擇器裡重新選擇 |
| 服務繁忙，N 秒後自動繼續 | 方案每分鐘請求上限 / 服務提供方限流 | 依倒數等待，或點「換個模型」「停止等待」；主回合、子 Agent 和並行任務共用限流狀態 |
| 服務持續繁忙，N 秒後自動重新開始本輪（第 n/3 次） | 多次重試失敗後等待重新開始本輪 | 等待自動恢復或停止；執行與自動重試期間「重試」停用，開始後舊錯誤列顯示「先前失敗已自動重試」 |
| 模型最近 N 次回復都是「…」…已自動停止 | 複讀空轉停轉（§19.10） | 補充更具體的指示後繼續，或換個模型再試 |
| ⚠️ 本次任務已執行 N 步（使用者當前設定的上限） | 達到「最大執行步數」 | 調大或設為 0（不限）後「繼續」 |
| 磁碟機 X 已被 BitLocker 鎖定 | Windows 專案所在盤被鎖 | 點「BitLocker 已鎖定」調起系統解除鎖定對話框；解除鎖定後自動開啟 |
| 磁碟機 X 目前無法存取（尚未就緒） | 盤未連線 / 未就緒 | 檢查後重試 |
| ❌ 壓縮會話失敗：… | 摘要請求以錯誤收場 | 歷史原樣保留；稍後重試 /compact |
| 「…」的自動修復已放棄 | 產出型自愈連續幾輪沒能糾正 | 人工介入：補充指示或換模型 |
| 遠端連線已斷開 | SSH / 遠端工作區鏈路斷開 | 標題與側邊欄斷連圖示可點重連，重連中顯示轉圈，失敗提示「重連失敗」 |
「用量不足」類錯誤掛直達入口：錯誤類型為
insufficient_balance或quota_exceeded時，錯誤塊下方出現「購買點券」「升級 · 訂閱套餐」兩個按鈕（其餘錯誤類型不掛 —— 限流 / 驗證 / 上游故障花錢也修不好）。