mocode-ai 1.3.9 → 1.4.0

package/dist/ui/layout-internal/selection.js

@@ -0,0 +1,229 @@
+// L1 选区纯计算:归一化 / 取文本 / 高亮 / 输入框坐标映射(无副作用、不写屏)。
+// 从 layout-internal/core.ts 按依赖分层拆出;可变运行态集中在 ./state.ts。
+import { charWidth, displayWidth, wrapByDisplayWidth, stripAnsi, sliceByDisplayCol } from '../render.js';
+import * as content from '../content.js';
+import { readClipboard } from '../clipboard.js';
+import { state } from './state.js';
+import { getGeo } from './screen.js';
+/** 选区归一化(anchor/end 按阅读顺序排序为 start/end)。无选区返 null。 */
+export function normalizeSelection() {
+    if (!state.selection)
+        return null;
+    const a = { line: state.selection.anchorLine, col: state.selection.anchorCol };
+    const b = { line: state.selection.endLine, col: state.selection.endCol };
+    const aFirst = a.line < b.line || (a.line === b.line && a.col <= b.col);
+    return aFirst
+        ? { startLine: a.line, startCol: a.col, endLine: b.line, endCol: b.col }
+        : { startLine: b.line, startCol: b.col, endLine: a.line, endCol: a.col };
+}
+/** 给自洽带色行的显示列区间 [colStart,colEnd) 套「统一亮黄底 + 黑字」。
+ *  强制重设前/背景,无视原 SGR:md 字符常带 ui.dim / ui.cyan / ui.gray 等,
+ *  仅靠 SGR 7 反转对比度极弱;改用显式「亮黄底 SGR 103 + 黑前景 SGR 30」,
+ *  跨终端一致。退反白用 0 清 SGR,行末 active SGR 自然续接。
+ *  关键:反白 active 期间**吃掉所有行内 SGR**(不让前景色干扰)——否则
+ *  行内首个 \x1B[2m(dim)/\x1B[36m(cyan)/\x1B[1m(bold) 进选区后仍生效,
+ *  前景被压回原色,整片亮黄底被切割、看着「花」;直穿则带 dim 等,对比不足。
+ *  反白外 SGR 直穿,保留原色。 */
+export const SEL_OPEN = '\x1B[30;103m'; // 30:黑前景 | 103:亮黄背景
+export const SEL_OFF = '\x1B[0m'; // 全清 SGR,行末 active 状态续接
+export function highlightRange(line, colStart, colEnd) {
+    if (colEnd <= colStart)
+        return line;
+    const parts = line.split(/(\x1b\[[0-9;]*m)/);
+    let w = 0;
+    let out = '';
+    let opened = false;
+    for (let i = 0; i < parts.length; i++) {
+        if (i % 2 === 1) {
+            // SGR 段:反白内直接吃,不让行内前景色进选区;反白外直穿,保留原色。
+            if (opened)
+                continue;
+            out += parts[i];
+            continue;
+        }
+        for (const ch of parts[i]) {
+            const cw = charWidth(ch.codePointAt(0) ?? 0);
+            if (!opened && w >= colStart && w < colEnd) {
+                out += SEL_OPEN;
+                opened = true;
+            }
+            if (opened && w >= colEnd) {
+                out += SEL_OFF;
+                opened = false;
+            }
+            out += ch;
+            w += cw;
+        }
+    }
+    if (opened)
+        out += SEL_OFF;
+    return out;
+}
+/** 从归一化选区抠出纯文本(去 ANSI,按显示列裁切,行间 \n 拼接)。越界行跳过(缓冲被 trim 等边界情况)。 */
+export function extractSelectionText(sel) {
+    const out = [];
+    for (let abs = sel.startLine; abs <= sel.endLine; abs++) {
+        const raw = content.lineAt(abs);
+        if (raw == null)
+            continue;
+        const plain = stripAnsi(raw);
+        const lineW = displayWidth(plain);
+        const colStart = abs === sel.startLine ? sel.startCol : 0;
+        const colEnd = abs === sel.endLine ? sel.endCol : lineW;
+        out.push(sliceByDisplayCol(plain, colStart, colEnd));
+    }
+    return out.join('\n');
+}
+/** 输入框选区归一化:按 (line, col) 字典序排成 start/end。无选区返 null。 */
+export function normalizeInputSelection() {
+    if (!state.inputSelection)
+        return null;
+    const a = state.inputSelection.anchor;
+    const b = state.inputSelection.end;
+    const aFirst = a.line < b.line || (a.line === b.line && a.col <= b.col);
+    return aFirst
+        ? { startLine: a.line, startCol: a.col, endLine: b.line, endCol: b.col }
+        : { startLine: b.line, startCol: b.col, endLine: a.line, endCol: a.col };
+}
+/** 从归一化输入框选区抠出纯文本(lines 上不带 ANSI,直接按 display_col 切)。越界行跳到该行末尾。 */
+export function extractInputSelectionText(sel) {
+    if (!state.lastView)
+        return '';
+    const out = [];
+    for (let l = sel.startLine; l <= sel.endLine; l++) {
+        const raw = state.lastView.lines[l];
+        if (raw == null)
+            continue;
+        const lineW = displayWidth(raw);
+        const colStart = l === sel.startLine ? sel.startCol : 0;
+        const colEnd = l === sel.endLine ? sel.endCol : lineW;
+        out.push(sliceByDisplayCol(raw, colStart, colEnd));
+    }
+    return out.join('\n');
+}
+/** 输入框 lastView 签名:lines 数 + 每行 display_w 累加;任何键改动 lines 即变化,用作 inputSelection 失效判据。 */
+export function inputViewSig(view) {
+    if (!view)
+        return '';
+    return view.lines.length + '|' + view.lines.map((l) => displayWidth(l).toString()).join(',');
+}
+/** 屏行是否落在底栏输入行范围内(paintInput 的 firstInputRow..firstInputRow+inputRowsAvail-1)。 */
+export function isInputRow(row) {
+    const g = getGeo();
+    const firstInputRow = g.contentBottom + 3 + state.planRows;
+    const inputRowsAvail = Math.max(0, g.footerH - 4 - state.planRows);
+    return row >= firstInputRow && row < firstInputRow + inputRowsAvail;
+}
+/** 右键单击输入行(未拖动的 press→release):读剪贴板 + 回调 pasteHandler 贴入。异步但不阻塞其他事件。 */
+export function pasteIntoInput() {
+    if (!state.pasteHandler)
+        return;
+    const handler = state.pasteHandler;
+    readClipboard()
+        .then((text) => {
+        if (text && state.active)
+            handler(text);
+    })
+        .catch(() => { });
+}
+/**
+ * 把屏(行,列)反推到 (lines 行号, 行内 display_col, flatIdx, 段内显示列),
+ * 算法与 setInputCursorFromClick 抽出前等价——基于 lastView 的"折行 + 滚动窗"几何,
+ * 与 paintInput 的 windowInputVis 同源(startVis 同锚),保证 press/drag 落点 = 画上高亮位置。
+ * 越界点(空行)→ 落末行末段末。
+ */
+export function inputScreenToInputPos(screenRow, screenCol) {
+    if (!state.lastView)
+        return null;
+    const g = getGeo();
+    const promptW = displayWidth(state.lastView.prompt);
+    const firstInputRow = g.contentBottom + 3 + state.planRows;
+    const inputRowsAvail = Math.max(0, g.footerH - 4 - state.planRows);
+    // 输入框可视区的 (visRow, visCol) 屏幕坐标 → 0-based。
+    // 点到可视区末行之下(空白区)→ 落到最末可视行(光标归最后一段);isInputRow 已挡可视区之上的点击。
+    const visRow = Math.max(0, Math.min(screenRow - firstInputRow, Math.max(0, inputRowsAvail - 1)));
+    // 屏幕列 (1-based SGR) → 显示列 (0-based),再扣 prompt 宽;尾点容许越界 clip 到 >=0。
+    const visCol = Math.max(0, screenCol - 1 - promptW);
+    // 复刻 windowInputVis 的折行 + 滚动窗(输入态, lines 全量参与)。
+    // lastView.lines 在 prompt 的 redraw() 中为 dispLines()(含 chip pre 行 / chip prefix 列);
+    // chip 模式下点击 chip 区域也走同一算法,与 paintInput 的视协议(段接缝除外)一致。
+    const cols = Math.max(1, g.cols - promptW);
+    const lineVis = state.lastView.lines.map((l) => wrapByDisplayWidth(l, cols));
+    const flat = [];
+    for (const lv of lineVis)
+        for (const r of lv)
+            flat.push(r);
+    const totalVis = flat.length;
+    const maxInputRows = Math.max(1, Math.floor(g.rows * 0.4));
+    // 起窗偏移:用 lastView 当前光标位置作为锚(与 paintInput 同算法)。
+    let curVisLine = 0;
+    {
+        const clRows = lineVis[state.lastView.cursorLine] ?? [''];
+        let acc = 0;
+        for (let i = 0; i < clRows.length; i++) {
+            const rw = displayWidth(clRows[i]);
+            if (state.lastView.cursorCol <= acc + rw) {
+                curVisLine = i;
+                break;
+            }
+            acc += rw;
+            curVisLine = i;
+        }
+    }
+    let curAbs = curVisLine;
+    for (let i = 0; i < state.lastView.cursorLine; i++)
+        curAbs += lineVis[i].length;
+    const startVis = totalVis > maxInputRows ? Math.max(0, Math.min(curAbs - maxInputRows + 1, totalVis - maxInputRows)) : 0;
+    // 点到可视区末行之下(空行)→ 等价"光标在最末可视行的字符串末尾"。
+    if (startVis + visRow >= totalVis) {
+        const lastFlatIdx = totalVis - 1;
+        // 把 lastFlatIdx 反推到 (line, segInLine)
+        let lastLine = 0;
+        let lastSegInLine = lastFlatIdx;
+        while (lastLine < lineVis.length && lastSegInLine >= lineVis[lastLine].length) {
+            lastSegInLine -= lineVis[lastLine].length;
+            lastLine++;
+        }
+        if (lastLine >= lineVis.length) {
+            lastLine = lineVis.length - 1;
+            lastSegInLine = lineVis[lastLine].length - 1;
+        }
+        // lines[lastLine] 内 display_col = 前 segInLine 段 display_w + 末段 display_w
+        let inLineDisplayCol = 0;
+        for (let s = 0; s <= lastSegInLine; s++)
+            inLineDisplayCol += displayWidth(lineVis[lastLine][s] ?? '');
+        return {
+            line: lastLine,
+            displayCol: inLineDisplayCol,
+            flatIdx: lastFlatIdx,
+            inSegVis: displayWidth(flat[lastFlatIdx]), // 段末
+        };
+    }
+    // flatIdx = 点击可视段在 flat 中的绝对索引(startVis + visRow)
+    const flatIdx = startVis + visRow;
+    // 把 flatIdx 反推到 (line, segInLine) — line 给 paintInput 用(同 lines[cursorLine] 行号),
+    // segInLine 给 prompt 做 cl/cc 反推用。
+    let line = 0;
+    let segInLine = flatIdx;
+    while (line < lineVis.length && segInLine >= lineVis[line].length) {
+        segInLine -= lineVis[line].length;
+        line++;
+    }
+    if (line >= lineVis.length) {
+        line = lineVis.length - 1;
+        segInLine = lineVis[line].length - 1;
+    }
+    // lines[line] 内 display_col = 前 segInLine 段 display_w 累加 + 段内显示列。
+    let inLineDisplayCol = 0;
+    for (let s = 0; s < segInLine; s++)
+        inLineDisplayCol += displayWidth(lineVis[line][s] ?? '');
+    const seg = flat[flatIdx];
+    const segW = displayWidth(seg);
+    const inSeg = Math.min(visCol, segW); // 段尾点击容许越界 clip 到段末
+    return {
+        line,
+        displayCol: inLineDisplayCol + inSeg,
+        flatIdx,
+        inSegVis: inSeg,
+    };
+}

package/dist/ui/layout-internal/state.js

@@ -0,0 +1,82 @@
+// layout 共享可变状态单例。
+//
+// 全屏 TUI 的各职责模块(screen / content-write / scroll / statusbar / input-paint / mouse)
+// 读写同一批游标与缓存:contentRow 由 content-write 写、scroll 与 input-paint 读;
+// planRows 同时驱动 statusbar 撑高与 geo 重算。这种交叉引用做不成依赖注入(会立刻循环),
+// 故收进单一对象,各模块 import 同一实例。
+//
+// 约定:
+//  - 只放**可变**运行态。纯常量(esc 序列表 / SCROLL_LOCK_MS / RUNNING_FRAMES 等)留在使用它的模块。
+//  - 字段按职责分组,组名与 layout-internal/ 下的文件划分对齐。
+//  - 不要在模块顶层读 state 快照(如 `const x = state.scrollOffset`)——必须每次现取,
+//    否则跨 await / 定时器会读到过期值。
+export const state = {
+    // ── 屏幕生命周期(alt screen / console 劫持 / resize / 退出钩子) ──
+    active: false,
+    consoleHookInstalled: false,
+    mode: 'input',
+    resizeTimer: null,
+    lastTerminalCols: 0,
+    exitHandler: null,
+    sigwinchHandler: null,
+    // ── 几何(底栏高度,contentBottom = rows - footerH) ──
+    footerH: 6, // 1 虚拟空行 + 1 spinner行 + 1 上线 + 输入行数 + 1 下线 + 1 model行(两行式底栏)
+    // ── 内容写入(续写位 / markdown 流式段 / banner / 欢迎块) ──
+    contentRow: 1, // 续写位行(1-based,屏坐标,[1,contentBottom])
+    contentCol: 1, // 续写位列(1-based)
+    segmentStartRow: 1, // 当前 md 段起始屏行(供 contentWriteMd 定位段末续写位;段内行数由 content 段标记跟踪)
+    /** markdown 流式段:agent onText 的 chunk 累积到 mdBuf,每 chunk 把整段经 renderMarkdown
+     *  渲成自洽行,replace 缓冲段(content.setLines)+ repaintViewport 重画。mdActive 期间任何
+     *  非 md 写(contentWrite)先 commitMd 收尾(清 segMark,后续写不再被 setLines 截断)。 */
+    mdActive: false,
+    mdBuf: '',
+    bannerH: 0,
+    welcomeStart: -1, // 块起点(content.committedRows 口径的绝对行索引)
+    welcomeRows: 0, // 块行数(0 = 屏上无欢迎块)
+    // ── 滚动与流式暂停(回看冻结 / 打字期停物理写) ──
+    scrollOffset: 0, // 滚动回看距尾行数(0=尾,跟随新内容);>0 时 viewport 显历史、状态行显滚动指示
+    scrollLockUntil: 0, // 发消息轮首滚动锁(绝对时间戳 ms,0=未锁):吸收 stdin 残留滚轮事件,防 resetScroll 回尾后被重新滚上去
+    /** 运行态用户打字时暂停流式物理写:流式每个 token 要 cup 到 contentRow 写入,IME 候选窗逐光标移动跟踪会跟过去;
+     *  用户打字期间只喂缓冲、不物理写,光标留输入框;停手 USER_ACTIVE_PAUSE_MS 后 flush 重画缓冲内容。 */
+    userActiveUntil: 0, // 打字活跃截止时刻(Date.now()+PAUSE);0=未活跃
+    flushTimer: null, // 用户停手后 flush 缓冲内容(repaintViewport)
+    // ── 状态栏(底栏文案 / spinner / 走时 / plan chip / live 帧位) ──
+    base: null,
+    /** 运行态实时 token 用量(agent core 流式推送,轮末 repl 清 undefined)。
+     *  composeModelLine 在 RUNNING 态把它画成 chip 放 context 进度条左侧;
+     *  不主动触发重画——RUNNING 态 turnTimer 80ms 心跳重画自然取最新值。 */
+    liveUsage: undefined,
+    statusText: '',
+    spinnerFrame: undefined,
+    turnStart: null, // RUNNING 态起点(Date.now());INPUT 态为 null。composeStatus 据此拼走时。
+    turnTimer: null, // 走时刷新计时器(独立于 spinner):流式期间 spinner 停转,由它续刷状态行。
+    /** 当前 plan chip 占用脚栏行数(1 或 2)。composePlanLines 每次重算后写入。
+     *  驱动 paintInput setRegion(fh) 动态撑高脚栏;drawStatusBar 据此画 1/2 行 plan,
+     *  与 spinner/上线/输入/下线/model 行的 +1/+2/+3/+4/+5 偏移天然一致(contentBottom 自动重算)。 */
+    planRows: 1,
+    runningFrame: -1, // 运行态状态行 chip 心跳帧(转圈帧 明灭);INPUT 态 -1 退回静态 ●
+    /** 上一次 paintLiveAtCursor 实际画帧的屏坐标(0=未画)。clearLiveAtCursor 清"这行"而非当前续写位——
+     *  防 spinner 运行期间续写位漂移时清错行、旧帧行残留(见 557e678 移除 isStreamingPaused 后的间歇性 frame 泄漏)。 */
+    frameRow: 0,
+    frameCol: 0,
+    // ── 输入框绘制(上次视图 / 菜单擦除坐标 / 粘贴与光标回调) ──
+    lastView: null,
+    lastMenuStartRow: 0, // 上次菜单起始屏行(供擦除)
+    lastMenuRows: 0,
+    /** 上次画过输入框的 lastView 签名(lines 数 + 每行 display_w 累加);变了说明 prompt.ts 改了文本 → 选区锚点失效,清掉。 */
+    lastInputSig: '',
+    pasteHandler: null,
+    /** 鼠标点击输入框 → prompt.ts(文本 source of truth)提供的光标应用回调;
+     *  layout 只做"点击 → 算新位置"的映射,实际改 cl/cc 归 prompt(同 pasteHandler 套路)。
+     *  若未注册(非输入态/未进 prompt):仅做视觉反馈,cl/cc 不变。 */
+    cursorChangeHandler: null,
+    // ── 鼠标选区(内容区框选 / 输入框反白 / picker 期禁鼠标) ──
+    selection: null,
+    selecting: false, // 左键按下中(press→release 之间)
+    mouseEnabled: true, // 导航菜单(picker)期间置 false:只吞报表不做选区/滚动,防菜单被 viewport 重画覆盖
+    inputSelection: null,
+    /** overlay 鼠标接管者(composer 输入面板等全屏弹窗)。非 null 时所有鼠标事件先喂给它,
+     *  返回 true = 已消费(不再走 layout 默认处理);弹窗自己消费全部事件,
+     *  防止背景选区/翻页触发 repaintViewport 重画覆盖弹窗。传 null 注销。 */
+    overlayMouseHandler: null,
+};

package/dist/ui/layout-internal/statusbar.js

@@ -0,0 +1,351 @@
+// L1 状态栏:两行式底栏(spinner 行 + model 行)的拼装与绘制、走时心跳。
+// 从 layout-internal/core.ts 按依赖分层拆出;可变运行态集中在 ./state.ts。
+import { stdout } from 'node:process';
+import { displayWidth, truncateDisplay, ansiDisplayWidth, fmtElapsed, stripAnsi } from '../render.js';
+import { ui } from '../theme.js';
+import * as content from '../content.js';
+import { t } from '../../i18n/index.js';
+import { state } from './state.js';
+import { esc, cup, getGeo, runningCaretPos, isStreamingPaused } from './screen.js';
+const RUNNING_FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+// ── 状态行(两行式:spinner 行 + model 行)──
+const STATUS_SEP = '  ';
+const STATUS_SEP_W = STATUS_SEP.length;
+/** 通用两段式排版:左段左端对齐 + 空格填充 + 右段右端对齐。pad 至少 1 空格防粘连。 */
+function twoColumn(leftStr, leftW, rightStr, rightW, cols) {
+    const pad = Math.max(1, cols - leftW - rightW);
+    return `${leftStr}${' '.repeat(pad)}${rightStr}`;
+}
+/** 上线之上那行(spinner 行):左段 = spinner 帧 + 状态文字 + 走时(全部左对齐,紧跟不分离)。
+ *  右段仅在滚动回看时显历史指示(右端对齐)。
+ *  示例:
+ *    INPUT:     ● 空闲
+ *    思考中:    ⠹ 思考中… 0.5s
+ *    运行心跳:  ⠋ 生成中 0.5s
+ *    滚动回看:  ● 空闲                  历史 ↑3 (PgDn 回底)  */
+export function composeSpinnerLine(status, cols) {
+    const spinning = state.mode === 'running' && state.runningFrame >= 0;
+    const hasSpinner = !!status.spinnerFrame;
+    const scrolled = state.scrollOffset > 0;
+    // 走时(仅运行态)
+    const elapsed = state.mode === 'running' && state.turnStart != null ? fmtElapsed(Date.now() - state.turnStart) : '';
+    // ── 左段:帧 + 状态 + 走时,全部紧跟 ──
+    let lead;
+    let leadW;
+    if (scrolled) {
+        // 滚动回看:左段 = 符号(● 或 心跳帧) + 状态名 + (运行态)走时;右段 = 历史指示。
+        // 跟非回看态严格对齐——RUNNING 态显示走时,INPUT 态不显示,避免滚动时信息降级。
+        const symbol = spinning
+            ? `${ui.bold}${ui.accent}${RUNNING_FRAMES[state.runningFrame]}${ui.reset}`
+            : `${ui.accent}●${ui.reset}`;
+        // spinning(运行态流式中 spinner 已停,靠 turnTimer 心跳):同非滚动 spinning 分支加
+        // || '生成中' fallback——流式首 token 到即 spinner.stop(),若 stop() 回调未留状态字,
+        // 此处兜底不再让 lead 只剩心跳帧字符(用户误读为"左侧蒸发了")。
+        const label = spinning ? status.status || '生成中' : status.status;
+        const ePart = elapsed ? ` ${ui.dim}${elapsed}${ui.reset}` : '';
+        lead = `${symbol} ${ui.dim}${label}${ui.reset}${ePart}`;
+        leadW = 1 + 1 + displayWidth(label) + (elapsed ? 1 + displayWidth(elapsed) : 0);
+    }
+    else if (hasSpinner) {
+        // spinner 激活(思考中/执行工具…):帧 + 状态 + 走时
+        const ePart = elapsed ? ` ${ui.dim}${elapsed}${ui.reset}` : '';
+        lead = `${ui.bold}${ui.accent}${status.spinnerFrame}${ui.reset} ${ui.dim}${status.status}${ui.reset}${ePart}`;
+        leadW = 1 + 1 + displayWidth(status.status) + (elapsed ? 1 + displayWidth(elapsed) : 0);
+    }
+    else if (spinning) {
+        // 运行态心跳帧(流式输出中 / 命令态如 /rollback /compact /resume):帧 + 状态文字(优先)或生成中(兜底) + 走时
+        const label = status.status || '生成中';
+        const ePart = elapsed ? ` ${ui.dim}${elapsed}${ui.reset}` : '';
+        lead = `${ui.bold}${ui.accent}${RUNNING_FRAMES[state.runningFrame]}${ui.reset} ${ui.dim}${label}${ui.reset}${ePart}`;
+        leadW = 1 + 1 + displayWidth(label) + (elapsed ? 1 + displayWidth(elapsed) : 0);
+    }
+    else {
+        // INPUT 态:● + 状态文字(无走时)
+        lead = `${ui.accent}●${ui.reset} ${ui.dim}${status.status}${ui.reset}`;
+        leadW = 1 + 1 + displayWidth(status.status);
+    }
+    // ── 右段:仅滚动回看时显历史指示 ──
+    let tail = '';
+    let tailW = 0;
+    if (scrolled) {
+        tail = t('status.history', { count: state.scrollOffset });
+        tailW = displayWidth(tail);
+    }
+    const rightStr = tail ? `${ui.yellow}${tail}${ui.reset}` : '';
+    return twoColumn(lead, leadW, rightStr, tailW, cols);
+}
+/** 下线之下那行(model 行):左 = 模式标识 + 本轮 token chip;右 = context + cwd,右端对齐。
+ *  活跃 plan chip 不再放这里,改放 spinner 行上方的「虚拟空行」(contentBottom+1,见 drawStatusBar),
+ *  既不挤 model 行,又给输入区上方留出可视分隔带。 */
+export function composeModelLine(status, cols) {
+    const ctx = status.contextBar; // 已带色
+    const ctxW = ansiDisplayWidth(ctx);
+    // 左段:模式标识 + 切换提示(灰)+ 本轮 token chip。token chip 仅展示总量,用 mid 灰,不抢主色。
+    const modeTag = status.modeTag ?? '';
+    const modeColor = modeTag === 'Plan' ? ui.yellow : ui.accent;
+    const modePart = modeTag ? `${modeColor}${modeTag}${ui.reset}` : '';
+    const modeW = modeTag ? displayWidth(modeTag) : 0;
+    // 切换提示:告诉用户怎么切模式。灰(dim)降优先级,不与 modeTag 抢色;只在有 modeTag 时出现。
+    const HINT = t('status.modeSwitch');
+    const hintW = modeTag ? displayWidth(HINT) : 0;
+    const hintPart = modeTag ? `${ui.dim}${HINT}${ui.reset}` : '';
+    const tokChip = formatTurnTokenChip(status.lastTurnUsage);
+    const tokW = displayWidth(stripAnsi(tokChip));
+    // 合并左段:段间留 2 空格分隔。极窄时 hint 与 chip 都可能藏掉。
+    // 优先级:modeTag(必) > chip(提示累计 token,有信息量)> hint(纯说明性,窄时最先省)。
+    const sepMH = modePart && (hintPart || tokChip) ? '  ' : '';
+    const sepHT = hintPart && tokChip ? '  ' : '';
+    const leftStr = `${modePart}${sepMH}${hintPart}${sepHT}${tokChip}`;
+    const leftW = modeW +
+        (modePart && (hintPart || tokChip) ? sepMH.length : 0) +
+        hintW +
+        (hintPart && tokChip ? sepHT.length : 0) +
+        tokW;
+    // 右段:实时用量 chip(仅 RUNNING)+ ctx + sep + cwd,右端对齐。cwd 按预算截断,极窄(<6)隐藏。
+    // 实时 chip 放 context 进度条左侧:本轮累计 ↑prompt ↓completion,流式实时增长。
+    // 任一 chip 极宽时收紧 cwd(toolbar 列挤压场景),先从 cwd 砍、再隐藏 cwd、再按 hint→chip 顺序省。
+    const liveChip = state.mode === 'running' && state.liveUsage ? formatLiveUsageChip(state.liveUsage) : '';
+    const liveW = displayWidth(stripAnsi(liveChip));
+    const liveSepW = liveChip ? STATUS_SEP_W : 0;
+    const minGap = 2;
+    const cwdBudget = cols - leftW - minGap - liveW - liveSepW - ctxW - STATUS_SEP_W - 1;
+    const cwd = cwdBudget >= 6 ? truncateDisplay(status.cwd, cwdBudget) : '';
+    const cwdW = displayWidth(cwd);
+    const rightStr = `${liveChip}${liveChip ? STATUS_SEP : ''}${ctx}${STATUS_SEP}${ui.dim}${cwd}${ui.reset}`;
+    const rightW = liveW + liveSepW + ctxW + STATUS_SEP_W + cwdW;
+    // 极窄:逐步降级——先藏 hint,再藏 token chip,只剩 modeTag 与右段挤。
+    // 这样 80 列宽终端下 hint 和 chip 都能稳住,只 <50 列才退化到只剩 modeTag。
+    if (leftW + minGap + rightW > cols) {
+        // 优先藏 hint(纯说明,信息密度最低):仅留 modePart + sep + tokChip
+        if (modePart && tokChip && hintPart) {
+            const leftStr2 = `${modePart}${sepMH}${tokChip}`;
+            const leftW2 = modeW + sepMH.length + tokW;
+            if (leftW2 + minGap + rightW <= cols) {
+                return twoColumn(leftStr2, leftW2, rightStr, rightW, cols);
+            }
+        }
+        // 再藏 token chip:仅留 modePart
+        if (modePart && tokChip) {
+            return twoColumn(modePart, modeW, rightStr, rightW, cols);
+        }
+    }
+    return twoColumn(leftStr, leftW, rightStr, rightW, cols);
+}
+/** 把本轮 token 总量格式化成 chip 文本(纯字符串,带 ANSI 色)。无 usage 返空串。
+ *  显示策略:chip 信息密度有限,只显示总量 + 一个 ↻ 标记表示有 cache 命中。
+ *  详细分项(↑↓ 计费/↻ 缓存/reasoning)在 turn 末 summary 行展示,不在此处展开。 */
+function formatTurnTokenChip(usage) {
+    if (!usage || !usage.totalTokens)
+        return '';
+    const n = usage.totalTokens;
+    const text = n < 1000 ? `${n}` : `${(n / 1000).toFixed(n >= 10000 ? 0 : 1)}k`;
+    const cached = usage.cachedTokens ?? 0;
+    const cacheTag = cached > 0 ? ` ↻ ${cached < 1000 ? cached : `${(cached / 1000).toFixed(cached >= 10000 ? 0 : 1)}k`}` : '';
+    // chip 用 mid 灰(降优先级)— 模式仍是主色
+    return `${ui.dim}${text} tokens${cacheTag}${ui.reset}`;
+}
+/** 运行态实时用量 chip(放 context 进度条左侧):↑计费prompt(裸-cached,与轮末摘要 (↑…) 同口径)
+ *  ↓completion,cache 命中带 ↻ 标记;缩写与轮末摘要 / 左侧 turn chip 同款。
+ *  流式期为估算值,每步末尾 usage chunk 到达后换实测;dim 灰降优先级,不与进度条阈值警示抢色。 */
+function formatLiveUsageChip(u) {
+    const fmt = (n) => (n < 1000 ? `${n}` : `${(n / 1000).toFixed(n >= 10000 ? 0 : 1)}k`);
+    const cached = u.cachedTokens ?? 0;
+    const billable = Math.max(0, u.promptTokens - cached);
+    const cacheTag = cached > 0 ? ` ↻ ${fmt(cached)}` : '';
+    return `${ui.dim}↑ ${fmt(billable)} ↓ ${fmt(u.completionTokens)}${cacheTag}${ui.reset}`;
+}
+/** spinner 行上方的「虚拟空行」(contentBottom+1)。
+ *  - 有活跃 plan:显「plan: <summary> ▸ N. step」整行左对齐(yellow)
+ *  - 无活跃 plan:空(保留原分隔视觉,避免内容贴输入区)
+ *  - 过长(> cols):始终**截断保 1 行 + "…"**,不撑高脚栏、不拆 2 行——
+ *    步进式任务标题/current step 通常是自然语言,即使切「 ▸ 」拆 2 行,第 2 行也大概率仍超长
+ *    (实测「第三步:实现核心业务模块。…」本身就比 cols 长),拆完依然覆盖 spinner/输入区,得不偿失。
+ *    截断 + "…" 一行内永远不溢出,脚栏恒 6 行,spinner/输入/下线/model 行偏移稳定。
+ *  这行在 DECSTBM 滚动区外([1, contentBottom]),稳定不滚。 */
+export function composePlanLines(status, cols) {
+    const plan = (status.planSummary ?? '').trim();
+    if (!plan) {
+        state.planRows = 1;
+        return [];
+    }
+    const w = displayWidth(stripAnsi(plan));
+    if (w <= cols) {
+        state.planRows = 1;
+        return [`${ui.yellow}${plan}${ui.reset}`];
+    }
+    // 溢出:截断为 1 行 + "…" 后缀(留 1 列空间给省略号)。
+    state.planRows = 1;
+    return [`${ui.yellow}${truncateDisplay(plan, Math.max(1, cols - 1))}…${ui.reset}`];
+}
+/** 画状态行(plan 行 + spinner 行 + model 行,三行)。RUNNING 态 spinner 频繁调。
+ *  行号(footerH=6 当 plan 单行;footerH=7 当 plan 撑 2 行):
+ *    plan 行     = contentBottom+1          (单行)
+ *    plan 第 2 行 = contentBottom+2          (双行,可选)
+ *    spinner 行  = contentBottom+1+planRows  (● 空闲 / ⠹ 思考中… / etc)
+ *    上线        = contentBottom+2+planRows  (画在 paintInput)
+ *    输入行      = contentBottom+3+planRows
+ *    下线        = contentBottom+4+planRows
+ *    model 行    = rows                       (屏底:auto + ctx + cwd) */
+export function drawStatusBar(status) {
+    if (!state.active || !state.base)
+        return;
+    const s = status ?? { ...state.base, status: state.statusText, spinnerFrame: state.spinnerFrame };
+    const g = getGeo();
+    const planLines = composePlanLines(s, g.cols);
+    const planRow1 = g.contentBottom + 1;
+    const spinnerRow = g.contentBottom + 1 + state.planRows;
+    const modelRow = g.rows; // 屏底:model 行
+    // plan 可能占 1 或 2 行(过长自动撑开);spinner/model 行随之平移。
+    // 一次写入:plan 1/2 行 + spinner 行 + model 行,末尾 cup 回续写位/输入框光标。
+    let planBuf = '';
+    for (let i = 0; i < planLines.length; i++) {
+        planBuf += cup(planRow1 + i, 1) + esc.clearLine + planLines[i];
+    }
+    // 计划行从 2 行降到 1 行时,清掉残留的第 2 行(撑高后回退不留尾巴)。
+    if (state.planRows === 1 && g.footerH > 6) {
+        planBuf += cup(planRow1 + 1, 1) + esc.clearLine;
+    }
+    // plan 从非空变成空(已结算为 ## Done:/ notes 里无活跃 ## Plan: 段)时,清掉残留的 plan 行 1。
+    // 否则上轮渲染的「plan: 标题 (N/M) ▸ 当前步」会卡在底栏「虚拟空行」位置直到下一次重启 REPL。
+    if (planLines.length === 0) {
+        planBuf += cup(planRow1, 1) + esc.clearLine;
+    }
+    let out = planBuf +
+        cup(spinnerRow, 1) +
+        esc.clearLine +
+        composeSpinnerLine(s, g.cols) +
+        cup(modelRow, 1) +
+        esc.clearLine +
+        composeModelLine(s, g.cols);
+    if (state.mode === 'running') {
+        // 运行态(回尾 / 滚动回看均):cup 回输入框光标位(供 IME 锚定)。
+        const p = runningCaretPos();
+        out += cup(p.row, p.col);
+    }
+    else {
+        out += cup(state.scrollOffset === 0 ? state.contentRow : g.contentBottom, state.scrollOffset === 0 ? state.contentCol : 1);
+    }
+    stdout.write(out);
+}
+/** 更新易变状态(状态文字 + spinner 帧)并重画状态行。spinner / agent 用。 */
+export function setStatus(status, frame) {
+    state.statusText = status;
+    state.spinnerFrame = frame;
+    drawStatusBar();
+}
+/**
+ * 启走时刷新计时器:RUNNING 态每 80ms 重画状态行,使 composeStatus 重算 elapsed。
+ * 必要性:spinner 在首 token 到达即 stop,思考/正文流式期间状态行不再经 spinner 刷新;
+ * 若走时只挂 spinner onFrame,流式那几十秒会冻住。此计时器独立续刷,与 spinner 80ms 同速,重叠幂等无妨。
+ * 非 TTY 不启(active=false 时 drawStatusBar 为 no-op)。
+ */
+export function startTurnTimer() {
+    if (!state.active)
+        return;
+    stopTurnTimer();
+    state.runningFrame = 0; // 进入运行态:启动状态行 chip 心跳(首帧立即生效)
+    state.turnTimer = setInterval(() => {
+        state.runningFrame = (state.runningFrame + 1) % RUNNING_FRAMES.length; // 推进心跳帧,让前导符跳动
+        drawStatusBar();
+    }, 80);
+    state.turnTimer.unref();
+}
+/** 停走时计时器。enterInputMode / exitAltScreen 调;intervention 面板进入时也调(防 drawStatusBar 80ms 心跳把光标拉到 runningCaretPos,覆盖 paintInput 的正确光标位)。 */
+export function stopTurnTimer() {
+    if (state.turnTimer) {
+        clearInterval(state.turnTimer);
+        state.turnTimer = null;
+    }
+}
+/** 恢复走时计时器(若 RUNNING 态)。intervention 面板退出时调,恢复状态行走时心跳。 */
+export function startTurnTimerIfRunning() {
+    if (state.active && state.mode === 'running')
+        startTurnTimer();
+}
+/**
+ * 在续写位画一行瞬时活动文本(spinner 帧):不进缓冲、不推进续写位,逐行 clearLine 重画。
+ * 仅 TTY + offset=0(实时尾)+ 非打字暂停态时物理写屏;滚动态跳过(由状态行 spinner 兜底,且避免覆盖 viewport 历史行)。
+ * 配合 clearLiveAtCursor 在 spinner 停时清掉,随后 contentWrite 的结果即写在该行(spinner 不入历史缓冲)。
+ *
+ * 记 frameRow/frameCol = 实际画帧位置;clearLiveAtCursor 清"这行"而非当前续写位,防续写位漂移时清错行。
+ * 续写位漂移时(运行期间被某次 contentWrite 推进,罕见但 557e678 后可能)先清旧 frameRow 再画新位,避免旧帧残留。
+ * 打字暂停态(isStreamingPaused)spinner 不画帧——恢复 557e678 前的 spinner 隐形行为(只关 spinner,不动 contentWrite)。
+ */
+export function paintLiveAtCursor(text) {
+    if (!state.active || !ui.isTTY || state.scrollOffset !== 0 || isStreamingPaused()) {
+        // 滚动态 / 暂停态:不画新帧。但若有旧帧残留(frameRow),必须清掉——
+        // 否则旧 spinner 帧停在历史视图某行,用户看到「思考中」卡在消息堆里(根因)。
+        // 滚动态由状态行心跳兜底显示运行状态,不需内联帧;清完后 frameRow 归零,回尾时下一帧自然重画。
+        if (state.frameRow) {
+            // resize 后 contentBottom 可能缩小:清旧帧时钳 frameRow 到当前可视区,避免 cup 到屏外行
+            const g = getGeo();
+            const fr = Math.min(state.frameRow, g.contentBottom);
+            let out = cup(fr, state.frameCol) + esc.clearLine;
+            if (state.mode === 'running') {
+                const p = runningCaretPos();
+                out += cup(p.row, p.col);
+            }
+            stdout.write(out);
+            state.frameRow = 0;
+            state.frameCol = 0;
+        }
+        return;
+    }
+    // resize 后 contentRow 可能过时(拖终端框):
+    //  - 缩小:contentRow > 新 bottom → 钳到新 bottom
+    //  - 放大:contentRow < 新 bottom 且回尾 → 推进到 min(total+1, bottom)(内容末尾或新区底)
+    //    total+1 是合法「待写位」(breakRow 后光标在新空行);用 total 会把续写位拉回最后一行,
+    //    首次 contentWrite 覆盖 banner(首条消息「插到 logo 下面」bug)。
+    // 否则 cup 到旧行号→帧画在屏幕中间(旧 bottom 位置),而非内容末尾/最底部。
+    const g = getGeo();
+    const committed = content.committedRows();
+    if (state.contentRow > g.contentBottom)
+        state.contentRow = g.contentBottom;
+    if (state.scrollOffset === 0 && state.contentRow < g.contentBottom) {
+        // 用 committed+1 而非 total+1:breakRow 后 hasCurrent=true,totalRows 已含当前空行,+1 会多跳一行
+        // (contentWrite 入口的同类逻辑已同步修正,见上方注释)。
+        state.contentRow = Math.min(committed + 1, g.contentBottom);
+    }
+    let out = '';
+    if (state.frameRow && (state.frameRow !== state.contentRow || state.frameCol !== state.contentCol)) {
+        // 清旧帧同样钳到可视区(resize 后 frameRow 可能 > contentBottom)
+        out += cup(Math.min(state.frameRow, g.contentBottom), state.frameCol) + esc.clearLine; // 续写位漂移:先清旧帧行,否则残留
+    }
+    out += cup(state.contentRow, state.contentCol) + esc.clearLine + text;
+    if (state.mode === 'running') {
+        const p = runningCaretPos();
+        out += cup(p.row, p.col);
+    }
+    stdout.write(out);
+    state.frameRow = state.contentRow;
+    state.frameCol = state.contentCol;
+}
+/** 清掉 paintLiveAtCursor 画过的那行瞬时活动文本。清"实际画过的位置"(frameRow),非当前续写位。
+ *  不加 isStreamingPaused 守卫——stop 时必须无条件清(只写一次、结尾 cup 回输入框,不扰 IME);否则打字中 stop 会跳过清帧、制造泄漏。
+ *  滚动态(scrollOffset≠0)也必须清残留帧——否则旧 spinner 帧卡在历史视图某行(「思考中在消息堆里」根因)。 */
+export function clearLiveAtCursor() {
+    if (!state.active || !ui.isTTY)
+        return;
+    if (!state.frameRow)
+        return; // 没画过就不清(避免误清当前续写位内容)
+    // 滚动态也清:旧帧不该残留。清"画过的行"(frameRow),回尾后该行由 repaintViewport 重画历史内容。
+    // resize 后 contentBottom 可能缩小:frameRow 钳到可视区,避免 cup 到屏外行清错位置。
+    const g = getGeo();
+    let out = cup(Math.min(state.frameRow, g.contentBottom), state.frameCol) + esc.clearLine;
+    if (state.mode === 'running') {
+        const p = runningCaretPos();
+        out += cup(p.row, p.col);
+    }
+    stdout.write(out);
+    state.frameRow = 0;
+    state.frameCol = 0;
+}
+/** 推送 / 清空运行态实时 token 用量(agent core 流式推送;repl 轮末清 undefined)。
+ *  不触发重画:RUNNING 态 turnTimer 80ms 心跳重画状态行,自然取到最新值。 */
+export function setLiveUsage(u) {
+    state.liveUsage = u;
+}
+/** 更新状态行基线(模型 / context / cwd / 模式标识 / 活跃 plan chip / 本轮 token chip)。repl 在轮次边界与切模式时调。 */
+export function setStatusBase(b) {
+    state.base = b;
+}

package/dist/ui/layout-types.js

@@ -0,0 +1 @@
+export {};