tripo-cli 0.7.3 → 0.8.1

package/dist/knowledge/models.js

@@ -1,9 +1,9 @@
 /**
- * Dual-model strategy — the single source of truth for 3D model selection.
+ * Model routing — the single source of truth for 3D generation selection.
  *
- * Rule (one branch, no exceptions): explicit low-poly intent or a face budget
- * <= 20000 selects P1; everything else selects v3.1. Explicit --model wins but
- * still goes through constraint validation.
+ * H3.1 is the official default (flagship, highest fidelity) and also covers dense
+ * geometry and H-only parameters. Real-time, editable and topology-constrained
+ * assets route to P2.
  */
 /**
  * Wire values are what the server actually accepts (backend whitelist:
@@ -13,24 +13,28 @@
  */
 export const MODEL_V31 = 'v3.1-20260211';
 export const MODEL_P1 = 'P1-20260311';
-/** P-series upgrade (Preview): adds quad output; explicit --model only, never auto-selected. */
+/** P-series model: editable low-poly topology and quad output. */
 export const MODEL_P2 = 'P2-20260801';
-/** User-facing aliases normalized to the wire values above. */
+/** User-facing aliases normalized to the wire values above (matched case-insensitively). */
 export const MODEL_ALIASES = {
+    'H3.1': MODEL_V31,
+    'P1.0': MODEL_P1,
+    'P2.0': MODEL_P2,
+    'P2.0 Preview': MODEL_P2,
     'v3.1': MODEL_V31,
     'v3.1-20260211': MODEL_V31,
     'tripo-v3.1': MODEL_V31,
-    p1: MODEL_P1,
     P1: MODEL_P1,
     'P1-20260311': MODEL_P1,
     'tripo-p1': MODEL_P1,
-    p2: MODEL_P2,
     P2: MODEL_P2,
     'P2-20260801': MODEL_P2,
     'tripo-p2': MODEL_P2,
     // Older whitelisted versions, alias → wire.
+    'H3.0': 'v3.0-20250812',
     'v3.0': 'v3.0-20250812',
     'tripo-v3.0': 'v3.0-20250812',
+    'H2.5': 'v2.5-20250123',
     'v2.5': 'v2.5-20250123',
     'tripo-v2.5': 'v2.5-20250123',
 };
