@armadra/agent 0.6.1 → 0.6.3

package/dist/modes/interactive/startup-header.js

@@ -1,19 +1,26 @@
 /**
  * 交互模式启动头（终端界面视觉设计 v1 §3.1）。
  *
- * - `normal`：宽度 ≥ 56 且非 `ui.compact` 时画框（宽 `min(width, 64)`，左对齐）——标题 `✻ ama x.y.z`、
- *   键值行（模型 / 目录 / 模式 / 已加载 / 宿主 / 警告）、按键提示；否则去框去键列，每项一行。
- * - `header`：一行 `✻ ama x.y.z · 模型 · 模式 · /help`，无框。`silent` 不输出（调用方不加本组件）。
- * - 着色：`✻` accent、标题粗体；键列 dim；模型 accent；已信任 success / 未信任 warning；Bypass 模式 warning；
- *   按键提示 dim。路径过长时从左截断（`…/armadra-agent`）。宽度变化时按新宽重算是否去框。
+ * - `normal`：无框。宽度 ≥ 72 时「AMA」字符画（startup-logo.ts）在左、信息列在右；48–71 列字符画在上、
+ *   空一行、信息列在下；< 48 列退回两行简洁头（不画字符画）。`ui.logo: "off"` 或 `ui.compact` 时只画信息列，
+ *   首行 `✻ ama x.y.z`。
+ * - 信息列：标题（版本）、模型 · 思考、目录 · 信任（来源）、模式 · 预设 · codemode、已加载 / 宿主 / 警告
+ *   （有才画）、按键提示。
+ * - `header`：一行 `✻ ama x.y.z · 模型 · 模式 · /help`。`silent` 不输出（调用方不加本组件）。
+ * - 着色：字符画按列 accent → user → tool 渐变；`✻` accent、标题粗体；模型 accent；已信任 success / 未信任
+ *   warning；Bypass 模式 warning；按键提示与分隔点 dim。路径过长时从左截断（`…/armadra-agent`）。
+ * - 启动动画通过 `setSweep` 改字符画的扫描位置（undefined = 定格），信息列不变。
  */
 import { msg } from "../../i18n/index.js";
 import { permissionModeLabel } from "../../permissions/modes.js";
-import { Box, KeyValue, padToWidth, truncateToWidth, visibleWidth, } from "../../tui.js";
-/** 画框的最小宽度；更窄时去框去键列。 */
-export const HEADER_BOX_MIN_WIDTH = 56;
-/** 设计稿写 60；常见的「供应商/模型@渠道 · 思考 级别」要 62 列左右才不截断，取 64。 */
-export const HEADER_BOX_MAX_WIDTH = 64;
+import { truncateToWidth, visibleWidth } from "../../tui.js";
+import { logoRows, logoWidth, paintLogo } from "./startup-logo.js";
+/** 字符画与信息列并排的最小宽度。 */
+export const HEADER_SIDE_MIN_WIDTH = 72;
+/** 画字符画的最小宽度；更窄时两行简洁头。 */
+export const HEADER_LOGO_MIN_WIDTH = 48;
+/** 字符画与信息列之间的空列。 */
+const GAP = 3;
 /** 从左截断到 `width` 列（保留末尾，前面加省略号）。 */
 export function truncateLeft(text, width, ellipsis = "…") {
     if (visibleWidth(text) <= width)
@@ -33,6 +40,13 @@ export function truncateLeft(text, width, ellipsis = "…") {
     }
     return ellipsis + out;
 }
