tripo-cli 0.7.1 → 0.7.3

package/README.md

@@ -15,7 +15,7 @@ tripo login          # browser approves, key arrives automatically; or --paste /
 tripo make knight.png --for game-mobile --then texture,rig,convert:fbx
 ```
 
-Works with both Tripo regions from the same install — international (`openapi.tripo3d.ai`, console `developers.tripo3d.ai`, email login + Stripe) and China mainland (`openapi.tripo3d.com`, console `developers.tripo3d.com`, SMS login + Alipay). `tripo login` runs an RFC 8628 device flow: the terminal shows a short code, the browser signs in (each console's own method) and approves, and the key lands in the CLI automatically — with graceful fallback to open-the-keys-page-and-paste when the device-auth backend is unavailable. The same flow works without a TTY: `tripo login --region ov|cn` from an agent or CI prints the verification URL + code and waits for the browser approval, so an AI agent can start the login and relay the code to its human. You never pick a region when a key is in hand: the key is probed against both regions and whichever accepts it wins; `tripo topup` then opens the matching billing page (`/billing` on ov, `/billing/recharge` on cn). If a config was moved between machines, `tripo doctor` detects the mismatch and prints the one-line fix.
+Works with both Tripo regions from the same install — international (`openapi.tripo3d.ai`, console `developers.tripo3d.ai`, email login + Stripe) and China mainland (`openapi.tripo3d.com`, console `developers.tripo3d.com`, SMS login + Alipay). `tripo login` runs an RFC 8628 device flow: the terminal shows a short code, the browser signs in (each console's own method) and approves, and the key lands in the CLI automatically — with graceful fallback to open-the-keys-page-and-paste when the device-auth backend is unavailable. The same flow works without a TTY: `tripo login --region ov|cn` from an agent or CI prints the verification URL + code and waits for the browser approval, so an AI agent can start the login and relay the code to its human. Chat agents that cannot keep a command running (e.g. ChatGPT dots) add `--no-wait`: it exits right after printing, and rerunning the same command once the human has approved finishes the login with that same code. You never pick a region when a key is in hand: the key is probed against both regions and whichever accepts it wins; `tripo topup` then opens the matching billing page (`/billing` on ov, `/billing/recharge` on cn). If a config was moved between machines, `tripo doctor` detects the mismatch and prints the one-line fix.
 
 ## Why this CLI
 
@@ -35,7 +35,7 @@ Works with both Tripo regions from the same install — international (`openapi.
 | `tripo login / logout / whoami / use` | device flow: browser approves, key arrives automatically (paste fallback); stored 0600 in `~/.tripo/config.json`; `use` switches accounts |
 | `tripo topup / balance / usage` | open the billing page + detect the credits arriving; check spend |
 | `tripo generate <endpoint>` | deterministic access to all 8 generation endpoints |
-| `tripo model / anim / mesh <step>` | refine, texture, convert, import, rig-check, rig, retarget, segment, complete, decimate, uv, smartsegment |
+| `tripo model / anim / mesh <step>` | texture, convert, import, rig-check, rig, retarget, segment, complete, decimate, uv, smartsegment |
 | `tripo task get/list/watch` | query and stream task progress (NDJSON in `--json` mode) |
 | `tripo files upload` | upload a file, print the `file_token` |
 | `tripo batch run <manifest.yaml>` | bulk pipelines with concurrency, retries, and resume |
