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

package/README.md

@@ -22,12 +22,9 @@ CLI 本身只负责平台调用、参数校验、精简输出和安全确认；
 | 积分 | `credits` | 可扣积分余额、项目组预算、任务用量统计 |
 | 模型 | `model` | 生图 / 生视频模型发现、模型参数白名单 |
 | 上传 | `upload` | 本地图片 / 视频 / 音频上传为平台可访问素材 |
-| 图片 | `image` | 生图估价、提交、批量提交、状态查询 |
-| 视频 | `video` | 生视频估价、提交、批量提交、状态查询、去字幕 |
+| 创建 | `create` | 生图、生视频、主体、音色、素材和去字幕提交 |
 | 任务 | `task` | 任务列表、等待、任务台账和台账轮询 |
-| 资产 | `asset` | 素材库匹配、素材组、素材注册 |
 | 最终产物 | `artifact` | Workbench 剧本、资产、视频最终产物 CRUD 与本地 JSON 导入 |
-| 主体 | `subject` | 可复用主体资产发布与查询 |
 
 ## 环境要求
 
@@ -114,7 +111,7 @@ lj-awb account info
 lj-awb doctor
 lj-awb doctor --verify
 lj-awb schema -f json
-lj-awb schema --domain video -f json
+lj-awb schema --domain create -f json
 lj-awb auth status
 lj-awb auth verify
 lj-awb account info
@@ -148,8 +145,8 @@ Agent 不应该靠记忆猜命令参数。进入任务前推荐先读取机器
 
 ```bash
 lj-awb schema -f json
-lj-awb schema --domain image -f json
-lj-awb schema --domain video --command create -f json
+lj-awb schema --domain create -f json
+lj-awb schema --domain create --command video -f json
 ```
 
 正式创作前推荐做一次体检：
