mocode-ai 0.5.2 → 0.5.4

package/dist/agent/core.js

@@ -17,6 +17,7 @@ import { createRelevancePruner } from '../context/relevance.js';
 import { config } from '../config/index.js';
 import { jailResolve } from '../sandbox/index.js';
 import { createLifecycleEngine } from '../context/lifecycle.js';
+import { hasActivePlan, getActivePlan } from '../plan/active.js';
 /** 解析工具 arguments JSON;非法或空返 null(调用方据此降级到普通 preview)。 */
 function parseArgs(raw) {
     try {
@@ -166,11 +167,45 @@ export async function runAgentCore(opts) {
     // Thrashing 检测:本轮内同 (name, args) 累计次数。≥3 在工具结果尾部追加 hint(见 thrashHint)。
     // 只在 runAgentCore 内,turn 结束自然 GC;不跨 turn 持久(下一轮重新计数,避免误把历史判为 thrashing)。
     const recentToolCalls = new Map();
+    // Plan progress nudge:LLM 连续 ≥ PLAN_NUDGE_THRESHOLD 次工具调用没调 todolist → 注入提醒到结果末尾。
+    // 让进度 chip 反映真实进展,而不是做完一大段后才一次性批量更新。
+    // 计数器在任何 todolist 调用后重置;nudge 发出后也重置(避免后续每次工具调用都重复提醒)。
+    let stepsSincePlanUpdate = 0;
+    const PLAN_NUDGE_THRESHOLD = 2;
+    // Plan nudge 节流:同一步骤只发一次,避免模型未响应时重复刷屏。
+    // nudge 发出后置 -1;调 todolist 后重置为 0(可重新触发);中间步骤保持负值(不重复)。
+    const planNudge = (name) => {
+        if (name === 'todolist') {
+            stepsSincePlanUpdate = 0;
+            return null;
+        }
+        stepsSincePlanUpdate++;
+        if (stepsSincePlanUpdate < PLAN_NUDGE_THRESHOLD)
+            return null;
+        if (stepsSincePlanUpdate > PLAN_NUDGE_THRESHOLD)
+            return null; // 已发过,不再重复
+        if (!hasActivePlan())
+            return null;
+        const p = getActivePlan();
+        if (!p || p.status !== 'in_progress')
+            return null;
+        const hasPending = p.steps.some((s) => s.status === 'pending' || s.status === 'in_progress');
+        if (!hasPending)
+            return null;
+        return ('\n\n[plan-nudge] ⚠ You\'ve run ' + PLAN_NUDGE_THRESHOLD +
+            '+ tool calls since the last plan update. ' +
+            'Call `todolist` (action=update) NOW to mark the current step done and set the next step in_progress. ' +
+            'Do this BEFORE making more tool calls.');
+    };
     const recordAndHint = (name, args) => {
         const fp = `${name}\x00${args}`;
         const c = (recentToolCalls.get(fp) ?? 0) + 1;
         recentToolCalls.set(fp, c);
-        return thrashHint(name, args, c);
+        const thrash = thrashHint(name, args, c);
+        const nudge = planNudge(name);
+        if (!thrash && !nudge)
+            return null;
+        return [thrash, nudge].filter(Boolean).join('');
     };
     history.push({ role: 'user', content: userInput });
     // drop_context 工具的上下文剔除回调:闭包捕获 history,原地剔除无关旧 tool 结果。
@@ -207,10 +242,6 @@ export async function runAgentCore(opts) {
     const onToolCall = (name) => {
         // 文本/思考已流完,模型转而生成 tool_call 参数(可能很长,如 write_file 整篇内容):
         // 补换行(让随后的 ● 行与 diff 不黏在正文末尾)+ 启「生成中」内联 spinner,内容区不再干等。
-        if (lastChar && lastChar !== '\n') {
-            hooks.onTextEnd?.(); // 主 agent:layout.contentWrite('\n')
-            lastChar = '\n';
-        }
         hooks.onToolCall?.(name); // 主 agent:spinner.start(`生成 ${name}…`)
     };
     // 中断还原:停 spinner + 补换行 + (已中断)提示 + history 还原到本 turn 前 + 模式还原。
@@ -267,9 +298,7 @@ export async function runAgentCore(opts) {
             onContextUpdate?.();
             if (result.toolCalls.length > 0) {
                 hadToolsThisTurn = true;
-                // 流式正文末尾补换行(若 onToolCall 已补则 lastChar='\n',此处 no-op);防 ● 行黏在正文行尾
-                if (mode !== 'idle' && lastChar !== '\n')
-                    hooks.onTextEnd?.();
+                // 正文与工具批次的分隔由 onToolBatchStart 连同摘要一次性提交，避免两次写屏错位。
                 // 带工具调用的 assistant 消息原样回灌(OpenAI 格式要求)
                 history.push({
                     role: 'assistant',
@@ -287,6 +316,7 @@ export async function runAgentCore(opts) {
                 // 渲染与 history 回灌一律按原顺序;并发只影响执行时序,tool_call_id 仍按序配对。
                 // executeTool 永不抛错(调度器 try/catch 返字符串),故 await 单个 promise 不会抛(永远 resolve 为字符串)。
                 const calls = result.toolCalls;
+                hooks.onToolBatchStart?.(calls);
                 let i = 0;
                 while (i < calls.length) {
                     if (READ_TOOL_NAMES.has(calls[i].name)) {

package/dist/agent/index.js

@@ -12,8 +12,6 @@ import { beginTurn } from '../rollback/index.js';
 import { config } from '../config/index.js';
 import { runAgentCore, isMutationTool, } from './core.js';
 import { createPetHooks } from '../pet/state.js';
-/** 当前 turn 的 batch id(runAgent 内闭包变量;一条 turn 一轮 tool batch 结束即清空)。 */
-let currentBatchId = null;
 /** 取 userInput 的首行:字符串直接 split;多模态 parts 找首个 text part 再 split。 */
 function firstLineOf(ui) {
     if (typeof ui === 'string')
@@ -21,19 +19,24 @@ function firstLineOf(ui) {
     const first = ui.find((p) => p.type === 'text');
     return first?.text.split('\n')[0] ?? '';
 }
-/** 工具调用 ● 头:工具名 + 参数摘要(按 tool_calls 原顺序打印,让用户看到本轮跑哪些工具)。
- *  重构后改为累积到 BatchRenderer,onToolBatchEnd 时统一打摘要行;
- *  展开/折叠由 BatchRenderer + 鼠标 release 决定,本函数不再直接写屏。 */
-function writeToolHeader(tc) {
-    if (!currentBatchId)
-        currentBatchId = batch.beginBatch();
-    batch.recordCall(currentBatchId, tc.name, summarizeToolCall(tc.name, tc.arguments));
+/** 完整工具批次一拿到就聚合成一行写屏，结果随后回填到同一可展开项。 */
+function writeToolBatch(calls, leadingBlank) {
+    const id = batch.beginBatch();
+    for (const tc of calls) {
+        batch.recordCall(id, tc.name, summarizeToolCall(tc.name, tc.arguments));
+    }
+    batch.showPendingBatch(id, layout, leadingBlank);
+    return id;
+}
+function appendToolBatch(id, calls) {
+    batch.appendPendingCalls(id, calls.map((tc) => ({
+        name: tc.name,
+        callSummary: summarizeToolCall(tc.name, tc.arguments),
+    })), layout);
 }
 /** 渲染工具结果:mutation 成功走 diff 块(行号 + 语法高亮,仿 Claude Code);其余走一行 preview。
  *  同 writeToolHeader,改为累积到 BatchRenderer(只缓存字符串,不写屏)。 */
-function writeToolResult(tc, output, parsed, preWriteOld, editStartLine) {
-    if (!currentBatchId)
-        return;
+function writeToolResult(batchId, tc, output, parsed, preWriteOld, editStartLine) {
     let diff = null;
     if (isMutationTool(tc.name) && parsed && !output.startsWith('错误')) {
         diff = renderFileChange({
@@ -47,7 +50,7 @@ function writeToolResult(tc, output, parsed, preWriteOld, editStartLine) {
         });
     }
     const preview = diff ? '' : summarizeToolResult(tc.name, output);
-    batch.recordResult(currentBatchId, tc.name, preview, diff, output);
+    batch.completePendingBatch(batchId, tc.name, preview, diff, output, layout);
 }
 /**
  * agent 核心循环(主 agent,TUI 渲染版):
@@ -69,7 +72,6 @@ onContextUpdate) {
     // 开新轮次(回滚用):首行截断 40,供 /rollback 轮次菜单展示。
     beginTurn(truncateDisplay(firstLineOf(userInput), 40));
     layout.contentMode(); // 防御性:运行态光标归输入框光标位供 IME 锚定(enterRunningMode 已置,这里兜底)
-    currentBatchId = null; // 新 turn 清旧 batch id(防上 turn 残留)
     // spinner:状态行最前面转圈(思考中 / 生成 / 执行 工具时,状态栏 lead 位显帧 + 文字)。
     // 经 setStatus 注入状态行(spinnerFrame + statusText),composeStatus 把帧 + 文字放 lead 位;
     // 不画内容区续写位——内容区在等待期间保持干净,首 token 到达即从续写位开始写正文。
@@ -79,20 +81,29 @@ onContextUpdate) {
     // lastChar 镜像:core 跟踪流式末字符决定补换行,但 TUI hooks 需读它决定 layout.contentWrite('\n')。
     // core 的 onTextEnd hook 只在 lastChar !== '\n' 时才调,调后置 '\n';镜像与此同步。
     let lastChar = '';
+    let visibleBlock = 'none';
+    let currentBatchId = null;
     const hooks = {
         onText: (s) => {
             spinner.stop(); // 任何正文 token 都停 spinner(首 token 停「思考中」;onToolCall 重启后若又来文本则停「生成中」)。未旋转时 stop 为 no-op。
-            layout.contentWriteMd(s); // 正文走 markdown 渲染(代码块高亮 / 标题 / 列表 / 行内 …),见 ui/markdown.ts
+            const hasVisibleText = s.trim().length > 0;
+            let expandedBatchHasBlankTail = false;
+            if (hasVisibleText && currentBatchId) {
+                batch.finalizePendingBatch(currentBatchId, layout);
+                // 展开详情通过中段插入，原摘要后的空行会保留在详情尾部；无需再补一次。
+                expandedBatchHasBlankTail = batch.isExpanded(currentBatchId);
+                currentBatchId = null;
+            }
+            const leadingBlank = hasVisibleText && visibleBlock === 'tool' && !expandedBatchHasBlankTail;
+            layout.contentWriteMd(s, leadingBlank); // 分隔与正文同次重绘，避免续写位二次定位多出空行
+            if (hasVisibleText)
+                visibleBlock = 'text';
             if (s)
                 lastChar = s[s.length - 1];
         },
         onToolCall: (name) => {
             // 文本/思考已流完,模型转而生成 tool_call 参数(可能很长,如 write_file 整篇内容):
             // 补换行(让随后的 ● 行与 diff 不黏在正文末尾)+ 启「生成中」内联 spinner,内容区不再干等。
-            if (lastChar && lastChar !== '\n') {
-                layout.contentWrite('\n');
-                lastChar = '\n';
-            }
             if (name)
                 spinner.start(`生成 ${name}`);
         },
@@ -104,30 +115,38 @@ onContextUpdate) {
                 lastChar = '\n';
             }
         },
-        onToolHeader: (tc) => writeToolHeader(tc),
+        onToolBatchStart: (calls) => {
+            if (currentBatchId)
+                appendToolBatch(currentBatchId, calls);
+            else
+                currentBatchId = writeToolBatch(calls, visibleBlock !== 'none');
+            visibleBlock = 'tool';
+        },
+        onToolHeader: () => { },
         onToolStart: (name) => spinner.start(`执行 ${name}`),
         onToolDone: () => spinner.stop(),
-        onToolResult: (tc, output, parsed, preWriteOld, editStartLine) => writeToolResult(tc, output, parsed, preWriteOld, editStartLine),
-        onToolBatchEnd: () => {
-            // 收尾:把累积的 batch 渲染成单行摘要(批内 N 个 tool 调用共用一行,
-            // 鼠标点击该行可展开完整明细——见 ui/batch.ts)。无 batch(模型未调工具)则补空行保持间距。
+        onToolResult: (tc, output, parsed, preWriteOld, editStartLine) => {
             if (currentBatchId) {
-                const id = currentBatchId;
-                currentBatchId = null;
-                batch.endBatch(id, layout);
+                writeToolResult(currentBatchId, tc, output, parsed, preWriteOld, editStartLine);
             }
-            layout.contentWrite('\n');
         },
+        // 连续无正文的工具步骤保持同一 batch；遇到正文或本轮结束时才收尾。
+        onToolBatchEnd: () => { },
         onNoReply: () => layout.contentWrite(`${ui.dim}(无回复)${ui.reset}\n`),
         onMaxSteps: () => layout.contentWrite(`  ${ui.yellow}●${ui.reset} ${ui.yellow}达到最大步数(${config.maxSteps}),本轮停止。${ui.reset}\n`),
         onAbort: () => {
             spinner.stop();
+            if (currentBatchId)
+                batch.finalizePendingBatch(currentBatchId, layout);
+            currentBatchId = null;
             if (lastChar && lastChar !== '\n')
                 layout.contentWrite('\n');
             layout.contentWrite(`${ui.dim}(已中断)${ui.reset}\n`);
-            currentBatchId = null; // 丢弃未收尾 batch
         },
         onDone: (elapsedMs, usage) => {
+            if (currentBatchId)
+                batch.finalizePendingBatch(currentBatchId, layout);
+            currentBatchId = null;
             const tok = formatTurnTokens(usage);
             layout.contentWrite(`  ${ui.dim}✻ Worked for ${fmtElapsed(elapsedMs)}${tok}${ui.reset}\n`);
         },

package/dist/config/index.js

@@ -223,6 +223,7 @@ ${buildSnapshotSection()}${config.projectSkillEnabled ? buildProjectSkillSection
 
 ## Working notepad (todolist)
 - For genuinely complex tasks only: explore codebase → clarify with user → create plan → execute step by step. See tool description for details.
+- **Update the plan after each step** — do NOT batch all status updates at the end. The progress chip must reflect real-time state.
 
 ## Termination & Reporting
 - Stop immediately when no more tools are needed; give conclusions directly.

package/dist/tools/builtins/todolist.js

@@ -36,8 +36,10 @@ export const todolistTool = {
         'BAD: "打开文件A → 修改函数X → 保存文件A → 运行测试" (too fine-grained, just do it)',
         '',
         '## UPDATE WORKFLOW',
-        'Update in real-time after completing each step (one step = one update, or batch_update for 2-3 at once).',
-        'Do NOT batch all updates at the end — update as you go so the chip reflects real progress.',
+        'Update the plan AFTER completing each step — not before, not in bulk at the end.',
+        '- Mark the current step `done` + set the next step `in_progress` in the same `todolist` call.',
+        '- Use `update` for single steps; `batch_update` ONLY when 2-3 steps finish simultaneously.',
+        '- ⛔ NEVER defer all updates to the end — this defeats the purpose of the progress chip.',
         'All steps done/skipped → plan auto-finishes, archives, and chip disappears.',
         '',
         '## LIFECYCLE',

package/dist/ui/batch.js

@@ -20,6 +20,7 @@ const absLineToBatchId = new Map();
 /** 已展开的 batch id;默认空(全折叠);layout.mouse release 点击摘要行时切。
  *  含 mutation 的 batch 不在此 set——它们走 forceExpanded 永远展开,与 toggle 隔离。 */
 const expandedBatches = new Set();
+const expandedEntries = new Map();
 /** mutation 工具名集合(写盘操作);与 src/agent/core.ts 的 isMutationTool 同步,本模块独立持有
  *  避免 ui → agent 反向依赖。 */
 const MUTATION_TOOLS = new Set(['write_file', 'edit_file']);
@@ -33,6 +34,7 @@ export function reset() {
     batches.clear();
     absLineToBatchId.clear();
     expandedBatches.clear();
+    expandedEntries.clear();
 }
 /** 新建一个 batch(在 agent 拿到第一条 onToolHeader 时调)。返回 id。 */
 export function beginBatch() {
@@ -89,14 +91,76 @@ function buildSummaryLine(entries) {
         parts.push(`${n} ${c}`);
     return `  ${ui.bold}${ui.accent}●${ui.reset} ${ui.dim}Ran ${entries.length} tools · ${parts.join(', ')}${ui.reset}`;
 }
+/** 连续无正文的下一步工具追加到现有 batch，并原位刷新同一条摘要。 */
+export function appendPendingCalls(id, calls, layout) {
+    const b = batches.get(id);
+    if (!b)
+        return;
+    const open = expandedEntries.get(id) ?? new Set();
+    const oldLines = expandedBatches.has(id)
+        ? buildExpandedLines(b.entries, '    ', open)
+        : [];
+    for (const call of calls) {
+        b.entries.push({ ...call, resultSummary: '', diffBlock: null });
+    }
+    if (b.summaryAbsIdx >= 0) {
+        layout.contentReplaceLine?.(b.summaryAbsIdx, buildSummaryLine(b.entries));
+    }
+    if (oldLines.length > 0 && layout.contentDeleteFrom) {
+        layout.contentDeleteFrom(b.summaryAbsIdx + 1, oldLines.length);
+        layout.contentInsertAfter(b.summaryAbsIdx, buildExpandedLines(b.entries, '    ', open));
+    }
+}
+/** 工具开始执行时立即写摘要行并注册点击区域；结果稍后回填，不阻塞首屏展示。 */
+export function showPendingBatch(id, layout, leadingBlank = false) {
+    const b = batches.get(id);
+    if (!b || b.summaryAbsIdx >= 0 || b.entries.length === 0)
+        return;
+    // 分隔换行与摘要必须在同一次 contentWrite 中提交。拆成两次时，第二次入口会重新
+    // 校正终端续写行，在 pending 空行状态下可能把光标再推进一行，造成视觉上的双空行。
+    layout.contentWrite(`${leadingBlank ? '\n' : ''}${buildSummaryLine(b.entries)}\n`);
+    b.summaryAbsIdx = Math.max(0, layout.totalRows() - 2);
+    absLineToBatchId.set(b.summaryAbsIdx, b.id);
+}
+/** 单个工具完成后，把结果回填到正在展示的批量项。 */
+export function completePendingBatch(id, name, resultSummary, diffBlock, fullOutput, layout) {
+    const b = batches.get(id);
+    const open = expandedEntries.get(id) ?? new Set();
+    const oldLines = b && expandedBatches.has(id)
+        ? buildExpandedLines(b.entries, '    ', open)
+        : [];
+    recordResult(id, name, resultSummary, diffBlock, fullOutput);
+    if (b && oldLines.length > 0 && layout?.contentDeleteFrom) {
+        layout.contentDeleteFrom(b.summaryAbsIdx + 1, oldLines.length);
+        layout.contentInsertAfter(b.summaryAbsIdx, buildExpandedLines(b.entries, '    ', open));
+    }
+}
+/** 整批工具完成后再自动展开 mutation，确保展开内容包含批内所有结果。 */
+export function finalizePendingBatch(id, layout) {
+    const b = batches.get(id);
+    if (!b)
+        return;
+    b.forceExpanded = b.entries.some((e) => isMutationTool(e.name));
+    if (b.forceExpanded) {
+        const open = expandedEntries.get(b.id) ?? new Set();
+        b.entries.forEach((e, i) => { if (isMutationTool(e.name))
+            open.add(i); });
+        expandedEntries.set(b.id, open);
+        if (!expandedBatches.has(b.id))
+            expand(b, layout);
+    }
+}
 // ── 展开/折叠 ──
 /** 把 batch 的详情行展开成自洽行数组(供 layout.contentInsertAfter 走 mid-buffer 插入)。
  *  每行末尾必须以 \x1B[0m 收尾(SGR 自洽模型),行内允许含 SGR(行末 reset 不影响行内样式),
  *  但**绝不**带 \n——rows[] 是行数组,不是流输出。 */
-function buildExpandedLines(entries, indent = '    ') {
+function buildExpandedLines(entries, indent = '    ', openEntries) {
     const lines = [];
-    for (const e of entries) {
+    for (let entryIndex = 0; entryIndex < entries.length; entryIndex++) {
+        const e = entries[entryIndex];
         lines.push(`${indent}${ui.bold}${ui.accent}●${ui.reset} ${ui.accent}${e.name}${ui.reset}  ${ui.dim}${e.callSummary}${ui.reset}\x1B[0m`);
+        if (openEntries && !openEntries.has(entryIndex))
+            continue;
         if (e.diffBlock) {
             // diff 块多行文本(由 renderFileChange 渲染);按 \n 拆成物理行,
             // 每行单独入 rows[]。行末 reset 由本函数统一追加(若原行已带 reset,终端合并即可)。
@@ -127,6 +191,35 @@ function buildExpandedLines(entries, indent = '    ') {
     }
     return lines;
 }
+/**
+ * 中断清理:abort 时正在执行的 batch 可能已写屏但尚未 finalize。
+ * 从 buffer 中删除已写入的 pending 摘要行,避免中断后残留无结果的工具执行信息。
+ * 未写屏(summaryAbsIdx < 0)时仅清理内存记录。
+ */
+export function discardPendingBatch(id, layout) {
+    const b = batches.get(id);
+    if (!b)
+        return;
+    // 已写屏且未被 finalize(finalize 后 forceExpanded/expandedBatches 已设置)
+    // 只删 pending 态的摘要行——已 finalize 的 batch 含完整结果,保留给回看
+    if (b.summaryAbsIdx >= 0 && !expandedBatches.has(b.id) && !b.forceExpanded) {
+        // contentDeleteFrom 内部已调 shiftBatchesAfter,此处不重复调
+        layout.contentDeleteFrom(b.summaryAbsIdx, 1);
+    }
+    // 清理内存
+    batches.delete(id);
+    expandedBatches.delete(id);
+    expandedEntries.delete(id);
+    // 清理 absLineToBatchId 中该 id 的映射
+    if (b.summaryAbsIdx >= 0) {
+        for (const [idx, bid] of absLineToBatchId) {
+            if (bid === id) {
+                absLineToBatchId.delete(idx);
+                break;
+            }
+        }
+    }
+}
 /** 在 batch 收尾时(onToolBatchEnd):写摘要行 + 登记 summaryAbsIdx;若已展开(回放场景)立即插详情。 */
 export function endBatch(id, layout) {
     const b = batches.get(id);
@@ -160,6 +253,26 @@ export function endBatch(id, layout) {
 export function findBatchByAbsLine(absLine) {
     return absLineToBatchId.get(absLine) ?? null;
 }
+export function findBatchHit(absLine) {
+    const summaryId = absLineToBatchId.get(absLine);
+    if (summaryId)
+        return { id: summaryId, entryIndex: null };
+    for (const id of expandedBatches) {
+        const b = batches.get(id);
+        if (!b || absLine <= b.summaryAbsIdx)
+            continue;
+        const open = expandedEntries.get(id) ?? new Set();
+        let row = b.summaryAbsIdx + 1;
+        for (let i = 0; i < b.entries.length; i++) {
+            if (absLine === row)
+                return { id, entryIndex: i };
+            row += 1;
+            if (open.has(i))
+                row += buildExpandedLines([b.entries[i]]).length - 1;
+        }
+    }
+    return null;
+}
 /** 当前 batch 是否已展开。 */
 export function isExpanded(id) {
     return expandedBatches.has(id);
@@ -189,15 +302,34 @@ export function toggleBatch(id, layout) {
         expand(b, layout);
     }
 }
+export function toggleEntry(id, entryIndex, layout) {
+    const b = batches.get(id);
+    if (!b || !expandedBatches.has(id) || !b.entries[entryIndex])
+        return;
+    const open = expandedEntries.get(id) ?? new Set();
+    const oldLines = buildExpandedLines(b.entries, '    ', open);
+    if (open.has(entryIndex))
+        open.delete(entryIndex);
+    else
+        open.add(entryIndex);
+    expandedEntries.set(id, open);
+    const newLines = buildExpandedLines(b.entries, '    ', open);
+    layout.contentDeleteFrom(b.summaryAbsIdx + 1, oldLines.length);
+    layout.contentInsertAfter(b.summaryAbsIdx, newLines);
+}
 function expand(b, layout) {
-    const lines = buildExpandedLines(b.entries);
+    const open = expandedEntries.get(b.id) ?? new Set();
+    expandedEntries.set(b.id, open);
+    const lines = buildExpandedLines(b.entries, '    ', open);
     layout.contentInsertAfter(b.summaryAbsIdx, lines);
     expandedBatches.add(b.id);
 }
 function collapse(b, layout) {
-    const lines = buildExpandedLines(b.entries);
+    const open = expandedEntries.get(b.id) ?? new Set();
+    const lines = buildExpandedLines(b.entries, '    ', open);
     layout.contentDeleteFrom(b.summaryAbsIdx + 1, lines.length);
     expandedBatches.delete(b.id);
+    expandedEntries.delete(b.id);
 }
 /**
  * 当 buffer 中段插/删 N 行后,所有受影响 batch 的 summaryAbsIdx 需平移。

package/dist/ui/content.js

@@ -131,6 +131,11 @@ export function sliceFromEnd(offset, count) {
 export function totalRows() {
     return rows.length + (hasCurrent ? 1 : 0);
 }
+/** 已提交行数(不含 hasCurrent 空行)。供续写位校正:breakRow 后 hasCurrent=true 时光标已在
+ *  rows.length+1 位,若用 totalRows()+1 会多跳 1 行(2 空行 bug)。 */
+export function committedRows() {
+    return rows.length;
+}
 /** 取绝对行索引(0-based,含当前行)的原始自洽行;越界返 null。供鼠标选区文本提取。 */
 export function lineAt(abs) {
     const all = snapshot();

package/dist/ui/layout.js

@@ -47,6 +47,7 @@ let sigwinchHandler = null;
 // 非 md 写(contentWrite)先 commitMd 收尾(清 segMark,后续写不再被 setLines 截断)。
 let mdActive = false;
 let mdBuf = '';
+let mdLeadingBlank = false;
 let selection = null;
 let selecting = false; // 左键按下中(press→release 之间)
 let mouseEnabled = true; // 导航菜单(picker)期间置 false:只吞报表不做选区/滚动,防菜单被 viewport 重画覆盖
@@ -191,13 +192,15 @@ export function contentWrite(s) {
     const bottom = g.contentBottom;
     // resize 后 contentRow 可能过时(拖终端框):
     //  - 缩小:contentRow > 新 bottom → 钳到新 bottom
-    //  - 放大:contentRow < 新 bottom 且回尾 → 推进到 min(total+1, bottom)
-    // total+1 是合法「待写位」(所有行已 breakRow 提交、光标在新空行);用 total 会把续写位拉回到
+    //  - 放大:contentRow < 新 bottom 且回尾 → 推进到 min(committed+1, bottom)
+    // committed+1 是合法「待写位」(所有行已 breakRow 提交、光标在新空行);用 committed 会把续写位拉回到
     // 最后一行 banner/content 上,首次 contentWrite 覆盖 banner(首条消息「插到 logo 下面」bug)。
+    // 注意:不能用 totalRows()+1——breakRow 后 hasCurrent=true,totalRows 已含当前空行,再 +1 会多跳一行,
+    // 导致 onDone 摘要行等写 \n 后的 contentWrite 入口多跳 1 行(2 空行 bug)。
     if (contentRow > bottom)
         contentRow = bottom;
     else if (scrollOffset === 0 && contentRow < bottom) {
-        contentRow = Math.min(content.totalRows() + 1, bottom);
+        contentRow = Math.min(content.committedRows() + 1, bottom);
     }
     const startRow = contentRow;
     const startCol = contentCol;
@@ -310,10 +313,11 @@ export function contentWrite(s) {
     }
 }
 /** 进入 markdown 流式段:标记段起点(layout 续写位 + content.beginSegment),清 accumulator。 */
-function beginMdSegment() {
+function beginMdSegment(leadingBlank = false) {
     segmentStartRow = contentRow;
     content.beginSegment();
     mdBuf = '';
+    mdLeadingBlank = leadingBlank;
     mdActive = true;
 }
 /** 提交 markdown 段:清 accumulator + content.commitSegment(后续非 md 写不再被 setLines 截断)。 */
@@ -322,6 +326,7 @@ function commitMd() {
         return;
     mdActive = false;
     mdBuf = '';
+    mdLeadingBlank = false;
     content.commitSegment();
 }
 // ── Banner(启动横幅/模式切换横幅)固定顶部行 ──
@@ -401,13 +406,15 @@ export function bannerHeight() {
  * 物理重画用 repaintViewport(全内容区,原子一次 write 无闪烁)— md 段是缓冲尾,viewport 显尾即显段。
  * 滚动回看(scrollOffset>0)只更新缓冲不物理写(回尾时显);打字中照常物理写——单次 write 结尾 cup 回输入框,IME 锚定不动。
  */
-export function contentWriteMd(s) {
+export function contentWriteMd(s, leadingBlank = false) {
     if (!active || !ui.isTTY) {
         stdout.write(s);
         return;
     }
     if (!mdActive)
-        beginMdSegment();
+        beginMdSegment(leadingBlank);
+    else if (leadingBlank)
+        mdLeadingBlank = true;
     mdBuf += s;
     const g = getGeo();
     // 滚动回看冻结(同 contentWrite):scrollOffset>0 时 setLines 替换段会改缓冲行数,若 offset 不变,
@@ -415,7 +422,12 @@ export function contentWriteMd(s) {
     // offset += delta(可负:setLines 重渲染可能缩行)冻住视图。md 段在尾,窗口在上方,冻结后不重叠。
     const scrolled = scrollOffset > 0;
     const totalBefore = scrolled ? content.totalRows() : 0;
-    const lines = renderMarkdown(mdBuf, g.cols);
+    // 工具→正文边界由本层统一提供一个空行；模型偶尔自带 \n/\n\n，先剥掉，避免随机叠成两行。
+    const markdownSource = mdLeadingBlank
+        ? mdBuf.replace(/^(?:[ \t]*\r?\n)+/, '')
+        : mdBuf;
+    const rendered = renderMarkdown(markdownSource, g.cols);
+    const lines = mdLeadingBlank ? [ui.reset, ...rendered] : rendered;
     content.setLines(lines);
     const segRows = lines.length;
     const available = g.contentBottom - segmentStartRow + 1;
@@ -467,6 +479,8 @@ export function clearContent() {
     scrollLockUntil = 0;
     mdActive = false;
     mdBuf = '';
+    mdLeadingBlank = false;
+    mdLeadingBlank = false;
     content.reset();
     notifyContentReset(); // batch 渲染器同步重置(batch 摘要行索引全部失效)
     stdout.write(esc.home);
@@ -576,6 +590,12 @@ export function contentDeleteFrom(startIdx, n) {
 export function totalRows() {
     return content.totalRows();
 }
+/** 原位替换一条已提交的内容行并重画；供连续工具链更新同一条 batch 摘要。 */
+export function contentReplaceLine(absIdx, line) {
+    content.replaceHead(absIdx, [line.endsWith(ui.reset) ? line : line + ui.reset]);
+    if (active && scrollOffset === 0)
+        repaintViewport();
+}
 /** 清空内容区时通知 batch 渲染器重置(摘要行映射与展开态)。 */
 export function notifyContentReset() {
     // 动态 import 避免循环;模块级 reset() 只清映射,不动 batch 内部数据(id 与 entries 仍可重用)
@@ -1133,12 +1153,16 @@ function handleMouseEvent(e) {
         void (async () => {
             try {
                 const m = await import('./batch.js');
-                const id = m.findBatchByAbsLine(absClick);
-                if (id) {
-                    m.toggleBatch(id, {
+                const hit = m.findBatchHit(absClick);
+                if (hit) {
+                    const batchLayout = {
                         contentInsertAfter: (after, lines) => contentInsertAfter(after, lines),
                         contentDeleteFrom: (start, n) => contentDeleteFrom(start, n),
-                    });
+                    };
+                    if (hit.entryIndex === null)
+                        m.toggleBatch(hit.id, batchLayout);
+                    else
+                        m.toggleEntry(hit.id, hit.entryIndex, batchLayout);
                     selection = null;
                     repaintViewport();
                     repaint();
@@ -1422,11 +1446,13 @@ export function paintLiveAtCursor(text) {
     //    首次 contentWrite 覆盖 banner(首条消息「插到 logo 下面」bug)。
     // 否则 cup 到旧行号→帧画在屏幕中间(旧 bottom 位置),而非内容末尾/最底部。
     const g = getGeo();
-    const total = content.totalRows();
+    const committed = content.committedRows();
     if (contentRow > g.contentBottom)
         contentRow = g.contentBottom;
     if (scrollOffset === 0 && contentRow < g.contentBottom) {
-        contentRow = Math.min(total + 1, g.contentBottom);
+        // 用 committed+1 而非 total+1:breakRow 后 hasCurrent=true,totalRows 已含当前空行,+1 会多跳一行
+        // (contentWrite 入口的同类逻辑已同步修正,见上方注释)。
+        contentRow = Math.min(committed + 1, g.contentBottom);
     }
     let out = '';
     if (frameRow && (frameRow !== contentRow || frameCol !== contentCol)) {
@@ -1846,6 +1872,7 @@ export function enterAltScreen() {
     scrollLockUntil = 0;
     mdActive = false;
     mdBuf = '';
+    mdLeadingBlank = false;
     selection = null;
     selecting = false;
     content.reset();
@@ -1859,13 +1886,14 @@ export function enterAltScreen() {
         // 重画 repaintViewport 防抖(下面 timer),避免连续拖动闪烁;但行号/区域必须立即正确。
         const g = getGeo(footerH);
         const total = content.totalRows();
+        const committed = content.committedRows();
         // 缩小:contentRow > 新 bottom → 钳到新 bottom
         if (contentRow > g.contentBottom)
             contentRow = g.contentBottom;
-        // 放大:contentRow < 新 bottom 且回尾(offset=0)→ 推进到 min(total+1, bottom)
-        //    total+1 是合法「待写位」;用 total 会把续写位拉回最后一行,首次 contentWrite 覆盖 banner
+        // 放大:contentRow < 新 bottom 且回尾(offset=0)→ 推进到 min(committed+1, bottom)
+        //    committed+1 是合法「待写位」;用 total+1 在 hasCurrent=true(breakRow 后)时会多跳一行。
         if (scrollOffset === 0 && contentRow < g.contentBottom) {
-            contentRow = Math.min(total + 1, g.contentBottom);
+            contentRow = Math.min(committed + 1, g.contentBottom);
         }
         if (frameRow && frameRow > g.contentBottom)
             frameRow = g.contentBottom;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mocode-ai",
-  "version": "0.5.2",
+  "version": "0.5.4",
   "description": "终端编码 agent:LLM + tool-call 循环 + 流式输出(含思考)+ 16 个工具,接任意 OpenAI 兼容后端。",
   "type": "module",
   "bin": {