@@ -105,7 +109,6 @@ export const TEXT_TO_IMAGE_MODELS = [
     'banana',
     'banana_pro',
     'banana2',
-    'chat_image_1',
     'chat_image_1.5',
     'chat_image_2',
     'chat_image_2.5_flare',
@@ -116,7 +119,6 @@ export const IMAGE_TO_IMAGE_MODELS = [
     'banana',
     'banana_pro',
     'banana2',
-    'chat_image_1',
     'chat_image_1.5',
     'chat_image_2',
     'chat_image_2.5_flare',
@@ -161,9 +163,10 @@ export const FBX_PRESETS = ['blender', '3dsmax', 'mixamo', 'bake_scale'];
 export const EXPORT_ORIENTATIONS = ['+x', '-x', '+y', '-y'];
 /** `fast` only works with texture model v3.5 (other versions → 1004). */
 export const TEXTURE_QUALITIES = ['fast', 'standard', 'detailed', 'extreme'];
-/** Normalize any accepted alias to the canonical wire value; unknown values pass through. */
+const MODEL_ALIAS_LOOKUP = new Map(Object.entries(MODEL_ALIASES).map(([alias, wire]) => [alias.toLowerCase(), wire]));
+/** Normalize any accepted alias to the canonical wire value; unknown values pass through for validation to reject. */
 export function normalizeModel(input) {
-    return MODEL_ALIASES[input] ?? input;
+    return MODEL_ALIAS_LOOKUP.get(input.trim().toLowerCase()) ?? input;
 }
 export function isP1(model) {
     return normalizeModel(model) === MODEL_P1;
@@ -171,21 +174,117 @@ export function isP1(model) {
 export function isP2(model) {
     return normalizeModel(model) === MODEL_P2;
 }
-/** The one rule. Returns the model plus a human-readable reason. */
+function hRequirement(intent) {
+    const params = intent.params ?? {};
+    const quad = intent.quad === true || params.quad === true;
+    if (intent.denseGeometry)
+        return 'dense geometry';
+    if (params.geometry_quality !== undefined)
+        return 'geometry_quality';
+    if (params.smart_low_poly === true)
+        return 'smart_low_poly';
+    if (params.generate_parts === true)
+        return 'generate_parts';
+    if (typeof intent.faceLimit === 'number' && intent.faceLimit > (quad ? P2_FACE_LIMIT.quadMax : P2_FACE_LIMIT.triMax)) {
+        return `face budget exceeds P2 ${quad ? 'quad' : 'triangle'} limit`;
+    }
+    if (typeof intent.faceLimit === 'number' && intent.faceLimit > 0 && intent.faceLimit < P2_FACE_LIMIT.min) {
+        return 'face budget below P2 minimum';
+    }
+    return undefined;
+}
+/** Select a generation model from explicit choice, geometry requirements and intended use. */
 export function chooseModel(intent) {
-    if (intent.explicit) {
-        return { model: normalizeModel(intent.explicit), reason: 'explicit --model' };
+    const paramModel = typeof intent.params?.model === 'string' ? intent.params.model : undefined;
+    const explicit = intent.explicit ?? paramModel;
+    if (explicit) {
+        return {
+            model: normalizeModel(explicit),
+            reason: intent.explicit ? 'explicit --model' : 'explicit model parameter',
+        };
+    }
+    const hOnly = hRequirement(intent);
+    if (hOnly) {
+        return { model: MODEL_V31, reason: `${hOnly} → v3.1` };
     }
-    if (intent.lowPoly) {
-        return { model: MODEL_P1, reason: 'low-poly intent → P1' };
+    if (intent.preferred) {
+        const preferred = normalizeModel(intent.preferred);
+        if (preferred !== MODEL_P1)
+            return { model: preferred, reason: 'scenario preference' };
     }
-    if (intent.faceLimit !== undefined && intent.faceLimit <= P1_FACE_LIMIT.max) {
-        return { model: MODEL_P1, reason: `face budget ${intent.faceLimit} ≤ ${P1_FACE_LIMIT.max} → P1` };
+    const params = intent.params ?? {};
+    if (intent.lowPoly || intent.realtime || intent.editable || intent.quad === true || params.quad === true || intent.faceLimit !== undefined) {
+        return { model: MODEL_P2, reason: 'real-time or editable topology → P2' };
     }
-    return { model: MODEL_V31, reason: 'default high-fidelity → v3.1' };
+    return { model: MODEL_V31, reason: 'official default → v3.1' };
+}
+/**
+ * Official list price per generation task in credits, identical on the ov and cn
+ * model pages. Tiers: [no texture, standard/fast, detailed, extreme]. P1 and the
+ * legacy models publish no price, so they are never estimated.
+ */
+const GENERATION_CREDITS = {
+    [MODEL_V31]: {
+        text_to_model: [10, 20, 30, 40],
+        image_to_model: [20, 30, 40, 50],
+        multiview_to_model: [20, 30, 40, 50],
+    },
+    [MODEL_P2]: {
+        text_to_model: [100, 110, 120, 130],
+        image_to_model: [100, 110, 120, 130],
+        multiview_to_model: [100, 110, 120, 130],
+    },
+};
+/** List-price credits for one generation task from its validated payload; undefined when no price is published. */
+export function estimateGenerationCredits(model, taskType, params) {
+    const wire = normalizeModel(model);
+    const tiers = GENERATION_CREDITS[wire]?.[taskType];
+    if (!tiers)
+        return undefined;
+    let credits = tiers[params.texture === false ? 0 : params.texture_quality === 'extreme' ? 3 : params.texture_quality === 'detailed' ? 2 : 1];
+    if (wire === MODEL_V31) {
+        if (params.geometry_quality === 'detailed')
+            credits += 20;
+        if (params.quad === true)
+            credits += 5;
+        if (params.smart_low_poly === true)
+            credits += 10;
+        if (params.generate_parts === true)
+            credits += 20;
+    }
+    return credits;
 }
 /** Keywords that signal low-poly intent in a prompt (used by make/ai). */
 const LOW_POLY_HINTS = [/low[\s_-]?poly/i, /低模/, /低面/, /低多边形/, /手游/, /voxel/i, /像素风/];
+/** Physical games, product nouns (gaming PC, console) and animation *styles* are not real-time intent. */
+const REALTIME_HINTS = [
+    /\b(?:(?<!\b(?:board|card|tabletop|dice|party)[\s_-]?)games?|gameplay|real[\s_-]?time|unity|unreal(?:\s+engine)?|godot|three\.?js|webgl)\b/i,
+    /\b(?:editable|edit[\s_-]?friendly|topology|retopo(?:logy)?|quad(?:s)?|rig(?:[\s_-]?ready|ged|ging)?|animat(?:e|ions?)(?![\s_-]?styl))\b/i,
+    /(?<!棋盘|桌面)游戏|手游|端游|实时|引擎|可编辑|可修改|拓扑|重拓扑|四边面|四边形|绑定|骨骼|动画(?![风片])|虚幻/,
+];
+const DENSE_GEOMETRY_HINTS = [
+    /\b(?:dense|high[\s_-]?density|high[\s_-]?detail(?:ed)?)\s+(?:mesh|geometry|topology)\b/i,
+    /\bhigh[\s_-]?poly(?:gon(?:al)?)?\b/i,
+    /\bnanite\b/i,
+    /\b(?:million|millions)\s+of\s+(?:faces|triangles|polygons)\b/i,
+    /高模|高面数|高多边形|高密度(?:网格|几何)|密集(?:网格|几何)|稠密(?:网格|几何)|高精度(?:网格|几何)|百万(?:面|三角面)/,
+];
 export function detectLowPolyIntent(text) {
     return LOW_POLY_HINTS.some((re) => re.test(text));
 }
+/** Detect uses that benefit from P-series topology without treating visual quality as mesh density. */
+export function detectRealtimeIntent(text) {
+    return REALTIME_HINTS.some((re) => re.test(text));
+}
+/** Detect only explicit dense-geometry requirements; phrases such as "high quality" do not match. */
+export function detectDenseGeometryIntent(text) {
+    // Match each mention independently: negating one must not hide a later positive requirement.
+    return DENSE_GEOMETRY_HINTS.some((re) => Array.from(text.matchAll(new RegExp(re.source, `${re.flags}g`))).some((match) => {
+        const before = text.slice(0, match.index);
+        const after = text.slice(match.index + match[0].length);
+        const negatedBefore = /(?:\b(?:no|not|without|avoid|exclude)\s+(?:(?:a|an|any|the)\s+)?|\b(?:do\s+not|don't|does\s+not|doesn't)\s+(?:need|want|require|use)\s+(?:(?:a|an|any|the)\s+)?|\bno\s+need\s+for\s+(?:(?:a|an|any|the)\s+)?|(?:不要|不需要|无需|不用|不使用|避免|非)\s*)$/i.test(before);
+        const negatedAfter = /^\s*(?:(?:mesh|geometry|topology)\s+)?(?:is\s+not|isn't|not)\s+(?:needed|required|wanted)\b/i.test(after)
+            || /^\s*(?:不需要|不要|无需)/.test(after);
+        return !negatedBefore && !negatedAfter;
+    }));
+}

package/dist/knowledge/params.js

@@ -5,14 +5,96 @@
  * Every rule here prevents a guaranteed 400 or a silently wasted credit.
  * Rules marked [hard] mirror server enforcement; [soft] are CLI smart defaults.
  */
-import { CONVERT_FORMATS, DECIMATE_MODELS, EXPORT_ORIENTATIONS, FBX_PRESETS, MODEL_P2, P1_FACE_LIMIT, P1_FORBIDDEN_PARAMS, P2_FACE_LIMIT, P2_FORBIDDEN_PARAMS, TEXTURE_FORMATS, TEXTURE_MODEL_V35, TEXTURE_QUALITIES, isP1, isP2, normalizeModel, } from './models.js';
+import { CAPABILITY_DEFAULTS, IMAGE_TO_IMAGE_MODELS, TEXT_TO_IMAGE_MODELS, CONVERT_FORMATS, DECIMATE_MODELS, EXPORT_ORIENTATIONS, FBX_PRESETS, LEGACY_3D_MODELS, MODEL_P1, MODEL_P2, MODEL_V31, P1_FACE_LIMIT, P1_FORBIDDEN_PARAMS, P2_FACE_LIMIT, P2_FORBIDDEN_PARAMS, TEXTURE_FORMATS, TEXTURE_MODEL_V35, TEXTURE_QUALITIES, isP1, isP2, normalizeModel, } from './models.js';
 const PROMPT_MAX = 1024;
 const NEGATIVE_PROMPT_MAX = 255;
+/** Image endpoint contracts; never silently substitute a paid model. */
+export function validateImageParams(input, editing) {
+    const params = { ...input };
+    const warnings = [];
+    const errors = [];
+    const model = params.model === undefined
+        ? (editing ? CAPABILITY_DEFAULTS.imageToImage : CAPABILITY_DEFAULTS.textToImage)
+        : params.model;
+    params.model = model;
+    const models = editing ? IMAGE_TO_IMAGE_MODELS : TEXT_TO_IMAGE_MODELS;
+    if (model === 'chat_image_1') {
+        errors.push('model chat_image_1 retired on 2026-10-23; explicitly choose chat_image_2 or chat_image_2.5_flare/sunburst (no automatic resubmission)');
+    }
+    else if (!models.includes(model)) {
+        errors.push(`unsupported image model "${String(model)}" for ${editing ? 'image-to-image' : 'text-to-image'}`);
+    }
+    const chat25 = model === 'chat_image_2.5_flare' || model === 'chat_image_2.5_sunburst';
+    if (params.size !== undefined && typeof model === 'string' && !validImageSize(model, params.size)) {
+        errors.push(`size is unsupported for model ${model}`);
+    }
+    if ((model === 'seedream_v4' || model === 'seedream_v5') && typeof params.size === 'string' && params.size.includes('x')) {
+        warnings.push('Seedream exact pixel-count limits unverified: official MP ranges are rounded; server validation still applies');
+    }
+    if (params.quality !== undefined) {
+        const qualities = chat25 ? ['low', 'medium', 'high', 'xhigh', 'max']
+            : model === 'chat_image_2' ? ['low', 'medium', 'high'] : [];
+        if (!qualities.includes(params.quality))
+            errors.push(`quality is unsupported for model ${String(model)} (auto is not supported)`);
+    }
+    if (params.output_format !== undefined && !['png', 'jpeg'].includes(params.output_format)) {
+        errors.push('output_format must be png or jpeg');
+    }
+    if (params.background !== undefined) {
+        if (!chat25) {
+            delete params.background;
+            warnings.push('background is ignored outside chat_image_2.5 models (removed)');
+        }
+        else if (!['auto', 'opaque', 'transparent'].includes(params.background)) {
+            errors.push('background must be auto, opaque or transparent');
+        }
+        else if (params.background === 'transparent' && params.output_format !== undefined && params.output_format !== 'png') {
+            errors.push('background=transparent requires output_format=png');
+        }
+    }
+    return { params, warnings, errors };
+}
+/** Only documented size rules; rounded Seedream MP limits are not exact pixel thresholds. */
+function validImageSize(model, size) {
+    if (typeof size !== 'string')
+        return false;
+    const match = /^([1-9]\d*)x([1-9]\d*)$/.exec(size);
+    const w = Number(match?.[1]);
+    const h = Number(match?.[2]);
+    const pixels = !!match && Number.isSafeInteger(w) && Number.isSafeInteger(h);
+    if (model === 'banana') {
+        return ['1024x1024', '832x1248', '1248x832', '864x1184', '1184x864', '896x1152', '1152x896', '768x1344', '1344x768', '1536x672'].includes(size);
+    }
+    if (model === 'banana2')
+        return ['0.5K', '1K', '2K', '4K'].includes(size);
+    if (model === 'banana_pro')
+        return ['1K', '2K', '4K'].includes(size) || pixels;
+    if (model === 'seedream_v4' || model === 'seedream_v5') {
+        return ['2K', model === 'seedream_v5' ? '3K' : '4K'].includes(size) || (pixels && w / h >= 1 / 16 && w / h <= 16);
+    }
+    if (model === 'chat_image_1.5')
+        return ['1024x1024', '1024x1536', '1536x1024', 'auto'].includes(size);
+    if (model === 'chat_image_2' || model.startsWith('chat_image_2.5_')) {
+        return size === 'auto' || (pixels && w <= 3840 && h <= 3840 && w % 16 === 0 && h % 16 === 0 &&
+            Math.max(w, h) <= 3 * Math.min(w, h) && w * h >= 655360 && w * h <= 8294400);
+    }
+    return true; // Unknown models are rejected separately.
+}
+function validateFaceLimit(params, errors) {
+    if (params.face_limit !== undefined &&
+        (typeof params.face_limit !== 'number' || !Number.isFinite(params.face_limit) || !Number.isInteger(params.face_limit))) {
+        errors.push('face_limit must be a finite integer');
+    }
+}
 /** Validate + auto-fix parameters for 3D generation (text/image/multiview-to-model). */
 export function validateGenerationParams(model, input) {
     const params = { ...input };
     const warnings = [];
     const errors = [];
+    if (![MODEL_V31, MODEL_P1, MODEL_P2, ...LEGACY_3D_MODELS].includes(normalizeModel(model))) {
+        errors.push(`unsupported 3D model "${model}"`);
+    }
+    validateFaceLimit(params, errors);
     if (typeof params.prompt === 'string' && params.prompt.length > PROMPT_MAX) {
         errors.push(`prompt exceeds ${PROMPT_MAX} characters (${params.prompt.length})`);
     }
@@ -44,6 +126,11 @@ export function validateGenerationParams(model, input) {
         params.texture = true;
         warnings.push('pbr=true forces texture=true (adjusted)');
     }
+    // [hard] pbr defaults to true server-side, so texture=false alone would still be textured.
+    if (params.texture === false && params.pbr === undefined) {
+        params.pbr = false;
+        warnings.push('texture=false implies pbr=false (adjusted)');
+    }
     // [hard] generate_parts outputs bare geometry: texture/pbr/quad must be off
     // (texture and pbr default to true server-side, so omitting them counts as on).
     if (params.generate_parts === true) {
@@ -60,7 +147,7 @@ export function validateGenerationParams(model, input) {
         if (typeof face === 'number') {
             if (face < P1_FACE_LIMIT.min || face > P1_FACE_LIMIT.max) {
                 errors.push(`P1 face_limit must be within ${P1_FACE_LIMIT.min}–${P1_FACE_LIMIT.max} (got ${face}); ` +
-                    `use tripo-v3.1 for higher budgets`);
+                    `use tripo-v3.1 for budgets outside this range`);
             }
         }
     }
@@ -72,7 +159,7 @@ export function validateGenerationParams(model, input) {
             const max = quad ? P2_FACE_LIMIT.quadMax : P2_FACE_LIMIT.triMax;
             if (face < P2_FACE_LIMIT.min || face > max) {
                 errors.push(`P2 face_limit must be within ${P2_FACE_LIMIT.min}–${max}${quad ? ' with quad=true' : ''} (got ${face}); ` +
-                    `use tripo-v3.1 for higher budgets`);
+                    `use tripo-v3.1 for budgets outside this range`);
             }
         }
     }
@@ -85,10 +172,6 @@ export function validateGenerationParams(model, input) {
             }
         }
     }
-    if (params.texture_quality !== undefined &&
-        !TEXTURE_QUALITIES.includes(params.texture_quality)) {
-        errors.push(`texture_quality must be one of ${TEXTURE_QUALITIES.join('/')}`);
-    }
     applyTextureV35(params, 'texture_version', warnings, errors);
     // [hard] quad topology cannot be stored in GLB → output will be FBX.
     if (params.quad === true) {
@@ -103,6 +186,9 @@ export function validateGenerationParams(model, input) {
  * generation endpoints and `model` on /v3/models/texture.
  */
 export function applyTextureV35(params, key, warnings, errors) {
+    if (params.texture_quality !== undefined && !TEXTURE_QUALITIES.includes(params.texture_quality)) {
+        errors.push(`texture_quality must be one of ${TEXTURE_QUALITIES.join('/')}`);
+    }
     const feature = params.texture_quality === 'fast' ? 'texture_quality=fast' : params.delight !== undefined ? 'delight' : undefined;
     if (!feature)
         return;
@@ -123,6 +209,7 @@ export function validateConvertParams(input) {
     const params = { ...input };
     const warnings = [];
     const errors = [];
+    validateFaceLimit(params, errors);
     const format = typeof params.format === 'string' ? params.format.toUpperCase() : undefined;
     if (!format) {
         errors.push(`convert requires format (${CONVERT_FORMATS.join('/')})`);
@@ -199,6 +286,7 @@ export function validateDecimateParams(input) {
     const params = { ...input };
     const warnings = [];
     const errors = [];
+    validateFaceLimit(params, errors);
     const model = typeof params.model === 'string' ? params.model.toLowerCase() : undefined;
     if (model !== undefined && model !== 'default' && !DECIMATE_MODELS.includes(model)) {
         errors.push(`decimate model must be ${DECIMATE_MODELS.join('/')} (got "${String(params.model)}")`);
@@ -207,7 +295,7 @@ export function validateDecimateParams(input) {
     if (params.smart_uv === true) {
         if (model === undefined) {
             params.model = 'v3.0';
-            warnings.push('smart_uv requires decimate v3.0: using model=v3.0 (35 credits tri / 40 quad; v2.0 is 30)');
+            warnings.push('smart_uv requires decimate v3.0: using model=v3.0 (cost not estimated; check current regional pricing)');
         }
         else if (model !== 'v3.0') {
             errors.push(`smart_uv only works with decimate model v3.0 (got "${String(params.model)}")`);

package/dist/knowledge/scenarios.js

@@ -2,105 +2,82 @@
  * Scenario decision matrix: --for presets and the AI wizard both read this
  * table. Changing production strategy means editing data here, not logic.
  */
-import { CAPABILITY_DEFAULTS, MODEL_P1, MODEL_V31 } from './models.js';
+import { CAPABILITY_DEFAULTS, MODEL_P2, MODEL_V31 } from './models.js';
 export const SCENARIOS = [
     {
         id: 'game-mobile',
-        label: { zh: '手游/低模', en: 'Mobile game / low-poly' },
-        description: { zh: '移动端游戏资产,面数预算严格,干净拓扑', en: 'Mobile game assets with strict face budgets and clean topology' },
-        model: MODEL_P1,
+        label: 'Mobile game / low-poly',
+        description: 'Mobile game assets with strict face budgets and clean topology',
+        model: MODEL_P2,
         genParams: { texture: true, pbr: true, texture_quality: 'standard', face_limit: 15000 },
         chain: [{ step: 'convert', args: { format: 'FBX', texture_size: 2048 } }],
         deliverables: ['FBX', 'GLB'],
-        notes: {
-            zh: ['P1 原生低模,拓扑干净', '2K 贴图适配移动端', '需要骨骼时追加 --then rig'],
-            en: ['P1 native low-poly with clean topology', '2K textures for mobile budgets', 'append --then rig if you need a skeleton'],
-        },
+        notes: ['P2 editable low-poly topology', '2K textures for mobile budgets', 'P2 costs more credits than H/P1; check credits before running', 'append --then rig if you need a skeleton'],
     },
     {
         id: 'game-pc',
-        label: { zh: '端游/主机', en: 'PC / console game' },
-        description: { zh: '高预算引擎资产,PBR 全开', en: 'High-budget engine assets with full PBR' },
-        model: MODEL_V31,
+        label: 'PC / console game',
+        description: 'Editable real-time engine assets with full PBR',
+        model: MODEL_P2,
         genParams: { texture: true, pbr: true, texture_quality: 'detailed' },
         chain: [{ step: 'convert', args: { format: 'FBX' } }],
         deliverables: ['FBX', 'GLTF'],
-        notes: {
-            zh: ['v3.1 高精度 + detailed 贴图', '需要 LOD 时追加 --then decimate:5000', '进 Blender/3dsMax 用 fbx_preset 对齐'],
-            en: ['v3.1 high fidelity + detailed textures', 'append --then decimate:5000 for LODs', 'use fbx_preset to match Blender/3dsMax'],
-        },
+        notes: ['P2 editable topology + detailed textures', 'append --then decimate:5000 for LODs', 'P2 costs more credits than H/P1; check credits before running', 'use fbx_preset to match Blender/3dsMax'],
     },
     {
         id: 'film',
-        label: { zh: '影视/离线渲染', en: 'Film / offline rendering' },
-        description: { zh: '细分友好四边面,规格拉满', en: 'Subdivision-friendly quads, maximum quality' },
+        label: 'Film / offline rendering',
+        description: 'Subdivision-friendly quads, maximum quality',
         model: MODEL_V31,
         genParams: { texture: true, pbr: true, quad: true, geometry_quality: 'detailed', texture_quality: 'detailed' },
         chain: [],
         deliverables: ['FBX (quad)', 'USDZ/OBJ via convert'],
-        notes: {
-            zh: ['quad=true 输出 FBX(quad 进不了 GLB)', 'geometry detailed 加收 HD credit', '进 USD 管线追加 --then convert:usdz'],
-            en: ['quad=true outputs FBX (quads cannot be stored in GLB)', 'geometry detailed bills an extra HD credit', 'append --then convert:usdz for USD pipelines'],
-        },
+        notes: ['quad=true outputs FBX (quads cannot be stored in GLB)', 'geometry detailed bills an extra HD credit', 'append --then convert:usdz for USD pipelines'],
     },
     {
         id: 'print',
-        label: { zh: '3D 打印', en: '3D printing' },
-        description: { zh: '水密可打印几何,免贴图省积分', en: 'Watertight printable geometry, skipping textures saves credits' },
+        label: '3D printing',
+        description: 'Watertight printable geometry, skipping textures saves credits',
         model: MODEL_V31,
         genParams: { texture: false, pbr: false },
         chain: [{ step: 'convert', args: { format: 'STL', flatten_bottom: true } }],
-        deliverables: ['STL', '3MF (colored)'],
-        notes: {
-            zh: ['白模生成,不花贴图积分', 'flatten_bottom 平底利于 FDM', '彩色打印改 --then convert:3mf,export_vertex_colors=true'],
-            en: ['bare geometry: no texture credits spent', 'flatten_bottom helps FDM adhesion', 'for color prints use --then convert:3mf,export_vertex_colors=true'],
-        },
+        deliverables: ['STL'],
+        notes: ['bare geometry: no texture credits spent', 'flatten_bottom helps FDM adhesion', 'for color prints add -p texture=true and --then convert:format=OBJ,export_vertex_colors=true (API 3MF output is single color)'],
     },
     {
         id: 'ar-web',
-        label: { zh: 'AR/Web/电商', en: 'AR / Web / e-commerce' },
-        description: { zh: '移动端性能预算,glb+usdz 双交付', en: 'Mobile performance budgets with dual glb+usdz delivery' },
-        model: MODEL_V31,
-        genParams: { texture: true, pbr: true },
-        chain: [
-            { step: 'decimate', args: { face_limit: 20000 } },
-            { step: 'convert', args: { format: 'USDZ' } },
-        ],
+        label: 'AR / Web / e-commerce',
+        description: 'Mobile performance budgets with dual glb+usdz delivery',
+        model: MODEL_P2,
+        genParams: { texture: true, pbr: true, face_limit: 20000 },
+        chain: [{ step: 'convert', args: { format: 'USDZ' } }],
+        downloadGeneration: true,
         deliverables: ['GLB', 'USDZ'],
-        notes: {
-            zh: ['v3.1 生成后减面到 2 万内', 'iOS QuickLook 需要 USDZ', 'decimate 默认 bake 烘焙贴图到低模'],
-            en: ['generate with v3.1, then decimate under 20k faces', 'iOS QuickLook requires USDZ', 'decimate bakes textures onto the low-poly by default'],
-        },
+        notes: ['P2 generates under 20k faces directly (no decimate step)', 'iOS QuickLook requires USDZ', 'P2 costs more credits than H/P1; check credits before running', 'downloads both the generated GLB and the USDZ'],
     },
     {
         id: 'anim',
-        label: { zh: '角色动画', en: 'Character animation' },
-        description: { zh: '绑骨+动作重定向全链路', en: 'Full rig + retarget pipeline' },
-        model: MODEL_V31,
+        label: 'Character animation',
+        description: 'Full rig + retarget pipeline',
+        model: MODEL_P2,
         genParams: { texture: true, pbr: true },
         chain: [
             { step: 'rig-check', args: {} },
-            { step: 'rig', args: { model: CAPABILITY_DEFAULTS.rig, spec: 'tripo', out_format: 'glb' } },
+            { step: 'rig', args: { model: CAPABILITY_DEFAULTS.rig, out_format: 'glb' } },
             { step: 'retarget', args: { animations: ['preset:idle', 'preset:walk'] } },
         ],
         deliverables: ['GLB', 'FBX'],
-        notes: {
-            zh: ['先 rig-check 预检,不可绑骨即止损', '接 Mixamo 用 rig:spec=mixamo,Unity Humanoid / Unreal 用 spec=unity / spec=unreal', '提示词建议 T-pose 站姿,或先 text-to-image template=t_pose'],
-            en: ['rig-check first: stop early if not riggable', 'use rig:spec=mixamo for Mixamo, spec=unity / spec=unreal for Unity Humanoid / Unreal', 'prompt for a T-pose, or pre-generate with text-to-image template=t_pose'],
-        },
+        notes: ['P2 costs more credits than H/P1; check credits before running', 'rig-check first: stop early if not riggable', 'use rig:spec=mixamo for Mixamo, spec=unity / spec=unreal for Unity Humanoid / Unreal', 'prompt for a T-pose, or pre-generate with text-to-image template=t_pose'],
     },
     {
         id: 'toy',
-        label: { zh: '风格化摆件', en: 'Stylized toy / desk piece' },
-        description: { zh: '低模可爱风摆件', en: 'Cute low-poly desk piece' },
-        model: MODEL_P1,
+        label: 'Stylized toy / desk piece',
+        description: 'Cute low-poly desk piece',
+        model: MODEL_P2,
         genParams: { texture: true, pbr: true, face_limit: 20000 },
         chain: [],
         deliverables: ['GLB', 'STL via convert'],
-        notes: {
-            zh: ['P1 出干净低模', '要打印实物追加 --then convert:stl'],
-            en: ['P1 produces clean low-poly', 'append --then convert:stl to print it'],
-        },
+        notes: ['P2 produces editable low-poly', 'P2 costs more credits than H/P1; check credits before running', 'append --then convert:stl to print it'],
     },
 ];
 const byId = new Map(SCENARIOS.map((s) => [s.id, s]));