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

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

@@ -1,7 +1,7 @@
 import fs from 'node:fs/promises';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { LingjingAwbCliError, createEnvelope, toBool, toInt } from './common.js';
+import { LingjingAwbCliError, createEnvelope, toBool, toInt, trimToNull } from './common.js';
 import { registerAwbCommands } from './commands.js';
 import { checkCliUpdate } from './update.js';
 import {
@@ -196,7 +196,13 @@ function buildOutputContext(command, kwargs = {}, data = {}) {
     confirmSet.autoConvert = true;
   }
   const isModelList = command.name === 'model image-models' || command.name === 'model video-models';
-  const modelListAll = isModelList && toBool(kwargs.all);
+  const hasModelFilter = isModelList && !toBool(kwargs.all) && Boolean(
+    trimToNull(kwargs.model) || trimToNull(kwargs.usage) || trimToNull(kwargs.provider)
+    || trimToNull(kwargs.inputMode) || trimToNull(kwargs.supports)
+    || trimToNull(kwargs.quality) || trimToNull(kwargs.ratio)
+    || trimToNull(kwargs.duration) || toBool(kwargs.needAudio),
+  );
+  const modelListAll = isModelList && (toBool(kwargs.all) || hasModelFilter);
   const modelListLimit = isModelList
     ? (modelListAll ? Number.POSITIVE_INFINITY : Math.max(1, toInt(kwargs.limit, 8)))
     : undefined;
@@ -344,7 +350,7 @@ const VIRTUAL_COMMANDS = [
     ].join('\n'),
     args: [
       { name: 'brief', description: '输出面向 Agent 的轻量能力摘要，不展开每个参数' },
-      { name: 'domain', valueName: 'name', description: '按命令域过滤，如 create / task / artifact / system' },
+      { name: 'domain', valueName: 'name', description: '按命令域过滤，如 create / task / system' },
       { name: 'command', valueName: 'name', description: '按子命令过滤，如 image / video / wait / doctor' },
     ],
   },
