mocode-ai 0.5.4 → 0.5.5

package/dist/ui/batch.js

@@ -17,29 +17,26 @@ const batches = new Map();
  *  buffer 行数变化时本表可能漂移——但只在 insertAfter/deleteFrom 后由本模块同步更新,
  *  并保持 buffer 当前状态对应。 */
 const absLineToBatchId = new Map();
-/** 已展开的 batch id;默认空(全折叠);layout.mouse release 点击摘要行时切。
- *  含 mutation 的 batch 不在此 set——它们走 forceExpanded 永远展开,与 toggle 隔离。 */
+/** 第一层展开后，工具概要行的绝对索引 → 对应 entry。 */
+const absLineToEntry = new Map();
+/** 已展开第一层工具列表的 batch id。 */
 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']);
-function isMutationTool(name) {
-    return MUTATION_TOOLS.has(name);
-}
 /** 展开时完整输出的最大行数;超出截断,避免巨型输出撑爆 viewport。 */
 const MAX_EXPAND_LINES = 200;
+export function isMutationToolName(name) {
+    return name === 'write_file' || name === 'edit_file';
+}
 /** 通知 buffer 整体清空(clearContent / exitAltScreen / 新一轮 turn)——本模块状态同步归零。 */
 export function reset() {
     batches.clear();
     absLineToBatchId.clear();
+    absLineToEntry.clear();
     expandedBatches.clear();
-    expandedEntries.clear();
 }
 /** 新建一个 batch(在 agent 拿到第一条 onToolHeader 时调)。返回 id。 */
 export function beginBatch() {
     const id = `b${++_idCounter}`;
-    batches.set(id, { id, summaryAbsIdx: -1, entries: [], forceExpanded: false });
+    batches.set(id, { id, summaryAbsIdx: -1, entries: [], expandedEntries: new Set() });
     return id;
 }
 /** 记一条工具调用(在 onToolHeader 时调,与 setEntryResult 配对;entries 顺序 = agent 调用顺序)。 */
@@ -80,7 +77,9 @@ function buildSummaryLine(entries) {
     }
     if (entries.length === 1) {
         const e = entries[0];
-        return `  ${ui.bold}${ui.accent}●${ui.reset} ${ui.accent}${e.name}${ui.reset}  ${ui.dim}${e.callSummary}${ui.reset}`;
+        // 实时摘要必须稳定保持单行；完整参数放在第一层工具概要中，避免长 JSON 自动折行后
+        // 原地刷新只能覆盖最后一条物理行、残留旧摘要前半段。
+        return `  ${ui.bold}${ui.accent}●${ui.reset} ${ui.dim}Ran 1 tool · ${e.name} 1${ui.reset}`;
     }
     // N>1:同类合并 "read_file 3, glob 1, grep 1"
     const counts = new Map();
