@bolloon/bolloon-agent 0.5.0 → 0.5.2

package/dist/agents/workflow-pivot-loop.js

@@ -13,6 +13,8 @@
  * - Token budget awareness
  */
 import { detectRepeatingCalls, toolCallArgsHash } from './loop-review.js';
+// 2026-09-26: 回程派发还原 (LLM 回吐的 API 名 → 注册表真名; 净化在 pi-ai.ts 唯一边界)
+import { resolveApiToolName } from '../llm/tool-name.js';
 /**
  * 2026-08-11 (借鉴 Hermes `_canonicalize_tool_call_arguments`): 工具参数规范化 —
  * LLM 返回的 arguments 常带尾随散文/尾逗号/代码围栏, 直接 JSON.parse 失败会丢整个工具调用.
@@ -234,7 +236,8 @@ export class WorkflowPivotLoop {
             const fn = tc?.function;
             if (!fn || !fn.name)
                 continue;
-            const name = fn.name;
+            // 2026-09-26: 回程还原 — 原生 tool_calls 里的名字是净化后的 API 名
+            const name = resolveApiToolName(fn.name);
             if (!this.tools.has(name)) {
                 this.pushContinuationHint(`工具 ${name} 未注册/不存在, 调用已跳过 — 请换用已提供的工具`);
                 continue;
@@ -326,7 +329,9 @@ export class WorkflowPivotLoop {
                 // 2026-08-02: 传原生 OpenAI tools — deepseek 返回结构化 tool_calls,
                 //   UI 才能显示真实的工具执行 step (之前靠文本 JSON 猜格式, LLM 编造 result)
                 const openAITools = this.buildOpenAITools();
-                const llmResponse = await llm.chat(context, headerForThisIter, signal, openAITools);
+                // 2026-09-28: pivot loop 就是主对话循环 → purpose='main-agent'
+                //   (完整 IMMUTABLE PREFIX + 工具全集 + CURRENT TURN; 也只有它带 cache_prompt)
+                const llmResponse = await llm.chat(context, headerForThisIter, signal, openAITools, 'main-agent', 'pivot-loop');
                 const reply = (llmResponse.reply || '').trim();
                 this.vlog(`[pivot] iter=${this.state.iteration} LLM took=${Date.now() - t0}ms reply=${reply.length} nativeToolCalls=${llmResponse.toolCalls?.length ?? 0} head=${reply.substring(0, 80).replace(/\n/g, ' ')}`);
                 this.emit({ type: 'token', content: reply });
@@ -613,11 +618,12 @@ export class WorkflowPivotLoop {
         while ((match = toolUseRe.exec(content)) !== null) {
             try {
                 const obj = JSON.parse(match[1]);
-                if (obj && obj.name && this.tools.has(obj.name)) {
+                const realName = obj && obj.name ? resolveApiToolName(String(obj.name)) : '';
+                if (obj && realName && this.tools.has(realName)) {
                     const args = this.normalizeArgs(canonicalizeToolCallArguments(obj.arguments));
-                    pending.push({ name: obj.name, args, description: '', parameters: {} });
+                    pending.push({ name: realName, args, description: '', parameters: {} });
                 }
-                else if (obj && obj.name && !this.tools.has(obj.name)) {
+                else if (obj && obj.name && !this.tools.has(realName)) {
                     this.pushContinuationHint(`工具 ${obj.name} 未注册/不存在, 调用已跳过 — 请换用已提供的工具`);
                 }
             }
@@ -634,7 +640,8 @@ export class WorkflowPivotLoop {
             const invokeRe = /<invoke\s+name="(\w+)"\s*>([\s\S]*?)<\/invoke>/g;
             let im;
             while ((im = invokeRe.exec(block)) !== null) {
-                const name = im[1];
+                // 2026-09-26: 回程还原 — LLM 可能回吐的是净化后的 API 名
+                const name = resolveApiToolName(im[1]);
                 if (!this.tools.has(name))
                     continue;
                 // 抓 <parameter name="k">v</parameter> 列表
@@ -642,7 +649,7 @@ export class WorkflowPivotLoop {
                 const paramRe = /<parameter\s+name="(\w+)"\s*>([\s\S]*?)<\/parameter>/g;
                 let pm;
                 while ((pm = paramRe.exec(im[2])) !== null) {
-                    args[pm[1]] = pm[2].trim().replace(/^["']|['"]$/g, '');
+                    args[pm[1]] = pm[2].trim().replace(/^["']|["']$/g, '');
                 }
                 // 避免重复添加
                 if (!pending.some(p => p.name === name)) {
@@ -659,7 +666,8 @@ export class WorkflowPivotLoop {
             const invokeRe = /<invoke\s+name="(\w+)"\s*>([\s\S]*?)<\/invoke>/g;
             let im;
             while ((im = invokeRe.exec(block)) !== null) {
-                const name = im[1];
+                // 2026-09-26: 回程还原 — LLM 可能回吐的是净化后的 API 名
+                const name = resolveApiToolName(im[1]);
                 if (!this.tools.has(name))
                     continue;
                 const args = {};
@@ -676,7 +684,7 @@ export class WorkflowPivotLoop {
         // Pattern 1: Chinese format "调用工具: tool_name(args)"
         const pattern1 = /调用工具[：:]\s*(\w+)\s*\(([^)]*)\)/g;
         while ((match = pattern1.exec(content)) !== null) {
-            const name = match[1];
+            const name = resolveApiToolName(match[1]);
             const argsStr = match[2];
             const args = this.parseArgs(argsStr);
             if (this.tools.has(name)) {
@@ -686,7 +694,7 @@ export class WorkflowPivotLoop {
         // Pattern 2: tool_name(args) format
         const pattern2 = /(\w+)\s*\(\s*([^)]*)\s*\)/g;
         while ((match = pattern2.exec(content)) !== null) {
-            const name = match[1];
+            const name = resolveApiToolName(match[1]);
             const argsStr = match[2];
             // Skip if already matched or doesn't look like a tool call
             if (pending.some(p => p.name === name))
@@ -703,8 +711,9 @@ export class WorkflowPivotLoop {
                 const parsed = JSON.parse(jsonMatch[0]);
                 if (Array.isArray(parsed.tool_calls)) {
                     for (const tc of parsed.tool_calls) {
-                        if (this.tools.has(tc.name)) {
-                            pending.push({ name: tc.name, args: tc.args || {}, description: '', parameters: {} });
+                        const realName = resolveApiToolName(String(tc?.name ?? ''));
+                        if (this.tools.has(realName)) {
+                            pending.push({ name: realName, args: tc.args || {}, description: '', parameters: {} });
                         }
                     }
                 }
@@ -720,7 +729,7 @@ export class WorkflowPivotLoop {
         const singleJsonRe = /\{\s*"name"\s*:\s*"(\w+)"\s*,\s*"(?:arguments|input)"\s*:\s*(\{[\s\S]*?\})\s*\}/g;
         let singleMatch;
         while ((singleMatch = singleJsonRe.exec(content)) !== null) {
-            const name = singleMatch[1];
+            const name = resolveApiToolName(singleMatch[1]);
             if (pending.some(p => p.name === name))
                 continue;
             if (!this.tools.has(name))

package/dist/cli/clipboard.js

@@ -0,0 +1,65 @@
+/**
+ * clipboard.ts — 把文本真写进**系统剪贴板** (2026-09-27)
+ *
+ * ## 为什么需要它
+ *
+ * 面板是 Ink 画的**一屏自绘帧**: 每帧都是 `eraseLines` + 重画。终端里的鼠标框选靠终端自己维护,
+ * 而"每秒重画一帧"会不断打断正在进行的框选 —— 于是"想抄一段回复"变成了撞运气。
+ * 真终端字节证据 (`scripts/verify-cli-panel.ts` 抓的那一份):
+ *   · `ESC[2J ESC[3J ESC[H` (**清屏 + 清回滚缓冲**) 在 30s 内出现 24 次;
+ *   · 每一次都来自 Ink 的 `renderInteractiveFrame` (`shouldClearTerminalForFrame`: 帧高缩了/上一帧是别的形状)。
+ * 这既解释了"选不中", 也解释了"往上滚看不到更早的内容"。
+ *
+ * 所以复制走**两条腿**:
+ *   ① 结构上少打断: 版面固定成"整屏高" + 跟随暂停时**完全不重画** (见 `ink-app.tsx`) → 帧不再乱清;
+ *   ② 一条**不靠鼠标**的显式通路: `/copy` —— 把最近一条/整段回复交给系统剪贴板工具。
+ *     能用 `pbcopy` 就不假装"已经复制到剪贴板了"。
+ */
+import { spawnSync } from 'child_process';
+/** 剪贴板工具按平台挑 (第一个能跑的胜出); 环境变量 `BOLLOON_CLIPBOARD_CMD` 可显式覆盖 (验收门用) */
+export function clipboardCommand(env = process.env) {
+    const override = (env.BOLLOON_CLIPBOARD_CMD ?? '').trim();
+    if (override) {
+        const parts = override.split(/\s+/).filter(Boolean);
+        if (parts.length)
+            return { cmd: parts[0], args: parts.slice(1) };
+    }
+    switch (process.platform) {
+        case 'darwin': return { cmd: 'pbcopy', args: [] };
+        case 'win32': return { cmd: 'clip', args: [] };
+        default:
+            if (env.WAYLAND_DISPLAY)
+                return { cmd: 'wl-copy', args: [] };
+            if (env.DISPLAY)
+                return { cmd: 'xclip', args: ['-selection', 'clipboard'] };
+            return null;
+    }
+}
+/** 剪贴板工具名 (报告/界面里只说工具名, 不打印被复制的内容) */
+export function clipboardToolName(env = process.env) {
+    const c = clipboardCommand(env);
+    return c ? c.cmd : null;
+}
+/**
+ * 真写剪贴板 (同步: 这条命令要立刻给出"成没成", 不能 fire-and-forget)。
+ * 返回值只含**长度与工具名** —— 文本内容绝不回显/落日志 (回复里可能有 key/私密内容)。
+ */
+export function clipboardWrite(text, env = process.env) {
+    const chars = String(text ?? '').length;
+    const c = clipboardCommand(env);
+    if (!c) {
+        return { ok: false, chars, error: '这个平台没有可用的剪贴板命令 (macOS: pbcopy / Windows: clip / Linux: wl-copy 或 xclip)' };
+    }
+    try {
+        const r = spawnSync(c.cmd, c.args, { input: String(text ?? ''), encoding: 'utf8', timeout: 5000 });
+        if (r.error)
+            return { ok: false, chars, tool: c.cmd, error: `调用 ${c.cmd} 失败: ${r.error.message}` };
+        if (r.status !== 0) {
+            return { ok: false, chars, tool: c.cmd, error: `${c.cmd} 退出码 ${r.status}${r.stderr ? `: ${String(r.stderr).slice(0, 120)}` : ''}` };
+        }
+        return { ok: true, chars, tool: c.cmd };
+    }
+    catch (e) {
+        return { ok: false, chars, tool: c.cmd, error: String(e?.message || e).slice(0, 160) };
+    }
+}

