@lingjingai/lj-awb-cli-pre 0.4.6 → 0.4.8

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
 ```
 
 正式写入、切换上下文、批量和扣费命令都支持安全确认：

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.6",
+  "version": "0.4.8",
   "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",
@@ -8,6 +8,7 @@
     "lj-awb": "packages/awb-cli/bin/lj-awb"
   },
   "dependencies": {
+    "@lingjingai/lj-awb-cli-pre": "^0.4.8",
     "chalk": "^5.6.2",
     "cli-table3": "^0.6.5"
   },
@@ -23,10 +24,10 @@
     "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/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.6",
+  "version": "0.4.8",
   "description": "Standalone CLI for Lingjing AWB",
   "private": true,
   "license": "MIT",
@@ -13,6 +13,6 @@
     "README.md"
   ],
   "dependencies": {
-    "@lingjingai/awb-core": "0.4.6"
+    "@lingjingai/awb-core": "0.4.8"
   }
 }

package/packages/awb-core/package.json

@@ -1,13 +1,12 @@
 {
   "name": "@lingjingai/awb-core",
-  "version": "0.4.6",
+  "version": "0.4.8",
   "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",

package/packages/awb-core/src/api.js

@@ -148,9 +148,10 @@ export async function selectProjectGroup(projectGroupNo) {
   });
 }
 
-export async function updateCurrentTeam(groupId) {
-  return await apiFetch('/api/anime/user/group/updateCurrentGroup', {
-    body: { groupId },
+export async function fetchGroupAccessKey({ userId, groupId }) {
+  // 切换团队：用当前用户的 userId + 目标 groupId 换取该团队的 accessKey，再刷新本地认证文件。
+  return await apiFetch('/api/anime/user/account/groupAccessKey', {
+    body: { userId, groupId },
   });
 }
 

package/packages/awb-core/src/commands.js

@@ -1,5 +1,4 @@
 import { fetchProjectGroupUsers, fetchTeams, fetchUserInfo } from './api.js';
-import * as artifact from './artifact.js';
 import { clearAuth, loadAuth, saveAccessKey, summarizeAuth } from './auth.js';
 import { LingjingAwbCliError, maskSecret, toBool, trimSecret } from './common.js';
 import { runCliUpdate } from './update.js';
@@ -116,7 +115,6 @@ const BODY_INPUT_ARGS = [
   { name: 'body-json', valueName: 'json', description: '直接传接口 body JSON' },
   { name: 'input-file', valueName: 'path', description: '从本地 JSON 文件读取接口 body' },
 ];
-const ARTIFACT_WRITE_ARGS = [DRY_RUN_ARG, YES_ARG];
 
 export function registerAwbCommands(cli) {
   cli({
@@ -293,9 +291,9 @@ export function registerAwbCommands(cli) {
   });
 
   cli({
-    name: 'project use',
+    name: 'project switch',
     description: commandHelp('切换当前项目组；后续生成任务会归属到该项目组', {
-      examples: ['lj-awb project use --project-group-no <no> --dry-run', 'lj-awb project use --project-group-no <no> --yes'],
+      examples: ['lj-awb project switch --project-group-no <no> --dry-run', 'lj-awb project switch --project-group-no <no> --yes'],
     }),
     args: [
       PROJECT_GROUP_ARG,
@@ -928,462 +926,6 @@ export function registerAwbCommands(cli) {
     func: async (_ctx, kwargs) => assetRegister(kwargs),
   });
 
-  const ARTIFACT_ROW_KIND_ARG = { name: 'row-kind', valueName: 'kind', description: 'document/asset/state/speaker/episode/scene/action' };
-  const ARTIFACT_ENTITY_KEY_ARG = { name: 'entity-key', valueName: 'key', description: '业务唯一键；可包含 / 和 #' };
-  const ARTIFACT_EPISODE_ARG = { name: 'episode-id', valueName: 'id', description: '集 ID，例如 ep_001' };
-  const ARTIFACT_SCENE_ARG = { name: 'scene-id', valueName: 'id', description: '场 ID，例如 scn_001' };
-  const ARTIFACT_CLIP_ARG = { name: 'clip-id', valueName: 'id', description: 'clip ID，例如 clip_001' };
-  const ARTIFACT_VIDEO_EPISODE_ID_ARG = { name: 'video-episode-id', valueName: 'id', description: '视频集产物的数字主键，由 artifact video upsert-episode / artifact video episode 返回的 id 字段提供（不是 ep_001 这种业务 ID）' };
-  const ARTIFACT_INCLUDE_STATES_ARG = { name: 'include-states', valueName: 'bool', description: '是否带 states，默认 true' };
-
-  for (const spec of [
-    {
-      name: 'artifact script get',
-      summary: '查询项目完整剧本最终产物',
-      examples: ['lj-awb artifact script get --project-id <projectId>'],
-      args: [PROJECT_ID_ARG],
-      func: artifact.artifactScriptGet,
-    },
-    {
-      name: 'artifact script document',
-      summary: '查询剧本 document 根记录',
-      examples: ['lj-awb artifact script document --project-id <projectId>'],
-      args: [PROJECT_ID_ARG],
-      func: artifact.artifactScriptDocument,
-    },
-    {
-      name: 'artifact script rows',
-      summary: '查询剧本最终产物行列表',
-      examples: [
-        'lj-awb artifact script rows --project-id <projectId> --row-kind scene',
-        'lj-awb artifact script rows --project-id <projectId> --row-kind action --parent-key scn_001',
-      ],
-      args: [
-        PROJECT_ID_ARG,
-        ARTIFACT_ROW_KIND_ARG,
-        { name: 'parent-key', valueName: 'key', description: '按父节点业务键过滤' },
-        { name: 'revision-after', valueName: 'n', description: '只查 revisionNo 大于该值的行' },
-        { name: 'include-deleted', valueName: 'bool', description: '是否包含逻辑删除行，默认 false' },
-      ],
-      func: artifact.artifactScriptRows,
-    },
-    {
-      name: 'artifact script row',
-      summary: '查询单条剧本最终产物行',
-      examples: ['lj-awb artifact script row --project-id <projectId> --row-kind action --entity-key "ep_001/scn_001#0"'],
-      args: [PROJECT_ID_ARG, ARTIFACT_ROW_KIND_ARG, ARTIFACT_ENTITY_KEY_ARG],
-      func: artifact.artifactScriptRow,
-    },
-    {
-      name: 'artifact script children',
-      summary: '按 parentKey 查询剧本子节点',
-      examples: ['lj-awb artifact script children --project-id <projectId> --parent-key scn_001 --row-kind action'],
-      args: [
-        PROJECT_ID_ARG,
-        { name: 'parent-key', valueName: 'key', description: '父节点业务键' },
-        ARTIFACT_ROW_KIND_ARG,
-      ],
-      func: artifact.artifactScriptChildren,
-    },
-    {
-      name: 'artifact script upsert-row',
-      summary: '新增或更新单条剧本最终产物行',
-      examples: ['lj-awb artifact script upsert-row --project-id <projectId> --input-file ./row.json --dry-run', 'lj-awb artifact script upsert-row --project-id <projectId> --input-file ./row.json --yes'],
-      args: [PROJECT_ID_ARG, ...BODY_INPUT_ARGS, ...ARTIFACT_WRITE_ARGS],
-      func: artifact.artifactScriptUpsertRow,
-    },
-    {
-      name: 'artifact script delete-row',
-      summary: '逻辑删除单条剧本最终产物行',
-      examples: ['lj-awb artifact script delete-row --project-id <projectId> --row-kind action --entity-key "ep_001/scn_001#0" --dry-run', 'lj-awb artifact script delete-row --project-id <projectId> --row-kind action --entity-key "ep_001/scn_001#0" --yes'],
-      args: [PROJECT_ID_ARG, ARTIFACT_ROW_KIND_ARG, ARTIFACT_ENTITY_KEY_ARG, ...ARTIFACT_WRITE_ARGS],
-      func: artifact.artifactScriptDeleteRow,
-    },
-    {
-      name: 'artifact script import',
-      summary: '从本地 script.json 拆分并批量导入剧本最终产物',
-      examples: [
-        'lj-awb artifact script import --project-id <projectId> --input-file 1_script/output/script.json --dry-run',
-        'lj-awb artifact script import --project-id <projectId> --input-file output/script.json --yes',
-      ],
-      args: [
-        PROJECT_ID_ARG,
-        { name: 'input-file', valueName: 'path', description: 'script.json 路径，默认 output/script.json' },
-        ...ARTIFACT_WRITE_ARGS,
-      ],
-      func: artifact.artifactScriptImport,
-      hint: '不传 --input-file 时默认读取当前目录的 output/script.json。',
-    },
-  ]) {
-    cli({
-      name: spec.name,
-      description: commandHelp(spec.summary, { examples: spec.examples, hint: spec.hint }),
-      args: spec.args,
-      func: async (_ctx, kwargs) => spec.func(kwargs),
-    });
-  }
-
-  for (const spec of [
-    {
-      name: 'artifact asset get',
-      summary: '查询项目完整资产最终产物',
-      examples: ['lj-awb artifact asset get --project-id <projectId>'],
-      args: [PROJECT_ID_ARG],
-      func: artifact.artifactAssetGet,
-    },
-    {
-      name: 'artifact asset actors',
-      summary: '查询角色最终产物列表',
-      examples: ['lj-awb artifact asset actors --project-id <projectId> --include-states true'],
-      args: [PROJECT_ID_ARG, ARTIFACT_INCLUDE_STATES_ARG],
-      func: artifact.artifactAssetActors,
-    },
-    {
-      name: 'artifact asset actor',
-      summary: '查询单个角色最终产物',
-      examples: ['lj-awb artifact asset actor --project-id <projectId> --actor-key act_001'],
-      args: [PROJECT_ID_ARG, { name: 'actor-key', valueName: 'key', description: '角色业务键' }, ARTIFACT_INCLUDE_STATES_ARG],
-      func: artifact.artifactAssetActor,
-    },
-    {
-      name: 'artifact asset props',
-      summary: '查询道具最终产物列表',
-      examples: ['lj-awb artifact asset props --project-id <projectId>'],
-      args: [PROJECT_ID_ARG, ARTIFACT_INCLUDE_STATES_ARG],
-      func: artifact.artifactAssetProps,
-    },
-    {
-      name: 'artifact asset prop',
-      summary: '查询单个道具最终产物',
-      examples: ['lj-awb artifact asset prop --project-id <projectId> --prop-key prp_001'],
-      args: [PROJECT_ID_ARG, { name: 'prop-key', valueName: 'key', description: '道具业务键' }, ARTIFACT_INCLUDE_STATES_ARG],
-      func: artifact.artifactAssetProp,
-    },
-    {
-      name: 'artifact asset locations',
-      summary: '查询场景最终产物列表',
-      examples: ['lj-awb artifact asset locations --project-id <projectId>'],
-      args: [PROJECT_ID_ARG, ARTIFACT_INCLUDE_STATES_ARG],
-      func: artifact.artifactAssetLocations,
-    },
-    {
-      name: 'artifact asset location',
-      summary: '查询单个场景最终产物',
-      examples: ['lj-awb artifact asset location --project-id <projectId> --location-key loc_001'],
-      args: [PROJECT_ID_ARG, { name: 'location-key', valueName: 'key', description: '场景业务键' }, ARTIFACT_INCLUDE_STATES_ARG],
-      func: artifact.artifactAssetLocation,
-    },
-    {
-      name: 'artifact asset upsert-actor',
-      summary: '新增或更新角色最终产物',
-      examples: ['lj-awb artifact asset upsert-actor --project-id <projectId> --input-file ./actor.json --dry-run', 'lj-awb artifact asset upsert-actor --project-id <projectId> --input-file ./actor.json --yes'],
-      args: [PROJECT_ID_ARG, ...BODY_INPUT_ARGS, ...ARTIFACT_WRITE_ARGS],
-      func: artifact.artifactAssetUpsertActor,
-    },
-    {
-      name: 'artifact asset upsert-prop',
-      summary: '新增或更新道具最终产物',
-      examples: ['lj-awb artifact asset upsert-prop --project-id <projectId> --input-file ./prop.json --dry-run', 'lj-awb artifact asset upsert-prop --project-id <projectId> --input-file ./prop.json --yes'],
-      args: [PROJECT_ID_ARG, ...BODY_INPUT_ARGS, ...ARTIFACT_WRITE_ARGS],
-      func: artifact.artifactAssetUpsertProp,
-    },
-    {
-      name: 'artifact asset upsert-location',
-      summary: '新增或更新场景最终产物',
-      examples: ['lj-awb artifact asset upsert-location --project-id <projectId> --input-file ./location.json --dry-run', 'lj-awb artifact asset upsert-location --project-id <projectId> --input-file ./location.json --yes'],
-      args: [PROJECT_ID_ARG, ...BODY_INPUT_ARGS, ...ARTIFACT_WRITE_ARGS],
-      func: artifact.artifactAssetUpsertLocation,
-    },
-    {
-      name: 'artifact asset upsert-actor-state',
-      summary: '新增或更新角色状态最终产物',
-      examples: ['lj-awb artifact asset upsert-actor-state --project-id <projectId> --actor-key act_001 --input-file ./state.json --dry-run', 'lj-awb artifact asset upsert-actor-state --project-id <projectId> --actor-key act_001 --input-file ./state.json --yes'],
-      args: [PROJECT_ID_ARG, { name: 'actor-key', valueName: 'key', description: '角色业务键' }, ...BODY_INPUT_ARGS, ...ARTIFACT_WRITE_ARGS],
-      func: artifact.artifactAssetUpsertActorState,
-    },
-    {
-      name: 'artifact asset upsert-prop-state',
-      summary: '新增或更新道具状态最终产物',
-      examples: ['lj-awb artifact asset upsert-prop-state --project-id <projectId> --prop-key prp_001 --input-file ./state.json --dry-run', 'lj-awb artifact asset upsert-prop-state --project-id <projectId> --prop-key prp_001 --input-file ./state.json --yes'],
-      args: [PROJECT_ID_ARG, { name: 'prop-key', valueName: 'key', description: '道具业务键' }, ...BODY_INPUT_ARGS, ...ARTIFACT_WRITE_ARGS],
-      func: artifact.artifactAssetUpsertPropState,
-    },
-    {
-      name: 'artifact asset upsert-location-state',
-      summary: '新增或更新场景状态最终产物',
-      examples: ['lj-awb artifact asset upsert-location-state --project-id <projectId> --location-key loc_001 --input-file ./state.json --dry-run', 'lj-awb artifact asset upsert-location-state --project-id <projectId> --location-key loc_001 --input-file ./state.json --yes'],
-      args: [PROJECT_ID_ARG, { name: 'location-key', valueName: 'key', description: '场景业务键' }, ...BODY_INPUT_ARGS, ...ARTIFACT_WRITE_ARGS],
-      func: artifact.artifactAssetUpsertLocationState,
-    },
-    {
-      name: 'artifact asset delete-actor',
-      summary: '逻辑删除角色及其状态最终产物',
-      examples: ['lj-awb artifact asset delete-actor --project-id <projectId> --actor-key act_001 --dry-run', 'lj-awb artifact asset delete-actor --project-id <projectId> --actor-key act_001 --yes'],
-      args: [PROJECT_ID_ARG, { name: 'actor-key', valueName: 'key', description: '角色业务键' }, ...ARTIFACT_WRITE_ARGS],
-      func: artifact.artifactAssetDeleteActor,
-    },
-    {
-      name: 'artifact asset delete-prop',
-      summary: '逻辑删除道具及其状态最终产物',
-      examples: ['lj-awb artifact asset delete-prop --project-id <projectId> --prop-key prp_001 --dry-run', 'lj-awb artifact asset delete-prop --project-id <projectId> --prop-key prp_001 --yes'],
-      args: [PROJECT_ID_ARG, { name: 'prop-key', valueName: 'key', description: '道具业务键' }, ...ARTIFACT_WRITE_ARGS],
-      func: artifact.artifactAssetDeleteProp,
-    },
-    {
-      name: 'artifact asset delete-location',
-      summary: '逻辑删除场景及其状态最终产物',
-      examples: ['lj-awb artifact asset delete-location --project-id <projectId> --location-key loc_001 --dry-run', 'lj-awb artifact asset delete-location --project-id <projectId> --location-key loc_001 --yes'],
-      args: [PROJECT_ID_ARG, { name: 'location-key', valueName: 'key', description: '场景业务键' }, ...ARTIFACT_WRITE_ARGS],
-      func: artifact.artifactAssetDeleteLocation,
-    },
-    {
-      name: 'artifact asset delete-actor-state',
-      summary: '逻辑删除角色状态最终产物',
-      examples: ['lj-awb artifact asset delete-actor-state --project-id <projectId> --actor-key act_001 --state-key default --dry-run', 'lj-awb artifact asset delete-actor-state --project-id <projectId> --actor-key act_001 --state-key default --yes'],
-      args: [PROJECT_ID_ARG, { name: 'actor-key', valueName: 'key', description: '角色业务键' }, { name: 'state-key', valueName: 'key', description: '状态业务键' }, ...ARTIFACT_WRITE_ARGS],
-      func: artifact.artifactAssetDeleteActorState,
-    },
-    {
-      name: 'artifact asset delete-prop-state',
-      summary: '逻辑删除道具状态最终产物',
-      examples: ['lj-awb artifact asset delete-prop-state --project-id <projectId> --prop-key prp_001 --state-key default --dry-run', 'lj-awb artifact asset delete-prop-state --project-id <projectId> --prop-key prp_001 --state-key default --yes'],
-      args: [PROJECT_ID_ARG, { name: 'prop-key', valueName: 'key', description: '道具业务键' }, { name: 'state-key', valueName: 'key', description: '状态业务键' }, ...ARTIFACT_WRITE_ARGS],
-      func: artifact.artifactAssetDeletePropState,
-    },
-    {
-      name: 'artifact asset delete-location-state',
-      summary: '逻辑删除场景状态最终产物',
-      examples: ['lj-awb artifact asset delete-location-state --project-id <projectId> --location-key loc_001 --state-key default --dry-run', 'lj-awb artifact asset delete-location-state --project-id <projectId> --location-key loc_001 --state-key default --yes'],
-      args: [PROJECT_ID_ARG, { name: 'location-key', valueName: 'key', description: '场景业务键' }, { name: 'state-key', valueName: 'key', description: '状态业务键' }, ...ARTIFACT_WRITE_ARGS],
-      func: artifact.artifactAssetDeleteLocationState,
-    },
-    {
-      name: 'artifact asset import',
-      summary: '从本地 actors/props/locations JSON 批量导入资产最终产物',
-      examples: [
-        'lj-awb artifact asset import --project-id <projectId> --input-dir 2_asset/output --dry-run',
-        'lj-awb artifact asset import --project-id <projectId> --actors-file output/actors/actors.json --props-file output/props/props.json --locations-file output/locations/locations.json --yes',
-      ],
-      args: [
-        PROJECT_ID_ARG,
-        { name: 'input-dir', valueName: 'path', description: '资产 output 目录，默认 output' },
-        { name: 'actors-file', valueName: 'path', description: '可选 actors.json 路径' },
-        { name: 'props-file', valueName: 'path', description: '可选 props.json 路径' },
-        { name: 'locations-file', valueName: 'path', description: '可选 locations.json 路径' },
-        ...ARTIFACT_WRITE_ARGS,
-      ],
-      func: artifact.artifactAssetImport,
-      hint: '默认在 --input-dir 下查找 actors/actors.json、props/props.json、locations/locations.json；也兼容 actors.json 等扁平文件名。',
-    },
-  ]) {
-    cli({
-      name: spec.name,
-      description: commandHelp(spec.summary, { examples: spec.examples, hint: spec.hint }),
-      args: spec.args,
-      func: async (_ctx, kwargs) => spec.func(kwargs),
-    });
-  }
-
-  for (const spec of [
-    {
-      name: 'artifact video get',
-      summary: '查询项目完整视频最终产物',
-      examples: ['lj-awb artifact video get --project-id <projectId>'],
-      args: [PROJECT_ID_ARG],
-      func: artifact.artifactVideoGet,
-    },
-    {
-      name: 'artifact video episodes',
-      summary: '查询视频集列表',
-      examples: ['lj-awb artifact video episodes --project-id <projectId>'],
-      args: [PROJECT_ID_ARG],
-      func: artifact.artifactVideoEpisodes,
-    },
-    {
-      name: 'artifact video episode',
-      summary: '查询单集视频最终产物',
-      examples: ['lj-awb artifact video episode --project-id <projectId> --episode-id ep_001'],
-      args: [PROJECT_ID_ARG, ARTIFACT_EPISODE_ARG],
-      func: artifact.artifactVideoEpisode,
-    },
-    {
-      name: 'artifact video scenes',
-      summary: '查询某集下的场列表',
-      examples: ['lj-awb artifact video scenes --project-id <projectId> --episode-id ep_001'],
-      args: [PROJECT_ID_ARG, ARTIFACT_EPISODE_ARG],
-      func: artifact.artifactVideoScenes,
-    },
-    {
-      name: 'artifact video scene',
-      summary: '查询单场视频最终产物',
-      examples: ['lj-awb artifact video scene --project-id <projectId> --episode-id ep_001 --scene-id scn_001'],
-      args: [PROJECT_ID_ARG, ARTIFACT_EPISODE_ARG, ARTIFACT_SCENE_ARG],
-      func: artifact.artifactVideoScene,
-    },
-    {
-      name: 'artifact video clips',
-      summary: '查询某场下的 clip 列表',
-      examples: ['lj-awb artifact video clips --project-id <projectId> --episode-id ep_001 --scene-id scn_001'],
-      args: [PROJECT_ID_ARG, ARTIFACT_EPISODE_ARG, ARTIFACT_SCENE_ARG],
-      func: artifact.artifactVideoClips,
-    },
-    {
-      name: 'artifact video clip',
-      summary: '查询单个 clip 视频最终产物',
-      examples: ['lj-awb artifact video clip --project-id <projectId> --episode-id ep_001 --scene-id scn_001 --clip-id clip_001'],
-      args: [PROJECT_ID_ARG, ARTIFACT_EPISODE_ARG, ARTIFACT_SCENE_ARG, ARTIFACT_CLIP_ARG],
-      func: artifact.artifactVideoClip,
-    },
-    {
-      name: 'artifact video upsert-episode',
-      summary: '新增或更新视频 episode 最终产物',
-      examples: ['lj-awb artifact video upsert-episode --project-id <projectId> --input-file ./episode.json --dry-run', 'lj-awb artifact video upsert-episode --project-id <projectId> --input-file ./episode.json --yes'],
-      args: [PROJECT_ID_ARG, ...BODY_INPUT_ARGS, ...ARTIFACT_WRITE_ARGS],
-      func: artifact.artifactVideoUpsertEpisode,
-    },
-    {
-      name: 'artifact video upsert-scene',
-      summary: '新增或更新视频 scene 最终产物',
-      examples: ['lj-awb artifact video upsert-scene --project-id <projectId> --episode-id ep_001 --input-file ./scene.json --dry-run', 'lj-awb artifact video upsert-scene --project-id <projectId> --episode-id ep_001 --input-file ./scene.json --yes'],
-      args: [PROJECT_ID_ARG, ARTIFACT_EPISODE_ARG, ...BODY_INPUT_ARGS, ...ARTIFACT_WRITE_ARGS],
-      func: artifact.artifactVideoUpsertScene,
-    },
-    {
-      name: 'artifact video upsert-clip',
-      summary: '新增或更新视频 clip 最终产物',
-      examples: ['lj-awb artifact video upsert-clip --project-id <projectId> --episode-id ep_001 --scene-id scn_001 --input-file ./clip.json --dry-run', 'lj-awb artifact video upsert-clip --project-id <projectId> --episode-id ep_001 --scene-id scn_001 --input-file ./clip.json --yes'],
-      args: [PROJECT_ID_ARG, ARTIFACT_EPISODE_ARG, ARTIFACT_SCENE_ARG, ...BODY_INPUT_ARGS, ...ARTIFACT_WRITE_ARGS],
-      func: artifact.artifactVideoUpsertClip,
-    },
-    {
-      name: 'artifact video update-clip-urls',
-      summary: '只回写 clip.videoUrls，不覆盖 payload / prompt / duration',
-      examples: [
-        'lj-awb artifact video update-clip-urls --project-id <projectId> --episode-id ep_001 --scene-id scn_001 --clip-id clip_001 --video-urls-json \'["https://example.com/a.mp4"]\' --dry-run',
-        'lj-awb artifact video update-clip-urls --project-id <projectId> --episode-id ep_001 --scene-id scn_001 --clip-id clip_001 --video-urls-json \'["https://example.com/a.mp4"]\' --yes',
-      ],
-      args: [
-        PROJECT_ID_ARG,
-        ARTIFACT_EPISODE_ARG,
-        ARTIFACT_SCENE_ARG,
-        ARTIFACT_CLIP_ARG,
-        { name: 'video-urls-json', valueName: 'json', description: '视频 URL 数组 JSON' },
-        ...ARTIFACT_WRITE_ARGS,
-      ],
-      func: artifact.artifactVideoUpdateClipVideoUrls,
-    },
-    {
-      name: 'artifact video delete-episode',
-      summary: '逻辑删除视频 episode，并级联删除该集 scenes/clips',
-      examples: ['lj-awb artifact video delete-episode --project-id <projectId> --episode-id ep_001 --dry-run', 'lj-awb artifact video delete-episode --project-id <projectId> --episode-id ep_001 --yes'],
-      args: [PROJECT_ID_ARG, ARTIFACT_EPISODE_ARG, ...ARTIFACT_WRITE_ARGS],
-      func: artifact.artifactVideoDeleteEpisode,
-    },
-    {
-      name: 'artifact video delete-scene',
-      summary: '逻辑删除视频 scene，并级联删除该场 clips',
-      examples: ['lj-awb artifact video delete-scene --project-id <projectId> --episode-id ep_001 --scene-id scn_001 --dry-run', 'lj-awb artifact video delete-scene --project-id <projectId> --episode-id ep_001 --scene-id scn_001 --yes'],
-      args: [PROJECT_ID_ARG, ARTIFACT_EPISODE_ARG, ARTIFACT_SCENE_ARG, ...ARTIFACT_WRITE_ARGS],
-      func: artifact.artifactVideoDeleteScene,
-    },
-    {
-      name: 'artifact video delete-clip',
-      summary: '逻辑删除视频 clip',
-      examples: ['lj-awb artifact video delete-clip --project-id <projectId> --episode-id ep_001 --scene-id scn_001 --clip-id clip_001 --dry-run', 'lj-awb artifact video delete-clip --project-id <projectId> --episode-id ep_001 --scene-id scn_001 --clip-id clip_001 --yes'],
-      args: [PROJECT_ID_ARG, ARTIFACT_EPISODE_ARG, ARTIFACT_SCENE_ARG, ARTIFACT_CLIP_ARG, ...ARTIFACT_WRITE_ARGS],
-      func: artifact.artifactVideoDeleteClip,
-    },
-    {
-      name: 'artifact video import-storyboard',
-      summary: '从 epXXX_storyboard.json 拆分 episode/scenes/clips 并导入视频最终产物',
-      examples: [
-        'lj-awb artifact video import-storyboard --project-id <projectId> --input-file 3_footage/output/ep001/ep001_storyboard.json --dry-run',
-        'lj-awb artifact video import-storyboard --project-id <projectId> --input-file output/ep001/ep001_storyboard.json --yes',
-      ],
-      args: [PROJECT_ID_ARG, { name: 'input-file', valueName: 'path', description: 'epXXX_storyboard.json 路径' }, ...ARTIFACT_WRITE_ARGS],
-      func: artifact.artifactVideoImportStoryboard,
-    },
-  ]) {
-    cli({
-      name: spec.name,
-      description: commandHelp(spec.summary, { examples: spec.examples }),
-      args: spec.args,
-      func: async (_ctx, kwargs) => spec.func(kwargs),
-    });
-  }
-
-  for (const spec of [
-    {
-      name: 'artifact clip get',
-      summary: '查询项目完整剪辑最终产物',
-      examples: ['lj-awb artifact clip get --project-id <projectId>'],
-      args: [PROJECT_ID_ARG],
-      func: artifact.artifactClipGet,
-    },
-    {
-      name: 'artifact clip episodes',
-      summary: '查询项目剪辑产物列表',
-      examples: ['lj-awb artifact clip episodes --project-id <projectId>'],
-      args: [PROJECT_ID_ARG],
-      func: artifact.artifactClipEpisodes,
-    },
-    {
-      name: 'artifact clip episode',
-      summary: '按 videoEpisodeId 查询单集剪辑产物',
-      examples: ['lj-awb artifact clip episode --project-id <projectId> --video-episode-id 101'],
-      args: [PROJECT_ID_ARG, ARTIFACT_VIDEO_EPISODE_ID_ARG],
-      func: artifact.artifactClipEpisode,
-    },
-    {
-      name: 'artifact clip episode-by-id',
-      summary: '按业务 episodeId 查询单集剪辑产物',
-      examples: ['lj-awb artifact clip episode-by-id --project-id <projectId> --episode-id ep_001'],
-      args: [PROJECT_ID_ARG, ARTIFACT_EPISODE_ARG],
-      func: artifact.artifactClipEpisodeById,
-    },
-    {
-      name: 'artifact clip upsert-episode',
-      summary: '新增或更新单集剪辑最终产物',
-      examples: ['lj-awb artifact clip upsert-episode --project-id <projectId> --input-file ./clip-output.json --dry-run', 'lj-awb artifact clip upsert-episode --project-id <projectId> --input-file ./clip-output.json --yes'],
-      args: [PROJECT_ID_ARG, ...BODY_INPUT_ARGS, ...ARTIFACT_WRITE_ARGS],
-      func: artifact.artifactClipUpsertEpisode,
-    },
-    {
-      name: 'artifact clip upsert-batch',
-      summary: '批量新增或更新剪辑最终产物',
-      examples: ['lj-awb artifact clip upsert-batch --project-id <projectId> --input-file ./clip-output-list.json --dry-run', 'lj-awb artifact clip upsert-batch --project-id <projectId> --input-file ./clip-output-list.json --yes'],
-      args: [PROJECT_ID_ARG, ...BODY_INPUT_ARGS, ...ARTIFACT_WRITE_ARGS],
-      func: artifact.artifactClipUpsertBatch,
-    },
-    {
-      name: 'artifact clip update-status',
-      summary: '只更新剪辑产物 status；messages 非空时覆盖',
-      examples: ['lj-awb artifact clip update-status --project-id <projectId> --video-episode-id 101 --status music_success --messages-json \'[{"level":"info","step":"music","message":"配乐完成"}]\' --dry-run'],
-      args: [
-        PROJECT_ID_ARG,
-        ARTIFACT_VIDEO_EPISODE_ID_ARG,
-        { name: 'status', valueName: 'status', description: '剪辑阶段状态，例如 concat_success / music_success / burn_success' },
-        { name: 'messages-json', valueName: 'json', description: '可选 messages 数组 JSON；传入时覆盖原 messages' },
-        ...ARTIFACT_WRITE_ARGS,
-      ],
-      func: artifact.artifactClipUpdateStatus,
-    },
-    {
-      name: 'artifact clip delete-episode',
-      summary: '逻辑删除单集剪辑最终产物',
-      examples: ['lj-awb artifact clip delete-episode --project-id <projectId> --video-episode-id 101 --dry-run', 'lj-awb artifact clip delete-episode --project-id <projectId> --video-episode-id 101 --yes'],
-      args: [PROJECT_ID_ARG, ARTIFACT_VIDEO_EPISODE_ID_ARG, ...ARTIFACT_WRITE_ARGS],
-      func: artifact.artifactClipDeleteEpisode,
-    },
-  ]) {
-    cli({
-      name: spec.name,
-      description: commandHelp(spec.summary, { examples: spec.examples }),
-      args: spec.args,
-      func: async (_ctx, kwargs) => spec.func(kwargs),
-    });
-  }
-
   cli({
     name: 'create subject-list',
     description: commandHelp('查询可用于视频主体参考的元素 / 主体', {