@@ -91,151 +90,57 @@ 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 = '    ', openEntries) {
+function buildEntryDetailLines(e, indent = '      ') {
     const lines = [];
-    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,终端合并即可)。
-            const block = e.diffBlock.endsWith('\n') ? e.diffBlock : e.diffBlock + '\n';
-            for (const line of block.split('\n')) {
-                if (line === '' && lines.length > 0 && lines[lines.length - 1] === '')
-                    continue; // 折叠连续空行
-                if (line === '' && lines.length > 0)
-                    continue; // 跳过首尾空行(diff 头/尾换行)
-                lines.push(line.endsWith('\x1B[0m') ? line : line + '\x1B[0m');
-            }
+    if (e.diffBlock) {
+        // diff 块多行文本(由 renderFileChange 渲染);按 \n 拆成物理行,
+        // 每行单独入 rows[]。行末 reset 由本函数统一追加(若原行已带 reset,终端合并即可)。
+        const block = e.diffBlock.endsWith('\n') ? e.diffBlock : e.diffBlock + '\n';
+        for (const line of block.split('\n')) {
+            if (line === '' && lines.length > 0 && lines[lines.length - 1] === '')
+                continue; // 折叠连续空行
+            if (line === '' && lines.length > 0)
+                continue; // 跳过首尾空行(diff 头/尾换行)
+            lines.push(line.endsWith('\x1B[0m') ? line : line + '\x1B[0m');
         }
-        else if (e.fullOutput) {
-            // 完整工具输出(纯文本):按行展开,每行缩进 + dim 样式;长输出截断到 MAX_EXPAND_LINES 行
-            const rawLines = e.fullOutput.split('\n');
-            const truncated = rawLines.length > MAX_EXPAND_LINES;
-            const displayLines = truncated ? rawLines.slice(0, MAX_EXPAND_LINES) : rawLines;
-            for (const line of displayLines) {
-                lines.push(`${indent}${ui.gray}${line}${ui.reset}\x1B[0m`);
-            }
-            if (truncated) {
-                lines.push(`${indent}${ui.dim}… (${rawLines.length - MAX_EXPAND_LINES} more lines)${ui.reset}\x1B[0m`);
-            }
+    }
+    else if (e.fullOutput) {
+        // 完整工具输出(纯文本):按行展开,每行缩进 + dim 样式;长输出截断到 MAX_EXPAND_LINES 行
+        const rawLines = e.fullOutput.split('\n');
+        const truncated = rawLines.length > MAX_EXPAND_LINES;
+        const displayLines = truncated ? rawLines.slice(0, MAX_EXPAND_LINES) : rawLines;
+        for (const line of displayLines) {
+            lines.push(`${indent}${ui.gray}${line}${ui.reset}\x1B[0m`);
         }
-        else if (e.resultSummary) {
-            lines.push(`${indent}${ui.gray}↳ ${e.resultSummary}${ui.reset}\x1B[0m`);
+        if (truncated) {
+            lines.push(`${indent}${ui.dim}… (${rawLines.length - MAX_EXPAND_LINES} more lines)${ui.reset}\x1B[0m`);
         }
     }
+    else if (e.resultSummary) {
+        lines.push(`${indent}${ui.gray}↳ ${e.resultSummary}${ui.reset}\x1B[0m`);
+    }
     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;
-            }
-        }
-    }
+/** 第一层只展示有哪些调用及其简短结果，不展开完整输出。 */
+function buildExpandedLines(entries, indent = '    ') {
+    return entries.map((e) => {
+        const result = e.resultSummary ? `  ${ui.gray}↳ ${e.resultSummary}${ui.reset}` : '';
+        return `${indent}${ui.bold}${ui.accent}●${ui.reset} ${ui.accent}${e.name}${ui.reset}  ${ui.dim}${e.callSummary}${ui.reset}${result}\x1B[0m`;
+    });
 }
 /** 在 batch 收尾时(onToolBatchEnd):写摘要行 + 登记 summaryAbsIdx;若已展开(回放场景)立即插详情。 */
 export function endBatch(id, layout) {
     const b = batches.get(id);
-    if (!b || b.summaryAbsIdx >= 0)
-        return; // 幂等
-    // 含 mutation(write_file/edit_file)时强制展开——写盘操作必须让用户看到 diff
-    b.forceExpanded = b.entries.some((e) => isMutationTool(e.name));
-    // 单条 mutation 调用:摘要行("● edit_file path")与展开详情头逐字重复,跳过摘要行、只写详情
-    // (N>1 时摘要行是聚合信息 "Ran N tools · ...",与详情不重复,两者照常都写)。
-    if (b.forceExpanded && b.entries.length === 1) {
-        // 无摘要行可当父行,详情头改用顶层 2 空格缩进(与 buildSummaryLine/diff head 对齐,而非嵌套的 4 空格)
-        const lines = buildExpandedLines(b.entries, '  ');
-        layout.contentWrite(lines.join('\n') + '\n');
-        b.summaryAbsIdx = Math.max(0, layout.totalRows() - 1 - lines.length);
+    if (!b)
+        return;
+    if (b.summaryAbsIdx >= 0) {
+        layout.contentReplaceLine?.(b.summaryAbsIdx, buildSummaryLine(b.entries));
+        // 执行阶段只展示实时摘要；到 endBatch 才开放点击，避免未完成 batch 的第一层列表失步。
         absLineToBatchId.set(b.summaryAbsIdx, b.id);
-        expandedBatches.add(b.id); // 已展开;防止 toggleBatch 再次 expand() 造成重复插入
         return;
     }
     const summary = buildSummaryLine(b.entries);
@@ -244,35 +149,31 @@ export function endBatch(id, layout) {
     // 摘要行绝对索引 = totalRows - 2(hasCurrent 那行是新空行)
     b.summaryAbsIdx = Math.max(0, layout.totalRows() - 2);
     absLineToBatchId.set(b.summaryAbsIdx, b.id);
-    // forceExpanded 时立刻展开(让 diff 在收尾后立即可见,无需点击)
-    if (b.forceExpanded) {
-        expand(b, layout);
+}
+/**
+ * 工具执行中立即显示/刷新摘要，但暂不登记点击命中；endBatch 收尾后才开放两层展开。
+ */
+export function showLiveBatch(id, layout) {
+    const b = batches.get(id);
+    if (!b)
+        return;
+    const summary = buildSummaryLine(b.entries);
+    if (b.summaryAbsIdx < 0) {
+        layout.contentWrite(summary + '\n');
+        b.summaryAbsIdx = Math.max(0, layout.totalRows() - 2);
+        // 首条摘要通过增量 contentWrite 落屏时，markdown→普通内容的边界可能只更新了
+        // buffer/续写位；直到第二个 header 的 contentReplaceLine 或后续正文重绘才完全可见。
+        // 立即按 buffer 原子重画，确保慢工具执行期间摘要前的空行已经显示。
+        layout.repaintViewport?.();
+    }
+    else {
+        layout.contentReplaceLine(b.summaryAbsIdx, summary);
     }
 }
 /** 绝对行索引 → 命中 batch id(用于鼠标 release 反查);非摘要行返 null。 */
 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);
@@ -283,18 +184,11 @@ export function isExpanded(id) {
  * 展开:把详情行插入摘要行下方(mid-buffer insert)。
  * 同步更新 absLineToBatchId 中所有受影响的索引:
  *   - 删除/插入点之后的 batch 摘要行索引相应平移。
- * 含 mutation(write_file/edit_file)的 batch 强制展开——不允许折叠(写盘操作必须始终可见)。
  */
 export function toggleBatch(id, layout) {
     const b = batches.get(id);
     if (!b)
         return;
-    if (b.forceExpanded) {
-        // 写盘操作的 batch 强制展开,toggle 拒绝折叠(用户能看到完整 diff 即用)
-        if (!expandedBatches.has(id))
-            expand(b, layout);
-        return;
-    }
     if (expandedBatches.has(id)) {
         collapse(b, layout);
     }
@@ -302,34 +196,67 @@ 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 open = expandedEntries.get(b.id) ?? new Set();
-    expandedEntries.set(b.id, open);
-    const lines = buildExpandedLines(b.entries, '    ', open);
+    const lines = buildExpandedLines(b.entries);
     layout.contentInsertAfter(b.summaryAbsIdx, lines);
     expandedBatches.add(b.id);
+    for (let i = 0; i < b.entries.length; i++) {
+        absLineToEntry.set(b.summaryAbsIdx + 1 + i, { batchId: b.id, entryIndex: i });
+    }
+}
+/** mutation 独占 batch 收尾后立即展示其调用概要和 diff。 */
+export function expandSingleEntryFully(id, layout) {
+    const b = batches.get(id);
+    if (!b || b.entries.length !== 1 || expandedBatches.has(id))
+        return;
+    const lines = [
+        ...buildExpandedLines(b.entries),
+        ...buildEntryDetailLines(b.entries[0]),
+    ];
+    layout.contentInsertAfter(b.summaryAbsIdx, lines);
+    expandedBatches.add(id);
+    b.expandedEntries.add(0);
+    absLineToEntry.set(b.summaryAbsIdx + 1, { batchId: id, entryIndex: 0 });
 }
 function collapse(b, layout) {
-    const open = expandedEntries.get(b.id) ?? new Set();
-    const lines = buildExpandedLines(b.entries, '    ', open);
-    layout.contentDeleteFrom(b.summaryAbsIdx + 1, lines.length);
+    let lineCount = b.entries.length;
+    for (const i of b.expandedEntries)
+        lineCount += buildEntryDetailLines(b.entries[i]).length;
+    layout.contentDeleteFrom(b.summaryAbsIdx + 1, lineCount);
     expandedBatches.delete(b.id);
-    expandedEntries.delete(b.id);
+    b.expandedEntries.clear();
+    for (const [idx, target] of absLineToEntry) {
+        if (target.batchId === b.id)
+            absLineToEntry.delete(idx);
+    }
+}
+/** 绝对行索引 → 第一层中的具体工具调用。 */
+export function findEntryByAbsLine(absLine) {
+    return absLineToEntry.get(absLine) ?? null;
+}
+/** 第二层：只展开/折叠某一个工具的完整输出。 */
+export function toggleEntry(batchId, entryIndex, layout) {
+    const b = batches.get(batchId);
+    if (!b || !expandedBatches.has(batchId))
+        return;
+    let headerIdx = -1;
+    for (const [idx, target] of absLineToEntry) {
+        if (target.batchId === batchId && target.entryIndex === entryIndex)
+            headerIdx = idx;
+    }
+    if (headerIdx < 0)
+        return;
+    const details = buildEntryDetailLines(b.entries[entryIndex]);
+    if (details.length === 0)
+        return;
+    if (b.expandedEntries.has(entryIndex)) {
+        layout.contentDeleteFrom(headerIdx + 1, details.length);
+        b.expandedEntries.delete(entryIndex);
+    }
+    else {
+        layout.contentInsertAfter(headerIdx, details);
+        b.expandedEntries.add(entryIndex);
+    }
 }
 /**
  * 当 buffer 中段插/删 N 行后,所有受影响 batch 的 summaryAbsIdx 需平移。
@@ -354,6 +281,21 @@ export function shiftBatchesAfter(absIdx, delta) {
     absLineToBatchId.clear();
     for (const [k, v] of next)
         absLineToBatchId.set(k, v);
+    const nextEntries = new Map();
+    // expand() 先插入整组概要行、再登记其命中位置；layout 随后的异步 shift 通知不应把
+    // 这批“刚插入”的概要行再次平移。插入单个工具详情时 absIdx 不是 summary，仍正常平移。
+    const insertedOverviewBatch = delta > 0
+        ? [...batches.values()].find((b) => b.summaryAbsIdx === absIdx && expandedBatches.has(b.id))?.id
+        : undefined;
+    for (const [idx, target] of absLineToEntry) {
+        const isNewOverviewLine = target.batchId === insertedOverviewBatch;
+        const newIdx = idx > absIdx && !isNewOverviewLine ? idx + delta : idx;
+        if (newIdx >= 0)
+            nextEntries.set(newIdx, target);
+    }
+    absLineToEntry.clear();
+    for (const [k, v] of nextEntries)
+        absLineToEntry.set(k, v);
     // 同步每个 batch 的 summaryAbsIdx
     for (const b of batches.values()) {
         if (b.summaryAbsIdx > absIdx)
@@ -364,21 +306,14 @@ export function shiftBatchesAfter(absIdx, delta) {
 /** 把已构造好的 BatchEntry[] 直接落成摘要行(用于 renderHistory 回放;不记录 id 也不需可切换)。
  *  含 mutation(write_file/edit_file)时整批展开——与实时 endBatch 行为一致。 */
 export function writeSummaryOnly(entries, layout) {
-    const hasMutation = entries.some((e) => isMutationTool(e.name));
-    // 单条 mutation:同 endBatch,摘要行与展开详情头重复,跳过摘要行只写详情
-    if (hasMutation && entries.length === 1) {
-        const lines = buildExpandedLines(entries, '  ');
-        layout.contentWrite(lines.join('\n') + '\n');
+    const id = beginBatch();
+    const b = batches.get(id);
+    if (!b)
         return;
-    }
-    layout.contentWrite(buildSummaryLine(entries) + '\n');
-    if (hasMutation) {
-        // 回放时同步展开:重新调 expand 路径需要 BatchRecord,此处直接拼 line 插入
-        const summaryIdx = Math.max(0, layout.totalRows() - 2);
-        const lines = buildExpandedLines(entries);
-        layout.contentInsertAfter(summaryIdx, lines);
-        // 不入 batches/absLineToBatchId/expandedBatches——回放行不支持点击 toggle(设计取舍:
-        // 简化模型;若需要支持回放也可展开/折叠,可在 alt-screen 启动时建一张临时映射)
+    b.entries = entries;
+    endBatch(id, layout);
+    if (entries.length === 1 && isMutationToolName(entries[0].name)) {
+        expandSingleEntryFully(id, layout);
     }
 }
 let _idCounter = 0;

package/dist/ui/content.js

@@ -141,6 +141,12 @@ export function lineAt(abs) {
     const all = snapshot();
     return abs >= 0 && abs < all.length ? all[abs] : null;
 }
+/** 等长替换一条已提交物理行，供运行中的工具 batch 原地刷新摘要。 */
+export function replaceLine(abs, line) {
+    if (abs < 0 || abs >= rows.length)
+        return;
+    rows[abs] = line.endsWith('\x1B[0m') ? line : line + '\x1B[0m';
+}
 /**
  * 找「绝对行索引 < absStart 的最近一条用户消息」的文本(用于滚动回看时的「我刚发的
  * 请求」sticky banner)。算法:从 absStart - 1 往上扫,识别「用户气泡行」(由 repl

package/dist/ui/layout.js

@@ -1,5 +1,5 @@
 import { stdin, stdout } from 'node:process';
-import { charWidth, displayWidth, truncateDisplay, truncateDisplayHead, ansiDisplayWidth, wrapByDisplayWidth, fmtElapsed, stripAnsi, sliceByDisplayCol, } from './render.js';
+import { charWidth, displayWidth, truncateDisplay, truncateDisplayHead, truncateAnsi, ansiDisplayWidth, wrapByDisplayWidth, fmtElapsed, stripAnsi, sliceByDisplayCol, } from './render.js';
 import { ui } from './theme.js';
 import * as content from './content.js';
 import * as mouse from './mouse.js';
@@ -47,7 +47,6 @@ 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 重画覆盖
@@ -313,11 +312,10 @@ export function contentWrite(s) {
     }
 }
 /** 进入 markdown 流式段:标记段起点(layout 续写位 + content.beginSegment),清 accumulator。 */
-function beginMdSegment(leadingBlank = false) {
+function beginMdSegment() {
     segmentStartRow = contentRow;
     content.beginSegment();
     mdBuf = '';
-    mdLeadingBlank = leadingBlank;
     mdActive = true;
 }
 /** 提交 markdown 段:清 accumulator + content.commitSegment(后续非 md 写不再被 setLines 截断)。 */
@@ -326,7 +324,6 @@ function commitMd() {
         return;
     mdActive = false;
     mdBuf = '';
-    mdLeadingBlank = false;
     content.commitSegment();
 }
 // ── Banner(启动横幅/模式切换横幅)固定顶部行 ──
@@ -406,15 +403,13 @@ export function bannerHeight() {
  * 物理重画用 repaintViewport(全内容区,原子一次 write 无闪烁)— md 段是缓冲尾,viewport 显尾即显段。
  * 滚动回看(scrollOffset>0)只更新缓冲不物理写(回尾时显);打字中照常物理写——单次 write 结尾 cup 回输入框,IME 锚定不动。
  */
-export function contentWriteMd(s, leadingBlank = false) {
+export function contentWriteMd(s) {
     if (!active || !ui.isTTY) {
         stdout.write(s);
         return;
     }
     if (!mdActive)
-        beginMdSegment(leadingBlank);
-    else if (leadingBlank)
-        mdLeadingBlank = true;
+        beginMdSegment();
     mdBuf += s;
     const g = getGeo();
     // 滚动回看冻结(同 contentWrite):scrollOffset>0 时 setLines 替换段会改缓冲行数,若 offset 不变,
@@ -422,12 +417,7 @@ export function contentWriteMd(s, leadingBlank = false) {
     // offset += delta(可负:setLines 重渲染可能缩行)冻住视图。md 段在尾,窗口在上方,冻结后不重叠。
     const scrolled = scrollOffset > 0;
     const totalBefore = scrolled ? content.totalRows() : 0;
-    // 工具→正文边界由本层统一提供一个空行；模型偶尔自带 \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;
+    const lines = renderMarkdown(mdBuf, g.cols);
     content.setLines(lines);
     const segRows = lines.length;
     const available = g.contentBottom - segmentStartRow + 1;
@@ -479,8 +469,6 @@ export function clearContent() {
     scrollLockUntil = 0;
     mdActive = false;
     mdBuf = '';
-    mdLeadingBlank = false;
-    mdLeadingBlank = false;
     content.reset();
     notifyContentReset(); // batch 渲染器同步重置(batch 摘要行索引全部失效)
     stdout.write(esc.home);
@@ -590,11 +578,15 @@ export function contentDeleteFrom(startIdx, n) {
 export function totalRows() {
     return content.totalRows();
 }
-/** 原位替换一条已提交的内容行并重画；供连续工具链更新同一条 batch 摘要。 */
+/** 原地刷新一条内容行（行数不变），用于运行中的工具 batch 更新计数。 */
 export function contentReplaceLine(absIdx, line) {
-    content.replaceHead(absIdx, [line.endsWith(ui.reset) ? line : line + ui.reset]);
-    if (active && scrollOffset === 0)
-        repaintViewport();
+    if (!active)
+        return;
+    // 原地更新的 batch 摘要可能随追加工具而变长。缓冲区仍把它当作一行，但若直接
+    // 交给终端超过 cols，终端会自动折行，造成视觉上多出空行且续写位与缓冲失步。
+    // 在写回缓冲前按 ANSI 可见宽度截断，确保“一条逻辑行 = 一条物理行”。
+    content.replaceLine(absIdx, truncateAnsi(line, getGeo().cols));
+    repaintViewport();
 }
 /** 清空内容区时通知 batch 渲染器重置(摘要行映射与展开态)。 */
 export function notifyContentReset() {
@@ -1153,18 +1145,25 @@ function handleMouseEvent(e) {
         void (async () => {
             try {
                 const m = await import('./batch.js');
-                const hit = m.findBatchHit(absClick);
-                if (hit) {
-                    const batchLayout = {
+                const entry = m.findEntryByAbsLine(absClick);
+                if (entry) {
+                    // 先清选区再改 buffer：contentInsert/Delete 内会立即 repaintViewport；若此时仍保留
+                    // 旧绝对行选区，会短暂画出一帧错位高亮，随后二次重画，视觉上就是抖动。
+                    selection = null;
+                    m.toggleEntry(entry.batchId, entry.entryIndex, {
                         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);
+                    });
+                    repaint();
+                    return;
+                }
+                const id = m.findBatchByAbsLine(absClick);
+                if (id) {
                     selection = null;
-                    repaintViewport();
+                    m.toggleBatch(id, {
+                        contentInsertAfter: (after, lines) => contentInsertAfter(after, lines),
+                        contentDeleteFrom: (start, n) => contentDeleteFrom(start, n),
+                    });
                     repaint();
                     return;
                 }
@@ -1872,7 +1871,6 @@ export function enterAltScreen() {
     scrollLockUntil = 0;
     mdActive = false;
     mdBuf = '';
-    mdLeadingBlank = false;
     selection = null;
     selecting = false;
     content.reset();

package/dist/ui/markdown.js

@@ -574,6 +574,11 @@ function renderMarkdownImpl(text, cols) {
     flushPara();
     if (inFence)
         flushCode(); // EOF 仍 inFence:流式中未闭合 fence → 照常 emit 进行中代码块
+    // 独立 markdown 段的外部间距由 agent/batch 边界统一管理。流式后端可能把
+    // "\n\n" 与首段正文拆成不同 chunk；仅清洗首个正文 chunk 不够，因为 mdBuf
+    // 累积重渲染时这些换行仍会变成段首空行。这里最终兜底，正文段永不自带前导空行。
+    while (out.length > 0 && out[0] === '')
+        out.shift();
     // 末尾不留空行:agent onText 后接 onToolCall 的 contentWrite('\n') 会补 1 空行分隔正文与 ● 行;
     // 若 md 末尾自带空行(段落/代码块后)则叠成 2 空行。裁掉末尾连续空行,让 onToolCall / 轮末
     // contentWrite('\n') 恰好补 1 行(与改造前 raw 文本行为一致)。块间空行(flushPara/flushCode 中段

package/package.json

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