package/dist/cli/ink-app.js

@@ -8,6 +8,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  *   ↑/↓ 导航, Tab/Enter 选中, Esc 关闭, 弹出窗打开时 TextInput 让出焦点 (focus=false)
  */
 import React, { useState, useEffect, useCallback, useRef, useMemo } from 'react';
+import * as fs from 'fs';
 import { render, Box, Text, useInput, useApp, useStdout } from 'ink';
 import TextInput from 'ink-text-input';
 import { dispWidth, LOADING_FRAMES as KAOMOJI } from './loading-tui.js';
@@ -29,23 +30,64 @@ function msgVisualLines(text, width) {
     }
     return n;
 }
+/**
+ * 分区账本 (2026-09-27 leo 口径: **面板高度必须确立 + 底部输入框打字不许抖**) ——
+ * 一屏就是终端的真实行数, 且**每一块的行数是常数**:
+ *
+ *   行 1 … history                 ← 历史区 (占满剩余高度; 消息窗口 + 弹层都在这里面)
+ *   行 history+1                   ← 活动行 (思考/自动整理/暂停跟随提示; **固定预留 1 行**)
+ *   行……                           ← 分隔线 / 状态栏 / 分隔线 / 输入栏 / 分隔线 (固定 5 行)
+ *
+ * 三条硬边界:
+ *   · 几何恒定: 打字 / 提示出现 / 补全弹窗出现或消失, **输入行所在行号与其余区域位置一个字不动**
+ *     (弹窗**覆盖**在历史区底部 —— 从 history 里扣, 不与固定栏抢位置);
+ *   · **渲染总行数 == 终端高** —— 消息窗口切片 + 根容器 `overflow="hidden"` 兜底。
+ *     (注: 修前帧高忽高忽低, 一旦某帧 > 终端高, Ink 的 `shouldClearTerminalForFrame` 会在**之后每一帧**
+ *      发 `ESC[2J ESC[3J ESC[H` —— 连回滚缓冲一起清, 于是"选不中 / 滚不回"同时出现。帧高恒定 = 那些清屏不再发。)
+ *   · 暂停跟随时冻结整帧 (状态栏时钟也不 tick) ⇒ 帧字节不变 ⇒ 终端里的框选/复制不被打断。
+ */
+const CHROME_LINES = 5; // 3 条全宽分隔线 + 状态栏 + 输入栏
+const ACTIVITY_LINES = 1; // 活动行 (固定预留, 免得状态一变就推挤历史区)
+const RESERVED_LINES = CHROME_LINES + ACTIVITY_LINES;
+const MIN_HISTORY_LINES = 1;
+/** 弹层最多占几行 (给历史区留出至少 1 行消息, 免得弹窗把历史区吃光) */
+const POPUP_MAX_ROWS = 8;
+/** 一屏布局账本 (纯函数 —— 验收门直接喂尺寸复核) */
+export function layoutBudget(opts) {
+    const rows = Math.max(RESERVED_LINES + MIN_HISTORY_LINES, Math.floor(opts.rows || 24));
+    const cols = Math.max(20, Math.floor(opts.cols || 80));
+    const history = Math.max(MIN_HISTORY_LINES, rows - RESERVED_LINES);
+    const popupRows = Math.max(0, Math.min(Math.floor(opts.popupRows || 0), POPUP_MAX_ROWS, Math.max(0, history - MIN_HISTORY_LINES)));
+    return {
+        rows, cols,
+        chrome: CHROME_LINES, activity: ACTIVITY_LINES,
+        history, msgH: history - popupRows, popupRows,
+    };
+}
 // 2026-09-08: React.memo — msgs 引用不变时跳过重渲染 (配合虚拟化 slice, status tick 不再整表重绘)
 const Messages = React.memo(({ msgs }) => (_jsx(Box, { flexDirection: "column", flexGrow: 1, justifyContent: "flex-start", children: msgs.map((m, i) => {
         const clean = m.replace(/\x1b\[[0-9;]*m/g, '');
         return clean.trim() ? _jsx(Text, { children: clean ? m : '' }, i) : null;
     }) })));
-const MentionPopup = ({ title, items, sel, width, loading }) => {
-    const MAX_ROWS = 8;
-    // 2026-08-08: 滑动窗口 — 选中项始终可见 (原实现 fix 屏幕顶部, sel 超窗口时无高亮行)
-    const offset = Math.max(0, Math.min(sel - Math.floor(MAX_ROWS / 2), Math.max(0, items.length - MAX_ROWS)));
-    const shown = items.slice(offset, offset + MAX_ROWS);
+const MentionPopup = ({ title, items, sel, width, loading, maxRows }) => {
     const innerW = Math.max(width - 2, 10);
-    return (_jsxs(Box, { flexDirection: "column", width: width, children: [_jsx(Text, { color: THEME.accent, bold: true, children: `╭─ ${title} ${'─'.repeat(Math.max(2, innerW - dispWidth(title) - 4))}╮` }), loading && items.length === 0 ? (_jsx(Text, { color: "dim", children: "\u2502 \u626B\u63CF\u4E2D..." })) : !loading && items.length === 0 ? (_jsx(Text, { color: "dim", children: "\u2502 \u65E0\u5339\u914D" })) : (shown.map((it, i) => {
+    // 行账本: 2 行边框 + 正文若干 + (还有更多?1:0) —— 正文裁剪到刚好填满 maxRows
+    const totalRows = Math.max(1, maxRows);
+    const emptyNote = !loading && items.length === 0;
+    let bodyRows = Math.max(0, totalRows - 2 - (emptyNote ? 1 : 0));
+    let hasMore = items.length > bodyRows;
+    if (hasMore && bodyRows > 0)
+        bodyRows -= 1; // 给"还有 N 项"让一行
+    hasMore = items.length > bodyRows;
+    // 2026-08-08: 滑动窗口 — 选中项始终可见 (原实现 fix 屏幕顶部, sel 超窗口时无高亮行)
+    const offset = Math.max(0, Math.min(sel - Math.floor(bodyRows / 2), Math.max(0, items.length - bodyRows)));
+    const shown = items.slice(offset, offset + bodyRows);
+    return (_jsxs(Box, { flexDirection: "column", width: width, children: [_jsx(Text, { color: THEME.accent, bold: true, children: `╭─ ${title} ${'─'.repeat(Math.max(2, innerW - dispWidth(title) - 4))}╮` }), loading && items.length === 0 ? (_jsx(Text, { color: "dim", children: "\u2502 \u626B\u63CF\u4E2D..." })) : emptyNote ? (_jsx(Text, { color: "dim", children: "\u2502 \u65E0\u5339\u914D" })) : (shown.map((it, i) => {
                 const active = i === sel;
                 const label = it.kind === 'file' ? it.label : `${it.kind === 'skill' ? '⚡' : it.kind === 'plugin' ? '🔌' : ''}${it.label}`;
                 const hint = it.hint ? `${it.hint}` : it.kind === 'file' ? '文件' : '';
                 return (_jsxs(Box, { width: innerW, children: [_jsx(Text, { color: active ? 'black' : undefined, backgroundColor: active ? 'cyan' : undefined, children: `${active ? '❯ ' : '  '}${label}` }), _jsx(Text, { color: active ? 'black' : 'dim', backgroundColor: active ? 'cyan' : undefined, dimColor: !active, children: `  ${hint}` })] }, `${it.kind}:${it.label}`));
-            })), items.length > MAX_ROWS && (_jsxs(Text, { color: "dim", children: ["\u2502 ", offset + 1, "-", offset + shown.length, "/", items.length, " \u00B7 \u8FD8\u6709 ", items.length - (offset + shown.length), " \u9879..."] })), _jsx(Text, { color: THEME.accent, children: `╰${'─'.repeat(innerW)}╯` })] }));
+            })), hasMore && (_jsxs(Text, { color: "dim", children: ["\u2502 ", offset + 1, "-", offset + shown.length, "/", items.length, " \u00B7 \u8FD8\u6709 ", items.length - (offset + shown.length), " \u9879..."] })), _jsx(Text, { color: THEME.accent, children: `╰${'─'.repeat(innerW)}╯` })] }));
 };
 const InkApp = ({ onPrompt, initialStatus, getStatusUpdate, terminalW, terminalH }) => {
     const [input, setInput] = useState('');
@@ -90,15 +132,27 @@ const InkApp = ({ onPrompt, initialStatus, getStatusUpdate, terminalW, terminalH
     const [picker, setPicker] = useState(null);
     const pickerCb = useRef(null);
     const pickerSelRef = useRef(0);
+    /**
+     * 2026-09-26: 取消回调。此前 Esc 只把 `pickerCb` 置空并关窗 —— 对"等一个选择结果"的调用方
+     * (分步选择器要按步往下走) 来说就是**永远等不到**。现在 Esc/显式关闭都会回调它。
+     */
+    const pickerCancel = useRef(null);
     // 全局钩子: index.ts 命令打开/关闭选择器
     useEffect(() => {
-        globalThis.__inkOpenPicker = (itemsArg, title, onPick) => {
+        globalThis.__inkOpenPicker = (itemsArg, title, onPick, onCancel) => {
             pickerSelRef.current = 0;
             pickerCb.current = onPick;
+            pickerCancel.current = onCancel ?? null;
             setPicker({ title: title || '选择', items: itemsArg, sel: 0 });
             setInput('');
         };
-        globalThis.__inkClosePicker = () => { pickerCb.current = null; setPicker(null); };
+        globalThis.__inkClosePicker = () => {
+            const c = pickerCancel.current;
+            pickerCb.current = null;
+            pickerCancel.current = null;
+            setPicker(null);
+            c?.();
+        };
         return () => { delete globalThis.__inkOpenPicker; delete globalThis.__inkClosePicker; };
     }, []);
     // ── 输入历史 (↑/↓ 切换) ───────────────────────────────────────────────────
@@ -392,13 +446,18 @@ const InkApp = ({ onPrompt, initialStatus, getStatusUpdate, terminalW, terminalH
                 const it = itemsArg[Math.min(pickerSelRef.current, itemsArg.length - 1)];
                 const cb = pickerCb.current;
                 pickerCb.current = null;
+                pickerCancel.current = null;
                 setPicker(null);
                 cb?.(it);
                 return;
             }
             if (key.escape) {
+                // 取消也要**回调**调用方 (否则等结果的调用方永远挂着)
+                const c = pickerCancel.current;
                 pickerCb.current = null;
+                pickerCancel.current = null;
                 setPicker(null);
+                c?.();
                 return;
             }
             return; // 其余键忽略
@@ -528,7 +587,9 @@ const InkApp = ({ onPrompt, initialStatus, getStatusUpdate, terminalW, terminalH
             return;
         }
         // 双击 Esc 退出当前进程: 第一击提示, 500ms 内第二击退出
-        if (key.escape) {
+        //   ⚠ 判据含**字节级兜底** (`_input === '\u001b'`): Ink 对"孤独的 Esc"要先攒 20ms 再吐,
+        //   重挂之后实测 `key.escape` 不再为真 —— 与上面 Enter 那条同一个道理 (不依赖 Ink 的键解析)。
+        if (key.escape || _input === '\u001b') {
             const now = Date.now();
             if (now - lastEscRef.current < DOUBLE_ESC_MS) {
                 requestExit();
@@ -558,7 +619,8 @@ const InkApp = ({ onPrompt, initialStatus, getStatusUpdate, terminalW, terminalH
     // 自动更新状态栏 (每秒)
     // 2026-08-07 修复: 依赖必须为空 [] — [getStatusUpdate] 在渲染间引用变化 (Ink 内部元素重建),
     //   effect 每次渲染 cleanup+setup → setInterval 刚建立就被清除 → 永不 tick → 状态栏恒初始值.
-    //   getStatusUpdate 是 startInk 传入的模块级函数 (引用稳定), 空依赖首渲染捕获即可, 内部实时读.
+    // 2026-09-27: **暂停跟随时不 tick** —— 用户上滚后整帧冻结 (Ink 的 log-update 在输出相同时
+    //   一个字节都不写), 于是终端里的框选/复制不会被打断, 也保证"底部行字节不再变化"。
     useEffect(() => {
         // 挂载时立即同步刷新一次状态栏 (不等 1s 后第一个 tick)
         try {
@@ -568,6 +630,8 @@ const InkApp = ({ onPrompt, initialStatus, getStatusUpdate, terminalW, terminalH
         }
         catch { /* 状态栏更新失败不致命 */ }
         const timer = setInterval(() => {
+            if (!stickRef.current)
+                return; // 暂停跟随: 冻结整帧 (回到最底自动恢复)
             try {
                 const s = getStatusUpdate();
                 if (s)
@@ -603,7 +667,16 @@ const InkApp = ({ onPrompt, initialStatus, getStatusUpdate, terminalW, terminalH
     // ── 虚拟化 transcript (消息级窗口 + 自动跟随底部) ───────────────────────────
     // #1 分区预留: chrome 固定行 = 分隔线×3 + 状态栏 + 输入栏 = 5; transcript 严格不超区
     //   (content Box flexGrow=1 但内容超宽会把 status/composer 挤走 → 可见窗口行数钳制 ≤ availH)
-    const availH = Math.max(6, termSize.h - 5);
+    // 2026-09-27: 高度**全部来自真终端尺寸** (`layoutBudget`) —— 帧高 == 终端高 (常数),
+    //   弹层从历史区里扣 (覆盖式, 不推挤固定栏) ⇒ 打字 / 提示出现都不动输入行位置。
+    const sticky = stickRef.current;
+    const popupOpenNow = !!(popupOpen || picker);
+    const budget = layoutBudget({
+        rows: termSize.h, cols: W,
+        popupRows: popupOpenNow ? POPUP_MAX_ROWS : 0,
+    });
+    const msgH = budget.msgH; // 消息窗口高度 (弹层占的那几行已经扣掉)
+    const availH = budget.history; // 滚动按"历史区总高"算 (含被弹层覆盖的几行)
     const heights = useMemo(() => msgs.map(m => msgVisualLines(m, W)), [msgs, W]);
     const cumulative = useMemo(() => {
         const c = [0];
@@ -612,26 +685,47 @@ const InkApp = ({ onPrompt, initialStatus, getStatusUpdate, terminalW, terminalH
         return c;
     }, [heights]);
     const totalLines = cumulative[cumulative.length - 1] || 0;
-    const maxTop = Math.max(0, totalLines - availH);
-    const sticky = stickRef.current;
+    const maxTop = Math.max(0, totalLines - msgH);
     const top = sticky ? maxTop : Math.min(scrollTop, maxTop);
     let start = 0;
     while (start < msgs.length && cumulative[start + 1] <= top + 0.5)
         start++;
     let end = start;
-    // 严格钳制: 端界不越过 availH, 保证 transcript 内容行数 ≤ 分区高度 (互不覆盖)
-    while (end + 1 < msgs.length && cumulative[end + 1] <= top + availH)
+    // 严格钳制: 端界不越过 msgH, 保证 transcript 内容行数 ≤ 分区高度 (互不覆盖)
+    while (end + 1 < msgs.length && cumulative[end + 1] <= top + msgH)
         end++;
     const visible = useMemo(() => msgs.slice(start, end + 1), [msgs, start, end]);
     const scrolledOut = maxTop > 0 && !sticky;
-    return (_jsxs(Box, { flexDirection: "column", height: "100%", children: [_jsxs(Box, { flexGrow: 1, flexDirection: hasRails ? 'row' : 'column', children: [_jsxs(Box, { flexGrow: 1, flexDirection: "column", justifyContent: "flex-start", children: [_jsx(Messages, { msgs: visible }), scrolledOut && (_jsxs(Text, { color: THEME.muted, children: ["\u25BE \u4E0A\u6EDA ", top, " \u884C \u00B7 Ctrl+U/D \u7FFB\u9875 \u00B7 Home \u9876 \u00B7 End \u56DE\u5E95"] })), thinking && (_jsx(Box, { children: _jsxs(Text, { color: "yellow", children: [KAOMOJI[thinkingIdx.current], " \u601D\u8003\u4E2D..."] }) })), transient && (_jsx(Box, { children: _jsx(Text, { children: transient }) }))] }), hasRails && (_jsx(Box, { width: 36, marginLeft: 1, flexDirection: "column", justifyContent: "flex-start", children: railNames.map((n) => _jsxs(Text, { color: THEME.muted, children: [n, "\\n", widgets[n]] }, n)) }))] }), _jsx(Box, { children: _jsx(Text, { bold: true, color: THEME.accent, children: '─'.repeat(W) }) }), _jsx(Box, { children: _jsx(Text, { children: status }) }), _jsx(Box, { children: _jsx(Text, { bold: true, color: THEME.accent, children: '─'.repeat(W) }) }), popupOpen && (tabState || mention) && (_jsx(MentionPopup, { title: popupTitle, items: filtered, sel: safeSel, width: W, loading: loadingFiles })), picker && (_jsx(MentionPopup, { title: picker.title, items: picker.items, sel: Math.min(picker.sel, picker.items.length - 1), width: W })), _jsxs(Box, { children: [_jsx(Text, { bold: true, color: THEME.accent, children: "\u276F " }), _jsx(TextInput, { value: input, onChange: setInput, onSubmit: onSubmit, focus: !popupOpen && !picker, placeholder: COMPOSER_PLACEHOLDER }, tiKey)] }), _jsx(Box, { children: _jsx(Text, { bold: true, color: THEME.accent, children: '─'.repeat(W) }) })] }));
+    // 测试/诊断探针: 把**真实用到的**布局与滚动状态写一份 JSONL (验收门按它做精确断言;
+    //   不设 BOLLOON_TUI_PROBE 时零开销 —— 只在渲染后追加一行)。
+    //   注: 走静态 import —— dist 是 ESM, 这里 `require()` 不存在 (踩过一次: 探针静默不写 + 树停更)。
+    useEffect(() => {
+        const p = process.env.BOLLOON_TUI_PROBE;
+        if (!p)
+            return;
+        try {
+            fs.appendFileSync(p, JSON.stringify({
+                t: Date.now(), rows: budget.rows, cols: budget.cols, chrome: budget.chrome,
+                activity: budget.activity, history: budget.history, msgH, popupRows: budget.popupRows,
+                inputLine: budget.rows - 1, // 输入栏行号 (1-based; 最后一行是底部分隔线)
+                totalMsgs: msgs.length, totalLines, top, maxTop, stick: sticky,
+                firstVisible: start, lastVisible: end, visibleCount: visible.length,
+                input, pausedHint: scrolledOut ? '已暂停跟随 · PgDn/End 回到底部' : '',
+            }) + '\n');
+        }
+        catch { /* 探针写不进去绝不影响界面 */ }
+    });
+    return (_jsxs(Box, { flexDirection: "column", height: budget.rows, width: budget.cols, overflow: "hidden", children: [_jsxs(Box, { flexDirection: "column", height: budget.history, children: [_jsxs(Box, { height: msgH, overflow: "hidden", flexDirection: hasRails ? 'row' : 'column', children: [_jsx(Box, { flexGrow: 1, flexDirection: "column", justifyContent: "flex-start", overflow: "hidden", children: _jsx(Messages, { msgs: visible }) }), hasRails && (_jsx(Box, { width: 36, marginLeft: 1, flexDirection: "column", justifyContent: "flex-start", children: railNames.map((n) => _jsxs(Text, { color: THEME.muted, children: [n, "\\n", widgets[n]] }, n)) }))] }), popupOpenNow && tabState && (_jsx(MentionPopup, { title: POPUP_TITLE_TAB, items: filtered, sel: safeSel, width: W, maxRows: budget.popupRows })), popupOpenNow && !tabState && mention && (_jsx(MentionPopup, { title: popupTitle, items: filtered, sel: safeSel, width: W, loading: loadingFiles, maxRows: budget.popupRows })), popupOpenNow && !tabState && !mention && picker && (_jsx(MentionPopup, { title: picker.title, items: picker.items, sel: Math.min(picker.sel, picker.items.length - 1), width: W, maxRows: budget.popupRows }))] }), _jsx(Box, { height: budget.activity, width: budget.cols, overflow: "hidden", children: scrolledOut ? (_jsxs(Text, { color: THEME.warn, children: ["\u5DF2\u6682\u505C\u8DDF\u968F \u00B7 PgDn/End \u56DE\u5230\u5E95\u90E8 (\u2191", top, " \u884C \u00B7 Ctrl+U/D \u7FFB\u9875 \u00B7 Home \u5230\u9876)"] })) : transient ? (_jsx(Text, { children: transient })) : thinking ? (_jsxs(Text, { color: "yellow", children: [KAOMOJI[thinkingIdx.current], " \u601D\u8003\u4E2D..."] })) : (_jsx(Text, { children: " " })) }), _jsx(Box, { children: _jsx(Text, { bold: true, color: THEME.accent, children: '─'.repeat(W) }) }), _jsx(Box, { height: 1, width: budget.cols, overflow: "hidden", children: _jsx(Text, { children: status }) }), _jsx(Box, { children: _jsx(Text, { bold: true, color: THEME.accent, children: '─'.repeat(W) }) }), _jsxs(Box, { width: budget.cols, height: 1, overflow: "hidden", children: [_jsx(Text, { bold: true, color: THEME.accent, children: "\u276F " }), _jsx(Box, { width: Math.max(10, budget.cols - 2), height: 1, overflow: "hidden", flexShrink: 0, children: _jsx(TextInput, { value: input, onChange: setInput, onSubmit: onSubmit, focus: !popupOpenNow, placeholder: COMPOSER_PLACEHOLDER }, tiKey) })] }), _jsx(Box, { children: _jsx(Text, { bold: true, color: THEME.accent, children: '─'.repeat(W) }) })] }));
 };
 export { InkApp };
 // ─── 启动 ────────────────────────────────────────────────────────────────────
 let _inkInstance = null;
+/** 上次 render 的参数 (suspend → resume 要原样重挂, 所以必须留着) */
+let _lastInkArgs = null;
 export function startInk(onPrompt, initialStatus, getStatusUpdate) {
     const tw = process.stdout.columns || 80;
     const th = process.stdout.rows || 24;
+    _lastInkArgs = { onPrompt, initialStatus, getStatusUpdate };
     _inkInstance = render(_jsx(InkApp, { onPrompt: onPrompt, initialStatus: initialStatus, getStatusUpdate: getStatusUpdate, terminalW: tw, terminalH: th }), {
         stdout: process.stdout,
         stdin: process.stdin,
@@ -639,12 +733,46 @@ export function startInk(onPrompt, initialStatus, getStatusUpdate) {
         patchConsole: false, // 重要: 阻止 Ink 劫持 console.log
     });
 }
+/**
+ * 暂时让出终端 (2026-09-27): 会话内 `/model` 要用**与 `bolloon model` 同一个**全屏选择器组件
+ * (`tui-select.ts` —— 固定高度视窗 + 跟随 + 折叠 + 搜索 + 光标高亮), 而它自己是 raw-mode
+ * 逐键渲染: 两个渲染器同时抢同一个终端必然互相撕。
+ *
+ * 语义: 先把 Ink 卸掉并清掉它那一帧 (终端干净), 交给选择器画; 用完 `resumeInk()` 原样挂回来。
+ * 为什么可以这么做: 会话内容活在**外部 store** (`stores.ts` 的 transcriptStore/uiStore), 不在 React 里,
+ * 所以重挂之后历史一字不少 (只丢"输入框草稿"这种真正的临时态)。
+ */
+export function suspendInk() {
+    if (!_inkInstance)
+        return;
+    try {
+        _inkInstance.unmount();
+        _inkInstance.clear();
+    }
+    catch { /* 卸不掉也让调用方继续 (选择器会自己清干净) */ }
+    _inkInstance = null;
+}
+/** 把 Ink 按上次的参数挂回来 (suspendInk 之后用); 没挂过则忽略 */
+export function resumeInk() {
+    if (_inkInstance || !_lastInkArgs)
+        return;
+    const a = _lastInkArgs;
+    startInk(a.onPrompt, a.initialStatus, a.getStatusUpdate);
+    // ⚠ 必须把 stdin **重新拉起来**: 选择器的 `RawSession.close()` 会 `stdin.pause()`,
+    //   而 Ink 挂载时只 `setRawMode(true)`、**自己不会 resume** ⇒ 少这一下, 面板照常重绘,
+    //   但按键再也不进来 —— 实测: 打字不回显、Esc 双击退出也没反应 (2026-09-27 验收门抓到)。
+    try {
+        process.stdin.resume();
+    }
+    catch { /* 不支持的宿主, 不影响渲染 */ }
+}
 export function stopInk() {
     if (_inkInstance) {
         _inkInstance.unmount();
         _inkInstance.clear();
         _inkInstance = null;
     }
+    _lastInkArgs = null;
 }
 export function inkAppendLine(line) {
     appendMsg(line);