@@ -235,7 +232,7 @@ lj-awb create video \
 如果参考图会复用，推荐先发布主体资产：
 
 ```bash
-lj-awb create subject --name 女主 --primary-file ./actor.png --yes
+lj-awb create subject --model-code tx --name 女主 --resource primary:./actor.png --yes
 lj-awb create subject-wait --element-id <elementId> --wait-seconds 300
 lj-awb create video \
   --model-group-code <modelGroupCode> \

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lingjingai/lj-awb-cli-pre",
-  "version": "0.3.16",
+  "version": "0.3.17",
   "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",

package/packages/awb-cli/package.json

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

package/packages/awb-core/package.json

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

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

@@ -177,6 +177,10 @@ export async function fetchModelGroupInfoAll(modelGroupCode) {
   return await apiFetch(`/api/resource/model/info/group/${encodeURIComponent(modelGroupCode)}/all`, { method: 'GET' });
 }
 
+export async function fetchAssetReviewModels() {
+  return await apiFetch('/api/material/creation/model/asset-review/list', { method: 'GET' });
+}
+
 export async function fetchUploadSecret(payload = {}) {
   return await apiFetch('/api/anime/workbench/TencentCloud/getSecret', { body: payload });
 }
@@ -241,8 +245,11 @@ export async function listAssetGroups(payload = {}) {
   return await apiFetch('/api/material/asset-groups/list', { body: payload });
 }
 
-export async function getAssetGroup(groupId) {
-  return await apiFetch(`/api/material/asset-groups/${encodeURIComponent(groupId)}`, { method: 'GET' });
+export async function getAssetGroup(groupId, payload = {}) {
+  return await apiFetch(`/api/material/asset-groups/${encodeURIComponent(groupId)}`, {
+    method: 'GET',
+    query: payload,
+  });
 }
 
 export async function createAssetGroup(payload = {}) {

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

@@ -8,6 +8,7 @@ import {
   assetGroupList,
   assetGroupUpdate,
   assetMatchActor,
+  assetReviewModels,
   assetRegister,
   creditsBalance,
   creditsUsageSummary,
@@ -74,6 +75,7 @@ const PROJECT_ID_ARG = { name: 'project-id', valueName: 'projectId', description
 const PROJECT_GROUP_ARG = { name: 'project-group-no', valueName: 'no', description: '项目组编号；不传时读取当前项目组 / 环境变量 / 本地状态' };
 const CUSTOM_BIZ_ARG = { name: 'custom-biz-id', valueName: 'id', description: '外部追踪 ID；不传则请求不携带 customBizId' };
 const MODEL_GROUP_ARG = { name: 'model-group-code', valueName: 'code', description: '模型组编码；创建和参数查询只传这个字段' };
+const ASSET_PLATFORM_ARG = { name: 'platform', valueName: 'platform', description: '素材加白平台，必须显式传 JIMENG 或 BYTEPLUS，不做别名推断' };
 const MODEL_LIST_ARGS = [
   { name: 'model', valueName: 'keyword', description: '按模型名、编码、供应商或输入方式过滤；不传时查询全部' },
   { name: 'limit', valueName: 'n', description: '默认文本最多展示 N 条，默认 8；JSON 输出始终返回全部匹配' },
@@ -399,6 +401,24 @@ export function registerAwbCommands(cli) {
     func: async (_ctx, kwargs) => listModels('video', kwargs),
   });
 
+  cli({
+    name: 'model asset-review-models',
+    description: commandHelp('查询支持素材加白的模型组与平台平铺关系', {
+      examples: [
+        'lj-awb model asset-review-models',
+        'lj-awb model asset-review-models --platform JIMENG',
+        'lj-awb model asset-review-models --model-group-code <code>',
+      ],
+      hint: '该命令只负责发现 modelGroupCode 与 platform 的关系；资产组和素材创建仍通过 create asset-group / create asset 显式传 --platform。',
+    }),
+    args: [
+      MODEL_GROUP_ARG,
+      ASSET_PLATFORM_ARG,
+      INCLUDE_RAW_ARG,
+    ],
+    func: async (_ctx, kwargs) => assetReviewModels(kwargs),
+  });
+
   cli({
     name: 'model options',
     description: commandHelp('查询指定模型支持的 CLI 参数、枚举值、素材约束和条件约束', {
@@ -448,7 +468,8 @@ export function registerAwbCommands(cli) {
     description: commandHelp('上传本地图片 / 视频 / 音频到平台 COS，并返回 backendPath / URL', {
       examples: [
         'lj-awb upload files --files ./a.png,./b.mp4 --dry-run',
-        'lj-awb upload files --file ./ref.png --scene-type material-video-create',
+        'lj-awb upload files --file ./ref.png',
+        'lj-awb upload files --file ./first-frame.png --scene-type material-video-create',
       ],
       hint: '不会暴露 COS 临时密钥；skill 只使用返回的 backendPath / url。',
     }),
@@ -456,7 +477,7 @@ export function registerAwbCommands(cli) {
       { name: 'file', valueName: 'path', description: '单个文件路径' },
       { name: 'files', valueName: 'paths', description: '多个文件路径，逗号分隔' },
       { name: 'files-json', valueName: 'path|json', description: '文件数组 JSON 或 JSON 文件路径' },
-      { name: 'scene-type', valueName: 'scene', description: '上传场景，默认 material-image-edit' },
+      { name: 'scene-type', valueName: 'scene', description: '上传场景；未传时图片默认 material-image-draw，音视频默认 material-video-create；图片用于视频 / 主体复用时显式传 material-video-create' },
       { name: 'project-no', valueName: 'no', description: '可选项目组编号；不传时读取当前项目组 / 环境变量 / 本地状态' },
       DRY_RUN_ARG,
     ],
@@ -726,10 +747,11 @@ export function registerAwbCommands(cli) {
   cli({
     name: 'create asset-groups',
     description: commandHelp('查询素材组', {
-      examples: ['lj-awb create asset-groups --name "女主"'],
+      examples: ['lj-awb create asset-groups --platform JIMENG --name "女主"'],
     }),
     args: [
       { name: 'name', valueName: 'keyword', description: '素材组名称关键词' },
+      ASSET_PLATFORM_ARG,
       { name: 'group-ids', valueName: 'ids', description: '素材组 ID，逗号分隔' },
       { name: 'page-number', valueName: 'n', description: '页码' },
       { name: 'page-size', valueName: 'n', description: '每页数量' },
@@ -741,9 +763,12 @@ export function registerAwbCommands(cli) {
   cli({
     name: 'create asset-group-get',
     description: commandHelp('查看素材组详情', {
-      examples: ['lj-awb create asset-group-get --group-id <id>'],
+      examples: ['lj-awb create asset-group-get --group-id <id> --platform JIMENG'],
     }),
-    args: [{ name: 'group-id', valueName: 'id', description: '素材组 ID' }],
+    args: [
+      { name: 'group-id', valueName: 'id', description: '素材组 ID' },
+      ASSET_PLATFORM_ARG,
+    ],
     func: async (_ctx, kwargs) => assetGroupGet(kwargs),
   });
 
@@ -751,13 +776,14 @@ export function registerAwbCommands(cli) {
     name: 'create asset-group',
     description: commandHelp('创建素材组（用于素材注册时作为命名空间）', {
       examples: [
-        'lj-awb create asset-group --name "女主素材组" --dry-run',
-        'lj-awb create asset-group --name "女主素材组" --description "用于第二集女主相关素材" --yes',
+        'lj-awb create asset-group --name "女主素材组" --platform JIMENG --dry-run',
+        'lj-awb create asset-group --name "女主素材组" --platform JIMENG --description "用于第二集女主相关素材" --yes',
       ],
     }),
     args: [
       { name: 'name', valueName: 'name', description: '素材组名称' },
       { name: 'description', valueName: 'text', description: '素材组描述' },
+      ASSET_PLATFORM_ARG,
       { name: 'project-name', valueName: 'name', description: '项目名，默认 default' },
       DRY_RUN_ARG,
       YES_ARG,
@@ -768,12 +794,13 @@ export function registerAwbCommands(cli) {
   cli({
     name: 'create asset-group-update',
     description: commandHelp('更新素材组名称 / 描述', {
-      examples: ['lj-awb create asset-group-update --group-id <id> --name "新名称" --dry-run'],
+      examples: ['lj-awb create asset-group-update --group-id <id> --platform JIMENG --name "新名称" --dry-run'],
     }),
     args: [
       { name: 'group-id', valueName: 'id', description: '素材组 ID' },
       { name: 'name', valueName: 'name', description: '新名称' },
       { name: 'description', valueName: 'text', description: '新描述' },
+      ASSET_PLATFORM_ARG,
       { name: 'project-name', valueName: 'name', description: '项目名' },
       DRY_RUN_ARG,
       YES_ARG,
@@ -784,7 +811,7 @@ export function registerAwbCommands(cli) {
   cli({
     name: 'create asset',
     description: commandHelp('把 COS 路径 / URL / 本地文件注册成平台素材', {
-      examples: ['lj-awb create asset --group-id <id> --url "material/upload/a.png" --name "女主正面" --dry-run'],
+      examples: ['lj-awb create asset --group-id <id> --platform JIMENG --url "asset-review/upload/a.png" --name "女主正面" --dry-run'],
     }),
     args: [
       { name: 'group-id', valueName: 'id', description: '素材组 ID' },
@@ -792,7 +819,7 @@ export function registerAwbCommands(cli) {
       { name: 'file', valueName: 'path', description: '本地素材文件；会先上传' },
       { name: 'url', valueName: 'url', description: '素材 URL 或 COS 路径' },
       { name: 'backend-path', valueName: 'path', description: 'upload files 返回的 backendPath' },
-      { name: 'platform', valueName: 'platform', description: '可选平台字段' },
+      ASSET_PLATFORM_ARG,
       DRY_RUN_ARG,
       YES_ARG,
     ],
@@ -1276,12 +1303,12 @@ export function registerAwbCommands(cli) {
         '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。主体 modelCode：KeLing / 可灵 → tx，Vidu → vidu。无 primary 时 three-view 自动升为主图；本地路径（./ 或绝对路径）会自动上传，含 :// 或 material/ 前缀的视为已上传 URL。',
+      hint: '参考图 slot：primary | three-view | face | side | back。主体 modelCode 只接受 tx / vidu：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: '主体创建模型编码 tx / vidu；KeLing / 可灵用 tx，Vidu 用 vidu' },
+      { 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"}]' },
@@ -1363,7 +1390,7 @@ export function registerAwbCommands(cli) {
     }),
     args: [
       { name: 'input-file', valueName: 'path', description: '批量输入文件' },
-      { name: 'model-code', valueName: 'code', description: '默认主体创建模型编码 tx / vidu；单条可覆盖' },
+      { name: 'model-code', valueName: 'code', description: '默认主体创建模型编码，仅 tx / vidu；单条可覆盖' },
       { name: 'project-name', valueName: 'name', description: '默认项目名' },
       { name: 'concurrency', valueName: 'n', description: '并发数，默认 1' },
       DRY_RUN_ARG,

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

@@ -21,7 +21,8 @@ export const TASK_UPLOAD_SCENE = {
   VIDEO_CREATE: 'material-video-create',
   VIDEO_GROUP: 'material-video-create',
   SUBJECT: 'material-video-create',
-  DEFAULT: 'material-image-edit',
+  ASSET_REVIEW: 'asset-review',
+  DEFAULT: 'material-image-draw',
 };
 export const TERMINAL_TASK_STATES = new Set([
   'SUCCESS',

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

@@ -160,9 +160,6 @@ function normalizeDryRun(data = {}) {
     localFiles,
     results: Array.isArray(data.results) ? data.results.map((row) => normalizeDryRunResult(row)) : data.results,
     nextRefSubject: data.nextRefSubject,
-    resolvedModelCode: data.resolvedModelCode,
-    resolvedFrom: data.resolvedFrom,
-    resolvedFromValue: data.resolvedFromValue,
   });
 }
 
@@ -338,6 +335,7 @@ function normalizeAsset(data = {}) {
     registered: data.registered,
     groupId: data.groupId,
     assetId: data.assetId,
+    platform: data.platform,
     name: data.name,
     projectName: data.projectName,
     assetPath: data.assetPath,
@@ -536,6 +534,7 @@ export function normalizeOutputData(commandName, data) {
       return normalizeAsset(data);
     case 'model image-models':
     case 'model video-models':
+    case 'model asset-review-models':
       return normalizeList(data, ['models', 'items', 'rows']);
     case 'account teams':
       return normalizeList(data, ['teams']);
@@ -699,6 +698,7 @@ function rowSummary(row) {
     'remoteTaskId',
     'taskType',
     'modelGroupCode',
+    'platform',
     'provider',
     'displayName',
     'modelDesc',
@@ -1117,10 +1117,8 @@ export function formatTextOutput(commandName, data, context = {}) {
       'taskType',
       'taskStatus',
       'modelCode',
-      'resolvedModelCode',
-      'resolvedFrom',
-      'resolvedFromValue',
       'modelGroupCode',
+      'platform',
       'projectGroupNo',
       'projectId',
       'groupId',

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

@@ -58,6 +58,9 @@ const REMOTE_VOICE_MIME_TYPES = new Set([
   'video/mp4',
 ]);
 const REMOTE_VOICE_EXTENSIONS = new Set(['.mp3', '.wav', '.m4a', '.aac', '.ogg', '.mp4']);
+const ASSET_PLATFORM_CODES = ['JIMENG', 'BYTEPLUS'];
+const ASSET_PLATFORM_CODE_SET = new Set(ASSET_PLATFORM_CODES);
+const ASSET_PLATFORM_HINT = ASSET_PLATFORM_CODES.join('|');
 
 export function normalizeUserInfo(payload) {
   const data = payload && typeof payload === 'object' ? payload : {};
@@ -732,6 +735,44 @@ export async function listModels(kind, kwargs = {}) {
   return { usage, models };
 }
 
+function requireAssetPlatform(value, options = {}) {
+  const flag = options.flag || '--platform';
+  const platform = trimToNull(value);
+  if (!platform) {
+    throw argumentError(`缺少参数：${flag}`, `素材加白平台必须显式传入 ${ASSET_PLATFORM_HINT}，不要依赖默认平台。`);
+  }
+  if (!ASSET_PLATFORM_CODE_SET.has(platform)) {
+    throw argumentError(`不支持的平台：${platform}`, `只接受 ${ASSET_PLATFORM_HINT}；请使用 model asset-review-models 查看模型支持的平台。`);
+  }
+  return platform;
+}
+
+function optionalAssetPlatform(value) {
+  if (value == null || value === '') return null;
+  return requireAssetPlatform(value);
+}
+
+function normalizeAssetReviewModelRecord(item = {}) {
+  return compactRecord({
+    modelGroupCode: item?.modelGroupCode ?? item?.groupCode ?? null,
+    platform: item?.platform ?? null,
+  });
+}
+
+export async function assetReviewModels(kwargs = {}) {
+  const modelGroupCode = trimToNull(kwargs.modelGroupCode);
+  const platform = optionalAssetPlatform(kwargs.platform);
+  const payload = await awbApi.fetchAssetReviewModels();
+  const models = normalizeRows(payload)
+    .map((item) => normalizeAssetReviewModelRecord(item))
+    .filter((item) => !modelGroupCode || item.modelGroupCode === modelGroupCode)
+    .filter((item) => !platform || item.platform === platform);
+  return {
+    models,
+    ...(toBool(kwargs.includeRaw) ? { raw: payload } : {}),
+  };
+}
+
 async function findModelGroup(modelGroupCode, options = {}) {
   const includeRaw = Boolean(options.includeRaw);
   const [imageResult, videoResult] = await Promise.allSettled([
@@ -2168,7 +2209,35 @@ async function readJsonMaybeFile(value, fallback) {
   return JSON.parse(fileText);
 }
 
-async function collectFileSpecs(kwargs = {}, defaultSceneType = TASK_UPLOAD_SCENE.DEFAULT) {
+const AUDIO_VIDEO_EXTENSIONS = new Set([
+  '.aac',
+  '.aiff',
+  '.avi',
+  '.flac',
+  '.m4a',
+  '.m4v',
+  '.mkv',
+  '.mov',
+  '.mp3',
+  '.mp4',
+  '.mpeg',
+  '.mpg',
+  '.oga',
+  '.ogg',
+  '.ogv',
+  '.wav',
+  '.webm',
+]);
+
+function defaultUploadSceneForFile(filePath, mimeType = '') {
+  const normalizedMime = String(mimeType || '').toLowerCase();
+  if (normalizedMime.startsWith('audio/') || normalizedMime.startsWith('video/')) return TASK_UPLOAD_SCENE.VIDEO_CREATE;
+  const ext = path.extname(String(filePath || '')).toLowerCase();
+  if (AUDIO_VIDEO_EXTENSIONS.has(ext)) return TASK_UPLOAD_SCENE.VIDEO_CREATE;
+  return TASK_UPLOAD_SCENE.DEFAULT;
+}
+
+async function collectFileSpecs(kwargs = {}, defaultSceneType = null) {
   const specs = [];
   for (const file of parseListArg(kwargs.file)) specs.push({ file });
   for (const file of parseListArg(kwargs.files)) specs.push({ file });
@@ -2181,11 +2250,14 @@ async function collectFileSpecs(kwargs = {}, defaultSceneType = TASK_UPLOAD_SCEN
     }
   }
   return specs
-    .map((item) => ({
-      file: trimToNull(item.file ?? item.path ?? item.filePath),
-      sceneType: trimToNull(item.sceneType ?? kwargs.sceneType) ?? defaultSceneType,
-      projectNo: trimToNull(item.projectNo ?? kwargs.projectNo) ?? '',
-    }))
+    .map((item) => {
+      const file = trimToNull(item.file ?? item.path ?? item.filePath);
+      return {
+        file,
+        sceneType: trimToNull(item.sceneType ?? kwargs.sceneType) ?? defaultSceneType ?? defaultUploadSceneForFile(file),
+        projectNo: trimToNull(item.projectNo ?? kwargs.projectNo) ?? '',
+      };
+    })
     .filter((item) => item.file);
 }
 
@@ -2194,7 +2266,7 @@ function dryRunBackendPath(filePath, sceneType) {
 }
 
 export async function uploadFilesCommand(kwargs = {}) {
-  const specs = await collectFileSpecs(kwargs, trimToNull(kwargs.sceneType) ?? TASK_UPLOAD_SCENE.DEFAULT);
+  const specs = await collectFileSpecs(kwargs, trimToNull(kwargs.sceneType));
   if (!specs.length) throw argumentError('缺少上传文件', '传 --file <path> 或 --files a.png,b.mp4。');
   if (toBool(kwargs.dryRun)) {
     const files = [];
@@ -2224,7 +2296,7 @@ export async function uploadLocalFile(filePath, options = {}) {
     throw argumentError(`文件不存在：${filePath}`);
   }
   const buffer = await fs.readFile(inspected.filePath);
-  const sceneType = options.sceneType ?? TASK_UPLOAD_SCENE.DEFAULT;
+  const sceneType = options.sceneType ?? defaultUploadSceneForFile(inspected.filePath, inspected.mimeType);
   const groupId = crypto.randomUUID().replaceAll('-', '');
   const secret = await awbApi.fetchUploadSecret({
     sceneType,
@@ -3433,6 +3505,7 @@ function normalizeAssetGroup(item = {}) {
     groupId: item?.id ?? item?.groupId ?? item?.assetGroupsId ?? null,
     name: item?.name ?? item?.groupName ?? null,
     description: item?.description ?? null,
+    platform: item?.platform ?? null,
     projectName: item?.projectName ?? null,
   };
 }
@@ -3640,43 +3713,53 @@ export async function assetMatchActor(kwargs = {}) {
 }
 
 export async function assetGroupList(kwargs = {}) {
+  const platform = requireAssetPlatform(kwargs.platform);
   const payload = await awbApi.listAssetGroups({
     name: kwargs.name ?? '',
+    platform,
     pageNumber: toInt(kwargs.pageNumber, 1),
     pageSize: toInt(kwargs.pageSize, 20),
     ...(parseListArg(kwargs.groupIds).length ? { groupIds: parseListArg(kwargs.groupIds) } : {}),
   });
-  return { groups: extractAssetGroupRows(payload), raw: toBool(kwargs.includeRaw) ? payload : undefined };
+  return { platform, groups: extractAssetGroupRows(payload), raw: toBool(kwargs.includeRaw) ? payload : undefined };
 }
 
 export async function assetGroupGet(kwargs = {}) {
   const groupId = requireValue(kwargs, 'groupId', 'group-id');
-  const payload = await awbApi.getAssetGroup(groupId);
-  return payload && typeof payload === 'object' && !Array.isArray(payload)
-    ? normalizeAssetGroup(payload)
-    : extractAssetGroupRows(payload)[0] ?? { groupId };
+  const platform = requireAssetPlatform(kwargs.platform);
+  const payload = await awbApi.getAssetGroup(groupId, { platform });
+  if (payload && typeof payload === 'object' && !Array.isArray(payload)) {
+    const group = normalizeAssetGroup(payload);
+    return { ...group, platform: group.platform ?? platform };
+  }
+  return extractAssetGroupRows(payload)[0] ?? { groupId, platform };
 }
 
 export async function assetGroupCreate(kwargs = {}) {
   const name = requireValue(kwargs, 'name');
+  const platform = requireAssetPlatform(kwargs.platform);
   const body = {
     name,
     description: kwargs.description ?? '',
+    platform,
     projectName: kwargs.projectName ?? 'default',
   };
   if (toBool(kwargs.dryRun)) return { dryRun: true, action: 'create asset-group', request: body };
   ensureConfirmed(kwargs, '创建素材组是云端写入动作，需要确认', { action: 'create asset-group', body });
   const payload = await awbApi.createAssetGroup(body);
-  return { created: true, groupId: payload?.id ?? payload?.groupId ?? payload ?? null, name, projectName: body.projectName };
+  return { created: true, groupId: payload?.id ?? payload?.groupId ?? payload ?? null, name, platform, projectName: body.projectName };
 }
 
 export async function assetGroupUpdate(kwargs = {}) {
   const groupId = requireValue(kwargs, 'groupId', 'group-id');
-  const body = {};
+  const platform = requireAssetPlatform(kwargs.platform);
+  const body = { platform };
   if (kwargs.name != null) body.name = kwargs.name;
   if (kwargs.description != null) body.description = kwargs.description;
   if (kwargs.projectName != null) body.projectName = kwargs.projectName;
-  if (!Object.keys(body).length) throw argumentError('缺少素材组更新字段', '至少传 --name、--description 或 --project-name。');
+  if (!['name', 'description', 'projectName'].some((key) => Object.prototype.hasOwnProperty.call(body, key))) {
+    throw argumentError('缺少素材组更新字段', '至少传 --name、--description 或 --project-name；--platform 只用于定位平台资产组。');
+  }
   if (toBool(kwargs.dryRun)) return { dryRun: true, action: 'create asset-group-update', groupId, request: body };
   ensureConfirmed(kwargs, '更新素材组是云端写入动作，需要确认', { action: 'create asset-group-update', groupId, body });
   await awbApi.updateAssetGroup(groupId, body);
@@ -3692,6 +3775,7 @@ function extractAssetId(payload) {
 export async function assetRegister(kwargs = {}) {
   const groupId = requireValue(kwargs, 'groupId', 'group-id');
   const name = requireValue(kwargs, 'name');
+  const platform = requireAssetPlatform(kwargs.platform);
   const localFile = trimToNull(kwargs.file);
   const assetPath = trimToNull(kwargs.backendPath) ?? normalizeCosAssetPath(kwargs.url);
   if (!localFile && !assetPath) throw argumentError('缺少素材路径', '传 --file、--backend-path 或 --url。');
@@ -3701,20 +3785,20 @@ export async function assetRegister(kwargs = {}) {
       action: 'create asset',
       request: {
         assetGroupsId: groupId,
-        url: localFile ? normalizeCosAssetPath(dryRunBackendPath(localFile, TASK_UPLOAD_SCENE.SUBJECT)) : assetPath,
+        url: localFile ? normalizeCosAssetPath(dryRunBackendPath(localFile, TASK_UPLOAD_SCENE.ASSET_REVIEW)) : assetPath,
         name,
-        ...(kwargs.platform ? { platform: kwargs.platform } : {}),
+        platform,
       },
       localFile: localFile ? await inspectLocalFile(localFile) : null,
     };
   }
   ensureConfirmed(kwargs, '注册素材是云端写入动作，需要确认', { action: 'create asset', groupId, name });
-  const uploaded = localFile ? await uploadLocalFile(localFile, { sceneType: TASK_UPLOAD_SCENE.SUBJECT }) : null;
+  const uploaded = localFile ? await uploadLocalFile(localFile, { sceneType: TASK_UPLOAD_SCENE.ASSET_REVIEW }) : null;
   const body = {
     assetGroupsId: groupId,
     url: normalizeCosAssetPath(uploaded?.backendPath ?? assetPath),
     name,
-    ...(kwargs.platform ? { platform: kwargs.platform } : {}),
+    platform,
   };
   const payload = await awbApi.registerAsset(body);
   return {
@@ -3722,6 +3806,7 @@ export async function assetRegister(kwargs = {}) {
     assetId: extractAssetId(payload),
     groupId,
     name,
+    platform,
     assetPath: body.url,
     ...(uploaded ? { upload: uploaded } : {}),
   };
@@ -4008,37 +4093,32 @@ function tagListFromArg(value) {
     .filter((item) => item.tagId);
 }
 
-function normalizeSubjectCreateModelCode(value) {
-  const text = trimToNull(value);
-  if (!text) return null;
-  const normalized = text.toLowerCase();
-  if (normalized === 'tx' || normalized === 'vidu') return normalized;
-  return null;
-}
+const SUBJECT_MODEL_CODE_HINT = '传 --model-code tx|vidu；KeLing / 可灵主体明确传 tx，Vidu 主体明确传 vidu。';
 
 function resolveSubjectCreateModelCode(kwargs = {}) {
   const explicitModelCode = trimToNull(kwargs.modelCode ?? kwargs.model_code);
-  const modelCode = normalizeSubjectCreateModelCode(explicitModelCode);
-  if (modelCode) return { modelCode };
+  if (explicitModelCode === 'tx' || explicitModelCode === 'vidu') {
+    return { modelCode: explicitModelCode };
+  }
   if (explicitModelCode) {
     throw argumentError(
       `主体 modelCode 不支持：${explicitModelCode}`,
-      '只支持 --model-code tx|vidu；KeLing / 可灵用 tx，Vidu 用 vidu。',
+      SUBJECT_MODEL_CODE_HINT,
     );
   }
 
   throw argumentError(
     '缺少主体 modelCode',
-    '传 --model-code tx|vidu；KeLing / 可灵用 tx，Vidu 用 vidu。',
+    SUBJECT_MODEL_CODE_HINT,
   );
 }
 
-function buildSubjectCreateBody(kwargs, specs, assets) {
+function buildSubjectCreateBody(kwargs, specs, assets, modelCodeResolution = resolveSubjectCreateModelCode(kwargs)) {
   const name = requireValue(kwargs, 'name');
   const description = trimToNull(kwargs.description ?? kwargs.elementDescription) ?? name;
   const primary = assets.find((item) => item.isPrimary);
   const referAssets = assets.filter((item) => item.assetPath);
-  const { modelCode } = resolveSubjectCreateModelCode(kwargs);
+  const { modelCode } = modelCodeResolution;
   return compactRecord({
     reqTaskId: trimToNull(kwargs.reqTaskId),
     modelCode,
@@ -4117,10 +4197,7 @@ export async function subjectPublish(kwargs = {}) {
       dryRun: true,
       action: 'create subject',
       name,
-      resolvedModelCode: modelCodeResolution.modelCode,
-      resolvedFrom: modelCodeResolution.resolvedFrom,
-      resolvedFromValue: modelCodeResolution.resolvedFromValue,
-      request: buildSubjectCreateBody(kwargs, specs, assets),
+      request: buildSubjectCreateBody(kwargs, specs, assets, modelCodeResolution),
       assets,
       localFiles: await inspectLocalFiles(specs.map((item) => item.file).filter(Boolean)),
       nextRefSubject: `${name}=<externalId>`,
@@ -4140,7 +4217,7 @@ export async function subjectPublish(kwargs = {}) {
       ...(uploaded ? { upload: uploaded } : {}),
     });
   }
-  const body = buildSubjectCreateBody(kwargs, specs, assets);
+  const body = buildSubjectCreateBody(kwargs, specs, assets, modelCodeResolution);
   const payload = await awbApi.createElement(body);
   const elementId = extractCreatedElementId(payload);
   if (!elementId) throw new LingjingAwbCliError('主体创建完成但未拿到 elementId', { type: 'api_error', exitCode: 1, details: payload });
@@ -4229,14 +4306,14 @@ export async function subtitleRemove(kwargs = {}) {
   });
   await appendTaskRecord(kwargs, {
     taskId: result.taskId,
-    taskType: 'VIDEO_GROUP',
+    taskType: 'VIDEO_SUBTITLE_REMOVAL',
     projectGroupNo: built.projectGroupNo,
     promptSummary: `去字幕 sourceTaskId=${built.sourceTaskId}`,
   });
   return {
     ...result,
     nextCommand: result.taskId
-      ? `lj-awb task wait --task-id ${result.taskId} --task-type VIDEO_GROUP${built.projectGroupNo ? ` --project-group-no ${built.projectGroupNo}` : ''} -f json`
+      ? `lj-awb task video-subtitle-status --task-id ${result.taskId}${built.projectGroupNo ? ` --project-group-no ${built.projectGroupNo}` : ''} -f json`
       : null,
   };
 }
@@ -4270,6 +4347,6 @@ export async function subtitleStatus(kwargs = {}) {
   return taskStatus({
     ...kwargs,
     taskId,
-    taskType: 'VIDEO_GROUP',
+    taskType: 'VIDEO_SUBTITLE_REMOVAL',
   });
 }

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

@@ -217,6 +217,33 @@ const VIRTUAL_COMMANDS = [
 ];
 
 const RENAMED_COMMAND_HINTS = {
+  image: 'create image',
+  'image fee': 'create image-fee',
+  'image create': 'create image',
+  'image create-batch': 'create image-batch',
+  'image status': 'task image-status',
+  video: 'create video',
+  'video fee': 'create video-fee',
+  'video create': 'create video',
+  'video create-batch': 'create video-batch',
+  'video status': 'task video-status',
+  'video subtitle-remove': 'create video-subtitle-removal',
+  'video subtitle-status': 'task video-subtitle-status',
+  asset: 'create asset',
+  'asset match-actor': 'create asset-match-actor',
+  'asset groups': 'create asset-groups',
+  'asset group': 'create asset-group-get',
+  'asset group-create': 'create asset-group',
+  'asset group-update': 'create asset-group-update',
+  'asset register': 'create asset',
+  subject: 'create subject',
+  'subject list': 'create subject-list',
+  'subject publish': 'create subject',
+  'subject wait': 'create subject-wait',
+  'subject publish-batch': 'create subject-batch',
+  'subject voice list': 'create subject-voice-list',
+  'subject voice create': 'create subject-voice',
+  'subject voice wait': 'create subject-voice-wait',
   'workspace me': 'account info',
   'workspace teams': 'account teams',
   'workspace team-select': 'account switch-team',
@@ -367,6 +394,7 @@ const GROUP_EXAMPLES = {
   model: [
     'lj-awb model image-models --model Banana',
     'lj-awb model video-models --model Seedance',
+    'lj-awb model asset-review-models --platform JIMENG',
     'lj-awb model input-guide',
     'lj-awb model options --model-group-code <code>',
     'lj-awb model create-spec --model-group-code <code>',
@@ -381,8 +409,8 @@ const GROUP_EXAMPLES = {
     'lj-awb create video-fee --model-group-code <code> --prompt "雨夜奔跑" --duration 5',
     'lj-awb create subject --model-code tx --name 女主 --resource primary:./three-view.png --dry-run',
     'lj-awb create subject-wait --element-id <elementId> --wait-seconds 300',
-    'lj-awb create asset --group-id <id> --file ./actor.png --name "女主正面" --dry-run',
-    'lj-awb create asset-groups --name "女主"',
+    'lj-awb create asset --group-id <id> --platform JIMENG --file ./actor.png --name "女主正面" --dry-run',
+    'lj-awb create asset-groups --platform JIMENG --name "女主"',
   ],
   task: [
     'lj-awb task list --task-type IMAGE_CREATE --project-group-no <no>',
@@ -417,10 +445,11 @@ const COMMAND_REQUIRED_OPTIONS = {
   'task video-subtitle-status': ['taskId'],
   'task wait': ['taskId', 'taskType'],
   'create asset-match-actor': ['description'],
-  'create asset-group-get': ['groupId'],
-  'create asset-group': ['name'],
-  'create asset-group-update': ['groupId'],
-  'create asset': ['groupId', 'name'],
+  'create asset-groups': ['platform'],
+  'create asset-group-get': ['groupId', 'platform'],
+  'create asset-group': ['name', 'platform'],
+  'create asset-group-update': ['groupId', 'platform'],
+  'create asset': ['groupId', 'name', 'platform'],
   'artifact script row': ['rowKind', 'entityKey'],
   'artifact script children': ['parentKey'],
   'artifact script delete-row': ['rowKind', 'entityKey'],
@@ -595,6 +624,7 @@ const OUTPUT_KIND_BY_COMMAND = {
   'credits usage': 'credits_usage',
   'model image-models': 'model_list',
   'model video-models': 'model_list',
+  'model asset-review-models': 'asset_review_model_list',
   'model options': 'model_options',
   'model create-spec': 'model_create_spec',
   'model input-guide': 'model_input_guide',
@@ -687,9 +717,9 @@ const PREFLIGHTS_BY_COMMAND = {
   'create subject': ['doctor --verify', 'create subject --model-code tx|vidu --dry-run'],
   'create subject-batch': ['doctor --verify', 'prepare JSONL input with modelCode', 'create subject-batch --dry-run'],
   'create video-subtitle-removal': ['doctor --verify', 'create video-subtitle-removal --source-task-id <videoTaskId> --dry-run'],
-  'create asset-group': ['create asset-group --dry-run'],
-  'create asset-group-update': ['create asset-group-update --dry-run'],
-  'create asset': ['create asset --dry-run'],
+  'create asset-group': ['model asset-review-models', 'create asset-group --platform <platform> --dry-run'],
+  'create asset-group-update': ['create asset-group-update --platform <platform> --dry-run'],
+  'create asset': ['model asset-review-models', 'create asset --platform <platform> --dry-run'],
   'upload files': ['upload files --dry-run'],
 };
 
@@ -803,6 +833,7 @@ function buildAgentContract() {
         'schema version / domains / commands',
         'auth / account / team / current projectGroup',
         'modelCandidates by taskKind + keyword',
+        'assetReviewModels by modelGroupCode / platform',
         'modelOptions / modelCreateSpec by modelGroupCode',
         'uploaded backendPath by local file path or remote URL',
         'taskId -> taskType / projectGroupNo / resultUrls / errorMessage',
@@ -817,6 +848,7 @@ function buildAgentContract() {
       'supportsDryRun=true 的写入 / 扣费命令先 dry-run，确认后 yes；不要把 dry-run 当参数探索工具反复跑。',
       '用户给出多条同模型同参数任务时优先 batch + task-record-file，不要单条循环 create。',
       '命令返回 nextCommand / nextRefSubject / nextVoiceArg 时优先复用返回值，不手拼等价命令。',
+      '素材加白平台先通过 model asset-review-models 或用户明确输入确定；create asset-* 必须显式传 --platform，不要依赖默认平台。',
       '旧根域 image / video / asset / subject 已移除；只使用 create / task / artifact 等 schema 暴露的 domain。',
     ],
     canonicalFields: {

package/skills/lj-awb/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: lj-awb
-version: 0.3.16
+version: 0.3.17
 description: "灵境 AWB CLI skill。使用 `lj-awb` 命令调用动漫平台 / AWB 云端能力，覆盖认证、项目组、积分、模型发现、上传、统一 create 创建域、任务查询、最终产物 artifact CRUD 与本地 JSON 导入。用户说生图、生视频、主体、音色、素材加白、去字幕、artifact 写入或查询时使用。正式生成、切换项目组、清空认证、artifact 写入等写入或扣费动作前必须确认。"
 metadata:
   requires:

package/skills/lj-awb/VERSION

@@ -1 +1 @@
-0.3.16
+0.3.17

package/skills/lj-awb/compat.json

@@ -1,6 +1,6 @@
 {
-  "skillVersion": "0.3.16",
-  "minCliVersion": "0.3.16",
+  "skillVersion": "0.3.17",
+  "minCliVersion": "0.3.17",
   "preferredCommand": "lj-awb",
-  "updatedAt": "2026-05-18"
+  "updatedAt": "2026-05-19"
 }

package/skills/lj-awb/modules/asset.md

@@ -1,18 +1,19 @@
 # Asset Module
 
-资产模块负责素材库的"分组管理 + 素材注册 + 候选匹配"，**专为 Seedance / BytePlus / 即梦系列生视频前的"加白 / 过审"流程服务**。可灵 / KeLing 和 Vidu 系列用 [`subject.md`](subject.md) 的 `create subject`，不走 asset。
+资产模块负责素材库的"分组管理 + 素材注册 + 候选匹配"，服务于生视频前需要平台素材加白 / 过审的流程。是否支持素材加白、支持哪个平台，以 `model asset-review-models` 返回为准；不要按模型名称硬编码推断。可灵 / KeLing 和 Vidu 的角色一致性通常走 [`subject.md`](subject.md) 的 `create subject`，不要把主体 `modelCode=tx|vidu` 和资产平台 `JIMENG|BYTEPLUS` 混用。
 
 ## 命令
 
 | 命令 | 用途 |
 |------|------|
-| `lj-awb create asset-groups --name "<keyword>"` | 查素材组（按名搜，避免重建已有的） |
-| `lj-awb create asset-group-get --group-id <id>` | 查素材组详情 + 成员 |
-| `lj-awb create asset-group --name "<name>" --dry-run` | 预览创建素材组 |
-| `lj-awb create asset-group --name "<name>" --yes` | 创建素材组（云端写入） |
-| `lj-awb create asset-group-update --group-id <id> --name "<name>" --yes` | 改素材组名 |
-| `lj-awb create asset --group-id <id> --url "material/assets/a.png" --name "女主正面" --yes` | 注册已上传素材 |
-| `lj-awb create asset --group-id <id> --file ./a.png --name "女主正面" --yes` | 先上传再注册（一步完成） |
+| `lj-awb model asset-review-models --model-group-code <code>` | 查该模型是否支持素材加白及支持的平台 |
+| `lj-awb create asset-groups --platform JIMENG --name "<keyword>"` | 按平台查素材组（按名搜，避免重建已有的） |
+| `lj-awb create asset-group-get --group-id <id> --platform JIMENG` | 按平台查素材组详情 + 成员 |
+| `lj-awb create asset-group --platform JIMENG --name "<name>" --dry-run` | 预览创建素材组 |
+| `lj-awb create asset-group --platform JIMENG --name "<name>" --yes` | 创建素材组（云端写入） |
+| `lj-awb create asset-group-update --group-id <id> --platform JIMENG --name "<name>" --yes` | 改指定平台素材组名 |
+| `lj-awb create asset --group-id <id> --platform JIMENG --url "asset-review/a.png" --name "女主正面" --yes` | 注册已上传素材 |
+| `lj-awb create asset --group-id <id> --platform JIMENG --file ./a.png --name "女主正面" --yes` | 先上传到 asset-review 场景再注册（一步完成） |
 | `lj-awb create asset-match-actor --description "..." --tags-json '[{"tagId":"o_102"}]'` | 候选匹配（角色画风 / 标签） |
 
 ## 什么时候用 match-actor
@@ -22,32 +23,38 @@
 ## 完整加白流程
 
 ```bash
