@bolloon/bolloon-agent 0.4.17 → 0.4.18

package/dist/cli/content.js

@@ -0,0 +1,10 @@
+/**
+ * content.ts — TUI 文案/提示 与组件解耦 (内容层分离, 便于统一改文案/多语言)
+ */
+export const COMPOSER_PLACEHOLDER = '输入消息... @智能体 /命令 #文件 · Esc 双击退出 · /queue 排队 · !终端命令';
+export const POPUP_TITLE_TAB = 'Tab 补齐';
+export const POPUP_TITLE_AGENT = '@ 智能体';
+export const POPUP_TITLE_FILE = '# 文件';
+export const POPUP_TITLE_COMMAND = '/ 命令 · 技能 · 插件';
+export const CHAR_EXIT_HINT = '再按一次 Esc 退出当前进程';
+export const CHAR_LOADING = ['(｀・ω・´)', '(´･_･`)', '(｡•́︿•̀｡)', 'ᕙ(▀̿̿Ĺ̯̿̿▀̿ ̿)ᕗ', '(◕‿◕)', 'ヽ(´▽｀)/'];

package/dist/cli/ink-app.js

@@ -7,39 +7,45 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  * 2026-08-05: @ / # 弹出选择窗 — 输入 @ 命中智能体, / 命中命令+技能+插件, # 命中文件
  *   ↑/↓ 导航, Tab/Enter 选中, Esc 关闭, 弹出窗打开时 TextInput 让出焦点 (focus=false)
  */
-import { useState, useEffect, useCallback, useRef, useMemo } from 'react';
-import { render, Box, Text, useInput, useApp } from 'ink';
+import React, { useState, useEffect, useCallback, useRef, useMemo } from 'react';
+import { render, Box, Text, useInput, useApp, useStdout } from 'ink';
 import TextInput from 'ink-text-input';
-import { brandArtLines, boxTop, boxRow, boxBottom, dispWidth } from './loading-tui.js';
+import { dispWidth, LOADING_FRAMES as KAOMOJI } from './loading-tui.js';
+import { THEME, fg } from './theme.js';
+import { COMPOSER_PLACEHOLDER, POPUP_TITLE_TAB, POPUP_TITLE_AGENT, POPUP_TITLE_FILE, POPUP_TITLE_COMMAND } from './content.js';
+import { DOUBLE_ESC_MS, STATUS_TICK_MS, THINK_FRAME_MS } from './timing.js';
+import { resolveNormalKey, applyScroll } from './keymap.js';
+import { useWidgets } from './widget-host.js';
+import { useStore, transcriptStore, uiStore, appendMsg, replaceLastMsg, replaceMarkerMsg, setUiStatus, setUiThinking, setUiTransient } from './stores.js';
 import { loadAgents, loadCommands, loadSkills, loadPlugins, loadFiles, getMention, matchFileScore, } from './mention-data.js';
-// ─── 组件: Logo Box ──────────────────────────────────────────────────────────
-const LogoBox = ({ width }) => {
-    const art = brandArtLines();
-    const mw = Math.max(40, ...art.map(l => dispWidth(l))) + 4;
-    const bw = Math.min(width - 2, mw);
-    const rows = [boxTop('Bolloon Agent', bw)];
-    for (const l of art)
-        rows.push(boxRow(l, bw, 'center'));
-    rows.push(boxBottom(bw));
-    return (_jsx(Box, { flexDirection: "column", children: rows.map((r, i) => _jsx(Text, { children: r }, i)) }));
-};
 // ─── 组件: 消息列表 ──────────────────────────────────────────────────────────
