@delta-infra/cli 1.1.16 → 1.1.18

package/README.md

@@ -2,6 +2,12 @@
 
 Delta Agent Cloud 的命令行工具，用于管理 Delta Sandbox GPU/CPU 计算任务和调用 Science 工具。
 
+## v1.1.18 Release Notes
+
+- Translate the three active agent skills (`delta-shared`, `delta-sandbox`, and `delta-science`) and their maintained references into English.
+- Validate representative agent workflows for authentication-state reporting, sandbox resource discovery, live Science catalogue discovery, and safe handling of tools without a request schema.
+- Include all three skill directories in the source release commit and regenerate platform binary checksums as part of the release.
+
 ## 安装
 
 ### 方式一：npx 一键安装（推荐）
@@ -182,11 +188,22 @@ delta-cli auth status
 # ⚠️ 资源语义：`--memory` 是容器 CPU 内存【总量】（每沙箱一份）；`--gpu-mem` 是【每张卡】的显存（MiB）——
 # `--gpu 2 --gpu-mem 8000` = 每卡 8000MiB、总显存 16000MiB（内部 OpenSandbox/HAMi 后端直接写入 HAMi 每卡注解；
 # 注意云端 runpod 后端将 --gpu-mem 视为总显存÷卡数）。单卡显存上限可查 `sandbox resources`（memory_mib）。
+# ⚠️ 资源语义：`--shm-size` 是容器 /dev/shm 大小（默认仅 64Mi），PyTorch DataLoader(num_workers>0)/
+# multiprocessing、Chromium 系内核等共享内存不足时报 "No space left on device"/"Bus error"，此时调大；
+# 必须带 Gi/Mi 单位（4G/512M 会被归一化为 4Gi/512Mi，裸数字会被服务端拒绝），且不得超过 --memory。
+# `--devices` 申请宿主机设备直通（逗号分隔，如 kvm → 容器内 /dev/kvm，用于嵌套虚拟化）：属权限提升，
+# 服务端白名单未开启时创建会被明确拒绝（不会静默忽略）。两者仅私有算力生效，第三方算力忽略。
 delta-cli sandbox create \
   --image image.yangtzeailab.com/opensandbox/pytorch-cuda13:latest \
   --cpu 4 --memory 16Gi --gpu 1 \
   --max-life 120
 
+# DataLoader 多进程/需要嵌套虚拟化时：调大 /dev/shm 并申请 /dev/kvm（shm 不得超过 memory）
+delta-cli sandbox create \
+  --image image.yangtzeailab.com/opensandbox/pytorch-cuda13:latest \
+  --cpu 4 --memory 8Gi --shm-size 4Gi --devices kvm \
+  --max-life 120
+
 # 需要长期存活、不被自动清理的 sandbox：加 --no-auto-cleanup（仅显式 kill/finish 可销毁）
 delta-cli sandbox create \
   --image image.yangtzeailab.com/opensandbox/pytorch-cuda13:latest \
@@ -241,7 +258,7 @@ delta-cli sandbox kill <sandbox_id>
 | `delta-cli sandbox resources [--provider opensandbox\|autodl]` | 查看各后端当前剩余可申请资源（GPU/显存/核心） |
 | `delta-cli sandbox images` | 查看可用镜像列表（每条含 `image_name`/`tags`/`description`/`supports_shared_workspace`；`supports_shared_workspace=true` 表示该算力可开共享工作区（opensandbox/autodl），可与 `--shared-workspace` 搭配；实际播种/写回由平台创建时探测镜像内 rclone 决定） |
 | `delta-cli sandbox recommend --cpu N --memory XGi` | 获取资源配置推荐 |
-| `delta-cli sandbox create --image <img> [--no-auto-cleanup] [--shared-workspace=true\|false]` | 创建 sandbox 容器（`--no-auto-cleanup` 不被自动清理；`--shared-workspace` 默认 true：启用共享工作区（播种/写回由平台创建时探测镜像内 rclone 决定，镜像无 rclone 时跳过、数据不跨沙箱持久）；false 跳过播种/写回，适合快速任务） |
+| `delta-cli sandbox create --image <img> [--shm-size XGi] [--devices kvm] [--no-auto-cleanup] [--shared-workspace=true\|false]` | 创建 sandbox 容器（`--no-auto-cleanup` 不被自动清理；`--shared-workspace` 默认 true：启用共享工作区（播种/写回由平台创建时探测镜像内 rclone 决定，镜像无 rclone 时跳过、数据不跨沙箱持久）；false 跳过播种/写回，适合快速任务；`--shm-size` 调大 /dev/shm（默认 64Mi，**必须带 Gi/Mi 单位**且 ≤ `--memory`，PyTorch DataLoader/multiprocessing 场景常用）；`--devices` 逗号分隔的宿主机设备令牌（`kvm` → /dev/kvm，嵌套虚拟化），**属权限提升**，服务端白名单未开启时**明确拒绝**；`--shm-size`/`--devices` 仅私有算力生效、第三方算力忽略） |
 | `delta-cli sandbox extend <id> --max-life N` | **动态延长运行中** sandbox 的 max-life（可增可减，N 需大于已存活分钟且 ≤10080；提前回收用 `kill`/`finish`）；不带 `--max-life` 时查询当前生命周期（已存活/剩余/到期时间）；`status` 输出含 `data.lifecycle` 生命周期摘要（已存活/剩余/到期；生命周期接口不可用时省略） |
 | `delta-cli sandbox connect <id>` | 连接 sandbox |
 | `delta-cli sandbox status <id>` | 查看 sandbox 状态 |