@@ -386,7 +392,8 @@ const RENAMED_COMMAND_HINTS = {
   'workspace team-select': 'account switch-team',
   'workspace project-groups': 'project list',
   'workspace project-group-current': 'project current',
-  'workspace project-group-select': 'project use',
+  'workspace project-group-select': 'project switch',
+  'project use': 'project switch',
   'workspace project-group-users': 'project users',
   'workspace project-group-create': 'project create',
   'workspace project-group-update': 'project update',
@@ -464,40 +471,11 @@ const GROUP_DESCRIPTIONS = {
   create: '创建：统一提交图片、视频、主体、音色、素材和视频去字幕任务',
   upload: '上传：把本地文件上传为平台可访问素材',
   task: '任务：任务列表、等待和本地任务台账',
-  artifact: '最终产物：剧本、资产、视频、剪辑 CRUD 与本地 JSON 导入',
 };
 
-const SUBGROUP_DESCRIPTIONS = {
-  artifact: {
-    script: '剧本：document / asset / state / speaker / episode / scene / action 行 CRUD 与 script.json 批量导入',
-    asset: '资产：角色 / 道具 / 场景 及其状态 CRUD，actors/props/locations JSON 批量导入',
-    video: '视频：集 / 场 / clip 三级最终产物 CRUD 与 storyboard 批量导入',
-    clip: '剪辑：按集组织的剪辑宽表 CRUD 与状态更新',
-  },
-};
+const SUBGROUP_DESCRIPTIONS = {};
 
-const SUBGROUP_EXAMPLES = {
-  'artifact script': [
-    'lj-awb artifact script import --project-id <projectId> --input-file 1_script/output/script.json --dry-run',
-    'lj-awb artifact script get --project-id <projectId>',
-    'lj-awb artifact script rows --project-id <projectId> --row-kind scene',
-  ],
-  'artifact asset': [
-    'lj-awb artifact asset import --project-id <projectId> --input-dir 2_asset/output --dry-run',
-    'lj-awb artifact asset actors --project-id <projectId> --include-states true',
-    'lj-awb artifact asset props --project-id <projectId>',
-  ],
-  'artifact video': [
-    'lj-awb artifact video import-storyboard --project-id <projectId> --input-file 3_footage/output/ep001/ep001_storyboard.json --dry-run',
-    'lj-awb artifact video episodes --project-id <projectId>',
-    'lj-awb artifact video clips --project-id <projectId> --episode-id ep_001 --scene-id scn_001',
-  ],
-  'artifact clip': [
-    'lj-awb artifact clip upsert-episode --project-id <projectId> --input-file 4_clip/output/ep001_clip_output.json --dry-run',
-    'lj-awb artifact clip episodes --project-id <projectId>',
-    'lj-awb artifact clip episode-by-id --project-id <projectId> --episode-id ep_001',
-  ],
-};
+const SUBGROUP_EXAMPLES = {};
 
 const GROUP_EXAMPLES = {
   system: [
@@ -528,7 +506,7 @@ const GROUP_EXAMPLES = {
   project: [
     'lj-awb project list',
     'lj-awb project current',
-    'lj-awb project use --project-group-no <no> --yes',
+    'lj-awb project switch --project-group-no <no> --yes',
     'lj-awb project create --name "CLI 测试项目" --point 1000 --yes',
   ],
   credits: [
@@ -569,12 +547,6 @@ const GROUP_EXAMPLES = {
     'lj-awb task wait --task-id <id> --task-type IMAGE_CREATE --wait-seconds 180',
     'lj-awb task records --task-record-file .awb/tasks.jsonl',
   ],
-  artifact: [
-    'lj-awb artifact script import --project-id <projectId> --input-file 1_script/output/script.json --dry-run',
-    'lj-awb artifact asset import --project-id <projectId> --input-dir 2_asset/output --dry-run',
-    'lj-awb artifact video import-storyboard --project-id <projectId> --input-file 3_footage/output/ep001/ep001_storyboard.json --dry-run',
-    'lj-awb artifact clip upsert-episode --project-id <projectId> --input-file 4_clip/output/ep001_clip_output.json --dry-run',
-  ],
 };
 
 const COMMAND_REQUIRED_OPTIONS = {
@@ -602,37 +574,6 @@ const COMMAND_REQUIRED_OPTIONS = {
   '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'],
-  'artifact asset actor': ['actorKey'],
-  'artifact asset prop': ['propKey'],
-  'artifact asset location': ['locationKey'],
-  'artifact asset upsert-actor-state': ['actorKey'],
-  'artifact asset upsert-prop-state': ['propKey'],
-  'artifact asset upsert-location-state': ['locationKey'],
-  'artifact asset delete-actor': ['actorKey'],
-  'artifact asset delete-prop': ['propKey'],
-  'artifact asset delete-location': ['locationKey'],
-  'artifact asset delete-actor-state': ['actorKey', 'stateKey'],
-  'artifact asset delete-prop-state': ['propKey', 'stateKey'],
-  'artifact asset delete-location-state': ['locationKey', 'stateKey'],
-  'artifact video episode': ['episodeId'],
-  'artifact video scenes': ['episodeId'],
-  'artifact video scene': ['episodeId', 'sceneId'],
-  'artifact video clips': ['episodeId', 'sceneId'],
-  'artifact video clip': ['episodeId', 'sceneId', 'clipId'],
-  'artifact video upsert-scene': ['episodeId'],
-  'artifact video upsert-clip': ['episodeId', 'sceneId'],
-  'artifact video update-clip-urls': ['episodeId', 'sceneId', 'clipId', 'videoUrlsJson'],
-  'artifact video delete-episode': ['episodeId'],
-  'artifact video delete-scene': ['episodeId', 'sceneId'],
-  'artifact video delete-clip': ['episodeId', 'sceneId', 'clipId'],
-  'artifact video import-storyboard': ['inputFile'],
-  'artifact clip episode': ['videoEpisodeId'],
-  'artifact clip episode-by-id': ['episodeId'],
-  'artifact clip update-status': ['videoEpisodeId', 'status'],
-  'artifact clip delete-episode': ['videoEpisodeId'],
   'create subject': ['name'],
   'create subject-wait': ['elementId'],
   'create subject-voice': ['name'],
@@ -649,61 +590,16 @@ const COMMAND_REQUIRED_ANY_OPTIONS = {
   'create video-subtitle-removal': [['sourceTaskId']],
   'create asset-group-update': [['name', 'description', 'projectName']],
   'create asset': [['file', 'url', 'backendPath']],
-  'artifact script upsert-row': [['bodyJson', 'inputFile']],
-  'artifact asset upsert-actor': [['bodyJson', 'inputFile']],
-  'artifact asset upsert-prop': [['bodyJson', 'inputFile']],
-  'artifact asset upsert-location': [['bodyJson', 'inputFile']],
-  'artifact asset upsert-actor-state': [['bodyJson', 'inputFile']],
-  'artifact asset upsert-prop-state': [['bodyJson', 'inputFile']],
-  'artifact asset upsert-location-state': [['bodyJson', 'inputFile']],
-  'artifact video upsert-episode': [['bodyJson', 'inputFile']],
-  'artifact video upsert-scene': [['bodyJson', 'inputFile']],
-  'artifact video upsert-clip': [['bodyJson', 'inputFile']],
-  'artifact clip upsert-episode': [['bodyJson', 'inputFile']],
-  'artifact clip upsert-batch': [['bodyJson', 'inputFile']],
   'create subject': [['resource'], ['modelCode']],
   'create subject-batch': [['modelCode']],
   'create subject-voice': [['file', 'voiceUrl', 'audioUrl', 'videoId']],
   'create subject-voice-wait': [['voiceRecordId', 'reqTaskId']],
 };
 
-const ARTIFACT_WRITE_COMMANDS = [
-  'artifact script upsert-row',
-  'artifact script delete-row',
-  'artifact script import',
-  'artifact asset upsert-actor',
-  'artifact asset upsert-prop',
-  'artifact asset upsert-location',
-  'artifact asset upsert-actor-state',
-  'artifact asset upsert-prop-state',
-  'artifact asset upsert-location-state',
-  'artifact asset delete-actor',
-  'artifact asset delete-prop',
-  'artifact asset delete-location',
-  'artifact asset delete-actor-state',
-  'artifact asset delete-prop-state',
-  'artifact asset delete-location-state',
-  'artifact asset import',
-  'artifact video upsert-episode',
-  'artifact video upsert-scene',
-  'artifact video upsert-clip',
-  'artifact video update-clip-urls',
-  'artifact video delete-episode',
-  'artifact video delete-scene',
-  'artifact video delete-clip',
-  'artifact video import-storyboard',
-  'artifact clip upsert-episode',
-  'artifact clip upsert-batch',
-  'artifact clip update-status',
-  'artifact clip delete-episode',
-];
-
-const ARTIFACT_DELETE_COMMANDS = ARTIFACT_WRITE_COMMANDS.filter((name) => name.includes(' delete-'));
-
 const CONFIRMATION_COMMANDS = new Set([
   'auth clear',
   'account switch-team',
-  'project use',
+  'project switch',
   'project create',
   'project update',
   'project ensure',
@@ -716,7 +612,6 @@ const CONFIRMATION_COMMANDS = new Set([
   'create asset-group',
   'create asset-group-update',
   'create asset',
-  ...ARTIFACT_WRITE_COMMANDS,
   'create subject',
   'create subject-voice',
   'create subject-batch',
@@ -733,7 +628,7 @@ const COST_COMMANDS = new Set([
 
 const REMOTE_WRITE_COMMANDS = new Set([
   'account switch-team',
-  'project use',
+  'project switch',
   'project create',
   'project update',
   'project ensure',
@@ -748,7 +643,6 @@ const REMOTE_WRITE_COMMANDS = new Set([
   'create asset-group',
   'create asset-group-update',
   'create asset',
-  ...ARTIFACT_WRITE_COMMANDS,
   'create subject',
   'create subject-voice',
   'create subject-batch',
@@ -759,12 +653,12 @@ const LOCAL_STATE_WRITE_COMMANDS = new Set([
   'auth login',
   'auth clear',
   'auth logout',
-  'project use',
+  'project switch',
   'project create',
   'project ensure',
 ]);
 
-const DESTRUCTIVE_COMMANDS = new Set(['auth clear', ...ARTIFACT_DELETE_COMMANDS]);
+const DESTRUCTIVE_COMMANDS = new Set(['auth clear']);
 const LONG_RUNNING_COMMANDS = new Set(['auth login', 'credits redeem', 'task wait', 'task record-poll', 'create subject-wait', 'create subject-voice-wait']);
 const NETWORK_NONE_COMMANDS = new Set(['schema', 'auth status', 'auth clear', 'auth logout', 'credits buy', 'model input-guide', 'task records']);
 const NETWORK_CONDITIONAL_COMMANDS = new Set(['doctor', 'auth login']);
@@ -823,57 +717,6 @@ const OUTPUT_KIND_BY_COMMAND = {
   'create subject-voice': 'subject_voice_create_result',
   'create subject-voice-wait': 'subject_voice_status',
   'create subject-batch': 'batch_subject_publish_result',
-  'artifact script get': 'artifact_full',
-  'artifact script document': 'artifact_record',
-  'artifact script rows': 'artifact_list',
-  'artifact script row': 'artifact_record',
-  'artifact script children': 'artifact_list',
-  'artifact script upsert-row': 'artifact_write_result',
-  'artifact script delete-row': 'artifact_delete_result',
-  'artifact script import': 'artifact_import_result',
-  'artifact asset get': 'artifact_full',
-  'artifact asset actors': 'artifact_list',
-  'artifact asset actor': 'artifact_record',
-  'artifact asset props': 'artifact_list',
-  'artifact asset prop': 'artifact_record',
-  'artifact asset locations': 'artifact_list',
-  'artifact asset location': 'artifact_record',
-  'artifact asset upsert-actor': 'artifact_write_result',
-  'artifact asset upsert-prop': 'artifact_write_result',
-  'artifact asset upsert-location': 'artifact_write_result',
-  'artifact asset upsert-actor-state': 'artifact_write_result',
-  'artifact asset upsert-prop-state': 'artifact_write_result',
-  'artifact asset upsert-location-state': 'artifact_write_result',
-  'artifact asset delete-actor': 'artifact_delete_result',
-  'artifact asset delete-prop': 'artifact_delete_result',
-  'artifact asset delete-location': 'artifact_delete_result',
-  'artifact asset delete-actor-state': 'artifact_delete_result',
-  'artifact asset delete-prop-state': 'artifact_delete_result',
-  'artifact asset delete-location-state': 'artifact_delete_result',
-  'artifact asset import': 'artifact_import_result',
-  'artifact video get': 'artifact_full',
-  'artifact video episodes': 'artifact_list',
-  'artifact video episode': 'artifact_record',
-  'artifact video scenes': 'artifact_list',
-  'artifact video scene': 'artifact_record',
-  'artifact video clips': 'artifact_list',
-  'artifact video clip': 'artifact_record',
-  'artifact video upsert-episode': 'artifact_write_result',
-  'artifact video upsert-scene': 'artifact_write_result',
-  'artifact video upsert-clip': 'artifact_write_result',
-  'artifact video update-clip-urls': 'artifact_write_result',
-  'artifact video delete-episode': 'artifact_delete_result',
-  'artifact video delete-scene': 'artifact_delete_result',
-  'artifact video delete-clip': 'artifact_delete_result',
-  'artifact video import-storyboard': 'artifact_import_result',
-  'artifact clip get': 'artifact_full',
-  'artifact clip episodes': 'artifact_list',
-  'artifact clip episode': 'artifact_record',
-  'artifact clip episode-by-id': 'artifact_record',
-  'artifact clip upsert-episode': 'artifact_write_result',
-  'artifact clip upsert-batch': 'artifact_import_result',
-  'artifact clip update-status': 'artifact_status_update',
-  'artifact clip delete-episode': 'artifact_delete_result',
 };
 
 const PREFLIGHTS_BY_COMMAND = {
@@ -1007,7 +850,7 @@ function buildCommandWorkflow(command) {
   }
   return {
     outputKind,
-    recommendedPreflight: PREFLIGHTS_BY_COMMAND[command.name] || (ARTIFACT_WRITE_COMMANDS.includes(command.name) ? [`${command.name} --dry-run`] : []),
+    recommendedPreflight: PREFLIGHTS_BY_COMMAND[command.name] || [],
     nextActions: next,
   };
 }
@@ -1027,7 +870,6 @@ function buildDomainSummaries(commands) {
 
 function requiredOptionsForCommand(command) {
   const requiredOptions = new Set();
-  if (commandGroup(command) === 'artifact') requiredOptions.add('projectId');
   for (const key of COMMAND_REQUIRED_OPTIONS[command.name] || []) requiredOptions.add(key);
   return [...requiredOptions];
 }
@@ -1140,11 +982,6 @@ function buildAgentBrief(commands, version = 'unknown') {
         start: ['task wait', 'task record-poll', 'task records'],
         rule: '优先复用 create 返回的 nextCommand；批量任务使用 task-record-file，失败项单独重试。',
       },
-      {
-        intent: '最终产物 artifact',
-        start: ['artifact script', 'artifact asset', 'artifact video', 'artifact clip'],
-        rule: 'artifact 使用 project-id，不是 project-group-no；写入/删除/导入先 dry-run，再一次性确认写入面。',
-      },
     ],
     lookup: {
       preciseSchema: `${commandPrefix()} schema --domain <domain> --command <command> -f json`,
@@ -1185,7 +1022,6 @@ function buildAgentContract() {
         'taskId -> taskType / projectGroupNo / resultUrls / errorMessage',
         'subject name + modelCode -> elementId / externalId / nextRefSubject',
         'subject voice name + source -> voiceRecordId / externalId / nextVoiceArg',
-        'artifact projectId and imported file paths',
       ],
       invalidation: '用户切换账号、团队、项目组、模型、素材、prompt 或关键参数后，只刷新受影响的缓存；不要重复跑未变化的 model options / create-spec / fee。',
     },
@@ -1197,7 +1033,7 @@ function buildAgentContract() {
       '用户给出多条同模型同参数任务时优先 batch + task-record-file，不要单条循环 create。',
       '命令返回 nextCommand / nextRefSubject / nextVoiceArg 时优先复用返回值，不手拼等价命令。',
       '素材加白平台先通过 model asset-review-models 或用户明确输入确定；create asset-* 必须显式传 --platform，不要依赖默认平台。create asset 会自动判断 assetType=Image/Video/Audio，本地文件会用 ffprobe 校验图片/视频尺寸、视频时长/FPS/像素数和音频时长；不合法素材正式执行时会询问是否转码，非交互场景可追加 --auto-convert；macOS + Homebrew 环境缺失时 CLI 会自动安装 ffmpeg。',
-      '旧根域 image / video / asset / subject 已移除；只使用 create / task / artifact 等 schema 暴露的 domain。',
+      '旧根域 image / video / asset / subject 已移除；只使用 create / task 等 schema 暴露的 domain。',
     ],
     canonicalFields: {
       purpose: 'CLI 输出对上游平台多版本字段做了归一化。Agent 只识别 canonical 列，遇到 aliases 列出的旧字段名时说明是上游原始返回，CLI 已在 text / 归一化层做了 fallback。不要把旧名当成独立新字段对外报告。',

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

@@ -149,6 +149,32 @@ async function runNpm(args, options = {}) {
   }
 }
 
+async function runVolta(args, options = {}) {
+  try {
+    const result = await execFileAsync('volta', args, {
+      cwd: currentRootDir(),
+      encoding: 'utf8',
+      timeout: options.timeoutMs || DEFAULT_NPM_TIMEOUT_MS,
+      maxBuffer: 1024 * 1024,
+      env: process.env,
+    });
+    return result;
+  } catch (error) {
+    const stderr = String(error.stderr || '').trim();
+    const stdout = String(error.stdout || '').trim();
+    throw new LingjingAwbCliError('volta 命令执行失败', {
+      type: 'runtime_error',
+      exitCode: 30,
+      hint: stderr || stdout || error.message || '请确认 Volta 可用，或改用 npm 全局安装方式。',
+      details: {
+        command: `volta ${args.join(' ')}`,
+        code: error.code,
+        signal: error.signal,
+      },
+    });
+  }
+}
+
 export async function fetchLatestCliVersion(options = {}) {
   const mocked = trimToNull(process.env.LINGJING_AWB_UPDATE_LATEST_VERSION);
   if (mocked) return mocked;
@@ -258,6 +284,45 @@ function tailLines(value, limit = 8) {
   return lines.slice(Math.max(0, lines.length - limit));
 }
 
+function isVoltaPackageImagePath(value) {
+  const normalized = String(value || '').replaceAll('\\', '/');
+  return normalized.includes('/.volta/tools/image/packages/');
+}
+
+async function isCurrentCommandVoltaManaged() {
+  try {
+    const result = await execFileAsync('volta', ['which', commandPrefix()], {
+      cwd: currentRootDir(),
+      encoding: 'utf8',
+      timeout: 5_000,
+      maxBuffer: 256 * 1024,
+      env: process.env,
+    });
+    return isVoltaPackageImagePath(result.stdout);
+  } catch {
+    return false;
+  }
+}
+
+async function resolveUpdateInstaller({ packageName, installVersion, installSpec, registry }) {
+  if (await isCurrentCommandVoltaManaged()) {
+    return {
+      name: 'volta',
+      args: ['install', npmInstallSpec(packageName, installVersion)],
+      command: `volta install ${npmInstallSpec(packageName, installVersion)}`,
+      run: () => runVolta(['install', npmInstallSpec(packageName, installVersion)], { timeoutMs: 120_000 }),
+    };
+  }
+
+  const args = npmArgsWithRegistry(['install', '-g', installSpec], registry);
+  return {
+    name: 'npm',
+    args,
+    command: `npm ${args.join(' ')}`,
+    run: () => runNpm(args, { timeoutMs: 120_000 }),
+  };
+}
+
 export async function runCliUpdate(kwargs = {}) {
   const currentVersion = await readCurrentCliVersion().catch(() => 'unknown');
   const packageName = resolveCliPackageName(kwargs);
@@ -268,7 +333,6 @@ export async function runCliUpdate(kwargs = {}) {
   const force = toBool(kwargs.force);
   const installVersion = latestVersion || 'latest';
   const installSpec = npmInstallSpec(packageName, force ? 'latest' : installVersion);
-  const installArgs = npmArgsWithRegistry(['install', '-g', installSpec], registry);
 
   if (checkOnly) {
     return {
@@ -297,7 +361,13 @@ export async function runCliUpdate(kwargs = {}) {
     };
   }
 
-  const result = await runNpm(installArgs, { timeoutMs: 120_000 });
+  const installer = await resolveUpdateInstaller({
+    packageName,
+    installVersion: force ? 'latest' : installVersion,
+    installSpec,
+    registry,
+  });
+  const result = await installer.run();
   await saveState({
     updateCheck: {
       packageName,
@@ -314,10 +384,11 @@ export async function runCliUpdate(kwargs = {}) {
     updated: true,
     updateAvailable,
     packageName,
+    installer: installer.name,
     previousVersion: currentVersion,
     currentVersion: latestVersion,
     latestVersion,
-    command: `npm ${installArgs.join(' ')}`,
+    command: installer.command,
     skillUpdated: true,
     restartRecommended: true,
     message: '更新完成。请退出并重新打开 AI Agent，以加载最新 CLI 和 skill。',

package/skills/lj-awb/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: lj-awb
-version: 0.4.7
-description: "灵境 AWB CLI skill。使用 `lj-awb` 命令调用动漫平台 / AWB 云端能力，覆盖认证、项目组、积分（含充值购买与兑换码兑换）、模型发现、上传、统一 create 创建域、任务查询、视频超分、最终产物 artifact CRUD 与本地 JSON 导入。用户说生图、生视频、视频超分、主体、音色、素材加白、去字幕、充值、购买积分、兑换码、artifact 写入或查询时使用。正式生成、切换项目组、清空认证、兑换码、artifact 写入等写入或扣费动作前必须确认。"
+version: 0.4.9
+description: "灵境 AWB CLI skill。使用 `lj-awb` 命令调用动漫平台 / AWB 云端能力，覆盖认证、项目组、积分（含充值购买与兑换码兑换）、模型发现、上传、统一 create 创建域、任务查询、视频超分。用户说生图、生视频、视频超分、主体、音色、素材加白、去字幕、充值、购买积分、兑换码时使用。正式生成、切换项目组、清空认证、兑换码等写入或扣费动作前必须确认。"
 metadata:
   bootstrap:
     package: "@lingjingai/lj-awb-cli"
-    version: "0.4.7"
+    version: "0.4.9"
     bin: "lj-awb"
   cliHelp: "lj-awb --help"
 ---
@@ -15,13 +15,20 @@ metadata:
 `lj-awb` 是确定性 CLI，skill 的职责是调度：少查、少问、少重跑，按 schema 和业务链条把命令串对。不要把本 skill 当成一堆命令片段来拼。
 普通命令如果 JSON 输出里出现 `meta._notice.update`，先完成当前用户请求，再告诉用户当前版本和最新版本，并建议执行 `lj-awb update`；更新后提醒重新打开 AI Agent。
 
+## 对话输出纪律
+
+- 面向用户只汇报关键状态和确认点：候选模型摘要、需要用户选择的参数、费用 / dry-run 结果、任务 ID、最终产物链接或明确错误。
+- 不主动暴露完整命令、长 JSON、schema 摘要、并行查询清单或内部调度过程；这些只在用户明确要求“展示命令 / 输出 / 日志”时给出。
+- 中间更新保持短句，避免逐条复述每个只读查询。需要说明进度时，用“正在查询模型候选 / 正在估价 / 正在等待任务”这类概括表达。
+- 最终答复聚焦结果和下一步，不把工具调用轨迹当作交付内容。
+
 ## 先读驱动器
 
 任何非单条查询任务，都先加载 [`modules/driver.md`](modules/driver.md)。它定义：
 
 - CLI 全部能力域和业务边界。
 - Agent 状态账本，避免重复跑 `model options`、`model create-spec`、`fee`、`upload`。
-- 创作、批量、主体、音色、素材加白、artifact 的最短链条。
+- 创作、批量、主体、音色、素材加白的最短链条。
 - 禁止清单：旧命令域、默认参数代决策、单条循环批量任务、直连后端等。
 
 只在驱动器把你引到某个细节模块时才继续读该模块。不要为了“掌握全部功能”一次性加载所有模块。
@@ -77,7 +84,6 @@ schema 查询必须先返回，再组织业务命令；不要把 schema 查询
 | 本地文件上传为 backendPath | `upload` | [`modules/upload.md`](modules/upload.md) |
 | 图片 / 视频 / 去字幕 / 主体 / 音色 / 素材创建 | `create` | [`modules/create.md`](modules/create.md)、[`modules/create-contract.md`](modules/create-contract.md) |
 | 异步任务等待与本地台账 | `task` | [`modules/task.md`](modules/task.md) |
-| 剧本、资产、视频、剪辑最终产物 | `artifact` | [`modules/artifact.md`](modules/artifact.md) |
 
 ## 触发分流
 
@@ -95,15 +101,15 @@ schema 查询必须先返回，再组织业务命令；不要把 schema 查询
 | “去字幕 / 擦掉英文字幕” | [`modules/video.md`](modules/video.md)，只走 material 任务体系 |
 | “批量 / 多镜头 / 分镜 / JSONL / 并行” | [`modules/workflows.md`](modules/workflows.md) 的批量链条 |
 | “任务好了没 / 继续等 / 查状态” | [`modules/task.md`](modules/task.md) |
-| “写入 AWB / 最终产物 / script / actor / storyboard / clip” | [`modules/artifact.md`](modules/artifact.md) |
 
-歧义词先一句话澄清：`加白` 是素材审核还是视觉白边；`存一下` 是 artifact 哪个子域；`角色一致` 是主体还是一次性参考图。
+歧义词先一句话澄清：`加白` 是素材审核还是视觉白边；`角色一致` 是主体还是一次性参考图。
 
 ## 全局硬规则
 
 - schema 中 `safety.requiresConfirmation=true` 的命令必须先向用户确认，再追加 `--yes`。
 - schema 中 `safety.supportsDryRun=true` 的写入 / 扣费命令先 `--dry-run`，确认后再正式执行。
 - 创作类命令在 fee / dry-run 前必须确认会影响价格或效果的关键参数；用户明确说“按默认”后才使用 defaultValue。
+- Prompt 默认原文直出：用户提供明确 prompt / 创作描述时，禁止语义改写、润色、扩写或从参考图补画面细节；只有用户明确要求“优化 / 润色 / 扩写 / 你来写 prompt”时才允许改写，且改写后的最终 prompt 必须先展示并等待确认，之后才能 fee / dry-run / create。
 - `fee` 是最终估价，不是参数探索工具。不要为多个 quality / duration / ratio / 渠道组合反复跑 fee。
 - 正式图片 / 视频任务要带 `--project-group-no`，除非命令 schema 没有该参数。
 - 命令返回 `nextCommand`、`nextRefSubject`、`nextVoiceArg` 时优先复用返回值，不手拼。

package/skills/lj-awb/VERSION

@@ -1 +1 @@
-0.4.7
+0.4.9

package/skills/lj-awb/compat.json

@@ -1,6 +1,6 @@
 {
-  "skillVersion": "0.4.7",
-  "minCliVersion": "0.4.7",
+  "skillVersion": "0.4.9",
+  "minCliVersion": "0.4.9",
   "preferredCommand": "lj-awb",
-  "updatedAt": "2026-06-12"
+  "updatedAt": "2026-06-13"
 }

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

@@ -19,7 +19,7 @@
 
 不该切换的场景：
 
-- 用户只是要换"项目"——那是 [`project use`](project.md)，**不是 switch-team**。
+- 用户只是要换"项目"——那是 [`project switch`](project.md)，**不是 switch-team**。
 - 用户没明确说要切——`account teams` 列出来给用户挑就够，别擅自切。
 
 ## 规则
@@ -27,6 +27,6 @@
 - `account switch-team` 改变团队上下文，**必须确认**后追加 `--yes`。
 - 切换原理：用当前用户 `userId` + 目标 `groupId` 调 `groupAccessKey` 换到该团队的 accessKey，再**写回本地认证文件**（等同重新登录到该团队）。
 - 若用户是通过 `LINGJING_AWB_ACCESS_KEY` 环境变量登录的，写回文件**不生效**（env key 优先级高于文件）；这种情况下要么 `unset LINGJING_AWB_ACCESS_KEY` 后再切，要么直接换该团队的 access key。
-- 切换团队会**重置项目组上下文**：之后跑 `project current` 必然为空，需要让用户重新 `project use --project-group-no <no>` 选一个。
+- 切换团队会**重置项目组上下文**：之后跑 `project current` 必然为空，需要让用户重新 `project switch --project-group-no <no>` 选一个。
 - 不要把 `account info.groupName`（团队名）当作项目组名报告给用户。
 - 输出字段速查见 [`../references/output-fields.md`](../references/output-fields.md) 的"账号与项目组"小节。

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

@@ -7,7 +7,7 @@
 | CLI 参数 | 含义 | 组织方式 |
 |----------|------|----------|
 | `--model-group-code` | 模型组编码，决定使用哪个模型、计费方式和参数白名单 | 来自 `model image-models` / `model video-models` |
-| `--prompt` | 提交给模型的最终提示词 | 以用户明确创作描述为基底，组装素材输入和模型约束；视频需要占位绑定时才做 key 对齐；没有明确需求时先追问或用最小中性表达 |
+| `--prompt` | 提交给模型的最终提示词 | 用户提供明确 prompt / 创作描述时默认原文直出，只做转义清理；禁止语义改写。只有用户明确要求优化 / 润色 / 扩写 / 代写 prompt 时才可改写，且必须先展示最终 prompt 等待确认 |
 | `--ratio` | 画幅比例 | 只能从 `model options.params[key=ratio].values` 选择 |
 | `--quality` | 清晰度 / 分辨率档位 | 只能从 `model options.params[key=quality].values` 选择 |
 | `--generate-num` | 生图张数 | 仅图片模型支持时使用 |
@@ -67,14 +67,16 @@ JSON 语法：
 
 ## Prompt 组装原则
 
-创建任务时，Prompt 的核心能力是组装可执行请求：
+创建任务时，Prompt 的核心原则是默认原文直出：
 
-- 用户有明确创作描述或提示词时，以该文本为基底，只做必要的素材组织、视频 key 对齐和转义清理，不要强行补资源占位符。
-- “使用某模型 / 参考生 / 生成视频 / 用这张图 / 用这个音频”等操作性指令只用于选择模型和资源，不要改写成新的画面描述。
-- 用户没有比较明确的创作需求或提示词时，先追问关键创作意图，或使用最小中性表达；不要为了让 prompt 好看而主动补风格、镜头、剧情细节。
+- 用户有明确创作描述或提示词时，`--prompt` 必须使用用户原文；只允许做 shell 转义、去掉包裹引号、首尾空白清理这类不改变语义的机械处理。
+- 禁止把短 prompt 自动扩成更长描述；禁止主动补风格、镜头、剧情、光线、场景、情绪、动作细节；禁止为了“更适合模型”而润色。
+- “使用某模型 / 参考生 / 生成视频 / 用这张图 / 用这个音频”等操作性指令只用于选择模型、资源和参数，不要改写成新的画面描述。
+- 参考图已经作为资源输入时，不要从图片内容中推断“山谷、街道、室内、人物外观”等画面描述塞进 prompt；除非用户明确要求看图补充描述或根据图写 prompt。
 - 用户只是描述任务目标时，不要默认补资源占位符；图片生图永远不用 `<<<key>>>`，视频只有用户明确要在 prompt 中绑定某个参考对象时才使用。
-- 参考图已经作为资源输入时，不要从图片内容中推断“山谷、街道、室内、人物外观”等画面描述塞进 prompt；除非用户明确要求看图补充描述。
-- 用户要求优化 / 改写 / 创作 prompt 时，可以进行提示词创作，但创建任务前仍要展示最终 prompt。
+- 用户没有比较明确的创作需求或提示词时，先追问关键创作意图，或使用最小中性表达；不要为了让 prompt 好看而主动补内容。
+- 只有用户明确要求“优化 / 润色 / 扩写 / 改写 / 帮我写 prompt / 你来写 prompt / 更适合生图或生视频”时，Agent 才能进行提示词创作。
+- 一旦最终 prompt 与用户原文发生任何可见语义变化，必须先展示原始 prompt 和最终 prompt，等待用户确认；确认前不得运行 `fee`、`create --dry-run` 或正式 `create`。
 
 规则：
 
@@ -122,7 +124,7 @@ Agent 必须按顺序做：
 7. 用 `supportedIntents[]` 匹配用户意图；不要只看模型列表摘要就生成最终能力结论。
 8. 参数枚举值只从 `model options.params[].values` 选择，素材限制只从 `model options.resources[]` 校验，参数 / 资源联动限制按 `model options.constraints[]` 收窄。新增通用参数只要在 `params[]` 中出现且带 `cliArg`，就通过 `--model-param` / `--model-params-json` 显式传入。
 9. 不主动列举所有缺失控制项；只追问会影响价格 / 效果的关键参数。视频包括 `quality`、`duration`、约束后仍可选的 `ratio`，以及用户明确要求输出音效时的 `needAudio`；图片包括 `quality`、`ratio`、`generateNum`。
-10. 组装最终 prompt；如果可见文本发生变化，先展示给用户。
+10. 组装最终 prompt；默认使用用户原文。若用户明确要求优化 / 代写且最终 prompt 与用户原文发生任何可见语义变化，先展示原始 prompt 和最终 prompt，等待用户确认。
 11. 若用户上传或指定音频文件，必须先确认 `model options.resources[]` 中存在 `mediaType=AUDIO usage=reference` 后再组织 `audio:reference` 资源；只有用户明确要求“输出是否带模型生成音效/音频”时，才检查 `model options.params[]` 是否存在 `needAudio`。
 12. 用户未提供关键参数时，把 `model options.params[].values` 和 `defaultValue` 转成候选问题；用户选择或确认“按默认”前，不跑 `create image-fee` / `create video-fee`，也不跑 `create --dry-run`。即使模型给了 `defaultValue`，也不要静默写入请求。
 13. 跑 `create image-fee` / `create video-fee` 获取预估积分——**只跑一次，参数取用户已确认的那组**。`fee` 是"用户敲定参数后的最终估价"，不是参数探索 / 候选比较工具：不要为了对比价格档跑 `fee` × 多个 `quality` / `duration` / `ratio` 组合，也不要为了横向比同款不同渠道跑 `fee` × 多个 `modelGroupCode`；价格档差异从 `model options.feeCalcType` + 参数取值表里就能口算/展示给用户，比较应该发生在 `model options` 阶段。