minimal-agent 0.2.0 → 0.3.0

package/src/tools/websearch/websearch.js

@@ -0,0 +1,161 @@
+/**
+ * ============================================================
+ *  src/tools/websearch.ts —— WebSearch 工具（联网搜索）
+ * ------------------------------------------------------------
+ *  底层调用 Tavily Search API（https://tavily.com/）。
+ *
+ *  为什么选 Tavily：
+ *    - LLM 友好：返回结构化 JSON，自带 content 摘要；不用我们再去抓 HTML
+ *    - 接口简单：一个 POST + JSON body 搞定，不用 OAuth / 翻墙
+ *    - 免费额度：每月 1000 次足够学习用
+ *
+ *  Key 配置：
+ *    在项目根 .env 里加：
+ *      TAVILY_API_KEY=tvly-xxxxxxxxxxxxxxxx
+ *    没设的话，工具会返回友好错误（不影响 agent 启动）。
+ *
+ *  输入：
+ *    query         必填，搜索关键词
+ *    max_results   可选，默认 5（Tavily 上限 20）
+ *    search_depth  可选 'basic' | 'advanced'，默认 basic
+ *    topic         可选 'general' | 'news'，默认 general
+ *
+ *  输出：
+ *    每条结果一段：
+ *      [1] 标题
+ *      URL: https://...
+ *      内容摘要（content）
+ *    如有 answer 字段（advanced 才返回），先列在最上面。
+ * ============================================================
+ */
+import { z } from 'zod';
+import { DEFAULT_MAX_RESULT_SIZE_CHARS } from '../types.js';
+import { toToolParameters } from '../../utils/zodToJson.js';
+// ---------------- 1. Zod 输入 schema ----------------
+const inputSchema = z.object({
+    query: z
+        .string()
+        .min(1, '必须提供搜索关键词')
+        .max(400, '搜索关键词太长（>400 字）')
+        .describe('搜索关键词，建议自然语言描述需要查的信息'),
+    max_results: z
+        .number()
+        .int()
+        .min(1)
+        .max(20)
+        .optional()
+        .describe('返回结果数量，1-20，默认 5'),
+    search_depth: z
+        .enum(['basic', 'advanced'])
+        .optional()
+        .describe('basic 快但浅；advanced 慢但深（含 answer 摘要），默认 basic'),
+    topic: z
+        .enum(['general', 'news'])
+        .optional()
+        .describe('general=通用网页；news=偏新闻源；默认 general'),
+});
+// ---------------- 2. JSON Schema（由 Zod 自动派生） ----------------
+const parameters = toToolParameters(inputSchema);
+// ---------------- 3. Description（给 LLM 看的工具说明） ----------------
+const description = `- Searches the public web via the Tavily Search API and returns structured results.
+- Use this when you need up-to-date information that is not in your training data, or when the user asks for recent news / docs / API references.
+- Returns the top N results, each with a title, URL, and content snippet. With \`search_depth: "advanced"\` Tavily also returns a synthesized answer at the top.
+- Prefer specific natural-language queries over keyword soup (e.g. "how does Bun handle .env files in version 1.1").
+- Requires the TAVILY_API_KEY environment variable to be set; if missing the tool returns a friendly error.`;
+// ---------------- 5. call() ----------------
+async function call(input, signal) {
+    // 5a. 取 key
+    const apiKey = process.env.TAVILY_API_KEY;
+    if (!apiKey) {
+        return {
+            ok: false,
+            error: 'WebSearch 不可用：环境变量 TAVILY_API_KEY 未设置。\n' +
+                '请在项目根 .env 里加：\n' +
+                '  TAVILY_API_KEY=tvly-你的key\n' +
+                '免费 key 申请：https://tavily.com/',
+        };
+    }
+    // 5b. 自动追加当前日期到 query（强制时间限制，防止搜索到过时信息）
+    const today = new Date().toISOString().slice(0, 10);
+    const queryWithDate = input.query.includes(today)
+        ? input.query
+        : `${input.query} (as of ${today})`;
+    const body = {
+        api_key: apiKey,
+        query: queryWithDate,
+        max_results: input.max_results ?? 5,
+        search_depth: input.search_depth ?? 'basic',
+        topic: input.topic ?? 'general',
+        // 让 advanced 模式自动给 answer；basic 不会有
+        include_answer: input.search_depth === 'advanced',
+    };
+    // 5c. 发请求
+    let res;
+    try {
+        res = await fetch('https://api.tavily.com/search', {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify(body),
+            signal,
+        });
+    }
+    catch (e) {
+        return {
+            ok: false,
+            error: `调用 Tavily 失败（网络）：${e.message}`,
+        };
+    }
+    if (!res.ok) {
+        const text = await res.text().catch(() => '');
+        return {
+            ok: false,
+            error: `Tavily HTTP ${res.status}：${text.slice(0, 500)}`,
+        };
+    }
+    // 5d. 解析
+    let data;
+    try {
+        data = (await res.json());
+    }
+    catch (e) {
+        return {
+            ok: false,
+            error: `Tavily 响应不是合法 JSON：${e.message}`,
+        };
+    }
+    const results = data.results ?? [];
+    if (results.length === 0) {
+        return {
+            ok: true,
+            content: `(no results for "${input.query}")`,
+        };
+    }
+    // 5e. 拼输出
+    const parts = [];
+    if (data.answer) {
+        parts.push(`【综合回答】\n${data.answer}\n`);
+    }
+    parts.push(`【共 ${results.length} 条结果】`);
+    results.forEach((r, i) => {
+        const date = r.published_date ? `（${r.published_date}）` : '';
+        parts.push(`\n[${i + 1}] ${r.title}${date}\nURL: ${r.url}\n${(r.content ?? '').trim()}`);
+    });
+    let content = parts.join('\n');
+    if (content.length > DEFAULT_MAX_RESULT_SIZE_CHARS) {
+        content =
+            content.slice(0, DEFAULT_MAX_RESULT_SIZE_CHARS) +
+                `\n\n... (输出超过 ${DEFAULT_MAX_RESULT_SIZE_CHARS} 字符，已截断)`;
+    }
+    return { ok: true, content };
+}
+// ---------------- 6. 导出 ----------------
+export const webSearchTool = {
+    name: 'WebSearch',
+    description,
+    inputSchema,
+    parameters,
+    isReadOnly: true,
+    isConcurrencySafe: true,
+    maxResultSizeChars: DEFAULT_MAX_RESULT_SIZE_CHARS,
+    call,
+};

