minimal-agent 0.5.2 → 0.5.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minimal-agent",
-  "version": "0.5.2",
+  "version": "0.5.4",
   "description": "最小化 Agent 系统 —— 10 工具 + 插件系统 + workflow DSL + 自动压缩 + OpenAI 兼容 + Ink TUI；NodeNext + tsc 原地编译，dev 用 Bun .ts、install 用 Node .js（学习/教学用）",
   "license": "SEE LICENSE IN LICENSE",
   "author": "Bill Wang <leiwang0359@gmail.com>",

package/skills/config/SKILL.md

@@ -53,8 +53,11 @@ Read({ file_path: "~/.minimal-agent/config.json" })
 | moonshot | moonshot-v1-8k | 8000 |
 | moonshot | moonshot-v1-32k | 32000 |
 | moonshot | moonshot-v1-128k | 128000 |
+| volces | doubao-seed-2.0-pro / glm-5.1 / kimi-k2.6 / deepseek-v3.2 / minimax-latest | 204800 |
 | 其它 / custom | — | 128000 |
 
+⚠️ 火山方舟 ARK Coding Plan：一个 endpoint (`https://ark.cn-beijing.volces.com/api/coding/v3`) 后挂多个 model，**model 字段大小写严格匹配**（`glm-5.1` 而非 `GLM-5.1`）。常见 model id 见 `src/cli/configWizard.tsx::PRESETS` 的 `volces` 项；部分 model（如 `glm-5.1`）走 draft-2020-12 严校验，由 `src/utils/zodToJson.ts::modernizeExclusiveBounds` 透明兼容。
+
 ⚠️ 询问 `contextWindow` 时，**先按上表给出推荐值并明确告诉用户**（例：「按你选的 `MiniMax-M2.7`，推荐 `contextWindow = 204800`，直接回车采纳」）。**不要让用户裸填 token 数**；用户主要关心 `baseURL` / `apiKey` / `model`，contextWindow 应优先按 provider+model 推断。
 
 如果用户改了 model 但没改 contextWindow，**主动重新计算推荐值**并提示；用户旧 contextWindow 与新 model 不匹配时（如把 model 从 `moonshot-v1-8k` 改成 `moonshot-v1-128k`），明确建议同步更新。

package/src/cli/configWizard.js

@@ -37,6 +37,25 @@ const PRESETS = [
         models: ['MiniMax-M2.7', 'MiniMax-M1', 'abab6.5s-chat'],
         contextWindow: 204_800,
     },
+    {
+        // 火山方舟 ARK Coding Plan —— 一个 endpoint 后挂多个 model id，
+        // model 字段大小写严格匹配（'glm-5.1' 而非 'GLM-5.1'）。
+        // 部分 model（如 glm-5.1）走 draft-2020-12 严校验，靠 zodToJson 的
+        // modernizeExclusiveBounds 兼容。
+        name: 'volces',
+        label: '火山方舟 Coding Plan (ARK)',
+        baseURL: 'https://ark.cn-beijing.volces.com/api/coding/v3',
+        models: [
+            'doubao-seed-2.0-pro',
+            'doubao-seed-2.0-code',
+            'doubao-seed-code',
+            'glm-5.1',
+            'minimax-latest',
+            'deepseek-v3.2',
+            'kimi-k2.6',
+        ],
+        contextWindow: 204_800,
+    },
     {
         name: 'deepseek',
         label: 'DeepSeek',

package/src/loop.js

@@ -107,6 +107,9 @@ export async function* runQuery(userInput, options) {
                     else if (ev.field === 'reasoning_details' && ev.items) {
                         reasoningDetails.push(...ev.items);
                     }
+                    if (ev.delta) {
+                        yield { type: 'reasoning_delta', field: ev.field, delta: ev.delta };
+                    }
                 }
                 // ev.type === 'done' 时无需处理：循环自然结束
             }

package/src/prompts/system.js

