故障排查
| 现象或错误 | 检查与处理 |
|---|---|
| UNAUTHORIZED / 401 | Token 是否过期、撤销或用户已禁用；确认没有混用管理员或平台凭据 |
| FORBIDDEN / 403 | 检查当前身份、浏览器 Origin 和 CSRF；不要绕过角色边界 |
| NOT_FOUND / 404 | 核对 ID 和当前用户；无权访问与不存在使用相同响应 |
| WORKSPACE_BUSY | 等待当前写操作完成，不要并发执行、写文件和保存 |
| QUOTA_EXCEEDED | 检查运行实例和逻辑工作区配额，停止或删除不再需要的工作区 |
| IDEMPOTENCY_CONFLICT | 同一个幂等键使用了不同请求内容；核对原请求 |
| UNKNOWN / RECOVERY_REQUIRED | 先查看原 operation/execution，再明确决定恢复或删除；不要自动重跑 |
| HASH_MISMATCH / RECOVERY_UNAVAILABLE | 保存点缺失或不一致；停止恢复并检查最后成功记录，不能使用空目录代替 |
MCP 已连接，但模型没有调用工具
Section titled “MCP 已连接，但模型没有调用工具”确认使用已验证的 opencode 1.19.4 配置。工具发现成功只是协议接入的一部分， 还需要实际工具调用事件和服务端状态证明。V2 当前仍处于兼容排查范围。
模型可能把受理描述为完成。请以 execution_get、operation_get 和产物哈希为准。
工作区自动停止
Section titled “工作区自动停止”查询状态不会刷新空闲时间。实例可能在 Agent 思考期间空闲停止；使用原 workspaceId 恢复， 不要创建另一个空工作区替代。需要更长空闲间隔时，在管理员策略允许范围内调整个人设置。
安全保留排查证据
Section titled “安全保留排查证据”记录 workspaceId、executionId、operationId、generation、时间和错误码。 不要在截图、日志、问题报告或归档中加入 Token、完整认证响应或有效下载凭据。