package/src/tools/write/write.js

@@ -0,0 +1,125 @@
+/**
+ * ============================================================
+ *  src/tools/write.ts —— Write 工具（整文件写入）
+ * ------------------------------------------------------------
+ *  对应 kakadeai 主仓库的 FileWriteTool。
+ *  把 content 整段写到 file_path（覆盖既有内容）。
+ *  目录不存在时自动创建（递归）。
+ *
+ *  v0.2 增强：
+ *    - 路径安全校验（null byte / UNC 路径）
+ *    - 内容大小上限（1GB）
+ *    - 覆盖已有文件时在返回值中明确提示
+ * ============================================================
+ */
+import { existsSync } from 'node:fs';
+import { mkdir, stat, writeFile } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { z } from 'zod';
+import { DEFAULT_MAX_RESULT_SIZE_CHARS } from '../types.js';
+import { toToolParameters } from '../../utils/zodToJson.js';
+import { applyLineEnding, detectFileBomEncoding, detectFileLineEndings, resolveToolPath, } from '../shared/fileUtils.js';
+import { filePathField } from '../shared/schemas.js';
+import { assertFresh, recordRead } from '../shared/fileState.js';
+/** 写入内容上限：1GB。防止模型试图写入超大内容撑爆内存/磁盘。 */
+const MAX_WRITE_SIZE_BYTES = 1024 * 1024 * 1024;
+// ---------------- 1. Zod 输入 schema ----------------
+const inputSchema = z.object({
+    file_path: filePathField('写入'),
+    content: z.string().describe('文件完整内容（会覆盖既有内容）'),
+});
+// ---------------- 2. JSON Schema（由 Zod 自动派生） ----------------
+const parameters = toToolParameters(inputSchema);
+// ---------------- 3. Description ----------------
+const description = `Writes a file to the local filesystem.
+
+Usage:
+- This tool will overwrite the existing file if there is one at the provided path.
+- If you intend to overwrite an existing file, you MUST use your \`Read\` tool to read its current content at least once in the current session BEFORE calling Write. This tool will error with a "请先 Read" message if you attempt to overwrite a file that has not been read. To create a new file (path does not yet exist), you can call Write directly without a prior Read.
+- If the parent directory does not exist, it will be created recursively.
+- ALWAYS prefer editing existing files in the codebase via the Edit tool. NEVER write new files unless explicitly required.
+- NEVER create documentation files (*.md) or README files unless explicitly requested by the User.`;
+// ---------------- 5. call() ----------------
+async function call(input) {
+    const pathResult = resolveToolPath(input.file_path);
+    if (!pathResult.ok)
+        return pathResult;
+    const filePath = pathResult.resolvedPath;
+    // Pre-read guard：覆盖已存在文件前必须先 Read 过；防止盲写覆盖外部修改。
+    const freshness = assertFresh(filePath);
+    if (!freshness.ok) {
+        return { ok: false, error: freshness.error };
+    }
+    const contentSize = Buffer.byteLength(input.content, 'utf8');
+    if (contentSize > MAX_WRITE_SIZE_BYTES) {
+        return {
+            ok: false,
+            error: `写入内容过大（${contentSize} 字节 > ${MAX_WRITE_SIZE_BYTES} 字节 ≈ 1GB）。请拆分内容或使用 Edit 工具分块修改。`,
+        };
+    }
+    try {
+        await mkdir(dirname(filePath), { recursive: true });
+        let originalSize = 0;
+        const fileExisted = existsSync(filePath);
+        if (fileExisted) {
+            try {
+                const st = await stat(filePath);
+                originalSize = st.size;
+            }
+            catch { }
+        }
+        let contentToWrite = input.content;
+        // bomEncoding 仅在覆盖既有文件时有意义；新建文件统一按 utf8 无 BOM 处理。
+        let bomEncoding = 'utf8';
+        if (fileExisted) {
+            const detected = await detectFileBomEncoding(filePath);
+            if (detected === 'utf16le') {
+                return {
+                    ok: false,
+                    error: '暂不支持改写 UTF-16 LE 文件（BOM=FF FE）。请改用 UTF-8 编码。',
+                };
+            }
+            bomEncoding = detected;
+            const lineEnding = await detectFileLineEndings(filePath);
+            contentToWrite = applyLineEnding(input.content, lineEnding);
+        }
+        if (bomEncoding === 'utf8-bom') {
+            // 关键：BOM 必须走 Buffer 路径手动拼接 EF BB BF。
+            // 不能直接 '\uFEFF' + content 再让 writeFile 以 utf8 编码 ——
+            // 那样 utf8 编码器虽然也会输出 EF BB BF，但等价于"二次编码"，且无法保证
+            // 与原文件字节级一致；显式 Buffer.concat 才能保证落盘字节稳定。
+            const bomBytes = Buffer.from([0xef, 0xbb, 0xbf]);
+            const bodyBytes = Buffer.from(contentToWrite, 'utf8');
+            // 传 Buffer 时不要再传 encoding 参数。
+            await writeFile(filePath, Buffer.concat([bomBytes, bodyBytes]));
+        }
+        else {
+            await writeFile(filePath, contentToWrite, 'utf8');
+        }
+        recordRead(filePath);
+        const action = fileExisted ? '已覆盖' : '已创建新文件';
+        const newSize = Buffer.byteLength(contentToWrite, 'utf8');
+        const sizeInfo = fileExisted
+            ? `（原文件 ${originalSize} 字节 → 新内容 ${newSize} 字节）`
+            : `（${newSize} 字节）`;
+        const bomInfo = bomEncoding === 'utf8-bom' ? '，已保留 UTF-8 BOM' : '';
+        return {
+            ok: true,
+            content: `${action} ${filePath}${sizeInfo}${bomInfo}`,
+        };
+    }
+    catch (e) {
+        return { ok: false, error: `写入失败：${e.message}` };
+    }
+}
+// ---------------- 6. 导出 ----------------
+export const writeTool = {
+    name: 'Write',
+    description,
+    inputSchema,
+    parameters,
+    isReadOnly: false,
+    isConcurrencySafe: false,
+    maxResultSizeChars: DEFAULT_MAX_RESULT_SIZE_CHARS,
+    call,
+};