@@ -293,10 +310,10 @@ delta-cli sandbox kill <sandbox_id>
 v1.1.1 起线上 catalog 已包含 `qe`（Quantum ESPRESSO DFT，20 个端点：任务提交/查询/
 日志/artifact/PP 库等）与 `materials-design`（持久化材料代理建模，7 个端点：
 health/capabilities/job-submit(multipart)/job-status/job-cancel 等）。用法见
-Skill 文档 `skills/delta-science/references/qe.md` 与
-`skills/delta-science/references/materials-design.md`。
-云端 XRD 的相识别、artifact、CIF 模拟和精修契约见
-`skills/delta-science/references/xrd.md`。
+Skill 文档 `skills/delta-science/references/qe.md` 与
+`skills/delta-science/references/materials-design.md`。
+云端 XRD 的相识别、artifact、CIF 模拟和精修契约见
+`skills/delta-science/references/xrd.md`。
 
 ## 输出格式
 
@@ -338,7 +355,7 @@ Skill 文件位于 `skills/` 目录：
 - `delta-shared/` — 全局通用规则（认证、配置、错误处理）
 - `delta-sandbox/` — Sandbox 操作指南（生命周期、命令路由）
 - `delta-science/` — 唯一 Science 入口，包含统一 Delta CLI wrapper、跨工具工作流和
-  PubChem、RDKit、pymatgen、XRD、GSAS-II、LAMMPS、Delta-BO、LDM-BO、SynBO、AntBO
+  PubChem、RDKit、pymatgen、XRD、GSAS-II、LAMMPS、Delta-BO、LDM-BO、SynBO、AntBO
   的按需 reference
 
 Memento 等宿主只需要选择 `delta-science`。Skill 根据自然语言科研目标选择 tool 和
@@ -439,16 +456,17 @@ make release
 ```bash
 export GH_TOKEN=<your-github-pat>
 export NPM_TOKEN=<your-npm-token>
-./release.sh v1.1.16
+./release.sh v1.1.18
 ```
 
 脚本执行步骤：
 1. 更新 `package.json` 版本号。
 2. 交叉编译 5 个平台二进制文件（优先 Docker + `make release`，Docker 不可用时回退本地 Go 工具链）。
-3. 在 `bin/` 目录生成 `.tar.gz` / `.zip` 归档。
-4. 通过 `.ci/publish-github-release.js` 创建 GitHub Release 并上传资产。
+3. 在 `bin/` 目录生成 `.tar.gz` / `.zip` 归档及 SHA-256 checksums，并更新仓库根目录的 `checksums.txt`。
+4. 通过 `.ci/publish-github-release.js` 创建 GitHub Release 并上传二进制归档及 checksums。
 5. 同步 npm 脚本、README 与全部 Skills 到公开仓库 `yzailab/delta-infra-cli`。
 6. 执行 `npm publish --access public` 发布 `@delta-infra/cli`。
+7. 创建本地 source commit 和 Git tag；只有显式设置 `PUSH_SOURCE=1` 时才会推送 source GitLab remote。
 
 需要提前安装 `gh` CLI、Node.js/npm，并配置 `GH_TOKEN` 与 `NPM_TOKEN`。CI 流程可参考 `.gitlab-ci.yml`。
 

package/checksums.txt

@@ -1,5 +1,5 @@
-14ab0d943d50009a3caa7d5ee2db13e557de36dc39a347e67ae90f88cae582d6 *delta-cli-darwin-amd64.tar.gz
-998c5188c25ec474818cf8aca047e349303d26208e900379b8e7e053babc7d82 *delta-cli-darwin-arm64.tar.gz
-c019843ac23cdf3f09f902686c6cdb0bfaa31136aa7d89cb32989992b1f2c255 *delta-cli-linux-amd64.tar.gz
-6ca4f2b73f99d1f78f339e2f171a7223d16b0a7a9e2e4667c1f8e418e9c9bedd *delta-cli-linux-arm64.tar.gz
-954bbd88f9ba7f706ec2e5106e0bba850553d809816a23cac30e2882a9753792 *delta-cli-windows-amd64.zip
+3fd24fd43adacb420e155e3e636beb43af693112b6b3c70b92de706f74fd85c6 *delta-cli-darwin-amd64.tar.gz
+c134129e704633f45108b03dcdcd40bf3c60eab0b29ef0227ca5b75d11da2a06 *delta-cli-darwin-arm64.tar.gz
+4e1a7f8d4aea6e1c49390ccdba84b9dae8b20d39eababcb7b01a8d1d6789f310 *delta-cli-linux-amd64.tar.gz
+b609bace1814405a3eceb0f298e95056d27630e92b9b489c90bc48890ea52eaa *delta-cli-linux-arm64.tar.gz
+06bddaa9d5733720b61985e2552036f660ebc2076afece1a1674d5c56a4f8b6b *delta-cli-windows-amd64.zip

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@delta-infra/cli",
-  "version": "1.1.16",
+  "version": "1.1.18",
   "description": "Delta Agent Cloud CLI for sandbox compute and science tools.",
   "bin": {
     "delta-cli": "scripts/run.js"