@@ -60,7 +60,7 @@ tripo make "a fox" --profile work-cn   # one-shot override, nothing sticky
 tripo logout                    # removes the *active* profile only
 ```
 
-Each profile carries its own key + region, so switching accounts switches regions automatically. `TRIPO_PROFILE=work-cn` does the same as `--profile work-cn`; `TRIPO_API_KEY` bypasses profiles entirely (CI/agents). Configs written by older versions are read as the `default` profile — no migration step, nothing breaks.
+Each profile carries its own key + region, so switching accounts switches regions automatically. `TRIPO_PROFILE=work-cn` does the same as `--profile work-cn`; `TRIPO_API_KEY` bypasses profiles entirely (CI/agents) and is not probed for its region — pair a China-region key with `TRIPO_REGION=cn`. Configs written by older versions are read as the `default` profile — no migration step, nothing breaks.
 
 ## Scenario presets
 
@@ -91,7 +91,7 @@ tripo batch run assets.yaml --concurrency 2
 
 - `make`/`watch` are blocking: run them, wait for exit, read the single JSON line on stdout. Do not poll yourself.
 - The plan card on stderr lists every call before it runs; the final JSON carries `credits_consumed` (total for the run) plus `credits_breakdown` (per task) when a chain ran.
-- Exit codes: `0` ok · `2` usage · `3` auth · `4` insufficient credits · `5` content policy · `6` task failed (credits auto-refunded; a `timeout` means it is still running) · `7` network (a failed submit is never resent — check `tripo balance` before re-running) · `8` not found · `9` rate limit.
+- Exit codes: `0` ok · `2` usage · `3` auth · `4` insufficient credits · `5` content policy · `6` task failed (failed/cancelled tasks are auto-refunded; a `timeout` means it is still running) · `7` network (a failed submit is never resent — check `tripo balance` before re-running) · `8` not found · `9` rate limit.
 - `preview.png` in every output directory is your eyes: look at it, then decide to `tripo redo` or continue the chain.
 - Full behavior rules: `tripo docs --llm`, per-command docs via `tripo docs --topic commands/make`.
 
@@ -99,9 +99,9 @@ tripo batch run assets.yaml --concurrency 2
 
 | var | meaning |
 | --- | --- |
-| `TRIPO_API_KEY` | API key (`tsk_...`), highest precedence (bypasses profiles) |
+| `TRIPO_API_KEY` | API key (`tsk_...`), highest precedence (bypasses profiles); its region is not probed — set `TRIPO_REGION=cn` for a China-region key |
 | `TRIPO_PROFILE` | account profile to use, same as the global `--profile` flag |
-| `TRIPO_REGION` | `ov` or `cn` — normally unnecessary: `tripo login` probes both regions with your key and stores the right one automatically |
+| `TRIPO_REGION` | `ov` or `cn` — unnecessary after `tripo login` (it probes both regions with your key and stores the right one); required with a China-region `TRIPO_API_KEY` |
 | `TRIPO_API_BASE_URL` / `TRIPO_PLATFORM_BASE_URL` | endpoint overrides |
 | `TRIPO_HOME` | config/history directory (default `~/.tripo`) |
 | `TRIPO_NO_UPDATE_CHECK` | disable the startup "new version available" hint (also off when `CI` is set, headless, or `--json`) |
@@ -116,8 +116,8 @@ Setting `TRIPO_API_KEY` per shell — bash/zsh: `export TRIPO_API_KEY=tsk_...`
 
 Since 0.7.0 the CLI sends usage events to Tripo (`https://sshu-api.tripo3d.ai`) for calls to the international API (`openapi.tripo3d.ai`). It is on by default, needs no setup, prints nothing, and never changes stdout, exit codes, or credit behavior.
 
