museav-cli 2.1.0 → 2.2.0

package/AGENTS.md

@@ -19,8 +19,10 @@ Don't try both — whichever credential is present is what gets used (env var `S
 # Generate an image, wait for it, get the URL on stdout
 museav gen --prompt 'a poster, neon lights, cyberpunk' --ratio 9:16
 
-# Generate a video (文生视频/图生视频), wait, get the mp4 URL on stdout
-museav gen --video --prompt 'a cat stretching on a windowsill, cinematic' --model seedance-2-fast --ratio 9:16
+# Generate a video (文生视频/图生视频), wait, get the mp4 URL on stdout.
+# Omit --model to let the platform route automatically (auto); pinning a tier uses
+# artsdance-* ids like artsdance-2-0-pro-260801 (Seedance 2.0).
+museav gen --video --prompt 'a cat stretching on a windowsill, cinematic' --ratio 9:16
 museav gen --video --image logo.png --prompt 'logo glows slowly, background fades' --ratio 1:1
 
 # Generate from a pre-configured image template instead of a raw prompt (deterministic
@@ -37,6 +39,10 @@ museav gen --template <id> --fields '{"artist":"name","city":"place"}'
 museav templates create --name '演唱会海报' --prompt '{artist} 在 {city} 的演唱会海报' --ratio 9:16
 
 # Reverse-engineer a prompt from an existing image (stdout: English prompt only).
+# PRIMARY path is LOCAL: Ollama qwen3-vl — fast, free, NO login needed. Falls back to
+# the platform API (with a slowness warning) only if Ollama isn't running or the model
+# is missing. Image URLs always go to the API (local path takes file paths only);
+# --api forces the API path.
 # This READS the image and nothing else — it will NOT build a template. Passing any
 # template-ish flag to the underlying API is a hard 400 since 2026-08-16.
 museav reverse ./photo.png

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## 2.2.0 · 2026-08-17
+
+**`reverse` 主路改本地：Ollama + qwen3-vl。** 中台 API 读图要上传、排队、等云端推理；本地 8b 量化模型在自己机器上跑，免登录、零成本、离线可用。本地不可用（服务没起 / 模型没拉 / 推理出错）自动回落中台 API，回落时明确提示较慢，缺什么会告诉你补什么命令。
+
+- 一次性配置：`brew install ollama && brew services start ollama && ollama pull qwen3-vl:8b`（Intel Mac / Linux 用官方安装脚本同理）。换模型档位设 `MUSEAV_LOCAL_VLM`（如 `qwen3-vl:4b`，更快、识图质量略降），自定服务地址走标准 `OLLAMA_HOST`。
+- SCULPT 提示词从中台移植，砍掉本地不消费的 genre / body_md；返回归一化后与 API 路完全同构，`$(museav reverse x.png)` 管线用法不变，stdout 仍只出英文 prompt。
+- 读图前复用上传同款压缩（压到视觉模型够用的尺寸），本地推理也跟着快。
+- URL 输入固定走中台 API（本地路只收文件路径）；`--api` 强制走中台。
+- 本地路完全不需要中台凭证——未登录也能用，只有真回落 API 时才提示登录。
+
+**修复 `video-templates create` 必被 400 拒**：中台视频模板契约硬性要求 `slug`（required=['zh_name','slug']），且 toapis 2026-08-14 下线后 CLI 默认的 `seedance-2` 成了悬空引用——不带参数建视频模板必挂。现在 `--slug` 缺省自动生成 `vt-` 短标识并在 stderr 回显，默认模型改 `auto`（交给中台路由），`--duration` 放宽到 4-30（Seedance 2.5 支持到 30 秒）。
+
+- `templates` / `video-templates` 列表兼容读 config 顶层的 `fields`（现行契约存法——CLI 自己 create 写的就是顶层，之前自己建的模板自己都列不出字段）。
+- `gen` / `video-templates` 帮助文案与 README / AGENTS.md 示例里已下线的 `seedance-2-*` 代号全部清掉，照旧文案传参会 400。
+
 ## 2.0.0 · 2026-08-16
 
 **改名：npm 包 `museav-cli`，命令 `museav`。** 产品叫 MUSE AV，命令却叫另一个名字，同一个东西两个叫法——这次统一到产品名。

package/README.md

@@ -172,8 +172,8 @@ museav gen --prompt '把这只鞋抠成透明底' --ref shoe.jpg --transparent
 #     （白底图看起来完全正常，静默降级只会让你以为提示词没写对，反复重试）
 #   · 会强制 PNG 输出：JPEG / 有损 WebP 没有 alpha 通道，装不下透明
 
-# 文生视频（模型如 seedance-2-fast / artsdance-2-0-pro-260801，自动轮询直到完成）
-museav gen --video --prompt '一只橘猫在窗台上伸懒腰，阳光洒进来，电影感' --model seedance-2-fast --ratio 9:16
+# 文生视频（不传 --model 走 auto 路由；锁死档次用 artsdance-2-0-pro-260801 这类代号，自动轮询直到完成）
+museav gen --video --prompt '一只橘猫在窗台上伸懒腰，阳光洒进来，电影感' --ratio 9:16
 
 # 图生视频（--image 传首帧图，自动上传）
 museav gen --video --image logo.png --prompt 'logo 缓缓发光，背景渐暗' --ratio 1:1
@@ -237,17 +237,24 @@ museav gen --template "$ID" --fields '{"artist":"..."}'
 
 ### 图片逆向 `reverse`
 
-上传一张图，中台用 **SCULPT 六要素**（主体/构图/世界观/光影/输出/质感）逆推出图 prompt，可以直接拿去再出一张同风格的：
+逆推出图 prompt，可以直接拿去再出一张同风格的。**主路是本地 Ollama（qwen3-vl）**：快、零成本、无需登录；本地不可用时自动回落中台 API（SCULPT 六要素：主体/构图/世界观/光影/输出/质感），回落时会明确提示较慢：
 
 ```bash
-# 本地文件或图片 URL 都行
+# 本地文件走本地模型（推荐，无需登录）
 museav reverse photo.png
+
+# 图片 URL 没法喂本地模型，走中台 API（需登录）
 museav reverse https://example.com/photo.png
 
+# 强制走中台 API（跳过本地，慢，需登录）
+museav reverse photo.png --api
+
 # 逆向 + 出图，一条龙
 museav gen --prompt "$(museav reverse photo.png)"
 ```
 