+/** 按 ` · ` 分段的提示放不下时从末尾整段去掉（至少留第一段，再不够由调用方截断）。 */
+function fitSegments(text, width) {
+    const parts = text.split(" · ");
+    while (parts.length > 1 && visibleWidth(parts.join(" · ")) > width)
+        parts.pop();
+    return parts.join(" · ");
+}
 /** 去掉模型引用里的渠道（`@messages`）。 */
 function withoutChannel(model) {
     const at = model.indexOf("@");
@@ -42,6 +56,7 @@ export class StartupHeader {
     info;
     options;
     cache = null;
+    sweep;
     constructor(info, options) {
         this.info = info;
         this.options = options;
@@ -49,6 +64,19 @@ export class StartupHeader {
     get theme() {
         return this.options.theme;
     }
+    /** 这个宽度下是否画字符画（动画只在画了时播放）。 */
+    hasLogo(width) {
+        return (this.options.level === "normal" &&
+            this.options.logo !== "off" &&
+            this.options.compact !== true &&
+            width >= HEADER_LOGO_MIN_WIDTH);
+    }
+    setSweep(sweep) {
+        if (sweep === this.sweep)
+            return;
+        this.sweep = sweep;
+        this.cache = null;
+    }
     title() {
         const t = this.theme;
         return `${t.fg("accent", t.glyphs.thinking)} ${t.bold(`ama ${this.info.version}`)}`;
@@ -82,11 +110,15 @@ export class StartupHeader {
     render(width) {
         if (this.cache?.width === width)
             return this.cache.lines;
-        const lines = this.options.level === "header"
-            ? [this.headerLine(width)]
-            : this.options.compact === true || width < HEADER_BOX_MIN_WIDTH
-                ? this.plainLines(width)
-                : this.boxLines(width);
+        let lines;
+        if (this.options.level === "header")
+            lines = [this.headerLine(width)];
+        else if (width < HEADER_LOGO_MIN_WIDTH)
+            lines = this.narrowLines(width);
+        else if (!this.hasLogo(width))
+            lines = this.infoLines(width, this.title());
+        else
+            lines = this.logoLines(width);
         this.cache = { width, lines };
         return lines;
     }
@@ -101,66 +133,68 @@ export class StartupHeader {
         ];
         return truncateToWidth(parts.join(sep), width);
     }
-    plainLines(width) {
+    /** < 48 列：两行（版本 · 模型 · 思考 / 模式 · 目录 · 信任），有警告再加一行。 */
+    narrowLines(width) {
         const t = this.theme;
         const sep = t.fg("dim", " · ");
-        const ellipsis = t.glyphs.ellipsis;
         const { info } = this;
-        const lines = [this.title()];
-        lines.push(t.fg("accent", withoutChannel(info.model)) + sep + info.thinking);
+        const lines = [
+            [this.title(), t.fg("accent", withoutChannel(info.model)), info.thinking].join(sep),
+        ];
+        const mode = this.modeText();
         const trust = this.trustText(false);
-        const room = Math.max(4, width - visibleWidth(trust) - 3);
-        lines.push(truncateLeft(info.cwd, room, ellipsis) + sep + trust);
-        const mode = [this.modeText(), info.preset, this.codemodeText()].filter((p) => p !== undefined);
-        lines.push(mode.join(sep));
-        const loaded = this.loadedText();
-        if (loaded !== undefined)
-            lines.push(loaded);
-        const m = msg().interactive.startup.header;
-        if (info.host !== undefined)
-            lines.push(m.host(info.host));
-        if (info.warnings > 0)
-            lines.push(t.fg("warning", m.warnings(info.warnings)));
-        lines.push(t.fg("dim", m.hintCompact));
+        const room = Math.max(4, width - visibleWidth(mode) - visibleWidth(trust) - 6);
+        lines.push([mode, truncateLeft(info.cwd, room, t.glyphs.ellipsis), trust].join(sep));
+        if (info.warnings > 0) {
+            lines.push(t.fg("warning", msg().interactive.startup.header.warnings(info.warnings)));
+        }
         return lines.map((line) => truncateToWidth(line, width));
     }
-    boxLines(width) {
+    /** 信息列：首行 `title`，其后模型、目录、模式、可选行、按键提示；每行截到 `width`。 */
+    infoLines(width, title) {
         const t = this.theme;
         const sep = t.fg("dim", " · ");
         const { info } = this;
         const m = msg().interactive.startup.header;
-        const boxWidth = Math.min(width, HEADER_BOX_MAX_WIDTH);
-        // 键列至少 6 列（「已加载」的宽度），没有这一行时也对齐；英文键更宽时按最宽的键
-        const keyWidth = Math.max(6, ...[m.keyModel, m.keyDir, m.keyMode, m.keyLoaded, m.keyHost, m.keyWarnings].map((k) => visibleWidth(k)));
-        /** 框内文本宽：边框 2 + 内边距 2；键列 + 间隔 1。 */
-        const valueWidth = boxWidth - 4 - keyWidth - 1;
         const trust = this.trustText(true);
-        const cwdRoom = Math.max(4, valueWidth - visibleWidth(trust) - 3);
-        const rows = [
-            { key: m.keyModel, value: t.fg("accent", info.model) + sep + m.thinking(info.thinking) },
-            { key: m.keyDir, value: truncateLeft(info.cwd, cwdRoom, t.glyphs.ellipsis) + sep + trust },
-            {
-                key: m.keyMode,
-                value: [this.modeText(), m.preset(info.preset), this.codemodeText()]
-                    .filter((p) => p !== undefined)
-                    .join(sep),
-            },
+        const cwdRoom = Math.max(4, width - visibleWidth(trust) - 3);
+        const lines = [
+            title,
+            t.fg("accent", info.model) + sep + m.thinking(info.thinking),
+            truncateLeft(info.cwd, cwdRoom, t.glyphs.ellipsis) + sep + trust,
+            [this.modeText(), m.preset(info.preset), this.codemodeText()]
+                .filter((p) => p !== undefined)
+                .join(sep),
         ];
         const loaded = this.loadedText();
         if (loaded !== undefined)
-            rows.push({ key: m.keyLoaded, value: loaded });
+            lines.push(loaded);
         if (info.host !== undefined)
-            rows.push({ key: m.keyHost, value: info.host });
-        if (info.warnings > 0) {
-            rows.push({ key: m.keyWarnings, value: t.fg("warning", m.warningsValue(info.warnings)) });
+            lines.push(m.host(info.host));
+        if (info.warnings > 0)
+            lines.push(t.fg("warning", m.warnings(info.warnings)));
+        lines.push(t.fg("dim", fitSegments(m.hint, width)));
+        return lines.map((line) => truncateToWidth(line, width));
+    }
+    /** 字符画 + 信息列：够宽并排（顶端对齐），否则上下叠放。 */
+    logoLines(width) {
+        const t = this.theme;
+        const logo = paintLogo(t, this.sweep);
+        const logoCols = logoWidth(logoRows(t));
+        const title = `${t.bold("ama")} ${t.fg("dim", this.info.version)}`;
+        if (width < HEADER_SIDE_MIN_WIDTH) {
+            return [...logo, "", ...this.infoLines(width, title)];
+        }
+        const info = this.infoLines(width - logoCols - GAP, title);
+        const rows = Math.max(logo.length, info.length);
+        const blank = " ".repeat(logoCols);
+        const gap = " ".repeat(GAP);
+        const lines = [];
+        for (let i = 0; i < rows; i++) {
+            const right = info[i];
+            lines.push(right === undefined ? (logo[i] ?? "") : (logo[i] ?? blank) + gap + right);
         }
-        const padded = rows.map((row) => ({ ...row, key: padToWidth(row.key, keyWidth) }));
-        const kv = new KeyValue(padded, { theme: t, gap: 1, maxKeyRatio: 1 });
-        const body = {
-            render: (inner) => [this.title(), "", ...kv.render(inner), "", t.fg("dim", m.hint)],
-            invalidate: () => kv.invalidate(),
-        };
-        return new Box(body, { theme: t }).render(boxWidth);
+        return lines;
     }
     invalidate() {
         this.cache = null;

package/dist/modes/interactive/startup-logo.d.ts

@@ -0,0 +1,83 @@
+/**
+ * 启动头的「AMA」字符画与启动动画（终端界面视觉设计 v1 §3.1.1）。
+ *
+ * - 字形：缺省 5 行实心块字（`█▀▄`，宽 25）；ASCII 回退（`ui.ascii` / `AMA_ASCII=1`）用 figlet 风格的
+ *   `_ / \ |`（同为 5 行、宽 25）。
+ * - 着色：按列三段渐变 accent → user → tool（主题已有颜色，深浅主题 / 16 色都有对应值）；无色主题原样输出。
+ * - 动画（点亮扫描）：未扫到的列 dim，扫描头 3 列 text 粗体高亮，扫过的列定格为渐变色；每帧前进 1 列，
+ *   约 30 帧 × 32 ms ≈ 1 s，结束停在定格帧。动画只重画启动头所在行（差分渲染器原地改写），所以只在
+ *   整屏内容装得下视口时播放；任何时候 `finish()` 立即定格。
+ */
+import type { Theme, TUI } from "../../tui.js";
+/** 缺省字形（实心块字）。 */
+export declare const LOGO_BLOCK: readonly string[];
+/** 纯 ASCII 字形（只用 `_ / \ |`）。 */
+export declare const LOGO_ASCII: readonly string[];
+/** 扫描头的宽度（列）。 */
+export declare const SWEEP_BAND = 3;
+/** 帧间隔（ms）；帧数 = 字形宽 + 扫描头宽，总时长约 1 s（上限 1.2 s）。 */
+export declare const FRAME_MS = 32;
+export declare function logoRows(theme: Theme): readonly string[];
+/** 字形的列宽（逐字符都是 1 列）。 */
+export declare function logoWidth(rows: readonly string[]): number;
+/** 动画总帧数（不含定格帧）。 */
+export declare function sweepFrames(theme: Theme): number;
+/** 画字形：同样式的连续列合成一段，空格不着色；返回的每行都补足到字形宽。 */
+export declare function paintLogo(theme: Theme, sweep?: number): string[];
+/** 动画画到的目标（启动头）。 */
+export interface SweepTarget {
+    setSweep(sweep: number | undefined): void;
+}
+export interface LogoAnimationOptions {
+    frames: number;
+    intervalMs?: number;
+    /** 每帧之后请求重绘。 */
+    render(): void;
+    /** 每帧之前检查：返回 false（内容已超出视口等）立即定格。 */
+    canContinue?(): boolean;
+    /** 定格之后（走完或提前结束）调用一次。 */
+    onDone?(): void;
+}
+/** 一次性的点亮扫描：`start()` 从第 0 帧开始，走完或 `finish()` 后定格，不会再动。 */
+export declare class LogoAnimation {
+    private readonly target;
+    private readonly options;
+    private frame;
+    private timer;
+    private done;
+    constructor(target: SweepTarget, options: LogoAnimationOptions);
+    get running(): boolean;
+    start(): void;
+    private step;
+    /** 立即定格（按键、退出、走完）；重复调用无副作用。 */
+    finish(): void;
+}
+/** 是否播放启动动画的输入（interactive-mode 汇总）。 */
+export interface AnimationGate {
+    /** `ui.animation`。 */
+    animation: boolean | undefined;
+    /** 启动头确实画了 logo（normal 档、`ui.logo` 非 off、非 compact、宽度够）。 */
+    hasLogo: boolean;
+    colors: number;
+    io: {
+        stdoutIsTTY: boolean;
+    };
+    /** 嵌入宿主（profile.host）。 */
+    host: boolean;
+    /** 启动即提交的提示（`ama "..."`）；非空不播放。 */
+    prompt: string | undefined;
+    env: NodeJS.ProcessEnv;
+    rows: number;
+}
+/** 终端低于这个行数不播放（启动头 + 输入框 + 状态栏放不下时差分渲染会把动画帧滚进回滚区）。 */
+export declare const MIN_ANIMATION_ROWS = 16;
+export declare function shouldAnimate(gate: AnimationGate): boolean;
+/** 能播放动画的启动头。 */
+export interface AnimatedHeader extends SweepTarget {
+    hasLogo(width: number): boolean;
+}
+/**
+ * 界面启动后调用：条件满足就播放点亮扫描并返回动画（退出时 `finish()`），否则返回 undefined、启动头
+ * 直接是定格帧。按任意键立即定格——监听器不吞键，按键照常进输入框。
+ */
+export declare function playStartupAnimation(tui: TUI, header: AnimatedHeader | undefined, theme: Theme, conditions: Omit<AnimationGate, "hasLogo" | "colors" | "rows">): LogoAnimation | undefined;

package/dist/modes/interactive/startup-logo.js

@@ -0,0 +1,183 @@
+/**
+ * 启动头的「AMA」字符画与启动动画（终端界面视觉设计 v1 §3.1.1）。
+ *
+ * - 字形：缺省 5 行实心块字（`█▀▄`，宽 25）；ASCII 回退（`ui.ascii` / `AMA_ASCII=1`）用 figlet 风格的
+ *   `_ / \ |`（同为 5 行、宽 25）。
+ * - 着色：按列三段渐变 accent → user → tool（主题已有颜色，深浅主题 / 16 色都有对应值）；无色主题原样输出。
+ * - 动画（点亮扫描）：未扫到的列 dim，扫描头 3 列 text 粗体高亮，扫过的列定格为渐变色；每帧前进 1 列，
+ *   约 30 帧 × 32 ms ≈ 1 s，结束停在定格帧。动画只重画启动头所在行（差分渲染器原地改写），所以只在
+ *   整屏内容装得下视口时播放；任何时候 `finish()` 立即定格。
+ */
+/** 缺省字形（实心块字）。 */
+export const LOGO_BLOCK = [
+    " ▄███▄  ██▄   ▄██  ▄███▄",
+    "██▀ ▀██ ███▄ ▄███ ██▀ ▀██",
+    "███████ ██ ▀█▀ ██ ███████",
+    "██   ██ ██     ██ ██   ██",
+    "▀▀   ▀▀ ▀▀     ▀▀ ▀▀   ▀▀",
+];
+/** 纯 ASCII 字形（只用 `_ / \ |`）。 */
+export const LOGO_ASCII = [
+    "    _    __  __    _",
+    "   / \\  |  \\/  |  / \\",
+    "  / _ \\ | |\\/| | / _ \\",
+    " / ___ \\| |  | |/ ___ \\",
+    "/_/   \\_\\_|  |_/_/   \\_\\",
+];
+/** 扫描头的宽度（列）。 */
+export const SWEEP_BAND = 3;
+/** 帧间隔（ms）；帧数 = 字形宽 + 扫描头宽，总时长约 1 s（上限 1.2 s）。 */
+export const FRAME_MS = 32;
+const GRADIENT = ["accent", "user", "tool"];
+/** 每个字母起始列（渐变按字母分段，不把一个字母劈成两色）。 */
+const LETTER_STARTS = { block: [0, 8, 18], ascii: [0, 8, 16] };
+export function logoRows(theme) {
+    return theme.glyphs.ascii ? LOGO_ASCII : LOGO_BLOCK;
+}
+function letterColor(col, ascii) {
+    const starts = LETTER_STARTS[ascii ? "ascii" : "block"];
+    let index = 0;
+    for (let i = 0; i < starts.length; i++)
+        if (col >= starts[i])
+            index = i;
+    return GRADIENT[index];
+}
+/** 字形的列宽（逐字符都是 1 列）。 */
+export function logoWidth(rows) {
+    return Math.max(...rows.map((row) => [...row].length));
+}
+/** 动画总帧数（不含定格帧）。 */
+export function sweepFrames(theme) {
+    return logoWidth(logoRows(theme)) + SWEEP_BAND;
+}
+/** 第 `col` 列的样式；`sweep` 为扫描头所在列，undefined 为定格。 */
+function styleAt(col, ascii, sweep) {
+    const settled = { color: letterColor(col, ascii), bold: true };
+    if (sweep === undefined || col <= sweep - SWEEP_BAND)
+        return settled;
+    if (col <= sweep)
+        return { color: "text", bold: true };
+    return { color: "dim", bold: false };
+}
+/** 画字形：同样式的连续列合成一段，空格不着色；返回的每行都补足到字形宽。 */
+export function paintLogo(theme, sweep) {
+    const rows = logoRows(theme);
+    const width = logoWidth(rows);
+    return rows.map((row) => {
+        const chars = [...row.padEnd(width)];
+        let out = "";
+        let run = "";
+        let runStyle;
+        const flush = () => {
+            if (run === "")
+                return;
+            if (runStyle === undefined)
+                out += run;
+            else {
+                const colored = theme.fg(runStyle.color, run);
+                out += runStyle.bold ? theme.bold(colored) : colored;
+            }
+            run = "";
+        };
+        chars.forEach((ch, col) => {
+            const style = ch === " " ? undefined : styleAt(col, theme.glyphs.ascii, sweep);
+            if (style?.color !== runStyle?.color || style?.bold !== runStyle?.bold) {
+                flush();
+                runStyle = style;
+            }
+            run += ch;
+        });
+        flush();
+        return out;
+    });
+}
+/** 一次性的点亮扫描：`start()` 从第 0 帧开始，走完或 `finish()` 后定格，不会再动。 */
+export class LogoAnimation {
+    target;
+    options;
+    frame = 0;
+    timer;
+    done = false;
+    constructor(target, options) {
+        this.target = target;
+        this.options = options;
+    }
+    get running() {
+        return !this.done && this.timer !== undefined;
+    }
+    start() {
+        if (this.done || this.timer !== undefined)
+            return;
+        this.step();
+    }
+    step() {
+        this.timer = undefined;
+        if (this.frame >= this.options.frames || this.options.canContinue?.() === false) {
+            this.finish();
+            return;
+        }
+        this.target.setSweep(this.frame++);
+        this.options.render();
+        this.timer = setTimeout(() => this.step(), this.options.intervalMs ?? FRAME_MS);
+        this.timer.unref?.();
+    }
+    /** 立即定格（按键、退出、走完）；重复调用无副作用。 */
+    finish() {
+        if (this.done)
+            return;
+        this.done = true;
+        if (this.timer !== undefined)
+            clearTimeout(this.timer);
+        this.timer = undefined;
+        this.target.setSweep(undefined);
+        this.options.render();
+        this.options.onDone?.();
+    }
+}
+/** 终端低于这个行数不播放（启动头 + 输入框 + 状态栏放不下时差分渲染会把动画帧滚进回滚区）。 */
+export const MIN_ANIMATION_ROWS = 16;
+export function shouldAnimate(gate) {
+    const ci = gate.env["CI"];
+    return (gate.animation !== false &&
+        gate.hasLogo &&
+        gate.colors > 0 &&
+        gate.io.stdoutIsTTY &&
+        !gate.host &&
+        (gate.prompt ?? "").trim() === "" &&
+        (ci === undefined || ci === "" || ci === "0" || ci === "false") &&
+        gate.rows >= MIN_ANIMATION_ROWS);
+}
+/**
+ * 界面启动后调用：条件满足就播放点亮扫描并返回动画（退出时 `finish()`），否则返回 undefined、启动头
+ * 直接是定格帧。按任意键立即定格——监听器不吞键，按键照常进输入框。
+ */
+export function playStartupAnimation(tui, header, theme, conditions) {
+    const term = tui.terminal;
+    const columns = term.columns;
+    if (header === undefined)
+        return undefined;
+    const gate = {
+        ...conditions,
+        hasLogo: header.hasLogo(term.columns),
+        colors: theme.caps.colors,
+        rows: term.rows,
+    };
+    // 整屏内容装得下视口，动画帧才只在原地改写、不进回滚区
+    const fits = () => tui.render(term.columns).length <= term.rows;
+    if (!shouldAnimate(gate) || !fits())
+        return undefined;
+    let offInput = () => undefined;
+    const animation = new LogoAnimation(header, {
+        frames: sweepFrames(theme),
+        render: () => tui.requestRender(),
+        // 改了尺寸（差分渲染要整屏重画）也立即定格
+        canContinue: () => term.columns === columns && fits(),
+        onDone: () => offInput(),
+    });
+    offInput = tui.addInputListener(() => {
+        animation.finish();
+        return false;
+    });
+    animation.start();
+    return animation;
+}

package/dist/modes/interactive/status-area.d.ts

@@ -8,6 +8,9 @@
  *   session_rewound、/tree 之后；结果变化时重画。
  * - [W5-U] `model_fallback` 之后状态栏模型项显示 `主模型 → 回退模型`，切回主模型（`model_changed`）后消失。
  * - `telemetry_tick`（流式中 ≤ 2 Hz）只重取统计并重画（速率行），状态栏的内容这时不变。
+ * - [W6] 订阅配额（status-quota.ts）：记住最近一次 `quota_update`（账户级，换会话不清；换到别的供应商不显示），
+ *   full 时在状态栏下方占第三行、compact 时在行尾追加短项；第三行显示中每分钟重画一次（重置倒计时），
+ *   不显示时不挂计时器。Ctrl+G 折叠时第三行与速率行一起收起。
  */
 import type { AgentSession, SessionEvent } from "../../agent/types.js";
 import type { Runtime } from "../../cli/runtime.js";
@@ -15,6 +18,9 @@ import type { StatusLineMode } from "../../config/types.js";
 import { type Component, type Theme } from "../../tui.js";
 import { StatusBar } from "./status-bar.js";
 import { StatusLine } from "./status-line.js";
+import { QuotaLine, type QuotaView } from "./status-quota.js";
+/** 配额行重画间隔（倒计时只到分钟）。 */
+export declare const QUOTA_TICK_MS = 60000;
 /** 一行提示；空时不占行。 */
 export declare class HintLine implements Component {
     private text;
@@ -42,6 +48,10 @@ export declare class StatusArea {
     readonly hint: HintLine;
     readonly bar: StatusBar;
     readonly rate: StatusLine;
+    /** [W6] 订阅配额行（full 第三行）。 */
+    readonly quota: QuotaLine;
+    private lastQuota;
+    private ticker;
     private mode;
     private startedAt;
     private git;
@@ -52,6 +62,13 @@ export declare class StatusArea {
     private fallback;
     private bashSandbox;
     constructor(deps: StatusAreaDeps);
+    /** [W6] 当前模型走 ChatGPT 订阅时的配额；codex 还没数据为 pending，SIWC 没数据或非订阅模型不显示。 */
+    quotaView(): QuotaView;
+    private backendMemo;
+    /** 模型的 ChatGPT 订阅后端（渠道 compat `chatgptBackend`）；按引用记住上次结果。 */
+    private backendOf;
+    /** 第三行显示且有重置时间时每分钟重画；否则不挂计时器。 */
+    private syncTicker;
     layout(): StatusLineMode;
     /** [W6-A] 界面配置（Agent 栏开关、子 Agent 视图的消息显示选项）。 */
     ui(): NonNullable<Runtime["config"]["ui"]>;
@@ -64,6 +81,7 @@ export declare class StatusArea {
     /** 返回 true：事件已处理完（只需重画），调用方不再分派。 */
     onEvent(event: SessionEvent): boolean;
     dispose(): void;
+    private disposeGit;
     private gitView;
     private watchGit;
 }

package/dist/modes/interactive/status-area.js

@@ -8,6 +8,9 @@
  *   session_rewound、/tree 之后；结果变化时重画。
  * - [W5-U] `model_fallback` 之后状态栏模型项显示 `主模型 → 回退模型`，切回主模型（`model_changed`）后消失。
  * - `telemetry_tick`（流式中 ≤ 2 Hz）只重取统计并重画（速率行），状态栏的内容这时不变。
+ * - [W6] 订阅配额（status-quota.ts）：记住最近一次 `quota_update`（账户级，换会话不清；换到别的供应商不显示），
+ *   full 时在状态栏下方占第三行、compact 时在行尾追加短项；第三行显示中每分钟重画一次（重置倒计时），
+ *   不显示时不挂计时器。Ctrl+G 折叠时第三行与速率行一起收起。
  */
 import { msg } from "../../i18n/index.js";
 import { basename } from "node:path";
@@ -20,8 +23,11 @@ import { effectiveCodemodeMode } from "../../tools/presets.js";
 import { truncateToWidth } from "../../tui.js";
 import { StatusBar } from "./status-bar.js";
 import { StatusLine } from "./status-line.js";
+import { QuotaLine } from "./status-quota.js";
 /** 结束后可能改了工作区的工具。 */
 const WRITE_TOOLS = new Set(["write", "edit", "bash", "task"]);
+/** 配额行重画间隔（倒计时只到分钟）。 */
+export const QUOTA_TICK_MS = 60_000;
 /** 一行提示；空时不占行。 */
 export class HintLine {
     text = "";
@@ -38,6 +44,10 @@ export class StatusArea {
     hint = new HintLine();
     bar;
     rate;
+    /** [W6] 订阅配额行（full 第三行）。 */
+    quota;
+    lastQuota;
+    ticker;
     mode;
     startedAt;
     git;
@@ -79,10 +89,53 @@ export class StatusArea {
                     .session()
                     .getTools()
                     .some((tool) => tool.name === "bash"),
+            quota: () => this.quotaView(),
         };
         this.bar = new StatusBar(source, deps.theme);
         this.rate = new StatusLine(this.bar, source, deps.theme);
+        this.quota = new QuotaLine({ layout: () => this.mode, quota: () => this.quotaView(), now: () => deps.now() }, deps.theme);
         this.watchGit();
+        this.syncTicker();
+    }
+    /** [W6] 当前模型走 ChatGPT 订阅时的配额；codex 还没数据为 pending，SIWC 没数据或非订阅模型不显示。 */
+    quotaView() {
+        const model = this.deps.session().state.model;
+        if (model === undefined)
+            return undefined;
+        const backend = this.backendOf(formatModelRef(model));
+        if (backend === undefined)
+            return undefined;
+        const quota = this.lastQuota ?? this.deps.session().getStats().subscription?.quota;
+        if (quota !== undefined && quota.provider === model.provider)
+            return { quota };
+        return backend === "codex" ? "pending" : undefined;
+    }
+    backendMemo;
+    /** 模型的 ChatGPT 订阅后端（渠道 compat `chatgptBackend`）；按引用记住上次结果。 */
+    backendOf(ref) {
+        if (this.backendMemo?.ref === ref)
+            return this.backendMemo.backend;
+        const found = this.deps.runtime.providers.findModel(ref);
+        const value = found.ok
+            ? found.model.compat?.chatgptBackend
+            : undefined;
+        const backend = value === "codex" || value === "siwc" ? value : undefined;
+        this.backendMemo = { ref, backend };
+        return backend;
+    }
+    /** 第三行显示且有重置时间时每分钟重画；否则不挂计时器。 */
+    syncTicker() {
+        const view = this.mode === "full" ? this.quotaView() : undefined;
+        const ticking = typeof view === "object" &&
+            (view.quota.primary?.resetsAt !== undefined || view.quota.secondary?.resetsAt !== undefined);
+        if (ticking && this.ticker === undefined) {
+            this.ticker = setInterval(() => this.deps.render(), QUOTA_TICK_MS);
+            this.ticker.unref?.();
+        }
+        else if (!ticking && this.ticker !== undefined) {
+            clearInterval(this.ticker);
+            this.ticker = undefined;
+        }
     }
     layout() {
         return this.mode;
@@ -95,6 +148,7 @@ export class StatusArea {
         if (mode === this.mode)
             return;
         this.mode = mode;
+        this.syncTicker();
         (this.deps.redraw ?? this.deps.render)();
     }
     toggle() {
@@ -110,6 +164,7 @@ export class StatusArea {
         this.fallback = undefined;
         this.watchGit();
         this.bar.refresh();
+        this.syncTicker();
     }
     refreshGit() {
         void this.git?.refresh();
@@ -120,6 +175,10 @@ export class StatusArea {
             case "telemetry_tick":
                 this.bar.refresh();
                 return true;
+            case "quota_update":
+                this.lastQuota = event;
+                this.syncTicker();
+                return true;
             case "agent_settled":
             case "session_rewound":
                 this.refreshGit();
@@ -141,6 +200,7 @@ export class StatusArea {
                     if (formatModelRef(model) === this.fallback.from)
                         this.fallback = undefined;
                 }
+                this.syncTicker();
                 return false;
             }
             default:
@@ -148,6 +208,12 @@ export class StatusArea {
         }
     }
     dispose() {
+        this.disposeGit();
+        if (this.ticker !== undefined)
+            clearInterval(this.ticker);
+        this.ticker = undefined;
+    }
+    disposeGit() {
         this.offGit();
         this.git?.dispose();
         this.git = undefined;
@@ -162,7 +228,7 @@ export class StatusArea {
         const cwd = this.deps.session().state.cwd;
         if (cwd === this.gitCwd && this.git !== undefined)
             return;
-        this.dispose();
+        this.disposeGit();
         this.gitCwd = cwd;
         const git = new GitInfoWatcher(cwd, this.deps.env !== undefined ? { env: this.deps.env } : {});
         this.git = git;