-# 1. 找/建分组
-lj-awb create asset-groups --name "项目X-角色"
-lj-awb create asset-group --name "项目X-角色" --yes
+# 0. 确认模型是否支持素材加白，以及应使用哪个平台
+lj-awb model asset-review-models --model-group-code <videoModelGroupCode>
+
+# 1. 找/建分组；platform 必须来自上一步返回或用户明确指定
+lj-awb create asset-groups --platform JIMENG --name "项目X-角色"
+lj-awb create asset-group --platform JIMENG --name "项目X-角色" --yes
 
 # 2. 注册（本地文件版，自动上传）
-lj-awb create asset --group-id <id> --file ./hero.png --name "主角正面" --dry-run
-lj-awb create asset --group-id <id> --file ./hero.png --name "主角正面" --yes
+lj-awb create asset --group-id <id> --platform JIMENG --file ./hero.png --name "主角正面" --dry-run
+lj-awb create asset --group-id <id> --platform JIMENG --file ./hero.png --name "主角正面" --yes
 
 # 3. 等审核（create asset 返回 taskId 时）
 lj-awb task wait --task-id <id> --task-type ASSET_REGISTER --wait-seconds 180
 
 # 4. 终态后用于视频
-lj-awb create video --model-group-code <seedance-code> \
-  --resource image:reference=material/assets/hero.png \
+lj-awb create video --model-group-code <videoModelGroupCode> \
+  --resource image:reference:hero=asset:<assetId> \
   ...
 ```
 
 ## 规则
 
 - `create asset-group` / `create asset-group-update` / `create asset` 都是云端写入，**必须确认**后追加 `--yes`。
+- `create asset-*` 平台必须显式传 `--platform JIMENG|BYTEPLUS`；不要依赖默认平台，不要传中文名、小写名或供应商别名。
+- `model asset-review-models` 只做发现，不自动创建资产组或素材；不要把 `modelGroupCode` 塞进资产创建命令。
+- 不使用 `/assets/submissions` 这类隐式自动补组流程；资产组是否复用、是否新建由当前任务显式决定。
 - 主体 element（视频里的"同一个人"概念）优先走 `create subject`，不要把素材组 / 素材 ID 当 subjectId 用——两者对应平台不同业务实体。
-- `create asset --file` 在 `--dry-run` 阶段不会真上传，只预览 backendPath 推断结果。
+- `create asset --file` 在 `--dry-run` 阶段不会真上传，只预览 `asset-review/...` backendPath 推断结果。
 - 输出字段速查见 [`../references/output-fields.md`](../references/output-fields.md) 的"素材"小节。
 
 ## 下一步
 
-- 注册成功 → 把 `assetPath`（形如 `material/assets/a.png`）作为 `--resource image:reference=<path>` 传给 `create video`。
-- 想看 group 里有哪些素材 → `create asset-group-get --group-id <id>`。
+- 注册成功 → 优先按模型 create-spec / options 要求使用返回的 `assetId` 或 `assetPath`；需要 asset_id 时写 `--resource image:reference:<key>=asset:<assetId>`。
+- 想看 group 里有哪些素材 → `create asset-group-get --group-id <id> --platform <platform>`。
 - 长期复用同一角色（可灵）→ 改走 [`subject.md`](subject.md)。

package/skills/lj-awb/modules/create.md

@@ -34,3 +34,4 @@
 - 状态和等待仍在查询域：`task image-status` / `task video-status` / `task wait` / `create subject-wait` / `create subject-voice-wait` / `task video-subtitle-status`。
 - 所有 `create` 写入或扣费命令正式执行前必须先 `--dry-run`，用户确认后再 `--yes`。
 - 查询型 create 子命令（`subject-list`、`subject-voice-list`、`asset-groups`、`asset-group-get`、`asset-match-actor`）是为了避免重复创建；创建前优先查重。
+- `asset-groups` / `asset-group-get` / `asset-group` / `asset-group-update` / `asset` 都必须显式传 `--platform`；平台先由 `model asset-review-models` 或用户选择确定。

package/skills/lj-awb/modules/driver.md

@@ -20,6 +20,7 @@ Agent 在当前任务中记录这些值，后续直接复用：
 | `auth/account/team` | `doctor --verify`、`account info` | 登录 / 团队切换 |
 | `projectGroupNo` | `project current` 或用户指定 | 项目组切换 |
 | `modelCandidates` | `model image-models` / `model video-models` | 任务类型或关键词变化 |
+| `assetReviewModels` / `assetReviewPlatform` | `model asset-review-models` | `modelGroupCode` 或平台切换 |
 | `modelOptions` / `createSpec` | `model options` / `model create-spec` | `modelGroupCode` 变化 |
 | `backendPath` | `upload files` 或 create dry-run/yes 的 upload 输出 | 本地文件或远端 URL 变化 |
 | `task` | create 返回的 `taskId` / `nextCommand` / wait 结果 | 任务终态后只追加结果 |
@@ -73,8 +74,9 @@ CLI 当前能力分为：
 
 ### 素材库与加白
 
-- Seedance / BytePlus / 即梦等素材预审走 `create asset-*`；KeLing / Vidu 角色一致性走主体，不走 asset。
-- 创建素材组前先 `create asset-groups --name` 查重；有可用组就复用。
+- 素材预审是否可用先查 `model asset-review-models --model-group-code <code>`；不要按模型名硬编码判断，也不要把 `modelGroupCode` 传入资产创建命令。
+- `create asset-*` 必须显式传 `--platform JIMENG|BYTEPLUS`，平台来自 `model asset-review-models` 或用户明确选择；不要依赖 material 默认平台。
+- 创建素材组前先 `create asset-groups --platform <platform> --name` 查重；有可用组就复用。
 - `create asset --file` 会在正式阶段自动上传并注册；同一文件多任务复用时，先 `upload files` 缓存 `backendPath`。
 - 注册成功后优先使用 `assetPath`，不要重新上传同一文件。
 
@@ -103,4 +105,5 @@ CLI 当前能力分为：
 - 不要把 `--need-audio` 当音频输入；音频输入只能是 `audio:reference`。
 - 不要把主体 `elementId` 当 `externalId`。
 - 不要用单条 create 循环处理明显批量任务。
+- 不要调用 `/assets/submissions` 或其它自动补齐资产组的隐式接口；素材组和素材注册必须通过 CLI 显式步骤完成。
 - 不要直连 material / asset / 外部服务；统一走 `lj-awb`。

package/skills/lj-awb/modules/model.md

@@ -8,6 +8,7 @@
 |------|------|
 | `lj-awb model image-models --model "<keyword>"` | 查询生图候选模型 |
 | `lj-awb model video-models --model "<keyword>"` | 查询生视频候选模型 |
+| `lj-awb model asset-review-models --model-group-code <code>` | 查询支持素材加白的模型组与平台关系 |
 | `lj-awb model input-guide -f json` | 查看统一创建参数、resources 字段和素材绑定规则 |
 | `lj-awb model options --model-group-code <code> -f json` | 查看该模型支持的 CLI 参数、枚举值、默认值、素材约束和条件约束 |
 | `lj-awb model create-spec --model-group-code <code> -f json` | 查看该模型如何创建任务：输入模式、素材绑定规则、示例和前置步骤 |
@@ -80,6 +81,7 @@ Agent 读取这些字段：
 - `model options` 是参数和素材约束入口；`model create-spec` 是创建方式入口。判断用户需求能否满足，优先看 `create-spec.supportedIntents[]`；素材格式 / 数量 / 时长限制看 `options.resources[]`；参数 / 资源联动看 `options.constraints[]`（`effect=no_selectable_values` 表示触发后该目标参数没有可选枚举，不要追问或传入）。
 - `supportLastFrameOnly` 只表示模型是否支持「仅尾帧」输入；首尾帧过渡能力看 frames 资源的 `usage` 是否包含 `last_frame` 和数量约束。
 - 用户说「上传音频 / 使用音乐 / 配音 / 音频参考」是**素材输入**，先看 `options.resources[]` 有没有 `mediaType=AUDIO usage=reference`；**不要先去找 `needAudio`**（那是输出音效开关）。具体使用规则、`reference_key` / `<<<key>>>` 对齐和 `--need-audio` 不是音频入口等都见 [`create-contract.md`](create-contract.md) §素材组织 + §Prompt 组装原则。
+- 用户要走素材加白 / 素材库过审时，先跑 `model asset-review-models --model-group-code <code>` 判断该模型是否支持以及平台值；不要根据模型名称猜平台，也不要把 `modelGroupCode` 放进资产组或素材创建命令。
 - 关键参数选择、`fee` / `create --dry-run` 前的追问流程、`inputRequirement.visualInputRequired` 检查等创建前校验见 [`create-contract.md`](create-contract.md) §创建前校验。
 - 输出字段速查见 [`../references/output-fields.md`](../references/output-fields.md) 的"模型"小节。
 

package/skills/lj-awb/modules/subject.md

@@ -2,7 +2,7 @@
 
 主体模块用于创建 / 查询平台主体 element。视频主体参考应使用主体的 `externalId`，通过 `--resource subject:reference:<key>=asset:<externalId>` 传给视频创建命令。
 
-> **发布主体前必须传 `--model-code <tx|vidu>`**：KeLing / Kling / 可灵 → `tx`，Vidu → `vidu`。不传 → CLI 报 `argument_error: 缺少主体 modelCode`；放过去后端 `ElementCreateHandler` 也会按 `modelCode` 路由请求体（Vidu / KeLing 字段集不一样），空值在两端都会失败。如果用户没说目标平台，先追问"这个主体将来主要用在 KeLing / 可灵 还是 Vidu？"
+> **发布主体前必须传 `--model-code <tx|vidu>`**：KeLing / 可灵主体明确传 `tx`，Vidu 主体明确传 `vidu`。CLI 不接受 `keling`、`可灵`、`tencent`、`vidu-q` 等别名；不传或传错都会报 `argument_error`。如果用户没说目标平台，先追问"这个主体将来主要用在 KeLing / 可灵 还是 Vidu？"
 
 ## 命令
 
@@ -13,8 +13,8 @@
 | `lj-awb create subject-voice --name 女主音色 --file ./voice.mp3 --yes` | 创建主体音色并返回 voiceRecordId |
 | `lj-awb create subject-voice-wait --voice-record-id <voiceRecordId> --wait-seconds 300` | 等待音色 externalId 回填 |
 | `lj-awb create subject-voice-list --name "女主"` | 查询已创建音色 |
-| `lj-awb create subject --model-code tx --name 女主 --resource primary:./three-view.png --dry-run` | 预览 KeLing 主体创建，request.modelCode 自动为 `tx` |
-| `lj-awb create subject --model-code vidu --name 女主 --resource primary:./three-view.png --dry-run` | 预览 Vidu 主体创建，request.modelCode 自动为 `vidu` |
+| `lj-awb create subject --model-code tx --name 女主 --resource primary:./three-view.png --dry-run` | 预览 KeLing 主体创建，request.modelCode 为 `tx` |
+| `lj-awb create subject --model-code vidu --name 女主 --resource primary:./three-view.png --dry-run` | 预览 Vidu 主体创建，request.modelCode 为 `vidu` |
 | `lj-awb create subject --model-code tx --name 女主 --resource primary:./three-view.png --yes` | 创建主体并返回 elementId |
 | `lj-awb create subject-wait --element-id <elementId> --wait-seconds 300` | 等待 externalId 回填 |
 | `lj-awb create subject --model-code vidu --name 女主 --resource primary:material/assets/a.png --yes` | 用已上传素材创建主体 |
@@ -24,7 +24,7 @@
 ## 规则
 
 - 发布前确认主体名称、主参考图、可选正脸 / 侧面 / 背面图、项目名。
-- 必须传 `--model-code tx|vidu`：KeLing / Kling / 可灵 → `tx`，Vidu → `vidu`。
+- 必须传 `--model-code tx|vidu`：KeLing / 可灵用 `tx`，Vidu 用 `vidu`。不要传平台名别名。
 - 如主体需要参考音色，先用 `create subject-voice --file <audio>` 创建音色，再 `create subject-voice-wait` 拿到 `externalId`，最后把它作为 `create subject --voice-id <externalId>`。
 - `create subject-voice` 的音色来源三选一：`--file` 本地音频、`--voice-url` / `--audio-url` 已上传 material 音频路径、`--video-id` 已有视频 ID。
 - 参考图统一通过 `--resource <slot>:<file|url>` 传入，slot ∈ `primary | three-view | face | side | back`。无 `primary` 时 `three-view` 自动升为主图；本地路径（`./` 或绝对路径）会自动上传，含 `://` 或 `material/` 前缀的视为已上传 URL。

