@bolloon/bolloon-agent 0.3.30 → 0.3.32

package/dist/agents/pi-sdk-tools.js

@@ -948,6 +948,134 @@ export function registerBuiltinTools(ctx) {
             }
         }
     });
+    // ============================================================
+    // Web 上网工具 (2026-08-04) — fetch_url + web_search
+    // 用 undici request (独立连接池, 与 pi-ai 一致, 避开全局 fetch 僵尸连接问题)
+    // ============================================================
+    ctx.tools.set('fetch_url', {
+        name: 'fetch_url',
+        description: '抓取一个 URL 的网页内容并转成纯文本. 适合查文档/新闻/API 页面. 返回前 4000 字符. HTML 自动去标签, JSON/文本原样返回. (走 curl, 兼容 TLS 指纹风控)',
+        parameters: { url: '完整 URL (必填, 含 https://)' },
+        execute: async (args) => {
+            try {
+                const url = String(args.url || '').trim();
+                if (!url)
+                    return { success: false, error: 'url 必填' };
+                if (!/^https?:\/\//i.test(url))
+                    return { success: false, error: 'url 必须以 http(s):// 开头' };
+                const { execFile } = await import('child_process');
+                const { promisify } = await import('util');
+                const pExecFile = promisify(execFile);
+                const { stdout, stderr } = await pExecFile('curl', [
+                    '-sL', '--max-time', '25',
+                    '-A', 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0 Safari/537.36',
+                    '-H', 'Accept-Language: zh-CN,zh;q=0.9,en;q=0.8',
+                    url,
+                ], { maxBuffer: 2 * 1024 * 1024, timeout: 30_000 });
+                if (!stdout && stderr)
+                    return { success: false, error: `fetch_url 失败: ${String(stderr).slice(0, 200)}` };
+                const raw = stdout.slice(0, 60_000);
+                const trimmed = raw.trimStart();
+                let text;
+                if (trimmed.startsWith('<!doctype') || trimmed.startsWith('<html') || /^<\?xml/i.test(trimmed)) {
+                    text = raw
+                        .replace(/<script[\s\S]*?<\/script>/gi, ' ')
+                        .replace(/<style[\s\S]*?<\/style>/gi, ' ')
+                        .replace(/<[^>]+>/g, ' ')
+                        .replace(/&nbsp;/g, ' ').replace(/&amp;/g, '&').replace(/&lt;/g, '<').replace(/&gt;/g, '>').replace(/&quot;/g, '"').replace(/&#39;/g, "'")
+                        .replace(/\s+/g, ' ')
+                        .trim();
+                }
+                else {
+                    text = raw;
+                }
+                const out = text.slice(0, 4000);
+                return { success: true, output: `🌐 ${url} (${raw.length} bytes):\n${out}${text.length > 4000 ? '\n...(截断, 共 ' + text.length + ' 字符)' : ''}` };
+            }
+            catch (e) {
+                return { success: false, error: `fetch_url 失败: ${String(e?.message || e).slice(0, 200)}` };
+            }
+        }
+    });
+    ctx.tools.set('web_search', {
+        name: 'web_search',
+        description: '网页搜索. 无 key 时走 DuckDuckGo Instant Answer API + Wikipedia (知识/资讯查询可靠); 配置 TAVILY_API_KEY 时走 Tavily 完整搜索 (更全). 返回前 8 条标题+URL+摘要.',
+        parameters: { query: '搜索词 (必填)' },
+        execute: async (args) => {
+            try {
+                const query = String(args.query || '').trim();
+                if (!query)
+                    return { success: false, error: 'query 必填' };
+                const { execFile } = await import('child_process');
+                const { promisify } = await import('util');
+                const pExecFile = promisify(execFile);
+                const UA = 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36';
+                const curlJson = async (url) => {
+                    const r = await pExecFile('curl', ['-s', '--max-time', '15', '-A', UA, url], { maxBuffer: 4 * 1024 * 1024, timeout: 20_000 });
+                    return JSON.parse(r.stdout);
+                };
+                // 引擎 0: Tavily (配了 TAVILY_API_KEY 时最完整)
+                const tavilyKey = process.env.TAVILY_API_KEY || '';
+                if (tavilyKey) {
+                    const r = await pExecFile('curl', [
+                        '-s', '--max-time', '20', '-A', UA,
+                        '-X', 'POST', 'https://api.tavily.com/search',
+                        '-H', 'Content-Type: application/json',
+                        '-d', JSON.stringify({ api_key: tavilyKey, query, max_results: 8, include_answer: true }),
+                    ], { maxBuffer: 4 * 1024 * 1024, timeout: 25_000 });
+                    const d = JSON.parse(r.stdout);
+                    const results = d.results || [];
+                    if (results.length > 0) {
+                        const lines = results.slice(0, 8).map((x, i) => `${i + 1}. ${x.title}\n  ${x.url}${x.content ? '\n   ' + String(x.content).replace(/\s+/g, ' ').slice(0, 150) : ''}`);
+                        const answer = d.answer ? `\n📌 ${d.answer}\n` : '';
+                        return { success: true, output: `🔎 "${query}" 结果 ${results.length} 条 (Tavily):${answer}\n\n${lines.join('\n\n')}` };
+                    }
+                }
+                // 引擎 1: DuckDuckGo Instant Answer API (摘要 + 相关主题)
+                try {
+                    const ia = await curlJson(`https://api.duckduckgo.com/?q=${encodeURIComponent(query)}&format=json&no_html=1`);
+                    const out = [];
+                    if (ia.AbstractText && ia.AbstractURL) {
+                        out.push(`📖 ${ia.AbstractText.slice(0, 400)}\n  ${ia.AbstractURL}`);
+                    }
+                    const topics = Array.isArray(ia.RelatedTopics) ? ia.RelatedTopics : [];
+                    for (const t of topics) {
+                        if (out.length >= 8)
+                            break;
+                        if (t.Topics) { // 分类组
+                            for (const sub of t.Topics) {
+                                if (out.length >= 8)
+                                    break;
+                                if (sub.Text && sub.FirstURL)
+                                    out.push(`${out.length + 1}. ${sub.Text.slice(0, 200)}\n  ${sub.FirstURL}`);
+                            }
+                        }
+                        else if (t.Text && t.FirstURL) {
+                            out.push(`${out.length + 1}. ${t.Text.slice(0, 200)}\n  ${t.FirstURL}`);
+                        }
+                    }
+                    if (out.length > 0) {
+                        return { success: true, output: `🔎 "${query}" (DuckDuckGo):\n\n${out.join('\n\n')}` };
+                    }
+                }
+                catch { /* fallback */ }
+                // 引擎 2: Wikipedia 搜索 API
+                try {
+                    const wiki = await curlJson(`https://zh.wikipedia.org/w/api.php?action=query&list=search&srsearch=${encodeURIComponent(query)}&format=json&srlimit=5`);
+                    const hits = wiki?.query?.search || [];
+                    if (hits.length > 0) {
+                        const lines = hits.map((h, i) => `${i + 1}. ${h.title}\n  https://zh.wikipedia.org/wiki/${encodeURIComponent(h.title.replace(/ /g, '_'))}\n   ${String(h.snippet || '').replace(/<[^>]+>/g, '').slice(0, 120)}`);
+                        return { success: true, output: `🔎 "${query}" (维基百科 ${hits.length} 条):\n\n${lines.join('\n\n')}` };
+                    }
+                }
+                catch { /* fallback */ }
+                return { success: true, output: `🔎 "${query}" 无结果 (免费引擎无匹配, 可配 TAVILY_API_KEY 提升覆盖)` };
+            }
+            catch (e) {
+                return { success: false, error: `web_search 失败: ${String(e?.message || e).slice(0, 200)}` };
+            }
+        }
+    });
     ctx.tools.set('git_log', {
         name: 'git_log',
         description: '查看 git log. 默认 --oneline -10. 支持过滤和范围.',

package/dist/cli/ink-app.js

@@ -3,11 +3,15 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  * ink-app.tsx — Ink (React for CLI) 渲染入口
  *
  * 用 Yoga flexbox 布局实现: 内容置顶, 输入栏固定底部, 状态栏固定
+ *
+ * 2026-08-05: @ / # 弹出选择窗 — 输入 @ 命中智能体, / 命中命令+技能+插件, # 命中文件
+ *   ↑/↓ 导航, Tab/Enter 选中, Esc 关闭, 弹出窗打开时 TextInput 让出焦点 (focus=false)
  */
-import { useState, useEffect, useCallback, useRef } from 'react';
+import { useState, useEffect, useCallback, useRef, useMemo } from 'react';
 import { render, Box, Text, useInput, useApp } from 'ink';
 import TextInput from 'ink-text-input';
 import { brandArtLines, boxTop, boxRow, boxBottom, dispWidth } from './loading-tui.js';
+import { loadAgents, loadCommands, loadSkills, loadPlugins, loadFiles, getMention, matchFileScore, } from './mention-data.js';
 // ─── 组件: Logo Box ──────────────────────────────────────────────────────────
 const LogoBox = ({ width }) => {
     const art = brandArtLines();
@@ -24,6 +28,17 @@ const Messages = ({ msgs }) => (_jsx(Box, { flexDirection: "column", flexGrow: 1
         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;
+    const shown = items.slice(0, 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) => {
+                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 \u8FD8\u6709 ", items.length - MAX_ROWS, " \u9879..."] })), _jsx(Text, { color: "cyan", children: `╰${'─'.repeat(innerW)}╯` })] }));
+};
 const InkApp = ({ onPrompt, initialStatus, getStatusUpdate, terminalW, terminalH }) => {
     const [input, setInput] = useState('');
     const [msgs, setMsgs] = useState([]);
@@ -34,6 +49,206 @@ const InkApp = ({ onPrompt, initialStatus, getStatusUpdate, terminalW, terminalH
     // 双击 Esc 退出当前进程 (500ms 窗口内第二次按下)
     const lastEscRef = useRef(0);
     const C_WARN_ANSI = '\x1b[38;2;245;158;11m'; // #f59e0b
+    // ── @ / # 弹出窗状态 ──────────────────────────────────────────────────────
+    const mention = useMemo(() => getMention(input), [input]);
+    const mentionKey = mention ? `${mention.kind}:${mention.start}` : null;
+    const [items, setItems] = useState([]);
+    const [sel, setSel] = useState(0);
+    const [dismissed, setDismissed] = useState(null);
+    const [loadingFiles, setLoadingFiles] = useState(false);
+    // Tab 补齐弹窗 (非 @ / # 触发的普通 token 补齐): { start, items }
+    const [tabState, setTabState] = useState(null);
+    const agentCache = useRef(null);
+    const skillCache = useRef(null);
+    const pluginCache = useRef(null);
+    const fileCache = useRef(null);
+    // ── 输入历史 (↑/↓ 切换) ───────────────────────────────────────────────────
+    const historyRef = useRef([]);
+    const historyIdxRef = useRef(-1); // -1 = 正在编辑新草稿
+    const draftRef = useRef('');
+    // 加载当前 mention 的候选 (agent/command 缓存一次; file 每次打开重扫)
+    useEffect(() => {
+        if (tabState) {
+            setItems(tabState.items);
+            setSel(0);
+            return;
+        }
+        if (!mention || !mentionKey) {
+            setItems([]);
+            return;
+        }
+        if (dismissed === mentionKey) {
+            setItems([]);
+            return;
+        }
+        let cancelled = false;
+        if (mention.kind === 'agent') {
+            if (agentCache.current) {
+                setItems(agentCache.current);
+            }
+            else {
+                loadAgents()
+                    .then(list => { agentCache.current = list; if (!cancelled)
+                    setItems(list); })
+                    .catch(() => { if (!cancelled)
+                    setItems([]); });
+            }
+        }
+        else if (mention.kind === 'command') {
+            // 命令立即显示, 技能/插件异步合并
+            const base = loadCommands();
+            setItems(base);
+            const skillsP = skillCache.current
+                ? Promise.resolve(skillCache.current)
+                : loadSkills().then(s => { skillCache.current = s; return s; });
+            const pluginsP = pluginCache.current
+                ? Promise.resolve(pluginCache.current)
+                : loadPlugins().then(p => { pluginCache.current = p; return p; });
+            Promise.all([skillsP, pluginsP])
+                .then(([sk, pl]) => {
+                if (cancelled)
+                    return;
+                const merged = [...base];
+                for (const it of [...sk, ...pl]) {
+                    if (!merged.some(m => m.kind === it.kind && m.label === it.label))
+                        merged.push(it);
+                }
+                setItems(merged);
+            })
+                .catch(() => { });
+        }
+        else {
+            // file: 每次打开重扫 (cwd 可能变化)
+            setLoadingFiles(true);
+            loadFiles(mention.query)
+                .then(list => { if (!cancelled) {
+                fileCache.current = list;
+                setItems(list);
+                setLoadingFiles(false);
+            } })
+                .catch(() => { if (!cancelled) {
+                setItems([]);
+                setLoadingFiles(false);
+            } });
+        }
+        setSel(0);
+        return () => { cancelled = true; };
+    }, [mentionKey, dismissed, tabState]);
+    // 按查询过滤 + 排序
+    const filtered = useMemo(() => {
+        if (tabState)
+            return items; // Tab 补齐: 已按前缀过滤好
+        if (!mention)
+            return [];
+        const q = mention.query.toLowerCase();
+        if (!q)
+            return items;
+        if (mention.kind === 'file') {
+            return items
+                .filter(it => matchFileScore(it.label.toLowerCase(), q) >= 0)
+                .sort((a, b) => matchFileScore(a.label.toLowerCase(), q) - matchFileScore(b.label.toLowerCase(), q));
+        }
+        return items.filter(it => it.label.toLowerCase().includes(q));
+    }, [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' ? '# 文件'
+                : '/ 命令 · 技能 · 插件';
+    // 在指定 start 位置插入补齐文本 (函数式更新, 闭包安全)
+    const insertAt = useCallback((start, it) => {
+        setInput(cur => {
+            if (start > cur.length)
+                return cur;
+            let insertText;
+            if (it.kind === 'agent')
+                insertText = '@' + it.insert + ' ';
+            else if (it.kind === 'file')
+                insertText = '#' + it.insert + ' ';
+            else if (it.kind === 'skill')
+                insertText = 'use_skill ' + it.insert + ' ';
+            else
+                insertText = '/' + it.insert + ' ';
+            return cur.slice(0, start) + insertText;
+        });
+        // TextInput 内部 cursorOffset 在值被重写后不重置 (2026-08-05 实测),
+        // 插入后强制重挂载让光标回到末尾; 仅此一处重挂载, 避免输入丢失窗口
+        setTiKey(k => k + 1);
+    }, []);
+    // 接受当前选中项 → 替换 token 插入输入
+    // 函数式更新 + 从最新 state 重新推导 mention (useInput 闭包可能陈旧, 2026-08-05)
+    const acceptMention = useCallback((it) => {
+        if (tabState) {
+            insertAt(tabState.start, it);
+            setTabState(null);
+            setDismissed(null);
+            return;
+        }
+        setInput(cur => {
+            const m = getMention(cur);
+            if (!m)
+                return cur;
+            let insertText;
+            if (it.kind === 'agent')
+                insertText = '@' + it.insert + ' ';
+            else if (it.kind === 'file')
+                insertText = '#' + it.insert + ' ';
+            else if (it.kind === 'skill')
+                insertText = 'use_skill ' + it.insert + ' ';
+            else
+                insertText = '/' + it.insert + ' ';
+            return cur.slice(0, m.start) + insertText;
+        });
+        setTiKey(k => k + 1);
+        setDismissed(null);
+    }, [tabState, insertAt]);
+    // Tab 命令补齐: 无触发符的普通 token 也补 (命令/技能/插件/智能体/文件)
+    const doTabCompletion = useCallback(() => {
+        const m = input.match(/(^|\s)([^\s]*)$/);
+        if (!m)
+            return;
+        const [, pre, token] = m;
+        const start = (m.index || 0) + pre.length;
+        const q = token.toLowerCase();
+        const items = [];
+        const add = (list) => {
+            for (const it of list) {
+                if (items.some(x => x.kind === it.kind && x.label === it.label))
+                    continue;
+                if (it.label.toLowerCase().startsWith(q))
+                    items.push(it);
+            }
+        };
+        if (q) {
+            add(loadCommands());
+            if (skillCache.current)
+                add(skillCache.current);
+            if (pluginCache.current)
+                add(pluginCache.current);
+            if (agentCache.current)
+                add(agentCache.current);
+            if (fileCache.current)
+                add(fileCache.current);
+        }
+        else {
+            // 空 token: 命令 + 技能 + 插件
+            add(loadCommands());
+            if (skillCache.current)
+                add(skillCache.current);
+            if (pluginCache.current)
+                add(pluginCache.current);
+        }
+        if (items.length === 1) {
+            insertAt(start, items[0]);
+            setTabState(null);
+        }
+        else if (items.length > 1) {
+            setTabState({ start, items });
+            setSel(0);
+        }
+    }, [input, insertAt]);
+    const [tiKey, setTiKey] = useState(0);
     // 全局: 思考动画控制
     useEffect(() => {
         globalThis.__inkSetThinking = (v) => setThinking(v);
@@ -53,6 +268,14 @@ const InkApp = ({ onPrompt, initialStatus, getStatusUpdate, terminalW, terminalH
         const trimmed = value.trim();
         if (!trimmed)
             return;
+        // 入历史 (去重最近一条, 上限 100)
+        const hist = historyRef.current;
+        if (hist[hist.length - 1] !== trimmed)
+            hist.push(trimmed);
+        if (hist.length > 100)
+            hist.shift();
+        historyIdxRef.current = -1;
+        draftRef.current = '';
         setInput('');
         // 用户消息由 processInput 统一通过 appendLine(renderUserMessage) 显示
         onPrompt(trimmed);
@@ -69,6 +292,97 @@ const InkApp = ({ onPrompt, initialStatus, getStatusUpdate, terminalW, terminalH
             requestExit();
             return;
         }
+        // ── 弹出窗打开: 全键接管 (TextInput focus=false 不处理) ──
+        if (popupOpen) {
+            if (key.upArrow) {
+                setSel(s => Math.max(0, s - 1));
+                return;
+            }
+            if (key.downArrow) {
+                setSel(s => Math.min(filtered.length - 1, s + 1));
+                return;
+            }
+            if ((key.tab || key.return) && filtered.length > 0) {
+                const it = filtered[safeSel];
+                if (it)
+                    acceptMention(it);
+                return;
+            }
+            if (key.escape) {
+                if (tabState)
+                    setTabState(null);
+                else
+                    setDismissed(mentionKey);
+                return;
+            }
+            if (key.backspace || key.delete) {
+                setInput(cur => cur.slice(0, -1));
+                return;
+            }
+            // 粘贴/连发 chunk: Ink 把一次 stdin read 当单个 keypress (2026-08-05 实测)
+            //   ① 连续退格 (\x7f×N) → 删 N 个字符
+            //   ② 混合 chunk (退格+控制符, 含 ESC 序列) → 退格部分生效, ESC 序列忽略
+            //   ③ 可打印 chunk (CJK/粘贴) → 整串追加
+            // 全部用函数式更新 — useInput 闭包可能陈旧 (实测), 函数式取最新 state
+            if (/^\x7f+$/.test(_input)) {
+                setInput(cur => cur.slice(0, Math.max(0, cur.length - _input.length)));
+                return;
+            }
+            if (/[\x00-\x1f\x7f]/.test(_input)) {
+                // 混合 chunk (退格+可打印): 逐字符处理; 含 ESC 序列 → 忽略整块 (箭头等由 TextInput 处理)
+                if (_input.includes('\u001b'))
+                    return;
+                setInput(cur => {
+                    let out = cur;
+                    for (const ch of _input) {
+                        if (ch === '\x7f')
+                            out = out.slice(0, -1);
+                        else if (/[\x00-\x1f]/.test(ch))
+                            continue;
+                        else
+                            out += ch;
+                    }
+                    return out;
+                });
+                return;
+            }
+            if (_input && !key.ctrl && !key.meta) {
+                setInput(cur => cur + _input);
+                return;
+            }
+            return; // 其余键忽略
+        }
+        // ── 正常模式 ──
+        // Tab 命令补齐 (无触发符的普通 token 也补)
+        if (key.tab) {
+            doTabCompletion();
+            return;
+        }
+        // ↑/↓ 切换输入历史 (TextInput 本身忽略 up/down, 无冲突)
+        if (key.upArrow) {
+            const hist = historyRef.current;
+            if (hist.length === 0)
+                return;
+            if (historyIdxRef.current === -1)
+                draftRef.current = input;
+            if (historyIdxRef.current < hist.length - 1) {
+                historyIdxRef.current += 1;
+                setInput(hist[hist.length - 1 - historyIdxRef.current]);
+                setTiKey(k => k + 1);
+            }
+            return;
+        }
+        if (key.downArrow) {
+            if (historyIdxRef.current === -1)
+                return;
+            historyIdxRef.current -= 1;
+            if (historyIdxRef.current === -1)
+                setInput(draftRef.current);
+            else
+                setInput(historyRef.current[historyRef.current.length - 1 - historyIdxRef.current]);
+            setTiKey(k => k + 1);
+            return;
+        }
         // 双击 Esc 退出当前进程: 第一击提示, 500ms 内第二击退出
         if (key.escape) {
             const now = Date.now();
@@ -80,6 +394,21 @@ const InkApp = ({ onPrompt, initialStatus, getStatusUpdate, terminalW, terminalH
                 inkAppendLine(`${C_WARN_ANSI}⚠ 再按一次 Esc 退出当前进程\x1b[0m`);
             }
         }
+        // 防御: 控制字符 chunk (TextInput 会把整 chunk 当字符追加, 2026-08-05 实测)
+        //   setTimeout(0) 保证我们的纠正落在 TextInput 的 onChange 之后 (无论监听器顺序)
+        //   \x7f×N → 先剥掉 TextInput 追加的垃圾, 再删 N 个真实字符
+        if (/^\x7f+$/.test(_input)) {
+            const n = _input.length;
+            setTimeout(() => setInput(cur => {
+                const cleaned = cur.replace(/[\x00-\x1f\x7f]+$/, '');
+                return cleaned.slice(0, Math.max(0, cleaned.length - n));
+            }), 0);
+            return;
+        }
+        if (/[\x00-\x1f\x7f]/.test(_input)) {
+            setTimeout(() => setInput(cur => cur.replace(/[\x00-\x1f\x7f]+$/, '')), 0);
+            return;
+        }
         // TextInput handles actual input; useInput only for Ctrl+C / Esc
     });
     // 自动更新状态栏 (每秒)
@@ -91,6 +420,19 @@ const InkApp = ({ onPrompt, initialStatus, getStatusUpdate, terminalW, terminalH
         }, 1000);
         return () => clearInterval(timer);
     }, [getStatusUpdate]);
+    // 调试/测试钩子: 输入变化时通知外部 (pty 测试用)
+    useEffect(() => {
+        globalThis.__inkOnInput?.(input);
+    }, [input]);
+    // 调试/测试钩子: 弹出窗状态 (pty 测试用)
+    useEffect(() => {
+        globalThis.__inkOnPopup?.({
+            open: popupOpen,
+            key: mentionKey,
+            count: filtered.length,
+            items: filtered.slice(0, 5).map(i => i.kind + ':' + i.label),
+        });
+    }, [popupOpen, mentionKey, filtered]);
     // 思考动画 — kaomoji 旋转
     const KAOMOJI = ['(｀・ω・´)', '(´･_･`)', '(｡•́︿•̀｡)', 'ᕙ(▀̿̿Ĺ̯̿̿▀̿ ̿)ᕗ', '(◕‿◕)'];
     useEffect(() => {
@@ -101,8 +443,9 @@ const InkApp = ({ onPrompt, initialStatus, getStatusUpdate, terminalW, terminalH
         }, 600);
         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..."] }) }))] }), _jsx(Box, { children: _jsx(Text, { bold: true, color: "white", children: '─'.repeat(terminalW) }) }), _jsx(Box, { children: _jsx(Text, { children: status }) }), _jsx(Box, { children: _jsx(Text, { bold: true, color: "white", children: '─'.repeat(terminalW) }) }), _jsxs(Box, { children: [_jsx(Text, { bold: true, color: "green", children: "\u276F " }), _jsx(TextInput, { value: input, onChange: setInput, onSubmit: onSubmit, placeholder: "\u8F93\u5165\u6D88\u606F...  Esc \u53CC\u51FB\u9000\u51FA \u00B7 /queue \u6392\u961F \u00B7 !\u7EC8\u7AEF\u547D\u4EE4" })] }), _jsx(Box, { children: _jsx(Text, { bold: true, color: "white", children: '─'.repeat(terminalW) }) })] }));
+    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..."] }) }))] }), _jsx(Box, { children: _jsx(Text, { bold: true, color: "white", children: '─'.repeat(terminalW) }) }), _jsx(Box, { children: _jsx(Text, { children: status }) }), _jsx(Box, { children: _jsx(Text, { bold: true, color: "white", children: '─'.repeat(terminalW) }) }), popupOpen && (tabState || mention) && (_jsx(MentionPopup, { title: popupTitle, items: filtered, sel: safeSel, width: terminalW, loading: loadingFiles })), _jsxs(Box, { children: [_jsx(Text, { bold: true, color: "green", children: "\u276F " }), _jsx(TextInput, { value: input, onChange: setInput, onSubmit: onSubmit, focus: !popupOpen, 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: "white", children: '─'.repeat(terminalW) }) })] }));
 };
+export { InkApp };
 // ─── 启动 ────────────────────────────────────────────────────────────────────
 let _inkInstance = null;
 export function startInk(onPrompt, initialStatus, getStatusUpdate) {