配置参考
CLI 和 SDK 共用远程传输配置，但只有 CLI 自动读取当前目录 .env.local 中的 API 地址。
| 配置 | CLI | SDK | 含义 |
|---|---|---|---|
ENVLOOP_BASE_URL | 环境或 .env.local | 仅环境 | 平台地址，生产 https://api.envloop.ai |
ENVPLATFORM_API_URL | 兼容 fallback | 兼容 fallback | 旧地址变量 |
ENVLOOP_API_KEY | 仅环境 | 环境或 api_key= | Bearer Key；没有 CLI --api-key |
ENVLOOP_WORKSPACE_ID | 环境或 --workspace-id | 环境或 workspace_id= | 可选已授权 workspace |
ENVLOOP_LOG_LEVEL | 环境 | 环境 | 应用日志配置级别；SDK 导入不安装全局 handler |
Address precedence
CLI：--api-url → 系统环境 → 当前目录 .env.local。同一来源中 ENVLOOP_BASE_URL 优先于旧变量。文件支持带引号的值、行尾注释和 export 前缀；文件中的 Key 或其他变量不会加载。
SDK：Client.remote(api_url=...) → 系统 ENVLOOP_BASE_URL → 系统旧变量。无地址或无效地址报错，不静默改成本地执行。显式 api_key / workspace_id 覆盖对应环境变量。
CLI 未配置任何地址时使用进程内本地后端；显式 repository / work-dir 或 Profile 操作跳过文件中的地址。shell 环境已设置远程地址时，与本地选项组合会报参数错误，先清除地址变量。
URL rules
- 生产：
https://api.envloop.ai。传输兼容已有/v1后缀。 - 本地完整平台：
http://127.0.0.1:5173/api/，保留/api前缀。 - 可信本地 JobMaster：例如
http://127.0.0.1:8000，端口以实际服务为准。 - 公网 HTTP、URL 内凭据、query / fragment 和自动重定向被拒绝。
生产客户端不应使用旧 workers.dev 网页地址发送 Bearer Key。端口由开发配置改变时相应替换。
Local storage and lifecycle
| 参数 / 路径 | 行为 |
|---|---|
work_dir / --work-dir | 本地任务执行与产物目录，不改变日志目录 |
repository_root / --repository-root | 显式绑定仓库；当前不会自动发现顶层路径 |
repository_commit / --repository-commit | 指定固定 commit；省略时解析本地 main，不是当前 HEAD |
logs/trials/<trial_id>/ | 启动时当前目录下的本地 stdout/stderr 日志和 manifest |
repository 用于 Dataset / Profile 和已完成回执；未绑定时状态为实例内存，不跨进程持久化。关闭本地客户端等待已接受执行，关闭远程客户端不取消平台工作。