tripo-cli 0.7.3 → 0.8.0

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]));

package/dist/pipeline/make.js

@@ -1,22 +1,38 @@
 /**
  * The `make` orchestrator — one entry point that turns any input (text /
  * image / multiview / model file / task ref) into finished artifacts,
- * applying the dual-model rule, scenario presets, and the processing chain.
+ * applying model routing, scenario presets, and the processing chain.
  * Shared by `tripo make`, `tripo ai`, `tripo redo`, batch, and the MCP server.
  */
 import { basename } from 'node:path';
 import { UsageError } from '../core/errors.js';
 import { log, warn } from '../core/output.js';
-import { buildImageToModel, buildMultiviewToModel, buildStepRequest, buildTextToModel, } from '../core/requests.js';
+import { buildImageToModel, buildMultiviewToModel, buildStepRequest, buildTextToModel, validateChainRequests, } from '../core/requests.js';
 import { precheckBalance, resolveInputValue, runTask } from '../core/task-service.js';
-import { t } from '../i18n.js';
 import { validateChain, ChainError } from '../knowledge/chains.js';
-import { chooseModel, detectLowPolyIntent } from '../knowledge/models.js';
+import { chooseModel, detectDenseGeometryIntent, detectLowPolyIntent, detectRealtimeIntent } from '../knowledge/models.js';
 import { getScenario } from '../knowledge/scenarios.js';
 import { classifyInputs } from '../util/input-detect.js';
 import { runChain, assertSourceReady } from './runner.js';