-- **Sent:** command or MCP tool name and its result, sign-in method and result, error category with HTTP status / API code, task id (and parent task id for chains), task type, model, status, credits consumed, durations, downloaded format and file count, CLI version, and the calling agent with its version — `codex` / `workbuddy` / `zcode` / `kimi` (otherwise `unknown`), from `TRIPO_CLIENT_APP` / `TRIPO_DISTRIBUTION_CHANNEL` (set by agent plugins) or the MCP host's client info.
-- **Identity:** a random installation id (`analytics_distinct_id` in `~/.tripo/config.json`) and, since 0.7.1, your Tripo account id (`platform_user_id`) when it can be resolved. It is looked up for the API key actually in use with `POST https://apiplatform.tripo3d.ai/verify`, once per command or MCP tool call, alongside the first API request rather than before it; the lookup gives up after 1 second, is never retried, and the id is never written to disk — on failure events simply go without it. No email or billing details are sent.
+- **Sent:** command or MCP tool name and its result, sign-in method and result, error category with HTTP status / API code, task id (and parent task id for chains), task type, model, status, credits consumed, durations, downloaded format and file count, CLI version, and the calling agent with its version — `codex` / `workbuddy` / `zcode` / `kimi` / `deepseek` / `claude` / `cursor` / `chatgpt` (otherwise `unknown`). Explicit `TRIPO_CLIENT_APP` takes priority over the MCP host's client info. When neither identifies the caller, the CLI can recognize Codex (`CODEX_THREAD_ID`), ZCode (`ZCODE_SESSION_ID`), or WorkBuddy (`CODEBUDDY_HOST=workbuddy-desktop`); only the app name is sent, never these marker values. Conflicting host markers remain `unknown`. `TRIPO_DISTRIBUTION_CHANNEL` names the plugin separately and is never used to guess the host; attribution is resolved per invocation and is not cached against an account or installation.
+- **Identity:** a random installation id (`analytics_distinct_id` in `~/.tripo/config.json`) and, since 0.7.1, your Tripo account id (`platform_user_id`) when it can be resolved. It is looked up for the API key actually in use with `POST https://apiplatform.tripo3d.ai/verify`, at most once per command or per `tripo mcp` session (since 0.7.3 a session reuses it across tool calls), alongside the first API request rather than before it; events wait at most 1 second for it, the lookup is never retried within that command or session, and the id is kept only in memory — never written to disk or printed — so on failure events simply go without it. No email or billing details are sent.
 - **Never sent:** prompts, file paths, input images or models, API keys, download URLs (the key itself only goes to `/verify` for the account lookup).
 - **Nothing is sent, and no account lookup is made, for:** China-region (`cn`) calls, custom API endpoints, `--dry-run`, help/version, `docs`, `completion`, `config`, `update`, `use`, `logout`, and the bare `tripo` home screen.
 - **Opt out:** `TRIPO_ANALYTICS_ENABLED=0` (also skips the account lookup).

package/dist/ai/experts.js

@@ -8,7 +8,7 @@
  */
 import { getLocale, t, tList } from '../i18n.js';
 import { availableSteps, parseThenExpression, validateChain } from '../knowledge/chains.js';
-import { chooseModel, detectLowPolyIntent, RIG_MODEL_V25 } from '../knowledge/models.js';
+import { CAPABILITY_DEFAULTS, chooseModel, detectLowPolyIntent } from '../knowledge/models.js';
 import { getScenario, SCENARIOS } from '../knowledge/scenarios.js';
 import { chatJson } from './llm.js';
 const SCENARIO_TABLE = SCENARIOS.map((s) => `- ${s.id}: ${s.description.en} | model=${s.model} | chain=${s.chain.map((c) => c.step).join('→') || 'none'} | deliver=${s.deliverables.join('/')}`).join('\n');