package/src/types/turndown.d.ts

@@ -0,0 +1,23 @@
+// 项目内补的最小 turndown 类型声明（社区 @types/turndown 不维护）。
+// 只覆盖 webfetch.ts 用到的两个 API：constructor + turndown(html)。
+declare module 'turndown' {
+  export interface TurndownOptions {
+    headingStyle?: 'setext' | 'atx';
+    hr?: string;
+    bulletListMarker?: '-' | '+' | '*';
+    codeBlockStyle?: 'indented' | 'fenced';
+    emDelimiter?: '_' | '*';
+    strongDelimiter?: '__' | '**';
+    linkStyle?: 'inlined' | 'referenced';
+    linkReferenceStyle?: 'full' | 'collapsed' | 'shortcut';
+  }
+
+  export default class TurndownService {
+    constructor(options?: TurndownOptions);
+    turndown(html: string): string;
+    use(plugin: unknown): this;
+    addRule(name: string, rule: unknown): this;
+    keep(filter: unknown): this;
+    remove(filter: unknown): this;
+  }
+}

package/src/types.js

@@ -0,0 +1,16 @@
+/**
+ * ============================================================
+ *  src/types.ts —— 全局核心类型定义
+ * ------------------------------------------------------------
+ *  这个文件是项目的"类型字典"，所有模块都从这里 import 类型。
+ *  新手阅读建议：从上往下，每个类型上方有"何时用 / 为何这么设计"的注释。
+ *
+ *  设计原则：
+ *  - 形状跟 OpenAI Chat Completions API 对齐（多 provider 兼容性最好）
+ *  - 不用 class，全用 interface / type alias（更轻、更易读）
+ *  - 一切尽量简单：能用基本类型就不引第三方
+ * ============================================================
+ */
+export {};
+// 注：插件私有事件（如 workflow-runner 的 workflow_*）不再写在这里。
+// 插件通过 PluginEvent 开放契约 yield 任意 type 字符串的事件，UI 静默忽略未识别项。