package/skills/lj-awb/modules/task-manual.md

@@ -172,7 +172,7 @@ lj-awb create video \
 判断要点：
 
 - `create subject-wait` 成功后优先使用返回的 `nextRefSubject`。
-- `--model-code` 只接受 `tx|vidu`；KeLing / 可灵用 `tx`，Vidu 用 `vidu`。它不是视频模型的 `modelGroupCode`。
+- `--model-code` 只接受 `tx|vidu`；KeLing / 可灵用 `tx`，Vidu 用 `vidu`。
 - `subject:reference:<key>=asset:<subjectId>` 必须放主体 ID；普通图片素材资产 ID 只能用于 `image:reference=asset:<assetId>` 等素材引用。
 - prompt 中出现 `<<<key>>>` 时必须有同名 reference 资源；不出现时不强制补。
 

package/skills/lj-awb/modules/upload.md

@@ -7,7 +7,8 @@
 | 命令 | 用途 |
 |------|------|
 | `lj-awb upload files --files ./a.png,./b.mp4 --dry-run` | 预览上传文件 |
-| `lj-awb upload files --file ./ref.png --scene-type material-video-create` | 上传单个参考素材 |
+| `lj-awb upload files --file ./ref.png` | 上传图片创建参考素材，默认 `material-image-draw` |
+| `lj-awb upload files --file ./first.png --scene-type material-video-create` | 上传生视频 / 主体复用素材 |
 | `lj-awb upload files --files-json ./files.json` | 按 JSON 清单上传 |
 
 ## 规则
