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

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

@@ -24,6 +24,7 @@ const OPTION_SYNONYMS = {
   threads: ['concurrency'],
   output: ['format'],
   json: ['format'],
+  keyword: ['model'],
   input: ['inputFile'],
   in: ['inputFile'],
   dry: ['dryRun'],
@@ -60,6 +61,16 @@ function suggestSimilarOptions(unknownKey, allowedKeys) {
   for (const syn of synonyms) {
     if (allowedKeys.includes(syn)) record(syn, -1);
   }
+  if (unknownKey.length === 1) {
+    const ch = unknownKey.toLowerCase();
+    for (const allowed of allowedKeys) {
+      if (allowed.toLowerCase().startsWith(ch)) record(allowed, 1);
+    }
+    return [...scored.entries()]
+      .sort((x, y) => x[1] - y[1])
+      .slice(0, 3)
+      .map(([key]) => formatOptionName(key));
+  }
   for (const allowed of allowedKeys) {
     const a = unknownKey.toLowerCase();
     const b = allowed.toLowerCase();
@@ -153,6 +164,7 @@ function assignKwarg(kwargs, key, value) {
 function parseArgv(argv) {
   const commandParts = [];
   const kwargs = {};
+  const kwargRawFlags = {};
   let format = 'text';
 
   for (let index = 0; index < argv.length; index += 1) {
@@ -182,10 +194,27 @@ function parseArgv(argv) {
       }
       continue;
     }
+    if (token.length > 1 && token.startsWith('-') && /^-[A-Za-z]/.test(token)) {
+      const raw = token.slice(1);
+      const eqIndex = raw.indexOf('=');
+      const keyPart = eqIndex >= 0 ? raw.slice(0, eqIndex) : raw;
+      const inlineValue = eqIndex >= 0 ? raw.slice(eqIndex + 1) : undefined;
+      const key = normalizeKey(keyPart);
+      if (!(key in kwargRawFlags)) kwargRawFlags[key] = token;
+      if (inlineValue !== undefined) {
+        assignKwarg(kwargs, key, inlineValue);
+      } else if (argv[index + 1] && !argv[index + 1].startsWith('-')) {
+        assignKwarg(kwargs, key, argv[index + 1]);
+        index += 1;
+      } else {
+        assignKwarg(kwargs, key, true);
+      }
+      continue;
+    }
     commandParts.push(token);
   }
 
-  return { commandName: commandParts.join(' '), kwargs, format };
+  return { commandName: commandParts.join(' '), kwargs, kwargRawFlags, format };
 }
 
 async function readVersion() {
@@ -217,6 +246,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 +423,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 +438,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 +474,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 +653,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 +746,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'],
 };
 
@@ -782,6 +841,23 @@ function buildCommandWorkflow(command) {
   if (command.name === 'create asset') {
     next.push('读取 data.assetPath', '若后端返回审核 taskId，再运行 task wait --task-type ASSET_REGISTER');
   }
+  if (command.name === 'model image-models' || command.name === 'model video-models') {
+    next.push('读取 data.models[] 得到全部候选；用户给了模型口语名时保留同族全部候选，不只取第一个');
+    next.push('对每个候选运行 model options --model-group-code <modelGroupCode> 查看真实参数和素材约束');
+    next.push('先向用户展示候选模型 + 参数取值 + 资源能力，再推荐模型或进入 fee/dry-run');
+  }
+  if (command.name === 'model asset-review-models') {
+    next.push('读取 data.models[].platform', '用 create asset-groups --platform <platform> 查重或创建素材组');
+  }
+  if (command.name === 'model options') {
+    next.push('读取 params/resources/constraints 确认参数与素材约束', '运行 model create-spec --model-group-code <code> 查看创建写法和示例');
+  }
+  if (command.name === 'model create-spec') {
+    next.push('按 examples / supportedIntents 组装命令', '用户确认关键参数后先运行 create image-fee 或 create video-fee，再 dry-run');
+  }
+  if (command.name === 'model input-guide') {
+    next.push('运行 model image-models 或 model video-models 选择模型', '选定模型后运行 model options --model-group-code <code>');
+  }
   if (['create image-batch', 'create video-batch', 'create subject-batch'].includes(command.name)) {
     next.push('读取每项 status / taskId / error', '使用 task record-poll 或对应 wait 命令恢复批量结果');
   }
@@ -803,6 +879,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',
@@ -813,10 +890,12 @@ function buildAgentContract() {
       invalidation: '用户切换账号、团队、项目组、模型、素材、prompt 或关键参数后，只刷新受影响的缓存；不要重复跑未变化的 model options / create-spec / fee。',
     },
     workflowPolicy: [
+      '模型口语名命中后必须先展示候选模型、真实参数取值和资源能力；没有完成用户可见候选清单前，不得代选默认模型 / 参数，也不得进入 fee 或 dry-run。',
       '模型探索阶段只读 model list / options / create-spec；fee 只在用户确认关键参数后跑一次。',
       '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: {
@@ -854,6 +933,12 @@ function buildAgentContract() {
         },
       ],
     },
+    modelCandidatePresentation: {
+      purpose: '把 model image-models / video-models 与每个候选的 model options 转成用户可见清单，避免 Agent 内部看完 options 后直接代选。',
+      trigger: '用户问有哪些模型、给出口语名、或模型列表返回候选时都触发；即使只有一个候选也要展示真实可选项。',
+      requiredVisibleFields: ['displayName', 'modelDesc', 'taskQueueNum', 'quality values/default', 'ratio values/default', 'duration or generateNum values/default', 'resource modes/media/usages', 'channel or fast/pro differences'],
+      blockedBeforePresentation: ['create image-fee', 'create video-fee', 'create image --dry-run', 'create video --dry-run', 'default model recommendation', 'default quality/ratio/duration choice'],
+    },
     modelOptions: {
       command: `${commandPrefix()} model options --model-group-code <code>`,
       jsonCommand: `${commandPrefix()} model options --model-group-code <code> -f json`,
@@ -1150,28 +1235,37 @@ function printCommandHelp(command) {
   process.stdout.write(`${lines.join('\n')}\n`);
 }
 
-function validateCommandOptions(command, kwargs) {
+function validateCommandOptions(command, kwargs, kwargRawFlags = {}) {
   const allowedKeys = (command.args || []).map((arg) => normalizeKey(arg.name));
   const allowed = new Set(allowedKeys);
   const unknown = Object.keys(kwargs).filter((key) => !allowed.has(key));
   if (!unknown.length) return;
+  const displayFlag = (key) => kwargRawFlags[key] || formatOptionName(key);
   const suggestions = {};
   for (const unk of unknown) {
     const matches = suggestSimilarOptions(unk, allowedKeys);
-    if (matches.length) suggestions[formatOptionName(unk)] = matches;
+    if (matches.length) suggestions[displayFlag(unk)] = matches;
   }
+  const usedShortForm = unknown.some((key) => {
+    const flag = kwargRawFlags[key];
+    return flag && flag.startsWith('-') && !flag.startsWith('--');
+  });
   const baseHint = `运行 ${commandPrefix()} ${command.name} -h 查看可用参数。`;
+  const shortHint = usedShortForm
+    ? `本 CLI 仅支持 -f / -h / -v 等少数短选项，业务参数请使用 --xxx 长形式。`
+    : '';
   const suggestionParts = Object.entries(suggestions).map(([opt, matches]) => `${opt} → ${matches.join(' / ')}`);
-  const hint = suggestionParts.length
-    ? `你是不是想用：${suggestionParts.join('；')}？否则 ${baseHint}`
-    : baseHint;
-  throw new LingjingAwbCliError(`未知参数：${unknown.map(formatOptionName).join(', ')}`, {
+  const hintParts = [];
+  if (suggestionParts.length) hintParts.push(`你是不是想用：${suggestionParts.join('；')}？`);
+  if (shortHint) hintParts.push(shortHint);
+  hintParts.push(baseHint);
+  throw new LingjingAwbCliError(`未知参数：${unknown.map(displayFlag).join(', ')}`, {
     type: 'unknown_option',
     exitCode: 2,
-    hint,
+    hint: hintParts.join(' '),
     details: {
       command: command.name,
-      unknownOptions: unknown.map(formatOptionName),
+      unknownOptions: unknown.map(displayFlag),
       ...(Object.keys(suggestions).length ? { suggestions } : {}),
     },
   });
@@ -1233,7 +1327,7 @@ export async function runStandaloneCli(argv = process.argv.slice(2)) {
     return;
   }
 
-  const { commandName: rawCommandName, kwargs, format } = parseArgv(argv);
+  const { commandName: rawCommandName, kwargs, kwargRawFlags, format } = parseArgv(argv);
   const commandName = resolveCommandName(rawCommandName, commands);
   const command = commands.find((item) => item.name === commandName);
   if (!command) {
@@ -1257,7 +1351,7 @@ export async function runStandaloneCli(argv = process.argv.slice(2)) {
 
   const startedAt = Date.now();
   try {
-    validateCommandOptions(command, kwargs);
+    validateCommandOptions(command, kwargs, kwargRawFlags);
     const data = command.virtual === 'schema'
       ? buildCommandSchema(commands, kwargs, version)
       : await command.func({ command }, kwargs);

package/skills/lj-awb/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: lj-awb
-version: 0.3.16
+version: 0.3.18
 description: "灵境 AWB CLI skill。使用 `lj-awb` 命令调用动漫平台 / AWB 云端能力，覆盖认证、项目组、积分、模型发现、上传、统一 create 创建域、任务查询、最终产物 artifact CRUD 与本地 JSON 导入。用户说生图、生视频、主体、音色、素材加白、去字幕、artifact 写入或查询时使用。正式生成、切换项目组、清空认证、artifact 写入等写入或扣费动作前必须确认。"
 metadata:
   requires:
@@ -43,6 +43,8 @@ LINGJING_AWB_CMD="$(bash "$(dirname "$0")/scripts/resolve-lj-awb-cmd.sh")"
 lj-awb schema -f json
 ```
 
+如果只是不确定某个命令参数，优先读精确契约，例如 `lj-awb schema --domain model --command video-models -f json`。schema 查询必须先返回，再组织业务命令；不要把 schema 查询和猜测命令放进同一批并行调用。
+
 如果用户已经给出完整只读命令，且该命令在本 skill 已知范围内，可以直接执行，不必为了形式补跑 schema。命令名、参数名、requiredOptions、safety、workflow.nextActions 都以 schema 为准。旧根域 `image` / `video` / `asset` / `subject` 不存在，不要尝试旧入口。
 
 ## 能力地图
@@ -84,7 +86,8 @@ lj-awb schema -f json
 - `fee` 是最终估价，不是参数探索工具。不要为多个 quality / duration / ratio / 渠道组合反复跑 fee。
 - 正式图片 / 视频任务要带 `--project-group-no`，除非命令 schema 没有该参数。
 - 命令返回 `nextCommand`、`nextRefSubject`、`nextVoiceArg` 时优先复用返回值，不手拼。
-- compact text 是默认输出；只有 schema、options、create-spec、完整嵌套结构或脚本解析时用 `-f json`。
+- compact text 是默认输出；复杂模型命令按 `section:` + 缩进 `key=value` 输出，先按分区读 `summary` / `params` / `resources` / `constraints` / `intents` / `examples` / `next`。只有 schema、options、create-spec、完整嵌套结构或脚本解析时用 `-f json`。
+- 模型口语名命中后必须过“候选展示门”：先把候选模型、真实参数取值和资源能力转成用户可见清单，再推荐或追问；不能只在内部读完 `model options` 就直接代选默认模型 / 参数。
 - 积分口径只把 `billingPointBalance` 当可扣积分余额；`projectBudgetBalance` 是项目组预算，不要混说。
 - 不直连 material / asset / 外部服务；所有业务能力统一通过 `lj-awb`。
 

package/skills/lj-awb/VERSION

@@ -1 +1 @@
-0.3.16
+0.3.18

package/skills/lj-awb/compat.json

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