@lingjingai/lj-awb-cli-pre 0.4.0 → 0.4.5

package/README.md

@@ -63,6 +63,18 @@ lj-awb auth verify
 
 可用 `LINGJING_AWB_SKILL_INSTALL_DIR` 指定单一安装目录；如果传入的是以 `skills` 结尾的根目录，安装器会自动追加 `lj-awb`。也可用 `LINGJING_AWB_SKIP_SKILL_INSTALL=1` 跳过 skill 安装。
 
+只分发 skill 也可以作为完整入口：`skills/lj-awb/scripts/resolve-lj-awb-cmd.sh` 会在首次使用时检查 `lj-awb`，缺失或版本低于 `skills/lj-awb/compat.json` 的 `minCliVersion` 时自动执行：
+
+```bash
+npm install -g @lingjingai/lj-awb-cli@<minCliVersion>
+```
+
+预发环境可在 bootstrap 前设置：
+
+```bash
+export LINGJING_AWB_CLI_PACKAGE=@lingjingai/lj-awb-cli-pre
+```
+
 源码运行：
 
 ```bash
@@ -75,8 +87,37 @@ packages/awb-cli/bin/lj-awb auth status
 
 macOS 本地 wrapper `packages/awb-cli/bin/lj-awb` 会自动补充 Node 证书链，适合直接调试 HTTPS 平台接口。
 
+自动更新检查默认每天最多访问一次 npm registry，并会在源码 checkout、CI 或设置 `LINGJING_AWB_DISABLE_UPDATE_CHECK=1` / `AWB_DISABLE_UPDATE_CHECK=1` 时跳过。调试时可用 `LINGJING_AWB_UPDATE_CHECK=force` 强制检查。
+
 ## 认证
 
+### 浏览器授权登录（推荐）
+
+不需要手动复制 access key，直接登录：
+
+```bash
+lj-awb auth login
+```
+
+CLI 会创建登录任务、展示授权链接，等你在浏览器登录并确认授权后，自动拿到 access key 并保存到本地。命令默认阻塞轮询，最长约 10 分钟。
+
+AI agent / 无法实时查看命令输出的场景，分两步走（避免阻塞）：
+
+```bash
+lj-awb auth login --no-wait --json     # 返回 flowId / verifyUrl，把链接给用户去授权
+lj-awb auth login --flow-id <flowId>   # 用户授权后续轮询，拿到并保存 access key
+```
+
+> 不要重复执行不带 `--flow-id` 的 login，否则会生成新的 flowId 导致旧授权链接失效。
+
+退出登录（清除本地 access key）：
+
+```bash
+lj-awb auth logout
+```
+
+### 直接使用 access key
+
 保存 access key 到本地认证文件：
 
 ```bash
