@delta-infra/cli 1.0.61 → 1.0.63

package/README.md

@@ -12,9 +12,10 @@ npx @delta-infra/cli@latest install
 
 该命令会依次完成：
 1. **全局安装** `@delta-infra/cli`（含 Go 二进制）
-2. **安装 AI Skills** 到 `~/.agents/skills/`，自动适配 Claude Code、Codex、OpenCode、Cursor 等 AI 工具
-3. **初始化配置** `delta-cli config init`（交互式，非 TTY 跳过）
-4. **身份认证** `delta-cli auth login`（交互式，非 TTY 跳过）
+2. **选择 AI 工具平台**（可多选）：通用 Agent 目录 `~/.agents/skills/`（Codex/Cursor/OpenCode）、Claude Code `~/.claude/skills/`、OpenCode 原生 `~/.config/opencode/skills/`、Cursor `~/.cursor/skills/`、Memento-S 开发模式 `~/memento_s/skills/`
+3. **安装 AI Skills** 到所选平台的 skills 目录
+4. **初始化配置** `delta-cli config init`（交互式，非 TTY 跳过）
+5. **身份认证** `delta-cli auth login`（交互式，非 TTY 跳过）
 
 AI Agent 也可以直接使用以下指令完成安装：
 
@@ -26,7 +27,7 @@ AI Agent 也可以直接使用以下指令完成安装：
 npx @delta-infra/cli@latest uninstall
 ```
 
-清理全局包、AI Skills 和配置文件。
+清理全局包、所有已知平台的 AI Skills 和配置文件。
 
 ### 升级
 
@@ -197,8 +198,6 @@ delta-cli sandbox kill <sandbox_id>
 | `delta-cli auth login` | 交互式登录 |
 | `delta-cli auth login --token <token>` | Token 认证 |
 | `delta-cli auth status` | 查看认证状态 |
-| `delta-cli update check` | 检查更新（deprecated，请用 `upgrade --check`） |
-| `delta-cli update` | 安装最新版本（deprecated，请用 `upgrade`） |
 | `delta-cli upgrade` | 升级 CLI 和 AI Skills 到最新版本 |
 | `delta-cli upgrade --check` | 检查是否有可用更新 |
 | `delta-cli upgrade --cli-only` | 只升级 CLI 二进制 |

package/checksums.txt

@@ -1,5 +1,5 @@
-3770b173894f9548536df67e995e346bdfd819ea784f6c517a758e95ddeab70d  delta-cli-darwin-amd64.tar.gz
-5a5f78039dd015d719840cf10da059778f0bed8c934e64f5678b7c7157eb5715  delta-cli-darwin-arm64.tar.gz
-71ca0548c7eecac71683c969165f050aea10800a7994facb81241a88c80477b5  delta-cli-linux-amd64.tar.gz
-5f3b5920f6ddf23a4cbd60b2fd57b804def6f8e9c287ea418f8f299ceb1f41ba  delta-cli-linux-arm64.tar.gz
-8769479c00c62fc560d96e75e762f5aa7431c570f7c866972dfcf829530c0dc2  delta-cli-windows-amd64.zip
+e5019395b7d3dbb9cbdd01b16d0407fe986ec4577ab839b92cf05f376d8f60a3  delta-cli-darwin-amd64.tar.gz
+2d68e0ff3f65b688235fed99b7011c41949e9c222bd2ce9be41b2a9df67472ba  delta-cli-darwin-arm64.tar.gz
+2c3ea59c3d5f98af2f9200d8e940c1b08d374307dabc6976e31aa38cf6929fa3  delta-cli-linux-amd64.tar.gz
+16c184a9cd9dd7d08da26a59c16364c23117a9edd82278f61c3e726595b6001d  delta-cli-linux-arm64.tar.gz
+a9e85daa3fb33ecf2c4db821d247df8cdd3c78b04a8af1ea08e997ef9117ff85  delta-cli-windows-amd64.zip

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@delta-infra/cli",
-  "version": "1.0.61",
+  "version": "1.0.63",
   "description": "Delta Sandbox CLI",
   "bin": {
     "delta-cli": "scripts/run.js"

package/scripts/install-wizard.js

@@ -14,6 +14,38 @@ const GH_MIRRORS = ["https://gh.ddlc.top", "https://ghproxy.net", "https://gh-pr
 const CONFIG_DIR = path.join(osHomedir(), ".delta-infra");
 const isWindows = process.platform === "win32";
 
+const PLATFORM_PATHS = {
+  agents:   [".agents", "skills"],
+  claude:   [".claude", "skills"],
+  opencode: [".config", "opencode", "skills"],
+  cursor:   [".cursor", "skills"],
+  mementos: ["memento_s", "skills"],
+};
+
+const PLATFORM_LABELS = {
+  zh: {
+    agents:   "通用 Agent 目录 (~/.agents/skills) — Codex / Cursor / OpenCode",
+    claude:   "Claude Code (~/.claude/skills)",
+    opencode: "OpenCode 原生目录 (~/.config/opencode/skills)",
+    cursor:   "Cursor (~/.cursor/skills)",
+    mementos: "Memento-S 开发模式 (~/memento_s/skills)",
+  },
+  en: {
+    agents:   "Generic agent dir (~/.agents/skills) — Codex / Cursor / OpenCode",
+    claude:   "Claude Code (~/.claude/skills)",
+    opencode: "OpenCode native dir (~/.config/opencode/skills)",
+    cursor:   "Cursor (~/.cursor/skills)",
+    mementos: "Memento-S dev mode (~/memento_s/skills)",
+  },
+};
+
+const SKILL_NAMES = ["delta-sandbox", "delta-shared"];
+const LANG = "zh";
+
+function platformSkillDir(platform) {
+  return path.join(osHomedir(), ...PLATFORM_PATHS[platform]);
+}
+
 // ── i18n ────────────────────────────────────────────────────────────────────
 
 const messages = {
@@ -26,8 +58,10 @@ const messages = {
     step1Upgraded:  "已升级到 v%s",
     step1Fail:      "全局安装失败。运行以下命令重试: npm install -g %s",
     step2:          "安装 AI Skills",
+    step2SelectPlatforms: "选择需要安装 Delta Skills 的 AI 工具平台（可多选）",
     step2Spinner:   "正在安装 Skills...",
     step2Done:      "Skills 已安装",
+    step2DoneFor:   "已安装至: %s",
     step2Skip:      "已安装，跳过",
     step2Fail:      "Skills 安装失败。运行以下命令重试: npx skills add %s -y -g",
     step3:          "正在初始化配置...",
@@ -52,8 +86,10 @@ const messages = {
     step1Upgraded:  "Upgraded to v%s",
     step1Fail:      "Failed to install globally. Run manually: npm install -g %s",
     step2:          "Install AI skills",
+    step2SelectPlatforms: "Select AI tool platforms to install Delta Skills (multi-select)",
     step2Spinner:   "Installing skills...",
     step2Done:      "Skills installed",
+    step2DoneFor:   "Installed to: %s",
     step2Skip:      "Already installed. Skipped",
     step2Fail:      "Failed to install skills. Run manually: npx skills add %s -y -g",
     step3:          "Initializing config...",
@@ -252,7 +288,7 @@ async function stepInstallGlobally(msg) {
   }
 }
 
-function installSkillsFromLocalPackage() {
+function findPackageSkillsDir() {
   const candidates = [];
   try {
     const npmRoot = runSilent("npm", ["root", "-g"], { timeout: 10000 })
@@ -261,54 +297,69 @@ function installSkillsFromLocalPackage() {
   } catch {}
   candidates.push(path.join(__dirname, "..", "skills"));
 
-  let pkgSkillsDir = null;
   for (const c of candidates) {
     if (fs.existsSync(path.join(c, "delta-sandbox", "SKILL.md"))) {
-      pkgSkillsDir = c;
-      break;
+      return c;
     }
   }
-  if (!pkgSkillsDir) return false;
-
-  const home = osHomedir();
-  const agentsDir = path.join(home, ".agents", "skills");
-  fs.mkdirSync(agentsDir, { recursive: true });
+  return null;
+}
 
-  for (const skill of ["delta-sandbox", "delta-shared"]) {
-    const src = path.join(pkgSkillsDir, skill);
-    if (!fs.existsSync(src)) continue;
-    const dst = path.join(agentsDir, skill);
-    fs.rmSync(dst, { recursive: true, force: true });
-    fs.cpSync(src, dst, { recursive: true });
-  }
+function installSkillsFromLocalPackage(platforms) {
+  const pkgSkillsDir = findPackageSkillsDir();
+  if (!pkgSkillsDir) return false;
 
-  const claudeDir = path.join(home, ".claude", "skills");
-  if (fs.existsSync(path.dirname(claudeDir))) {
-    fs.mkdirSync(claudeDir, { recursive: true });
-    for (const skill of ["delta-sandbox", "delta-shared"]) {
-      const linkPath = path.join(claudeDir, skill);
-      const targetPath = path.join(agentsDir, skill);
-      try {
-        fs.rmSync(linkPath, { force: true });
-        fs.symlinkSync(path.relative(path.dirname(linkPath), targetPath), linkPath);
-      } catch { /* symlink may fail on some platforms */ }
+  for (const platform of platforms) {
+    const targetDir = platformSkillDir(platform);
+    fs.mkdirSync(targetDir, { recursive: true });
+    for (const skill of SKILL_NAMES) {
+      const src = path.join(pkgSkillsDir, skill);
+      if (!fs.existsSync(src)) continue;
+      const dst = path.join(targetDir, skill);
+      try { fs.rmSync(dst, { recursive: true, force: true }); } catch {}
+      fs.cpSync(src, dst, { recursive: true });
     }
   }
-
   return true;
 }
 
-async function stepInstallSkills(msg) {
+async function stepSelectPlatforms(msg) {
+  if (!isInteractiveEnv()) {
+    return ["agents"];
+  }
+  const labels = PLATFORM_LABELS[LANG];
+  const defaultPlatforms = fs.existsSync(path.dirname(platformSkillDir("claude")))
+    ? ["agents", "claude"]
+    : ["agents"];
+  const selected = await p.multiselect({
+    message: msg.step2SelectPlatforms,
+    options: Object.keys(PLATFORM_PATHS).map((key) => ({
+      value: key,
+      label: labels[key],
+    })),
+    initialValues: defaultPlatforms,
+    required: true,
+  });
+  handleCancel(selected, msg);
+  return selected;
+}
+
+async function stepInstallSkills(msg, platforms) {
   const s = createSpinner();
   s.start(msg.step2Spinner);
   try {
     try {
-      if (installSkillsFromLocalPackage()) {
+      if (installSkillsFromLocalPackage(platforms)) {
         s.stop(msg.step2Done);
+        p.log.info(fmt(msg.step2DoneFor, platforms.join(", ")));
         return;
       }
     } catch { }
 
+    if (!platforms.includes("agents")) {
+      throw new Error("local skills package not found and agent dir not selected");
+    }
+
     const urls = [
       `https://gh.ddlc.top/https://github.com/${SKILLS_REPO}`,
       `https://ghproxy.net/https://github.com/${SKILLS_REPO}`,
