Skip to content
进入工作台

诊断与故障恢复

诊断页面用于回答三件事:哪里不可用、影响什么、下一步怎样修复。基础页面只显示结论和建议;技术细节在展开后查看。

运行检查

检查通常覆盖 Host Base、账号、项目、执行设备、环境、凭据、本机 MCP 和更新状态。每项都应提供:

  • 当前状态和检查时间。
  • 对日常使用的影响。
  • 推荐的下一步。
  • 是否需要再次确认或重启。

blocked 在普通页面显示为“暂不可继续”,degraded 显示为“部分功能不可用”,readiness 统一显示为“运行检查”。原始枚举只进入技术详情。

修复步骤

涉及真实修改时,按以下顺序处理:

  1. 预览将要改变的内容。
  2. 核对风险、影响对象和是否需要重启。
  3. 输入页面要求的确认内容。
  4. 执行后重新检查结果。
  5. 支持回滚的修改保留回滚入口。

Host Program 更新、重启和系统级环境修改仍需单独授权,不会因为打开诊断页自动执行。

支持包

支持包只用于协助排障。页面不应直接返回真实绝对路径;导出后仍需要用户自行复核内容,再决定是否发送。

常见恢复方向

现象先检查
项目不可用项目是否已连接、目录是否可访问。
AI 连接异常服务健康状态、账号或接口是否有效。
执行设备离线当前任务、节点状态和执行方案授权。
环境部分不可用Docker、数据库模式和页面给出的影响说明。
凭据失效授权是否撤销、是否需要重新连接或轮换。

Git 状态怎样判断

本地工作台先读取当前分支、工作副本和现有远端跟踪引用,再按用户点击“重新检查”或后台刷新执行只读 fetch。检查不会自动合并、变基、重置、推送、提交或丢弃变化。

页面状态含义建议动作
远端不可确认本次 fetch 没有在检查窗口内取得可信结果,可能是服务响应慢、代理路线、VPN、DNS 或凭据交互导致;它不等于凭据一定无效,也不能继续把缓存引用当作当前远端。保持工作副本不变,检查当前仓库使用的 Git 访问方案后重新检查。
远端领先且本地没有独有提交当前分支可以只快进到远端。先复核新增提交,再执行 git pull --ff-only;命令拒绝产生合并提交。
双方都有独有提交本地与远端已经分叉。先查看两边提交和差异,再决定合并或变基;工作台不会代替你改写历史。
index.lock 已存在另一个 Git 写操作仍在运行,或上次进程异常退出留下锁文件。先确认没有 Git 进程;工作台只会清理能证明失去持有者的陈旧锁,不会删除活跃锁。
出现 .maw/project-space-runtime.json 未提交文件旧版工作台曾把本机 Project Space 草稿写进项目协议目录,可能让 Git 就绪检查误判工作副本不干净。新版会把可证明为工作台生成且未跟踪的旧文件迁到 .local/project-space-runtime.json;已提交、内容异常或归属不明时不会自动移动,请先人工核对。

Git 认证和网络路线分别配置。若只有 GitHub 仓库需要代理,可为 GitHub 项目使用带独立安全路由的 Git 访问方案,其它仓库继续选择“强制直连”或“继承本机”;代理只注入使用该方案的 Git 子进程,不改变整台电脑或其它仓库的网络设置。

没有 remote 不一定是错误。同一账号在当前安装操作、且本机项目与云端项目已经精确映射时,单人任务可以使用任务级同机源码证明,在本机隔离工作树执行;跨设备、团队交接或云端节点执行才要求受管 Git remote。映射或安装身份不一致时,工作台会停止执行并要求重新核对。

如果任务显示节点已经执行,但真实项目的分支、HEAD 和工作树完全没有变化,不要直接验收通过。先在任务结果中确认是否出现真实 task worktree 与变更文件;新版 Host 会让执行节点通过 loopback 解析本机项目,并在本地 Task 版本、安装、节点、映射或冻结 Git 基线不一致时停止。Runner 审计目录里的孤立文件不属于项目交付,应记录“验收未通过 / 返工”后原位重试。

原位重试时,本地工作台会先保存“已排队”,再请求云端重排同一个任务;执行节点即使立即领取,也会读取这份本机事实。若旧版曾在重试后立刻显示“无法建立项目源码工作区”,升级 Host 后直接重试同一任务即可,不需要新建 WorkItem,也不需要为同机项目临时增加 remote。

同一个任务会复用稳定的审计工作区,但每轮结果必须独立判断。新版 Runner 只用本轮 execution-result.md 自身的时间确认结果是否新鲜;即使本轮失败摘要刚刚生成,也不会把更早一轮的成功结果误算为本轮完成。若页面显示完成而真实 task worktree、目标文件和项目 HEAD 均未变化,应选择“验收未通过”保留证据,不要直接归档。

排障完成后还应复核两个长期事实面:项目手册能否读到本轮新增的项目文档,审计中心是否按时间保留每次失败、修复、重试和最终验收。不同 evidence key 的失败记录不应被合并;同一 evidence key 的重放不应重复出现。若两者只显示最终状态而没有过程证据,应视为审计缺口,而不是“任务已完成”。

阶段提示也分两类:云端显示团队声明,本机显示当前工作副本和证据推断。两者不同但不影响当前任务时只是说明信息;只有差异会阻断任务、验收或发布时,页面才应给出针对该对象的操作,不需要为了让两个标签相同而单独“校准”。