+本地路依赖：Ollama 运行中（`brew services start ollama`）+ 模型在位（`ollama pull qwen3-vl:8b`，换档位设 `MUSEAV_LOCAL_VLM`，自定地址设 `OLLAMA_HOST`）。缺哪个都会提示对应命令并回落 API。
+
 分析详情打到 stderr（人看），**stdout 只输出英文 prompt**（机器用，方便管道）。
 
 `reverse` **只读图**，不会顺手帮你建模板。要把图做成模板看下一节——中台 2026-08-16 把这两件事

package/dist/client.d.ts

@@ -51,6 +51,12 @@ export interface TemplateOption {
         model: string;
         prompt_template: string;
         ref_slots?: string[];
+        /** 表单字段声明——现行契约放 config 顶层（服务端 validateConfig 读这里） */
+        fields?: Array<{
+            key: string;
+            label: string;
+        }>;
+        /** 旧存法：fields 曾在 params_json 里，老模板还这么存，读时两种都要兜 */
         params_json?: {
             fields?: Array<{
                 key: string;
@@ -58,6 +64,8 @@ export interface TemplateOption {
                 placeholder?: string;
             }>;
         };
+        duration?: number;
+        aspect_ratio?: string;
         is_default?: boolean;
     }>;
 }
@@ -89,6 +97,8 @@ export interface CreateTemplateInput {
  *  ratio/duration/model 放在 generation_configs 每项里。 */
 export interface CreateVideoTemplateInput {
     zh_name: string;
+    /** 对外调用标识，视频模板硬必填（服务端 validateCore required=['zh_name','slug']），全局唯一 */
+    slug: string;
     category?: string;
     description?: string;
     sample_video_url?: string | null;

package/dist/commands/reverse.d.ts

@@ -1,3 +1,8 @@
-/** museav reverse —— 图片逆向（SCULPT 六要素反推 prompt） */
+/** museav reverse —— 图片逆向（SCULPT 六要素反推 prompt）。
+ *  主路是本地 Ollama（qwen3-vl），快、零成本、无需登录；中台 API 是回落路，走回落时会明确提示较慢。
+ *  client 懒构造（getClient）：本地路成功就完全不碰中台凭证。
+ *  本地系统的 AI 能力统一收口在这个 CLI，reverse 是第一个本地化的能力。 */
 import type { StudioClient } from '../client.js';
-export declare function reverse(client: StudioClient, input: string): Promise<void>;
+export declare function reverse(getClient: () => StudioClient, input: string, opts?: {
+    api?: boolean;
+}): Promise<void>;

package/dist/commands/reverse.js

@@ -1,7 +1,33 @@
-export async function reverse(client, input) {
-    // 输入是文件路径还是 URL
+import { checkLocalVlm, reverseLocally, LOCAL_VLM_MODEL } from '../local-vision.js';
+export async function reverse(getClient, input, opts = {}) {
     const isUrl = /^https?:\/\//.test(input);
+    if (!opts.api && !isUrl) {
+        const status = await checkLocalVlm();
+        if (status.running && status.modelPresent) {
+            try {
+                const start = Date.now();
+                const result = await reverseLocally(input);
+                process.stderr.write(`✓ 本地 Ollama（${LOCAL_VLM_MODEL}）用时 ${((Date.now() - start) / 1000).toFixed(1)}s\n`);
+                renderReverse(result);
+                return;
+            }
+            catch (e) {
+                process.stderr.write(`⚠ 本地读图失败（${e instanceof Error ? e.message : e}），回落中台 API —— 速度较慢，请耐心等待\n`);
+            }
+        }
+        else {
+            process.stderr.write(`⚠ 本地读图不可用（${status.reason}），回落中台 API —— 速度较慢，请耐心等待\n`);
+        }
+    }
+    else if (!opts.api && isUrl) {
+        process.stderr.write(`ℹ URL 输入走中台 API（本地路只收文件路径）\n`);
+    }
+    const client = getClient();
     const result = await client.reverse(isUrl ? { imageUrl: input } : { file: input });
+    renderReverse(result);
+}
+/** 两条路产出同构，渲染只写一份 */
+function renderReverse(result) {
     process.stderr.write(`✅ 逆向完成\n\n`);
     process.stderr.write(`风格: ${result.zh_name || '-'}  比例: ${result.aspect_ratio}\n`);
     process.stderr.write(`标签: ${result.style_tags.join(', ')}\n\n`);

package/dist/commands/templates.js

@@ -13,7 +13,8 @@ export async function templates(client, opts = {}) {
     process.stderr.write(`可用模板（${list.length} 个）:\n`);
     for (const t of list) {
         const cfg = t.generation_configs?.find((c) => c.is_default) || t.generation_configs?.[0];
-        const fields = cfg?.params_json?.fields || [];
+        // fields 新契约在 config 顶层（CLI 自己 create 就写顶层），老数据在 params_json 里——两种都兜
+        const fields = cfg?.fields || cfg?.params_json?.fields || [];
         const fieldHint = fields.length ? `字段:${fields.map((f) => f.key).join(',')}` : '';
         process.stderr.write(`  ${t.id.padEnd(38)} ${(t.zh_name || '').padEnd(16)} ${(t.category || '').padEnd(10)} ${(t.ratio || '').padEnd(6)} ${typeTag(t).padEnd(8)} ${fieldHint.padEnd(20)} ${tag(t)}\n`);
     }

package/dist/commands/video-templates.d.ts

@@ -5,6 +5,8 @@ export declare function videoTemplates(client: StudioClient, opts?: {
 }): Promise<void>;
 interface CreateVideoTemplateOpts {
     name: string;
+    /** 对外调用标识，全局唯一。不给就自动生成一个（vt- 前缀） */
+    slug?: string;
     prompt: string;
     category?: string;
     description?: string;

package/dist/commands/video-templates.js

@@ -14,8 +14,9 @@ export async function videoTemplates(client, opts = {}) {
         const cfg = t.generation_configs?.find((c) => c.is_default) || t.generation_configs?.[0];
         const modelHint = cfg?.model ? `模型:${cfg.model}` : '';
         const ratioHint = t.ratio || '';
-        const fieldCount = cfg?.params_json?.fields?.length || 0;
-        const fieldHint = fieldCount ? `字段:${cfg.params_json.fields.map((f) => f.key).join(',')}` : '';
+        // fields 新契约在 config 顶层，老数据在 params_json 里——两种都兜，否则自己建的模板自己列不出来
+        const fields = cfg?.fields || cfg?.params_json?.fields || [];
+        const fieldHint = fields.length ? `字段:${fields.map((f) => f.key).join(',')}` : '';
         const sampleHint = t.sample_video_url ? '有参考视频' : '';
         process.stderr.write(`  ${t.id.padEnd(38)} ${(t.zh_name || '').padEnd(20)} ${(t.category || '').padEnd(10)} ${ratioHint.padEnd(6)} ${modelHint.padEnd(30)} ${fieldHint.padEnd(24)} ${sampleHint.padEnd(10)} ${tag(t)}\n`);
         if (t.sample_video_url) {
@@ -34,11 +35,17 @@ export async function createVideoTemplate(client, opts) {
         throw new Error('--name 必填');
     if (!opts.prompt?.trim())
         throw new Error('--prompt 必填，占位符用 {key} 形式，如 "{product} 在 {scene} 中展示"');
+    // slug 是视频模板的硬必填（服务端 required=['zh_name','slug']），漏了必 400。
+    // 中文名大多是中文没法直接转 slug，不给 --slug 就生成一个 vt- 短标识，撞了让服务端报出来再换。
+    const slug = (opts.slug || `vt-${Date.now().toString(36)}${Math.random().toString(36).slice(2, 5)}`).trim();
+    if (!/^[\w-]+$/.test(slug))
+        throw new Error('--slug 只能包含字母、数字、下划线和连字符');
     // 占位符必须声明 fields（中台 validateConfig 硬校验：prompt 里有 {key} 但没 fields 会被拒）
     const keys = Array.from(new Set(Array.from(opts.prompt.matchAll(/\{(\w+)\}/g), (m) => m[1])));
     const fields = keys.map((key) => ({ key, label: key }));
     const cfg = {
-        model: opts.model || 'seedance-2',
+        // 默认 auto：交给中台路由按 ratio/duration 挑档次。锁死具体模型得自己保证参数配得上它
+        model: opts.model || 'auto',
         prompt_template: opts.prompt,
         is_default: true,
     };
@@ -46,14 +53,15 @@ export async function createVideoTemplate(client, opts) {
         cfg.fields = fields;
     if (opts.duration) {
         const d = Number(opts.duration);
-        if (!Number.isFinite(d) || d < 4 || d > 15)
-            throw new Error('--duration 必须是 4-15 之间的数字（秒）');
+        if (!Number.isFinite(d) || d < 4 || d > 30)
+            throw new Error('--duration 必须是 4-30 之间的数字（秒；Seedance 2.0 系上限 15，2.5 到 30，具体由中台按模型校验）');
         cfg.duration = d;
     }
     if (opts.ratio)
         cfg.aspect_ratio = opts.ratio;
     const row = await client.createVideoTemplate({
         zh_name: opts.name,
+        slug,
         category: opts.category,
         description: opts.description,
         sample_video_url: opts.sampleVideo || null,
@@ -61,6 +69,7 @@ export async function createVideoTemplate(client, opts) {
         generation_configs: [cfg],
     });
     process.stderr.write(`✅ 视频模板已建：${row.id}\n`);
+    process.stderr.write(`slug: ${slug}\n`);
     process.stderr.write(`归属：${row.tenant_id ? '当前租户（其他租户看不到）' : '平台共享（所有租户可见）'}\n`);
     process.stderr.write(`模型: ${cfg.model} 时长: ${cfg.duration || '模板默认'} 比例: ${cfg.aspect_ratio || '模板默认'}\n`);
     if (fields.length)

package/dist/index.js

@@ -93,6 +93,22 @@ function withClient(fn) {
         }
     };
 }
+// reverse 的本地路（Ollama）不需要中台凭证，client 懒构造：只有真回落 API 才建，
+// 未登录的报错也只在那时候出现
+function withLazyClient(fn) {
+    return async (...args) => {
+        try {
+            const opts = args[args.length - 2];
+            const positional = args.slice(0, -2);
+            const getClient = () => new StudioClient(loadConfig());
+            await fn(getClient, ...positional, opts);
+        }
+        catch (e) {
+            process.stderr.write(`❌ ${e.message}\n`);
+            process.exit(1);
+        }
+    };
+}
 // products / assets 查的是租户自己后台的数据，不是 Studio 中台的，走独立的 TenantClient
 // （见 tenant-client.ts 顶部注释），只支持租户 apiKey 身份，不支持个人 login token。
 function withTenantClient(fn) {
@@ -125,7 +141,7 @@ program
     // 不设默认值：--skill / --template 场景下要让技能/模板自己的比例生效，
     // CLI 强填默认值会把它们覆盖掉（服务端在纯 --prompt 场景已有 3:4 兜底，这里不用重复兜底）
     .option('-r, --ratio <ratio>', '宽高比: 3:4 / 9:16 / 1:1 / 4:3 / 16:9（不指定则用技能/模板自己的比例，纯 prompt 模式兜底 3:4）')
-    .option('-m, --model <name>', '指定模型，如 gpt-image-2 / seedance-2-fast / artsdance-2-0-pro-260801')
+    .option('-m, --model <name>', '指定模型，如 gpt-image-2 / artsdance-2-0-pro-260801（视频不传则走 auto 路由）')
     .option('-q, --quality <level>', '质量: low / medium / high（仅 gpt-image）')
     // 可重复：--ref 正面.jpg --ref 背景.jpg。顺序即语义——提示词里写「参考图片1的排版、
     // 用图片2作为背景」时，图片N 对应第 N 个 --ref。commander 的 collect 保证顺序。
@@ -133,14 +149,15 @@ program
     // 透明背景是上游的 background 参数，不是提示词能表达的东西——提示词里写
     // "transparent background" 只是在描述构图，模型照样铺一层白底。这个开关才是抠图开关。
     .option('--transparent', '透明背景 PNG（抠掉背景，带 alpha 通道）。仅部分上游支持，不支持时中台明确报错、不会悄悄给白底图；服务端自动强制 PNG 输出（JPEG 没有 alpha 通道）')
-    .option('--video', '生成视频（走 /api/videos 链路，模型如 seedance-2-fast / artsdance-2-0-pro）')
+    .option('--video', '生成视频（走 /api/videos 链路；模型档次如 artsdance-2-0-pro-260801，不传 --model 走 auto 路由）')
     .option('--duration <sec>', '视频时长（秒，仅 --video；由模型与上游支持范围决定）', (v) => Number(v))
     .option('--image <file>', '图生视频首帧图（仅 --video，自动上传）')
     .action(withClient((client, opts) => gen(client, opts)));
 program
     .command('reverse <input>')
-    .description('读图：上传图或图片 URL，反推 SCULPT prompt，stdout 输出英文 prompt（只读图；要做成模板用 image-to-template）')
-    .action(withClient((client, input) => reverse(client, input)));
+    .description('读图：反推 SCULPT prompt，stdout 输出英文 prompt。主路本地 Ollama（qwen3-vl，快，无需登录）；本地不可用回落中台 API（会提示较慢）。只读图；要做成模板用 image-to-template')
+    .option('--api', '跳过本地 Ollama，强制走中台 API（慢，需登录）')
+    .action(withLazyClient((getClient, input, opts) => reverse(getClient, input, opts)));
 program
     .command('image-to-template <input>')
     .description('图生模板：上传图或图片 URL → 读图 + 文字层逆向 + 变量化 → 建成可复用的图片模板（原图自动焊成参考图）')
@@ -181,10 +198,11 @@ videoTemplatesCmd
     .description('新建视频模板——归属由账号身份自动决定：租户 apiKey 建的自动归该租户，平台管理员建的是平台共享模板，个人账号不能建')
     .requiredOption('--name <zh_name>', '模板中文名')
     .requiredOption('--prompt <template>', '提示词模板，占位符用 {key} 形式，如 "{product} 在 {scene} 中展示"')
+    .option('--slug <slug>', '对外调用标识（全局唯一，视频模板硬必填）；不传自动生成 vt- 前缀短标识')
     .option('--category <name>', '分类，默认「其他」')
     .option('--description <text>', '模板说明')
-    .option('--model <name>', '视频模型，默认 seedance-2（可选 seedance-2-fast / seedance-2-mini / artsdance-2-0-pro-260801）')
-    .option('--duration <sec>', '视频时长（秒，4-15，可选）')
+    .option('--model <name>', '视频模型档次，默认 auto（交给中台路由）；锁死可选 artsdance-2-0-pro-260801（Seedance 2.0）/ artsdance-2-0-fast-260801 / artsdance-2-0-mini-260801 / artsdance-2-5-pro-260801（Seedance 2.5）')
+    .option('--duration <sec>', '视频时长（秒，4-30：Seedance 2.0 系上限 15、2.5 到 30，可选）')
     .option('--ratio <ratio>', '画面比例: 9:16 / 16:9 / 1:1 / 3:4（可选）')
     .option('--sample-video <url>', '参考视频 URL（可选，展示给用户的示例片）')
     .option('--sample-cover <url>', '封面图 URL（可选）')

package/dist/local-vision.d.ts

@@ -0,0 +1,14 @@
+import type { ReverseResult } from './client.js';
+/** 本地读图模型。换档位用 MUSEAV_LOCAL_VLM 环境变量，不用改代码 */
+export declare const LOCAL_VLM_MODEL: string;
+export interface LocalVlmStatus {
+    running: boolean;
+    modelPresent: boolean;
+    host: string;
+    /** running=false 时的原因（给用户看的行动指引） */
+    reason?: string;
+}
+/** 探活 + 模型在位检查。3 秒探不通就是没起服务，不等推理超时才发现 */
+export declare function checkLocalVlm(): Promise<LocalVlmStatus>;
+/** 本地逆向一张图。任何失败都抛 Error，由调用方决定回落 */
+export declare function reverseLocally(filePath: string): Promise<ReverseResult>;

package/dist/local-vision.js

@@ -0,0 +1,126 @@
+/**
+ * 本地视觉模型（Ollama + qwen3-vl）—— reverse 的主路。
+ * 中台 API 逆向一次要十几秒到几十秒，本地 8b 量化模型在 Apple Silicon 上更快且零成本；
+ * API 降级为回落路（commands/reverse.ts 负责切换与提示）。
+ * 提示词与返回结构从中台 _reverse-core.js / reverse-template.js 移植，保证两条路产出同构。
+ */
+import { readFile } from 'node:fs/promises';
+import { compressForVision } from './compress.js';
+/** 本地读图模型。换档位用 MUSEAV_LOCAL_VLM 环境变量，不用改代码 */
+export const LOCAL_VLM_MODEL = process.env.MUSEAV_LOCAL_VLM || 'qwen3-vl:8b';
+const ALLOWED_RATIOS = ['3:4', '9:16', '1:1', '4:3', '16:9'];
+// OLLAMA_HOST 生态里带不带 scheme、带不带尾斜杠的写法都有
+function ollamaHost() {
+    let host = process.env.OLLAMA_HOST || 'http://localhost:11434';
+    if (!/^https?:\/\//.test(host))
+        host = `http://${host}`;
+    return host.replace(/\/+$/, '');
+}
+/** 探活 + 模型在位检查。3 秒探不通就是没起服务，不等推理超时才发现 */
+export async function checkLocalVlm() {
+    const host = ollamaHost();
+    try {
+        const resp = await fetch(`${host}/api/tags`, { signal: AbortSignal.timeout(3000) });
+        if (!resp.ok) {
+            return { running: false, modelPresent: false, host, reason: `Ollama 探活返回 HTTP ${resp.status}` };
+        }
+        const tags = (await resp.json());
+        const names = (tags.models || []).map((m) => m.name || '');
+        if (!names.includes(LOCAL_VLM_MODEL)) {
+            return { running: true, modelPresent: false, host, reason: `模型未拉取，执行: ollama pull ${LOCAL_VLM_MODEL}` };
+        }
+        return { running: true, modelPresent: true, host };
+    }
+    catch {
+        return { running: false, modelPresent: false, host, reason: `Ollama 未运行（${host}），启动: ollama serve 或 brew services start ollama` };
+    }
+}
+/** SCULPT 系统提示词 —— 从中台 reverse-template.js 移植。本地路只做纯读图，
+ *  中台提示词里的 genre / body_md（给 image-to-template 用的）在 ReverseResult 里
+ *  根本不消费，本地砍掉这两项省几百个输出 token——输出长度直接决定本地推理耗时 */
+function sculptSystemPrompt() {
+    return (`你是一位专业的 AI 图像逆向工程师。请分析这张图片，用 SCULPT 六要素框架逆推生成该图片所需的 prompt。` +
+        `严格输出 JSON，不要输出任何其他文字：\n` +
+        `{\n` +
+        `  "sculpt": {\n` +
+        `    "subject": "主体描述 — 画面中的人物/物体/场景，包括外貌、姿态、服饰",\n` +
+        `    "composition": "构图描述 — 视角、布局、留白、视觉引导线",\n` +
+        `    "universe": "世界观 — 时代背景、艺术风格、整体氛围",\n` +
+        `    "light": "光影描述 — 光源方向、色温、明暗对比、光影效果",\n` +
+        `    "print": "输出特性 — 比例、色调倾向、对比度、饱和度",\n` +
+        `    "texture": "质感描述 — 材质、表面纹理、细节精度"\n` +
+        `  },\n` +
+        `  "prompt": "整合 SCULPT 六要素后的完整英文 prompt（适合 AI 图像生成模型）",\n` +
+        `  "prompt_cn": "对应中文 prompt",\n` +
+        `  "style_tags": ["2-4 个关键风格标签"],\n` +
+        `  "aspect_ratio": "推荐比例，从 3:4|9:16|1:1|4:3|16:9 中按图片比例选一个",\n` +
+        `  "zh_name": "4-8 字风格名（供技能命名）",\n` +
+        `  "description": "一句话描述该风格"` +
+        `\n}\n要求：prompt 必须是英文，详细且精确，覆盖全部六个维度；prompt_cn 为对应中文；只输出 JSON。`);
+}
+/** 本地逆向一张图。任何失败都抛 Error，由调用方决定回落 */
+export async function reverseLocally(filePath) {
+    // 复用上传同款压缩：图小不仅传得快，本地 VLM 推理也快
+    const { buffer, note } = await compressForVision(filePath);
+    if (note)
+        process.stderr.write(`  ${note}\n`);
+    const bytes = buffer ?? (await readFile(filePath));
+    const b64 = Buffer.from(bytes).toString('base64');
+    const payload = {
+        model: LOCAL_VLM_MODEL,
+        messages: [
+            { role: 'system', content: sculptSystemPrompt() },
+            { role: 'user', content: '用 SCULPT 六要素分析这张图，逆推出图 prompt', images: [b64] },
+        ],
+        stream: false,
+    };
+    // 8b 视觉推理单张图几十秒量级，给足余量
+    const resp = await fetch(`${ollamaHost()}/api/chat`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(payload),
+        signal: AbortSignal.timeout(5 * 60 * 1000),
+    });
+    if (!resp.ok) {
+        throw new Error(`Ollama 返回 HTTP ${resp.status}: ${(await resp.text()).slice(0, 200)}`);
+    }
+    const out = (await resp.json());
+    const content = out.message?.content || '';
+    if (!content.trim())
+        throw new Error('本地模型返回空内容');
+    return normalizeSculpt(parseJsonLoose(content));
+}
+/** 视觉模型「只输出 JSON」的承诺不可信：剥 ```json 围栏、截首尾大括号 */
+function parseJsonLoose(text) {
+    let t = text.trim().replace(/^```(?:json)?\s*/i, '').replace(/\s*```$/, '');
+    const start = t.indexOf('{');
+    const end = t.lastIndexOf('}');
+    if (start >= 0 && end > start)
+        t = t.slice(start, end + 1);
+    return JSON.parse(t);
+}
+/** 与中台 basePayload 同构的归一化：超长截断、非法比例兜底 3:4 */
+function normalizeSculpt(parsed) {
+    const sculptIn = (parsed.sculpt || {});
+    const sculpt = {};
+    for (const key of ['subject', 'composition', 'universe', 'light', 'print', 'texture']) {
+        sculpt[key] = String(sculptIn[key] || '').slice(0, 500);
+    }
+    const ratio = ALLOWED_RATIOS.includes(parsed.aspect_ratio)
+        ? parsed.aspect_ratio
+        : ALLOWED_RATIOS.includes(parsed.ratio)
+            ? parsed.ratio
+            : '3:4';
+    return {
+        ok: true,
+        sculpt,
+        prompt: String(parsed.prompt || '').slice(0, 2000),
+        prompt_cn: String(parsed.prompt_cn || '').slice(0, 2000),
+        style_tags: Array.isArray(parsed.style_tags)
+            ? parsed.style_tags.slice(0, 6).map((t) => String(t).slice(0, 30))
+            : [],
+        aspect_ratio: ratio,
+        zh_name: String(parsed.zh_name || '裂变风格').slice(0, 24),
+        description: String(parsed.description || '').slice(0, 200),
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "museav-cli",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "MUSE AV 出图中台官方 CLI —— 命令行调中台 API 出图、出视频、读图逆向、图生模板",
   "type": "module",
   "bin": {

package/src/client.ts

@@ -101,7 +101,12 @@ export interface TemplateOption {
     model: string
     prompt_template: string
     ref_slots?: string[]
+    /** 表单字段声明——现行契约放 config 顶层（服务端 validateConfig 读这里） */
+    fields?: Array<{ key: string; label: string }>
+    /** 旧存法：fields 曾在 params_json 里，老模板还这么存，读时两种都要兜 */
     params_json?: { fields?: Array<{ key: string; label: string; placeholder?: string }> }
+    duration?: number
+    aspect_ratio?: string
     is_default?: boolean
   }>
 }
@@ -132,6 +137,8 @@ export interface CreateTemplateInput {
  *  ratio/duration/model 放在 generation_configs 每项里。 */
 export interface CreateVideoTemplateInput {
   zh_name: string
+  /** 对外调用标识，视频模板硬必填（服务端 validateCore required=['zh_name','slug']），全局唯一 */
+  slug: string
   category?: string
   description?: string
   sample_video_url?: string | null

package/src/commands/reverse.ts

@@ -1,11 +1,43 @@
-/** museav reverse —— 图片逆向（SCULPT 六要素反推 prompt） */
-import type { StudioClient } from '../client.js'
+/** museav reverse —— 图片逆向（SCULPT 六要素反推 prompt）。
+ *  主路是本地 Ollama（qwen3-vl），快、零成本、无需登录；中台 API 是回落路，走回落时会明确提示较慢。
+ *  client 懒构造（getClient）：本地路成功就完全不碰中台凭证。
+ *  本地系统的 AI 能力统一收口在这个 CLI，reverse 是第一个本地化的能力。 */
+import type { StudioClient, ReverseResult } from '../client.js'
+import { checkLocalVlm, reverseLocally, LOCAL_VLM_MODEL } from '../local-vision.js'
 
-export async function reverse(client: StudioClient, input: string): Promise<void> {
-  // 输入是文件路径还是 URL
+export async function reverse(
+  getClient: () => StudioClient,
+  input: string,
+  opts: { api?: boolean } = {},
+): Promise<void> {
   const isUrl = /^https?:\/\//.test(input)
+
+  if (!opts.api && !isUrl) {
+    const status = await checkLocalVlm()
+    if (status.running && status.modelPresent) {
+      try {
+        const start = Date.now()
+        const result = await reverseLocally(input)
+        process.stderr.write(`✓ 本地 Ollama（${LOCAL_VLM_MODEL}）用时 ${((Date.now() - start) / 1000).toFixed(1)}s\n`)
+        renderReverse(result)
+        return
+      } catch (e) {
+        process.stderr.write(`⚠ 本地读图失败（${e instanceof Error ? e.message : e}），回落中台 API —— 速度较慢，请耐心等待\n`)
+      }
+    } else {
+      process.stderr.write(`⚠ 本地读图不可用（${status.reason}），回落中台 API —— 速度较慢，请耐心等待\n`)
+    }
+  } else if (!opts.api && isUrl) {
+    process.stderr.write(`ℹ URL 输入走中台 API（本地路只收文件路径）\n`)
+  }
+
+  const client = getClient()
   const result = await client.reverse(isUrl ? { imageUrl: input } : { file: input })
+  renderReverse(result)
+}
 
+/** 两条路产出同构，渲染只写一份 */
+function renderReverse(result: ReverseResult): void {
   process.stderr.write(`✅ 逆向完成\n\n`)
   process.stderr.write(`风格: ${result.zh_name || '-'}  比例: ${result.aspect_ratio}\n`)
   process.stderr.write(`标签: ${result.style_tags.join(', ')}\n\n`)

package/src/commands/templates.ts

@@ -19,7 +19,8 @@ export async function templates(client: StudioClient, opts: { category?: string;
   process.stderr.write(`可用模板（${list.length} 个）:\n`)
   for (const t of list) {
     const cfg = t.generation_configs?.find((c) => c.is_default) || t.generation_configs?.[0]
-    const fields = cfg?.params_json?.fields || []
+    // fields 新契约在 config 顶层（CLI 自己 create 就写顶层），老数据在 params_json 里——两种都兜
+    const fields = cfg?.fields || cfg?.params_json?.fields || []
     const fieldHint = fields.length ? `字段:${fields.map((f) => f.key).join(',')}` : ''
     process.stderr.write(
       `  ${t.id.padEnd(38)} ${(t.zh_name || '').padEnd(16)} ${(t.category || '').padEnd(10)} ${(t.ratio || '').padEnd(6)} ${typeTag(t).padEnd(8)} ${fieldHint.padEnd(20)} ${tag(t)}\n`,

package/src/commands/video-templates.ts

@@ -19,8 +19,9 @@ export async function videoTemplates(client: StudioClient, opts: { category?: st
     const cfg = t.generation_configs?.find((c) => c.is_default) || t.generation_configs?.[0]
     const modelHint = cfg?.model ? `模型:${cfg.model}` : ''
     const ratioHint = t.ratio || ''
-    const fieldCount = cfg?.params_json?.fields?.length || 0
-    const fieldHint = fieldCount ? `字段:${cfg!.params_json!.fields!.map((f) => f.key).join(',')}` : ''
+    // fields 新契约在 config 顶层，老数据在 params_json 里——两种都兜，否则自己建的模板自己列不出来
+    const fields = cfg?.fields || cfg?.params_json?.fields || []
+    const fieldHint = fields.length ? `字段:${fields.map((f) => f.key).join(',')}` : ''
     const sampleHint = t.sample_video_url ? '有参考视频' : ''
     process.stderr.write(
       `  ${t.id.padEnd(38)} ${(t.zh_name || '').padEnd(20)} ${(t.category || '').padEnd(10)} ${ratioHint.padEnd(6)} ${modelHint.padEnd(30)} ${fieldHint.padEnd(24)} ${sampleHint.padEnd(10)} ${tag(t)}\n`,
@@ -36,6 +37,8 @@ export async function videoTemplates(client: StudioClient, opts: { category?: st
 
 interface CreateVideoTemplateOpts {
   name: string
+  /** 对外调用标识，全局唯一。不给就自动生成一个（vt- 前缀） */
+  slug?: string
   prompt: string
   category?: string
   description?: string
@@ -53,25 +56,32 @@ export async function createVideoTemplate(client: StudioClient, opts: CreateVide
   if (!opts.name?.trim()) throw new Error('--name 必填')
   if (!opts.prompt?.trim()) throw new Error('--prompt 必填，占位符用 {key} 形式，如 "{product} 在 {scene} 中展示"')
 
+  // slug 是视频模板的硬必填（服务端 required=['zh_name','slug']），漏了必 400。
+  // 中文名大多是中文没法直接转 slug，不给 --slug 就生成一个 vt- 短标识，撞了让服务端报出来再换。
+  const slug = (opts.slug || `vt-${Date.now().toString(36)}${Math.random().toString(36).slice(2, 5)}`).trim()
+  if (!/^[\w-]+$/.test(slug)) throw new Error('--slug 只能包含字母、数字、下划线和连字符')
+
   // 占位符必须声明 fields（中台 validateConfig 硬校验：prompt 里有 {key} 但没 fields 会被拒）
   const keys = Array.from(new Set(Array.from(opts.prompt.matchAll(/\{(\w+)\}/g), (m) => m[1])))
   const fields = keys.map((key) => ({ key, label: key }))
 
   const cfg: Record<string, unknown> = {
-    model: opts.model || 'seedance-2',
+    // 默认 auto：交给中台路由按 ratio/duration 挑档次。锁死具体模型得自己保证参数配得上它
+    model: opts.model || 'auto',
     prompt_template: opts.prompt,
     is_default: true,
   }
   if (fields.length) cfg.fields = fields
   if (opts.duration) {
     const d = Number(opts.duration)
-    if (!Number.isFinite(d) || d < 4 || d > 15) throw new Error('--duration 必须是 4-15 之间的数字（秒）')
+    if (!Number.isFinite(d) || d < 4 || d > 30) throw new Error('--duration 必须是 4-30 之间的数字（秒；Seedance 2.0 系上限 15，2.5 到 30，具体由中台按模型校验）')
     cfg.duration = d
   }
   if (opts.ratio) cfg.aspect_ratio = opts.ratio
 
   const row = await client.createVideoTemplate({
     zh_name: opts.name,
+    slug,
     category: opts.category,
     description: opts.description,
     sample_video_url: opts.sampleVideo || null,
@@ -80,6 +90,7 @@ export async function createVideoTemplate(client: StudioClient, opts: CreateVide
   })
 
   process.stderr.write(`✅ 视频模板已建：${row.id}\n`)
+  process.stderr.write(`slug: ${slug}\n`)
   process.stderr.write(`归属：${row.tenant_id ? '当前租户（其他租户看不到）' : '平台共享（所有租户可见）'}\n`)
   process.stderr.write(`模型: ${cfg.model} 时长: ${cfg.duration || '模板默认'} 比例: ${cfg.aspect_ratio || '模板默认'}\n`)
   if (fields.length) process.stderr.write(`占位符字段: ${fields.map((f) => f.key).join(', ')}\n`)

package/src/index.ts

@@ -93,6 +93,22 @@ function withClient<T extends (...args: any[]) => Promise<any>>(fn: T) {
   }
 }
 
+// reverse 的本地路（Ollama）不需要中台凭证，client 懒构造：只有真回落 API 才建，
+// 未登录的报错也只在那时候出现
+function withLazyClient(fn: (getClient: () => StudioClient, ...args: any[]) => Promise<any>) {
+  return async (...args: any[]) => {
+    try {
+      const opts = args[args.length - 2]
+      const positional = args.slice(0, -2)
+      const getClient = () => new StudioClient(loadConfig())
+      await fn(getClient, ...positional, opts)
+    } catch (e) {
+      process.stderr.write(`❌ ${(e as Error).message}\n`)
+      process.exit(1)
+    }
+  }
+}
+
 // products / assets 查的是租户自己后台的数据，不是 Studio 中台的，走独立的 TenantClient
 // （见 tenant-client.ts 顶部注释），只支持租户 apiKey 身份，不支持个人 login token。
 function withTenantClient<T extends (...args: any[]) => Promise<any>>(fn: T) {
@@ -127,7 +143,7 @@ program
   // 不设默认值：--skill / --template 场景下要让技能/模板自己的比例生效，
   // CLI 强填默认值会把它们覆盖掉（服务端在纯 --prompt 场景已有 3:4 兜底，这里不用重复兜底）
   .option('-r, --ratio <ratio>', '宽高比: 3:4 / 9:16 / 1:1 / 4:3 / 16:9（不指定则用技能/模板自己的比例，纯 prompt 模式兜底 3:4）')
-  .option('-m, --model <name>', '指定模型，如 gpt-image-2 / seedance-2-fast / artsdance-2-0-pro-260801')
+  .option('-m, --model <name>', '指定模型，如 gpt-image-2 / artsdance-2-0-pro-260801（视频不传则走 auto 路由）')
   .option('-q, --quality <level>', '质量: low / medium / high（仅 gpt-image）')
   // 可重复：--ref 正面.jpg --ref 背景.jpg。顺序即语义——提示词里写「参考图片1的排版、
   // 用图片2作为背景」时，图片N 对应第 N 个 --ref。commander 的 collect 保证顺序。
@@ -136,15 +152,16 @@ program
   // 透明背景是上游的 background 参数，不是提示词能表达的东西——提示词里写
   // "transparent background" 只是在描述构图，模型照样铺一层白底。这个开关才是抠图开关。
   .option('--transparent', '透明背景 PNG（抠掉背景，带 alpha 通道）。仅部分上游支持，不支持时中台明确报错、不会悄悄给白底图；服务端自动强制 PNG 输出（JPEG 没有 alpha 通道）')
-  .option('--video', '生成视频（走 /api/videos 链路，模型如 seedance-2-fast / artsdance-2-0-pro）')
+  .option('--video', '生成视频（走 /api/videos 链路；模型档次如 artsdance-2-0-pro-260801，不传 --model 走 auto 路由）')
   .option('--duration <sec>', '视频时长（秒，仅 --video；由模型与上游支持范围决定）', (v) => Number(v))
   .option('--image <file>', '图生视频首帧图（仅 --video，自动上传）')
   .action(withClient((client: StudioClient, opts: any) => gen(client, opts)))
 
 program
   .command('reverse <input>')
-  .description('读图：上传图或图片 URL，反推 SCULPT prompt，stdout 输出英文 prompt（只读图；要做成模板用 image-to-template）')
-  .action(withClient((client: StudioClient, input: string) => reverse(client, input)))
+  .description('读图：反推 SCULPT prompt，stdout 输出英文 prompt。主路本地 Ollama（qwen3-vl，快，无需登录）；本地不可用回落中台 API（会提示较慢）。只读图；要做成模板用 image-to-template')
+  .option('--api', '跳过本地 Ollama，强制走中台 API（慢，需登录）')
+  .action(withLazyClient((getClient: () => StudioClient, input: string, opts: any) => reverse(getClient, input, opts)))
 
 program
   .command('image-to-template <input>')
@@ -194,10 +211,11 @@ videoTemplatesCmd
   )
   .requiredOption('--name <zh_name>', '模板中文名')
   .requiredOption('--prompt <template>', '提示词模板，占位符用 {key} 形式，如 "{product} 在 {scene} 中展示"')
+  .option('--slug <slug>', '对外调用标识（全局唯一，视频模板硬必填）；不传自动生成 vt- 前缀短标识')
   .option('--category <name>', '分类，默认「其他」')
   .option('--description <text>', '模板说明')
-  .option('--model <name>', '视频模型，默认 seedance-2（可选 seedance-2-fast / seedance-2-mini / artsdance-2-0-pro-260801）')
-  .option('--duration <sec>', '视频时长（秒，4-15，可选）')
+  .option('--model <name>', '视频模型档次，默认 auto（交给中台路由）；锁死可选 artsdance-2-0-pro-260801（Seedance 2.0）/ artsdance-2-0-fast-260801 / artsdance-2-0-mini-260801 / artsdance-2-5-pro-260801（Seedance 2.5）')
+  .option('--duration <sec>', '视频时长（秒，4-30：Seedance 2.0 系上限 15、2.5 到 30，可选）')
   .option('--ratio <ratio>', '画面比例: 9:16 / 16:9 / 1:1 / 3:4（可选）')
   .option('--sample-video <url>', '参考视频 URL（可选，展示给用户的示例片）')
   .option('--sample-cover <url>', '封面图 URL（可选）')

package/src/local-vision.ts

@@ -0,0 +1,143 @@
+/**
+ * 本地视觉模型（Ollama + qwen3-vl）—— reverse 的主路。
+ * 中台 API 逆向一次要十几秒到几十秒，本地 8b 量化模型在 Apple Silicon 上更快且零成本；
+ * API 降级为回落路（commands/reverse.ts 负责切换与提示）。
+ * 提示词与返回结构从中台 _reverse-core.js / reverse-template.js 移植，保证两条路产出同构。
+ */
+import { readFile } from 'node:fs/promises'
+import { compressForVision } from './compress.js'
+import type { ReverseResult } from './client.js'
+
+/** 本地读图模型。换档位用 MUSEAV_LOCAL_VLM 环境变量，不用改代码 */
+export const LOCAL_VLM_MODEL = process.env.MUSEAV_LOCAL_VLM || 'qwen3-vl:8b'
+
+const ALLOWED_RATIOS = ['3:4', '9:16', '1:1', '4:3', '16:9']
+
+// OLLAMA_HOST 生态里带不带 scheme、带不带尾斜杠的写法都有
+function ollamaHost(): string {
+  let host = process.env.OLLAMA_HOST || 'http://localhost:11434'
+  if (!/^https?:\/\//.test(host)) host = `http://${host}`
+  return host.replace(/\/+$/, '')
+}
+
+export interface LocalVlmStatus {
+  running: boolean
+  modelPresent: boolean
+  host: string
+  /** running=false 时的原因（给用户看的行动指引） */
+  reason?: string
+}
+
+/** 探活 + 模型在位检查。3 秒探不通就是没起服务，不等推理超时才发现 */
+export async function checkLocalVlm(): Promise<LocalVlmStatus> {
+  const host = ollamaHost()
+  try {
+    const resp = await fetch(`${host}/api/tags`, { signal: AbortSignal.timeout(3000) })
+    if (!resp.ok) {
+      return { running: false, modelPresent: false, host, reason: `Ollama 探活返回 HTTP ${resp.status}` }
+    }
+    const tags = (await resp.json()) as { models?: Array<{ name?: string }> }
+    const names = (tags.models || []).map((m) => m.name || '')
+    if (!names.includes(LOCAL_VLM_MODEL)) {
+      return { running: true, modelPresent: false, host, reason: `模型未拉取，执行: ollama pull ${LOCAL_VLM_MODEL}` }
+    }
+    return { running: true, modelPresent: true, host }
+  } catch {
+    return { running: false, modelPresent: false, host, reason: `Ollama 未运行（${host}），启动: ollama serve 或 brew services start ollama` }
+  }
+}
+
+/** SCULPT 系统提示词 —— 从中台 reverse-template.js 移植。本地路只做纯读图，
+ *  中台提示词里的 genre / body_md（给 image-to-template 用的）在 ReverseResult 里
+ *  根本不消费，本地砍掉这两项省几百个输出 token——输出长度直接决定本地推理耗时 */
+function sculptSystemPrompt(): string {
+  return (
+    `你是一位专业的 AI 图像逆向工程师。请分析这张图片，用 SCULPT 六要素框架逆推生成该图片所需的 prompt。` +
+    `严格输出 JSON，不要输出任何其他文字：\n` +
+    `{\n` +
+    `  "sculpt": {\n` +
+    `    "subject": "主体描述 — 画面中的人物/物体/场景，包括外貌、姿态、服饰",\n` +
+    `    "composition": "构图描述 — 视角、布局、留白、视觉引导线",\n` +
+    `    "universe": "世界观 — 时代背景、艺术风格、整体氛围",\n` +
+    `    "light": "光影描述 — 光源方向、色温、明暗对比、光影效果",\n` +
+    `    "print": "输出特性 — 比例、色调倾向、对比度、饱和度",\n` +
+    `    "texture": "质感描述 — 材质、表面纹理、细节精度"\n` +
+    `  },\n` +
+    `  "prompt": "整合 SCULPT 六要素后的完整英文 prompt（适合 AI 图像生成模型）",\n` +
+    `  "prompt_cn": "对应中文 prompt",\n` +
+    `  "style_tags": ["2-4 个关键风格标签"],\n` +
+    `  "aspect_ratio": "推荐比例，从 3:4|9:16|1:1|4:3|16:9 中按图片比例选一个",\n` +
+    `  "zh_name": "4-8 字风格名（供技能命名）",\n` +
+    `  "description": "一句话描述该风格"` +
+    `\n}\n要求：prompt 必须是英文，详细且精确，覆盖全部六个维度；prompt_cn 为对应中文；只输出 JSON。`
+  )
+}
+
+/** 本地逆向一张图。任何失败都抛 Error，由调用方决定回落 */
+export async function reverseLocally(filePath: string): Promise<ReverseResult> {
+  // 复用上传同款压缩：图小不仅传得快，本地 VLM 推理也快
+  const { buffer, note } = await compressForVision(filePath)
+  if (note) process.stderr.write(`  ${note}\n`)
+  const bytes = buffer ?? (await readFile(filePath))
+  const b64 = Buffer.from(bytes).toString('base64')
+
+  const payload = {
+    model: LOCAL_VLM_MODEL,
+    messages: [
+      { role: 'system', content: sculptSystemPrompt() },
+      { role: 'user', content: '用 SCULPT 六要素分析这张图，逆推出图 prompt', images: [b64] },
+    ],
+    stream: false,
+  }
+
+  // 8b 视觉推理单张图几十秒量级，给足余量
+  const resp = await fetch(`${ollamaHost()}/api/chat`, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify(payload),
+    signal: AbortSignal.timeout(5 * 60 * 1000),
+  })
+  if (!resp.ok) {
+    throw new Error(`Ollama 返回 HTTP ${resp.status}: ${(await resp.text()).slice(0, 200)}`)
+  }
+  const out = (await resp.json()) as { message?: { content?: string } }
+  const content = out.message?.content || ''
+  if (!content.trim()) throw new Error('本地模型返回空内容')
+
+  return normalizeSculpt(parseJsonLoose(content))
+}
+
+/** 视觉模型「只输出 JSON」的承诺不可信：剥 ```json 围栏、截首尾大括号 */
+function parseJsonLoose(text: string): Record<string, unknown> {
+  let t = text.trim().replace(/^```(?:json)?\s*/i, '').replace(/\s*```$/, '')
+  const start = t.indexOf('{')
+  const end = t.lastIndexOf('}')
+  if (start >= 0 && end > start) t = t.slice(start, end + 1)
+  return JSON.parse(t) as Record<string, unknown>
+}
+
+/** 与中台 basePayload 同构的归一化：超长截断、非法比例兜底 3:4 */
+function normalizeSculpt(parsed: Record<string, unknown>): ReverseResult {
+  const sculptIn = (parsed.sculpt || {}) as Record<string, unknown>
+  const sculpt: Record<string, string> = {}
+  for (const key of ['subject', 'composition', 'universe', 'light', 'print', 'texture']) {
+    sculpt[key] = String(sculptIn[key] || '').slice(0, 500)
+  }
+  const ratio = ALLOWED_RATIOS.includes(parsed.aspect_ratio as string)
+    ? (parsed.aspect_ratio as string)
+    : ALLOWED_RATIOS.includes(parsed.ratio as string)
+      ? (parsed.ratio as string)
+      : '3:4'
+  return {
+    ok: true,
+    sculpt,
+    prompt: String(parsed.prompt || '').slice(0, 2000),
+    prompt_cn: String(parsed.prompt_cn || '').slice(0, 2000),
+    style_tags: Array.isArray(parsed.style_tags)
+      ? (parsed.style_tags as unknown[]).slice(0, 6).map((t) => String(t).slice(0, 30))
+      : [],
+    aspect_ratio: ratio,
+    zh_name: String(parsed.zh_name || '裂变风格').slice(0, 24),
+    description: String(parsed.description || '').slice(0, 200),
+  }
+}