-const Messages = ({ msgs }) => (_jsx(Box, { flexDirection: "column", flexGrow: 1, justifyContent: "flex-start", children: msgs.map((m, i) => {
+/** 消息显示行数 (ANSI 剥离后按宽度 wrap 估行; 与 Ink 按父宽 wrap 近似一致) */
+function msgVisualLines(text, width) {
+    let n = 0;
+    const clean = text.replace(/\x1b\[[0-9;]*m/g, '');
+    for (const line of clean.split('\n')) {
+        const w = dispWidth(line);
+        n += Math.max(1, Math.ceil(w / Math.max(10, width - 1)));
+    }
+    return n;
+}
+// 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 innerW = Math.max(width - 2, 10);
-    return (_jsxs(Box, { flexDirection: "column", width: width, children: [_jsx(Text, { color: "cyan", 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) => {
+    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) => {
                 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: "cyan", children: `╰${'─'.repeat(innerW)}╯` })] }));
+            })), 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)}╯` })] }));
 };
 const InkApp = ({ onPrompt, initialStatus, getStatusUpdate, terminalW, terminalH }) => {
     const [input, setInput] = useState('');
@@ -50,17 +56,23 @@ const InkApp = ({ onPrompt, initialStatus, getStatusUpdate, terminalW, terminalH
     }, [input]);
     // 2026-08-07: 提交防重 (InkApp \n/\r 兜底 + TextInput 双触发场景)
     const lastSubmitRef = useRef({ t: 0, v: '' });
-    const [msgs, setMsgs] = useState([]);
-    const [status, setStatus] = useState(initialStatus);
+    const msgs = useStore(transcriptStore); // #2 状态外置: transcript 来自外部 store
+    const ui = useStore(uiStore); // #2 status/thinking/transient 外置
+    const status = ui.status || initialStatus;
+    const thinking = ui.thinking;
+    const transient = ui.transient;
+    // #8 占用槽: 右侧 rails (有 widget 占宽, 无则布局不变)
+    const widgets = useWidgets();
+    const railNames = Object.keys(widgets);
+    const hasRails = railNames.length > 0;
     const { exit } = useApp();
-    const [thinking, setThinking] = useState(false);
-    // 2026-08-10: 临时状态行 (自动整理心跳/run-end 经验整理用) — 显示在颜文字行位置,
-    //   结束后设 null 即清空 (显示为空). 不进入消息历史, 不会残留显示效果.
-    const [transient, setTransient] = useState(null);
+    // 虚拟化滚动: 行窗口 top + 是否跟随底部 (用户上滚后自动跟随关闭, End 恢复)
+    const [scrollTop, setScrollTop] = useState(0);
+    const stickRef = useRef(true);
     const thinkingIdx = useRef(0);
     // 双击 Esc 退出当前进程 (500ms 窗口内第二次按下)
     const lastEscRef = useRef(0);
-    const C_WARN_ANSI = '\x1b[38;2;245;158;11m'; // #f59e0b
+    const C_WARN_ANSI = fg(THEME.warn); // #f59e0b
     // ── @ / # 弹出窗状态 ──────────────────────────────────────────────────────
     const mention = useMemo(() => getMention(input), [input]);
     const mentionKey = mention ? `${mention.kind}:${mention.start}` : null;
@@ -179,10 +191,10 @@ const InkApp = ({ onPrompt, initialStatus, getStatusUpdate, terminalW, terminalH
     }, [items, mention, tabState]);
     const popupOpen = !!(tabState || (mention && dismissed !== mentionKey));
     const safeSel = Math.min(sel, Math.max(0, filtered.length - 1));
-    const popupTitle = tabState ? 'Tab 补齐'
-        : mention?.kind === 'agent' ? '@ 智能体'
-            : mention?.kind === 'file' ? '# 文件'
-                : '/ 命令 · 技能 · 插件';
+    const popupTitle = tabState ? POPUP_TITLE_TAB
+        : mention?.kind === 'agent' ? POPUP_TITLE_AGENT
+            : mention?.kind === 'file' ? POPUP_TITLE_FILE
+                : POPUP_TITLE_COMMAND;
     // 在指定 start 位置插入补齐文本 (函数式更新, 闭包安全)
     const insertAt = useCallback((start, it) => {
         setInput(cur => {
@@ -276,34 +288,52 @@ const InkApp = ({ onPrompt, initialStatus, getStatusUpdate, terminalW, terminalH
         }
     }, [input, insertAt]);
     const [tiKey, setTiKey] = useState(0);
+    // 2026-09-08 (Hermes TUI 学习落地): 实时终端尺寸 — 原来 terminalW/H 在 mount 时冻结,
+    //   终端 resize 后分隔线/logo 宽度全错位 (Hermes 用 resizeCoalescer + 实时 layout)。
+    //   订阅 stdout resize, 每次渲染用最新列数。
+    const { stdout } = useStdout();
+    const [termSize, setTermSize] = useState({ w: terminalW, h: terminalH });
+    useEffect(() => {
+        // resizeCoalescer (#9): 拖拽终端时会连发 resize — 聚合到 80ms 空闲后一次性应用, 避免中间态跳帧
+        let raf = null;
+        let pending = null;
+        const apply = () => {
+            if (pending) {
+                const p = pending;
+                pending = null;
+                setTermSize(p);
+            }
+            raf = null;
+        };
+        const update = () => {
+            pending = { w: stdout?.columns || terminalW, h: stdout?.rows || terminalH };
+            if (raf)
+                clearTimeout(raf);
+            raf = setTimeout(apply, 80);
+        };
+        update();
+        stdout?.on?.('resize', update);
+        return () => { stdout?.removeListener?.('resize', update); if (raf)
+            clearTimeout(raf); };
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [stdout]);
+    const W = termSize.w;
     // 全局: 思考动画控制
     useEffect(() => {
         // 2026-08-06: 防御 — 某些环境 (tsx/完整 CLI 初始化) 下 stdin 会处于 paused,
         // 不恢复则 useInput 收不到任何输入 (实测 isPaused=true, listeners=0)
         if (process.stdin.isPaused())
             process.stdin.resume();
-        globalThis.__inkSetThinking = (v) => setThinking(v);
-        globalThis.__inkAppend = (line) => {
-            setMsgs(prev => [...prev, line]);
-        };
-        globalThis.__inkSetStatus = (s) => {
-            setStatus(s);
-        };
+        globalThis.__inkSetThinking = (v) => setUiThinking(v);
+        globalThis.__inkAppend = (line) => appendMsg(line);
+        globalThis.__inkSetStatus = (s) => setUiStatus(s);
         // 2026-08-10: 临时状态行 (自动整理/经验整理): 传字符串显示, 传 null 清空 (显示为空)
-        globalThis.__inkSetTransient = (v) => {
-            setTransient(v === undefined ? null : v);
-        };
-        // 2026-08-12 (Task4): 原地替换最后一条消息 (命令加载态 → 完成态用).
-        //   不命中则追加 (兼容旧逻辑).
-        globalThis.__inkReplaceLast = (line) => {
-            setMsgs(prev => {
-                if (prev.length === 0)
-                    return [...prev, line];
-                const next = prev.slice();
-                next[next.length - 1] = line;
-                return next;
-            });
-        };
+        globalThis.__inkSetTransient = (v) => setUiTransient(v);
+        // 2026-08-12 (Task4): 原地替换最后一条消息 (命令加载态 → 完成态用). 不命中则追加.
+        globalThis.__inkReplaceLast = (line) => replaceLastMsg(line);
+        // 2026-09-08: 按内容匹配替换 — 占位框可能在 P2P/连接消息之后才被替换,
+        //   __inkReplaceLast 会覆盖错一条; 用字符串标记精确定位要替换的消息.
+        globalThis.__inkReplaceMatching = (marker, line) => replaceMarkerMsg(marker, line);
         return () => {
             delete globalThis.__inkAppend;
             delete globalThis.__inkSetStatus;
@@ -443,6 +473,18 @@ const InkApp = ({ onPrompt, initialStatus, getStatusUpdate, terminalW, terminalH
             return; // 其余键忽略 (return/tab/esc 等由 TextInput 或上层处理)
         }
         // ── 正常模式 ──
+        // #7 输入层: 滚动键走数据化 keymap (Ctrl+U/D / PgUp/PgDn / Home-End / Alt+↑↓ / Ctrl+Home-End)
+        if (totalLines > availH) {
+            const pg = Math.max(6, availH - 2);
+            const maxT = Math.max(0, totalLines - availH);
+            const act = resolveNormalKey(key, { scrollable: true, input: _input });
+            if (act !== 'none') {
+                const r = applyScroll(act, stickRef.current ? maxT : (scrollTop || 0), pg, maxT);
+                stickRef.current = r.stick;
+                setScrollTop(r.next);
+                return;
+            }
+        }
         // 2026-08-07: Enter 兜底 — pty/管道下 termios 可能把 \r 转 \n 且 node 把整 chunk
         //   当一次 keypress (key.return=false), TextInput 的 onSubmit 永不触发 → 消息发不出去.
         //   应用层把 \n/\r 一律视为提交 (兼容 raw/cooked 两种模式, 不依赖 termios).
@@ -488,7 +530,7 @@ const InkApp = ({ onPrompt, initialStatus, getStatusUpdate, terminalW, terminalH
         // 双击 Esc 退出当前进程: 第一击提示, 500ms 内第二击退出
         if (key.escape) {
             const now = Date.now();
-            if (now - lastEscRef.current < 500) {
+            if (now - lastEscRef.current < DOUBLE_ESC_MS) {
                 requestExit();
             }
             else {
@@ -522,17 +564,17 @@ const InkApp = ({ onPrompt, initialStatus, getStatusUpdate, terminalW, terminalH
         try {
             const s0 = getStatusUpdate();
             if (s0)
-                setStatus(s0);
+                setUiStatus(s0);
         }
         catch { /* 状态栏更新失败不致命 */ }
         const timer = setInterval(() => {
             try {
                 const s = getStatusUpdate();
                 if (s)
-                    setStatus(s);
+                    setUiStatus(s);
             }
             catch { /* 状态栏更新失败不致命 */ }
-        }, 1000);
+        }, STATUS_TICK_MS);
         return () => clearInterval(timer);
         // eslint-disable-next-line react-hooks/exhaustive-deps
     }, []);
@@ -549,17 +591,40 @@ const InkApp = ({ onPrompt, initialStatus, getStatusUpdate, terminalW, terminalH
             items: filtered.slice(0, 5).map(i => i.kind + ':' + i.label),
         });
     }, [popupOpen, mentionKey, filtered]);
-    // 思考动画 — kaomoji 旋转
-    const KAOMOJI = ['(｀・ω・´)', '(´･_･`)', '(｡•́︿•̀｡)', 'ᕙ(▀̿̿Ĺ̯̿̿▀̿ ̿)ᕗ', '(◕‿◕)'];
+    // 思考动画 — kaomoji 旋转 (帧序列单一来源: loading-tui LOADING_FRAMES, 2026-09-08)
     useEffect(() => {
         if (!thinking)
             return;
         const timer = setInterval(() => {
             thinkingIdx.current = (thinkingIdx.current + 1) % KAOMOJI.length;
-        }, 600);
+        }, THINK_FRAME_MS);
         return () => clearInterval(timer);
     }, [thinking]);
