问题排查
先判断问题发生在哪一层：本地准备、连接批准、云端执行、业务接口还是电脑执行器。保留原操作标识，避免重复操作扩大问题。
找不到 xuji 命令
检查 Node.js 和序基工具是否安装在当前环境。可使用准备条件中的绝对路径调用方式；工作目录仍应为目标项目目录。
接入预检失败
| 错误码 | 检查方向 |
|---|---|
CONNECT_CONFIGURATION_REQUIRED | 项目根目录是否有声明文件或受支持适配器 |
CONNECT_TARGET_REQUIRED | 多个目标时是否传入 --target |
CONNECT_TARGET_NOT_FOUND | target 名称是否与声明一致 |
CONNECT_PREPARATION_REQUIRED | 计划和冻结 ZIP 是否已准备 |
CONNECT_CONFIGURATION_MISSING_FIELDS | 根据 missing 字段补齐明确配置 |
CONNECT_ADAPTER_ENVIRONMENT_MISMATCH | 适配器物理环境是否与计划相同 |
CONNECT_PATH_LINK_REJECTED | 路径是否包含符号链接或 junction |
CONNECT_PATH_OUTSIDE_ROOT | 文件是否越过项目根目录 |
批准后连接没有激活
检查原会话状态、批准账号、冻结计划与目标云身份。保持原恢复记录，重新查询已发生的操作。云端返回未知结果时，不直接再建一份连接。
概览有数据，详情不可用
摘要上报和详情查询是不同接口。检查查询动作是否已在项目端实现、连接是否允许、账号是否有权限。记录不可用原因，不把失败转为零数据。
插件已上传但未出现
依次检查候选上传、扫码批准登记、预览与启用。然后检查组件能力、查询动作和当前账号权限。登记不会自动启用。
Runner 没有执行任务
检查电脑是否在线、设备授权、配置摘要、任务计划及阶段是否获准。存在旧执行或未知部署时，先核实停止与结果证据，不手动抹掉状态强制重跑。
提交排查材料
提供组件版本、环境角色、错误码、原操作 ID、复现步骤与已脱敏日志。不要包含密码、完整密钥、短期证明、用户业务记录或真实儿童资料。