诊断与故障恢复
诊断页面用于回答三件事:哪里不可用、影响什么、下一步怎样修复。基础页面只显示结论和建议;技术细节在展开后查看。
运行检查
检查通常覆盖 Host Base、账号、项目、执行设备、环境、凭据、本机 MCP 和更新状态。每项都应提供:
- 当前状态和检查时间。
- 对日常使用的影响。
- 推荐的下一步。
- 是否需要再次确认或重启。
blocked 在普通页面显示为“暂不可继续”,degraded 显示为“部分功能不可用”,readiness 统一显示为“运行检查”。原始枚举只进入技术详情。
修复步骤
涉及真实修改时,按以下顺序处理:
- 预览将要改变的内容。
- 核对风险、影响对象和是否需要重启。
- 输入页面要求的确认内容。
- 执行后重新检查结果。
- 支持回滚的修改保留回滚入口。
Host Program 更新、重启和系统级环境修改仍需单独授权,不会因为打开诊断页自动执行。
支持包
支持包只用于协助排障。页面不应直接返回真实绝对路径;导出后仍需要用户自行复核内容,再决定是否发送。
常见恢复方向
| 现象 | 先检查 |
|---|---|
| 项目不可用 | 项目是否已连接、目录是否可访问。 |
| AI 连接异常 | 服务健康状态、账号或接口是否有效。 |
| 执行设备离线 | 当前任务、节点状态和执行方案授权。 |
| 环境部分不可用 | Docker、数据库模式和页面给出的影响说明。 |
| 凭据失效 | 授权是否撤销、是否需要重新连接或轮换。 |