-/** Build the full plan (no network calls except none): what model, what chain, why. */
+function chooseGenerationModel(options, scenario, genParams, prompt) {
+    return chooseModel({
+        explicit: options.model,
+        preferred: scenario?.model,
+        faceLimit: typeof genParams.face_limit === 'number' ? genParams.face_limit : undefined,
+        quad: genParams.quad === true,
+        lowPoly: prompt ? detectLowPolyIntent(prompt) : false,
+        realtime: prompt ? detectRealtimeIntent(prompt) : false,
+        denseGeometry: prompt ? detectDenseGeometryIntent(prompt) : false,
+        params: genParams,
+    });
+}
+/** Validate the entire plan without side effects before resolving uploads. */
 export async function planMake(client, options) {
+    const preview = await prepareMake(client, { ...options, dryRun: true });
+    checkPlanChain(preview);
+    return options.dryRun ? preview : prepareMake(client, options);
+}
+async function prepareMake(client, options) {
     const classified = classifyInputs(options.inputs);
     const scenario = options.scenario ? getScenario(options.scenario) : undefined;
     if (options.scenario && !scenario) {
@@ -25,25 +41,21 @@ export async function planMake(client, options) {
     const userParams = options.params ?? {};
     const genParams = { ...(scenario?.genParams ?? {}), ...userParams };
     const chain = options.chain && options.chain.length > 0 ? options.chain : (scenario?.chain ?? []);
+    // --then replaces the scenario chain, so its dual-delivery promise no longer holds.
+    const downloadGeneration = scenario?.downloadGeneration === true && !(options.chain && options.chain.length > 0);
     const warnings = [];
     if (options.chain && options.chain.length > 0 && scenario && scenario.chain.length > 0) {
-        warnings.push(t({
-            zh: `--then 覆盖了 ${scenario.id} 场景默认加工链`,
-            en: `--then overrides the default ${scenario.id} processing chain`,
-        }));
+        warnings.push(`--then overrides the default ${scenario.id} processing chain`);
     }
     switch (classified.kind) {
         case 'text': {
             const prompt = classified.values[0].value;
-            const choice = chooseModel({
-                explicit: options.model ?? scenario?.model,
-                faceLimit: typeof genParams.face_limit === 'number' ? genParams.face_limit : undefined,
-                lowPoly: detectLowPolyIntent(prompt),
-            });
+            const choice = chooseGenerationModel(options, scenario, genParams, prompt);
             const generation = buildTextToModel(prompt, choice.model, genParams);
             return {
                 generation,
                 chain,
+                downloadGeneration,
                 model: choice.model,
                 modelReason: choice.reason,
                 name: options.name ?? prompt,
@@ -54,14 +66,12 @@ export async function planMake(client, options) {
         case 'url-image': {
             const raw = classified.values[0].value;
             const { value } = await resolveInputValue(client, raw, { dryRun: options.dryRun });
-            const choice = chooseModel({
-                explicit: options.model ?? scenario?.model,
-                faceLimit: typeof genParams.face_limit === 'number' ? genParams.face_limit : undefined,
-            });
+            const choice = chooseGenerationModel(options, scenario, genParams);
             const generation = buildImageToModel(value, choice.model, genParams);
             return {
                 generation,
                 chain,
+                downloadGeneration,
                 model: choice.model,
                 modelReason: choice.reason,
                 name: options.name ?? basename(raw),
@@ -70,14 +80,12 @@ export async function planMake(client, options) {
         }
         case 'multiview': {
             const views = await assignViews(client, classified.values.map((v) => v.value), { dryRun: options.dryRun });
-            const choice = chooseModel({
-                explicit: options.model ?? scenario?.model,
-                faceLimit: typeof genParams.face_limit === 'number' ? genParams.face_limit : undefined,
-            });
+            const choice = chooseGenerationModel(options, scenario, genParams);
             const generation = buildMultiviewToModel(views, choice.model, genParams);
             return {
                 generation,
                 chain,
+                downloadGeneration,
                 model: choice.model,
                 modelReason: choice.reason,
                 name: options.name ?? basename(classified.values[0].value),
@@ -89,10 +97,7 @@ export async function planMake(client, options) {
             const { value } = await resolveInputValue(client, raw, { dryRun: options.dryRun });
             const generation = buildStepRequest('import', value, {});
             if (chain.length === 0) {
-                warnings.push(t({
-                    zh: '导入模型后没有加工步骤;用 --then 指定(如 --then texture,rig)',
-                    en: 'importing a model with no processing steps; add --then (e.g. --then texture,rig)',
-                }));
+                warnings.push('importing a model with no processing steps; add --then (e.g. --then texture,rig)');
             }
             return {
                 generation,
@@ -121,6 +126,7 @@ export async function planMake(client, options) {
  * Skipped when the upstream type is unknown (raw task id without local history).
  */
 export function checkPlanChain(plan) {
+    validateChainRequests(plan.chain);
     if (plan.chain.length === 0)
         return;
     const upstream = plan.generation?.taskType ?? plan.sourceType;
@@ -147,7 +153,7 @@ export async function executeMake(client, plan, options) {
     let primary;
     if (plan.generation) {
         if (plan.model && plan.modelReason) {
-            log(t({ zh: `模型选择:${plan.model}(${plan.modelReason})`, en: `model: ${plan.model} (${plan.modelReason})` }));
+            log(`model: ${plan.model} (${plan.modelReason})`);
         }
         primary = await runTask({
             client,
@@ -156,10 +162,11 @@ export async function executeMake(client, plan, options) {
             name: plan.name,
             outDir: options.outDir,
             noWait: options.noWait,
-            noDownload: options.noDownload || plan.chain.length > 0,
+            noDownload: options.noDownload || (plan.chain.length > 0 && !plan.downloadGeneration),
             timeoutMs: options.timeoutMs,
             notify: options.notify && plan.chain.length === 0,
             precheckBalance: false,
+            onCreated: options.onTaskCreated,
         });
         if (options.noWait)
             return { primary, chainResults: [] };
@@ -183,6 +190,7 @@ export async function executeMake(client, plan, options) {
         outDir: options.outDir,
         notify: false,
         timeoutMs: options.timeoutMs,
+        onTaskCreated: options.onTaskCreated,
     });
     // If the chain stopped early (not riggable) and no step downloaded a model,
     // fetch the source artifacts so the user still gets their model.

package/dist/pipeline/runner.js

@@ -5,14 +5,14 @@
  */
 import { UsageError } from '../core/errors.js';
 import { log, warn } from '../core/output.js';
-import { buildStepRequest } from '../core/requests.js';
+import { buildStepRequest, validateChainRequests } from '../core/requests.js';
 import { runTask } from '../core/task-service.js';
-import { t } from '../i18n.js';
 import { getStep, validateChain } from '../knowledge/chains.js';
 import { NON_BIPED_PRESETS } from '../knowledge/models.js';
 export async function runChain(options) {
     const { client, chain } = options;
     validateChain(chain, options.sourceType);
+    validateChainRequests(chain);
     const results = [];
     let currentTaskId = options.sourceTaskId;
     let rigTypeRecommendation;
@@ -22,7 +22,7 @@ export async function runChain(options) {
         const args = { ...spec.args };
         if (spec.step === 'rig' && rigTypeRecommendation && args.rig_type === undefined) {
             args.rig_type = rigTypeRecommendation;
-            log(t({ zh: `采用 rig-check 推荐体型:${rigTypeRecommendation}`, en: `using rig-check recommendation: ${rigTypeRecommendation}` }));
+            log(`using rig-check recommendation: ${rigTypeRecommendation}`);
         }
         if (spec.step === 'rig')
             rigType = String(args.rig_type ?? 'biped');
@@ -33,7 +33,7 @@ export async function runChain(options) {
             if (requested.length > 0 && requested.every((a) => /^preset:[^:]+$/.test(a))) {
                 delete args.animation;
                 args.animations = bodyPresets;
-                log(t({ zh: `体型为 ${rigType},双足预设换成 ${bodyPresets.join(', ')}`, en: `rig type is ${rigType}: biped presets swapped for ${bodyPresets.join(', ')}` }));
+                log(`rig type is ${rigType}: biped presets swapped for ${bodyPresets.join(', ')}`);
             }
         }
         // avian/others have no preset animations: the rigged model is the final output.
@@ -52,13 +52,11 @@ export async function runChain(options) {
             // Intermediate steps skip download; final step downloads.
             noDownload: i < chain.length - 1 && spec.step !== 'rig-check' && !noPresets,
             precheckBalance: false, // checked once by the caller
+            onCreated: options.onTaskCreated,
         });
         results.push(result);
         if (noPresets) {
-            const message = t({
-                zh: `体型 ${rigType} 没有预设动画,已跳过 retarget,产物为绑骨模型`,
-                en: `rig type ${rigType} has no preset animations; skipped retarget and kept the rigged model`,
-            });
+            const message = `rig type ${rigType} has no preset animations; skipped retarget and kept the rigged model`;
             warn(message);
             return { results, stoppedEarly: message };
         }
@@ -68,10 +66,7 @@ export async function runChain(options) {
             const riggable = output.riggable;
             rigTypeRecommendation = typeof output.rig_type === 'string' ? output.rig_type : undefined;
             if (riggable === false) {
-                const message = t({
-                    zh: 'rig-check 判定该模型不可绑骨,动画链止损停止(后续步骤未执行,未扣积分)',
-                    en: 'rig-check says this model is not riggable; stopping the chain early (no further credits spent)',
-                });
+                const message = 'rig-check says this model is not riggable; stopping the chain early (no further credits spent)';
                 warn(message);
                 return { results, stoppedEarly: message };
             }

package/dist/pipeline/stdin.js

@@ -2,12 +2,48 @@
  * NDJSON pipe support: downstream commands read the upstream task result from
  * stdin, enabling `tripo make cat.png | tripo model texture | tripo anim rig`.
  */
-/** Read piped NDJSON/JSON from stdin; returns undefined on a TTY. */
+import { CliError, UsageError } from '../core/errors.js';
+import { EXIT } from '../knowledge/error-catalog.js';
+/**
+ * Read piped NDJSON/JSON from stdin; returns undefined only on a TTY.
+ * Piped input that carries an upstream error or no task throws, so a broken
+ * pipeline never falls back to some other task and spends credits on it.
+ */
 export async function readPipedTask() {
     if (process.stdin.isTTY)
         return undefined;
     const raw = await readAll(process.stdin);
-    return parsePipedText(raw);
+    const upstream = parsePipedError(raw);
+    if (upstream) {
+        const code = upstream.exit_code;
+        const exitCode = code !== undefined && Number.isInteger(code) && code >= 1 && code <= 9 ? code : EXIT.USAGE;
+        throw new CliError(`upstream command failed${code !== undefined ? ` (exit ${code})` : ''}: ${upstream.error}; nothing was submitted`, exitCode);
+    }
+    const task = parsePipedText(raw);
+    if (!task) {
+        throw new UsageError('no task on stdin (piped input was empty or carried no task_id); nothing was submitted', 'pass the input explicitly, e.g. "tripo model texture @last" or a task id');
+    }
+    return task;
+}
+/** The upstream error when the last JSON line is an error object (`{"error","exit_code"}`). */
+export function parsePipedError(raw) {
+    const lines = raw.trim().split('\n').map((l) => l.trim()).filter(Boolean);
+    for (let i = lines.length - 1; i >= 0; i--) {
+        let obj;
+        try {
+            obj = JSON.parse(lines[i]);
+        }
+        catch {
+            continue;
+        }
+        if (typeof obj !== 'object' || obj === null)
+            continue;
+        const { error, exit_code: exitCode } = obj;
+        if (typeof error !== 'string')
+            return undefined;
+        return { error, exit_code: typeof exitCode === 'number' ? exitCode : undefined };
+    }
+    return undefined;
 }
 /** Parse piped text: JSON object, NDJSON (last task line wins), or a bare task id. */
 export function parsePipedText(raw) {
@@ -18,7 +54,8 @@ export function parsePipedText(raw) {
     for (let i = lines.length - 1; i >= 0; i--) {
         try {
             const obj = JSON.parse(lines[i]);
-            if (typeof obj.task_id === 'string') {
+            // Error JSON may name the failed task; it is never an input.
+            if (typeof obj.task_id === 'string' && obj.error === undefined) {
                 return { task_id: obj.task_id, type: typeof obj.type === 'string' ? obj.type : undefined };
             }
         }

package/dist/program.js

@@ -18,11 +18,9 @@ import { registerTaskCommands } from './commands/task.js';
 import { registerTopupCommand } from './commands/topup.js';
 import { notifyIfOutdated, registerUpdateCommand } from './commands/update.js';
 import { registerViewCommands } from './commands/view.js';
-import { loadConfig } from './config/config.js';
 import { RefError } from './config/history.js';
-import { ApiError, CliError, UsageError } from './core/errors.js';
+import { ApiError, ArtifactDownloadError, CliError, TaskFailedError, UsageError } from './core/errors.js';
 import { configureOutput, errorLine, isJsonMode } from './core/output.js';
-import { setLocale, t } from './i18n.js';
 import { EXIT } from './knowledge/error-catalog.js';
 import { cliVersion } from './version.js';
 import { beginOperation, finishOperation } from './core/analytics.js';
@@ -30,10 +28,7 @@ export function buildProgram() {
     const program = new Command();
     program
         .name('tripo')
-        .description(t({
-        zh: 'Tripo 3D 智能 CLI — 一句话/一张图,直出可进引擎的 3D 资产\n高频: make(生成) ai(专家规划) view(预览) topup(充值)',
-        en: 'Tripo 3D intelligent CLI — turn a sentence or an image into engine-ready 3D assets\ntop commands: make · ai · view · topup',
-    }))
+        .description('Tripo 3D intelligent CLI — turn a sentence or an image into engine-ready 3D assets\ntop commands: make · ai · view · topup')
         .version(cliVersion(), '-v, --version')
         .option('--json', 'machine-readable output on stdout (auto-enabled when piped)')
         .option('--yes', 'skip confirmations (auto-enabled when headless)')
@@ -54,9 +49,6 @@ export function buildProgram() {
         const profile = resolveGlobalString(actionCommand, 'profile');
         if (profile)
             process.env.TRIPO_PROFILE = profile;
-        const lang = loadConfig().language;
-        if (lang)
-            setLocale(lang);
         const path = [];
         for (let command = actionCommand; command && command !== program; command = command.parent)
             path.unshift(command.name());
@@ -158,6 +150,7 @@ export function handleError(err) {
                 ...(err instanceof ApiError
                     ? { api_code: err.apiCode, request_id: err.requestId, http_status: err.httpStatus }
                     : {}),
+                ...(err instanceof TaskFailedError || err instanceof ArtifactDownloadError ? { task_id: err.taskId } : {}),
                 ...(err.suggestion ? { suggestion: err.suggestion } : {}),
             }) + '\n');
         }