@lingjingai/lj-awb-cli-pre 0.3.15 → 0.3.16

package/README.md

@@ -136,8 +136,8 @@ lj-awb artifact video import-storyboard --project-id <projectId> --input-file 3_
 正式写入、切换上下文、批量和扣费命令都支持安全确认：
 
 ```bash
-lj-awb image create ... --dry-run
-lj-awb image create ... --yes
+lj-awb create image ... --dry-run
+lj-awb create image ... --yes
 ```
 
 缺少 `--yes` 时，CLI 返回 `confirmation_required`，退出码为 `10`。`task wait` 超时返回 `task_still_running`，退出码为 `20`。
@@ -177,7 +177,7 @@ lj-awb model options --model-group-code <modelGroupCode>
 lj-awb model create-spec --model-group-code <modelGroupCode>
 ```
 
-`model input-guide` 返回跨模型统一参数、`resources` 字段和 `reference_key` 规则。`model options` 专门返回模型参数、资源媒体约束和条件约束，例如 `params[].values`、`params[].defaultValue`、`resources[].mediaType`、`resources[].usage`、`resources[].fileTypes`、`resources[].maxFiles`、`resources[].supportLastFrameOnly`、`resources[].minDurationMs/maxDurationMs`、`constraints[].target`、`constraints[].conditions`。`model create-spec` 专门返回如何创建任务，例如 `inputRequirement`、`supportedIntents`、`preflight` 和 `examples`。默认 text 已经覆盖常用决策字段；只有脚本严格解析或需要完整嵌套结构时才追加 `-f json`。Agent 应用 `options` 选参数值、校验素材并判断联动约束，再用 `create-spec` 组装 `image create` / `video create`，不要直接把平台旧参数传给 create。上传音频是 `resources` 素材输入，具体 `audio:reference` 写法看 `input-guide` / `create-spec`；是否需要输出音效才使用 `--need-audio true/false`。
+`model input-guide` 返回跨模型统一参数、`resources` 字段和 `reference_key` 规则。`model options` 专门返回模型参数、资源媒体约束和条件约束，例如 `params[].values`、`params[].defaultValue`、`resources[].mediaType`、`resources[].usage`、`resources[].fileTypes`、`resources[].maxFiles`、`resources[].supportLastFrameOnly`、`resources[].minDurationMs/maxDurationMs`、`constraints[].target`、`constraints[].conditions`。`model create-spec` 专门返回如何创建任务，例如 `inputRequirement`、`supportedIntents`、`preflight` 和 `examples`。默认 text 已经覆盖常用决策字段；只有脚本严格解析或需要完整嵌套结构时才追加 `-f json`。Agent 应用 `options` 选参数值、校验素材并判断联动约束，再用 `create-spec` 组装 `create image` / `create video`，不要直接把平台旧参数传给 create。上传音频是 `resources` 素材输入，具体 `audio:reference` 写法看 `input-guide` / `create-spec`；是否需要输出音效才使用 `--need-audio true/false`。
 
 ## 示例：参考图生成视频
 
@@ -188,7 +188,7 @@ lj-awb model input-guide -f json
 lj-awb model options --model-group-code <modelGroupCode> -f json
 lj-awb model create-spec --model-group-code <modelGroupCode> -f json
 
-lj-awb video fee \
+lj-awb create video-fee \
   --model-group-code <modelGroupCode> \
   --prompt "参考女主首帧，在雨夜街头奔跑，电影感运镜" \
   --resource image:first_frame=./actor.png \
@@ -197,7 +197,7 @@ lj-awb video fee \
   --duration 5 \
   --project-group-no <projectGroupNo>
 
-lj-awb video create \
+lj-awb create video \
   --model-group-code <modelGroupCode> \
   --prompt "参考女主首帧，在雨夜街头奔跑，电影感运镜" \
   --resource image:first_frame=./actor.png \
@@ -218,7 +218,7 @@ lj-awb task wait \
 帧素材也可以直接使用平台资产 ID；是否可传尾帧以 `model options.resources[].usage` 是否包含 `last_frame` 为准：
 
 ```bash
