第二十節 錯誤訊息
[!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 | 等待回收或主動終止 |