第二十节 错误信息
[!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时，错误块下方出现「购买点券」「升级 · 订阅套餐」两个按钮（其余错误类型不挂 —— 限流 / 鉴权 / 上游故障花钱也修不好）。