@lingjingai/lj-awb-cli-pre 0.4.7 → 0.4.9

package/README.md

@@ -24,7 +24,6 @@ CLI 本身只负责平台调用、参数校验、人类友好输出、机器可
 | 上传 | `upload` | 本地图片 / 视频 / 音频上传为平台可访问素材 |
 | 创建 | `create` | 生图、生视频、主体、音色、素材和去字幕提交 |
 | 任务 | `task` | 任务列表、等待、任务台账和台账轮询 |
-| 最终产物 | `artifact` | Workbench 剧本、资产、视频最终产物 CRUD 与本地 JSON 导入 |
 
 ## 环境要求
 
@@ -161,7 +160,7 @@ lj-awb auth verify
 lj-awb account info
 lj-awb account teams
 lj-awb project list
-lj-awb project use --project-group-no <no> --yes
+lj-awb project switch --project-group-no <no> --yes
 lj-awb credits balance
 lj-awb credits usage --project-group-no <no> --last-hours 24
 lj-awb model image-models --model Banana
@@ -169,9 +168,6 @@ lj-awb model video-models --model Seedance
 lj-awb model input-guide
 lj-awb model options --model-group-code <modelGroupCode>
 lj-awb model create-spec --model-group-code <modelGroupCode>
-lj-awb artifact script import --project-id <projectId> --input-file 1_script/output/script.json --dry-run
-lj-awb artifact asset import --project-id <projectId> --input-dir 2_asset/output --dry-run
-lj-awb artifact video import-storyboard --project-id <projectId> --input-file 3_footage/output/ep001/ep001_storyboard.json --dry-run
 ```
 
 正式写入、切换上下文、批量和扣费命令都支持安全确认：
@@ -369,6 +365,19 @@ npm run version:sync -- 0.3.5
 
 `npm run check:local` 会做 Node 语法检查、shell wrapper 检查、skill 元数据和 schema 校验，不需要 access key。`npm run check` 会额外执行真实平台契约校验，需要本地或环境变量中有可用 access key。`npm run build:pre` / `npm run build:prod` 发布构建只自动执行 `check:local`，避免被本机过期平台凭据阻断；需要真实平台回归时单独运行 `npm run check:real`。`npm run smoke` 会运行帮助命令和无网络写入风险的认证状态检查。
 
+### 用 Volta 管理 Node 的机器
+
+`lj-awb update` 会检测当前 CLI 是否由 [Volta](https://volta.sh) 管理；如果是，会使用 `volta install` 更新包并刷新 shim，否则沿用 `npm install -g`。
+
+`npm run build:pre` 走的是 `npm install -g`。在用 Volta 管理 Node/npm 的机器上，`npm install -g` **不会**在 `~/.volta/bin` 生成 shim（软链接只落在 `~/.volta/tools/image/node/<ver>/bin/`，该目录不在 `PATH` 中），安装后会出现 `lj-awb: command not found`。这类机器请改用：
+
+```bash
+npm run build:volta-pre        # 用 volta install 安装本地 pre 构建，正确生成 shim
+npm run build:volta-pre -- --dry-run   # 只查看安装计划，不实际安装
+```
+
+`build:volta-pre` 缺少 volta 时会直接报错退出。其余环境变量（`SKIP_CHECK=1` 等）与 `build:pre` 一致。
+
 ## 文档索引
 
 - [`docs/TECHNICAL.md`](docs/TECHNICAL.md)：架构、运行时、数据契约、发布维护说明。

package/build/volta-pre.mjs

@@ -0,0 +1,64 @@
+#!/usr/bin/env node
+import { mkdtempSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+import {
+  capture,
+  copyPackageFiles,
+  packTarball,
+  patchDefaultApiOrigin,
+  run,
+} from './_shared.mjs';
+
+const PRE_API_ORIGIN = 'https://animeworkbench-pre.lingjingai.cn';
+const PACKAGE_NAME = '@lingjingai/lj-awb-cli';
+const dryRun = process.env.NPM_INSTALL_DRY_RUN === '1' || process.argv.slice(2).includes('--dry-run');
+
+function ensureVolta() {
+  if (!process.env.VOLTA_HOME) {
+    process.stderr.write(
+      'Volta is required for this script but VOLTA_HOME is not set.\n'
+        + 'Install Volta (https://volta.sh) or use `npm run build:pre` instead.\n',
+    );
+    process.exit(1);
+  }
+  const result = capture('volta', ['--version']);
+  if (result.status !== 0) {
+    process.stderr.write(
+      'Volta is required for this script but the `volta` command is not available.\n'
+        + 'Install Volta (https://volta.sh) or use `npm run build:pre` instead.\n',
+    );
+    process.exit(1);
+  }
+  process.stderr.write(`Using Volta ${result.stdout.trim()} for global install.\n`);
+}
+
+function installTarball(tarballPath) {
+  const spec = `${PACKAGE_NAME}@file:${tarballPath}`;
+  if (dryRun) {
+    process.stderr.write(`$ volta install ${spec} (dry-run)\n`);
+    process.stderr.write('Validated local pre build Volta install plan from packed tarball.\n');
+    return;
+  }
+
+  run('volta', ['install', spec]);
+  run('lj-awb', ['--version']);
+  process.stderr.write('Installed local pre build with Volta from packed tarball.\n');
+}
+
+ensureVolta();
+
+if (process.env.SKIP_CHECK !== '1') {
+  run('npm', ['run', 'check:local']);
+}
+
+const stageDir = mkdtempSync(path.join(tmpdir(), 'lj-awb-pre-src-'));
+try {
+  process.stderr.write(`Preparing local pre build with default API origin ${PRE_API_ORIGIN}.\n`);
+  copyPackageFiles(stageDir);
+  patchDefaultApiOrigin(stageDir, PRE_API_ORIGIN);
+  const tarballPath = packTarball(stageDir);
+  installTarball(tarballPath);
+} finally {
+  rmSync(stageDir, { recursive: true, force: true });
+}

package/install.mjs

@@ -48,7 +48,15 @@ if (!existsSync(skillSourceDir)) {
 }
 
 for (const skillTargetDir of [...new Set(skillTargetDirs)]) {
-  rmSync(skillTargetDir, { recursive: true, force: true });
-  copyDirectory(skillSourceDir, skillTargetDir);
-  log(`Installed lj-awb skill -> ${skillTargetDir}`);
+  try {
+    // 目标目录可能正被运行中的 agent（如 Claude Code）实时占用、并发重建子目录，
+    // 普通 rmSync 删父目录时会撞上 ENOTEMPTY/EBUSY。maxRetries/retryDelay 让其自动重试规避竞态。
+    rmSync(skillTargetDir, { recursive: true, force: true, maxRetries: 10, retryDelay: 100 });
+    copyDirectory(skillSourceDir, skillTargetDir);
+    log(`Installed lj-awb skill -> ${skillTargetDir}`);
+  } catch (error) {
+    // 单个目标被占用不应中断整个 postinstall（否则 npm install 失败并留下半删目录）；
+    // 跳过该目标并提示用户：重启 agent 后重新安装即可刷新。
+    log(`Warning: skipped lj-awb skill refresh at ${skillTargetDir} (${error.code || error.message}). It may be in use by a running agent; restart it and reinstall to refresh.`);
+  }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lingjingai/lj-awb-cli-pre",
-  "version": "0.4.7",
+  "version": "0.4.9",
   "description": "Lingjing AWB CLI monorepo with shared core, standalone CLI, and agent skills (pre-release build pointing to https://animeworkbench-pre.lingjingai.cn)",
   "license": "MIT",
   "type": "module",
@@ -20,13 +20,14 @@
   "scripts": {
     "build": "node build/build.mjs",
     "build:pre": "node build/pre.mjs",
+    "build:volta-pre": "node build/volta-pre.mjs",
     "build:pre-publish": "node build/pre-publish.mjs",
     "build:prod": "node build/prod.mjs",
     "check": "npm run check:local && npm run check:real",
-    "check:local": "node --check install.mjs && node --check packages/awb-core/src/common.js && node --check packages/awb-core/src/api.js && node --check packages/awb-core/src/artifact.js && node --check packages/awb-core/src/auth.js && node --check packages/awb-core/src/output.js && node --check packages/awb-core/src/update.js && node --check packages/awb-core/src/services.js && node --check packages/awb-core/src/commands.js && node --check packages/awb-core/src/standalone.js && sh -n packages/awb-cli/bin/lj-awb && bash -n skills/lj-awb/scripts/resolve-lj-awb-cmd.sh && node --check packages/awb-cli/bin/lj-awb.js && node --check build/build.mjs && node --check build/_shared.mjs && node --check build/pre.mjs && node --check build/pre-publish.mjs && node --check build/prod.mjs && node --check scripts/run-openapi-cli-examples-real.mjs && node --check scripts/validate-cli-schema.mjs && node --check scripts/validate-cli-output-contract.mjs && node --check scripts/validate-cli-command-coverage.mjs && node scripts/validate-skill-meta.mjs && node scripts/validate-cli-schema.mjs && node scripts/validate-cli-command-coverage.mjs",
+    "check:local": "node --check install.mjs && node --check packages/awb-core/src/common.js && node --check packages/awb-core/src/api.js && node --check packages/awb-core/src/auth.js && node --check packages/awb-core/src/output.js && node --check packages/awb-core/src/update.js && node --check packages/awb-core/src/services.js && node --check packages/awb-core/src/commands.js && node --check packages/awb-core/src/standalone.js && sh -n packages/awb-cli/bin/lj-awb && bash -n skills/lj-awb/scripts/resolve-lj-awb-cmd.sh && node --check packages/awb-cli/bin/lj-awb.js && node --check build/build.mjs && node --check build/_shared.mjs && node --check build/pre.mjs && node --check build/volta-pre.mjs && node --check build/pre-publish.mjs && node --check build/prod.mjs && node --check scripts/run-openapi-cli-examples-real.mjs && node --check scripts/validate-cli-schema.mjs && node --check scripts/validate-cli-output-contract.mjs && node --check scripts/validate-cli-command-coverage.mjs && node scripts/validate-skill-meta.mjs && node scripts/validate-cli-schema.mjs && node scripts/validate-cli-command-coverage.mjs",
     "check:real": "node scripts/validate-cli-output-contract.mjs && node scripts/validate-openapi-cli-examples.mjs",
     "test:openapi-real": "node scripts/run-openapi-cli-examples-real.mjs",
-    "smoke": "packages/awb-cli/bin/lj-awb --help && packages/awb-cli/bin/lj-awb auth status -f json && packages/awb-cli/bin/lj-awb system && packages/awb-cli/bin/lj-awb auth && packages/awb-cli/bin/lj-awb account && packages/awb-cli/bin/lj-awb project && packages/awb-cli/bin/lj-awb credits && packages/awb-cli/bin/lj-awb upload && packages/awb-cli/bin/lj-awb model && packages/awb-cli/bin/lj-awb create && packages/awb-cli/bin/lj-awb task && packages/awb-cli/bin/lj-awb artifact && packages/awb-cli/bin/lj-awb schema -f json >/dev/null",
+    "smoke": "packages/awb-cli/bin/lj-awb --help && packages/awb-cli/bin/lj-awb auth status -f json && packages/awb-cli/bin/lj-awb system && packages/awb-cli/bin/lj-awb auth && packages/awb-cli/bin/lj-awb account && packages/awb-cli/bin/lj-awb project && packages/awb-cli/bin/lj-awb credits && packages/awb-cli/bin/lj-awb upload && packages/awb-cli/bin/lj-awb model && packages/awb-cli/bin/lj-awb create && packages/awb-cli/bin/lj-awb task && packages/awb-cli/bin/lj-awb schema -f json >/dev/null",
     "postinstall": "node install.mjs",
     "version:sync": "node scripts/sync-versions.mjs"
   },

package/packages/awb-cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lingjingai/awb-cli-bin",
-  "version": "0.4.7",
+  "version": "0.4.9",
   "description": "Standalone CLI for Lingjing AWB",
   "private": true,
   "license": "MIT",
@@ -13,6 +13,6 @@
     "README.md"
   ],
   "dependencies": {
-    "@lingjingai/awb-core": "0.4.7"
+    "@lingjingai/awb-core": "0.4.9"
   }
 }

package/packages/awb-core/package.json

@@ -1,13 +1,12 @@
 {
   "name": "@lingjingai/awb-core",
-  "version": "0.4.7",
+  "version": "0.4.9",
   "description": "Shared core runtime for Lingjing AWB CLI",
   "license": "MIT",
   "type": "module",
   "exports": {
     "./common.js": "./src/common.js",
     "./api.js": "./src/api.js",
-    "./artifact.js": "./src/artifact.js",
     "./auth.js": "./src/auth.js",
     "./output.js": "./src/output.js",
     "./services.js": "./src/services.js",