@@ -34,6 +34,17 @@ export async function getSystemPrompt(cwd, tools) {
 
 # 思维与立场（核心：像专家一样独立思考）
 - **你是工程协作者，不是奉承者**。不无条件夸赞、不为附和而附和、不同意时直说。不用"很好的问题"、"你说得对"、"完全同意"这类前缀——直接答内容。
+- **先判断用户意图再行动**——这是最重要的第一步，区分以下三种情况：
+  - ✅ **明确执行（直接动手，不要犹豫）**：用户表述包含明确的行动指令。
+    动词特征：「修改/改/调整/修复/优化/更新/替换/删/移除/写/创建/实现/做/生成/新建/开发/执行/跑/运行/提交/部署/安装」
+    确认性指令也算：「对就这么改」「是的按这个方案实现」「好的麻烦改一下」
+  - ❌ **纯讨论（绝对不能动文件，只回答）**：用户只是提问、咨询、探讨、评估。
+    特征：问号结尾、「是不是/怎么样/为什么/好不好/能否/你觉得」、纯观点表达「我觉得...」「这里好像有...」
+    即使你发现明显问题，也只能给文字建议，**禁止调用 Edit/Write/MultiEdit/Bash 写操作等任何修改类工具**
+  - ❓ **模糊场景（仅一次确认，不要啰嗦）**：介于两者之间无法判断时。
+    例：「这个接口响应太慢了」「这个正则好像有问题」
+    只问一句：「你是需要我实际修改/修复，还是只是讨论这个问题？」—— 用户说改就立刻改，说讨论就停
+- **兜底原则**：宁可多问一次也不要擅自修改；但只要用户明确说要改，必须立刻执行，不要二次确认。
 - **基于证据，不基于揣测用户想听什么**。没读过的代码先 Read，没验证过的行为先验证，不凭印象答。回答前先问自己：这个判断有具体证据吗，还是我在猜？
 - **不知道就说不知道**。明确边界："这个版本号我不确定"、"这个 API 我没看过文档"、"这部分行为我没验证过"。胡编一个看起来对的答案，代价远高于承认不知道。
 - **明示 confidence 分层**。结论按确定度分层表达——"已 verify / 高度确信"、"基于代码合理推测"、"未验证猜测"——让用户基于你的不确定程度决策，不要把推测说成事实。
@@ -62,6 +73,7 @@ ${toolList}
 - 修改既有文件之前，必须用 Read 工具读取相关代码的最新内容。
   "我记得"、"我之前看过"、"应该差不多"都不算读过——必须在本轮任务中实际调用 Read。
   尤其当你要参考某个文件的写法来实现类似功能时，必须先重读该文件的关键部分（函数实现、判断逻辑、数据流），理解清楚后再动手。
+- Edit / MultiEdit 拦截 fallback：如果你忘了先 Read 就直接调 Edit/MultiEdit，错误响应里会**自动附带当前文件前 200 行 / 32KB 以内的 snippet**（带行号）。这种情况下**直接基于 snippet 重新构造 old_string 再发一次 Edit 即可，不要再额外调 Read**。只有当 snippet 显示"未注入内容"（文件过大或二进制）时才需要显式 Read。Write 不附带 snippet——整文件覆盖语义下必须先显式 Read，避免基于片段重写导致截断范围外内容丢失。
 - Edit 工具的 old_string 必须在文件中唯一；不唯一时请扩大上下文或显式 replace_all=true。
 - 同一文件需要修改多处（3 处及以上）时优先用 MultiEdit：所有 edit 按顺序在内存中应用，**全部成功才落盘**；任一失败磁盘不动，避免中间状态污染。单点修改继续用 Edit。
 - Write 覆盖既有文件前同样必须先 Read（与 Edit 对称，未先 Read 会被拒绝并提示"请先 Read"）；写新文件无此要求。

package/src/tools/edit/edit.js

@@ -17,7 +17,7 @@ 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 { resolveToolPath, findActualString, preserveQuoteStyle, detectLineEndingsForString, applyLineEnding, countOccurrences, splitReplaceAll, } from '../shared/fileUtils.js';
+import { resolveToolPath, findActualString, preserveQuoteStyle, detectLineEndingsForString, applyLineEnding, countOccurrences, splitReplaceAll, tryAutoSnapshot, } from '../shared/fileUtils.js';
 import { filePathField } from '../shared/schemas.js';
 import { assertFresh, recordRead, wasTruncated } from '../shared/fileState.js';
 /** 编辑文件大小上限：1GB。防止模型试图 Edit 超大文件撑爆内存。 */
@@ -59,9 +59,33 @@ async function call(input) {
         return pathResult;
     const filePath = pathResult.resolvedPath;
     // 5a-bis. Pre-read guard：文件已存在则必须先 Read（创建新文件场景下 assertFresh 返回 ok:true）
+    // 拦截路径自动注入 snippet：让模型在同一轮 tool result 里看到当前内容，无需多绕一次 Read。
+    // 安全语义保留：模型必须显式重发 Edit 才会落盘；snippet 只是给模型看的，不静默放行。
     const freshness = assertFresh(filePath);
     if (!freshness.ok) {
-        return { ok: false, error: freshness.error };
+        const snap = await tryAutoSnapshot(filePath);
+        if (snap.ok) {
+            // 关键：truncated=true 时 wasTruncated 会守住 Write 路径，防止基于残缺 snippet 重写整文件
+            recordRead(filePath, { truncated: snap.truncated });
+            const tail = snap.truncated
+                ? `\n\n⚠️ 仅注入了前 200 行（文件共 ${snap.totalLines} 行 / 上限 32KB）。若要改的位置在范围外，请显式 Read offset=X limit=Y 后再 Edit。`
+                : '';
+            return {
+                ok: false,
+                error: freshness.error +
+                    `\n\n以下是当前文件${snap.truncated ? '前 200 行' : '全部'}内容（带行号），请基于此重新构造 old_string 后立即重试 Edit，不要再单独调 Read：\n\n${snap.snippet}` +
+                    tail,
+            };
+        }
+        const why = snap.reason === 'too-large'
+            ? `文件 ${((snap.sizeBytes ?? 0) / 1024).toFixed(1)} KB 超过 32KB 自动注入上限`
+            : snap.reason === 'binary'
+                ? '文件命中二进制扩展名黑名单'
+                : '文件读取失败';
+        return {
+            ok: false,
+            error: `${freshness.error}\n\n（${why}，未注入内容快照，请用 Read 工具显式读取后再 Edit）`,
+        };
     }
     if (old_string === new_string) {
         return { ok: false, error: 'old_string 与 new_string 完全相同，没有可改的内容。' };

package/src/tools/edit/multi-edit.js

@@ -18,7 +18,7 @@ import { existsSync } from 'node:fs';
 import { z } from 'zod';
 import { DEFAULT_MAX_RESULT_SIZE_CHARS } from '../types.js';
 import { toToolParameters } from '../../utils/zodToJson.js';
-import { resolveToolPath, detectFileLineEndings, applyLineEnding, findActualString, preserveQuoteStyle, countOccurrences, splitReplaceAll, } from '../shared/fileUtils.js';
+import { resolveToolPath, detectFileLineEndings, applyLineEnding, findActualString, preserveQuoteStyle, countOccurrences, splitReplaceAll, tryAutoSnapshot, } from '../shared/fileUtils.js';
 import { filePathField } from '../shared/schemas.js';
 import { assertFresh, recordRead, wasTruncated } from '../shared/fileState.js';
 // ---------------- 1. Zod 输入 schema ----------------
@@ -58,10 +58,31 @@ async function call(input) {
     if (!pathResult.ok)
         return pathResult;
     const filePath = pathResult.resolvedPath;
-    // 4b. Pre-read guard
+    // 4b. Pre-read guard —— 入口处一次性检查 + 注入 snippet（循环内多个 edit 不重复注入）
     const freshness = assertFresh(filePath);
     if (!freshness.ok) {
-        return { ok: false, error: freshness.error };
+        const snap = await tryAutoSnapshot(filePath);
+        if (snap.ok) {
+            recordRead(filePath, { truncated: snap.truncated });
+            const tail = snap.truncated
+                ? `\n\n⚠️ 仅注入了前 200 行（文件共 ${snap.totalLines} 行 / 上限 32KB）。若要改的位置在范围外，请显式 Read offset=X limit=Y 后再 MultiEdit。`
+                : '';
+            return {
+                ok: false,
+                error: freshness.error +
+                    `\n\n以下是当前文件${snap.truncated ? '前 200 行' : '全部'}内容（带行号），请基于此重新构造各 edit 的 old_string 后立即重试 MultiEdit，不要再单独调 Read：\n\n${snap.snippet}` +
+                    tail,
+            };
+        }
+        const why = snap.reason === 'too-large'
+            ? `文件 ${((snap.sizeBytes ?? 0) / 1024).toFixed(1)} KB 超过 32KB 自动注入上限`
+            : snap.reason === 'binary'
+                ? '文件命中二进制扩展名黑名单'
+                : '文件读取失败';
+        return {
+            ok: false,
+            error: `${freshness.error}\n\n（${why}，未注入内容快照，请用 Read 工具显式读取后再 MultiEdit）`,
+        };
     }
     // 4c. 文件必须存在（MultiEdit 不做"创建新文件"语义）
     if (!existsSync(filePath)) {

package/src/tools/shared/fileState.js

@@ -39,6 +39,7 @@ export function assertFresh(absPath) {
         if (existsSync(absPath)) {
             return {
                 ok: false,
+                reason: 'never-read',
                 error: `文件 ${absPath} 已存在但未在本会话 Read 过。请先用 Read 工具读取，确认内容后再修改。`,
             };
         }
@@ -50,6 +51,7 @@ export function assertFresh(absPath) {
         if (st.mtimeMs > entry.timestamp) {
             return {
                 ok: false,
+                reason: 'mtime-drift',
                 error: `${absPath} 在 Read 后被外部修改（mtime 漂移）。请重新用 Read 工具读取最新内容。`,
             };
         }

package/src/tools/shared/fileUtils.js

@@ -9,6 +9,7 @@
  *    4. 引号风格保留（弯引号 ↔ 直引号归一化）
  * ============================================================
  */
+import { statSync } from 'node:fs';
 import { open, readFile } from 'node:fs/promises';
 import { homedir } from 'node:os';
 import { extname, resolve } from 'node:path';
@@ -129,6 +130,66 @@ export function hasBinaryExtension(filePath) {
     const ext = extname(filePath).toLowerCase();
     return BINARY_EXTENSIONS.has(ext);
 }
+// -------------------- 3.7 自动 snapshot（Edit/MultiEdit 拦截路径用） --------------------
+/**
+ * 自动读取文件前 N 行作为 snippet，给 Edit/MultiEdit 在 assertFresh 拦截时注入到错误响应里。
+ *
+ * 双限制：
+ *   - SNAPSHOT_MAX_LINES = 200 行（防止小行长文件吃 context）
+ *   - SNAPSHOT_MAX_BYTES = 32KB（防止超长单行 minified 文件撑爆 context）
+ *   两个阈值任一命中都拒绝读全量。
+ *
+ * 失败 reason：
+ *   - 'binary'      → 命中二进制扩展名黑名单
+ *   - 'too-large'   → 文件 > 32KB（不读全文，让模型走显式 Read）
+ *   - 'unreadable'  → stat 或 read 失败
+ *
+ * 调用方负责：
+ *   1. 在拿到 ok=true 后调 recordRead(filePath, { truncated: snap.truncated })
+ *   2. 把 snippet 拼到 error 字符串里
+ *   3. ok=false 时根据 reason 给模型可读的 fallback 消息
+ */
+const SNAPSHOT_MAX_LINES = 200;
+const SNAPSHOT_MAX_BYTES = 32 * 1024;
+export async function tryAutoSnapshot(filePath) {
+    // 1. 二进制扩展名拒绝
+    if (hasBinaryExtension(filePath)) {
+        return { ok: false, reason: 'binary' };
+    }
+    // 2. stat 拿大小
+    let sizeBytes;
+    try {
+        const st = statSync(filePath);
+        if (!st.isFile())
+            return { ok: false, reason: 'unreadable' };
+        sizeBytes = st.size;
+    }
+    catch {
+        return { ok: false, reason: 'unreadable' };
+    }
+    // 3. 字节阈值
+    if (sizeBytes > SNAPSHOT_MAX_BYTES) {
+        return { ok: false, reason: 'too-large', sizeBytes };
+    }
+    // 4. 读全文（已知 <= 32KB）
+    let content;
+    try {
+        content = await readFile(filePath, 'utf8');
+    }
+    catch {
+        return { ok: false, reason: 'unreadable' };
+    }
+    // 5. 行数阈值：超过 200 行截断
+    const allLines = content.split('\n');
+    const totalLines = allLines.length;
+    const truncated = totalLines > SNAPSHOT_MAX_LINES;
+    const lines = truncated ? allLines.slice(0, SNAPSHOT_MAX_LINES) : allLines;
+    // 拼带行号的 snippet（与 Read 工具输出风格一致）
+    const numbered = lines
+        .map((line, i) => `${String(i + 1).padStart(6, ' ')}\t${line}`)
+        .join('\n');
+    return { ok: true, snippet: numbered, truncated, totalLines };
+}
 /**
  * 读文件前 3 字节，返回 BOM 类型。
  * - EF BB BF → utf8-bom

package/src/ui/App.js

@@ -8,7 +8,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  * ============================================================
  */
 import React from 'react';
-import { Box, Text } from 'ink';
+import { Box, Text, Static } from 'ink';
 import { saveContext } from '../context/persistContext.js';
 import { InputBox } from './InputBox.js';
 import { MessageList } from './MessageList.js';
@@ -33,5 +33,5 @@ export function App({ provider, initialHistory }) {
         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 })] }));
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Static, { items: [null], 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, streamingReasoning: chat.streamingReasoning }), _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(Static, { items: [chat.history.length], children: () => (_jsx(StatusLine, { provider: provider, history: chat.history, pluginProgress: chat.pluginProgress })) })] }));
 }