package/src/ui/App.js

@@ -0,0 +1,37 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * ============================================================
+ *  src/ui/App.tsx —— TUI 顶层组件
+ * ------------------------------------------------------------
+ *  组合所有 UI 子组件，把 useChat 暴露的状态映射到各组件 props。
+ *  不直接处理键盘输入，那是 InputBox 的事。
+ * ============================================================
+ */
+import React from 'react';
+import { Box, Text } from 'ink';
+import { saveContext } from '../context/persistContext.js';
+import { InputBox } from './InputBox.js';
+import { MessageList } from './MessageList.js';
+import { StatusLine } from './StatusLine.js';
+import { ToolStatus } from './ToolStatus.js';
+import { useChat } from './hooks/useChat.js';
+/** ANSI escape: 清屏 + 光标归位 */
+const CLEAR_SCREEN = '\x1b[2J\x1b[H';
+export function App({ provider, initialHistory }) {
+    // 持久化挂钩：每次轮次结束 / 清空 / 压缩后由 useChat 触发；fire-and-forget。
+    const onPersist = React.useCallback((messages) => {
+        void saveContext(messages);
+    }, []);
+    const chat = useChat({
+        provider,
+        initialHistory,
+        onPersist,
+        onCompactDone: () => process.stdout.write(CLEAR_SCREEN),
+    });
+    // /new：内存 reset + 磁盘 clearContext 全部由 chat.clearHistory() 内部完成，await 之后再清屏。
+    const handleClear = React.useCallback(async () => {
+        await chat.clearHistory();
+        process.stdout.write(CLEAR_SCREEN);
+    }, [chat]);
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { marginBottom: 1, children: [_jsx(Text, { color: "cyan", bold: true, children: "minimal-agent" }), _jsx(Text, { color: "gray", children: `  · ${provider.name}/${provider.model} · /new 清空 · /compact 压缩 · /exit 退出 · Ctrl+C 中断` })] }), _jsx(MessageList, { history: chat.history, streamingText: chat.streamingText }), _jsx(ToolStatus, { status: chat.toolStatus, compacting: chat.compacting }), chat.error && (_jsx(Box, { marginBottom: 1, children: _jsxs(Text, { color: "red", children: ["\u26A0 ", chat.error] }) })), chat.interrupted && (_jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: "yellow", children: "\u26A1 \u64CD\u4F5C\u88AB\u7528\u6237\u4E2D\u65AD\uFF0C\u7B49\u5F85\u65B0\u7684\u4EFB\u52A1\u8F93\u5165..." }) })), _jsx(InputBox, { onSubmit: chat.submit, disabled: chat.isLoading, onAbort: chat.abort, onClear: handleClear, onCompact: chat.compactNow }), _jsx(StatusLine, { provider: provider, history: chat.history, pluginProgress: chat.pluginProgress })] }));
+}

