第二十节 错误信息
[!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 | 等待回收或主动终止 |