@delta-infra/cli 1.0.87 → 1.0.89
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md
CHANGED
|
@@ -218,6 +218,7 @@ delta-cli sandbox kill <sandbox_id>
|
|
|
218
218
|
|------|------|
|
|
219
219
|
| `delta-cli sandbox list` | 列出当前用户的 sandbox 实例 |
|
|
220
220
|
| `delta-cli sandbox providers` | 查看可用计算后端 |
|
|
221
|
+
| `delta-cli sandbox resources [--provider opensandbox\|autodl]` | 查看各后端当前剩余可申请资源（GPU/显存/核心） |
|
|
221
222
|
| `delta-cli sandbox images` | 查看可用镜像列表 |
|
|
222
223
|
| `delta-cli sandbox recommend --cpu N --memory XGi` | 获取资源配置推荐 |
|
|
223
224
|
| `delta-cli sandbox create --image <img> [--no-auto-cleanup]` | 创建 sandbox 容器（`--no-auto-cleanup` 不被自动清理） |
|
|
@@ -421,6 +422,27 @@ export NPM_TOKEN=<your-npm-token>
|
|
|
421
422
|
DELTA_CLI_MIRROR="https://gh-proxy.com/https://github.com" npm install -g @delta-infra/cli
|
|
422
423
|
```
|
|
423
424
|
|
|
425
|
+
## 沙箱内镜像源自动配置
|
|
426
|
+
|
|
427
|
+
创建沙箱时，服务端会**自动检测部署所在网络区域**（中国大陆 / 海外），并在区域为中国大陆时把镜像配置注入到容器里。用户无需任何手动配置，进去即可用。
|
|
428
|
+
|
|
429
|
+
- **中国大陆（domestic）**：服务端自动注入镜像配置，`pip install` / `npm install` / `git clone` / HuggingFace 下载会走国内镜像。
|
|
430
|
+
- **海外（overseas）**：不注入镜像，使用各包管理器官方源。
|
|
431
|
+
- 服务端通过探测 `pypi.org` / `npmjs.org` 的连通性来判断区域（带缓存、探测失败时按海外兜底，即 fail-open）。
|
|
432
|
+
|
|
433
|
+
覆盖的 4 类配置：
|
|
434
|
+
|
|
435
|
+
| 类型 | 说明 | 示例 |
|
|
436
|
+
|------|------|------|
|
|
437
|
+
| pip index-url | Python 包索引 | `https://pypi.tuna.tsinghua.edu.cn/simple` |
|
|
438
|
+
| npm registry | Node 包源 | `https://registry.npmmirror.com` |
|
|
439
|
+
| HF_ENDPOINT | HuggingFace 下载域名 | `https://hf-mirror.com` |
|
|
440
|
+
| git insteadOf | GitHub 克隆代理 | `https://gh-proxy.com/https://github.com` |
|
|
441
|
+
|
|
442
|
+
AutoDL 计算后端默认关闭镜像注入（海外平台），仅当运维明确配置开启后才生效。
|
|
443
|
+
|
|
444
|
+
> **注意区分两套镜像机制**：本沙箱镜像配置针对的是**沙箱里的包管理器**（pip / npm / git / HF）。它与 CLI 自身的下载镜像 `DELTA_CLI_MIRROR` 是两回事——`DELTA_CLI_MIRROR` 只用于**安装 delta-cli 二进制**，不作用于沙箱内。
|
|
445
|
+
|
|
424
446
|
## 技术栈
|
|
425
447
|
|
|
426
448
|
- **语言**: Go 1.23+
|
package/checksums.txt
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
1
|
+
7d508465cf9cd3e646b5c6b40f7455e87d19d50220549ba99fc2cba8446e4620 delta-cli-darwin-amd64.tar.gz
|
|
2
|
+
c37f4cd4dff81a202a2f9902ba44385a4f5d8117270ea07d2fa929c9a42fbbfb delta-cli-darwin-arm64.tar.gz
|
|
3
|
+
e8d891e90578a487e225621d682435b003fbfb681544f152dddd69eb76fcc95d delta-cli-linux-amd64.tar.gz
|
|
4
|
+
debd0241feb4a02c2a46054767f826a35d7abcd22f804bc134ec2df0ab5b85cd delta-cli-linux-arm64.tar.gz
|
|
5
|
+
c5274e69364a89293062b886e7cfb41934259c442180531d76c66855de18d16f delta-cli-windows-amd64.zip
|
package/package.json
CHANGED
|
@@ -23,6 +23,13 @@ metadata:
|
|
|
23
23
|
- delta-cli 不内嵌默认凭证，运行前必须按 `delta-shared` 完成认证配置。
|
|
24
24
|
- sandbox_id 必须来自真实返回，不要凭用户口述猜测。
|
|
25
25
|
|
|
26
|
+
## 沙箱环境（镜像源）
|
|
27
|
+
|
|
28
|
+
- **国内部署（domestic）**：沙箱创建时服务端已自动注入国内镜像配置。`pip install` / `npm install` / `git clone` / HuggingFace 下载**无需额外配置**，直接可用。覆盖：pip index-url（pypi.tuna.tsinghua.edu.cn）、npm registry（npmmirror）、HF_ENDPOINT（hf-mirror.com）、git insteadOf（github 代理）。
|
|
29
|
+
- **海外部署（overseas）**：不注入镜像，使用官方源。
|
|
30
|
+
- **AutoDL 沙箱**：默认不注入镜像（默认关闭），按官方源使用。
|
|
31
|
+
- 若镜像源异常，优先检查沙箱所在区域的网络，而不是假设沙箱未配置。
|
|
32
|
+
|
|
26
33
|
## 强制规则（违规则任务视为失败）
|
|
27
34
|
|
|
28
35
|
1. **必须使用 delta-cli**：所有 sandbox 操作必须通过 `delta-cli sandbox <subcommand>` 执行。**禁止**用 Python（urllib/httpx/requests）或任何 SDK 直接调用 HTTP API。delta-cli 提供类型化错误输出（`error.type`），是 AI agent 正确解析错误的唯一途径。
|
|
@@ -52,11 +59,14 @@ metadata:
|
|
|
52
59
|
|
|
53
60
|
- 后台任务成功后仍需按规则 2/3 销毁 sandbox。
|
|
54
61
|
|
|
55
|
-
8.
|
|
62
|
+
8. **写入文件默认落到 sandbox 的 working-directory，禁止使用 Shell 变量路径**：
|
|
63
|
+
- ✅ **推荐**：`delta-cli sandbox write <id> --source train.py`（不传 `--path`，默认写到 `<working-directory>/train.py`）
|
|
64
|
+
- ✅ **显式指定**：`delta-cli sandbox write <id> --path <working-directory>/train.py --source train.py`（`--path` 传相对路径也会自动以 working-directory 为前缀）
|
|
56
65
|
- ❌ **禁止**：`--source "$WORKSPACE_ROOT/train.py"`、`--source "$(pwd)/train.py"`（Shell 展开路径 → 空文件或失败）
|
|
57
66
|
- ❌ **禁止**：`--data "大量代码..."`（Shell 转义问题）
|
|
58
|
-
-
|
|
59
|
-
-
|
|
67
|
+
- ❌ **不建议**：`--path /workspace/train.py` 这类直接写工作目录根、落在 `{user_id}` 之外的路径——kill 后 `rclone sync` 不会写回 OSS，文件不持久化。
|
|
68
|
+
- 查询 sandbox 的 working-directory：`delta-cli sandbox working-directory <id>`（返回 `data.path`）。`run`/`run-bg` 引用脚本时用 `python <working-directory>/train.py` 的完整路径。
|
|
69
|
+
- 少量配置（< 20 行）可用 `--data "..."`，此时必须带 `--path`（无法从文件名推断）。`--mode 755` 可设置文件权限。
|
|
60
70
|
|
|
61
71
|
9. **每个 `run-bg` 生成独立 `execution_id`**：每次调用 `sandbox run-bg` 都会返回一个唯一的 `execution_id`，多个后台任务之间通过它区分。务必保存每次返回的 `execution_id` 并与任务对应，后续通过 `sandbox logs <id> --execution-id <exec_id>` 分别查询各任务的结果。同步 `sandbox run` 无需 `execution_id`，结果直接返回。
|
|
62
72
|
|
|
@@ -67,7 +77,7 @@ metadata:
|
|
|
67
77
|
- 只有在**解析 JSON**（例如从 `sandbox read` 的信封中提取 `summary` 并写入 `result.json`）时，才使用 `python3`/`python_repl`。
|
|
68
78
|
|
|
69
79
|
11. **代码/数据必须经由 `delta-cli sandbox write` 进入 sandbox**
|
|
70
|
-
- 所有要送进 sandbox 执行的脚本、配置、数据文件，**必须**通过 `delta-cli sandbox write <id> --
|
|
80
|
+
- 所有要送进 sandbox 执行的脚本、配置、数据文件，**必须**通过 `delta-cli sandbox write <id> --source <本地文件名>` 写入，默认落到该 sandbox 的 working-directory（`/workspace/{user_id}/{sandbox_id}/`，可用 `delta-cli sandbox working-directory <id>` 查询），位于 OSS 同步范围内、kill 后可持久化。
|
|
71
81
|
- 不要把脚本先写到宿主 workspace 再依赖同步；宿主 workspace 的文件对 sandbox 内部不可见。
|
|
72
82
|
- 本规则关注的是“入口统一为 `sandbox write`”，不针对任何特定宿主工具。无论宿主提供何种文件操作接口，最终都要把内容送到 sandbox 内部。
|
|
73
83
|
|
|
@@ -130,6 +140,7 @@ required_outputs:
|
|
|
130
140
|
| **发现** | |
|
|
131
141
|
| 查看可用镜像 | `sandbox images` |
|
|
132
142
|
| 查看可用 provider | `sandbox providers` |
|
|
143
|
+
| 查看剩余可申请资源 | `sandbox resources [--provider <opensandbox/autodl>]` — 各后端 GPU/显存/核心可用量，`gpu_types` 结构随 provider 不同（opensandbox 有 `vgpu`/`core`/`memory_mib`，autodl 有 `idle_gpu_num`） |
|
|
133
144
|
| 获取资源推荐 | `sandbox recommend --cpu N --memory XGi [--gpu N] [--gpu-mem N]` |
|
|
134
145
|
| 列出当前用户的 sandbox | `sandbox list [--status <running/finished/killed/error>] [--start-time <ISO8601>] [--end-time <ISO8601>] [--provider <opensandbox/autodl>] [--sandbox-id <id>] [--days N]` |
|
|
135
146
|
| **生命周期** | |
|
|
@@ -146,7 +157,8 @@ required_outputs:
|
|
|
146
157
|
| **文件操作** | |
|
|
147
158
|
| 读取文件 | `sandbox read <id> --path <path> [--output <本地路径> --tail N --grep <pattern> --offset N --limit N --context N --max-bytes N --parse-json]` |
|
|
148
159
|
| 拉取文件/目录 | `sandbox pull <id> --source <沙箱路径> --target <本地路径> [--recursive] [--pattern <glob>]` — 单文件或目录递归，含 sha1 校验（mirror of upload，flag 方向与 upload 相反：source=远程，target=本地） |
|
|
149
|
-
|
|
|
160
|
+
| 查询工作目录 | `sandbox working-directory <id>`（返回 `data.path`，形如 `/workspace/{user_id}/{sandbox_id}`）|
|
|
161
|
+
| 写入文件 | `sandbox write <id> --source <文件名>`（不传 `--path` 默认写到 working-directory）；`--path <路径>` 传相对路径自动加 working-directory 前缀，绝对路径原样使用 |
|
|
150
162
|
| 批量写入 | `sandbox write-multiple <id> --entry <远程路径>=<本地路径> [--entry ...]` |
|
|
151
163
|
| 上传目录 | `sandbox upload <id> --source <本地目录> --target <沙箱路径>` |
|
|
152
164
|
| 列出目录 | `sandbox ls <id> --path <路径>`（默认 `.`）|
|
|
@@ -173,18 +185,18 @@ required_outputs:
|
|
|
173
185
|
- `--no-auto-cleanup`：加此 flag 后该 sandbox **不会被自动清理**（服务端超时回收 + 本地周期 cleanup_stale 均跳过），只能通过显式 `sandbox kill`/`finish` 销毁。仅当任务确实需要跨越周期清理长期存活时才使用，任务结束后必须主动销毁，避免资源泄漏。
|
|
174
186
|
- **禁止在 create 成功后反复调用 `sandbox status` 轮询**。`sandbox create` 返回时 sandbox 已经就绪，直接用它返回的 `data.sandbox_id` 执行 `write`/`run` 即可。多余的轮询会增加工具调用次数且没有任何收益。
|
|
175
187
|
3. **写入代码/数据**：
|
|
176
|
-
- **单个文件**：`delta-cli sandbox write <id> --path /
|
|
188
|
+
- **单个文件**：`delta-cli sandbox write <id> --source <文件名>` — 不传 `--path`，默认写到该 sandbox 的 working-directory（`/workspace/{user_id}/{sandbox_id}/`，可用 `delta-cli sandbox working-directory <id>` 查询）。`--source` 只传本地文件名（如 `--source train.py`），**禁止**使用 `"$WORKSPACE_ROOT/train.py"` 或 `$(pwd)/train.py` 等 Shell 变量路径。`--source` 让 CLI 自行读取本地文件，不会经过 Shell 展开，是最安全的方式。若需指定路径，`--path <相对路径>` 会自动加 working-directory 前缀，绝对路径原样使用（**不建议**写 `/workspace/<filename>` 这种落在 `{user_id}` 之外的位置，kill 后不持久化）。写入后返回的 `size` 字段是实际磁盘字节数（来自 stat 验证），可对比确认写入完整性。少量配置（<20 行）可用 `--data "..."`，但此时必须带 `--path`。文件路径和扩展名由镜像中的运行时决定。
|
|
177
189
|
- **批量写入**：`sandbox write-multiple <id> --entry <远程路径>=<本地路径> [--entry ...]`（远程路径在 `=` 左边，本地路径在右边，`--data` 批量写入不可用）
|
|
178
190
|
- **上传目录**：`sandbox upload <id> --source <本地目录> --target <沙箱路径>` — CLI 将本地目录打包为 tar.gz，通过 multipart/form-data 上传，服务端自动解压到 target 目录。返回每个文件的路径、大小、模式。上传后 CLI 自动对比本地和远程文件清单做完整性校验（大小不匹配、多余文件等会告警）。
|
|
179
191
|
- **注意**：`--source` 是**本地目录路径**，`--target` 是**沙箱内的目标目录**，target 目录不存在会自动创建。
|
|
180
192
|
- 支持嵌套目录，空目录也会被创建。
|
|
181
193
|
- **写后验证（可选）**：`sandbox stat <id> --path <path>` 确认文件存在且 size 符合预期即可。**不要**用 `sandbox ls` + `sandbox read` 把刚写入的文件读回宿主再逐字对比；无异常时不需要读回。
|
|
182
194
|
4. **运行命令**：
|
|
183
|
-
- **短任务（预计 ≤ 60 秒）**：`delta-cli sandbox run <id> --command "<命令>" --timeout <秒>` 同步执行，命令的 stdout/stderr 通过 SSE **以原始 `data:` 帧逐帧透传到 stdout**（无末尾信封），`exit_code` / `log_file` / `execution_id` 从 `complete` 帧读取。完整 `stdout` 在完成后写入 run envelope 日志文件（`log_file` 字段），需要读全文或提取末尾 JSON 时用 `sandbox read`，**不要**再调用 `sandbox logs`。可通过 `--log-file <路径>` 自定义 run envelope 日志文件路径；默认值为 `/workspace/{user_id}/{sandbox_id}/{execution_id}/delta-result-{execution_id}.json`（以服务端返回的 `log_file`
|
|
184
|
-
- Python：`python
|
|
185
|
-
- Node.js：`node
|
|
186
|
-
- Go：`go run
|
|
187
|
-
- Shell：`bash
|
|
195
|
+
- **短任务（预计 ≤ 60 秒）**：`delta-cli sandbox run <id> --command "<命令>" --timeout <秒>` 同步执行，命令的 stdout/stderr 通过 SSE **以原始 `data:` 帧逐帧透传到 stdout**（无末尾信封），`exit_code` / `log_file` / `execution_id` 从 `complete` 帧读取。完整 `stdout` 在完成后写入 run envelope 日志文件（`log_file` 字段），需要读全文或提取末尾 JSON 时用 `sandbox read`，**不要**再调用 `sandbox logs`。可通过 `--log-file <路径>` 自定义 run envelope 日志文件路径；默认值为 `/workspace/{user_id}/{sandbox_id}/{execution_id}/delta-result-{execution_id}.json`（以服务端返回的 `log_file` 字段为准）。脚本经 `sandbox write` 落盘后位于 working-directory，运行命令需用完整路径 `<working-directory>/<文件名>`（先 `sandbox working-directory <id>` 查询）。根据镜像中的运行时构造命令，常见示例（`<wd>` 为 working-directory）：
|
|
196
|
+
- Python：`python <wd>/train.py`
|
|
197
|
+
- Node.js：`node <wd>/app.js`
|
|
198
|
+
- Go：`go run <wd>/main.go`
|
|
199
|
+
- Shell：`bash <wd>/run.sh`
|
|
188
200
|
- **长任务（预计 > 60 秒，如下载模型、训练、编译、大规模数据处理）**：`delta-cli sandbox run-bg <id> --command "<命令>" --timeout <秒> [--log-file <路径>]` 提交后台任务，获得 `execution_id` 后通过以下命令查询：
|
|
189
201
|
- `delta-cli sandbox logs <id> --execution-id <execution_id> --stream` — SSE 实时跟随，原始 `data:` 帧逐帧透传到 stdout，直到 `complete` 事件（含 `exit_code`/`log_file`），无末尾信封。
|
|
190
202
|
- `delta-cli sandbox logs <id> --execution-id <execution_id>` — 快照信封，返回 `stdout_tail`（末尾 800 字节）、`stderr_tail`（末尾 200 字节）、`stdout_size`、`stderr_size`、`cursor`、`running`、`finished`、`exit_code`、`log_file`（完成后）。当 `finished=true` 时认为完成，完整输出需读取 `log_file`。
|
|
@@ -256,8 +268,8 @@ required_outputs:
|
|
|
256
268
|
命令执行完毕后，推荐在 `stdout` 末尾打印一行**独立的结构化 JSON**。例如：
|
|
257
269
|
|
|
258
270
|
- CUDA 检查：`{"status":"ok","torch_version":"2.5.1+cu121","cuda_available":true,"device_name":"NVIDIA H100 80GB HBM3"}`
|
|
259
|
-
- 训练任务：`{"status":"ok","epochs":10,"final_loss":0.12,"final_accuracy":0.94,"model_file":"
|
|
260
|
-
- 数据处理：`{"status":"ok","input_rows":10000,"output_rows":9876,"output_file":"
|
|
271
|
+
- 训练任务：`{"status":"ok","epochs":10,"final_loss":0.12,"final_accuracy":0.94,"model_file":"<wd>/model.pt"}`
|
|
272
|
+
- 数据处理：`{"status":"ok","input_rows":10000,"output_rows":9876,"output_file":"<wd>/output.csv"}`
|
|
261
273
|
|
|
262
274
|
这样 SKILL 可以用同一套代码把它提取到 `result.json` 的 `summary` 字段，再生成 `RESULT:` 行。
|
|
263
275
|
|
|
@@ -8,6 +8,7 @@
|
|
|
8
8
|
|------|------|
|
|
9
9
|
| `sandbox list [--status <running/finished/killed/error>] [--start-time <ISO8601>] [--end-time <ISO8601>] [--provider <opensandbox/autodl>] [--sandbox-id <id>] [--days N]` | 列出当前用户的 sandbox（与 `ls` 不同：这是列 **沙箱实例**）；支持按状态/时间/Provider/sandbox_id 过滤；时间范围优先级 start_time/end_time > days > 默认 7 天 |
|
|
10
10
|
| `sandbox providers` | 查看可用的计算后端（opensandbox / autodl） |
|
|
11
|
+
| `sandbox resources [--provider <opensandbox/autodl>]` | 查看各后端当前**剩余可申请**资源（GPU/显存/核心）；`gpu_types` 按后端原样透传，结构随 provider 不同——opensandbox 含 `vgpu`/`core`/`memory_mib` 的 `total/used/available`，autodl 含 `total_gpu_num`/`idle_gpu_num` |
|
|
11
12
|
| `sandbox images` | 查看可用镜像列表 |
|
|
12
13
|
| `sandbox recommend --cpu N --memory XGi [--gpu N] [--gpu-mem N]` | 获取资源配置推荐 |
|
|
13
14
|
|
|
@@ -35,9 +36,10 @@
|
|
|
35
36
|
| 命令 | 说明 |
|
|
36
37
|
|------|------|
|
|
37
38
|
| `sandbox read <id> --path <path> [--output <本地路径>] [--tail N] [--grep <pattern>] [--offset N] [--limit N] [--context N] [--max-bytes N] [--parse-json]` | 读取文件；返回 `content` + `size` + `content_length`；`--output <path>` 保存到本地；`--tail/--grep` 用于过滤；非 UTF-8 文件 CLI 自动走 base64 fallback |
|
|
38
|
-
| `sandbox
|
|
39
|
-
| `sandbox write <id> --path
|
|
40
|
-
| `sandbox write
|
|
39
|
+
| `sandbox working-directory <id>` | 查询 sandbox 当前工作目录（绝对路径 `/workspace/{user_id}/{sandbox_id}`） |
|
|
40
|
+
| `sandbox write <id> [--path <路径>] --source <文件名>` | 写入文件（推荐）。不传 `--path` 默认写到 working-directory（`<working-directory>/<文件名>`）；相对 `--path` 也会拼到 working-directory 下；仅绝对 `--path` 原样使用（但 `/workspace/<文件名>` 根路径不在 OSS 同步范围内，不推荐） |
|
|
41
|
+
| `sandbox write <id> --path <绝对路径> --data "..."` | 写入少量内联内容（`--data` 无源文件名，必须显式传 `--path`） |
|
|
42
|
+
| `sandbox write-multiple <id> --entry <src=path> [--entry ...]` | 批量写入多个文件（目标 `path` 相对则同样拼到 working-directory） |
|
|
41
43
|
| `sandbox pull <id> --source <沙箱路径> --target <本地路径> [--recursive] [--pattern <glob>]` | 拉取文件/目录到本地（mirror of `upload`，flag 方向相反：`--source`=远程沙箱路径，`--target`=本地路径）；单文件自动识别；目录默认递归；CLI 端 + 服务端双向 sha1 完整性校验 |
|
|
42
44
|
| `sandbox ls <id> --path <path>` | 列出目录内容（默认 `.`） |
|
|
43
45
|
| `sandbox stat <id> --path <path>` | 获取文件元数据（size / mode / owner / group） |
|
|
@@ -7,11 +7,11 @@
|
|
|
7
7
|
1. **查看可用镜像** `delta-cli sandbox images` — 查询服务端支持的镜像列表。镜像决定了容器内的语言运行时（Python / Node.js / Go / Java / Rust 等），根据用户的技术栈和 GPU/CPU 需求匹配。
|
|
8
8
|
2. **列出现有 sandbox（可选）** `delta-cli sandbox list` — 查看当前用户已创建的活跃 sandbox，避免重复创建
|
|
9
9
|
3. **创建** `delta-cli sandbox create --image <image> --cpu 4 --memory 16Gi --gpu 1 --gpu-mem 8000 --max-life 120`（创建后立即可用，无需连接；--max-life 指定 sandbox 最大存活时间（分钟），默认 30。`--no-auto-cleanup` 可让 sandbox 不被自动清理，仅显式 kill/finish 可销毁。`--provider autodl` 可指定使用 AutoDL 后端。）
|
|
10
|
-
4. **写入代码/数据** `delta-cli sandbox write <id> --
|
|
11
|
-
5. **运行命令** —
|
|
10
|
+
4. **写入代码/数据** `delta-cli sandbox write <id> --source <文件名>` — 将本地文件直接写入 sandbox，**不传 `--path` 默认写到该 sandbox 的 working-directory**（`/workspace/{user_id}/{sandbox_id}/<文件名>`，在 OSS 同步范围内，kill 后文件不会丢）。写前可用 `delta-cli sandbox working-directory <id>` 确认路径。**必须**使用相对源路径（如 `--source infer.py`），禁止使用 `"$WORKSPACE_ROOT/<filename>"` 或 `$(pwd)/...`。相对 `--path` 也会拼到 working-directory 下；仅绝对 `--path` 原样使用（`/workspace/<filename>` 根路径不在 OSS 同步范围，不推荐）。也可用 `--data "..."` 写入少量内联内容（需显式 `--path`），`--mode 755` 可设置文件权限。写入后返回的 `size` 字段是 stat 验证后的实际磁盘字节数，可确认写入完整。批量写入用 `write-multiple`。文件路径和扩展名由镜像中的运行时决定。
|
|
11
|
+
5. **运行命令** — 先 `delta-cli sandbox working-directory <id>` 查询 `<wd>`，再根据镜像中的运行时构造命令，常见示例：`python <wd>/train.py`（Python）、`node <wd>/app.js`（Node.js）、`go run <wd>/main.go`（Go）、`bash <wd>/run.sh`（Shell）
|
|
12
12
|
- **短任务 ≤60s**：`delta-cli sandbox run <id> --command "<命令>" --timeout <秒>` 同步执行，SSE 原始 `data:` 帧透传到 stdout（无末尾信封），`exit_code`/`log_file` 从 `complete` 帧读取，完整 stdout 写入 log_file
|
|
13
13
|
- **长任务 >60s**：`delta-cli sandbox run-bg <id> --command "<命令>" --timeout <秒> --wait` 后台执行（推荐），或 `run-bg` + `logs` 手动轮询 (run-bg --wait 默认带 --summary；不加 --wait 立即返回 {execution_id, sandbox_id})
|
|
14
|
-
6. **读取结果** `delta-cli sandbox read <id> --path
|
|
14
|
+
6. **读取结果** `delta-cli sandbox read <id> --path <wd>/result.json`（`<wd>` 为 working-directory，可用 `delta-cli sandbox working-directory <id>` 查询） — 返回 `content`（内容）、`size`（磁盘字节，来自 stat）、`content_length`（字符数）。读不存在的文件返回 error 而非空内容。
|
|
15
15
|
7. **销毁** `delta-cli sandbox kill <id>`（如需保存结果用 finish，finish 会自动销毁）
|
|
16
16
|
|
|
17
17
|
> **注意**：server 端没有 sandbox 的自动过期或 TTL 机制，不 kill 会永久占用 GPU 资源。请务必在任务结束后销毁。
|
|
@@ -60,15 +60,17 @@ SKILL 会把它提取为 `result.json` 的 `summary`，并生成 `result_summary
|
|
|
60
60
|
## 2. 运行用户已有的脚本
|
|
61
61
|
|
|
62
62
|
```text
|
|
63
|
-
在 sandbox <sandbox_id> 中运行
|
|
63
|
+
在 sandbox <sandbox_id> 中运行 <wd>/train.py，参数为 --epochs 10 --batch-size 32。
|
|
64
64
|
```
|
|
65
65
|
|
|
66
|
+
> `<wd>` 为该 sandbox 的 working-directory（`/workspace/{user_id}/{sandbox_id}`，先 `delta-cli sandbox working-directory <id>` 查询）。
|
|
67
|
+
|
|
66
68
|
说明：文件已存在，用中性动词 `运行`，不使用 `创建` 等承诺动词。
|
|
67
69
|
|
|
68
70
|
## 3. 安装依赖并执行命令
|
|
69
71
|
|
|
70
72
|
```text
|
|
71
|
-
在 sandbox 中运行 pip install -r
|
|
73
|
+
在 sandbox 中运行 pip install -r <wd>/requirements.txt，然后运行 python <wd>/app.py。
|
|
72
74
|
```
|
|
73
75
|
|
|
74
76
|
说明：依赖安装和命令执行都没有落盘新文件，使用中性动词描述。
|
|
@@ -82,20 +84,20 @@ SKILL 会把它提取为 `result.json` 的 `summary`，并生成 `result_summary
|
|
|
82
84
|
说明：
|
|
83
85
|
|
|
84
86
|
- 训练日志可能很长，不要让 skill 去读整段日志再摘要；让脚本自己输出关键指标。
|
|
85
|
-
- 推荐脚本最终打印：`{"status":"ok","epochs":10,"final_loss":0.023,"final_accuracy":0.992,"model_file":"
|
|
87
|
+
- 推荐脚本最终打印：`{"status":"ok","epochs":10,"final_loss":0.023,"final_accuracy":0.992,"model_file":"<wd>/model.pt"}`
|
|
86
88
|
- skill 会把它提取为 `result.json` 的 `summary`，最终输出 `RESULT: exit_code=0, status=ok, epochs=10, ...`。
|
|
87
89
|
- 如需保存完整模型文件，可再用 `sandbox read` 或 `sandbox upload` 处理，不属于 `result.json` 的摘要范围。
|
|
88
90
|
|
|
89
91
|
## 5. 通用数据处理
|
|
90
92
|
|
|
91
93
|
```text
|
|
92
|
-
在 sandbox 中运行数据处理命令，读取
|
|
94
|
+
在 sandbox 中运行数据处理命令，读取 <wd>/input.csv，输出 <wd>/output.csv，并在 stdout 末尾打印包含 input_rows、output_rows、output_file 的结构化 JSON。
|
|
93
95
|
```
|
|
94
96
|
|
|
95
97
|
说明：
|
|
96
98
|
|
|
97
|
-
- 推荐脚本最终打印：`{"status":"ok","input_rows":10000,"output_rows":9876,"output_file":"
|
|
98
|
-
- skill 会把它提取为 `result.json` 的 `summary`，最终输出 `RESULT: exit_code=0, status=ok, input_rows=10000, output_rows=9876, output_file
|
|
99
|
+
- 推荐脚本最终打印：`{"status":"ok","input_rows":10000,"output_rows":9876,"output_file":"<wd>/output.csv"}`
|
|
100
|
+
- skill 会把它提取为 `result.json` 的 `summary`，最终输出 `RESULT: exit_code=0, status=ok, input_rows=10000, output_rows=9876, output_file=<wd>/output.csv`。
|
|
99
101
|
|
|
100
102
|
## 6. 模型推理（Qwen / LLM / 视觉等）
|
|
101
103
|
|
|
@@ -120,7 +122,7 @@ SKILL 会把它提取为 `result.json` 的 `summary`，并生成 `result_summary
|
|
|
120
122
|
- 只有在 skill 会真实创建文件时，才在请求中显式写出 `*.py` / `*.json` / `*.csv` 等扩展名。
|
|
121
123
|
- 不要使用 `脚本需输出...` 这类把代码片段直接跟在承诺动词后的句式。
|
|
122
124
|
- **任务完成的标准是执行结果，不是脚本文件存在**。Planner 和 skill 都要以本地 `result.json` 的生成作为完成标志；`required_outputs` 必须声明 `.json`，不要只声明 `{"kind": "file"}`。
|
|
123
|
-
- **`skill_request` 里不要出现完整代码块或宿主文件路径概念**（如 `@ROOT/...`、`/Users/...`）。脚本应通过 `delta-cli sandbox write
|
|
125
|
+
- **`skill_request` 里不要出现完整代码块或宿主文件路径概念**（如 `@ROOT/...`、`/Users/...`）。脚本应通过 `delta-cli sandbox write <id> --source <文件名>` 写入 sandbox 的 working-directory（`/workspace/{user_id}/{sandbox_id}/...`）。
|
|
124
126
|
|
|
125
127
|
## 本地 `result.json` 的内容约定
|
|
126
128
|
|