RCH 是远程编译专用技能,用途是把一条明确的编译命令卸载到远程编译器执行,或检查远程编译路径。它只报告结果,不治理重试,也不做修复。
诊断按流水线顺序进行:可用性、配置、钩子、分类、同步、远程编译、worker 压力。第一个失败的阶段即可定位故障,其后阶段在通过前都是噪声。修复按不可逆程度排序:先只读探测和配置检查,再重启守护进程,最后才清理;破坏性清理或 worker 变更必须获得调用方明确授权。
典型失败模式是“本地绿色盲区”:本地 [RCH] local (...) 构建通过被误读为卸载成功,本地回退掩盖了远程声明从未被证明。反模式是重跑构建期待回退原因消失;正确做法是读取记录的回退原因并修复对应阶段。
流程:先采集 rch check、rch doctor --json、worker 状态和相关 [RCH] 摘要;诊断时找出首个失败阶段;只运行一次调用方授权命令或文档化的安全诊断;记录确切命令、已知 worker、退出码、本地回退原因和操作后状态;停止并返回证据。
rch check 退出状态判定就绪性(0 表示就绪,非零表示未就绪)。不要把 rch doctor --json 的 success: true 当作就绪,诊断报告成功可能与守护进程宕机或 worker 不可达并存;以 rch check 判定,用 doctor 查原因。
输出为事实包:状态(remote、local_fallback、failed 或 not_proven)、命令与退出码、worker、摘要行、已检查/未检查面,不含下一步动作。not_proven 是运行时诊断状态,不是 AgentOps 裁决,不具裁决权重。破坏性清理、worker 部署、守护进程配置和远程变更均需调用方明确授权。