@@ -323,6 +374,7 @@ async function stepInstallSkills(msg) {
           env: { ...process.env, GIT_TERMINAL_PROMPT: "0" },
         });
         s.stop(msg.step2Done);
+        p.log.info(fmt(msg.step2DoneFor, "agents"));
         return;
       } catch (e) {
         lastErr = e;
@@ -406,17 +458,15 @@ async function stepUninstallSkills(msg) {
   const s = createSpinner();
   s.start("Removing AI skills...");
 
-  const home = osHomedir();
-  const agentsDir = path.join(home, ".agents", "skills");
-  const claudeDir = path.join(home, ".claude", "skills");
   let removedLocally = false;
-
-  for (const skill of ["delta-sandbox", "delta-shared"]) {
-    try {
-      fs.rmSync(path.join(agentsDir, skill), { recursive: true, force: true });
-      fs.rmSync(path.join(claudeDir, skill), { force: true });
-      removedLocally = true;
-    } catch { }
+  for (const platform of Object.keys(PLATFORM_PATHS)) {
+    const dir = platformSkillDir(platform);
+    for (const skill of SKILL_NAMES) {
+      try {
+        fs.rmSync(path.join(dir, skill), { recursive: true, force: true });
+        removedLocally = true;
+      } catch { }
+    }
   }
 
   if (removedLocally) {
@@ -466,14 +516,16 @@ async function doInstall() {
   if (isInteractive) {
     p.intro(messages.zh.setup);
     await stepInstallGlobally(messages.zh);
-    await stepInstallSkills(messages.zh);
+    const platforms = await stepSelectPlatforms(messages.zh);
+    await stepInstallSkills(messages.zh, platforms);
     await stepConfigInit(messages.zh);
     await stepAuthLogin(messages.zh);
     p.outro(messages.zh.done);
   } else {
     console.log(messages.zh.setup);
     await stepInstallGlobally(messages.zh);
-    await stepInstallSkills(messages.zh);
+    const platforms = ["agents"];
+    await stepInstallSkills(messages.zh, platforms);
     console.log(messages.zh.nonTtyHint);
   }
 }

package/skills/delta-sandbox/SKILL.md

@@ -49,7 +49,7 @@ metadata:
    - `finished=true` + `exit_code!=0` → 失败  
    - `running=true` → 仍运行
 
-   **故障诊断**：连续 3 次 `running=true` 且 `stderr_tail`/`cursor` 无变化且距离提交超过 60 秒 → 用 `sandbox status <id>` 检查 sandbox 是否存活。注意：`cursor` 字段无 `omitempty`，永远会出现在响应中（即使为 0）；`stderr_tail` 默认只保留 **最后 200 字节** stderr 片段（CLI 硬编码 `tailString(s, 200)`，按字节截取；ASCII 文本等同于 200 字符，多字节 UTF-8 可能被截断），`cursor=0` 通常意味着服务端从 provider 还没读到任何 stderr 行。
+   **故障诊断**：连续 3 次 `running=true` 且 `stderr_tail`/`stdout_tail`/`cursor` 无变化且距离提交超过 60 秒 → 用 `sandbox status <id>` 检查 sandbox 是否存活。注意：`cursor` 字段无 `omitempty`，永远会出现在响应中（即使为 0）；`stderr_tail` 默认只保留 **最后 200 字节** stderr 片段，`stdout_tail` 默认保留 **最后 800 字节** stdout 片段（CLI 硬编码 `tailString(s, n)`，按字节截取；ASCII 文本等同于 n 字符，多字节 UTF-8 可能被截断），`cursor=0` 通常意味着服务端从 provider 还没读到任何 stderr 行。
 
    - 后台任务成功后仍需按规则 2/3 销毁 sandbox。
 
@@ -142,7 +142,7 @@ required_outputs:
 | **命令执行** | |
 | 同步运行命令（≤60s） | `sandbox run <id> --command "..." [--timeout <秒>] [--summary/--no-summary] [--artifacts]` |
 | 后台运行命令（>60s） | `sandbox run-bg <id> --command "..." [--timeout <秒>] [--wait] [--summary/--no-summary] [--artifacts]` |
-| 查看后台日志 | `sandbox logs <id> --execution-id <exec_id> [--tail N --grep <pattern> --context N --max-bytes N]` |
+| 查看后台日志 | `sandbox logs <id> --execution-id <exec_id> [--tail N --grep <pattern> --context N]` |
 | 中断后台命令 | `sandbox cancel <id> --execution-id <exec_id>` |
 | **文件操作** | |
 | 读取文件 | `sandbox read <id> --path <path> [--output <本地路径> --tail N --grep <pattern> --offset N --limit N --context N --max-bytes N --parse-json]` |
@@ -187,7 +187,7 @@ required_outputs:
      - Go：`go run /workspace/main.go`
      - Shell：`bash /workspace/run.sh`
    - **长任务（预计 > 60 秒，如下载模型、训练、编译、大规模数据处理）**：`delta-cli sandbox run-bg <id> --command "<命令>" --timeout <秒> [--log-file <路径>]` 提交后台任务，获得 `execution_id` 后通过以下命令轮询：
-      - `delta-cli sandbox logs <id> --execution-id <execution_id>` — 返回 `cursor`、`running`、`finished`、`exit_code`、`log_file`（完成后）。当 `finished=true` 时认为完成，完整输出需读取 `log_file`。
+       - `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`。
            禁止对长任务使用同步 `sandbox run`
 
    **推荐实践**：让 sandbox 脚本在 `stdout` 末尾打印一个独立的结构化 JSON 对象（例如 `{"status":"ok", ...}`），CLI 的 `--summary` 默认会自动反向扫描 stdout 末尾 JSON 提取为 `data.result_summary` 字段。这样即使 `stdout` 前面是大量训练/下载日志，skill 也无需让大模型去“读整段日志再摘要”。

package/skills/delta-sandbox/references/commands.md

@@ -27,7 +27,7 @@
 |------|------|
 | `sandbox run <id> --command "..." [--timeout N] [--summary/--no-summary] [--artifacts]` | 同步运行命令；默认 `--summary` 开启，返回 JSON 中 `summary` 字段已含 stdout 末尾 JSON 提取结果；`--artifacts` 附带 workspace 产物清单 |
 | `sandbox run-bg <id> --command "..." [--timeout N] [--wait] [--summary/--no-summary] [--artifacts]` | 后台运行命令；不加 `--wait` 立即返回 `{execution_id, sandbox_id}`；加 `--wait` 等待完成返回含 `summary` 的完整结果 |
-| `sandbox logs <id> --execution-id <eid> [--tail N --grep <pattern> --context N --max-bytes N]` | 获取后台命令日志；**默认返回 `stderr_tail`（CLI 硬编码 `tailString(s, 200)` 截取最后 200 字节，ASCII 等同 200 字符）+ `stderr_size` + `cursor`**，避免上下文爆炸；可用 `--tail/--grep` 过滤；**`cursor` 字段无 `omitempty`，0 也常驻响应**；**stdout 不通过此接口暴露**，需在 `finished=true` 后读 `log_file`。 |
+| `sandbox logs <id> --execution-id <eid> [--tail N --grep <pattern> --context N]` | 获取后台命令日志；**默认返回 `stdout_tail`（末尾 800 字节）+ `stderr_tail`（末尾 200 字节）+ `stderr_size` + `cursor`**，总计约 1KB，避免上下文爆炸；`--tail N` 同时作用于 stdout 和 stderr（各取尾 N 行）；`--grep <pattern>` 同时过滤 stdout 和 stderr（正则）；`--context N` 提供 grep 匹配行前后 N 行上下文（同时用于 stdout 和 stderr）；**`cursor` 字段无 `omitempty`，0 也常驻响应**。 |
 | `sandbox cancel <id> --execution-id <eid>` | 中断正在运行的后台命令 |
 
 ## 文件操作

package/skills/delta-sandbox/references/lifecycle.md

@@ -51,30 +51,30 @@ delta-cli sandbox kill <id>
 `sandbox logs` 返回的数据结构为：
 
 ```json
-{"ok":true,"data":{"sandbox_id":"...","execution_id":"...","stderr_tail":"...","stderr_size":1234,"cursor":5,"running":false,"finished":true,"exit_code":0,"log_file":"/tmp/delta-result-...json"}}
+{"ok":true,"data":{"sandbox_id":"...","execution_id":"...","stdout_tail":"...","stderr_tail":"...","stdout_size":1234,"stderr_size":1234,"cursor":5,"running":false,"finished":true,"exit_code":0,"log_file":"/tmp/delta-result-...json"}}
 ```
 
 字段说明：
 - `sandbox_id` / `execution_id` — 与请求一致
-- `stderr_tail` — CLI 默认保留的 **最后 200 字节** stderr 片段（CLI 硬编码 `tailString(s, 200)` 按字节截取；ASCII 等同 200 字符，多字节 UTF-8 可能被截断），避免上下文爆炸。不传任何 range flag 时，CLI 会把原始 `stderr` 字段清空，只暴露 `stderr_tail` 和 `stderr_size`
+- `stdout_tail` — CLI 默认保留的 **最后 800 字节** stdout 片段，避免上下文爆炸
+- `stderr_tail` — CLI 默认保留的 **最后 200 字节** stderr 片段（CLI 硬编码 `tailString(s, n)` 按字节截取；ASCII 等同 n 字符，多字节 UTF-8 可能被截断），避免上下文爆炸。不传任何 range flag 时，CLI 会把原始 `stdout`/`stderr` 字段清空，只暴露 `stdout_tail`/`stderr_tail` 和 `stdout_size`/`stderr_size`
+- `stdout_size` — 原始 stdout 字节数（CLI 端计算）
 - `stderr_size` — 原始 stderr 字节数（CLI 端计算）
-- `cursor` — 服务端 stderr 行计数器；**该字段无 `omitempty`，永远出现在响应中**（即使为 0 也露）。`cursor=0` 通常意味着服务端从 provider 还没读到任何 stderr 行
+- `cursor` — 服务端 stderr 行计数器；**该字段无 `omitempty`，永远出现在响应中**（即使为 0）。`cursor=0` 通常意味着服务端从 provider 还没读到任何 stderr 行
 - `running` — 命令是否仍在运行
 - `finished` — 命令是否已完成（`finished = not running`）
 - `exit_code` — 退出码（完成后才有值，运行中字段省略）
 - `log_file` — 仅 `finished=true` 时出现，是 run envelope 日志文件路径（含完整 stdout + stderr + exit_code + finished + command + error），需读它用 `delta-cli sandbox read <id> --path <log_file>`
 
-**stdout 路径说明**：`sandbox logs` **永远不直接返回 stdout**——stdout 在命令结束时被写入沙箱内的 `log_file`，必须用 `sandbox read` 读。CLI `run-bg --wait` 完成后默认开启 `--summary`，会自动 reverse-scan stdout 末尾 JSON 填入 `data.result_summary`，常用场景无需手动读 `log_file`。
+**stdout 路径说明**：`sandbox logs` 默认返回 stdout 末尾 800 字节（`stdout_tail`）提供实时中间进度预览，完整 stdout 仍在命令结束时被写入沙箱内的 `log_file`，需全文时用 `sandbox read` 读。CLI `run-bg --wait` 完成后默认开启 `--summary`，会自动 reverse-scan stdout 末尾 JSON 填入 `data.result_summary`，常用场景无需手动读 `log_file`。
 
-要用 `--tail/--grep/--context/--max-bytes` 自定义切片：传任意一个 flag 时，CLI 会把过滤后的 stderr 写回 `stderr` 字段并更新 `stderr_size`；不传则保持 `stderr=""` + `stderr_tail` 末尾 200 字节预览。
+要用 `--tail/--grep/--context` 自定义切片：传任意一个 flag 时，CLI 会把过滤后的 stdout 和 stderr 分别写回 `stdout`/`stderr` 字段并更新 `stdout_size`/`stderr_size`；不传则保持 `stdout=""` + `stdout_tail` 末尾 800 字节预览 + `stderr=""` + `stderr_tail` 末尾 200 字节预览（总计约 1KB）。
 
 ```bash
-# 看最后 50 行 stderr
+# 看最后 50 行 stdout 和 stderr
 delta-cli sandbox logs <id> --execution-id <eid> --tail 50
-# 过滤 ERROR/warning 行
+# 过滤 ERROR/warning 行（同时作用于 stdout 和 stderr）
 delta-cli sandbox logs <id> --execution-id <eid> --grep "ERROR|warning" --context 2
-# 兜底限流 32KB
-delta-cli sandbox logs <id> --execution-id <eid> --max-bytes 32768
 ```
 
 判断任务状态的规则（按优先顺序）：

package/skills/delta-shared/SKILL.md

@@ -76,12 +76,12 @@ AI Agent 解析规则：
 | api | 7 | 服务端非 2xx |
 | internal | 10 | 客户端内部错误 |
 
-## 更新检查
+## 升级检查
 
 完成用户请求后，如果 JSON 中有 `_notice.update`，可建议：
 
 ```bash
-delta-cli update
+delta-cli upgrade
 ```
 
 ## 常见恢复