-    return (_jsxs(Box, { flexDirection: "column", height: "100%", children: [_jsxs(Box, { flexGrow: 1, flexDirection: "column", justifyContent: "flex-start", children: [_jsx(LogoBox, { width: terminalW }), _jsx(Messages, { msgs: msgs }), thinking && (_jsx(Box, { children: _jsxs(Text, { color: "yellow", children: [KAOMOJI[thinkingIdx.current], " \u601D\u8003\u4E2D..."] }) })), transient && (_jsx(Box, { children: _jsx(Text, { children: transient }) }))] }), _jsx(Box, { children: _jsx(Text, { bold: true, color: "#c4d640", children: '─'.repeat(terminalW) }) }), _jsx(Box, { children: _jsx(Text, { children: status }) }), _jsx(Box, { children: _jsx(Text, { bold: true, color: "#c4d640", children: '─'.repeat(terminalW) }) }), popupOpen && (tabState || mention) && (_jsx(MentionPopup, { title: popupTitle, items: filtered, sel: safeSel, width: terminalW, loading: loadingFiles })), picker && (_jsx(MentionPopup, { title: picker.title, items: picker.items, sel: Math.min(picker.sel, picker.items.length - 1), width: terminalW })), _jsxs(Box, { children: [_jsx(Text, { bold: true, color: "#c4d640", children: "\u276F " }), _jsx(TextInput, { value: input, onChange: setInput, onSubmit: onSubmit, focus: !popupOpen && !picker, placeholder: "\u8F93\u5165\u6D88\u606F... @\u667A\u80FD\u4F53 /\u547D\u4EE4 #\u6587\u4EF6 \u00B7 Esc \u53CC\u51FB\u9000\u51FA \u00B7 /queue \u6392\u961F \u00B7 !\u7EC8\u7AEF\u547D\u4EE4" }, tiKey)] }), _jsx(Box, { children: _jsx(Text, { bold: true, color: "#c4d640", children: '─'.repeat(terminalW) }) })] }));
+    // ── 虚拟化 transcript (消息级窗口 + 自动跟随底部) ───────────────────────────
+    // #1 分区预留: chrome 固定行 = 分隔线×3 + 状态栏 + 输入栏 = 5; transcript 严格不超区
+    //   (content Box flexGrow=1 但内容超宽会把 status/composer 挤走 → 可见窗口行数钳制 ≤ availH)
+    const availH = Math.max(6, termSize.h - 5);
+    const heights = useMemo(() => msgs.map(m => msgVisualLines(m, W)), [msgs, W]);
+    const cumulative = useMemo(() => {
+        const c = [0];
+        for (const h of heights)
+            c.push(c[c.length - 1] + h);
+        return c;
+    }, [heights]);
+    const totalLines = cumulative[cumulative.length - 1] || 0;
+    const maxTop = Math.max(0, totalLines - availH);
+    const sticky = stickRef.current;
+    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)
+        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) }) })] }));
 };
 export { InkApp };
 // ─── 启动 ────────────────────────────────────────────────────────────────────