package/src/ui/InputBox.js

@@ -0,0 +1,240 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * ============================================================
+ *  src/ui/InputBox.tsx —— 用户输入框（v0.4 多行粘贴支持版）
+ * ------------------------------------------------------------
+ *  v0.4 新增功能：
+ *    - 多行粘贴支持：粘贴多行代码时完整保留所有行
+ *    - 多行编辑模式：Enter 提交，Alt+Enter（Mac: Option+Enter）插入换行
+ *    - 粘贴检测：自动识别长输入为粘贴操作
+ *    - 跨平台兼容：Win / Mac / Linux
+ *
+ *  v0.3 修复内容：
+ *    - 移除过激进的全局防抖机制（导致 Backspace 完全失效）
+ *    - 改为仅对 Delete 键做去重（解决 Windows 双事件问题）
+ *    - 修复 BufferView 组件重建导致的不可见问题
+ *    - 保留强制刷新但精准控制时机
+ * ============================================================
+ */
+import { useRef, useState, useCallback } from 'react';
+import { Box, Text, useApp, useInput } from 'ink';
+import { useTextBuffer } from './hooks/useTextBuffer.js';
+import { usePasteHandler } from './hooks/usePasteHandler.js';
+export function InputBox({ onSubmit, disabled, onAbort, onClear, onCompact }) {
+    const buf = useTextBuffer();
+    const ctrlCCountRef = useRef(0);
+    const ctrlCTimerRef = useRef(null);
+    const { exit } = useApp();
+    // ✅ 精准刷新计数器：只在必要时触发重渲染
+    const [refreshCounter, setRefreshCounter] = useState(0);
+    // ✅ Delete 专用去重：只防止 Windows 双事件，不影响其他键
+    const lastDeleteTime = useRef(0);
+    const DELETE_DEBOUNCE_MS = 20; // 仅 Delete 键用极短防抖
+    const forceRefresh = useCallback(() => {
+        setRefreshCounter((c) => c + 1);
+    }, []);
+    // ✅ 粘贴处理 Hook：支持多行粘贴
+    // v0.3 设计：Enter 始终发送, Alt+Enter（Mac: Option+Enter）换行, 粘贴期间拦截 Enter
+    const { handleInput: handlePasteInput } = usePasteHandler({
+        onPasteComplete: (text) => {
+            buf.insert(text);
+            forceRefresh();
+        },
+        multiline: true,
+    });
+    useInput((input, key) => {
+        // ---- ✅ 粘贴检测（必须优先处理）----
+        // 这会在粘贴期间忽略 Enter 键，防止多行内容被截断
+        const pasteResult = handlePasteInput(input, key);
+        if (pasteResult === 'paste') {
+            // 粘贴内容已由 usePasteHandler 处理并插入
+            return;
+        }
+        if (pasteResult === 'enter-in-paste') {
+            // 粘贴期间的 Enter 键被忽略（不插入换行，不提交）
+            return;
+        }
+        if (pasteResult === 'enter-newline') {
+            // Alt+Enter：插入换行符（多行编辑用）
+            buf.insert('\n');
+            forceRefresh();
+            return;
+        }
+        // pasteResult === 'continue'，继续普通处理
+        // ---- ESC ----
+        if (key.escape) {
+            if (disabled)
+                onAbort();
+            return;
+        }
+        // ---- Ctrl+C ----
+        if (key.ctrl && input === 'c') {
+            if (buf.state.text.length > 0) {
+                buf.clear();
+                forceRefresh();
+                return;
+            }
+            if (disabled) {
+                onAbort();
+                return;
+            }
+            ctrlCCountRef.current++;
+            if (ctrlCCountRef.current >= 2)
+                exit();
+            if (ctrlCTimerRef.current)
+                clearTimeout(ctrlCTimerRef.current);
+            ctrlCTimerRef.current = setTimeout(() => { ctrlCCountRef.current = 0; }, 1000);
+            return;
+        }
+        // ---- ✅ Enter 提交（始终发送）----
+        // usePasteHandler v0.3 逻辑：
+        //   - Enter（单独按）：返回 'continue' → 这里执行**发送**
+        //   - Alt+Enter（Mac: Option+Enter）：返回 'enter-newline' → 上面已处理为**插入换行**
+        //   - Ctrl+Enter：返回 'continue' → 这里也执行**强制发送**
+        //   - 粘贴期间 + Enter：返回 'enter-in-paste' → **忽略**（防误发）
+        if (key.return) {
+            const text = buf.state.text.trim();
+            if (text.length === 0)
+                return;
+            if (text === '/exit' || text === '/quit')
+                exit();
+            else if (text === '/new' || text === '/clear') {
+                buf.clear();
+                forceRefresh();
+                onClear();
+            }
+            else if (text === '/compact') {
+                buf.clear();
+                forceRefresh();
+                onCompact();
+            }
+            else {
+                buf.clear();
+                forceRefresh();
+                onSubmit(text);
+            }
+            return;
+        }
+        // ---- 移动光标（无防抖，响应优先）----
+        if (key.leftArrow) {
+            if (key.ctrl || key.meta)
+                buf.moveWordLeft();
+            else
+                buf.moveLeft();
+            forceRefresh();
+            return;
+        }
+        if (key.rightArrow) {
+            if (key.ctrl || key.meta)
+                buf.moveWordRight();
+            else
+                buf.moveRight();
+            forceRefresh();
+            return;
+        }
+        if (key.upArrow) {
+            buf.moveUp();
+            forceRefresh();
+            return;
+        }
+        if (key.downArrow) {
+            buf.moveDown();
+            forceRefresh();
+            return;
+        }
+        // ---- ✅ Backspace（无防抖，保证每次按键都生效）----
+        if (key.backspace) {
+            buf.deleteBefore();
+            forceRefresh();
+            return;
+        }
+        // ---- ✅ Delete（仅此键有防抖，解决 Windows 双事件）----
+        if (key.delete) {
+            const now = Date.now();
+            if (now - lastDeleteTime.current < DELETE_DEBOUNCE_MS) {
+                return; // 忽略过快的重复 Delete（Windows 特有问题）
+            }
+            lastDeleteTime.current = now;
+            // Windows 下 key.delete 通常对应 Backspace，保持与原始行为一致
+            buf.deleteBefore();
+            forceRefresh();
+            return;
+        }
+        // ---- Emacs 控制键（无防抖）----
+        if (key.ctrl && !key.meta) {
+            switch (input) {
+                case 'a':
+                    buf.moveLineStart();
+                    break;
+                case 'e':
+                    buf.moveLineEnd();
+                    break;
+                case 'b':
+                    buf.moveLeft();
+                    break;
+                case 'f':
+                    buf.moveRight();
+                    break;
+                case 'u':
+                    buf.killToLineStart();
+                    break;
+                case 'k':
+                    buf.killToLineEnd();
+                    break;
+                case 'w':
+                    buf.deleteWordBefore();
+                    break;
+                case 'h':
+                    buf.deleteBefore();
+                    break; // Ctrl+H = Backspace
+                default: return; // 忽略其他控制键
+            }
+            forceRefresh();
+            return;
+        }
+        // ---- Alt 快捷键 ----
+        if (key.meta && input === '<') {
+            buf.moveBufferStart();
+            forceRefresh();
+            return;
+        }
+        if (key.meta && input === '>') {
+            buf.moveBufferEnd();
+            forceRefresh();
+            return;
+        }
+        // ---- ✅ 字符输入（已排除粘贴，已排除裸 Enter）----
+        // Alt+Enter 在多数终端发 \x1b\r：Ink 把 \x1b 剥掉后 input='\r'、key.return=false、
+        // key.meta=false，从这里落地。把 \r/\r\n 统一成 \n，textBuffer 才能真切分逻辑行
+        // （否则 layout 永远 1 行 → ↑/↓ 失效、输入框不长高，光标只能左右）。
+        if (input && !key.meta) {
+            const normalized = input.replace(/\r\n?/g, '\n');
+            buf.insert(normalized);
+            forceRefresh();
+        }
+    });
+    // ✅ 传递 refreshCounter 作为 prop（不放入 key）
+    return (_jsx(BufferView, { buf: buf, disabled: disabled, refreshCounter: refreshCounter }));
+}
+function BufferView({ buf, disabled, refreshCounter }) {
+    // ✅ 关键：用 useMemo 依赖 refreshCounter，而非改变 key
+    // 这样不会重建组件，只是强制重新计算 layout
+    const { lines, cursorRow, cursorCol } = buf.layout;
+    const promptColor = disabled ? 'gray' : 'cyan';
+    const prompt = disabled ? '⏳ ' : '> ';
+    return (_jsx(Box, { borderStyle: "round", borderColor: promptColor, paddingX: 1, flexDirection: "column", children: lines.map((line, row) => {
+            const isFirst = row === 0;
+            const isCursorRow = row === cursorRow && !disabled;
+            // ✅ key 保持稳定（只用 row），避免组件重建
+            // refreshCounter 通过 useMemo 依赖间接触发更新
+            return (_jsxs(Box, { children: [_jsx(Text, { color: promptColor, bold: true, children: isFirst ? prompt : '  ' }), isCursorRow ? _jsx(CursorLine, { line: line, col: cursorCol }) : _jsx(Text, { children: line || ' ' })] }, row));
+        }) }));
+}
+/** 光标行渲染（稳定，不会被重建） */
+function CursorLine({ line, col }) {
+    const cps = Array.from(line);
+    const before = cps.slice(0, col).join('');
+    const cursorChar = cps[col] ?? ' ';
+    const after = cps.slice(col + 1).join('');
+    return (_jsxs(Text, { children: [before, _jsx(Text, { inverse: true, children: cursorChar }), after] }));
+}

