tripo-cli 0.7.2 → 0.8.0

package/dist/commands/make.js

@@ -5,14 +5,13 @@
  */
 import * as p from '@clack/prompts';
 import { TripoClient } from '../core/client.js';
-import { AuthError, UsageError } from '../core/errors.js';
+import { ArtifactDownloadError, AuthError, UsageError } from '../core/errors.js';
 import { emitResult, isInteractive, log, warn } from '../core/output.js';
 import { buildStepRequest } from '../core/requests.js';
-import { t } from '../i18n.js';
 import { ChainError, getStep } from '../knowledge/chains.js';
 import { EXIT } from '../knowledge/error-catalog.js';
 import { scenarioIds } from '../knowledge/scenarios.js';
-import { cardFromMakePlan, costNotes, renderPlanCard } from '../ai/plan-card.js';
+import { cardFromMakePlan, costNotes, generationCreditsEstimate, renderPlanCard } from '../ai/plan-card.js';
 import { checkPlanChain, executeMake, planMake } from '../pipeline/make.js';
 import { detectInput, InputDetectError } from '../util/input-detect.js';
 import { newClient, parseChainFlag, printTaskResult, summarizeCredits, withTaskOptions } from './shared.js';
@@ -50,9 +49,9 @@ async function confirmPlan(plan, inputs, flags) {
     log(renderPlanCard(card));
     if (!isInteractive())
         return true;
-    const go = await p.confirm({ message: t({ zh: '按方案执行?', en: 'Run this plan?' }) });
+    const go = await p.confirm({ message: 'Run this plan?' });
     if (p.isCancel(go) || !go) {
-        log(t({ zh: '已取消,未消耗积分', en: 'cancelled; no credits spent' }));
+        log('cancelled; no credits spent');
         return false;
     }
     return true;
@@ -90,20 +89,14 @@ export async function runMake(inputs, flags) {
         return { results: [outcome.primary], chainResults: outcome.chainResults, stoppedEarly: outcome.stoppedEarly };
     }
     // -n candidates: N parallel generations with distinct seeds.
-    if (n > 4)
-        throw new UsageError('at most 4 candidates per run (-n 4)');
+    const preview = await planMake(client, { ...options, dryRun: true });
+    checkCandidatePlan(preview, n);
     const basePlan = await planMake(client, options);
-    if (!basePlan.generation) {
-        throw new UsageError('-n only applies to generation inputs (text/image), not task references');
-    }
     const chain = basePlan.chain;
     const interactive = isInteractive();
-    if (chain.length > 0 && !interactive) {
-        throw new UsageError('-n with --then needs an interactive terminal to pick the winner; run the chain afterwards with "tripo make <task-id> --then ..."');
-    }
     if (!(await confirmPlan(basePlan, inputs, flags)))
         return cancelled;
-    log(t({ zh: `并行生成 ${n} 个候选…`, en: `generating ${n} candidates in parallel…` }));
+    log(`generating ${n} candidates in parallel…`);
     const seeds = Array.from({ length: n }, () => Math.floor(Math.random() * 2 ** 31));
     const runs = seeds.map((seed, i) => (async () => {
         const candidateOptions = {
@@ -121,6 +114,9 @@ export async function runMake(inputs, flags) {
     for (const s of settled) {
         if (s.status === 'fulfilled')
             results.push(s.value.primary);
+        // A finished (billed) candidate stays in the results even if its download failed.
+        else if (s.reason instanceof ArtifactDownloadError)
+            results.push({ ...s.reason.result, download_error: s.reason.message });
         else
             warn(String(s.reason instanceof Error ? s.reason.message : s.reason));
     }
@@ -134,7 +130,7 @@ export async function runMake(inputs, flags) {
     let stoppedEarly;
     if (chain.length > 0 && interactive) {
         const pick = await p.select({
-            message: t({ zh: '选择一个候选继续加工链', en: 'pick a candidate to continue the chain' }),
+            message: 'pick a candidate to continue the chain',
             options: results.map((r, i) => ({
                 value: r.task_id,
                 label: `#${i + 1} ${r.task_id.slice(0, 8)} ${r.output_dir ?? ''}`,
@@ -158,6 +154,17 @@ export async function runMake(inputs, flags) {
     }
     return { results, chainResults, stoppedEarly };
 }
+/** Shared by normal execution and dry-run; must run before upload. */
+function checkCandidatePlan(plan, count) {
+    if (count > 4)
+        throw new UsageError('at most 4 candidates per run (-n 4)');
+    if (count > 1 && !plan.generation) {
+        throw new UsageError('-n only applies to generation inputs (text/image), not task references');
+    }
+    if (count > 1 && plan.chain.length > 0 && !isInteractive()) {
+        throw new UsageError('-n with --then needs an interactive terminal to pick the winner; run the chain afterwards with "tripo make <task-id> --then ..."');
+    }
+}
 const UPSTREAM_PLACEHOLDER = '<upstream>';
 /** Dry runs never send a request, so a missing API key must not block them. */
 function dryRunClient() {
@@ -208,6 +215,7 @@ async function dryRunMake(inputs, flags, options) {
             candidates: flags.candidates,
             warnings,
             errors,
+            generation_credits_estimate: null,
             cost_notes: [],
         });
         return;
@@ -224,10 +232,13 @@ async function dryRunMake(inputs, flags, options) {
     if (plan.chain.length > 0 && !plan.generation && !plan.sourceType) {
         warnings.push(`chain legality unverified: upstream task type unknown (no local history for ${plan.sourceTaskId}); the real run checks it via the API`);
     }
-    if (flags.candidates > 4)
-        errors.push('at most 4 candidates per run (-n 4)');
-    if (flags.candidates > 1 && !plan.generation) {
-        errors.push('-n only applies to generation inputs (text/image), not task references');
+    try {
+        checkCandidatePlan(plan, flags.candidates);
+    }
+    catch (err) {
+        if (!(err instanceof UsageError))
+            throw err;
+        errors.push(err.message);
     }
     // Same card the real run shows; chain-step args are replaced by the
     // normalized payloads so the human sees the completed parameters too.
@@ -281,6 +292,7 @@ async function dryRunMake(inputs, flags, options) {
         candidates: flags.candidates,
         warnings,
         errors,
+        generation_credits_estimate: generationCreditsEstimate(card) ?? null,
         cost_notes: costNotes(card),
     }, renderPlanCard(card));
 }
@@ -288,18 +300,18 @@ async function dryRunMake(inputs, flags, options) {
 function emitDryRun(result, cardText) {
     const lines = cardText ? [cardText] : [];
     if (result.warnings.length > 0) {
-        lines.push(t({ zh: '警告(已自动调整):', en: 'warnings (auto-adjusted):' }));
+        lines.push('warnings (auto-adjusted):');
         for (const w of result.warnings)
             lines.push(`  ! ${w}`);
     }
     if (result.errors.length > 0) {
-        lines.push(t({ zh: '错误(阻断):', en: 'errors (blocking):' }));
+        lines.push('errors (blocking):');
         for (const e of result.errors)
             lines.push(`  ✗ ${e}`);
     }
     lines.push(result.valid
-        ? t({ zh: 'dry run:方案有效;未提交任务,未消耗积分', en: 'dry run: plan is valid; nothing submitted, no credits spent' })
-        : t({ zh: 'dry run:方案无效;修正上述错误后重试', en: 'dry run: plan is invalid; fix the errors above and retry' }));
+        ? 'dry run: plan is valid; nothing submitted, no credits spent'
+        : 'dry run: plan is invalid; fix the errors above and retry');
     emitResult(result, lines.join('\n'));
     if (!result.valid)
         process.exitCode = EXIT.USAGE;
@@ -315,6 +327,13 @@ export function emitMakeOutcome(outcome) {
             : primary;
         if (outcome.chainResults.length > 0)
             merged.chain = outcome.chainResults;
+        if (finalChain && primary.model_file) {
+            merged.source_output_dir = primary.output_dir;
+            merged.source_model_file = primary.model_file;
+        }
+        // Chain steps take a task id input, so the API omits normalize_scale on them; the model keeps the import's scale.
+        if (primary.normalize_scale !== undefined)
+            merged.normalize_scale ??= primary.normalize_scale;
         if (outcome.stoppedEarly)
             merged.stopped_early = outcome.stoppedEarly;
         if (credits.breakdown.length > 1) {
@@ -326,9 +345,9 @@ export function emitMakeOutcome(outcome) {
             printInlineImage(merged.preview);
     }
     else {
-        const lines = outcome.results.map((r, i) => `#${i + 1} ${r.task_id} ${r.output_dir ?? r.status}`);
+        const lines = outcome.results.map((r, i) => `#${i + 1} ${r.task_id} ${r.output_dir ?? (r.download_error ? 'download failed' : r.status)}`);
         if (credits.breakdown.length > 0) {
-            lines.push(t({ zh: `消耗积分合计: ${credits.total}`, en: `credits consumed (total): ${credits.total}` }));
+            lines.push(`credits consumed (total): ${credits.total}`);
             for (const line of credits.breakdown)
                 lines.push(`  ${line.type}  ${line.task_id}  ${line.credits_consumed}`);
         }
@@ -339,4 +358,10 @@ export function emitMakeOutcome(outcome) {
             credits_breakdown: credits.breakdown,
         }, lines.join('\n'));
     }
+    const downloadFailed = outcome.results.filter((r) => r.download_error);
+    for (const r of downloadFailed) {
+        warn(`${r.task_id} succeeded but its download failed; do not regenerate, run "tripo task get ${r.task_id} --download"`);
+    }
+    if (downloadFailed.length > 0)
+        process.exitCode = EXIT.NETWORK;
 }

package/dist/commands/mcp.js

@@ -20,14 +20,17 @@ import { beginOperation, finishOperation } from '../core/analytics.js';
 const TOOLS = [
     {
         name: 'tripo_make',
-        description: 'Generate a 3D asset from text, an image path/URL, or an existing task id. Blocks until finished; downloads artifacts locally and returns file paths (model_file, preview). Use scenario presets for domain defaults.',
+        description: 'Generate a 3D asset from text, an image path/URL, a model file path/URL, or an existing task id. Blocks until finished; downloads artifacts locally and returns file paths (model_file, preview). A model file is imported first and the result adds normalize_scale, the import normalization factor (original size = model size / normalize_scale). Use scenario presets for domain defaults.',
         inputSchema: {
             type: 'object',
             properties: {
-                input: { type: 'string', description: 'prompt text, image file path, image URL, or task id' },
+                input: { type: 'string', description: 'prompt text, image file path or URL, model file path or URL (GLB/GLTF/FBX/OBJ/STL), or task id' },
                 scenario: { type: 'string', enum: scenarioIds(), description: 'production scenario preset' },
                 then: { type: 'string', description: 'processing chain, e.g. "texture,rig,convert:fbx"' },
-                model: { type: 'string', description: 'force model: tripo-v3.1, tripo-p1 or tripo-p2 (P-series preview with quad)' },
+                model: {
+                    type: 'string',
+                    description: 'force model: tripo-v3.1 / v3.1-20260211, tripo-p1 / P1-20260311, or tripo-p2 / P2-20260801. Automatic routing prefers P2 for real-time/editable topology and uses H3.1 for dense or H-only geometry; aliases and dated versions are both accepted',
+                },
                 output_dir: { type: 'string', description: 'directory for artifacts' },
             },
             required: ['input'],
@@ -165,7 +168,9 @@ async function callTool(params) {
                     status: final.status,
                     output_dir: final.output_dir ?? outcome.primary.output_dir,
                     model_file: final.model_file ?? outcome.primary.model_file,
+                    source_model_file: final === outcome.primary ? undefined : outcome.primary.model_file,
                     preview: final.preview ?? outcome.primary.preview,
+                    normalize_scale: final.normalize_scale ?? outcome.primary.normalize_scale,
                     chain: outcome.chainResults.map((r) => ({ task_id: r.task_id, type: r.type })),
                     stopped_early: outcome.stoppedEarly,
                 });

package/dist/commands/process-groups.js

@@ -1,6 +1,6 @@
 /**
  * Processing command groups: `tripo model`, `tripo anim`, `tripo mesh`.
- * Input resolution order: explicit argument > piped NDJSON from stdin > @last.
+ * Input resolution order: explicit argument > piped NDJSON from stdin > @last (interactive terminals only).
  * That makes both human implicit-context and shell pipelines work:
  *   tripo make cat.png | tripo anim rig | tripo anim retarget --param animation=preset:walk
  */
@@ -8,34 +8,45 @@ import { UsageError } from '../core/errors.js';
 import { log, warn } from '../core/output.js';
 import { buildStepRequest } from '../core/requests.js';
 import { resolveInputValue, runTask } from '../core/task-service.js';
-import { t } from '../i18n.js';
 import { getStep, isMeshEditEnabled } from '../knowledge/chains.js';
 import { readPipedTask } from '../pipeline/stdin.js';
+import { detectInput, IMAGE_EXTS, urlExtension } from '../util/input-detect.js';
 import { newClient, printTaskResult, withTaskOptions } from './shared.js';
 async function resolveStepInput(client, raw) {
-    if (raw)
-        return resolveInputValue(client, raw);
+    if (raw) {
+        const { value, sourceTaskType } = await resolveInputValue(client, raw);
+        return { value, sourceType: sourceTaskType };
+    }
     const piped = await readPipedTask();
     if (piped) {
-        log(t({ zh: `使用管道输入任务 ${piped.task_id}`, en: `using piped task ${piped.task_id}` }));
+        log(`using piped task ${piped.task_id}`);
         return { value: piped.task_id, sourceType: piped.type };
     }
     const fallback = await resolveInputValue(client, '@last');
-    log(t({ zh: `未指定输入,使用上一个成功任务 @last`, en: `no input given; defaulting to the last successful task (@last)` }));
-    return fallback;
+    log(`no input given; defaulting to the last successful task (@last)`);
+    return { value: fallback.value, sourceType: fallback.sourceTaskType };
 }
 function makeStepAction(stepName, extraDefaults = {}) {
     return async (input, flags) => {
         const client = newClient();
+        const def = getStep(stepName);
+        const kind = input ? detectInput(input).kind : undefined;
+        // Task-only steps (retarget/complete): refuse a file/URL before uploading it.
+        if (!def.acceptsFile && kind && kind !== 'task-id' && kind !== 'history-ref' && kind !== 'text') {
+            throw new UsageError(`${def.name} takes a task id or @reference, not a file/URL`);
+        }
         const resolved = await resolveStepInput(client, input);
         // Local chain legality: catch e.g. retarget-on-non-rig before spending credits.
-        const def = getStep(stepName);
         if (Array.isArray(def.accepts) && resolved.sourceType && !def.accepts.includes(resolved.sourceType)) {
             throw new UsageError(def.accepts.length === 0
                 ? `${def.name} takes a file/URL input, not a task (input is a ${resolved.sourceType} task)`
                 : `${def.name} only accepts ${def.accepts.join('/')} tasks (input is a ${resolved.sourceType} task)`);
         }
         const args = { ...extraDefaults, ...collectStepArgs(stepName, flags), ...flags.param };
+        if (stepName === 'smartsegment' && args.seg_type === undefined
+            && (kind === 'image-file' || (kind === 'url' && IMAGE_EXTS.has(urlExtension(input))))) {
+            args.seg_type = 'image';
+        }
         const built = buildStepRequest(stepName, resolved.value, args);
         for (const w of built.warnings)
             warn(w);
@@ -67,7 +78,7 @@ function collectStepArgs(step, flags) {
     };
     switch (step) {
         case 'convert':
-            return pick(['format', 'texture_size', 'texture_format', 'face_limit', 'quad', 'flatten_bottom', 'fbx_preset', 'export_orientation', 'scale_factor', 'auto_size', 'pivot_to_center_bottom', 'export_vertex_colors']);
+            return pick(['format', 'texture_size', 'texture_format', 'face_limit', 'quad', 'flatten_bottom', 'fbx_preset', 'export_orientation', 'scale_factor', 'pivot_to_center_bottom', 'export_vertex_colors']);
         case 'texture':
             return pick(['model', 'texture_quality', 'texture_alignment', 'pbr']);
         case 'rig':
@@ -92,12 +103,12 @@ function collectStepArgs(step, flags) {
 }
 export function registerProcessCommands(program) {
     // ---- tripo model ----
-    const model = program.command('model').description('model processing: refine / texture / convert / import');
-    withTaskOptions(model.command('refine [input]').description('refine a draft text-to-model task (task id / @last)')).action(makeStepAction('refine'));
+    const model = program.command('model').description('model processing: texture / convert / import');
     withTaskOptions(model
         .command('texture [input]')
         .description('re-texture a model (task/@last/file/url)')
-        .option('--texture-quality <q>', 'standard|detailed|extreme')
+        .option('--model <v>', 'v3.5-20260815|v3.0-20250812|v2.5-20250123 (default v3.0; fast/delight select v3.5)')
+        .option('--texture-quality <q>', 'fast|standard|detailed|extreme (fast needs v3.5)')
         .option('--texture-alignment <a>', 'original_image|geometry')).action(makeStepAction('texture'));
     withTaskOptions(model
         .command('convert [input]')
@@ -108,21 +119,21 @@ export function registerProcessCommands(program) {
         .option('--face-limit <n>', 'face limit', (v) => Number(v))
         .option('--quad', 'quad remesh')
         .option('--flatten-bottom', 'flatten the bottom (3D printing)')
-        .option('--fbx-preset <p>', 'blender|3dsmax|mixamo')
+        .option('--fbx-preset <p>', 'blender|3dsmax|mixamo|bake_scale')
         .option('--export-orientation <o>', '+x|-x|+y|-y')
         .option('--scale-factor <n>', 'scale factor', (v) => Number(v))
-        .option('--auto-size', 'scale to real-world size')
         .option('--pivot-to-center-bottom', 'pivot at center bottom')
         .option('--export-vertex-colors', 'include vertex colors (OBJ/GLTF)')).action(makeStepAction('convert'));
     withTaskOptions(model.command('import <input>').description('import an external model file/url (GLB/GLTF/FBX/OBJ/STL ≤150MB)')).action(makeStepAction('import'));
     // ---- tripo anim ----
     const anim = program.command('anim').description('animation: check (riggability) / rig / retarget');
-    withTaskOptions(anim.command('check [input]').description('rig-check: is this model riggable? (GLB input)')).action(makeStepAction('rig-check'));
+    withTaskOptions(anim.command('check [input]').description('rig-check: is this model riggable? (GLB/FBX/OBJ/STL input)')).action(makeStepAction('rig-check'));
     withTaskOptions(anim
         .command('rig [input]')
         .description('rig a model (skeleton binding)')
-        .option('--rig-type <type>', 'biped|quadruped|hexapod|octopod|avian|serpentine|aquatic')
-        .option('--spec <spec>', 'tripo|mixamo')
+        .option('--model <v>', 'v3.0-20260909|v2.5-20260210|v1.0-20240301 (default v3.0; aliases rig-v3.0/rig-v2.5/rig-v1.0)')
+        .option('--rig-type <type>', 'biped|quadruped|hexapod|octopod|avian|serpentine|aquatic|others (others: v3.0)')
+        .option('--spec <spec>', 'tripo|mixamo|actorcore|unity|unreal|vrm (biped only; actorcore/unity/unreal/vrm: v3.0)')
         .option('--out-format <f>', 'glb|fbx')).action(makeStepAction('rig'));
     withTaskOptions(anim
         .command('retarget [input]')
@@ -180,7 +191,7 @@ export function registerProcessCommands(program) {
     withTaskOptions(mesh
         .command('smartsegment [input]')
         .description('smart segmentation (image or model pipeline)')
-        .option('--seg-type <t>', 'image|model', 'model')
+        .option('--seg-type <t>', 'image|model (default: image for an image file/URL, else model)')
         .option('--granularity <g>', 'coarse|medium|fine')
         .option('--hint <text>', 'hint for the parts to find')).action(makeStepAction('smartsegment'));
 }

package/dist/commands/shared.js

@@ -3,8 +3,7 @@ import { loadConfig } from '../config/config.js';
 import { TripoClient } from '../core/client.js';
 import { UsageError } from '../core/errors.js';
 import { emitResult } from '../core/output.js';
-import { t } from '../i18n.js';
-import { parseThenExpression } from '../knowledge/chains.js';
+import { ChainError, parseThenExpression } from '../knowledge/chains.js';
 /** repeatable --param key=value collector */
 export function collectParam(value, previous) {
     const eq = value.indexOf('=');
@@ -49,7 +48,14 @@ export function newClient() {
 export function parseChainFlag(value) {
     if (!value)
         return undefined;
-    return parseThenExpression(value);
+    try {
+        return parseThenExpression(value);
+    }
+    catch (error) {
+        if (error instanceof ChainError)
+            throw new UsageError(error.message);
+        throw error;
+    }
 }
 /**
  * Sum the spend of every task in a run and keep the per-task lines. Tasks
@@ -64,32 +70,35 @@ export function summarizeCredits(tasks) {
         breakdown.push({ task_id: task.task_id, type: task.type, credits_consumed: task.credits_consumed });
         total += task.credits_consumed;
     }
-    return { total, breakdown };
+    // credits carry up to two decimals; round away float drift from the sum.
+    return { total: Math.round(total * 100) / 100, breakdown };
 }
 /** Standard result output for a finished task (human + JSON modes). */
 export function printTaskResult(result) {
     const lines = [];
-    lines.push(t({
-        zh: `任务 ${result.task_id} ${result.status === 'success' ? '完成' : result.status}`,
-        en: `task ${result.task_id} ${result.status}`,
-    }));
+    lines.push(`task ${result.task_id} ${result.status}`);
     if (result.credits_breakdown && result.credits_breakdown.length > 1) {
-        lines.push(t({ zh: `消耗积分合计: ${result.credits_consumed}`, en: `credits consumed (total): ${result.credits_consumed}` }));
+        lines.push(`credits consumed (total): ${result.credits_consumed}`);
         const typeWidth = Math.max(...result.credits_breakdown.map((l) => l.type.length));
         for (const line of result.credits_breakdown) {
             lines.push(`  ${line.type.padEnd(typeWidth)}  ${line.task_id}  ${line.credits_consumed}`);
         }
     }
     else if (result.credits_consumed !== undefined) {
-        lines.push(t({ zh: `消耗积分: ${result.credits_consumed}`, en: `credits consumed: ${result.credits_consumed}` }));
+        lines.push(`credits consumed: ${result.credits_consumed}`);
     }
     if (result.output_dir) {
-        lines.push(t({ zh: `产物目录: ${result.output_dir}`, en: `artifacts: ${result.output_dir}` }));
+        lines.push(`artifacts: ${result.output_dir}`);
     }
     if (result.model_file)
-        lines.push(t({ zh: `模型文件: ${result.model_file}`, en: `model file: ${result.model_file}` }));
+        lines.push(`model file: ${result.model_file}`);
+    if (result.source_model_file)
+        lines.push(`generated model: ${result.source_model_file}`);
     if (result.preview)
-        lines.push(t({ zh: `预览图: ${result.preview}`, en: `preview: ${result.preview}` }));
+        lines.push(`preview: ${result.preview}`);
+    if (result.normalize_scale !== undefined) {
+        lines.push(`import scale: ${result.normalize_scale} (original size = imported size ÷ ${result.normalize_scale})`);
+    }
     emitResult(result, lines.join('\n'));
 }
 export function llmConfigured() {

package/dist/commands/task.js

@@ -2,10 +2,9 @@
 import { readHistory, resolveReference, updateHistoryStatus } from '../config/history.js';
 import { TripoClient } from '../core/client.js';
 import { defaultOutputDir, downloadArtifacts } from '../core/download.js';
-import { emitNdjson, emitResult, isJsonMode, isQuiet, log } from '../core/output.js';
+import { emitResult, isJsonMode, isQuiet, log } from '../core/output.js';
 import { watchTask } from '../core/watch.js';
 import { uploadLocalFile } from '../core/upload.js';
-import { t } from '../i18n.js';
 import { createSpinner } from '../util/spinner.js';
 import { newClient } from './shared.js';
 function resolveTaskId(target) {
@@ -21,12 +20,14 @@ function humanTask(task) {
         `${task.task_id}  ${task.type}  ${task.status}${typeof task.progress === 'number' ? ` ${task.progress}%` : ''}`,
     ];
     if (task.credits_consumed !== undefined)
-        lines.push(t({ zh: `消耗积分 ${task.credits_consumed}`, en: `credits ${task.credits_consumed}` }));
+        lines.push(`credits ${task.credits_consumed}`);
     const output = task.output ?? {};
     for (const [key, value] of Object.entries(output)) {
         if (typeof value === 'string' && value.startsWith('http'))
             lines.push(`${key}: ${value}`);
     }
+    if (typeof output.normalize_scale === 'number')
+        lines.push(`normalize_scale: ${output.normalize_scale}`);
     return lines.join('\n');
 }
 export function registerTaskCommands(program) {
@@ -45,7 +46,7 @@ export function registerTaskCommands(program) {
             const entry = readHistory().find((e) => e.task_id === taskId);
             const dir = opts.out ?? entry?.output_dir ?? defaultOutputDir(process.cwd(), entry?.name ?? 'task', taskId);
             const artifacts = await downloadArtifacts(detail, dir);
-            emitResult({ ...detail, output_dir: artifacts.outputDir, files: artifacts.files }, `${humanTask(detail)}\n${t({ zh: `产物目录: ${artifacts.outputDir}`, en: `artifacts: ${artifacts.outputDir}` })}`);
+            emitResult({ ...detail, output_dir: artifacts.outputDir, files: artifacts.files }, `${humanTask(detail)}\n${`artifacts: ${artifacts.outputDir}`}`);
             return;
         }
         emitResult(detail, humanTask(detail));
@@ -60,19 +61,19 @@ export function registerTaskCommands(program) {
             ? targets.map(resolveTaskId)
             : readHistory().slice(-opts.limit).map((e) => e.task_id);
         if (ids.length === 0) {
-            emitResult([], t({ zh: '本地历史为空', en: 'no local history yet' }));
+            emitResult([], 'no local history yet');
             return;
         }
         const { tasks, missed } = await client.listTasks(ids);
         const lines = tasks.map((d) => `${d.task_id}  ${(d.type ?? '').padEnd(24)} ${d.status}${typeof d.progress === 'number' ? ` ${d.progress}%` : ''}`);
         if (missed.length > 0) {
-            lines.push(t({ zh: `未找到: ${missed.join(', ')}`, en: `missed: ${missed.join(', ')}` }));
+            lines.push(`missed: ${missed.join(', ')}`);
         }
         emitResult({ tasks, missed }, lines.join('\n'));
     });
     task
         .command('watch <task-id>')
-        .description('block until a task finishes (streams NDJSON progress in --json mode)')
+        .description('block until a task finishes (progress on stderr; stdout carries only the final JSON)')
         .option('--download', 'download artifacts on success')
         .option('-o, --out <dir>', 'output directory for --download')
         .option('--timeout <seconds>', 'timeout in seconds', (v) => Number(v))
@@ -89,7 +90,7 @@ export function registerTaskCommands(program) {
                 }
                 else if (isJsonMode() && typeof d.progress === 'number' && d.progress !== lastProgress) {
                     lastProgress = d.progress;
-                    emitNdjson({ event: 'progress', task_id: d.task_id, status: d.status, progress: d.progress });
+                    log(`${d.type ?? 'task'} · ${d.status} ${d.progress}%`);
                 }
             },
         });
@@ -98,9 +99,9 @@ export function registerTaskCommands(program) {
         if (opts.download) {
             const entry = readHistory().find((e) => e.task_id === taskId);
             const dir = opts.out ?? entry?.output_dir ?? defaultOutputDir(process.cwd(), entry?.name ?? 'task', taskId);
-            log(t({ zh: '下载产物…', en: 'downloading artifacts…' }));
+            log('downloading artifacts…');
             const artifacts = await downloadArtifacts(detail, dir);
-            emitResult({ ...detail, output_dir: artifacts.outputDir, files: artifacts.files, model_file: artifacts.modelFile, preview: artifacts.preview }, `${humanTask(detail)}\n${t({ zh: `产物目录: ${artifacts.outputDir}`, en: `artifacts: ${artifacts.outputDir}` })}`);
+            emitResult({ ...detail, output_dir: artifacts.outputDir, files: artifacts.files, model_file: artifacts.modelFile, preview: artifacts.preview }, `${humanTask(detail)}\n${`artifacts: ${artifacts.outputDir}`}`);
             return;
         }
         emitResult(detail, humanTask(detail));
@@ -123,6 +124,6 @@ export function registerTaskCommands(program) {
         const human = entries
             .map((e) => `${e.created_at.slice(0, 19)}  ${(e.name ?? '').padEnd(24)} ${e.type.padEnd(22)} ${e.status.padEnd(9)} ${e.task_id}`)
             .join('\n');
-        emitResult(entries, human || t({ zh: '本地历史为空', en: 'no local history yet' }));
+        emitResult(entries, human || 'no local history yet');
     });
 }

package/dist/commands/topup.js

@@ -6,7 +6,6 @@
 import { sleep, TripoClient } from '../core/client.js';
 import { topupUrl } from '../core/task-service.js';
 import { emitResult, log, shouldOpen } from '../core/output.js';
-import { t } from '../i18n.js';
 import { createSpinner } from '../util/spinner.js';
 import { openExternal } from '../util/open.js';
 const POLL_INTERVAL_MS = 3000;
@@ -22,17 +21,17 @@ export function registerTopupCommand(program) {
         const url = topupUrl();
         if (shouldOpen()) {
             openExternal(url);
-            log(t({ zh: `已打开充值页面: ${url}`, en: `opened the billing page: ${url}` }));
+            log(`opened the billing page: ${url}`);
         }
         else {
-            log(t({ zh: `充值页面: ${url}`, en: `billing page: ${url}` }));
+            log(`billing page: ${url}`);
         }
-        log(t({ zh: `当前余额 ${before.balance} 积分`, en: `current balance: ${before.balance} credits` }));
+        log(`current balance: ${before.balance} credits`);
         if (!opts.watch || !shouldOpen()) {
             emitResult({ billing_url: url, balance: before.balance }, url);
             return;
         }
-        const spinner = createSpinner(t({ zh: '等待到账…(Ctrl+C 退出,不影响支付)', en: 'waiting for credits… (Ctrl+C is safe; payment continues in the browser)' }));
+        const spinner = createSpinner('waiting for credits… (Ctrl+C is safe; payment continues in the browser)');
         const deadline = Date.now() + POLL_TIMEOUT_MS;
         let current = Number(before.balance);
         while (Date.now() < deadline) {
@@ -41,10 +40,7 @@ export function registerTopupCommand(program) {
                 const now = await client.getBalance();
                 const value = Number(now.balance);
                 if (value > current) {
-                    spinner.succeed(t({
-                        zh: `到账 +${value - current} 积分,当前余额 ${value}`,
-                        en: `+${value - current} credits arrived; balance is now ${value}`,
-                    }));
+                    spinner.succeed(`+${value - current} credits arrived; balance is now ${value}`);
                     emitResult({ billing_url: url, balance: value, delta: value - current });
                     return;
                 }
@@ -55,7 +51,7 @@ export function registerTopupCommand(program) {
             }
         }
         spinner.stop();
-        log(t({ zh: '未检测到到账(超时 10 分钟);支付完成后余额会自动生效', en: 'no balance change detected within 10 minutes; credits apply automatically once payment completes' }));
+        log('no balance change detected within 10 minutes; credits apply automatically once payment completes');
         emitResult({ billing_url: url, balance: current });
     });
 }

package/dist/commands/update.js

@@ -8,13 +8,13 @@
  * so agents and pipes are unaffected.
  */
 import { spawn } from 'node:child_process';
-import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
 import pc from 'picocolors';
 import { tripoHome } from '../config/config.js';
 import { CliError, NetworkError } from '../core/errors.js';
 import { emitResult, isJsonMode, log, success } from '../core/output.js';
-import { t } from '../i18n.js';
 import { EXIT } from '../knowledge/error-catalog.js';
 import { cliVersion } from '../version.js';
 const PACKAGE_NAME = 'tripo-cli';
@@ -86,28 +86,40 @@ export function notifyIfOutdated() {
     const current = cliVersion();
     const cache = readCache();
     if (cache && isNewerVersion(cache.latest, current)) {
-        process.stderr.write(pc.yellow(t({
-            zh: `! 有新版本 tripo-cli ${cache.latest} 可用(当前 ${current}),运行 tripo update 升级`,
-            en: `! a new version of tripo-cli is available: ${cache.latest} (current ${current}) — run "tripo update" to upgrade`,
-        })) + '\n');
+        process.stderr.write(pc.yellow(`! a new version of tripo-cli is available: ${cache.latest} (current ${current}) — run "tripo update" to upgrade`) + '\n');
     }
     if (!cache || Date.now() - cache.checked_at > CHECK_INTERVAL_MS) {
         // Fire-and-forget; the result shows up on the next run.
         fetchLatestVersion().catch(() => { });
     }
 }
+/**
+ * Prefix of the running global install: `<prefix>/lib/node_modules/tripo-cli` plus `<prefix>/bin/tripo`
+ * (`<prefix>/node_modules/tripo-cli` plus `<prefix>/tripo.cmd` on Windows). Version managers such as
+ * vite-plus and Volta keep `tripo` linked to the Node version it was installed under, so a bare
+ * `npm install -g` can land in the current Node's prefix and leave the `tripo` on PATH untouched.
+ */
+function installPrefix() {
+    const pkgRoot = fileURLToPath(new URL('../../', import.meta.url));
+    const win = process.platform === 'win32';
+    const prefix = win ? join(pkgRoot, '..', '..') : join(pkgRoot, '..', '..', '..');
+    return existsSync(win ? join(prefix, 'tripo.cmd') : join(prefix, 'bin', 'tripo')) ? prefix : undefined;
+}
 function runNpmInstall() {
+    const prefix = installPrefix();
+    const manual = `npm install -g ${prefix ? `--prefix "${prefix}" ` : ''}${PACKAGE_NAME}@latest`;
     return new Promise((resolve, reject) => {
         const child = spawn('npm', ['install', '-g', `${PACKAGE_NAME}@latest`], {
             stdio: 'inherit',
             shell: process.platform === 'win32',
+            env: prefix ? { ...process.env, npm_config_prefix: prefix } : process.env,
         });
         child.on('error', (err) => reject(new CliError(`failed to run npm: ${err.message}`, EXIT.FATAL)));
         child.on('exit', (code) => {
             if (code === 0)
                 resolve();
             else
-                reject(new CliError(`npm install exited with code ${code}`, EXIT.FATAL, t({ zh: `手动执行: npm install -g ${PACKAGE_NAME}@latest`, en: `run manually: npm install -g ${PACKAGE_NAME}@latest` })));
+                reject(new CliError(`npm install exited with code ${code}`, EXIT.FATAL, `run manually: ${manual}`));
         });
     });
 }
@@ -121,18 +133,18 @@ export function registerUpdateCommand(program) {
         const latest = await fetchLatestVersion();
         const available = isNewerVersion(latest, current);
         if (!available) {
-            success(t({ zh: `已是最新版本 ${current}`, en: `already up to date (${current})` }));
+            success(`already up to date (${current})`);
             emitResult({ current, latest, update_available: false, updated: false }, current);
             return;
         }
         if (opts.check) {
-            log(t({ zh: `有新版本 ${latest} 可用(当前 ${current}),运行 tripo update 升级`, en: `new version ${latest} available (current ${current}); run "tripo update" to upgrade` }));
+            log(`new version ${latest} available (current ${current}); run "tripo update" to upgrade`);
             emitResult({ current, latest, update_available: true, updated: false }, `${current} → ${latest}`);
             return;
         }
-        log(t({ zh: `正在升级 ${current} → ${latest}…`, en: `updating ${current} → ${latest}…` }));
+        log(`updating ${current} → ${latest}…`);
         await runNpmInstall();
-        success(t({ zh: `已升级到 tripo-cli ${latest}`, en: `updated to tripo-cli ${latest}` }));
+        success(`updated to tripo-cli ${latest}`);
         emitResult({ current, latest, update_available: true, updated: true }, `${current} → ${latest}`);
     });
 }