@@ -582,15 +647,15 @@ export function stopInk() {
     }
 }
 export function inkAppendLine(line) {
-    const fn = globalThis.__inkAppend;
-    if (fn)
-        fn(line);
+    appendMsg(line);
 }
 /** 2026-08-12 (Task4): 原地替换最后一条消息 (命令加载态 → 完成态). 无消息时追加. */
 export function inkReplaceLastLine(line) {
-    const fn = globalThis.__inkReplaceLast;
-    if (fn)
-        fn(line);
+    replaceLastMsg(line);
+}
+/** 2026-09-08: 按内容标记原地替换一条消息 (占位框 → 启动面板完整内容). */
+export function inkReplaceMatchingLine(marker, line) {
+    replaceMarkerMsg(marker, line);
 }
 export function inkSetStatus(s) {
     const fn = globalThis.__inkSetStatus;
@@ -598,13 +663,9 @@ export function inkSetStatus(s) {
         fn(s);
 }
 export function inkSetThinking(v) {
-    const fn = globalThis.__inkSetThinking;
-    if (fn)
-        fn(v);
+    setUiThinking(v);
 }
 /** 2026-08-10: 设置/清除临时状态行 (自动整理/经验整理). 传 null 清空 → 显示为空 */
 export function inkSetTransient(v) {
-    const fn = globalThis.__inkSetTransient;
-    if (fn)
-        fn(v);
+    setUiTransient(v);
 }

package/dist/cli/keymap.js

@@ -0,0 +1,36 @@
+// ─── 输入层 keymap (Hermes 学习 #7) ────────────────────────────────────────
+//   正常模式按键绑定表 + 纯函数 resolver: useInput 只做分发, 键->意图映射集中在这,
+//   便于单测与扩展 (新增 Ctrl/Meta 组合不再改 useInput 巨块).
+//   注: OSC52 剪贴板 / 精确滚轮 依赖终端能力, Ink useInput 不暴露, 不在本表范围.
+/** 纯函数绑定表: 键 -> 意图 (仅在 scrollable 时响应滚动) */
+export function resolveNormalKey(key, ctx) {
+    if (!ctx.scrollable)
+        return 'none';
+    const ch = ctx.input.toLowerCase();
+    // 上滚: Ctrl+U / PgUp / Alt+↑
+    if (key.ctrl && ch === 'u' || key.pageUp || key.meta && key.upArrow)
+        return 'scrollUp';
+    // 下滚: Ctrl+D / PgDn / Alt+↓
+    if (key.ctrl && ch === 'd' || key.pageDown || key.meta && key.downArrow)
+        return 'scrollDown';
+    // 顶部: Home / Ctrl+Home
+    if (key.home || key.ctrl && ch === 'a')
+        return 'scrollHome';
+    // 底部: End / Ctrl+End
+    if (key.end || key.ctrl && ch === 'e')
+        return 'scrollEnd';
+    return 'none';
+}
+/** 把意图映射成 scrollTop 平移量 (纯函数, 便于断言) */
+export function applyScroll(act, cur, page, maxTop) {
+    switch (act) {
+        case 'scrollUp': return { next: Math.max(0, Math.min(cur - page, maxTop)), stick: false };
+        case 'scrollDown': {
+            const nx = Math.min(cur + page, maxTop);
+            return { next: nx, stick: nx >= maxTop };
+        }
+        case 'scrollHome': return { next: 0, stick: false };
+        case 'scrollEnd': return { next: maxTop, stick: true };
+        default: return { next: cur, stick: false };
+    }
+}

package/dist/cli/loading-tui.js

@@ -14,6 +14,7 @@
 import * as fs from 'fs';
 import * as path from 'path';
 import { fileURLToPath } from 'url';
+import { mdInline } from './markdown.js';
 const RESET = '\x1b[0m';
 const BOLD = '\x1b[1m';
 const DIM = '\x1b[2m';
@@ -48,7 +49,7 @@ const BOLLOON_VERSION = getPackageVersion();
 // ── 品牌图标: 笑脸机器人 (2026-08-09, bolloon 色系填充) ──────
 //   头: 主色边框 + 亮绿填充 (C_ACCENT_BG); 眼睛 ◉ / 嘴 ◡ 用亮色填充;
 //   末行 BOLLOON 主色艺术字 (仅 printBanner 用, brandArtLines 会裁掉避免双 logo).
-const ROBOT_HEAD = [
+export const ROBOT_HEAD = [
     `${C_ACCENT}   ╭───────╮${RESET}`,
     `${C_ACCENT} ╭─╯${C_ACCENT_BG}  ${C_WHITE}◉${C_ACCENT_BG} ${C_WHITE}◉${C_ACCENT_BG}  ${RESET}${C_ACCENT}╰─╮${RESET}`,
     `${C_ACCENT} │${C_ACCENT_BG}     ${C_WHITE}◡${C_ACCENT_BG}     ${RESET}${C_ACCENT}│${RESET}`,
@@ -328,11 +329,11 @@ function renderReference(opts) {
 }
 /** 已发送消息框 (用户输入) */
 export function renderUserMessage(body) {
-    return renderMessageBox({ title: '✓ 已发送', body, color: C_OK, maxLines: DEFAULT_MAX_LINES });
+    return renderMessageBox({ title: '✓ 已发送', body: mdInline(body), color: C_OK, maxLines: DEFAULT_MAX_LINES });
 }
 /** 智能体回复框 (不压缩, 用户需要看到完整回复) */
 export function renderAgentMessage(body) {
-    return renderMessageBox({ title: '◉ Bolloon Agent', body, color: C_ACCENT, maxLines: 0 });
+    return renderMessageBox({ title: '◉ Bolloon Agent', body: mdInline(body), color: C_ACCENT, maxLines: 0 });
 }
 /** 循环工作流连接线: 用 ╼ ╾ 串联相邻工具框 */
 export function flowConnector(width) {
@@ -423,7 +424,9 @@ export function renderToolCall(v) {
     lines.push(boxBottom(w, RD));
     return lines.join('\n');
 }
-const FRAMES = ['(｀・ω・´)', '(´･_･`)', '(｡•́︿•̀｡)', 'ᕙ(▀̿̿Ĺ̯̿̿▀̿ ̿)ᕗ', '(◕‿◕)', 'ヽ(´▽｀)/'];
+// 2026-09-08 (Hermes TUI 学习): 帧序列单一来源 — loading-tui 导出, ink-app 思考动画复用,
+//   原来两份拷贝 (FRAMES / KAOMOJI) 会漂移.
+export const LOADING_FRAMES = ['(｀・ω・´)', '(´･_･`)', '(｡•́︿•̀｡)', 'ᕙ(▀̿̿Ĺ̯̿̿▀̿ ̿)ᕗ', '(◕‿◕)', 'ヽ(´▽｀)/'];
 export class LoadingTUI {
     write;
     timer = null;
@@ -432,7 +435,6 @@ export class LoadingTUI {
     currentLabel = 'Bolloon loading...';
     finished = false;
     ok = true;
-    width = 0;
     constructor() {
         this.write = process.stdout.write.bind(process.stdout);
     }
@@ -448,7 +450,9 @@ export class LoadingTUI {
         return 1 + brandArtLines().length + this.steps.length + 1 + 1;
     }
     draw(showSpinner) {
-        const w = this.width || (this.width = this.computeWidth());
+        // 2026-09-08 (Hermes TUI 学习): 每次 draw 实时算宽度 — 原首次缓存 (this.width),
+        //   启动过程中 resize 终端 → 仪表盘整框错位; computeWidth 每次成本可忽略
+        const w = this.computeWidth();
         const out = [];
         out.push(boxTop('Bolloon Agent · 启动仪表盘', w));
         for (const l of brandArtLines())
@@ -457,7 +461,7 @@ export class LoadingTUI {
             out.push(boxRow(`${STATUS_SYMBOL[step.status]} ${step.label}`, w));
         }
         if (showSpinner) {
-            const sp = C_WARN + FRAMES[this.frameIdx % FRAMES.length] + RESET;
+            const sp = C_WARN + LOADING_FRAMES[this.frameIdx % LOADING_FRAMES.length] + RESET;
             out.push(boxRow(`${sp} ${this.currentLabel}`, w));
         }
         else {
@@ -470,7 +474,6 @@ export class LoadingTUI {
     }
     setSteps(steps) {
         this.steps = steps.map(label => ({ label, status: 'pending' }));
-        this.width = 0;
         if (this.timer)
             this.draw(true);
     }

package/dist/cli/markdown.js

@@ -0,0 +1,18 @@
+// ─── 内联 Markdown 分词渲染 (Hermes 学习 #4 之 MessageLine) ────────────────
+//   把正文里的 `code` / **bold** / _italic_ / __underline__ 转成 ANSI 高亮,
+//   供 renderUserMessage / renderAgentMessage 在出框前套用 (字节变长, dispWidth 剥 ANSI 不计宽).
+//   仅内联分段; ```
+//   多行代码块折叠/Thinking/ToolTrail 折叠 仍待续.
+const R = '\x1b[0m';
+const BOLD = '\x1b[1m';
+const DIM = '\x1b[2m';
+const UNDER = '\x1b[4m';
+const CYAN = '\x1b[36m';
+const GREEN = '\x1b[32m';
+export function mdInline(s) {
+    return s
+        .replace(/`([^`]+)`/g, (_, c) => `${CYAN}${c}${R}`)
+        .replace(/\*\*([^*]+)\*\*/g, (_, c) => `${BOLD}${c}${R}`)
+        .replace(/__([^_]+)__/g, (_, c) => `${UNDER}${c}${R}`)
+        .replace(/(^|[^*\w])\*([^*\s][^*]*)\*/g, (_m, p, c) => `${p}${GREEN}${c}${R}`);
+}

package/dist/cli/stores.js

@@ -0,0 +1,64 @@
+// ─── 状态外置 (Hermes 学习 #2): 每域一小 store + 纯函数 action ──────────────
+//   目的: 状态不再散在 InkApp 单组件 useState 里, 而是集中到可订阅的 store,
+//         输入/桥接 handler 变为 over store 的纯函数, 便于单测与热置换.
+//   用 useSyncExternalStore 订阅 (React 18+, 与 nanostores 同款订阅语义).
+import { useSyncExternalStore } from 'react';
+export function createStore(initial) {
+    let state = initial;
+    const subs = new Set();
+    return {
+        get: () => state,
+        set: (v) => {
+            if (Object.is(v, state))
+                return;
+            state = v;
+            subs.forEach((cb) => cb());
+        },
+        subscribe: (cb) => {
+            subs.add(cb);
+            return () => { subs.delete(cb); };
+        },
+    };
+}
+/** 订阅 store, 值变化触发重渲染 (外部状态源统一入口) */
+export function useStore(s) {
+    return useSyncExternalStore(s.subscribe, s.get, s.get);
+}
+// ── 域 store ────────────────────────────────────────────────────────────────
+/** transcript: 消息列表 (agent/用户/系统行) — 供虚拟化/滚动/桥接读写 */
+export const transcriptStore = createStore([]);
+export const uiStore = createStore({ status: '', thinking: false, transient: null });
+// ── 纯函数 action (bridge 与组件都走这里) ────────────────────────────────────
+export function appendMsg(line) {
+    const c = transcriptStore.get();
+    transcriptStore.set([...c, line]);
+}
+export function replaceLastMsg(line) {
+    const c = transcriptStore.get();
+    if (c.length === 0) {
+        transcriptStore.set([line]);
+        return;
+    }
+    const n = c.slice();
+    n[n.length - 1] = line;
+    transcriptStore.set(n);
+}
+/** 按内容标记原地替换一条 (占位框 → 完整内容); 未命中不改 */
+export function replaceMarkerMsg(marker, line) {
+    const c = transcriptStore.get();
+    const i = c.indexOf(marker);
+    if (i < 0)
+        return;
+    const n = c.slice();
+    n[i] = line;
+    transcriptStore.set(n);
+}
+export function setUiStatus(status) {
+    uiStore.set({ ...uiStore.get(), status });
+}
+export function setUiThinking(thinking) {
+    uiStore.set({ ...uiStore.get(), thinking });
+}
+export function setUiTransient(v) {
+    uiStore.set({ ...uiStore.get(), transient: v === undefined ? null : v });
+}

package/dist/cli/theme.js

@@ -0,0 +1,23 @@
+/**
+ * theme.ts — bolloon TUI 主题 token (唯一颜色事实源)
+ * 与 Web UI 一致: 主色 #c4d640, 文本 #d8d8c8, 警告 #f59e0b, 成功 #22c55e, 错误 #ef4444。
+ * 组件一律引用 THEME.*, 不再散落 hex 字面量。后续可扩展皮肤/深色切换。
+ */
+export const THEME = {
+    accent: '#c4d640', // 主色 (bolloon 绿)
+    text: '#d8d8c8', // 正文
+    muted: '#606058', // 次要/暗层
+    dim: '#909088', // 更暗
+    ok: '#22c55e', // 成功
+    error: '#ef4444', // 错误
+    warn: '#f59e0b', // 警告
+    border: '#3a3a36', // 暗描边
+    borderBright: '#8a8a7e', // 对话框边框提亮
+};
+/** '#c4d640' → '\x1b[38;2;196;214;64m' ANSI 前景色码 */
+export function fg(hex) {
+    const r = parseInt(hex.slice(1, 3), 16);
+    const g = parseInt(hex.slice(3, 5), 16);
+    const b = parseInt(hex.slice(5, 7), 16);
+    return `\x1b[38;2;${r};${g};${b}m`;
+}

package/dist/cli/timing.js

@@ -0,0 +1,8 @@
+/**
+ * timing.ts — TUI 时序常量 (原来散落魔法数字)
+ */
+export const DOUBLE_ESC_MS = 500; // 双击 Esc 退出窗口
+export const STATUS_TICK_MS = 1000; // 状态栏刷新周期
+export const THINK_FRAME_MS = 600; // 思考 kaomoji 帧间隔
+export const LOAD_FRAME_MS = 100; // 启动仪表盘帧间隔
+export const CHUNK_GUARD_DELAY_MS = 0; // 控制字符纠偏 setTimeout(0)

package/dist/cli/widget-host.js

@@ -0,0 +1,68 @@
+// ─── 占用槽 / widget host (Hermes 学习 #8) ────────────────────────────────
+//   在 UI 右侧保留一个 rails 槽位 (占用槽), 供外部 widget 注册渲染.
+//   触点: registerWidget / unregisterWidget / refreshWidgets / listWidgets.
+//   默认无 widget 时槽位不占宽 (布局不变); 有 widget 时才预留右侧列.
+//   .mjs 热加载: hotReloadWidgets(dir) 监听目录, 动态 import 模块 (模块调用 registerWidget 注册).
+import * as fs from 'fs';
+import * as path from 'path';
+import { pathToFileURL } from 'url';
+import { useSyncExternalStore } from 'react';
+let widgets = new Map();
+let cache = null; // getSnapshot 必须缓存同引用, 否则 useSyncExternalStore 无限重渲
+const subs = new Set();
+function rebuild() {
+    const out = {};
+    for (const [name, w] of widgets)
+        out[name] = w.text;
+    cache = out;
+    return out;
+}
+function emit() { cache = null; subs.forEach((cb) => cb()); }
+export function getWidgets() {
+    if (!cache)
+        rebuild();
+    return cache;
+}
+/** 4 触点之一: 注册 (render 在注册时立即执行一次, 得 text) */
+export function registerWidget(name, render) {
+    widgets.set(name, { name, render, text: render() });
+    emit();
+}
+export function unregisterWidget(name) {
+    if (widgets.delete(name))
+        emit();
+}
+/** 重新执行所有 widget 的 render (数据/间隔刷新) */
+export function refreshWidgets() {
+    for (const [name, w] of widgets) {
+        try {
+            w.text = w.render();
+        }
+        catch { /* 单个 widget 渲染失败不致命 */ }
+    }
+    emit();
+}
+export function listWidgets() { return [...widgets.keys()]; }
+/** 仅测试用: 清空所有 widget */
+export function resetWidgetsForTest() { widgets = new Map(); emit(); }
+export function subscribeWidgets(cb) { subs.add(cb); return () => { subs.delete(cb); }; }
+/** React 订阅: 返回 {name: text} (槽位渲染用) */
+export function useWidgets() {
+    return useSyncExternalStore(subscribeWidgets, getWidgets, getWidgets);
+}
+/** .mjs 热加载: 监听 dir, 新增/变更的 .mjs 直接 import (模块内调 registerWidget); 失败静默 */
+export function hotReloadWidgets(dir) {
+    if (!fs.existsSync(dir))
+        return null;
+    const loaded = new Set();
+    const load = (f) => {
+        if (f.endsWith('.mjs') && !loaded.has(f)) {
+            loaded.add(f);
+            import(pathToFileURL(path.join(dir, f)).href).catch(() => { });
+        }
+    };
+    for (const f of fs.readdirSync(dir))
+        load(f);
+    return setInterval(() => { for (const f of fs.readdirSync(dir))
+        load(f); }, 3000);
+}

package/dist/index.js

@@ -6,7 +6,7 @@ import { sha512 } from '@noble/hashes/sha2.js';
 import * as fs from 'fs/promises';
 import { existsSync, mkdirSync } from 'fs';
 import * as path from 'path';
-import { spawn } from 'child_process';
+import { spawn, execSync } from 'child_process';
 import * as os from 'os';
 import { documentReader } from './documents/reader.js';
 import { initMinimax } from './constraints/index.js';
@@ -15,8 +15,8 @@ import { createSubAgentManager } from './agents/subagent-manager.js';
 import { getGlobalSharedContext } from './social/global-shared-context.js';
 import { createBollharnessIntegration } from './bollharness-integration/index.js';
 import * as readline from 'readline';
-import { printBanner, renderDialog, renderUserMessage, renderAgentMessage, renderMessageBox, renderToolCallListItem, termWidth } from './cli/loading-tui.js';
-import { startInk, stopInk, inkAppendLine as appendLine, inkSetStatus, inkSetThinking, inkSetTransient } from './cli/ink-app.js';
+import { printBanner, renderDialog, renderUserMessage, renderAgentMessage, renderMessageBox, renderToolCallListItem, termWidth, ROBOT_HEAD, BOLLOON_BANNER, dispWidth } from './cli/loading-tui.js';
+import { startInk, stopInk, inkAppendLine as appendLine, inkReplaceMatchingLine, inkSetStatus, inkSetThinking, inkSetTransient } from './cli/ink-app.js';
 // 启动自动检查更新：后台、节流、检测到新版本自动安装（可被 --no-update / BOLLOON_SKIP_UPDATE 关闭）
 import { createRequire } from 'module';
 const _require = createRequire(import.meta.url);
@@ -497,25 +497,169 @@ function statusBarLine() {
     const usage = getCliCtxUsage();
     return `${C_ACCENT}${cliModelName}${RESET}${C_DIM}  │${RESET} ${cliAgentName} ${C_DIM}│${RESET} ⏱ ${C_ACCENT}${dur}${RESET} ${C_DIM}│${RESET} ${buildContextBar(usage)}`;
 }
+/**
+ * 启动会话面板 — 按类别展示启动加载的 skills (真实类别 = 目录名去掉 frontmatter.name 后缀),
+ * 每类一行 (前 6 名 + '+N more'), 结尾 totals; skills/tools 并行 (各 2.5s 预算), 失败静默.
+ */
+/** 启动面板框: BOLLOON 字标 logo 顶部居中 → 下方两栏 = face 艺术字(左) + 加载内容(右) */
+function buildBootBox(face, banner, rest) {
+    const faceW = Math.max(1, ...face.map((l) => dispWidth(l)));
+    const bannerMax = Math.max(1, ...banner.map((l) => dispWidth(l)));
+    const restMax = Math.max(1, ...rest.map((l) => dispWidth(l)));
+    const gap = 4;
+    const twoColW = faceW + gap + restMax;
+    const contentW = Math.max(bannerMax + 8, twoColW);
+    const center = (rows) => rows.map((l) => ' '.repeat(Math.max(0, Math.floor((contentW - dispWidth(l)) / 2))) + l);
+    const n = rest.length;
+    const fStart = Math.max(0, Math.floor((n - face.length) / 2)); // face 列对内容垂直居中 = 等高
+    const twoCol = rest.map((r, i) => {
+        const f = (i >= fStart && i < fStart + face.length) ? face[i - fStart] : null;
+        const fpart = f ? `${f}${' '.repeat(Math.max(0, faceW - dispWidth(f)) + gap)}` : ' '.repeat(faceW + gap);
+        return fpart + r;
+    });
+    const body = [...center(banner), '', ...twoCol];
+    return renderMessageBox({ title: '🚀 Bolloon · 启动面板', body: body.join('\n'), color: C_ACCENT, maxLines: 0 });
+}
+async function bootPanel(boot) {
+    const sub = []; // tools / MCP (Promise.all 里填充, 最后统一排到类别下方)
+    const catNames = new Map();
+    await Promise.all([
+        (async () => {
+            try {
+                // 真实类别 = 目录名前缀去掉技能名后缀 (SKILL.md 无 category 字段, 但 frontmatter.name 是真名:
+                //   software-development-bolloon-development / name=bolloon-development → software-development)
+                const { loadSkillsDir, defaultSkillPaths } = await import('./agents/skill-loader.js');
+                const pushCat = (cat, name) => {
+                    const arr = catNames.get(cat) || [];
+                    if (!arr.includes(name))
+                        arr.push(name);
+                    catNames.set(cat, arr);
+                };
+                for (const root of defaultSkillPaths()) {
+                    const metas = await loadSkillsDir(root);
+                    for (const m of metas) {
+                        if (m.status === 'archived')
+                            continue;
+                        const dir = m.sourcePath ? path.basename(path.dirname(m.sourcePath)) : '';
+                        const nm = m.name || '';
+                        let cat = dir;
+                        if (dir && nm && dir.endsWith(nm)) {
+                            const pre = dir.slice(0, dir.length - nm.length).replace(/-+$/, '');
+                            if (pre)
+                                cat = pre;
+                        }
+                        pushCat(cat || 'other', nm || dir);
+                    }
+                }
+            }
+            catch { /* 省略 */ }
+        })(),
+        (async () => {
+            try {
+                const a = await Promise.race([
+                    getAgent().catch(() => null),
+                    new Promise((res) => setTimeout(() => res(null), 2500)),
+                ]);
+                const tools = a && typeof a.getToolList === 'function' ? a.getToolList() : null;
+                if (tools && tools.length > 0)
+                    sub.push(`🔧 ${tools.length} tools`);
+            }
+            catch { /* 省略 */ }
+        })(),
+        (async () => {
+            try {
+                const { getAdapterStatus } = await import('./pi-ecosystem-mcp/index.js');
+                const st = getAdapterStatus();
+                if (st.initialized && st.serverCount > 0)
+                    sub.push(`🔌 MCP ${st.serverCount} 服务器 · ${st.toolCount} tools`);
+            }
+            catch { /* 省略 */ }
+        })(),
+    ]);
+    // 栈式布局: face 艺术字居中 → BOLLOON 字标 logo 在其下 → 内容左对齐
+    const art = ROBOT_HEAD;
+    const banner = BOLLOON_BANNER.split('\n');
+    // 头: 目录 / 模型 / Session (预先加载信息)
+    const rest = [];
+    if (boot.dir)
+        rest.push(`📁 ${boot.dir}`);
+    if (boot.model)
+        rest.push(`模型 ${boot.model}`);
+    if (boot.session)
+        rest.push(`Session: ${boot.session}`);
+    rest.push('');
+    // 类别行 (全部展开, 不截断类别; 每类列前 8 名 + '+N more') — 单一实例归 other
+    const normalized = new Map();
+    for (const [cat, arr] of catNames) {
+        if (arr.length === 1) {
+            const o = normalized.get('other') || [];
+            o.push(...arr);
+            normalized.set('other', o);
+        }
+        else {
+            normalized.set(cat, (normalized.get(cat) || []).concat(arr));
+        }
+    }
+    const sorted = [...normalized.entries()].sort((a, b) => b[1].length - a[1].length);
+    const total = sorted.reduce((s, [, arr]) => s + arr.length, 0);
+    for (const [cat, arr] of sorted) {
+        const shown = arr.slice(0, 8);
+        const more = arr.length > shown.length ? `, +${arr.length - shown.length} more` : '';
+        rest.push(`${cat}: ${shown.join(', ')}${more}`);
+    }
+    rest.push(`⚡ ${total} skills · ${sorted.length} 类`, '');
+    if (sub.length)
+        rest.push(...sub, '');
+    // 自动整理 (经验/技能整理心跳) 模式并入面板
+    rest.push(`🧹 经验自动整理: 启动后每 30min 一次`);
+    try {
+        const branch = execSync('git rev-parse --abbrev-ref HEAD 2>/dev/null', { encoding: 'utf8', timeout: 1500 }).trim();
+        if (branch)
+            rest.push(`⎇ ${branch}`);
+    }
+    catch { /* 非 git 目录省略 */ }
+    try {
+        rest.push(new Date().toLocaleTimeString('zh-CN', { hour12: false }));
+    }
+    catch { /* 忽略 */ }
+    if (rest.length <= 3)
+        return null;
+    // 启动面板框: BOLLOON 字标 logo 顶部居中 → 下方两栏 = face 艺术字(左) + skills/信息(右)
+    return buildBootBox(art, banner, rest);
+}
 async function startCLI(commReady) {
     isRunning = true;
     // 2026-09-08 加速启动: P2P 后台就绪, UI 直接渲染不阻塞 — comm 就绪前为 null,
     // 内部用法全空安全 (P2P 功能自动降级, 就绪后立即可用)
     let comm = null;
     commReady.then((c) => { comm = c; }).catch(() => { });
-    // CLI 模式下静音所有 console.log/warn
-    // (Ink 用自己的 render 引擎, console.log 输出会污染终端)
+    // CLI 模式下静音所有 console.log/warn/info/debug
+    // (Ink 用自己的 render 引擎, console 输出会污染终端)
     console.log = () => { };
     console.warn = () => { };
-    // 同时过滤 process.stdout.write — 阻止 [xxx] 前缀的输出
+    console.info = () => { };
+    console.debug = () => { };
+    // 过滤 process.stdout/stderr.write — 丢弃启动期 SDK/后台日志
+    //   (ISO 时间戳前缀如 `2026-09-08T...Z [info]:` 或被 [info]/[warn]/[error] 标记的行)
     const _origStdout = process.stdout.write.bind(process.stdout);
-    process.stdout.write = ((chunk, ...rest) => {
+    const _origStderr = process.stderr.write.bind(process.stderr);
+    const isLogLine = (line) => {
+        const t = line.trimStart();
+        return t.startsWith('[') || /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}/.test(t) || /\[\s*(info|warn|error|debug|log)\s*\]/.test(t)
+            // Kubo/ipfs 启动噪声: "Use 'ipfs init --help'..." / "ipfs daemon is running..." 提示行无时间戳, 一并丢弃
+            || /ipfs init --help|ipfs daemon is running|please stop it to run this command/i.test(t);
+    };
+    const wrap = (orig) => (chunk, ...rest) => {
         const s = typeof chunk === 'string' ? chunk : String(chunk);
-        // 过滤以 [ 开头的行 (agent 内部日志)
-        if (s.trimStart().startsWith('['))
-            return true;
-        return _origStdout(chunk, ...rest);
-    });
+        if (!isLogLine(s))
+            return orig(chunk, ...rest);
+        const keep = s.split('\n').filter((l) => !isLogLine(l)).join('\n');
+        if (keep)
+            orig(keep, ...rest);
+        return true;
+    };
+    process.stdout.write = wrap(_origStdout);
+    process.stderr.write = wrap(_origStderr);
     let peerCount = 0;
     void commReady.then((c) => { try {
         if (c)
@@ -594,6 +738,13 @@ async function startCLI(commReady) {
     }
     catch { /* 降级: getCliCtxUsage 返回 0/1M */ }
     const initialStatus = `${C_ACCENT}${cliModelName}${RESET}${C_DIM}  │${RESET} ${cliAgentName} ${C_DIM}│${RESET} ⏱ 0s${C_DIM} │${RESET} ${buildContextBar(getCliCtxUsage())}`;
+    // 2026-09-08 (leo 规格): 图标下元信息层数据 — 目录(home→~) / 模型 / Session id (Hermes 风格: YYYYMMDD_HHMMSS_xxxx)
+    const bootDirShort = process.cwd().replace(os.homedir(), '~');
+    const bootSessionId = (() => {
+        const d = new Date(cliStartTime);
+        const p = (n, l = 2) => String(n).padStart(l, '0');
+        return `${d.getFullYear()}${p(d.getMonth() + 1)}${p(d.getDate())}_${p(d.getHours())}${p(d.getMinutes())}${p(d.getSeconds())}_${Math.random().toString(16).slice(2, 8)}`;
+    })();
     startInk((text) => { processInput(text, comm); }, initialStatus, getStatus);
     // 2026-08-10: 自动整理心跳 (CLI 侧, 与社交心跳并列) — 启动后立即"固定看一下 skills view"
     //   (扫描遗留 skills), 之后按周期 (默认 30min, env BOLLOON_ORGANIZE_HEARTBEAT_MS) 完整进化经验.
@@ -683,6 +834,18 @@ async function startCLI(commReady) {
         setTimeout(() => { cronScheduler.tick().catch(() => { }); }, 15_000);
     }
     catch { /* cron 调度启动失败不阻塞 CLI */ }
+    // 启动会话面板 (大框): 栈式 = face 艺术字居中 + BOLLOON 字标 logo 在其下 + 预设信息(skills/工具/模型/目录/Session/分支/时间)
+    //   先立即渲染「艺术字 + logo + 正在加载...」, bootPanel 就绪后 inkReplaceMatchingLine 按标记原位替换为完整内容
+    //   (用匹配替换而非 replaceLast — P2P/连接消息可能先于 bootPanel 追加, replaceLast 会覆盖错一条)
+    const bootBox = buildBootBox(ROBOT_HEAD, BOLLOON_BANNER.split('\n'), [
+        `${bootDirShort}  ·  ${(cliModelName && cliModelName !== '…') ? cliModelName : ''}  ·  Session: ${bootSessionId}`,
+        '',
+        '⟳ 正在加载技能 / 工具...',
+    ]);
+    appendLine(bootBox);
+    void bootPanel({ dir: bootDirShort, model: (cliModelName && cliModelName !== '…') ? cliModelName : undefined, session: bootSessionId })
+        .then((box) => { if (box)
+        inkReplaceMatchingLine(bootBox, box); }).catch(() => { });
     // Wait on a promise that resolves on Ctrl+C / 双击 Esc
     // (ink-app 的 requestExit 调 __inkRequestExit → resolve, 清理后 process.exit)
     let cliExitResolve = () => { };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bolloon/bolloon-agent",
-  "version": "0.4.17",
+  "version": "0.4.18",
   "type": "module",
   "description": "P2P AI Document Agent - 全局安装后执行 `bolloon` 启动产品",
   "main": "dist/cli-entry.js",