package/src/ui/MessageList.js

@@ -1,8 +1,10 @@
 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" })] }))] }));
+export function MessageList({ history, streamingText, streamingReasoning }) {
+    return (_jsxs(Box, { flexDirection: "column", children: [history.map((m, i) => (_jsx(MessageRow, { message: m }, i))), streamingReasoning.length > 0 && (_jsx(Box, { marginBottom: 1, children: _jsxs(Text, { color: "gray", dimColor: true, children: ["\uD83D\uDCA1 ", streamingReasoning.length > 300
+                            ? `...(${Math.round(streamingReasoning.length / 1000)}K字)${streamingReasoning.slice(-200)}`
+                            : streamingReasoning] }) })), streamingText.length > 0 && (_jsx(Box, { marginBottom: 1, children: _jsx(Text, { children: streamingText }) }))] }));
 }
 function MessageRow({ message }) {
     switch (message.role) {

package/src/ui/hooks/useChat.js

@@ -29,6 +29,7 @@ export function useChat(args) {
     const [version, setVersion] = useState(0);
     const bump = useCallback(() => setVersion((v) => v + 1), []);
     const [streamingText, setStreamingText] = useState('');
+    const [streamingReasoning, setStreamingReasoning] = useState('');
     const [toolStatus, setToolStatus] = useState(null);
     const [isLoading, setIsLoading] = useState(false);
     const [error, setError] = useState(null);
@@ -55,6 +56,49 @@ export function useChat(args) {
         setPluginProgress(null);
         const ac = new AbortController();
         abortRef.current = ac;
+        let streamBuf = '';
+        let reasoningBuf = '';
+        let streamTimer = null;
+        const throttledSetStreamingText = (value) => {
+            streamBuf = typeof value === 'function' ? value(streamBuf) : value;
+            if (!streamTimer) {
+                streamTimer = setInterval(() => {
+                    if (streamBuf.length > 0) {
+                        setStreamingText(streamBuf);
+                    }
+                    if (reasoningBuf.length > 0) {
+                        setStreamingReasoning(reasoningBuf);
+                    }
+                }, 200);
+            }
+        };
+        const throttledSetStreamingReasoning = (value) => {
+            reasoningBuf = typeof value === 'function' ? value(reasoningBuf) : value;
+            if (!streamTimer) {
+                streamTimer = setInterval(() => {
+                    if (streamBuf.length > 0) {
+                        setStreamingText(streamBuf);
+                    }
+                    if (reasoningBuf.length > 0) {
+                        setStreamingReasoning(reasoningBuf);
+                    }
+                }, 200);
+            }
+        };
+        const flushStream = () => {
+            if (streamTimer) {
+                clearInterval(streamTimer);
+                streamTimer = null;
+            }
+            if (streamBuf.length > 0) {
+                setStreamingText(streamBuf);
+                streamBuf = '';
+            }
+            if (reasoningBuf.length > 0) {
+                setStreamingReasoning(reasoningBuf);
+                reasoningBuf = '';
+            }
+        };
         try {
             for await (const ev of runWithPlugins(trimmed, {
                 provider: args.provider,
@@ -62,7 +106,8 @@ export function useChat(args) {
                 signal: ac.signal,
             })) {
                 handleEvent(ev, {
-                    setStreamingText,
+                    setStreamingText: throttledSetStreamingText,
+                    setStreamingReasoning: throttledSetStreamingReasoning,
                     setToolStatus,
                     setCompacting,
                     setError,
@@ -76,8 +121,10 @@ export function useChat(args) {
             setError(`未捕获异常：${e.message}`);
         }
         finally {
+            flushStream();
             setIsLoading(false);
             setStreamingText('');
+            setStreamingReasoning('');
             setToolStatus(null);
             setCompacting(false);
             setPluginProgress(null);
@@ -104,6 +151,7 @@ export function useChat(args) {
         // 允许新 session 再次触发反应式压缩自救
         resetReactiveCompactState();
         setStreamingText('');
+        setStreamingReasoning('');
         setToolStatus(null);
         setError(null);
         setInterrupted(false);
@@ -156,6 +204,7 @@ export function useChat(args) {
     return {
         history,
         streamingText,
+        streamingReasoning,
         toolStatus,
         isLoading,
         error,
@@ -179,11 +228,16 @@ function handleEvent(ev, setters) {
     const e = ev;
     switch (e.type) {
         case 'text':
-            setters.setStreamingText((prev) => prev + e.delta);
+            setters.setStreamingText(prev => prev + e.delta);
+            break;
+        case 'reasoning_delta':
+            if (e.delta) {
+                setters.setStreamingReasoning(prev => prev + e.delta);
+            }
             break;
         case 'assistant_message':
-            // history 已被 runQuery 直接 push，这里只刷一下视图 + 清流式 buffer
-            setters.setStreamingText(() => '');
+            setters.setStreamingText('');
+            setters.setStreamingReasoning('');
             setters.bump();
             break;
         case 'tool_start':
@@ -199,10 +253,8 @@ function handleEvent(ev, setters) {
             setters.bump();
             break;
         case 'compact_start':
-            // reactive 自救场景：LLM 失败前可能已经 yield 过部分 text delta，
-            // 压缩前清掉残留 streamingText，避免重发后新文本追加在旧 buffer 后面。
-            // autoCompact 场景下 streamingText 本来就是空，这里 no-op。
-            setters.setStreamingText(() => '');
+            setters.setStreamingText('');
+            setters.setStreamingReasoning('');
             setters.setCompacting(true);
             setters.bump();
             break;
@@ -215,10 +267,14 @@ function handleEvent(ev, setters) {
             break;
         case 'interrupted':
             setters.setInterrupted(true);
+            setters.setStreamingText('');
+            setters.setStreamingReasoning('');
             setters.bump();
             break;
         case 'error':
             setters.setError(e.error);
+            setters.setStreamingText('');
+            setters.setStreamingReasoning('');
             setters.bump();
             break;
         case 'plugin_progress':

package/src/utils/zodToJson.js

@@ -11,12 +11,55 @@
  * ============================================================
  */
 import { zodToJsonSchema } from 'zod-to-json-schema';
+/**
+ * 把 zodToJsonSchema 输出的 draft-04 boolean 形式 exclusiveMin/Max 升级为
+ * draft-2020-12 number 形式，让生成的 schema 在严校验 LLM provider 也能通过。
+ *
+ * 背景：`target: 'openApi3'` 走 OpenAPI 3.0 / JSON Schema draft-04 规范，
+ *   `.positive()` 之类的 Zod 约束生成 `{minimum: 0, exclusiveMinimum: true}`。
+ * 严校验 provider（如火山 ARK Coding 后挂的 GLM-5.1）按 draft-2020-12 要求
+ *   `exclusiveMinimum` 必须是 number，遇 boolean 直接 400 InvalidParameter。
+ *
+ * 转换规则：
+ *   {minimum: N, exclusiveMinimum: true}  →  {exclusiveMinimum: N}
+ *   {maximum: N, exclusiveMaximum: true}  →  {exclusiveMaximum: N}
+ *
+ * Fallback：boolean 形式但同级没有 minimum/maximum 时（理论 edge case），
+ *   静默删除 boolean 字段——避免污染 schema，运行时 Zod 兜底校验。
+ */
+function modernizeExclusiveBounds(node) {
+    if (Array.isArray(node))
+        return node.map(modernizeExclusiveBounds);
+    if (node === null || typeof node !== 'object')
+        return node;
+    const obj = node;
+    const out = {};
+    for (const [k, v] of Object.entries(obj)) {
+        if (k === 'exclusiveMinimum' && typeof v === 'boolean') {
+            if (v && typeof obj.minimum === 'number')
+                out.exclusiveMinimum = obj.minimum;
+            continue;
+        }
+        if (k === 'minimum' && obj.exclusiveMinimum === true)
+            continue;
+        if (k === 'exclusiveMaximum' && typeof v === 'boolean') {
+            if (v && typeof obj.maximum === 'number')
+                out.exclusiveMaximum = obj.maximum;
+            continue;
+        }
+        if (k === 'maximum' && obj.exclusiveMaximum === true)
+            continue;
+        out[k] = modernizeExclusiveBounds(v);
+    }
+    return out;
+}
 /**
  * 从 Zod schema 派生出 OpenAI tools[] 兼容的 JSON Schema 对象。
  *
  * 做了以下清理：
  *   - 移除 `$schema` 元数据字段（LLM 不需要）
  *   - `additionalProperties` 默认 false（防止模型传多余字段）
+ *   - `modernizeExclusiveBounds` 把 boolean exclusiveMin/Max 升级 draft-2020-12 number 形式
  */
 export function toToolParameters(schema) {
     const json = zodToJsonSchema(schema, {
@@ -25,5 +68,5 @@ export function toToolParameters(schema) {
     });
     // 移除 LLM 不需要的元数据
     const { $schema, ...rest } = json;
-    return rest;
+    return modernizeExclusiveBounds(rest);
 }