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

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';
@@ -86,6 +85,14 @@ const MODEL_GROUP_ARG = { name: 'model-group-code', valueName: 'code', descripti
 const ASSET_PLATFORM_ARG = { name: 'platform', valueName: 'platform', description: '素材加白平台，必须显式传 JIMENG 或 BYTEPLUS，不做别名推断' };
 const MODEL_LIST_ARGS = [
   { name: 'model', valueName: 'keyword', description: '按模型名、编码、供应商或输入方式过滤；不传时查询全部' },
+  { name: 'usage', valueName: 'usage', description: '模型用途：image 可选 IMAGE_CREATE(默认)/IMAGE_EDIT；video 为 VIDEO_CREATE。取值大小写不敏感' },
+  { name: 'provider', valueName: 'keyword', description: '按厂商过滤（大小写不敏感子串，如 字节 / GPT / Google）' },
+  { name: 'input-mode', valueName: 'mode', description: '按输入方式过滤（对模型 inputModes 做成员匹配，如 reference / prompt_only / frames）' },
+  { name: 'supports', valueName: 'param', description: '按支持的可调参数过滤（对 params 做成员匹配，如 quality / ratio / duration / needAudio）' },
+  { name: 'quality', valueName: 'value', description: '按分辨率取值过滤（模型真实支持该 quality 才返回，如 4k / 2k / 1080；大小写不敏感）' },
+  { name: 'ratio', valueName: 'value', description: '按画面比例取值过滤（模型真实支持该 ratio 才返回，如 9:16 / 16:9 / 1:1）' },
+  { name: 'duration', valueName: 'sec', description: '按时长取值过滤（video，模型真实支持该秒数才返回，如 10 / 15）' },
+  { name: 'need-audio', description: '只返回支持音效 / 音频的模型（video，按 audio 能力）' },
   { name: 'limit', valueName: 'n', description: '默认文本最多展示 N 条，默认 8；JSON 输出始终返回全部匹配' },
   { name: 'all', description: '默认文本展示全部匹配模型（覆盖 --limit）' },
   INCLUDE_RAW_ARG,
@@ -116,7 +123,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 +299,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 +934,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('查询可用于视频主体参考的元素 / 主体', {