package/src/ui/MessageList.js

@@ -0,0 +1,28 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from 'ink';
+const MAX_TOOL_PREVIEW_LINES = 3;
+export function MessageList({ history, streamingText }) {
+    return (_jsxs(Box, { flexDirection: "column", children: [history.map((m, i) => (_jsx(MessageRow, { message: m }, i))), streamingText.length > 0 && (_jsxs(Box, { marginBottom: 1, children: [_jsx(Text, { children: streamingText }), _jsx(Text, { color: "gray", children: " \u258D" })] }))] }));
+}
+function MessageRow({ message }) {
+    switch (message.role) {
+        case 'system':
+            return null; // 不展示系统提示词
+        case 'user':
+            return (_jsxs(Box, { marginBottom: 1, children: [_jsx(Text, { color: "cyan", bold: true, children: '> ' }), _jsx(Text, { children: message.content })] }));
+        case 'assistant': {
+            // assistant 可能只有 tool_calls 没有 content（content 为 null）
+            const text = message.content ?? '';
+            const tcCount = message.tool_calls?.length ?? 0;
+            return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [text.length > 0 && _jsx(Text, { children: text }), tcCount > 0 && (_jsx(Text, { color: "yellow", dimColor: true, children: `  └─ 调用了 ${tcCount} 个工具：${(message.tool_calls ?? [])
+                            .map((tc) => tc.function.name)
+                            .join(', ')}` }))] }));
+        }
+        case 'tool': {
+            const lines = message.content.split('\n');
+            const preview = lines.slice(0, MAX_TOOL_PREVIEW_LINES).join('\n');
+            const hidden = Math.max(0, lines.length - MAX_TOOL_PREVIEW_LINES);
+            return (_jsx(Box, { marginBottom: 1, paddingLeft: 2, children: _jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: "gray", dimColor: true, children: "[tool result]" }), _jsx(Text, { color: "gray", children: preview }), hidden > 0 && (_jsx(Text, { color: "gray", dimColor: true, children: `... (省略 ${hidden} 行)` }))] }) }));
+        }
+    }
+}