-lj-awb video create \
+lj-awb create video \
   --model-group-code <modelGroupCode> \
   --prompt "参考首帧生成一段镜头推进视频" \
   --resource image:first_frame=asset:<assetId> \
@@ -235,9 +235,9 @@ lj-awb video create \
 如果参考图会复用，推荐先发布主体资产：
 
 ```bash
-lj-awb subject publish --name 女主 --primary-file ./actor.png --yes
-lj-awb subject wait --element-id <elementId> --wait-seconds 300
-lj-awb video create \
+lj-awb create subject --name 女主 --primary-file ./actor.png --yes
+lj-awb create subject-wait --element-id <elementId> --wait-seconds 300
+lj-awb create video \
   --model-group-code <modelGroupCode> \
   --prompt "<<<女主>>> 在雨夜街头奔跑，电影感运镜" \
   --resource subject:reference:女主=asset:<externalId> \

package/install.mjs

@@ -34,6 +34,7 @@ const skillTargetDirs = explicitSkillTargetDir
   : [
       join(homedir(), '.cc-switch', 'skills', 'lj-awb'),
       join(codexHomeDir, 'skills', 'lj-awb'),
+      join(homedir(), '.claude', 'skills', 'lj-awb'),
     ];
 
 if (process.env.LINGJING_AWB_SKIP_SKILL_INSTALL === '1' || process.env.ANIME_SKIP_SKILL_INSTALL === '1') {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lingjingai/lj-awb-cli-pre",
-  "version": "0.3.15",
+  "version": "0.3.16",
   "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",
@@ -22,7 +22,7 @@
     "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/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 && 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 image && packages/awb-cli/bin/lj-awb video && packages/awb-cli/bin/lj-awb task && packages/awb-cli/bin/lj-awb asset && packages/awb-cli/bin/lj-awb subject && 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 artifact && 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.3.15",
+  "version": "0.3.16",
   "description": "Standalone CLI for Lingjing AWB",
   "private": true,
   "license": "MIT",
@@ -13,6 +13,6 @@
     "README.md"
   ],
   "dependencies": {
-    "@lingjingai/awb-core": "0.3.15"
+    "@lingjingai/awb-core": "0.3.16"
   }
 }

package/packages/awb-core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lingjingai/awb-core",
-  "version": "0.3.15",
+  "version": "0.3.16",
   "description": "Shared core runtime for Lingjing AWB CLI",
   "license": "MIT",
   "type": "module",

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

@@ -1,12 +1,6 @@
 import { API_ORIGIN, LingjingAwbCliError } from './common.js';
 import { resolveAuthContext } from './auth.js';
 
-export const ASSET_EDIT_ORIGIN = (
-  process.env.LINGJING_AWB_ASSET_EDIT_ORIGIN
-  || process.env.ASSET_EDIT_ORIGIN
-  || 'https://asset-edit.lingjingai.cn'
-).replace(/\/+$/, '');
-
 function buildHeaders(authContext, extraHeaders = {}) {
   const contextHeaders = {};
   for (const [headerName, envNames] of Object.entries({
@@ -224,6 +218,14 @@ export async function fetchVideoTask(taskId) {
   });
 }
 
+export async function fetchVideoSubtitleRemovalFee(payload = {}) {
+  return await apiFetch('/api/material/creation/videoSubtitleRemovalFeeCalc', { body: payload });
+}
+
+export async function createVideoSubtitleRemovalTask(payload = {}) {
+  return await apiFetch('/api/material/creation/videoSubtitleRemoval', { body: payload });
+}
+
 export async function fetchTaskFeed(payload = {}) {
   return await apiFetch('/api/material/creation/task/feedPull', {
     query: payload,
@@ -283,67 +285,27 @@ export async function listElementsByName(elementName) {
   });
 }
 
-export async function assetEditFetch(pathname, options = {}) {
-  const {
-    method = 'GET',
-    body,
+export async function listVoices(query = {}) {
+  return await apiFetch('/api/material/creation/listVoices', {
+    method: 'GET',
     query,
-    headers = {},
-  } = options;
-  const url = new URL(pathname, ASSET_EDIT_ORIGIN);
-  for (const [key, value] of Object.entries(query || {})) {
-    if (value === undefined || value === null || value === '') continue;
-    url.searchParams.set(key, String(value));
-  }
-  let response;
-  try {
-    response = await fetch(url, {
-      method,
-      headers: {
-        'content-type': 'application/json',
-        ...headers,
-      },
-      body: method.toUpperCase() === 'GET' || body === undefined ? undefined : stringifyJsonBody(body),
-    });
-  } catch (error) {
-    throw new LingjingAwbCliError(`请求去字幕服务失败：${error.message}`, {
-      type: 'network_error',
-      exitCode: 30,
-      details: { url: url.toString() },
-    });
-  }
-  const rawText = await response.text();
-  let payload = null;
-  try {
-    payload = rawText ? JSON.parse(rawText) : null;
-  } catch {
-    throw new LingjingAwbCliError('去字幕服务返回了无效 JSON', {
-      type: 'invalid_json',
-      exitCode: 30,
-      details: { status: response.status, body: rawText.slice(0, 500) },
-    });
-  }
-  if (!response.ok) {
-    throw new LingjingAwbCliError(payload?.message || payload?.msg || `${response.status} ${response.statusText}`, {
-      type: 'http_error',
-      exitCode: 30,
-      details: { status: response.status, payload },
-    });
-  }
-  return payload && typeof payload === 'object' && 'data' in payload ? payload.data : payload;
+  });
 }
 
-export async function createSubtitleRemoveTask(payload = {}) {
-  return await assetEditFetch('/api/watermark/tasks', {
-    method: 'POST',
-    body: payload,
-  });
+export async function createVoice(payload = {}) {
+  return await apiFetch('/api/material/creation/createVoice', { body: payload });
 }
 
-export async function fetchSubtitleTaskByPublicId(publicId) {
-  return await assetEditFetch(`/api/watermark/tasks/${encodeURIComponent(publicId)}`);
+export async function getVoiceByReqTaskId(reqTaskId) {
+  return await apiFetch('/api/material/creation/getVoiceByReqTaskId', {
+    method: 'GET',
+    query: { reqTaskId },
+  });
 }
 
-export async function fetchSubtitleTaskByRemoteId(remoteTaskId) {
-  return await assetEditFetch(`/api/watermark/remote/${encodeURIComponent(remoteTaskId)}`);
+export async function listVoicesByName(voiceName) {
+  return await apiFetch('/api/material/creation/listVoicesByName', {
+    method: 'GET',
+    query: { voiceName },
+  });
 }

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

@@ -32,6 +32,9 @@ import {
   subjectList,
   subjectPublish,
   subjectPublishBatch,
+  subjectVoiceCreate,
+  subjectVoiceList,
+  subjectVoiceWait,
   subjectWait,
   subtitleRemove,
   subtitleStatus,
@@ -419,7 +422,7 @@ export function registerAwbCommands(cli) {
       examples: [
         'lj-awb model create-spec --model-group-code <code>',
       ],
-      hint: '创建前先用 model input-guide 理解统一参数，再用 model options 查具体枚举和素材限制，最后按 create-spec 组装 image create / video create。',
+      hint: '创建前先用 model input-guide 理解统一参数，再用 model options 查具体枚举和素材限制，最后按 create-spec 组装 create image / create video。',
     }),
     args: [
       MODEL_GROUP_ARG,
@@ -461,9 +464,9 @@ export function registerAwbCommands(cli) {
   });
 
   cli({
-    name: 'image fee',
+    name: 'create image-fee',
     description: commandHelp('计算生图预计积分（必须有 --prompt；参考图通过 --resource 传入）', {
-      examples: ['lj-awb image fee --model-group-code <code> --prompt "一只小狗" --ratio 9:16 --quality 2K'],
+      examples: ['lj-awb create image-fee --model-group-code <code> --prompt "一只小狗" --ratio 9:16 --quality 2K'],
       hint: '估价前先确认 quality、ratio、generate-num 等会影响积分的关键参数。',
     }),
     args: [
@@ -481,12 +484,12 @@ export function registerAwbCommands(cli) {
   });
 
   cli({
-    name: 'image create',
+    name: 'create image',
     description: commandHelp('提交生图任务；正式执行需要 --yes', {
       examples: [
-        'lj-awb image create --model-group-code <code> --prompt "一只小狗" --dry-run',
-        'lj-awb image create --model-group-code <code> --prompt "参考图里的角色奔跑" --resource image:reference=./ref.png --project-group-no <no> --yes',
-        'lj-awb image create --model-group-code <code> --prompt "产品海报" --resources-json \'[{"type":"image","usage":"reference","source":{"kind":"url","value":"./product.jpg"}}]\' --dry-run',
+        'lj-awb create image --model-group-code <code> --prompt "一只小狗" --dry-run',
+        'lj-awb create image --model-group-code <code> --prompt "参考图里的角色奔跑" --resource image:reference=./ref.png --project-group-no <no> --yes',
+        'lj-awb create image --model-group-code <code> --prompt "产品海报" --resources-json \'[{"type":"image","usage":"reference","source":{"kind":"url","value":"./product.jpg"}}]\' --dry-run',
       ],
     }),
     args: [
@@ -508,11 +511,11 @@ export function registerAwbCommands(cli) {
   });
 
   cli({
-    name: 'image create-batch',
+    name: 'create image-batch',
     description: commandHelp('批量提交生图任务；输入支持 JSON / JSONL / 纯文本 prompt（每行一条）', {
       examples: [
-        'lj-awb image create-batch --input-file ./prompts.txt --model-group-code <code> --dry-run',
-        'lj-awb image create-batch --input-file ./image-input.jsonl --model-group-code <code> --concurrency 3 --yes',
+        'lj-awb create image-batch --input-file ./prompts.txt --model-group-code <code> --dry-run',
+        'lj-awb create image-batch --input-file ./image-input.jsonl --model-group-code <code> --concurrency 3 --yes',
       ],
       hint: 'JSON/JSONL 每项只写任务差异字段：prompt、ratio、quality、generate_num、resources、resource、customBizId。',
     }),
@@ -529,9 +532,9 @@ export function registerAwbCommands(cli) {
   });
 
   cli({
-    name: 'image status',
+    name: 'task image-status',
     description: commandHelp('查询生图任务状态', {
-      examples: ['lj-awb image status --task-id <id>'],
+      examples: ['lj-awb task image-status --task-id <id>'],
     }),
     args: [
       { name: 'task-id', valueName: 'id', description: '任务 ID' },
@@ -540,9 +543,9 @@ export function registerAwbCommands(cli) {
   });
 
   cli({
-    name: 'video fee',
+    name: 'create video-fee',
     description: commandHelp('计算生视频预计积分（--prompt / --resource / --resources-json 至少传一个）', {
-      examples: ['lj-awb video fee --model-group-code <code> --prompt "雨夜奔跑" --duration 5 --quality 720 --ratio 9:16'],
+      examples: ['lj-awb create video-fee --model-group-code <code> --prompt "雨夜奔跑" --duration 5 --quality 720 --ratio 9:16'],
       hint: '估价前先确认 quality、duration、ratio 等会影响积分的关键参数。',
     }),
     args: [
@@ -561,13 +564,13 @@ export function registerAwbCommands(cli) {
   });
 
   cli({
-    name: 'video create',
+    name: 'create video',
     description: commandHelp('提交生视频任务；正式执行需要 --yes', {
       examples: [
-        'lj-awb video create --model-group-code <code> --prompt "雨夜奔跑" --dry-run',
-        'lj-awb video create --model-group-code <code> --prompt "镜头推进" --resource image:first_frame=./actor.png --duration 5 --yes',
-        'lj-awb video create --model-group-code <code> --prompt "首尾帧过渡" --duration 5 --resources-json \'[{"type":"image","usage":"first_frame","source":{"kind":"url","value":"./first.png"}},{"type":"image","usage":"last_frame","source":{"kind":"url","value":"./last.png"}}]\' --dry-run',
-        'lj-awb video create --model-group-code <code> --prompt "让 <<<hero>>> 跟随音乐节奏转身" --resource image:reference:hero=./actor.png --resource audio:reference=./music.mp3 --duration 5 --dry-run',
+        'lj-awb create video --model-group-code <code> --prompt "雨夜奔跑" --dry-run',
+        'lj-awb create video --model-group-code <code> --prompt "镜头推进" --resource image:first_frame=./actor.png --duration 5 --yes',
+        'lj-awb create video --model-group-code <code> --prompt "首尾帧过渡" --duration 5 --resources-json \'[{"type":"image","usage":"first_frame","source":{"kind":"url","value":"./first.png"}},{"type":"image","usage":"last_frame","source":{"kind":"url","value":"./last.png"}}]\' --dry-run',
+        'lj-awb create video --model-group-code <code> --prompt "让 <<<hero>>> 跟随音乐节奏转身" --resource image:reference:hero=./actor.png --resource audio:reference=./music.mp3 --duration 5 --dry-run',
       ],
       hint: '--prompt / --resource / --resources-json 至少传一个；fee / --dry-run 之前先确认 quality、duration、ratio 等关键参数。',
     }),
@@ -591,11 +594,11 @@ export function registerAwbCommands(cli) {
   });
 
   cli({
-    name: 'video create-batch',
+    name: 'create video-batch',
     description: commandHelp('批量提交生视频任务；输入支持 JSON / JSONL / 纯文本 prompt（每行一条）', {
       examples: [
-        'lj-awb video create-batch --input-file ./prompts.txt --model-group-code <code> --dry-run',
-        'lj-awb video create-batch --input-file ./video-input.jsonl --model-group-code <code> --concurrency 2 --yes',
+        'lj-awb create video-batch --input-file ./prompts.txt --model-group-code <code> --dry-run',
+        'lj-awb create video-batch --input-file ./video-input.jsonl --model-group-code <code> --concurrency 2 --yes',
       ],
       hint: 'JSON/JSONL 每项只写任务差异字段：prompt、ratio、quality、duration、need_audio、resources、resource、customBizId。',
     }),
@@ -612,24 +615,24 @@ export function registerAwbCommands(cli) {
   });
 
   cli({
-    name: 'video status',
+    name: 'task video-status',
     description: commandHelp('查询生视频任务状态', {
-      examples: ['lj-awb video status --task-id <id>'],
+      examples: ['lj-awb task video-status --task-id <id>'],
     }),
     args: [{ name: 'task-id', valueName: 'id', description: '任务 ID' }],
     func: async (_ctx, kwargs) => taskStatus({ ...kwargs, taskType: 'VIDEO_GROUP' }),
   });
 
   cli({
-    name: 'video subtitle-remove',
-    description: commandHelp('提交视频去字幕 / 去水印任务', {
-      examples: ['lj-awb video subtitle-remove --video-url "https://..." --dry-run'],
-      hint: '该能力走 asset-edit.lingjingai.cn，适合 Seedance 原始结果后处理。',
+    name: 'create video-subtitle-removal',
+    description: commandHelp('基于 material 来源视频任务提交去字幕任务', {
+      examples: ['lj-awb create video-subtitle-removal --source-task-id <videoTaskId> --project-group-no <no> --dry-run'],
+      hint: '不再接收视频 URL；material 会根据来源任务读取原始视频、计费、落库和异步处理。',
     }),
     args: [
-      { name: 'video-url', valueName: 'url', description: '待处理视频 URL' },
-      { name: 'name', valueName: 'name', description: '可选任务名' },
-      { name: 'callback-url', valueName: 'url', description: '可选回调 URL' },
+      { name: 'source-task-id', valueName: 'id', description: '来源视频任务 ID；必须是 material 中已成功的视频任务' },
+      PROJECT_GROUP_ARG,
+      TASK_RECORD_ARG,
       DRY_RUN_ARG,
       YES_ARG,
     ],
@@ -637,13 +640,13 @@ export function registerAwbCommands(cli) {
   });
 
   cli({
-    name: 'video subtitle-status',
-    description: commandHelp('查询去字幕 / 去水印任务状态', {
-      examples: ['lj-awb video subtitle-status --remote-task-id <id>', 'lj-awb video subtitle-status --public-id <id>'],
+    name: 'task video-subtitle-status',
+    description: commandHelp('查询 material 去字幕任务状态', {
+      examples: ['lj-awb task video-subtitle-status --task-id <subtitleTaskId>'],
     }),
     args: [
-      { name: 'remote-task-id', valueName: 'id', description: '远端任务 ID' },
-      { name: 'public-id', valueName: 'id', description: '公开任务 ID' },
+      { name: 'task-id', valueName: 'id', description: 'material 去字幕任务 ID' },
+      PROJECT_GROUP_ARG,
     ],
     func: async (_ctx, kwargs) => subtitleStatus(kwargs),
   });
@@ -706,9 +709,9 @@ export function registerAwbCommands(cli) {
   });
 
   cli({
-    name: 'asset match-actor',
+    name: 'create asset-match-actor',
     description: commandHelp('按描述和标签匹配平台素材库角色候选', {
-      examples: ['lj-awb asset match-actor --description "十八岁少女，古风，清冷" --tags-json \'{"gender":"女"}\''],
+      examples: ['lj-awb create asset-match-actor --description "十八岁少女，古风，清冷" --tags-json \'{"gender":"女"}\''],
     }),
     args: [
       { name: 'description', valueName: 'text', description: '角色 / 状态描述' },
@@ -721,9 +724,9 @@ export function registerAwbCommands(cli) {
   });
 
   cli({
-    name: 'asset groups',
+    name: 'create asset-groups',
     description: commandHelp('查询素材组', {
-      examples: ['lj-awb asset groups --name "女主"'],
+      examples: ['lj-awb create asset-groups --name "女主"'],
     }),
     args: [
       { name: 'name', valueName: 'keyword', description: '素材组名称关键词' },
@@ -736,20 +739,20 @@ export function registerAwbCommands(cli) {
   });
 
   cli({
-    name: 'asset group',
+    name: 'create asset-group-get',
     description: commandHelp('查看素材组详情', {
-      examples: ['lj-awb asset group --group-id <id>'],
+      examples: ['lj-awb create asset-group-get --group-id <id>'],
     }),
     args: [{ name: 'group-id', valueName: 'id', description: '素材组 ID' }],
     func: async (_ctx, kwargs) => assetGroupGet(kwargs),
   });
 
   cli({
-    name: 'asset group-create',
+    name: 'create asset-group',
     description: commandHelp('创建素材组（用于素材注册时作为命名空间）', {
       examples: [
-        'lj-awb asset group-create --name "女主素材组" --dry-run',
-        'lj-awb asset group-create --name "女主素材组" --description "用于第二集女主相关素材" --yes',
+        'lj-awb create asset-group --name "女主素材组" --dry-run',
+        'lj-awb create asset-group --name "女主素材组" --description "用于第二集女主相关素材" --yes',
       ],
     }),
     args: [
@@ -763,9 +766,9 @@ export function registerAwbCommands(cli) {
   });
 
   cli({
-    name: 'asset group-update',
+    name: 'create asset-group-update',
     description: commandHelp('更新素材组名称 / 描述', {
-      examples: ['lj-awb asset group-update --group-id <id> --name "新名称" --dry-run'],
+      examples: ['lj-awb create asset-group-update --group-id <id> --name "新名称" --dry-run'],
     }),
     args: [
       { name: 'group-id', valueName: 'id', description: '素材组 ID' },
@@ -779,9 +782,9 @@ export function registerAwbCommands(cli) {
   });
 
   cli({
-    name: 'asset register',
+    name: 'create asset',
     description: commandHelp('把 COS 路径 / URL / 本地文件注册成平台素材', {
-      examples: ['lj-awb asset register --group-id <id> --url "material/upload/a.png" --name "女主正面" --dry-run'],
+      examples: ['lj-awb create asset --group-id <id> --url "material/upload/a.png" --name "女主正面" --dry-run'],
     }),
     args: [
       { name: 'group-id', valueName: 'id', description: '素材组 ID' },
@@ -1253,9 +1256,9 @@ export function registerAwbCommands(cli) {
   }
 
   cli({
-    name: 'subject list',
+    name: 'create subject-list',
     description: commandHelp('查询可用于视频主体参考的元素 / 主体', {
-      examples: ['lj-awb subject list --name "女主"'],
+      examples: ['lj-awb create subject-list --name "女主"'],
     }),
     args: [
       { name: 'name', valueName: 'keyword', description: '主体名称关键词' },
@@ -1267,18 +1270,18 @@ export function registerAwbCommands(cli) {
   });
 
   cli({
-    name: 'subject publish',
-    description: commandHelp('创建平台主体 element，用于 KeLing / 可灵 视频主体参考', {
+    name: 'create subject',
+    description: commandHelp('创建平台主体 element，用于 KeLing / 可灵 和 Vidu 视频主体参考', {
       examples: [
-        'lj-awb subject publish --name 女主 --resource primary:./three-view.png --dry-run',
-        'lj-awb subject publish --name 女主 --resource primary:material/assets/a.png --resource face:./face.png --yes',
+        'lj-awb create subject --model-code tx --name 女主 --resource primary:./three-view.png --dry-run',
+        'lj-awb create subject --model-code vidu --name 女主 --resource primary:material/assets/a.png --resource face:./face.png --yes',
       ],
-      hint: '参考图 slot：primary | three-view | face | side | back。无 primary 时 three-view 自动升为主图；本地路径（./ 或绝对路径）会自动上传，含 :// 或 material/ 前缀的视为已上传 URL。',
+      hint: '参考图 slot：primary | three-view | face | side | back。主体 modelCode：KeLing / 可灵 → tx，Vidu → vidu。无 primary 时 three-view 自动升为主图；本地路径（./ 或绝对路径）会自动上传，含 :// 或 material/ 前缀的视为已上传 URL。',
     }),
     args: [
       { name: 'name', valueName: 'name', description: '主体名称' },
       { name: 'description', valueName: 'text', description: '主体描述' },
-      { name: 'model-code', valueName: 'code', description: '主体创建模型编码，可选' },
+      { name: 'model-code', valueName: 'code', description: '主体创建模型编码 tx / vidu；KeLing / 可灵用 tx，Vidu 用 vidu' },
       { name: 'reference-type', valueName: 'type', description: '参考类型，默认 image_refer' },
       { name: 'voice-id', valueName: 'id', description: '参考音色 ID，可选' },
       { name: 'tags-json', valueName: 'json', description: '标签数组，例如 [{"tagId":"o_102"}]' },
@@ -1290,27 +1293,77 @@ export function registerAwbCommands(cli) {
   });
 
   cli({
-    name: 'subject wait',
+    name: 'create subject-wait',
     description: commandHelp('等待主体 externalId 回填，用于后续视频主体参考', {
-      examples: ['lj-awb subject wait --element-id <elementId> --wait-seconds 300'],
+      examples: ['lj-awb create subject-wait --element-id <elementId> --wait-seconds 300'],
     }),
     args: [
-      { name: 'element-id', valueName: 'id', description: 'subject publish 返回的 elementId' },
+      { name: 'element-id', valueName: 'id', description: 'create subject 返回的 elementId' },
       ...SUBJECT_WAIT_ARGS,
     ],
     func: async (_ctx, kwargs) => subjectWait(kwargs),
   });
 
   cli({
-    name: 'subject publish-batch',
+    name: 'create subject-voice-list',
+    description: commandHelp('查询主体创建可引用的自定义音色', {
+      examples: ['lj-awb create subject-voice-list --name "女主"'],
+    }),
+    args: [
+      { name: 'name', valueName: 'keyword', description: '音色名称关键词' },
+      { name: 'page-number', valueName: 'n', description: '页码' },
+      { name: 'page-size', valueName: 'n', description: '每页数量' },
+      INCLUDE_RAW_ARG,
+    ],
+    func: async (_ctx, kwargs) => subjectVoiceList(kwargs),
+  });
+
+  cli({
+    name: 'create subject-voice',
+    description: commandHelp('创建主体自定义音色，成功后 externalId 可作为 create subject --voice-id', {
+      examples: [
+        'lj-awb create subject-voice --name 女主音色 --file ./voice.mp3 --dry-run',
+        'lj-awb create subject-voice --name 女主音色 --voice-url material/video-create/audio.mp3 --yes',
+      ],
+      hint: '音色来源三选一：--file 本地音频会先上传；--voice-url/--audio-url 使用已上传 material 路径，外部 HTTP URL 会先转存上传；--video-id 使用已有视频 ID。',
+    }),
+    args: [
+      { name: 'name', valueName: 'name', description: '音色名称' },
+      { name: 'file', valueName: 'path', description: '本地音频文件，创建前自动上传' },
+      { name: 'voice-url', valueName: 'url', description: '已上传的 material 音频路径或 COS URL' },
+      { name: 'audio-url', valueName: 'url', description: '同 --voice-url，兼容音频命名' },
+      { name: 'video-id', valueName: 'id', description: '已有视频 ID；与 --file / --voice-url 二选一' },
+      { name: 'req-task-id', valueName: 'id', description: '可选外部追踪 ID' },
+      DRY_RUN_ARG,
+      YES_ARG,
+    ],
+    func: async (_ctx, kwargs) => subjectVoiceCreate(kwargs),
+  });
+
+  cli({
+    name: 'create subject-voice-wait',
+    description: commandHelp('等待主体音色 externalId 回填，用于 create subject --voice-id', {
+      examples: ['lj-awb create subject-voice-wait --voice-record-id <voiceRecordId> --wait-seconds 300'],
+    }),
+    args: [
+      { name: 'voice-record-id', valueName: 'id', description: 'create subject-voice 返回的 voiceRecordId' },
+      { name: 'req-task-id', valueName: 'id', description: '兼容 material getVoiceByReqTaskId 的 reqTaskId' },
+      ...SUBJECT_WAIT_ARGS,
+    ],
+    func: async (_ctx, kwargs) => subjectVoiceWait(kwargs),
+  });
+
+  cli({
+    name: 'create subject-batch',
     description: commandHelp('批量发布主体资产；输入支持 JSON 数组文件或 JSONL（每行一条）', {
       examples: [
-        'lj-awb subject publish-batch --input-file ./subjects.jsonl --dry-run',
-        'lj-awb subject publish-batch --input-file ./subjects.json --concurrency 2 --yes',
+        'lj-awb create subject-batch --model-code tx --input-file ./subjects.jsonl --dry-run',
+        'lj-awb create subject-batch --model-code vidu --input-file ./subjects.json --concurrency 2 --yes',
       ],
     }),
     args: [
       { name: 'input-file', valueName: 'path', description: '批量输入文件' },
+      { name: 'model-code', valueName: 'code', description: '默认主体创建模型编码 tx / vidu；单条可覆盖' },
       { name: 'project-name', valueName: 'name', description: '默认项目名' },
       { name: 'concurrency', valueName: 'n', description: '并发数，默认 1' },
       DRY_RUN_ARG,