故障排查

先区分命令输入错误、平台拒绝、任务执行失败和等待超时，再检查对应层。提交时保留 job_id / trial_id；不要把 Key、Profile 或任务源码写到诊断日志中。

现象	检查与处理
CLI 退出 2	查看 stderr 中完整 help；全局选项放在 job/task/profile 前；不要同时传位置 dataset 和 --dataset
公网连接缺 Key / 认证失败	检查 ENVLOOP_API_KEY 是有效 EnvLoop Key，而非模型供应商 Key；确认账号和工作区权限；撤销的 Key 需替换
CLI 能连接、SDK 不能	CLI 可读取 .env.local 地址，SDK 不会；为 SDK export 地址和 Key 或显式传参
localhost 连接失败	确认完整平台已启动；网页端口默认 5173，机器 API 路径是 /api/；直连 JobMaster 用其实际端口
Task 校验失败	目录只含 UTF-8 runner.toml 和声明的 main.py / main.sh；不要额外输入文件或符号链接
Dataset 不存在 / 选择歧义	核对平台可用名称、作者版本、namespace、config、split；不要假设 latest 或指定平台没有的来源 revision
wait() 抛 TimeoutError	仅等待超时，任务可能继续；查询状态、再次 wait，或显式 stop
Trial 为 failed	检查终态 exit_code 与 result 的 stderr；脚本失败不会让 SDK wait 自动抛异常
Job 为 completed 但分数异常	分别检查成员失败、评分缺失与 Job 聚合结果；完成不等于 reward=1
本地下一条命令查不到 Trial	纯内存服务不能跨进程恢复；使用远程平台或绑定同一 repository 读取已完成回执
Client.local() 缺依赖	安装 EnvPlatform checkout；远程模式无需该后端
Profile 不存在 / 没有默认	显式使用 name@version，或在本地 registry 设置默认；远程命名 Profile 必须在平台可用
CANCELLATION_UNSUPPORTED	当前执行后端无法支持取消；不要当作已停止或已释放资源

Report an issue

附上客户端版本 / commit、运行模式、脱敏命令、相关 ID、状态和稳定错误 code，以及复现步骤。SDK HTTP 错误已限制为脱敏 code；本地错误可能含路径，分享前检查。

使用 el --help 及资源级 help 核对参数；接口和默认值见 CLI reference、SDK reference。