@@ -16,17 +17,18 @@
 - 后续任务的 `source.value` 一律使用 `backendPath`（例如 `material/...` 或 `/material/...`），**不要使用回显的 `url` 字段**。`url` 只是用于人工预览，把完整 `https://*.myqcloud.com/...` 直接塞回任务请求会让请求体冗余，也会破坏请求一致性。
 - 对 Agent 来说，优先使用返回的结构化字段，不要从自然语言输出里猜 URL。
 - 生图 / 生视频命令传本地参考文件时，会在内部自动上传；只有需要复用素材时才单独调用 `upload files`。
+- 单独预上传时按下游任务选择 scene：未传 `--scene-type` 时，图片默认 `material-image-draw`，音频 / 视频默认 `material-video-create`；图片若要作为生视频首帧 / 尾帧 / 参考图或主体图复用，必须显式传 `--scene-type material-video-create`；只有明确走图片编辑入口时才传 `material-image-edit`。
 - 即使把平台 COS 完整 URL 当作 `source.value` 传入，CLI 会自动剥离 host 还原为 `backendPath`；但不要依赖该自愈，仍以传 `backendPath` 为准。
 - 输出字段速查见 [`../references/output-fields.md`](../references/output-fields.md) 的"文件上传"小节；上传失败（exit 30 / `upload_failed`）见 [`../references/error-codes.md`](../references/error-codes.md) 场景 6。
 
 ## 下一步
 