@@ -29,9 +29,9 @@ const SPECIALIST_PROMPTS = {
     'game-mobile': `You are a senior game technical artist (mobile). Budgets: 500–20000 faces, 1–2K textures, clean topology, FBX/GLB delivery. P1 model is used (no quad/parts/geometry_quality).`,
     'game-pc': `You are a senior game technical artist (PC/console). PBR detailed textures, optional decimate for LODs (bake=true), FBX delivery with engine presets.`,
     film: `You are a film/offline-rendering artist. quad=true subdivision-friendly topology (FBX output), geometry_quality=detailed, texture_quality=detailed, 4K textures, USD/OBJ handoff via convert.`,
-    print: `You are a 3D-printing engineer. Geometry only (texture=false,pbr=false), watertight meshes, flatten_bottom for FDM, STL or colored 3MF via convert, real-world sizing via scale_factor/auto_size.`,
+    print: `You are a 3D-printing engineer. Geometry only (texture=false,pbr=false), watertight meshes, flatten_bottom for FDM, STL or colored 3MF via convert, real-world sizing via auto_size at generation or scale_factor at convert.`,
     'ar-web': `You are a realtime AR/Web 3D engineer. Keep faces <= 20000 via decimate, 2K textures, deliver GLB + USDZ (iOS QuickLook).`,
-    anim: `You are a character animation TD. Chain: rig-check → rig (v2.5 rig, spec tripo|mixamo) → retarget (<=5 preset animations, billed per animation). Mixamo/Unity Humanoid → spec=mixamo.`,
+    anim: `You are a character animation TD. Chain: rig-check → rig (v3.0 rig, spec tripo|mixamo|actorcore|unity|unreal|vrm, biped only) → retarget (<=5 preset animations, billed per animation). Mixamo → spec=mixamo; Unity Humanoid → spec=unity; Unreal → spec=unreal.`,
     toy: `You are a stylized collectible designer. P1 low-poly. STL via convert for physical prints.`,
 };
 function specialistSystem(scenarioId) {
@@ -85,7 +85,7 @@ export async function buildExpertPlan(request, askUser) {
         chain = [
             ...chain.filter((s) => s.step !== 'convert'),
             { step: 'rig-check', args: {} },
-            { step: 'rig', args: { model: RIG_MODEL_V25 } },
+            { step: 'rig', args: { model: CAPABILITY_DEFAULTS.rig } },
             { step: 'retarget', args: { animations: ['preset:idle', 'preset:walk'] } },
         ];
     }

package/dist/ai/plan-card.js

@@ -6,6 +6,7 @@
 import pc from 'picocolors';
 import { t } from '../i18n.js';
 import { getStep } from '../knowledge/chains.js';
+import { isComplexConvert } from '../knowledge/params.js';
 import { getScenario } from '../knowledge/scenarios.js';
 const GENERATION_DESCRIBE = {
     text_to_model: { zh: '文本生成 3D 模型', en: 'generate a 3D model from text' },
@@ -90,7 +91,7 @@ export function costNotes(card) {
         notes.push(t({ zh: '分件生成:价签更高,出裸几何', en: 'part generation: higher price tier, bare geometry' }));
     }
     for (const step of card.chain) {
-        if (step.step === 'convert' && Object.keys(step.args).length > 1) {
+        if (step.step === 'convert' && isComplexConvert(step.args)) {
             notes.push(t({ zh: 'convert 非默认参数:按 complex 价签计费', en: 'non-default convert options bill as complex convert' }));
         }
         if (step.step === 'retarget') {

package/dist/ai/wizard.js

@@ -8,7 +8,7 @@ import { CliError, UsageError } from '../core/errors.js';
 import { isInteractive } from '../core/output.js';
 import { t, tList } from '../i18n.js';
 import { EXIT } from '../knowledge/error-catalog.js';
-import { RIG_MODEL_V25 } from '../knowledge/models.js';
+import { CAPABILITY_DEFAULTS } from '../knowledge/models.js';
 import { getScenario, SCENARIOS } from '../knowledge/scenarios.js';
 export async function runWizard(initialPrompt) {
     if (!isInteractive()) {
@@ -79,10 +79,14 @@ export function adjustChain(scenarioId, engine, animations) {
     let chain = scenario.chain.map((s) => ({ step: s.step, args: { ...s.args } }));
     const notes = [];
     if (animations && !chain.some((s) => s.step === 'rig')) {
-        const rigArgs = { model: RIG_MODEL_V25, out_format: 'fbx' };
+        const rigArgs = { model: CAPABILITY_DEFAULTS.rig, out_format: 'fbx' };
         if (engine === 'unity') {
-            rigArgs.spec = 'mixamo';
-            notes.push(t({ zh: 'Unity Humanoid → spec=mixamo', en: 'Unity Humanoid → spec=mixamo' }));
+            rigArgs.spec = 'unity';
+            notes.push(t({ zh: 'Unity Humanoid → spec=unity', en: 'Unity Humanoid → spec=unity' }));
+        }
+        else if (engine === 'unreal') {
+            rigArgs.spec = 'unreal';
+            notes.push(t({ zh: 'Unreal Mannequin → spec=unreal', en: 'Unreal Mannequin → spec=unreal' }));
         }
         chain = [
             ...chain.filter((s) => s.step !== 'convert'),

package/dist/commands/completion.js

@@ -9,7 +9,7 @@ const COMMANDS = [
 ];
 const SUBS = {
     generate: ['text-to-model', 'image-to-model', 'multiview-to-model', 'text-to-image', 'image-to-image', 'image-to-multiview', 'edit-multiview', 'image-to-splat'],
-    model: ['refine', 'texture', 'convert', 'import'],
+    model: ['texture', 'convert', 'import'],
     anim: ['check', 'rig', 'retarget'],
     mesh: ['segment', 'complete', 'decimate', 'uv', ...(isMeshEditEnabled() ? ['edit'] : []), 'smartsegment'],
     task: ['get', 'list', 'watch'],

package/dist/commands/generate.js

@@ -5,6 +5,7 @@ import { buildEditMultiview, buildImageToImage, buildImageToModel, buildImageToM
 import { resolveInputValue, runTask } from '../core/task-service.js';
 import { chooseModel } from '../knowledge/models.js';
 import { assignViews } from '../pipeline/make.js';
+import { detectInput } from '../util/input-detect.js';
 import { newClient, printTaskResult, withTaskOptions } from './shared.js';
 export function registerGenerateCommands(program) {
     const generate = program.command('generate').description('deterministic generation endpoints (text/image/multiview → model/image/splat)');
@@ -46,21 +47,31 @@ export function registerGenerateCommands(program) {
         const { model } = chooseModel({ explicit: flags.model, faceLimit: numberParam(flags, 'face_limit') });
         return buildImageToModel(value, model, flags.param);
     });
-    add('multiview-to-model', '2–4 view images → 3D model', 'multi', async (client, inputs, flags) => {
-        const views = await assignViews(client, inputs);
+    add('multiview-to-model', '2–4 view images, or one image-to-multiview/edit-multiview task → 3D model', 'multi', async (client, inputs, flags) => {
         const { model } = chooseModel({ explicit: flags.model, faceLimit: numberParam(flags, 'face_limit') });
+        const kind = inputs.length === 1 ? detectInput(inputs[0]).kind : undefined;
+        if (kind === 'task-id' || kind === 'history-ref') {
+            const { value, sourceTaskType } = await resolveInputValue(client, inputs[0]);
+            if (sourceTaskType && sourceTaskType !== 'generate_multiview_image' && sourceTaskType !== 'edit_multiview_image') {
+                throw new UsageError(`multiview-to-model reuses an image-to-multiview / edit-multiview task, not ${sourceTaskType}`);
+            }
+            return buildMultiviewToModel({ task_id: value }, model, flags.param);
+        }
+        const views = await assignViews(client, inputs);
         return buildMultiviewToModel(views, model, flags.param);
     });
     add('text-to-image', 'text → image (concept art / t_pose templates)', 'prompt', async (_c, inputs, flags) => buildTextToImage(inputs.join(' '), { ...(flags.model ? { model: flags.model } : {}), ...flags.param }));
-    add('image-to-image', 'image + prompt → edited image', 'single', async (client, inputs, flags) => {
-        const { value } = await resolveInputValue(client, inputs[0]);
+    add('image-to-image', 'image(s) + prompt → edited image (several images: cite them as image[1], image[2], ...)', 'multi', async (client, inputs, flags) => {
         const params = { ...(flags.model ? { model: flags.model } : {}), ...flags.param };
         if (flags.prompt)
             params.prompt = flags.prompt;
         if (!params.prompt && !params.template) {
             throw new UsageError('image-to-image needs --prompt or --param template=...');
         }
-        return buildImageToImage(value, params);
+        const values = [];
+        for (const input of inputs)
+            values.push((await resolveInputValue(client, input)).value);
+        return buildImageToImage(values, params);
     });
     add('image-to-multiview', 'single image → 4-view sheet', 'single', async (client, inputs, flags) => {
         const { value } = await resolveInputValue(client, inputs[0]);

package/dist/commands/login.js

@@ -12,7 +12,7 @@ import * as p from '@clack/prompts';
 import { activeProfileName, DEFAULT_PROFILE, deleteProfile, describeKeySource, isValidProfileName, listProfiles, loadConfig, maskKey, REGION_DEFAULTS, resolveApiKey, resolvePlatformBaseUrl, resolveRegion, setActiveProfile, updateProfile, } from '../config/config.js';
 import { TripoClient } from '../core/client.js';
 import { trackEvent } from '../core/analytics.js';
-import { DeviceAuthUnavailableError, requestDeviceCode, waitForDeviceApproval, } from '../core/device-auth.js';
+import { checkDeviceApproval, clearPendingGrant, DeviceAuthUnavailableError, loadPendingGrant, requestDeviceCode, savePendingGrant, waitForDeviceApproval, } from '../core/device-auth.js';
 import { AuthError, CliError, NetworkError, UsageError } from '../core/errors.js';
 import { detectRegionForKey } from '../core/region.js';
 import { emitResult, isInteractive, log, shouldOpen, success, warn } from '../core/output.js';
@@ -29,6 +29,7 @@ export function registerAuthCommands(program) {
         .option('--key <key>', 'provide the API key directly (tsk_...); region is auto-detected')
         .option('--region <region>', 'ov or cn — needed for the browser flow; required for non-interactive login')
         .option('--profile <name>', 'save into a named profile (for a second account); becomes the active profile')
+        .option('--no-wait', 'print the verification URL + code and exit at once; rerun the same command after approval to finish')
         .action(async (opts) => {
         await runLogin(opts);
     });
@@ -169,8 +170,8 @@ export async function runLogin(opts) {
         await validateAndSave(opts.key, region, profile);
         return;
     }
-    if (!isInteractive()) {
-        await runHeadlessLogin(region, profile, opts.paste);
+    if (!isInteractive() || opts.wait === false) {
+        await runHeadlessLogin(region, profile, opts.paste, opts.wait === false);
         return;
     }
     p.intro('tripo login');
@@ -211,8 +212,13 @@ export async function runLogin(opts) {
  * path are impossible here, so --region must be explicit (there is no key
  * yet to probe, and the two regions have different console hosts) and
  * --paste is rejected outright.
+ *
+ * A rerun resumes the parked grant instead of issuing a new code, so a
+ * killed poll never strands the human's approval. --no-wait exits right after
+ * printing (chat agents relay the code by ending their turn); rerunning it
+ * checks once and finishes the login when the human has approved.
  */
-async function runHeadlessLogin(region, profile, paste) {
+async function runHeadlessLogin(region, profile, paste, noWait) {
     if (paste) {
         throw new UsageError(t({
             zh: '--paste 需要交互终端;非交互环境请用设备码登录(tripo login --region ov|cn)或 TRIPO_API_KEY / --key',
@@ -228,30 +234,66 @@ async function runHeadlessLogin(region, profile, paste) {
             en: '"tripo login --region cn|ov" — or, with a key in hand: "tripo login --key tsk_..." (site auto-detected)',
         }));
     }
-    let grant;
-    try {
-        grant = await requestDeviceCode(region, profile === DEFAULT_PROFILE ? undefined : profile);
+    let grant = loadPendingGrant(region, profile);
+    const resumed = grant !== undefined;
+    if (grant && noWait) {
+        let poll;
+        try {
+            poll = await checkDeviceApproval(region, grant);
+        }
+        catch (err) {
+            throw new NetworkError(t({
+                zh: `授权服务暂时连不上(${err.message}),终端码仍然有效`,
+                en: `authorization service unavailable (${err.message}); the code is still valid`,
+            }), t({ zh: '稍后重新运行同一条命令', en: 'run the same command again shortly' }));
+        }
+        if (poll.status !== 'pending') {
+            clearPendingGrant();
+            await finishDeviceLogin(poll, region, profile);
+            return;
+        }
     }
-    catch (err) {
-        if (err instanceof DeviceAuthUnavailableError) {
-            if (err.kind === 'unreachable') {
+    if (!grant) {
+        try {
+            grant = await requestDeviceCode(region, profile === DEFAULT_PROFILE ? undefined : profile);
+        }
+        catch (err) {
+            if (err instanceof DeviceAuthUnavailableError) {
+                if (err.kind === 'unreachable') {
+                    throw new CliError(t({
+                        zh: `连不上授权服务(${err.message})— 请检查本机网络/防火墙,出网走 HTTP 代理时设置 HTTPS_PROXY;或改用 TRIPO_API_KEY / tripo login --key tsk_...`,
+                        en: `cannot reach the authorization service (${err.message}) — check this machine's network/firewall (set HTTPS_PROXY when behind a proxy), or use TRIPO_API_KEY / "tripo login --key tsk_..."`,
+                    }), EXIT.NETWORK);
+                }
+                // No paste fallback without a TTY — fail with every remaining option spelled out.
                 throw new CliError(t({
-                    zh: `连不上授权服务(${err.message})— 请检查本机网络/防火墙,出网走 HTTP 代理时设置 HTTPS_PROXY;或改用 TRIPO_API_KEY / tripo login --key tsk_...`,
-                    en: `cannot reach the authorization service (${err.message}) — check this machine's network/firewall (set HTTPS_PROXY when behind a proxy), or use TRIPO_API_KEY / "tripo login --key tsk_..."`,
-                }), EXIT.NETWORK);
+                    zh: `浏览器授权服务不可用(${err.message});请设置 TRIPO_API_KEY,运行 tripo login --key tsk_...,或在交互终端里运行 tripo login`,
+                    en: `device authorization unavailable (${err.message}) — set TRIPO_API_KEY, run "tripo login --key tsk_...", or run "tripo login" in an interactive terminal`,
+                }), EXIT.AUTH);
             }
-            // No paste fallback without a TTY — fail with every remaining option spelled out.
-            throw new CliError(t({
-                zh: `浏览器授权服务不可用(${err.message});请设置 TRIPO_API_KEY,运行 tripo login --key tsk_...,或在交互终端里运行 tripo login`,
-                en: `device authorization unavailable (${err.message}) — set TRIPO_API_KEY, run "tripo login --key tsk_...", or run "tripo login" in an interactive terminal`,
-            }), EXIT.AUTH);
+            throw err;
         }
-        throw err;
+        savePendingGrant(region, profile, grant);
     }
     const minutes = Math.max(1, Math.round(grant.expires_in / 60));
+    const rerun = `tripo login --region ${region}${profile === DEFAULT_PROFILE ? '' : ` --profile ${profile}`}${noWait ? ' --no-wait' : ''}`;
+    const header = noWait
+        ? {
+            zh: `需要在浏览器完成授权;本命令现在退出。用户说授权完成后,运行 ${rerun} 完成登录(同一个终端码,不要重新发起)。请转告用户:`,
+            en: `Authorization happens in a browser; this command exits now. Once the human says it is done, run ${rerun} to finish (same code — do not start over). Relay these steps:`,
+        }
+        : resumed
+            ? {
+                zh: '继续等待之前发起的授权(终端码不变),直到授权完成或过期。用户还没操作的话,请转告:',
+                en: 'Resuming the authorization started earlier (same code); waiting until approved or expired. If the human has not done it yet, relay:',
+            }
+            : {
+                zh: '需要在浏览器完成授权;本命令会一直等待,直到授权完成或过期。请转告用户:',
+                en: 'Authorization happens in a browser; this command keeps waiting until approved or expired. Relay these steps:',
+            };
     log(t({
         zh: [
-            '需要在浏览器完成授权;本命令会一直等待,直到授权完成或过期。请转告用户:',
+            header.zh,
             `  1. 打开: ${grant.verification_url_complete}`,
             '     (页面如果提示登录,先登录或注册 Tripo 账号 — 新账号有免费额度)',
             `  2. 在「Verification code」输入框填入终端码: ${grant.user_code}`,
@@ -259,7 +301,7 @@ async function runHeadlessLogin(region, profile, paste) {
             `  4. 点击「Authorize」。此码 ${minutes} 分钟内有效`,
         ].join('\n'),
         en: [
-            'Authorization happens in a browser; this command keeps waiting until approved or expired. Relay these steps:',
+            header.en,
             `  1. Open: ${grant.verification_url_complete}`,
             '     (if the page asks to sign in, sign in or sign up first — new accounts get free credits)',
             `  2. Enter this one-time code in the "Verification code" field: ${grant.user_code}`,
@@ -267,7 +309,23 @@ async function runHeadlessLogin(region, profile, paste) {
             `  4. Click "Authorize". The code expires in ${minutes} minutes`,
         ].join('\n'),
     }));
+    if (noWait) {
+        emitResult({
+            status: 'pending',
+            profile,
+            region,
+            user_code: grant.user_code,
+            verification_url: grant.verification_url_complete,
+            expires_in: grant.expires_in,
+            next: rerun,
+        }, t({ zh: `等待用户授权(终端码 ${grant.user_code});完成后运行: ${rerun}`, en: `waiting for approval (code ${grant.user_code}); then run: ${rerun}` }));
+        return;
+    }
     const result = await waitForDeviceApproval(region, grant);
+    clearPendingGrant();
+    await finishDeviceLogin(result, region, profile);
+}
+async function finishDeviceLogin(result, region, profile) {
     if (result.status === 'denied') {
         throw new CliError(t({ zh: '授权被拒绝;重新运行 tripo login 再试', en: 'authorization denied — run "tripo login" again to retry' }), EXIT.AUTH);
     }

package/dist/commands/make.js

@@ -315,6 +315,9 @@ export function emitMakeOutcome(outcome) {
             : primary;
         if (outcome.chainResults.length > 0)
             merged.chain = outcome.chainResults;
+        // 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) {

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 (default), tripo-p1 / P1-20260311 (low-poly) or tripo-p2 / P2-20260801 (P-series Preview with quad); aliases and dated versions are both accepted',
+                },
                 output_dir: { type: 'string', description: 'directory for artifacts' },
             },
             required: ['input'],
@@ -166,6 +169,7 @@ async function callTool(params) {
                     output_dir: final.output_dir ?? outcome.primary.output_dir,
                     model_file: final.model_file ?? 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

@@ -11,10 +11,13 @@ 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}` }));
@@ -22,20 +25,29 @@ async function resolveStepInput(client, raw) {
     }
     const fallback = await resolveInputValue(client, '@last');
     log(t({ zh: `未指定输入,使用上一个成功任务 @last`, en: `no input given; defaulting to the last successful task (@last)` }));
-    return fallback;
+    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 +79,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 +104,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 +120,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 +192,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

@@ -4,7 +4,7 @@ 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 +49,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,7 +71,8 @@ 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) {
@@ -90,6 +98,12 @@ export function printTaskResult(result) {
         lines.push(t({ zh: `模型文件: ${result.model_file}`, en: `model file: ${result.model_file}` }));
     if (result.preview)
         lines.push(t({ zh: `预览图: ${result.preview}`, en: `preview: ${result.preview}` }));
+    if (result.normalize_scale !== undefined) {
+        lines.push(t({
+            zh: `导入缩放系数: ${result.normalize_scale}(原始尺寸 = 导入后尺寸 ÷ ${result.normalize_scale})`,
+            en: `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

@@ -27,6 +27,8 @@ function humanTask(task) {
         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) {

package/dist/commands/update.js

@@ -8,8 +8,9 @@
  * 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';
@@ -96,18 +97,33 @@ export function notifyIfOutdated() {
         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, t({ zh: `手动执行: ${manual}`, en: `run manually: ${manual}` })));
         });
     });
 }