dsh-ssh-tui 0.3.5 → 0.3.7

package/lib/tui.js

@@ -24,8 +24,29 @@ import { settingsNamespace } from '@deepseek-ai/dsh-settings';
 import { formatSessionTime, listResumableSessions } from './session-list.js';
 import { defaultReasoningEffort } from './reasoning.js';
 import { checkForPluginUpdate } from './update-check.js';
+import { ROUTE_MEMORY_NAMESPACE, parseRouteMemory, rememberedRouteFor, upsertRememberedRoute, } from './route-memory.js';
 import { DEFAULT_SUBAGENT_MODEL, SUBAGENT_SETTINGS_NAMESPACE, defaultSubagentModelForProvider, subagentModelMatchesProvider, subagentSettingsValue, } from './subagent-model.js';
 import { UserQuestionError, } from '@deepseek-ai/dsh-user-questions';
+function discoverProviderModels(llm, request, signal) {
+    return llm.discoverModels(settingsNamespace('llm-pi-ai'), { ...request, signal }, signal);
+}
+function installUserQuestionAnswerer(ctx, questions, ask) {
+    const provider = questions;
+    if (typeof provider.registerProvider === 'function') {
+        return provider.registerProvider({ ask });
+    }
+    return ctx.on('user-questions/request', async (request, next) => {
+        try {
+            return await ask(request);
+        }
+        catch (error) {
+            if (error instanceof UserQuestionError && error.code === 'ASK_ABORTED')
+                throw error;
+            return await next();
+        }
+    });
+}
+const ROUTE_MEMORY_NS = ROUTE_MEMORY_NAMESPACE;
 const PROVIDER_TEMPLATES = {
     official: {
         label: 'DeepSeek 官方',
@@ -68,6 +89,26 @@ const WAIT_INDICATOR_MS = 8000;
 const MIN_PAINT_INTERVAL_MS = 40;
 const MAX_PAINT_INTERVAL_MS = 1000;
 const DSR_PROBE_TIMEOUT_MS = 800;
+/** Compact token count, matching the web stats line (517 / 12.2K / 1.2M). */
+export function formatTokens(n) {
+    const scaled = (value) => value >= 100 ? String(Math.round(value)) : String(Math.round(value * 10) / 10);
+    if (n < 1_000)
+        return String(n);
+    if (n < 1_000_000)
+        return `${scaled(n / 1_000)}K`;
+    return `${scaled(n / 1_000_000)}M`;
+}
+/** Compact duration, matching the web stats line (45.2s / 2m42s). */
+export function formatDuration(ms) {
+    const seconds = ms / 1_000;
+    if (seconds < 60)
+        return `${Math.round(seconds * 10) / 10}s`;
+    const whole = Math.round(seconds);
+    return `${Math.floor(whole / 60)}m${whole % 60}s`;
+}
+export function formatTokensPerSecond(tokensPerSecond) {
+    return `${Math.round(tokensPerSecond)} tok/s`;
+}
 /**
  * Explicit env/config always wins. Otherwise local TTYs stay snappy and SSH
  * sessions pick a tier from a measured round-trip (CSI 6n), falling back to
@@ -103,9 +144,179 @@ export function paintLinkLabel(kind, intervalMs, probed) {
         return `本机绘制 ${intervalMs}ms`;
     return probed ? `SSH 绘制 ${intervalMs}ms` : `SSH 绘制 ${intervalMs}ms（未测到往返）`;
 }
+/** Signal-bar quality from a measured SSH round-trip, or local TTY. */
+export function linkQualityOf(kind, rttMs) {
+    if (kind === 'local')
+        return 'local';
+    if (rttMs === undefined || !Number.isFinite(rttMs) || rttMs < 0)
+        return 'unknown';
+    if (rttMs < 50)
+        return 'good';
+    if (rttMs < 150)
+        return 'ok';
+    if (rttMs < 350)
+        return 'slow';
+    return 'poor';
+}
+/** How many filled signal pips: 4 local/fast, 3 ok, 2 slow, 1 poor, 0 unknown. */
+export function linkSignalPips(quality) {
+    if (quality === 'local' || quality === 'good')
+        return 4;
+    if (quality === 'ok')
+        return 3;
+    if (quality === 'slow')
+        return 2;
+    if (quality === 'poor')
+        return 1;
+    return 0;
+}
+const LINK_PIP_COLOR = {
+    0: '90',
+    1: '31',
+    2: '33',
+    3: '32',
+    4: '32',
+};
+/** Compact footer chip: `SSH ●●●○ 90ms` — 1 pip red, 2 yellow, 3+ green. */
+export function formatLinkQualityChip(kind, intervalMs, rttMs, probed, color = false) {
+    const quality = linkQualityOf(kind, probed ? rttMs : undefined);
+    const filled = linkSignalPips(quality);
+    const pips = `${'●'.repeat(filled)}${'○'.repeat(4 - filled)}`;
+    const colored = color
+        ? `\x1b[${LINK_PIP_COLOR[filled] ?? '90'}m${pips}\x1b[0m`
+        : pips;
+    if (kind === 'local')
+        return `本机 ${colored}`;
+    const delay = probed && rttMs !== undefined && Number.isFinite(rttMs)
+        ? `${Math.round(rttMs)}ms`
+        : `${intervalMs}ms`;
+    return `SSH ${colored} ${delay}`;
+}
+export function providerShortCode(provider) {
+    const id = provider.trim();
+    if (id === 'deepseek-official' || id === 'deepseek')
+        return 'DeepSeek 官方';
+    if (id === 'xai' || id === 'grok' || id.startsWith('xai-'))
+        return 'SuperGrok';
+    if (id === 'opencode-go')
+        return 'OpenCode Go';
+    if (id === 'opencode')
+        return 'OpenCode Zen';
+    return id;
+}
+/** Stats groups in drop order (last is dropped first when the row is too wide). */
+export function footerStatsGroups(stats) {
+    const groups = [];
+    if (stats.steps > 0)
+        groups.push(`${stats.turns} 轮 · ${stats.steps} 步`);
+    const billedInput = stats.inputTokens + stats.cacheReadTokens + stats.cacheWriteTokens;
+    if (billedInput > 0 || stats.outputTokens > 0) {
+        groups.push(`输入 ${formatTokens(billedInput)} · 输出 ${formatTokens(stats.outputTokens)}`);
+    }
+    const speeds = [];
+    if (stats.decodeMs > 0 && stats.decodeTokens > 0) {
+        speeds.push(formatTokensPerSecond(stats.decodeTokens / (stats.decodeMs / 1_000)));
+    }
+    else if (stats.ttftSteps > 0) {
+        speeds.push(`首字 ${formatDuration(stats.ttftMs / stats.ttftSteps)}`);
+    }
+    if (speeds.length > 0)
+        groups.push(speeds.join(' '));
+    const durations = [];
+    if (stats.llmMs > 0)
+        durations.push(`模型 ${formatDuration(stats.llmMs)}`);
+    if (stats.toolMs > 0)
+        durations.push(`工具 ${formatDuration(stats.toolMs)}`);
+    if (durations.length > 0)
+        groups.push(durations.join(' '));
+    if (billedInput > 0)
+        groups.push(`缓存命中 ${Math.round(stats.cacheReadTokens / billedInput * 100)}%`);
+    return groups;
+}
+export function fitFooterStatsLine(chip, groups, width) {
+    const kept = [...groups];
+    const render = () => kept.length === 0 ? chip : `${chip} │ ${kept.join(' │ ')}`;
+    while (kept.length > 0 && displayWidth(render()) > width)
+        kept.pop();
+    return truncateToWidth(render(), Math.max(1, width));
+}
+export function footerActivity(input) {
+    if (input.planReview)
+        return { kind: 'plan-review', text: '计划待审' };
+    if (input.waitingQuestion)
+        return { kind: 'waiting', text: '等待回答' };
+    if (input.compacting)
+        return { kind: 'compacting', text: '压缩中' };
+    if (input.retry !== undefined) {
+        return { kind: 'retry', text: `重试 ${input.retry.retry}/${input.retry.maxRetries}` };
+    }
+    if (input.subagents > 0)
+        return { kind: 'subagents', text: `子代理 ${input.subagents}` };
+    if (input.running && input.tools > 0)
+        return { kind: 'tools', text: `工具 ${input.tools}` };
+    if (input.planLeftOpen)
+        return { kind: 'plan-open', text: '本轮未收尾' };
+    if (input.planPending)
+        return { kind: 'plan-pending', text: '计划切换中' };
+    if (input.planActive)
+        return { kind: 'plan-pending', text: '计划模式' };
+    if (input.goalPhase === 'active')
+        return { kind: 'goal', text: '目标进行中' };
+    if (input.goalPhase === 'paused')
+        return { kind: 'goal', text: '目标已暂停' };
+    if (input.goalPhase === 'blocked')
+        return { kind: 'goal', text: '目标受阻' };
+    if (input.running && input.idleMs > WAIT_INDICATOR_MS) {
+        return { kind: 'waiting-llm', text: `等待 ${Math.floor(input.idleMs / 1000)}s` };
+    }
+    if (input.running)
+        return { kind: 'idle', text: '运行中' };
+    return { kind: 'idle', text: '空闲' };
+}
+/** Short remaining-quota bar: 8 pips, filled from the left. */
+export function formatQuotaBar(remainingPercent, width = 8) {
+    const remaining = Math.max(0, Math.min(100, remainingPercent));
+    const filled = Math.round(remaining / 100 * width);
+    return `${'█'.repeat(filled)}${'░'.repeat(width - filled)}`;
+}
+export function footerIdentityParts(input) {
+    const parts = [];
+    if (input.preset !== undefined && input.preset !== '')
+        parts.push(`[${input.preset}]`);
+    const model = input.effort === undefined ? input.model : `${input.model} ${input.effort}`;
+    if (model !== '')
+        parts.push(model);
+    if (input.subDiffers)
+        parts.push(`sub:${input.subModel}`);
+    if (input.quotaCode !== undefined && input.quotaPercent !== undefined) {
+        parts.push(`${input.quotaCode} ${formatQuotaBar(input.quotaPercent)} ${input.quotaPercent.toFixed(0)}%`);
+    }
+    if (input.search !== undefined)
+        parts.push(`搜索 ${input.search.index + 1}/${input.search.total}`);
+    if (input.foldedInput)
+        parts.push('输入已折叠');
+    else if (input.multiLineInput)
+        parts.push('多行输入');
+    if (input.queued > 0)
+        parts.push(`排队 ${input.queued}`);
+    return parts;
+}
+export function fitFooterStatusLine(activity, identity, width) {
+    const kept = [...identity];
+    const render = () => kept.length === 0 ? activity : `${activity}  ${kept.join(' · ')}`;
+    while (kept.length > 0 && displayWidth(render()) > width)
+        kept.pop();
+    return truncateToWidth(render(), Math.max(1, width));
+}
 /** One incremental paint as a single stdout write (one SSH packet when corked). */
 export function composePaintOutput(options) {
     const { width, height, paintRows, previousRows, sizeChanged, chromeChanged, chromeStart } = options;
+    const previousChromeStart = options.previousChromeStart ?? chromeStart;
+    // When a card expands, the input box moves up. Rows that used to be
+    // transcript may now be chrome (or vice versa); force-repaint from the
+    // higher of the two chrome starts so leftover tool-body glyphs cannot sit
+    // on the prompt.
+    const dirtyChromeStart = Math.min(chromeStart, previousChromeStart);
     let out = '\x1b[?25l';
     const prev = sizeChanged ? [] : previousRows;
     if (sizeChanged)
@@ -115,7 +326,7 @@ export function composePaintOutput(options) {
     const rowCount = Math.min(height, paintRows.length);
     for (let i = 0; i < rowCount; i++) {
         const current = paintRows[i] ?? '';
-        if (current === prev[i] && !(chromeChanged && i >= chromeStart))
+        if (current === prev[i] && !(chromeChanged && i >= dirtyChromeStart))
             continue;
         const clipped = padAnsiToWidth(current, width);
         // EL2 *before* the glyphs, from column 1. A full-width write followed
@@ -296,19 +507,20 @@ export function providerUsesLocalOAuth(provider) {
 }
 const LOCAL_COMMANDS = [
     { name: 'help', description: 'show all available commands' },
-    { name: 'model', description: 'select provider, model and reasoning effort' },
+    { name: 'model', description: 'select model and reasoning effort for the current provider' },
+    { name: 'provider', description: 'switch provider, then model and reasoning effort' },
     { name: 'submodel', description: `select subagent model (default ${DEFAULT_SUBAGENT_MODEL}, same provider as parent)` },
     { name: 'subeffort', description: 'select subagent reasoning effort (default follows provider)' },
-    { name: 'mode', description: 'switch agent mode / preset (standard, minimal, code, cordis, routing-suite, ...)' },
+    { name: 'mode', description: 'switch agent mode / preset (standard, minimal, ptc, cordis, routing-suite, ...)' },
     { name: 'quit', description: 'exit the TUI' },
     { name: 'exit', description: 'exit the TUI' },
     { name: 'clear', description: 'clear the transcript view' },
     { name: 'status', description: 'show session, provider, model, paint, and plugin version' },
-    { name: 'usage', description: 'show remaining quota for the current provider (OpenCode Go / SuperGrok)' },
-    { name: 'quota', description: 'alias of /usage' },
+    { name: 'usage', description: 'show remaining quota or account balance for the current provider' },
+    { name: 'balance', description: 'alias of /usage: DeepSeek / OpenAI-compatible balance, or subscription quota' },
     { name: 'subagents', description: 'list active subagents; kill <id> to stop one' },
     { name: 'resume', description: 'resume a past session (empty = session picker)' },
-    { name: 'setup', description: 'configure an API-key provider (DeepSeek / OpenCode); SuperGrok uses local OAuth' },
+    { name: 'setup', description: 'add or update an API-key provider without wiping other saved routes' },
     { name: 'find', description: 'search thinking / plan / subagent / reply cards' },
     { name: 'dialog-test', description: 'verify the question dialog' },
 ];
@@ -905,6 +1117,14 @@ function reasoningEffortsForDefault(reasoning) {
 const OPENCODE_GO_USAGE_URL = 'https://opencode.ai/zen/go/v1/usage';
 const OPENCODE_ZEN_BASE_URL = 'https://opencode.ai/zen/v1';
 const SUPERGROK_BILLING_URL = 'https://cli-chat-proxy.grok.com/v1/billing?format=credits';
+const DEEPSEEK_PUBLIC_BASE_URL = 'https://api.deepseek.com';
+/** OpenAI-completions gateways: probe these relative to the configured base URL. */
+const OPENAI_COMPAT_BALANCE_PATHS = [
+    '/user/balance',
+    '/dashboard/billing/credit_grants',
+    '/v1/dashboard/billing/credit_grants',
+    '/v1/dashboard/billing/subscription',
+];
 const QUOTA_ALERT_THRESHOLDS = [50, 25, 10, 5];
 /** Remaining % at or below this is “close” and uses the faster cadence. */
 const QUOTA_NEAR_THRESHOLD_PERCENT = 55;
@@ -996,9 +1216,14 @@ export function remainingPercentFromUsed(usedPercent) {
         return 100;
     return Math.max(0, Math.min(100, Math.round((100 - usedPercent) * 10) / 10));
 }
-/** Cross a remaining-percent threshold from above (50 / 25 / 10 / 5). */
+/** Cross a remaining-percent threshold from above (50 / 25 / 10 / 5).
+ *  Only the tightest (lowest) crossed threshold is returned, so one drop
+ *  never paints 50/25/10 as three identical warnings. */
 export function crossedQuotaThresholds(previousRemaining, remaining) {
-    return QUOTA_ALERT_THRESHOLDS.filter(threshold => remaining <= threshold && (previousRemaining === undefined || previousRemaining > threshold));
+    const crossed = QUOTA_ALERT_THRESHOLDS.filter(threshold => remaining <= threshold && (previousRemaining === undefined || previousRemaining > threshold));
+    if (crossed.length === 0)
+        return [];
+    return [crossed[crossed.length - 1]];
 }
 export function quotaAlertText(snapshot, window) {
     const reset = window.resetsAt === undefined ? '' : `（${formatQuotaReset(window.resetsAt)}）`;
@@ -1006,11 +1231,13 @@ export function quotaAlertText(snapshot, window) {
 }
 /**
  * How often to re-fetch quota, based on the tightest window.
- * Hourly/5h: every 10 turns, every 4 when near a threshold.
- * Weekly: every 50 turns, every 10 when near.
- * Monthly: every 80 turns, every 20 when near.
+ * Counted in model steps (not conversation turns): a turn with several
+ * tool/LLM steps should refresh more often because it spends more quota.
+ * Hourly/5h: every 10 steps, every 4 when near a threshold.
+ * Weekly: every 50 steps, every 10 when near.
+ * Monthly: every 80 steps, every 20 when near.
  */
-export function quotaRefreshEveryTurns(window) {
+export function quotaRefreshEverySteps(window) {
     if (window === undefined)
         return 10;
     const near = window.remainingPercent <= QUOTA_NEAR_THRESHOLD_PERCENT;
@@ -1022,6 +1249,8 @@ export function quotaRefreshEveryTurns(window) {
         return near ? 20 : 80;
     return near ? 10 : 50;
 }
+/** @deprecated Same cadence as {@link quotaRefreshEverySteps}; the name predates step accounting. */
+export const quotaRefreshEveryTurns = quotaRefreshEverySteps;
 function quotaPeriodLabel(period) {
     if (period === 'hourly')
         return '5 小时';
@@ -1124,6 +1353,112 @@ export function tightestQuotaWindow(snapshot) {
 export function formatOpenCodeGoUsage(payload, source) {
     return formatQuotaSnapshot(parseOpenCodeGoQuota(payload, source.provider));
 }
+export function joinUrl(base, path) {
+    const root = base.replace(/\/+$/u, '');
+    const suffix = path.startsWith('/') ? path : `/${path}`;
+    if (root.endsWith('/v1') && suffix.startsWith('/v1/'))
+        return `${root}${suffix.slice(3)}`;
+    return `${root}${suffix}`;
+}
+export function parseDeepSeekBalance(payload, provider = 'deepseek-official') {
+    if (payload === null || typeof payload !== 'object') {
+        throw new Error('DeepSeek 余额接口返回格式无法识别');
+    }
+    const raw = payload;
+    const infos = Array.isArray(raw.balance_infos) ? raw.balance_infos : [];
+    const lines = [];
+    for (const item of infos) {
+        if (item === null || typeof item !== 'object')
+            continue;
+        const row = item;
+        const currency = typeof row.currency === 'string' ? row.currency : undefined;
+        const total = typeof row.total_balance === 'string' ? row.total_balance : typeof row.total_balance === 'number' ? String(row.total_balance) : undefined;
+        if (total === undefined)
+            continue;
+        lines.push({
+            label: '可用余额',
+            amount: total,
+            ...(currency === undefined ? {} : { currency }),
+        });
+        const granted = typeof row.granted_balance === 'string' ? row.granted_balance : undefined;
+        const topped = typeof row.topped_up_balance === 'string' ? row.topped_up_balance : undefined;
+        if (granted !== undefined)
+            lines.push({ label: '赠送余额', amount: granted, ...(currency === undefined ? {} : { currency }) });
+        if (topped !== undefined)
+            lines.push({ label: '充值余额', amount: topped, ...(currency === undefined ? {} : { currency }) });
+    }
+    if (lines.length === 0)
+        throw new Error('DeepSeek 余额接口返回格式无法识别');
+    return {
+        provider,
+        plan: 'DeepSeek 官方',
+        available: typeof raw.is_available === 'boolean' ? raw.is_available : undefined,
+        lines,
+        sourcePath: '/user/balance',
+    };
+}
+function numberish(value) {
+    if (typeof value === 'number' && Number.isFinite(value))
+        return String(value);
+    if (typeof value === 'string' && value.trim() !== '')
+        return value.trim();
+    return undefined;
+}
+function recordOf(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+/** Best-effort parse of OpenAI-compatible credit/balance JSON. */
+export function parseOpenAiCompatibleBalance(payload, provider, path) {
+    const raw = recordOf(payload);
+    if (raw === undefined)
+        return undefined;
+    const lines = [];
+    const totalGranted = numberish(raw.total_granted);
+    const totalUsed = numberish(raw.total_used);
+    const totalAvailable = numberish(raw.total_available);
+    if (totalAvailable !== undefined)
+        lines.push({ label: '剩余额度', amount: totalAvailable, currency: 'USD' });
+    if (totalGranted !== undefined)
+        lines.push({ label: '总额度', amount: totalGranted, currency: 'USD' });
+    if (totalUsed !== undefined)
+        lines.push({ label: '已用', amount: totalUsed, currency: 'USD' });
+    const hardLimit = numberish(raw.hard_limit_usd ?? raw.hard_limit);
+    const softLimit = numberish(raw.soft_limit_usd ?? raw.soft_limit);
+    if (hardLimit !== undefined)
+        lines.push({ label: '硬限额', amount: hardLimit, currency: 'USD' });
+    if (softLimit !== undefined)
+        lines.push({ label: '软限额', amount: softLimit, currency: 'USD' });
+    const data = recordOf(raw.data) ?? raw;
+    const balance = numberish(data.balance ?? data.total_balance ?? data.credit ?? data.credits ?? data.quota);
+    if (lines.length === 0 && balance !== undefined) {
+        lines.push({ label: '余额', amount: balance, currency: typeof data.currency === 'string' ? data.currency : undefined });
+    }
+    if (Array.isArray(raw.balance_infos)) {
+        try {
+            return { ...parseDeepSeekBalance(raw, provider), plan: provider, sourcePath: path };
+        }
+        catch {
+            // Not DeepSeek-shaped despite the field name.
+        }
+    }
+    if (lines.length === 0)
+        return undefined;
+    return { provider, plan: provider, lines, sourcePath: path };
+}
+export function formatAccountBalance(snapshot) {
+    const header = [`${snapshot.plan} 余额（${snapshot.provider}）`];
+    if (snapshot.available === false)
+        header.push('账号当前不可用');
+    for (const line of snapshot.lines) {
+        const currency = line.currency === undefined ? '' : ` ${line.currency}`;
+        header.push(`  ${line.label} · ${line.amount}${currency}`);
+    }
+    if (snapshot.sourcePath !== undefined)
+        header.push(`  来源 ${snapshot.sourcePath}`);
+    return header.join('\n');
+}
 /** Extract a safe human-readable message from an OpenCode error payload. */
 function openCodeApiErrorMessage(payload) {
     if (typeof payload !== 'object' || payload === null)
@@ -1965,26 +2300,6 @@ export function parseExitStatus(text) {
     }
     return { body: text, exitCode: 0 };
 }
-/** Compact token count, matching the web stats line (517 / 12.2K / 1.2M). */
-export function formatTokens(n) {
-    const scaled = (value) => value >= 100 ? String(Math.round(value)) : String(Math.round(value * 10) / 10);
-    if (n < 1_000)
-        return String(n);
-    if (n < 1_000_000)
-        return `${scaled(n / 1_000)}K`;
-    return `${scaled(n / 1_000_000)}M`;
-}
-/** Compact duration, matching the web stats line (45.2s / 2m42s). */
-export function formatDuration(ms) {
-    const seconds = ms / 1_000;
-    if (seconds < 60)
-        return `${Math.round(seconds * 10) / 10}s`;
-    const whole = Math.round(seconds);
-    return `${Math.floor(whole / 60)}m${whole % 60}s`;
-}
-export function formatTokensPerSecond(tokensPerSecond) {
-    return `${Math.round(tokensPerSecond)} tok/s`;
-}
 const GRAPHEME_SEGMENTER = new Intl.Segmenter(undefined, { granularity: 'grapheme' });
 /** Owns one interactive terminal channel and its agent event wiring. */
 export class SshTui {
@@ -2065,14 +2380,17 @@ export class SshTui {
     lastChromeKey = '';
     lastPaintWidth = 0;
     lastPaintHeight = 0;
+    lastChromeStart = 0;
+    lastTranscriptStart = -1;
     paintIntervalMs;
     paintLink = 'local';
     paintProbed = false;
+    paintRttMs;
     sessionTitle = '';
     llmRetry;
     quotaSnapshot;
     quotaAlerted = new Set();
-    quotaTurnsSinceRefresh = 0;
+    quotaStepsSinceRefresh = 0;
     quotaRefreshInFlight = false;
     searchHits = [];
     searchIndex = -1;
@@ -2116,7 +2434,7 @@ export class SshTui {
         this.disposers.push(this.ctx.on('session/event', this.handleSessionEvent), this.ctx.on('agent/status', this.handleStatus), this.ctx.on('agent/error', this.handleError), this.ctx.on('agent/disposed', this.handleDisposed), this.ctx.on('agent/inbox/claimed', this.handleInboxClaimed), this.ctx.on('agent/inbox/discarded', this.handleInboxDiscarded), this.ctx.on('agent/request', this.handleAgentRequest), this.ctx.on('subagent/start', this.handleSubagentStart), this.ctx.on('subagent/end', this.handleSubagentEnd), this.ctx.on('approval/request', this.handleApproval));
         const questions = this.ctx.get('userQuestions');
         if (questions !== undefined) {
-            this.userQuestionDisposer = questions.registerProvider({ ask: this.handleUserQuestions });
+            this.userQuestionDisposer = installUserQuestionAnswerer(this.ctx, questions, this.handleUserQuestions);
         }
         this.write(`${this.useAlternateScreen ? '\x1b[?1049h' : ''}\x1b[?1000h\x1b[?1006h\x1b[?2004h\x1b[?25l`);
         this.render();
@@ -2142,8 +2460,8 @@ export class SshTui {
             this.pushRow({ kind: 'error', text: `同步子代理模型失败: ${errorChain(error)}` });
             this.markDirty();
         });
-        void this.refreshQuota({ reason: 'start', announce: true }).catch(() => {
-            // Start-up quota is best-effort; /usage still reports errors.
+        void this.refreshQuota({ reason: 'start', announce: false }).catch(() => {
+            // Start-up quota is silent; /usage and threshold alerts still report.
         });
         void this.notifyPluginUpdate().catch(() => {
             // Update check is best-effort and never blocks the TUI.
@@ -2191,27 +2509,19 @@ export class SshTui {
         const envOverride = Number.parseInt(process.env.DSH_TUI_PAINT_MS ?? '', 10);
         if (Number.isFinite(envOverride) && envOverride > 0) {
             this.paintProbed = false;
-            this.pushRow({
-                kind: 'system',
-                text: `${paintLinkLabel(this.paintLink, this.paintIntervalMs, false)} · DSH_TUI_PAINT_MS`,
-            });
+            this.markDirty();
             return;
         }
         if (this.paintLink !== 'ssh') {
-            this.pushRow({ kind: 'system', text: paintLinkLabel('local', this.paintIntervalMs, false) });
+            this.markDirty();
             return;
         }
         const rtt = await probeTerminalRttMs();
         if (this.disposed)
             return;
         this.paintProbed = rtt !== undefined;
+        this.paintRttMs = rtt;
         this.paintIntervalMs = resolvePaintIntervalMs(undefined, {}, { ssh: true, rttMs: rtt });
-        this.pushRow({
-            kind: 'system',
-            text: rtt === undefined
-                ? paintLinkLabel('ssh', this.paintIntervalMs, false)
-                : `${paintLinkLabel('ssh', this.paintIntervalMs, true)} · 往返 ${Math.round(rtt)}ms`,
-        });
         this.markDirty();
     }
     /** Replay the durable session log so a resumed session renders its history. */
@@ -2238,7 +2548,7 @@ export class SshTui {
         if (providerUsesLocalOAuth(provider)) {
             this.pushRow({
                 kind: 'system',
-                text: `当前是 ${describeProviderRoute(provider).kind}（${provider}），走本机 SuperGrok / X Premium OAuth，无需 API Key。用 /model 切换 Grok 模型和思考强度；只有要改成 DeepSeek 官方或 OpenCode 这类 Key 提供商时才需要 /setup。`,
+                text: `当前是 ${describeProviderRoute(provider).kind}（${provider}），走本机 SuperGrok / X Premium OAuth，无需 API Key。用 /model 切换 Grok 模型和思考强度；换官方或 OpenCode 用 /provider。只有要新增 API Key 提供商时才需要 /setup。`,
             });
             this.markDirty();
             return;
@@ -2740,8 +3050,9 @@ export class SshTui {
         const displayRefs = [];
         const searchHit = this.searchHits[this.searchIndex];
         const addDisplay = (line, ref) => {
+            const clipped = clipAnsiToWidth(line, width);
             const hit = ref !== undefined && ref === searchHit;
-            display.push(hit ? this.highlightSearchLine(line) : line);
+            display.push(hit ? this.highlightSearchLine(clipped) : clipped);
             displayRefs.push(ref);
         };
         const pushRow = (kind, text, ref) => {
@@ -2818,7 +3129,7 @@ export class SshTui {
                     addDisplay(focused && this.color ? `\x1b[7m${styled}\x1b[27m` : styled, row);
                     continue;
                 }
-                for (const wrapped of wrap(plainHeader, width)) {
+                for (const wrapped of wrap(`${focused ? '▶ ' : '  '}${plainHeader}`, width)) {
                     addDisplay(styleToolHeader(wrapped), row);
                 }
                 for (const line of toolBodyLines(row, this.maxToolOutputLines)) {
@@ -3210,66 +3521,76 @@ export class SshTui {
             const dockTop = headerLines.length + visible.length + 1;
             this.clickableRows.set(dockTop, dockPlan);
         }
-        const statsText = this.statsText();
-        const statsLine = this.styleLine('system', fitLine(statsText === '' ? '— 尚无会话统计' : statsText));
-        let statusText = `${this.status}  [${this.presetName}]  ${this.currentSelectionLabel()}`;
-        const sub = this.subagentSelection.current;
-        const subProvider = sub.provider ?? this.selectionRef?.current?.provider ?? this.agent.options.provider ?? this.providerName;
-        const subEffort = sub.reasoningEffort === undefined ? '' : `(${sub.reasoningEffort})`;
-        statusText += sub.provider === undefined
-            ? ` · sub:${sub.model}${subEffort}`
-            : ` · sub:${subProvider}/${sub.model}${subEffort}`;
-        if (this.searchHits.length > 0 && this.searchIndex >= 0) {
-            statusText += ` · 搜索 ${this.searchIndex + 1}/${this.searchHits.length}`;
-        }
-        if (inputView.folded)
-            statusText += ' · 输入已折叠 · Ctrl+T 展开';
-        else if (inputRows > 1)
-            statusText += ' · Ctrl+T 折叠输入';
-        if (this.pendingMessages.size > 0)
-            statusText += ` · 排队 ${this.pendingMessages.size}`;
-        statusText += ` · ${this.paintLink === 'ssh' ? 'ssh' : '本机'}${this.paintIntervalMs}ms`;
+        const linkChip = formatLinkQualityChip(this.paintLink, this.paintIntervalMs, this.paintRttMs, this.paintProbed, this.color);
+        const statsGroups = footerStatsGroups({
+            turns: this.stats.turns,
+            steps: this.stats.steps,
+            llmMs: this.stats.llmMs,
+            toolMs: this.stats.toolMs,
+            ttftMs: this.stats.ttftMs,
+            ttftSteps: this.stats.ttftSteps,
+            decodeMs: this.stats.decodeMs,
+            decodeTokens: this.stats.decodeTokens,
+            inputTokens: this.stats.usage.inputTokens,
+            outputTokens: this.stats.usage.outputTokens,
+            cacheReadTokens: this.stats.usage.cacheReadTokens,
+            cacheWriteTokens: this.stats.usage.cacheWriteTokens,
+        });
+        const statsPlain = fitFooterStatsLine(formatLinkQualityChip(this.paintLink, this.paintIntervalMs, this.paintRttMs, this.paintProbed, false), statsGroups, Math.max(1, width));
+        const chipVisible = formatLinkQualityChip(this.paintLink, this.paintIntervalMs, this.paintRttMs, this.paintProbed, false);
+        const statsLine = statsPlain.startsWith(chipVisible)
+            ? clipAnsiToWidth(`${linkChip}${this.styleLine('system', statsPlain.slice(chipVisible.length))}`, Math.max(1, width))
+            : this.styleLine('system', statsPlain);
         const idleMs = Date.now() - this.lastActivity;
         const livePlan = this.findLivePlanRow();
-        const waitingQuestions = this.rows.some(row => row.kind === 'question' && row.status === 'waiting');
-        if (waitingQuestions || this.dialog?.kind === 'questions') {
-            statusText += this.dialog?.kind === 'questions' && planReviewOf(this.dialog.question)
-                ? ' · 计划待审'
-                : ' · 等待用户回答';
-        }
-        else if (livePlan?.turnLeftOpen === true) {
-            statusText += ' · 本轮未收尾';
-        }
-        else if (livePlan?.active === true || livePlan?.pending === true) {
-            statusText += livePlan.pending ? ' · 计划模式切换中' : ' · 计划模式';
-        }
         const liveGoal = this.rows.findLast((row) => row.kind === 'goal');
-        if (liveGoal !== undefined && (liveGoal.phase === 'active' || liveGoal.phase === 'paused' || liveGoal.phase === 'blocked')) {
-            const phase = liveGoal.phase === 'active' ? '目标进行中' : liveGoal.phase === 'paused' ? '目标已暂停' : '目标受阻';
-            statusText += ` · ${phase}`;
-        }
-        const compacting = this.rows.some(row => row.kind === 'compaction' && row.status === 'running');
-        if (compacting) {
-            statusText += ` · ${this.spinnerFrame()} 压缩上下文`;
-        }
-        else if (this.activeSubagents.size > 0) {
-            const spinner = this.spinnerFrame(160);
-            statusText += ` · ${spinner} 子代理 ${this.activeSubagents.size}`;
-        }
-        else if (this.agent.status === 'running' && this.openToolCalls.size > 0) {
-            statusText += ` · 工具执行中 ${this.openToolCalls.size}`;
-        }
-        else if (this.llmRetry !== undefined) {
-            statusText += ` · 重试 ${this.llmRetry.retry}/${this.llmRetry.maxRetries}`;
-        }
-        else if (this.agent.status === 'running' && idleMs > WAIT_INDICATOR_MS) {
-            statusText += ` · 等待响应 ${Math.floor(idleMs / 1000)}s`;
-        }
         const quotaWindow = this.quotaSnapshot === undefined ? undefined : tightestQuotaWindow(this.quotaSnapshot);
-        if (quotaWindow !== undefined) {
-            statusText += ` · ${this.quotaSnapshot?.plan} 剩余 ${quotaWindow.remainingPercent.toFixed(0)}%`;
-        }
-        const statusLine = this.styleLine('system', fitLine(statusText));
+        const waitingQuestions = this.rows.some(row => row.kind === 'question' && row.status === 'waiting');
+        const compacting = this.rows.some(row => row.kind === 'compaction' && row.status === 'running');
+        const current = this.selectionRef?.current;
+        const provider = this.currentProviderId();
+        const parentModel = current?.model ?? this.agent.options.model ?? '';
+        const sub = this.subagentSelection.current;
+        const footer = {
+            running: this.agent.status === 'running',
+            planReview: this.dialog?.kind === 'questions' && planReviewOf(this.dialog.question),
+            waitingQuestion: waitingQuestions || (this.dialog?.kind === 'questions' && !planReviewOf(this.dialog.question)),
+            compacting,
+            ...(this.llmRetry === undefined ? {} : { retry: this.llmRetry }),
+            subagents: this.activeSubagents.size,
+            tools: this.openToolCalls.size,
+            planLeftOpen: livePlan?.turnLeftOpen === true,
+            planPending: livePlan?.pending === true,
+            planActive: livePlan?.active === true,
+            ...(liveGoal?.phase === 'active' || liveGoal?.phase === 'paused' || liveGoal?.phase === 'blocked'
+                ? { goalPhase: liveGoal.phase }
+                : {}),
+            idleMs,
+            model: parentModel,
+            preset: this.presetName,
+            ...(current?.reasoningEffort === undefined ? {} : { effort: current.reasoningEffort }),
+            provider,
+            parentModel,
+            subModel: sub.model,
+            subDiffers: sub.model !== parentModel,
+            ...(quotaWindow === undefined || this.quotaSnapshot === undefined || this.quotaSnapshot.provider !== provider
+                ? {}
+                : { quotaCode: this.quotaSnapshot.plan, quotaPercent: quotaWindow.remainingPercent }),
+            ...(this.searchHits.length > 0 && this.searchIndex >= 0
+                ? { search: { index: this.searchIndex, total: this.searchHits.length } }
+                : {}),
+            foldedInput: inputView.folded,
+            multiLineInput: inputRows > 1,
+            queued: this.pendingMessages.size,
+        };
+        const activity = footerActivity(footer);
+        const activityText = activity.kind === 'compacting'
+            ? `${this.spinnerFrame()} ${activity.text}`
+            : activity.kind === 'subagents'
+                ? `${this.spinnerFrame(160)} ${activity.text}`
+                : activity.text;
+        const statusText = fitFooterStatusLine(activityText, footerIdentityParts(footer), Math.max(1, width));
+        const statusLine = this.styleLine('system', statusText);
         const paintRows = [
             ...headerLines,
             ...visible,
@@ -3289,7 +3610,7 @@ export class SshTui {
             this.status,
             this.agent.status,
             this.scrollOffset,
-            statsText,
+            statsPlain,
             statusText,
             inputView.text,
             inputView.folded,
@@ -3303,9 +3624,11 @@ export class SshTui {
             this.activeSubagents.size,
             this.dialog?.kind ?? '',
             planDockLines.join('\n'),
+            String(chromeStart),
         ].join('\x1f');
-        const chromeChanged = chromeKey !== this.lastChromeKey;
-        const sizeChanged = width !== this.lastPaintWidth || height !== this.lastPaintHeight;
+        const chromeChanged = chromeKey !== this.lastChromeKey || chromeStart !== this.lastChromeStart;
+        const transcriptScrolled = start !== this.lastTranscriptStart;
+        const sizeChanged = width !== this.lastPaintWidth || height !== this.lastPaintHeight || transcriptScrolled;
         // One stdout write per frame: dirty rows only, so jump-host SSH sees a
         // single packet instead of one write per line. Clip/pad so leftover
         // wide glyphs cannot wrap into the input box.
@@ -3319,6 +3642,7 @@ export class SshTui {
             sizeChanged,
             chromeChanged,
             chromeStart,
+            previousChromeStart: this.lastChromeStart,
             cursorRow: row,
             cursorColumn: column,
         }));
@@ -3326,6 +3650,8 @@ export class SshTui {
         this.lastChromeKey = chromeKey;
         this.lastPaintWidth = width;
         this.lastPaintHeight = height;
+        this.lastChromeStart = chromeStart;
+        this.lastTranscriptStart = start;
     };
     buildSuggestions() {
         const input = this.input;
@@ -3379,36 +3705,22 @@ export class SshTui {
         };
         this.usageByStep.set(key, next);
     }
-    /** The web-aligned session stats strip: counts, timings, cache, tokens. */
+    /** Compact session stats groups for the first footer row. */
     statsText() {
-        const stats = this.stats;
-        const groups = [];
-        if (stats.steps > 0)
-            groups.push(`${stats.turns} 轮 · ${stats.steps} 步`);
-        const durations = [];
-        if (stats.llmMs > 0)
-            durations.push(`模型 ${formatDuration(stats.llmMs)}`);
-        if (stats.toolMs > 0)
-            durations.push(`工具 ${formatDuration(stats.toolMs)}`);
-        if (durations.length > 0)
-            groups.push(durations.join(' · '));
-        const speeds = [];
-        if (stats.ttftSteps > 0)
-            speeds.push(`首字 ${formatDuration(stats.ttftMs / stats.ttftSteps)}`);
-        if (stats.decodeMs > 0 && stats.decodeTokens > 0) {
-            speeds.push(formatTokensPerSecond(stats.decodeTokens / (stats.decodeMs / 1_000)));
-        }
-        if (speeds.length > 0)
-            groups.push(speeds.join(' · '));
-        const usage = stats.usage;
-        const billedInput = usage.inputTokens + usage.cacheReadTokens + usage.cacheWriteTokens;
-        if (billedInput > 0 || usage.outputTokens > 0) {
-            if (billedInput > 0) {
-                groups.push(`缓存命中 ${Math.round(usage.cacheReadTokens / billedInput * 100)}%`);
-            }
-            groups.push(`输入 ${formatTokens(billedInput)} · 输出 ${formatTokens(usage.outputTokens)}`);
-        }
-        return groups.join(' | ');
+        return footerStatsGroups({
+            turns: this.stats.turns,
+            steps: this.stats.steps,
+            llmMs: this.stats.llmMs,
+            toolMs: this.stats.toolMs,
+            ttftMs: this.stats.ttftMs,
+            ttftSteps: this.stats.ttftSteps,
+            decodeMs: this.stats.decodeMs,
+            decodeTokens: this.stats.decodeTokens,
+            inputTokens: this.stats.usage.inputTokens,
+            outputTokens: this.stats.usage.outputTokens,
+            cacheReadTokens: this.stats.usage.cacheReadTokens,
+            cacheWriteTokens: this.stats.usage.cacheWriteTokens,
+        }).join(' │ ');
     }
     /** Refresh the terminal window title (throttled while running). */
     updateTerminalTitle() {
@@ -3488,8 +3800,9 @@ export class SshTui {
                 kind === 'reasoning' ? '2;3' :
                     kind === 'brand' ? '1;38;2;77;107;253' :
                         kind === 'tool' || kind === 'tool-result' ? '33' :
-                            kind === 'diff-add' ? '38;5;22;48;5;194' :
-                                kind === 'diff-del' ? '38;5;124;48;5;224' :
+                            // Codex-like: muted add/del that blend into the terminal background.
+                            kind === 'diff-add' ? '38;2;122;168;116;48;2;18;42;24' :
+                                kind === 'diff-del' ? '38;2;196;122;122;48;2;48;20;20' :
                                     kind === 'diff-path' ? '1;36' :
                                         kind === 'todo-done' ? '2;32' :
                                             kind === 'todo-active' ? '1;36' :
@@ -3725,6 +4038,16 @@ export class SshTui {
                 // Usage accounting is complete for this step; the map only exists to
                 // deduplicate repeated usage reports during the step.
                 this.usageByStep.delete(`${event.data.turn}:${event.data.step}`);
+                if (!this.replaying) {
+                    this.quotaStepsSinceRefresh += 1;
+                    const every = quotaRefreshEverySteps(this.quotaSnapshot === undefined
+                        ? undefined
+                        : tightestQuotaWindow(this.quotaSnapshot));
+                    if (this.quotaStepsSinceRefresh >= every) {
+                        this.quotaStepsSinceRefresh = 0;
+                        void this.refreshQuota({ reason: 'step', announce: false }).catch(() => { });
+                    }
+                }
                 this.markDirty();
                 break;
             }
@@ -3735,14 +4058,6 @@ export class SshTui {
                 this.markDirty();
                 break;
             case 'turn/end': {
-                this.quotaTurnsSinceRefresh += 1;
-                const every = quotaRefreshEveryTurns(this.quotaSnapshot === undefined
-                    ? undefined
-                    : tightestQuotaWindow(this.quotaSnapshot));
-                if (this.quotaTurnsSinceRefresh >= every) {
-                    this.quotaTurnsSinceRefresh = 0;
-                    void this.refreshQuota({ reason: 'turn', announce: false }).catch(() => { });
-                }
                 const reason = event.data.reason;
                 this.openToolCalls.clear();
                 this.pendingToolTimes.clear();
@@ -3781,11 +4096,6 @@ export class SshTui {
                 this.markDirty();
                 break;
             }
-            case 'todo/write': {
-                this.upsertPlanRow({ todos: parsePlanTodos(event.data.todos) });
-                this.markDirty();
-                break;
-            }
             default:
                 this.handleExtensionEvent(event);
                 break;
@@ -3851,6 +4161,11 @@ export class SshTui {
             this.markDirty();
             return;
         }
+        if (type === 'todo/write') {
+            this.upsertPlanRow({ todos: parsePlanTodos(data?.todos) });
+            this.markDirty();
+            return;
+        }
         if (type === 'command/run') {
             this.handleCommandRun(data);
             return;
@@ -4426,12 +4741,11 @@ export class SshTui {
         const llm = this.ctx.get('llm');
         if (llm === undefined)
             return [];
-        const discovered = await llm.discoverModels(settingsNamespace('llm-pi-ai'), {
+        const discovered = await discoverProviderModels(llm, {
             baseURL,
             ...(api === undefined ? {} : { api }),
             ...(apiKey === undefined ? {} : { apiKey }),
-            signal: AbortSignal.timeout(15_000),
-        });
+        }, AbortSignal.timeout(15_000));
         return discovered.map(model => ({ id: model.id, label: model.name || model.id }));
     }
     /** Add one endpoint-listed model to the stored provider profile when needed. */
@@ -4556,50 +4870,24 @@ export class SshTui {
         { id: 'grok-4.5', label: 'Grok 4.5' },
         { id: 'grok-4.3', label: 'Grok 4.3' },
     ];
-    /** /model: stay on the current provider by default; switching providers is opt-in. */
-    async runModelCommand() {
+    async loadModelOptions(provider) {
         const llm = this.ctx.get('llm');
-        const current = this.selectionRef?.current;
-        const providers = this.listSelectableProviders();
-        let provider = this.currentProviderId();
-        const SWITCH_PROVIDER_ID = '__switch_provider__';
-        const pickProvider = async () => {
-            if (providers.length <= 1)
-                return provider;
-            const currentIndex = Math.max(0, providers.findIndex(option => option.id === provider));
-            const pickedAnswer = await this.askQuestion({
-                id: 'provider-pick',
-                question: '选择提供商',
-                options: providers.map(option => ({
-                    label: option.label,
-                    description: option.id === provider
-                        ? `${describeProviderRoute(option.id).kind} · 当前`
-                        : describeProviderRoute(option.id).kind,
-                })),
-            }, 0, 1, currentIndex);
-            return providers.find(option => option.label === pickedAnswer.selected[0])?.id;
-        };
-        let modelOptions = [];
-        let modelSource = '已配置列表';
-        // OpenCode and other third-party routes are interrogated live so the picker
-        // shows what the endpoint actually serves, not just the stored catalog.
+        let options = [];
+        let source = '已配置列表';
         if (this.piAiProviderProfile(provider) !== undefined || provider === 'opencode' || provider === 'opencode-go') {
             const previousStatus = this.status;
             try {
                 this.status = `正在从端点获取 ${provider} 的模型列表…`;
                 this.markDirty();
-                modelOptions = await this.discoverEndpointModels(provider);
-                if (modelOptions.length > 0) {
-                    modelSource = '端点实时列表';
-                    // Keep models the endpoint does not list (e.g. ones already stored
-                    // for the route) selectable, so the live list never hides the
-                    // current model.
+                options = await this.discoverEndpointModels(provider);
+                if (options.length > 0) {
+                    source = '端点实时列表';
                     try {
                         const listed = (await llm?.listModels(provider)) ?? [];
-                        const endpointIds = new Set(modelOptions.map(model => model.id));
+                        const endpointIds = new Set(options.map(model => model.id));
                         for (const model of listed) {
                             if (!endpointIds.has(model.id)) {
-                                modelOptions.push({ id: model.id, label: model.name || model.id });
+                                options.push({ id: model.id, label: model.name || model.id });
                             }
                         }
                     }
@@ -4609,86 +4897,107 @@ export class SshTui {
                 }
             }
             catch {
-                modelOptions = [];
+                options = [];
             }
             finally {
                 this.status = previousStatus;
                 this.markDirty();
             }
         }
-        if (modelOptions.length === 0) {
+        if (options.length === 0) {
             try {
                 const listed = (await llm?.listModels(provider)) ?? [];
-                modelOptions = listed.map(model => ({ id: model.id, label: model.name || model.id }));
+                options = listed.map(model => ({ id: model.id, label: model.name || model.id }));
             }
             catch {
-                modelOptions = [];
+                options = [];
             }
         }
-        if (modelOptions.length === 0 && providerUsesLocalOAuth(provider)) {
-            modelOptions = SshTui.XAI_FALLBACK_MODELS.map(option => ({ ...option }));
-            modelSource = 'SuperGrok 目录';
+        if (options.length === 0 && providerUsesLocalOAuth(provider)) {
+            options = SshTui.XAI_FALLBACK_MODELS.map(option => ({ ...option }));
+            source = 'SuperGrok 目录';
         }
-        if (modelOptions.length === 0) {
-            const fallback = current?.model ?? this.agent.options.model ?? (providerUsesLocalOAuth(provider) ? 'grok-4.6' : 'deepseek-v4-flash');
-            modelOptions = [{ id: fallback, label: fallback }];
+        if (options.length === 0) {
+            const remembered = this.rememberedRoute(provider)?.model;
+            const fallback = remembered
+                ?? (providerUsesLocalOAuth(provider) ? 'grok-4.6' : 'deepseek-v4-flash');
+            options = [{ id: fallback, label: fallback }];
         }
+        return { options, source };
+    }
+    /** /model: models and effort for the current provider only. */
+    async runModelCommand() {
+        const provider = this.currentProviderId();
+        const current = this.selectionRef?.current;
+        const loaded = await this.loadModelOptions(provider);
+        let modelOptions = loaded.options;
         if (current?.model !== undefined && !modelOptions.some(option => option.id === current.model)) {
             modelOptions = [{ id: current.model, label: current.model }, ...modelOptions];
         }
-        if (providers.length > 1) {
-            modelOptions = [
-                ...modelOptions,
-                { id: SWITCH_PROVIDER_ID, label: '更换提供商…' },
-            ];
-        }
-        const selected = await this.pickModelOption(modelOptions, provider, modelSource, current?.model);
+        const selected = await this.pickModelOption(modelOptions, provider, loaded.source, current?.model);
         if (selected === undefined)
             return;
-        if (selected.id === SWITCH_PROVIDER_ID) {
-            const nextProvider = await pickProvider();
-            if (nextProvider === undefined || nextProvider === provider)
-                return;
-            provider = nextProvider;
-            modelOptions = [];
-            modelSource = '已配置列表';
-            // Reload the model list for the newly chosen provider.
-            if (this.piAiProviderProfile(provider) !== undefined || provider === 'opencode' || provider === 'opencode-go') {
-                try {
-                    modelOptions = await this.discoverEndpointModels(provider);
-                    if (modelOptions.length > 0)
-                        modelSource = '端点实时列表';
-                }
-                catch {
-                    modelOptions = [];
-                }
-            }
-            if (modelOptions.length === 0) {
-                try {
-                    const listed = (await llm?.listModels(provider)) ?? [];
-                    modelOptions = listed.map(model => ({ id: model.id, label: model.name || model.id }));
-                }
-                catch {
-                    modelOptions = [];
-                }
-            }
-            if (modelOptions.length === 0 && providerUsesLocalOAuth(provider)) {
-                modelOptions = SshTui.XAI_FALLBACK_MODELS.map(option => ({ ...option }));
-                modelSource = 'SuperGrok 目录';
-            }
-            if (modelOptions.length === 0) {
-                const fallback = providerUsesLocalOAuth(provider) ? 'grok-4.6' : 'deepseek-v4-flash';
-                modelOptions = [{ id: fallback, label: fallback }];
-            }
-            const switched = await this.pickModelOption(modelOptions, provider, modelSource, undefined);
-            if (switched === undefined)
-                return;
-            return await this.applyModelSelection(provider, switched.id, undefined);
+        await this.applyModelSelection(provider, selected.id, modelOptions.map(option => option.id));
+    }
+    /** /provider: pick a provider, then its model (remembered route pre-filled). */
+    async runProviderCommand() {
+        const providers = this.listSelectableProviders();
+        const current = this.currentProviderId();
+        if (providers.length === 0) {
+            this.pushRow({ kind: 'error', text: '没有可切换的提供商。用 /setup 先配置一条 API Key 路由。' });
+            this.markDirty();
+            return;
+        }
+        const currentIndex = Math.max(0, providers.findIndex(option => option.id === current));
+        const pickedAnswer = await this.askQuestion({
+            id: 'provider-pick',
+            question: '选择提供商',
+            options: providers.map(option => ({
+                label: option.label,
+                description: option.id === current
+                    ? `${describeProviderRoute(option.id).kind} · 当前`
+                    : describeProviderRoute(option.id).kind,
+            })),
+        }, 0, 1, currentIndex);
+        const provider = providers.find(option => option.label === pickedAnswer.selected[0])?.id;
+        if (provider === undefined)
+            return;
+        const remembered = this.rememberedRoute(provider);
+        const loaded = await this.loadModelOptions(provider);
+        let modelOptions = loaded.options;
+        if (remembered !== undefined && !modelOptions.some(option => option.id === remembered.model)) {
+            modelOptions = [{ id: remembered.model, label: remembered.model }, ...modelOptions];
         }
-        await this.applyModelSelection(provider, selected.id, modelOptions.map(option => option.id).filter(id => id !== SWITCH_PROVIDER_ID));
+        const selected = await this.pickModelOption(modelOptions, provider, loaded.source, remembered?.model ?? (provider === current ? this.selectionRef?.current?.model : undefined));
+        if (selected === undefined)
+            return;
+        await this.applyModelSelection(provider, selected.id, modelOptions.map(option => option.id), remembered?.reasoningEffort);
     }
     /** Persist a provider/model/effort choice and keep the subagent on the same family. */
-    async applyModelSelection(provider, modelId, listed = []) {
+    rememberedRoute(provider) {
+        const section = this.ctx.get('settings')?.get(ROUTE_MEMORY_NS);
+        const memory = section !== null && typeof section === 'object' && !Array.isArray(section)
+            ? parseRouteMemory(section.providers)
+            : {};
+        return rememberedRouteFor(memory, provider);
+    }
+    async rememberRoute(selection) {
+        const settings = this.ctx.get('settings');
+        if (settings === undefined)
+            return;
+        const section = settings.get(ROUTE_MEMORY_NS);
+        const memory = section !== null && typeof section === 'object' && !Array.isArray(section)
+            ? parseRouteMemory(section.providers)
+            : {};
+        const next = upsertRememberedRoute(memory, selection.provider, {
+            model: selection.model,
+            ...(selection.reasoningEffort === undefined ? {} : { reasoningEffort: String(selection.reasoningEffort) }),
+        });
+        await settings.mutate(ROUTE_MEMORY_NS, [
+            { op: 'set', path: ['providers'], value: next },
+        ]);
+    }
+    async applyModelSelection(provider, modelId, listed = [], preferredEffort) {
         if (!(await this.ensureProviderModelConfigured(provider, modelId)))
             return;
         const llm = this.ctx.get('llm');
@@ -4719,7 +5028,10 @@ export class SshTui {
         }
         let effort;
         if (effortOptions.length > 0) {
-            const currentEffort = current?.provider === provider ? String(current?.reasoningEffort ?? '') : '';
+            const rememberedEffort = this.rememberedRoute(provider)?.reasoningEffort ?? preferredEffort ?? '';
+            const currentEffort = current?.provider === provider
+                ? String(current?.reasoningEffort ?? '')
+                : rememberedEffort;
             const currentIndex = Math.max(0, effortOptions.findIndex(option => option.id === currentEffort));
             const effortAnswer = await this.askQuestion({
                 id: 'effort-pick',
@@ -4740,12 +5052,23 @@ export class SshTui {
             this.selectionRef.current = next;
         this.onSelectionChanged?.(next);
         await this.ctx.get('agentDefaultModel')?.saveSelection(next);
+        await this.rememberRoute(next);
         const kind = describeProviderRoute(provider);
         this.pushRow({
             kind: 'system',
             text: `已切换到 ${kind.kind}：${provider}/${modelId}（思考强度 ${effort ?? '默认'}${effortOptions.length === 0 ? '，该模型未声明可选强度' : ''}）；下一步请求生效。`,
         });
-        await this.syncSubagentToProvider(provider, listed.filter(id => id !== '__switch_provider__' && id !== ''));
+        const listedIds = listed.filter(id => id !== '__switch_provider__' && id !== '');
+        const previousProvider = current?.provider ?? this.agent.options.provider ?? this.providerName;
+        if (previousProvider !== provider) {
+            await this.syncSubagentToProvider(provider, listedIds, true);
+            await this.promptSubagentAfterProviderSwitch(provider);
+            this.clearQuotaForProvider(provider);
+            void this.refreshQuota({ reason: 'command', announce: false }).catch(() => { });
+        }
+        else {
+            await this.syncSubagentToProvider(provider, listedIds);
+        }
         this.markDirty();
     }
     /** Provider route the next subagent request should use. */
@@ -4760,11 +5083,11 @@ export class SshTui {
      * on a same-family model. An explicit leftover DeepSeek flash id after
      * switching to xAI is treated as stale.
      */
-    async syncSubagentToProvider(provider, listed = []) {
+    async syncSubagentToProvider(provider, listed = [], force = false) {
         const current = this.subagentSelection.current;
-        if (current.provider !== undefined && current.provider !== provider)
+        if (!force && current.provider !== undefined && current.provider !== provider)
             return;
-        if (subagentModelMatchesProvider(provider, current.model, listed))
+        if (!force && subagentModelMatchesProvider(provider, current.model, listed))
             return;
         let catalog = [...listed];
         if (catalog.length === 0) {
@@ -4777,10 +5100,9 @@ export class SshTui {
             }
         }
         const nextModel = defaultSubagentModelForProvider(provider, catalog);
-        if (nextModel === current.model)
+        if (!force && nextModel === current.model && current.provider === undefined)
             return;
         const persisted = await this.saveSubagentSelection({
-            ...current,
             model: nextModel,
             reasoningEffort: undefined,
         });
@@ -4789,6 +5111,43 @@ export class SshTui {
             text: `子代理已跟随提供商 ${provider}，模型改为 ${nextModel}${persisted ? '' : '（仅当前会话）'}。`,
         });
     }
+    async promptSubagentAfterProviderSwitch(provider) {
+        const current = this.subagentSelection.current;
+        try {
+            const { options, source } = await this.subagentModelOptions(provider);
+            const listed = options.length === 0
+                ? [{ id: current.model, label: current.model }]
+                : options;
+            if (!listed.some(option => option.id === current.model)) {
+                listed.unshift({ id: current.model, label: current.model });
+            }
+            const selected = await this.pickModelOption(listed, provider, source, current.model);
+            if (selected === undefined || selected.id === current.model)
+                return;
+            if (!(await this.ensureProviderModelConfigured(provider, selected.id)))
+                return;
+            const persisted = await this.saveSubagentSelection({ model: selected.id });
+            this.pushRow({
+                kind: 'system',
+                text: `子代理模型已设为 ${selected.id}（提供方跟随 ${provider}）${persisted ? '' : '（仅当前会话）'}。`,
+            });
+        }
+        catch (error) {
+            if (error instanceof UserQuestionError) {
+                this.pushRow({ kind: 'system', text: `子代理沿用 ${current.model}。之后可用 /submodel 再改。` });
+                return;
+            }
+            this.pushRow({ kind: 'error', text: `选择子代理模型失败：${errorChain(error)}` });
+        }
+    }
+    clearQuotaForProvider(provider) {
+        if (this.quotaSnapshot !== undefined && this.quotaSnapshot.provider === provider)
+            return;
+        this.quotaSnapshot = undefined;
+        this.quotaAlerted.clear();
+        this.quotaStepsSinceRefresh = 0;
+        this.markDirty();
+    }
     /** Persist one subagent selection and publish it to the live request waterfall. */
     async saveSubagentSelection(next) {
         this.subagentSelection.current = next;
@@ -4928,7 +5287,7 @@ export class SshTui {
         });
         this.markDirty();
     }
-    /** /mode: pick an agent preset (standard / minimal / code / cordis / routing-suite / ...). */
+    /** /mode: pick an agent preset (standard / minimal / ptc / cordis / routing-suite / ...). */
     async runModeCommand() {
         const agentPresets = this.ctx.get('agentPresets');
         if (agentPresets === undefined) {
@@ -5090,30 +5449,35 @@ export class SshTui {
             tokenLine,
         ].join('\n');
     }
-    /** /usage and /quota: remaining quota for the current subscription provider. */
+    /** /usage and /balance: remaining quota or prepaid balance for the current provider. */
     async runUsageCommand() {
         const previousStatus = this.status;
         this.status = '查询额度…';
         this.markDirty();
         try {
-            const snapshot = await this.refreshQuota({ reason: 'command', announce: true });
-            if (snapshot === undefined) {
-                const provider = this.currentProviderId();
-                const llmPiAi = this.ctx.get('settings')?.get(settingsNamespace('llm-pi-ai'));
-                const source = openCodeSourceFor(provider, llmPiAi);
-                if (source?.flavor === 'zen') {
-                    this.pushRow({ kind: 'system', text: this.zenUsageText(source) });
-                }
-                else {
-                    this.pushRow({
-                        kind: 'system',
-                        text: `当前提供商 ${provider} 没有固定额度接口。OpenCode Go 与 SuperGrok 可查剩余额度；DeepSeek 官方按 API 计费。`,
-                    });
-                }
+            const quota = await this.refreshQuota({ reason: 'command', announce: true });
+            if (quota !== undefined)
+                return;
+            const balance = await this.fetchAccountBalance(this.currentProviderId());
+            if (balance !== undefined) {
+                this.pushRow({ kind: 'system', text: formatAccountBalance(balance) });
+                return;
+            }
+            const provider = this.currentProviderId();
+            const llmPiAi = this.ctx.get('settings')?.get(settingsNamespace('llm-pi-ai'));
+            const source = openCodeSourceFor(provider, llmPiAi);
+            if (source?.flavor === 'zen') {
+                this.pushRow({ kind: 'system', text: this.zenUsageText(source) });
+            }
+            else {
+                this.pushRow({
+                    kind: 'system',
+                    text: `当前提供商 ${provider} 没有可用的余额或额度接口。DeepSeek 官方走 /user/balance；OpenAI Completions 兼容网关会探测 credit_grants；OpenCode Go 与 SuperGrok 走订阅额度。`,
+                });
             }
         }
         catch (error) {
-            this.pushRow({ kind: 'error', text: `/usage failed: ${errorChain(error)}` });
+            this.pushRow({ kind: 'error', text: `/balance failed: ${errorChain(error)}` });
         }
         finally {
             this.status = previousStatus;
@@ -5144,14 +5508,66 @@ export class SshTui {
         try {
             const provider = this.currentProviderId();
             const snapshot = await this.fetchQuotaSnapshot(provider);
-            if (snapshot !== undefined)
+            if (snapshot !== undefined) {
                 this.applyQuotaSnapshot(snapshot, options.announce);
-            return snapshot;
+                return snapshot;
+            }
+            if (this.quotaSnapshot !== undefined && this.quotaSnapshot.provider !== provider) {
+                this.quotaSnapshot = undefined;
+                this.quotaAlerted.clear();
+                this.markDirty();
+            }
+            return undefined;
         }
         finally {
             this.quotaRefreshInFlight = false;
         }
     }
+    async fetchAccountBalance(provider) {
+        if (provider === 'deepseek-official' || provider === 'deepseek') {
+            const apiKey = await this.resolveCredential('DEEPSEEK_API_KEY');
+            if (apiKey === undefined)
+                throw new Error('未找到 DEEPSEEK_API_KEY');
+            const section = this.ctx.get('settings')?.get(settingsNamespace('llm-deepseek'));
+            const baseURL = typeof section?.baseURL === 'string' && section.baseURL.trim() !== ''
+                ? section.baseURL.trim()
+                : (process.env.DEEPSEEK_BASE_URL?.trim() || DEEPSEEK_PUBLIC_BASE_URL);
+            const payload = await this.fetchJson(joinUrl(baseURL, '/user/balance'), {
+                authorization: `Bearer ${apiKey}`,
+                accept: 'application/json',
+            }, 'DeepSeek');
+            return parseDeepSeekBalance(payload, provider);
+        }
+        const profile = this.piAiProviderProfile(provider);
+        const api = typeof profile?.api === 'string' ? profile.api : undefined;
+        const baseURL = typeof profile?.baseURL === 'string' && profile.baseURL.trim() !== '' ? profile.baseURL.trim() : undefined;
+        if (baseURL === undefined || (api !== undefined && api !== 'openai-completions'))
+            return undefined;
+        const apiKeyEnv = typeof profile?.apiKeyEnv === 'string' && profile.apiKeyEnv.trim() !== ''
+            ? profile.apiKeyEnv.trim()
+            : `${provider.replaceAll('-', '_').toUpperCase()}_API_KEY`;
+        const apiKey = await this.resolveCredential(apiKeyEnv);
+        if (apiKey === undefined)
+            throw new Error(`未找到凭据 ${apiKeyEnv}`);
+        const errors = [];
+        for (const path of OPENAI_COMPAT_BALANCE_PATHS) {
+            const url = joinUrl(baseURL, path);
+            try {
+                const payload = await this.fetchJson(url, {
+                    authorization: `Bearer ${apiKey}`,
+                    accept: 'application/json',
+                }, provider);
+                const parsed = parseOpenAiCompatibleBalance(payload, provider, path);
+                if (parsed !== undefined)
+                    return parsed;
+                errors.push(`${path}: 返回无法识别`);
+            }
+            catch (error) {
+                errors.push(`${path}: ${errorChain(error)}`);
+            }
+        }
+        throw new Error(`OpenAI 兼容网关未找到余额接口（${errors.join('；')}）`);
+    }
     async fetchQuotaSnapshot(provider) {
         if (providerUsesLocalOAuth(provider)) {
             const token = await this.resolveSuperGrokToken();
@@ -5766,12 +6182,11 @@ export class SshTui {
             const llm = this.ctx.get('llm');
             if (llm === undefined)
                 throw new Error('llm 服务不可用');
-            const discovered = await llm.discoverModels(settingsNamespace('llm-pi-ai'), {
+            const discovered = await discoverProviderModels(llm, {
                 baseURL,
                 ...(template.api === undefined ? {} : { api: template.api }),
                 ...(key === '' ? {} : { apiKey: key }),
-                signal: AbortSignal.timeout(15_000),
-            });
+            }, AbortSignal.timeout(15_000));
             // Apply only if the wizard is still on the same draft the fetch started
             // from, so a stale reply cannot overwrite a newer edit or a reset.
             const stillCurrent = this.onboarding === state
@@ -5818,6 +6233,7 @@ export class SshTui {
                     this.selectionRef.current = { provider: 'deepseek-official', model };
                 }
                 this.onSelectionChanged?.({ provider: 'deepseek-official', model });
+                await this.rememberRoute({ provider: 'deepseek-official', model });
                 await this.syncSubagentToProvider('deepseek-official', state.models);
                 if (state.baseUrl !== '' && settings !== undefined) {
                     await settings.update(settingsNamespace('llm-deepseek'), { baseURL: state.baseUrl });
@@ -5826,7 +6242,7 @@ export class SshTui {
                 if (saved) {
                     this.pushRow({
                         kind: 'system',
-                        text: `配置完成，已记住默认提供商/模型：deepseek-official / ${model}。以后直接运行 dsh --profile tui 即可。`,
+                        text: `配置完成，已记住 deepseek-official / ${model}。用 /provider 可切回其它已保存的提供商，无需再 /setup。`,
                     });
                 }
             }
@@ -5845,12 +6261,37 @@ export class SshTui {
                 const reasoningEfforts = defaultEffort === undefined
                     ? undefined
                     : { off: null, [defaultEffort]: defaultEffort };
+                const existing = this.piAiProviderProfile(state.providerId);
+                const existingModels = Array.isArray(existing?.models) ? existing.models : [];
+                const mergedIds = [];
+                const seen = new Set();
+                for (const id of state.models) {
+                    if (id !== '' && !seen.has(id)) {
+                        seen.add(id);
+                        mergedIds.push(id);
+                    }
+                }
+                for (const raw of existingModels) {
+                    const id = typeof raw === 'string'
+                        ? raw
+                        : typeof raw === 'object' && raw !== null && typeof raw.id === 'string'
+                            ? raw.id
+                            : '';
+                    if (id !== '' && !seen.has(id)) {
+                        seen.add(id);
+                        mergedIds.push(id);
+                    }
+                }
                 const profile = {
-                    displayName: template.label,
+                    displayName: typeof existing?.displayName === 'string' && existing.displayName.trim() !== ''
+                        ? existing.displayName
+                        : template.label,
                     apiKeyEnv: envRef,
-                    api: template.api,
-                    baseURL: state.baseUrl === '' ? template.defaultBaseUrl : state.baseUrl,
-                    models: state.models.map(id => ({
+                    api: template.api ?? existing?.api,
+                    baseURL: state.baseUrl === ''
+                        ? (typeof existing?.baseURL === 'string' && existing.baseURL !== '' ? existing.baseURL : template.defaultBaseUrl)
+                        : state.baseUrl,
+                    models: mergedIds.map(id => ({
                         id,
                         ...(reasoningEfforts === undefined ? {} : { reasoningEfforts }),
                     })),
@@ -5881,10 +6322,11 @@ export class SshTui {
                         this.selectionRef.current = selection;
                     }
                     this.onSelectionChanged?.(selection);
+                    await this.rememberRoute(selection);
                     await this.syncSubagentToProvider(state.providerId, state.models);
                     this.pushRow({
                         kind: 'system',
-                        text: `配置完成，已记住默认提供商/模型：${state.providerId} / ${model}。以后直接运行 dsh --profile tui 即可（--provider/--model 可临时覆盖）。`,
+                        text: `配置完成，已记住 ${state.providerId} / ${model}。其它提供商的模型和 Key 仍保留；用 /provider 切换，下一步请求生效。`,
                     });
                 }
             }
@@ -6140,8 +6582,8 @@ export class SshTui {
                         '空输入时 ↑/↓ 选卡片（与 Ctrl+N/P 相同）；Enter 展开；Ctrl+R 全部展开/收起；Ctrl+T 折叠输入。',
                         'Alt+1 最新思考 · Alt+2 计划 · Alt+3 子代理 · Alt+4 最新回复。',
                         '/find [思考|计划|子代理|回复] 关键字；Ctrl+/ 或 Alt+/ 打开搜索，Ctrl+G / Alt+N 下一条。',
-                        '/model 默认列出当前提供商的模型；当前是 SuperGrok 时直接选 grok-4.6 / grok-4.5 和思考强度（含 xhigh）。要换提供商再选「更换提供商」。',
-                        '/setup 只用于配置 API Key 提供商。SuperGrok / X Premium 走本机 OAuth，不需要填 Key。',
+                        '/model 只换当前提供商的模型和思考强度。/provider 换提供商（并选模型），下一步请求生效，无需重启。',
+                        '/setup 只新增或更新某一条 API Key 提供商，不会删掉其它已保存的路由。SuperGrok 走本机 OAuth，不需要填 Key。',
                         '/status 会标明当前是 DeepSeek 官方、SuperGrok 订阅、OpenCode Go / Zen，还是其它已注册提供商。',
                     ].join('\n'),
                 });
@@ -6162,6 +6604,17 @@ export class SshTui {
                     this.markDirty();
                 });
                 break;
+            case 'provider':
+                void this.runProviderCommand().catch((error) => {
+                    if (error instanceof UserQuestionError) {
+                        this.pushRow({ kind: 'system', text: '提供商选择已取消。' });
+                    }
+                    else {
+                        this.pushRow({ kind: 'error', text: `/provider failed: ${errorChain(error)}` });
+                    }
+                    this.markDirty();
+                });
+                break;
             case 'submodel':
                 void this.runSubmodelCommand(arg).catch((error) => {
                     if (error instanceof UserQuestionError) {
@@ -6228,13 +6681,14 @@ export class SshTui {
                         `preset: ${this.presetName}`,
                         `subagents: ${this.activeSubagents.size}`,
                         `plan: ${plan === undefined ? 'off' : plan.pending ? 'pending' : plan.active ? 'on' : 'off'}`,
-                        `paint: ${paintLinkLabel(this.paintLink, this.paintIntervalMs, this.paintProbed)}`,
+                        `paint: ${formatLinkQualityChip(this.paintLink, this.paintIntervalMs, this.paintRttMs, this.paintProbed)}`,
                         waiting > 0 ? `questions: waiting ${waiting}` : 'questions: none',
                     ];
                     this.pushRow({ kind: 'system', text: lines.join('\n') });
                 }
                 break;
             case 'usage':
+            case 'balance':
             case 'quota':
                 void this.runUsageCommand().catch((error) => {
                     this.pushRow({ kind: 'error', text: `/${command} failed: ${errorChain(error)}` });