@@ -110,6 +151,8 @@ lj-awb account info
 ```bash
 lj-awb doctor
 lj-awb doctor --verify
+lj-awb update --check
+lj-awb update
 lj-awb schema --brief -f json
 lj-awb schema -f json
 lj-awb schema --domain create -f json
@@ -159,6 +202,8 @@ lj-awb doctor --verify
 
 `auth status` 只检查本地是否配置 access key；`auth verify` 会联网校验 key 是否远端有效。`doctor` 默认只做本地检查；追加 `--verify` 后会联网校验 access key、当前用户和项目组。精确 `schema` 返回每个命令的 `options[].key`，Agent 应使用这些 key 生成 CLI 参数，而不是解析自然语言 help。
 
+`lj-awb` 在普通命令结束后会做非阻塞更新检查；如果有新版本，JSON 输出会在 `meta._notice.update` 里带上更新提示。Skill / Agent 看到这个提示后，应在完成当前任务后告诉用户当前版本和最新版本，并建议或直接运行 `lj-awb update`。真正安装更新只走显式 `lj-awb update`，`--check` 只检查不安装。
+
 `schema` 还包含面向 Agent 的执行约束：
 
 - `requiredOptions`：必须提供的参数 key。

package/build/_shared.mjs

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import { spawnSync } from 'node:child_process';
-import { cpSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { cpSync, mkdtempSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import os from 'node:os';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 
@@ -19,13 +20,16 @@ export function run(command, args, options = {}) {
   process.stderr.write(`$ ${[command, ...args].join(' ')}\n`);
   const result = spawnSync(command, args, {
     cwd: options.cwd || repoRoot,
+    env: options.env ? { ...process.env, ...options.env } : process.env,
     stdio: 'inherit',
   });
   if (result.error) {
+    options.beforeExit?.();
     process.stderr.write(`${result.error.message}\n`);
     process.exit(1);
   }
   if (result.status !== 0) {
+    options.beforeExit?.();
     process.exit(result.status || 1);
   }
 }
@@ -33,11 +37,53 @@ export function run(command, args, options = {}) {
 export function capture(command, args, options = {}) {
   return spawnSync(command, args, {
     cwd: options.cwd || repoRoot,
+    env: options.env ? { ...process.env, ...options.env } : process.env,
     encoding: 'utf8',
     stdio: ['inherit', 'pipe', 'pipe'],
   });
 }
 
+export function createNpmPublishAuthConfig(registry) {
+  const tokenSource = ['NPM_PUBLISH_TOKEN', 'NPM_TOKEN', 'NODE_AUTH_TOKEN']
+    .find((name) => process.env[name]?.trim());
+  if (!tokenSource) {
+    return {
+      env: {},
+      cleanup() {},
+      tokenSource: null,
+    };
+  }
+
+  const token = process.env[tokenSource].trim();
+  const normalizedRegistry = registry.endsWith('/') ? registry : `${registry}/`;
+  const registryUrl = new URL(normalizedRegistry);
+  const registryPath = registryUrl.pathname.endsWith('/') ? registryUrl.pathname : `${registryUrl.pathname}/`;
+  const npmrcDir = mkdtempSync(path.join(os.tmpdir(), 'lj-awb-npm-'));
+  const npmrcPath = path.join(npmrcDir, '.npmrc');
+  writeFileSync(
+    npmrcPath,
+    [
+      `registry=${normalizedRegistry}`,
+      `//${registryUrl.host}${registryPath}:_authToken=${token}`,
+      'strict-ssl=false',
+      'always-auth=true',
+      '',
+    ].join('\n'),
+    { mode: 0o600 },
+  );
+
+  return {
+    env: {
+      NPM_CONFIG_USERCONFIG: npmrcPath,
+      NPM_CONFIG_REGISTRY: normalizedRegistry,
+    },
+    cleanup() {
+      rmSync(npmrcDir, { recursive: true, force: true });
+    },
+    tokenSource,
+  };
+}
+
 export function packageFilePaths(cwd = repoRoot) {
   const result = capture('npm', ['pack', '--dry-run', '--json'], { cwd });
   if (result.error) {
@@ -101,12 +147,13 @@ export function packTarball(stageDir) {
   return path.join(stageDir, tarball);
 }
 
-export function ensureLoggedIn(registry) {
-  const result = capture('npm', ['whoami', `--registry=${registry}`]);
+export function ensureLoggedIn(registry, options = {}) {
+  const result = capture('npm', ['whoami', `--registry=${registry}`], { env: options.env });
   if (result.status === 0) {
     process.stderr.write(`npm user: ${result.stdout.trim()}\n`);
     return;
   }
+  options.beforeExit?.();
   process.stderr.write([
     `npm is not logged in for ${registry}.`,
     `Run: npm login --registry=${registry}`,
@@ -115,14 +162,16 @@ export function ensureLoggedIn(registry) {
   process.exit(1);
 }
 
-export function ensureVersionNotPublished({ name, version, registry }) {
+export function ensureVersionNotPublished({ name, version, registry }, options = {}) {
   const spec = `${name}@${version}`;
-  const result = capture('npm', ['view', spec, 'version', `--registry=${registry}`]);
+  const result = capture('npm', ['view', spec, 'version', `--registry=${registry}`], { env: options.env });
   if (result.status === 0) {
+    options.beforeExit?.();
     process.stderr.write(`${spec} already exists on npm. Bump the version before publishing.\n`);
     process.exit(1);
   }
   if (!/E404|404 Not Found|Not found/i.test(`${result.stderr}\n${result.stdout}`)) {
+    options.beforeExit?.();
     process.stderr.write(`Could not verify whether ${spec} exists on npm.\n`);
     process.stderr.write(result.stderr || result.stdout || '');
     process.exit(1);

package/build/prod.mjs

@@ -2,6 +2,7 @@
 import { readFileSync } from 'node:fs';
 import path from 'node:path';
 import {
+  createNpmPublishAuthConfig,
   ensureLoggedIn,
   ensureVersionNotPublished,
   findArgValue,
@@ -33,14 +34,21 @@ function ensureProductionDefaultApiOrigin() {
 ensureProductionDefaultApiOrigin();
 
 process.stderr.write(`Preparing ${pkg.name}@${pkg.version} for npm ${dryRun ? 'dry-run' : 'publish'} with default API origin ${PROD_API_ORIGIN}.\n`);
+const publishAuth = createNpmPublishAuthConfig(registry);
+if (!dryRun && publishAuth.tokenSource) {
+  process.stderr.write(`Using npm publish token from ${publishAuth.tokenSource}; NPM_CONFIG_USERCONFIG points to an isolated temporary npmrc.\n`);
+}
 
 if (process.env.SKIP_CHECK !== '1') {
   run('npm', ['run', 'check:local']);
 }
 
-ensureVersionNotPublished({ name: pkg.name, version: pkg.version, registry });
+ensureVersionNotPublished(
+  { name: pkg.name, version: pkg.version, registry },
+  { env: publishAuth.env, beforeExit: publishAuth.cleanup },
+);
 if (!dryRun) {
-  ensureLoggedIn(registry);
+  ensureLoggedIn(registry, { env: publishAuth.env, beforeExit: publishAuth.cleanup });
 }
 
 run('npm', [
@@ -49,4 +57,5 @@ run('npm', [
   'public',
   `--registry=${registry}`,
   ...passthroughArgs,
-]);
+], { env: publishAuth.env, beforeExit: publishAuth.cleanup });
+publishAuth.cleanup();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lingjingai/lj-awb-cli-pre",
-  "version": "0.4.0",
+  "version": "0.4.5",
   "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",
@@ -23,7 +23,7 @@
     "build:pre-publish": "node build/pre-publish.mjs",
     "build:prod": "node build/prod.mjs",
     "check": "npm run check:local && npm run check:real",
-    "check:local": "node --check install.mjs && node --check packages/awb-core/src/common.js && node --check packages/awb-core/src/api.js && node --check packages/awb-core/src/artifact.js && node --check packages/awb-core/src/auth.js && node --check packages/awb-core/src/output.js && node --check packages/awb-core/src/services.js && node --check packages/awb-core/src/commands.js && node --check packages/awb-core/src/standalone.js && sh -n packages/awb-cli/bin/lj-awb && node --check packages/awb-cli/bin/lj-awb.js && node --check build/build.mjs && node --check build/_shared.mjs && node --check build/pre.mjs && node --check build/pre-publish.mjs && node --check build/prod.mjs && node --check scripts/run-openapi-cli-examples-real.mjs && node --check scripts/validate-cli-schema.mjs && node --check scripts/validate-cli-output-contract.mjs && node --check scripts/validate-cli-command-coverage.mjs && node scripts/validate-skill-meta.mjs && node scripts/validate-cli-schema.mjs && node scripts/validate-cli-command-coverage.mjs",
+    "check:local": "node --check install.mjs && node --check packages/awb-core/src/common.js && node --check packages/awb-core/src/api.js && node --check packages/awb-core/src/artifact.js && node --check packages/awb-core/src/auth.js && node --check packages/awb-core/src/output.js && node --check packages/awb-core/src/update.js && node --check packages/awb-core/src/services.js && node --check packages/awb-core/src/commands.js && node --check packages/awb-core/src/standalone.js && sh -n packages/awb-cli/bin/lj-awb && bash -n skills/lj-awb/scripts/resolve-lj-awb-cmd.sh && node --check packages/awb-cli/bin/lj-awb.js && node --check build/build.mjs && node --check build/_shared.mjs && node --check build/pre.mjs && node --check build/pre-publish.mjs && node --check build/prod.mjs && node --check scripts/run-openapi-cli-examples-real.mjs && node --check scripts/validate-cli-schema.mjs && node --check scripts/validate-cli-output-contract.mjs && node --check scripts/validate-cli-command-coverage.mjs && node scripts/validate-skill-meta.mjs && node scripts/validate-cli-schema.mjs && node scripts/validate-cli-command-coverage.mjs",
     "check:real": "node scripts/validate-cli-output-contract.mjs && node scripts/validate-openapi-cli-examples.mjs",
     "test:openapi-real": "node scripts/run-openapi-cli-examples-real.mjs",
     "smoke": "packages/awb-cli/bin/lj-awb --help && packages/awb-cli/bin/lj-awb auth status -f json && packages/awb-cli/bin/lj-awb system && packages/awb-cli/bin/lj-awb auth && packages/awb-cli/bin/lj-awb account && packages/awb-cli/bin/lj-awb project && packages/awb-cli/bin/lj-awb credits && packages/awb-cli/bin/lj-awb upload && packages/awb-cli/bin/lj-awb model && packages/awb-cli/bin/lj-awb create && packages/awb-cli/bin/lj-awb task && packages/awb-cli/bin/lj-awb artifact && packages/awb-cli/bin/lj-awb schema -f json >/dev/null",

package/packages/awb-cli/package.json

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

package/packages/awb-core/package.json

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

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

@@ -109,6 +109,14 @@ export async function fetchUserInfo() {
   return await apiFetch('/api/anime/user/account/userInfo', { body: {} });
 }
 
+export async function createLoginFlow() {
+  return await apiFetch('/api/anime/user/cli/createLoginFlow', { body: {}, auth: false });
+}
+
+export async function queryLoginFlowStatus(flowId) {
+  return await apiFetch('/api/anime/user/cli/queryFlowStatus', { body: { flowId }, auth: false });
+}
+
 export async function fetchTeams() {
   return await apiFetch('/api/anime/user/group/getOwnGroupList', { body: {} });
 }
@@ -230,6 +238,20 @@ export async function createVideoSubtitleRemovalTask(payload = {}) {
   return await apiFetch('/api/material/creation/videoSubtitleRemoval', { body: payload });
 }
 
+export async function fetchVideoSuperResolutionFee(payload = {}) {
+  return await apiFetch('/api/material/creation/videoUpResolutionCal', {
+    method: 'GET',
+    query: payload,
+  });
+}
+
+export async function createVideoSuperResolutionTask(payload = {}) {
+  return await apiFetch('/api/material/creation/videoUpResolution', {
+    method: 'POST',
+    query: payload,
+  });
+}
+
 export async function fetchTaskFeed(payload = {}) {
   return await apiFetch('/api/material/creation/task/feedPull', {
     query: payload,

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

@@ -2,6 +2,7 @@ import { fetchProjectGroupUsers, fetchTeams, fetchUserInfo } from './api.js';
 import * as artifact from './artifact.js';
 import { clearAuth, loadAuth, saveAccessKey, summarizeAuth } from './auth.js';
 import { LingjingAwbCliError, maskSecret, toBool, trimSecret } from './common.js';
+import { runCliUpdate } from './update.js';
 import {
   assetGroupCreate,
   assetGroupGet,
@@ -10,6 +11,8 @@ import {
   assetMatchActor,
   assetReviewModels,
   assetRegister,
+  authLogin,
+  authLogout,
   creditsBalance,
   creditsUsageSummary,
   createProjectGroupCommand,
@@ -39,6 +42,9 @@ import {
   subjectWait,
   subtitleRemove,
   subtitleStatus,
+  videoSuperResolution,
+  videoSuperResolutionFee,
+  videoSuperResolutionStatus,
   taskList,
   taskRecordPoll,
   taskRecords,
@@ -85,6 +91,9 @@ const MODEL_LIST_ARGS = [
 const TASK_RECORD_ARG = { name: 'task-record-file', valueName: 'path', description: '任务台账 JSONL 文件；也可用 LINGJING_AWB_TASK_RECORD_FILE' };
 const RESOURCE_ARG = { name: 'resource', valueName: 'spec', description: '统一素材，格式 type:usage[:key]=path|url|asset，可重复传；音频参考用 audio:reference=./music.mp3' };
 const RESOURCES_JSON_ARG = { name: 'resources-json', valueName: 'json|path', description: 'resources 数组 JSON 或 JSON 文件路径' };
+const MODEL_PARAM_ARG = { name: 'model-param', valueName: 'key=value', description: '通用模型配置参数，可重复传；key 来自 model options.params[]，例如 generation_effort=high' };
+const MODEL_PARAMS_JSON_ARG = { name: 'model-params-json', valueName: 'json|path', description: '通用模型配置参数对象 JSON 或 JSON 文件路径；显式 --ratio/--quality 等命令参数优先' };
+const MODEL_PARAM_ARGS = [MODEL_PARAM_ARG, MODEL_PARAMS_JSON_ARG];
 const CREATE_WAIT_ARGS = [
   { name: 'wait-seconds', valueName: 'seconds', description: '提交后顺带等待结果的秒数；默认 0 不等待' },
   { name: 'poll-interval-ms', valueName: 'ms', description: '任务轮询间隔毫秒数，默认 5000' },
@@ -125,6 +134,25 @@ export function registerAwbCommands(cli) {
     func: async (_ctx, kwargs) => doctor(kwargs),
   });
 
+  cli({
+    name: 'update',
+    description: commandHelp('检查并更新 CLI 到最新版本；默认只在需要时安装新版本', {
+      examples: [
+        'lj-awb update --check',
+        'lj-awb update',
+        'lj-awb update --force',
+      ],
+      hint: '普通命令只会做非阻塞更新检查；真正安装请显式运行 update。',
+    }),
+    args: [
+      { name: 'check', description: '只检查是否有新版本，不安装' },
+      { name: 'force', description: '强制重新检查并执行安装，忽略缓存' },
+      { name: 'registry', valueName: 'url', description: 'npm registry 地址；默认读取环境变量或 npm 默认 registry' },
+      { name: 'package-name', valueName: 'name', description: '要更新的包名；默认自动识别当前 CLI 包' },
+    ],
+    func: async (_ctx, kwargs) => runCliUpdate(kwargs),
+  });
+
   cli({
     name: 'auth status',
     description: commandHelp('查看本地 access key 是否已配置；不联网', {
@@ -163,50 +191,27 @@ export function registerAwbCommands(cli) {
 
   cli({
     name: 'auth login',
-    description: commandHelp('登录：使用 access key 校验身份，并保存到本地认证文件', {
+    description: commandHelp('登录：默认走浏览器授权登录；也支持直接传 access key 保存', {
       examples: [
+        'lj-awb auth login',
+        'lj-awb auth login --no-wait',
+        'lj-awb auth login --flow-id <flowId>',
         'lj-awb auth login --access-key <key>',
         'LINGJING_AWB_ACCESS_KEY=<key> lj-awb auth login',
         'lj-awb auth login --access-key <key> --skip-verify',
       ],
-      hint: '不要写成 lj-awb auth <key>。不传 --access-key 时只读取 LINGJING_AWB_ACCESS_KEY 环境变量。',
+      hint: '不传 --access-key（且无 LINGJING_AWB_ACCESS_KEY 环境变量）时走浏览器授权：创建登录任务、展示链接、轮询直到授权成功并自动保存 access key。命令最长阻塞约 10 分钟；AI agent 可先用 --no-wait --json 拿 flow_id，再用 --flow-id <id> 续轮询，不要重复发起新的 login。',
     }),
     args: [
-      { name: 'access-key', valueName: 'key', description: '平台 access key；不传时读取环境变量' },
+      { name: 'access-key', valueName: 'key', description: '平台 access key；传了则跳过浏览器授权直接保存，不传时读取环境变量' },
+      { name: 'flow-id', valueName: 'flowId', description: '复用已有登录任务的 flow_id 继续轮询；不传则新建登录任务' },
+      { name: 'no-wait', description: '只创建登录任务并返回 flow_id / verify_url，不阻塞轮询；适合 AI agent / 脚本' },
+      { name: 'wait-seconds', valueName: 'seconds', description: '浏览器授权最长轮询秒数，默认 600' },
+      { name: 'poll-interval-ms', valueName: 'ms', description: '授权状态轮询间隔毫秒数，默认 3000' },
       { name: 'skip-verify', description: '只保存 key，不调用 userInfo 校验；仅用于本地调试' },
       DRY_RUN_ARG,
     ],
-    func: async (_ctx, kwargs) => {
-      const skipVerify = toBool(kwargs.skipVerify);
-      const accessKey = trimSecret(kwargs.accessKey || process.env.LINGJING_AWB_ACCESS_KEY || '');
-      if (!accessKey) {
-        throw new LingjingAwbCliError('缺少 access key', {
-          type: 'argument_error',
-          exitCode: 2,
-          hint: '传 --access-key <key>，或设置 LINGJING_AWB_ACCESS_KEY 环境变量。',
-        });
-      }
-      if (toBool(kwargs.dryRun)) {
-        return {
-          dryRun: true,
-          saved: false,
-          verified: false,
-          accessKey: maskSecret(accessKey),
-        };
-      }
-      let user = null;
-      if (!skipVerify) {
-        process.env.LINGJING_AWB_ACCESS_KEY = accessKey;
-        user = normalizeUserInfo(await fetchUserInfo());
-      }
-      const { auth } = await saveAccessKey(accessKey, { verified: !skipVerify });
-      return {
-        auth: summarizeAuth(auth, { accessKey, source: 'saved', sourceName: 'auth' }),
-        accessKey: maskSecret(accessKey),
-        verified: !skipVerify,
-        user,
-      };
-    },
+    func: async (_ctx, kwargs) => authLogin(kwargs),
   });
 
   cli({
@@ -224,6 +229,16 @@ export function registerAwbCommands(cli) {
     },
   });
 
+  cli({
+    name: 'auth logout',
+    description: commandHelp('退出登录：清除本地保存的 access key', {
+      examples: ['lj-awb auth logout'],
+      hint: '只清本地认证文件，不清当前 shell 中的 LINGJING_AWB_ACCESS_KEY 环境变量；下次使用前重新运行 lj-awb auth login。',
+    }),
+    args: [],
+    func: async () => authLogout(),
+  });
+
   cli({
     name: 'account info',
     description: commandHelp('查看当前 AWB 用户、团队、项目组和积分摘要', {
@@ -497,10 +512,12 @@ export function registerAwbCommands(cli) {
       { name: 'ratio', valueName: 'ratio', description: '画幅比例，如 9:16' },
       { name: 'quality', valueName: 'quality', description: '清晰度，如 2K' },
       { name: 'generate-num', valueName: 'n', description: '生成张数' },
+      ...MODEL_PARAM_ARGS,
       RESOURCE_ARG,
       RESOURCES_JSON_ARG,
       FEE_DRY_RUN_ARG,
     ],
+    allowDynamicModelParams: true,
     func: async (_ctx, kwargs) => imageFee(kwargs),
   });
 
@@ -521,6 +538,7 @@ export function registerAwbCommands(cli) {
       { name: 'ratio', valueName: 'ratio', description: '画幅比例' },
       { name: 'quality', valueName: 'quality', description: '清晰度' },
       { name: 'generate-num', valueName: 'n', description: '生成张数' },
+      ...MODEL_PARAM_ARGS,
       RESOURCE_ARG,
       RESOURCES_JSON_ARG,
       TASK_RECORD_ARG,
@@ -528,6 +546,7 @@ export function registerAwbCommands(cli) {
       DRY_RUN_ARG,
       YES_ARG,
     ],
+    allowDynamicModelParams: true,
     func: async (_ctx, kwargs) => imageCreate(kwargs),
   });
 
@@ -538,17 +557,19 @@ export function registerAwbCommands(cli) {
         'lj-awb create image-batch --input-file ./prompts.txt --model-group-code <code> --dry-run',
         'lj-awb create image-batch --input-file ./image-input.jsonl --model-group-code <code> --concurrency 3 --yes',
       ],
-      hint: 'JSON/JSONL 每项只写任务差异字段：prompt、ratio、quality、generate_num、resources、resource、customBizId。',
+      hint: 'JSON/JSONL 每项只写任务差异字段：prompt、ratio、quality、generate_num、resources、resource、model_params、customBizId；新增模型配置参数也可直接写入每项。',
     }),
     args: [
       { name: 'input-file', valueName: 'path', description: '批量输入文件' },
       MODEL_GROUP_ARG,
       PROJECT_GROUP_ARG,
+      ...MODEL_PARAM_ARGS,
       { name: 'concurrency', valueName: 'n', description: '并发数，默认 1' },
       TASK_RECORD_ARG,
       DRY_RUN_ARG,
       YES_ARG,
     ],
+    allowDynamicModelParams: true,
     func: async (_ctx, kwargs) => imageCreateBatch(kwargs),
   });
 
@@ -577,10 +598,12 @@ export function registerAwbCommands(cli) {
       { name: 'quality', valueName: 'quality', description: '清晰度，如 720' },
       { name: 'duration', valueName: 'seconds', description: '生成时长秒数' },
       { name: 'need-audio', valueName: 'bool', description: '输出音效开关：是否让模型在视频中生成音效（true/false）。不接收音频文件；参考音频请用 --resource audio:reference=...' },
+      ...MODEL_PARAM_ARGS,
       RESOURCE_ARG,
       RESOURCES_JSON_ARG,
       FEE_DRY_RUN_ARG,
     ],
+    allowDynamicModelParams: true,
     func: async (_ctx, kwargs) => videoFee(kwargs),
   });
 
@@ -604,6 +627,7 @@ export function registerAwbCommands(cli) {
       { name: 'quality', valueName: 'quality', description: '清晰度' },
       { name: 'duration', valueName: 'seconds', description: '生成时长秒数' },
       { name: 'need-audio', valueName: 'bool', description: '输出音效开关：是否让模型在视频中生成音效（true/false）。不接收音频文件；参考音频请用 --resource audio:reference=...' },
+      ...MODEL_PARAM_ARGS,
       RESOURCE_ARG,
       RESOURCES_JSON_ARG,
       TASK_RECORD_ARG,
@@ -611,6 +635,7 @@ export function registerAwbCommands(cli) {
       DRY_RUN_ARG,
       YES_ARG,
     ],
+    allowDynamicModelParams: true,
     func: async (_ctx, kwargs) => videoCreate(kwargs),
   });
 
@@ -621,17 +646,19 @@ export function registerAwbCommands(cli) {
         'lj-awb create video-batch --input-file ./prompts.txt --model-group-code <code> --dry-run',
         'lj-awb create video-batch --input-file ./video-input.jsonl --model-group-code <code> --concurrency 2 --yes',
       ],
-      hint: 'JSON/JSONL 每项只写任务差异字段：prompt、ratio、quality、duration、need_audio、resources、resource、customBizId。',
+      hint: 'JSON/JSONL 每项只写任务差异字段：prompt、ratio、quality、duration、need_audio、resources、resource、model_params、customBizId；新增模型配置参数也可直接写入每项。',
     }),
     args: [
       { name: 'input-file', valueName: 'path', description: '批量输入文件' },
       MODEL_GROUP_ARG,
       PROJECT_GROUP_ARG,
+      ...MODEL_PARAM_ARGS,
       { name: 'concurrency', valueName: 'n', description: '并发数，默认 1' },
       TASK_RECORD_ARG,
       DRY_RUN_ARG,
       YES_ARG,
     ],
+    allowDynamicModelParams: true,
     func: async (_ctx, kwargs) => videoCreateBatch(kwargs),
   });
 
@@ -660,6 +687,35 @@ export function registerAwbCommands(cli) {
     func: async (_ctx, kwargs) => subtitleRemove(kwargs),
   });
 
+  cli({
+    name: 'create video-super-resolution-fee',
+    description: commandHelp('计算视频超分预计积分；传入 objectName', {
+      examples: ['lj-awb create video-super-resolution-fee --object-name material/video-super/example.mp4 --project-group-no <no>'],
+      hint: 'objectName 通常是 material backendPath 或 COS 对象路径；正式超分前先看一次估价。',
+    }),
+    args: [
+      { name: 'object-name', valueName: 'path', description: '视频对象路径；通常是 material backendPath 或 COS 对象路径' },
+      PROJECT_GROUP_ARG,
+    ],
+    func: async (_ctx, kwargs) => videoSuperResolutionFee(kwargs),
+  });
+
+  cli({
+    name: 'create video-super-resolution',
+    description: commandHelp('基于 objectName 提交视频超分任务', {
+      examples: ['lj-awb create video-super-resolution --object-name material/video-super/example.mp4 --project-group-no <no> --dry-run'],
+      hint: '正式执行需要 --yes；会先按 objectName 读取视频信息，再选择 1080P / 2K 模型组。',
+    }),
+    args: [
+      { name: 'object-name', valueName: 'path', description: '视频对象路径；通常是 material backendPath 或 COS 对象路径' },
+      PROJECT_GROUP_ARG,
+      TASK_RECORD_ARG,
+      DRY_RUN_ARG,
+      YES_ARG,
+    ],
+    func: async (_ctx, kwargs) => videoSuperResolution(kwargs),
+  });
+
   cli({
     name: 'task video-subtitle-status',
     description: commandHelp('查询 material 去字幕任务状态', {
@@ -672,13 +728,25 @@ export function registerAwbCommands(cli) {
     func: async (_ctx, kwargs) => subtitleStatus(kwargs),
   });
 
+  cli({
+    name: 'task video-super-resolution-status',
+    description: commandHelp('查询 material 视频超分任务状态', {
+      examples: ['lj-awb task video-super-resolution-status --task-id <superResolutionTaskId>'],
+    }),
+    args: [
+      { name: 'task-id', valueName: 'id', description: 'material 视频超分任务 ID' },
+      PROJECT_GROUP_ARG,
+    ],
+    func: async (_ctx, kwargs) => videoSuperResolutionStatus(kwargs),
+  });
+
   cli({
     name: 'task list',
     description: commandHelp('查询项目组近期任务流', {
       examples: ['lj-awb task list --task-type IMAGE_CREATE --project-group-no <no>'],
     }),
     args: [
-      { name: 'task-type', valueName: 'type', description: 'IMAGE_CREATE / IMAGE_EDIT / VIDEO_GROUP' },
+      { name: 'task-type', valueName: 'type', description: 'IMAGE_CREATE / IMAGE_EDIT / VIDEO_GROUP / VIDEO_SUPER_RESOLUTION / VIDEO_SUBTITLE_REMOVAL' },
       PROJECT_GROUP_ARG,
       { name: 'page-size', valueName: 'n', description: '每页任务数' },
       { name: 'min-time', valueName: 'ms', description: '任务流 minTime，默认当前时间' },
@@ -694,7 +762,7 @@ export function registerAwbCommands(cli) {
     }),
     args: [
       { name: 'task-id', valueName: 'id', description: '任务 ID' },
-      { name: 'task-type', valueName: 'type', description: 'IMAGE_CREATE / VIDEO_GROUP' },
+      { name: 'task-type', valueName: 'type', description: 'IMAGE_CREATE / VIDEO_GROUP；material 扩展任务优先用 task video-subtitle-status / task video-super-resolution-status' },
       PROJECT_GROUP_ARG,
       ...TASK_WAIT_ARGS,
     ],
@@ -811,7 +879,11 @@ export function registerAwbCommands(cli) {
   cli({
     name: 'create asset',
     description: commandHelp('把 COS 路径 / URL / 本地文件注册成平台素材', {
-      examples: ['lj-awb create asset --group-id <id> --platform JIMENG --url "asset-review/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',
+        'lj-awb create asset --group-id <id> --platform JIMENG --file ./clip.mp4 --name "参考视频" --dry-run',
+      ],
+      hint: 'CLI 会按扩展名自动设置 assetType=Image/Video/Audio；本地文件会用 ffprobe 预校验图片/视频尺寸、视频时长/FPS/像素数和音频时长，缺少 ffprobe/ffmpeg 时 macOS + Homebrew 会自动安装 ffmpeg。',
     }),
     args: [
       { name: 'group-id', valueName: 'id', description: '素材组 ID' },
@@ -819,6 +891,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: 'auto-convert', description: '本地素材不符合加白规格时自动转换为合法规格后继续' },
       ASSET_PLATFORM_ARG,
       DRY_RUN_ARG,
       YES_ARG,

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

@@ -318,11 +318,19 @@ export function guessMimeType(filePath) {
       return 'image/png';
     case '.jpg':
     case '.jpeg':
+    case '.jfif':
       return 'image/jpeg';
+    case '.tif':
+    case '.tiff':
+      return 'image/tiff';
     case '.webp':
       return 'image/webp';
     case '.gif':
       return 'image/gif';
+    case '.heic':
+      return 'image/heic';
+    case '.heif':
+      return 'image/heif';
     case '.mp3':
       return 'audio/mpeg';
     case '.wav':