-拿到 `uploads[].backendPath`（形如 `material/...`）后立刻就近喂给下游命令，不要重复 upload：
+拿到 `files[].backendPath`（形如 `material/...`）后立刻就近喂给下游命令，不要重复 upload：
 
 - 生图参考图：`lj-awb create image ... --resource image:reference=material/...`
 - 生视频首帧 / 尾帧 / 参考图：`lj-awb create video ... --resource image:first_frame=material/...`
 - 视频参考音频：`lj-awb create video ... --resource audio:reference=material/...`
 - 主体发布参考图：`lj-awb create subject ... --resource primary:material/...`
-- 注册到素材库（长期复用）：`lj-awb create asset --group-id <id> --url material/... --name "..." --yes`
+- 注册到素材库（素材加白）：优先让 `lj-awb create asset --group-id <id> --platform <platform> --file ./a.png --name "..." --yes` 自动上传到 `asset-review` 场景；若已单独上传，使用 `--backend-path asset-review/...` 或 `--url asset-review/...`。
 
 > `create image` / `create video` / `create subject` 传 `--file` / 本地路径时**会自动 upload**——只有需要"先看 backendPath / 跨任务复用同一份素材"时才单独跑 `upload files`。

package/skills/lj-awb/modules/workflows.md

@@ -12,7 +12,7 @@
 - [批量任务](#批量任务) — `create-batch --concurrency`
 - [分镜流水线（分镜图 → 视频）](#分镜流水线分镜图--视频) — GPT Image 2 分镜 → 视频生成
 - [预上传后批量复用](#预上传后批量复用) — `upload files` 一次，多任务复用 `backendPath`
-- [素材库加白后生视频](#素材库加白后生视频) — Seedance / 即梦的 `create asset` → 视频
+- [素材库加白后生视频](#素材库加白后生视频) — `model asset-review-models` → `create asset` → 视频
 - [Artifact 流水线错误恢复](#artifact-流水线错误恢复) — `import-storyboard` / 批量写入失败的局部重试
 
 ## 通用启动流程
@@ -140,8 +140,8 @@ lj-awb task record-poll \
 1. 准备 `image.jsonl`，每行一个镜头的 `prompt` 和共用参考图（人物、场景）：
 
    ```json
-   {"prompt":"镜头1：徐然推开 502 户门，门缝透出暖光...","ratio":"9:16","quality":"2k","resources":[{"type":"image","usage":"reference","source":{"kind":"url","value":"material/image-edit/<人物参考>"}},{"type":"image","usage":"reference","source":{"kind":"url","value":"material/image-edit/<场景参考>"}}]}
-   {"prompt":"镜头2：徐然侧身贴墙，听门外脚步声...","ratio":"9:16","quality":"2k","resources":[{"type":"image","usage":"reference","source":{"kind":"url","value":"material/image-edit/<人物参考>"}}]}
+   {"prompt":"镜头1：徐然推开 502 户门，门缝透出暖光...","ratio":"9:16","quality":"2k","resources":[{"type":"image","usage":"reference","source":{"kind":"url","value":"material/image-draw/<人物参考>"}},{"type":"image","usage":"reference","source":{"kind":"url","value":"material/image-draw/<场景参考>"}}]}
+   {"prompt":"镜头2：徐然侧身贴墙，听门外脚步声...","ratio":"9:16","quality":"2k","resources":[{"type":"image","usage":"reference","source":{"kind":"url","value":"material/image-draw/<人物参考>"}}]}
    ```
 
 2. 批量生分镜图（GPT Image 2 通道，并行 4）：
@@ -167,8 +167,8 @@ lj-awb task record-poll \
 4. 把每条 `taskId` 的 `result` 图（COS 对象路径，**用 `backendPath` 形式**）作为视频任务的 `first_frame`，组装 `video.jsonl`：
 
    ```json
-   {"prompt":"镜头1 动起来：徐然缓慢推门，光线从门缝渐扩","duration":5,"ratio":"9:16","quality":"720","resources":[{"type":"image","usage":"first_frame","source":{"kind":"url","value":"material/image-edit/<镜头1结果>"}}]}
-   {"prompt":"镜头2 动起来：徐然贴墙呼吸起伏，听门外动静","duration":5,"ratio":"9:16","quality":"720","resources":[{"type":"image","usage":"first_frame","source":{"kind":"url","value":"material/image-edit/<镜头2结果>"}}]}
+   {"prompt":"镜头1 动起来：徐然缓慢推门，光线从门缝渐扩","duration":5,"ratio":"9:16","quality":"720","resources":[{"type":"image","usage":"first_frame","source":{"kind":"url","value":"material/image-draw/<镜头1结果>"}}]}
+   {"prompt":"镜头2 动起来：徐然贴墙呼吸起伏，听门外动静","duration":5,"ratio":"9:16","quality":"720","resources":[{"type":"image","usage":"first_frame","source":{"kind":"url","value":"material/image-draw/<镜头2结果>"}}]}
    ```
 
 5. 批量生视频（视频模型通道，并行 3）：
@@ -197,11 +197,10 @@ lj-awb task record-poll \
 ```bash
 lj-awb upload files \
   --files ./hero.png,./scene.png \
-  --scene-type material-video-create \
   -f json
 ```
 
-读取响应 `data.uploads[].backendPath`（形如 `material/...`），把这个值（**不是 `url` 字段**）写入下游：
+读取响应 `data.files[].backendPath`（形如 `material/...`），把这个值（**不是 `url` 字段**）写入下游。上面是图片创建参考图，默认 scene 是 `material-image-draw`；如果预上传后要作为视频首帧 / 尾帧 / 参考图或主体素材复用，命令必须显式加 `--scene-type material-video-create`。
 
 ```bash
 lj-awb create video-batch \
@@ -228,23 +227,28 @@ lj-awb create video-batch \
 
 ## 素材库加白后生视频
 
-适用：Seedance / BytePlus / 即梦系列视频模型，要求参考图先在素材库登记并完成"加白"才能用于生视频。可灵 / KeLing 和 Vidu 系列可走 [主体参考生成视频](#主体参考生成视频)，不走 asset。
+适用：`model asset-review-models` 返回支持素材加白的平台模型。不要按 Seedance / BytePlus / 即梦等名称硬编码判断；可灵 / KeLing 和 Vidu 的角色一致性通常走 [主体参考生成视频](#主体参考生成视频)，不走 asset。
 
 ```bash
-# 1. 找/建分组
-lj-awb create asset-groups --name "项目X-角色"
-lj-awb create asset-group --name "项目X-角色" --dry-run
-lj-awb create asset-group --name "项目X-角色" --yes
+# 0. 先确认该视频模型支持哪个素材加白平台
+lj-awb model asset-review-models --model-group-code <videoModelGroupCode>
+
+# 1. 找/建分组；platform 必须来自上一步返回或用户明确指定
+lj-awb create asset-groups --platform JIMENG --name "项目X-角色"
+lj-awb create asset-group --platform JIMENG --name "项目X-角色" --dry-run
+lj-awb create asset-group --platform JIMENG --name "项目X-角色" --yes
 
 # 2. 注册参考图（本地文件版，--file 在 --yes 阶段自动上传 + 注册一步完成）
 lj-awb create asset \
   --group-id <groupId> \
+  --platform JIMENG \
   --file ./hero.png \
   --name "主角正面" \
   --dry-run
 
 lj-awb create asset \
   --group-id <groupId> \
+  --platform JIMENG \
   --file ./hero.png \
   --name "主角正面" \
   --yes
@@ -255,24 +259,24 @@ lj-awb task wait \
   --task-type ASSET_REGISTER \
   --wait-seconds 180
 
-# 4. 加白成功后拿到的 assetPath 用于视频创建
+# 4. 加白成功后按模型资源要求使用 assetId 或 assetPath 创建视频
 lj-awb create video-fee \
-  --model-group-code <seedance-code> \
+  --model-group-code <videoModelGroupCode> \
   --prompt "<...>" \
-  --resource image:reference=material/assets/hero.png \
+  --resource image:reference:hero=asset:<assetId> \
   --project-group-no <projectGroupNo>
 
 lj-awb create video \
-  --model-group-code <seedance-code> \
+  --model-group-code <videoModelGroupCode> \
   --prompt "<...>" \
-  --resource image:reference=material/assets/hero.png \
+  --resource image:reference:hero=asset:<assetId> \
   --project-group-no <projectGroupNo> \
   --dry-run
 
 lj-awb create video \
-  --model-group-code <seedance-code> \
+  --model-group-code <videoModelGroupCode> \
   --prompt "<...>" \
-  --resource image:reference=material/assets/hero.png \
+  --resource image:reference:hero=asset:<assetId> \
   --project-group-no <projectGroupNo> \
   --yes
 ```
@@ -281,8 +285,9 @@ lj-awb create video \
 
 - 用户描述"我有这样一个角色，平台上有没有现成的"时，先跑 `create asset-match-actor --description ... --tags-json '...'`，命中合适候选就跳过 register。
 - 加白未终态时直接拿 `assetPath` 喂给视频，平台会拒；必须先 `task wait` 到 `taskStatus=success`。
-- 同一角色后续视频任务复用同一 `assetPath`，不要每次重新 register。
-- asset 系列只服务于 Seedance / BytePlus / 即梦，**不要**把 `assetPath` 当成可灵的 `subject:reference` 用，反之亦然。
+- 同一角色后续视频任务复用同一 `assetId` / `assetPath`，不要每次重新 register。
+- asset 系列只服务于素材加白；**不要**把素材 `assetId` / `assetPath` 当成可灵的 `subject:reference` 用，反之亦然。
+- 不要调用隐式 submissions 自动补组；素材组查重、创建、素材注册都用显式 CLI 步骤。
 
 ## Artifact 流水线错误恢复
 

package/skills/lj-awb/references/output-fields.md

@@ -47,7 +47,7 @@
 
 | outputKind | 命令 | 必报给用户 | agent 内部用 | 可丢弃 |
 |------------|------|-----------|--------------|--------|
-| `upload_result` | `upload files` | 上传文件数、`uploads[].backendPath` | `backendPath`（喂给 `--resource <type>:<usage>=<backendPath>`） | `uploads[].url`、mimeType |
+| `upload_result` | `upload files` | 上传文件数、`files[].backendPath` | `backendPath`（喂给 `--resource <type>:<usage>=<backendPath>`） | `files[].url`、mimeType |
 
 ## 生图 / 生视频
 
@@ -89,11 +89,12 @@
 
 | outputKind | 命令 | 必报给用户 | agent 内部用 | 可丢弃 |
 |------------|------|-----------|--------------|--------|
+| `asset_review_model_list` | `model asset-review-models` | `modelGroupCode`、`platform` | `platform`（后续 create asset-* 必填） | — |
 | `asset_match_list` | `create asset-match-actor` | 候选列表（名称 + 评分） | `assetId/groupId` | — |
-| `asset_group_list` | `create asset-groups` | `count` + 组名 | `groupId`（下游 register 必填） | — |
-| `asset_group_detail` | `create asset-group-get` | 组名、成员数 | `groupId` | — |
-| `asset_group_write_result` | `create asset-group / group-update` | `created/updated`、`groupId` | — | — |
-| `asset_register_result` | `create asset` | `registered`、`assetId`、`assetPath` | `assetId`（下游引用） | upload 嵌套 |
+| `asset_group_list` | `create asset-groups` | `platform`、`count` + 组名 | `groupId`（下游 register 必填） | — |
+| `asset_group_detail` | `create asset-group-get` | `platform`、组名、成员数 | `groupId` | — |
+| `asset_group_write_result` | `create asset-group / group-update` | `created/updated`、`groupId`、`platform` | — | — |
+| `asset_register_result` | `create asset` | `registered`、`assetId`、`assetPath`、`platform` | `assetId`（下游引用） | upload 嵌套 |
 
 ## Artifact（产物 CRUD）