mocode-ai 1.7.5 → 1.7.7

package/dist/agent/run-coordinator.js

@@ -11,7 +11,7 @@ import { defaultAgentRuntimeContext } from './runtime-context.js';
 import { runModelTurn } from './model-turn.js';
 import { runToolTurn } from './tool-turn.js';
 import { createTurnLifecycle } from './turn-lifecycle.js';
-import { parseArgs, argumentErrorHint, isParallelTool, isParallelOrchestrationCall, isResourceLockedCall, deniedOutcome, readDiffContext, pushToolResult, } from './tool-helpers.js';
+import { parseArgs, argumentErrorHint, isParallelTool, isParallelOrchestrationCall, isResourceLockedCall, deniedOutcome, readDiffContext, pushToolResult, unregisteredToolOutcome, } from './tool-helpers.js';
 import { contextState, summarizeToolArguments } from '../session/index.js';
 import { createReadDedup } from '../tools/read-dedup.js';
 import { createBudgetScheduler } from '../session/scheduler.js';
@@ -424,10 +424,14 @@ export async function runAgentCoreLegacy(opts, historyManager, stages) {
                                             const tc = calls[index];
                                             const outcome = {
                                                 status: 'denied',
-                                                code: 'TOOL_DISABLED',
+                                                code: isToolDeniedForStep(tc.name) && !ctx.toolRuntime.findTool(tc.name)
+                                                    ? 'UNKNOWN_TOOL'
+                                                    : 'TOOL_DISABLED',
                                                 retryable: false,
                                                 output: isToolDeniedForStep(tc.name)
-                                                    ? `错误:当前 tool policy snapshot 不允许调用 ${tc.name}。`
+                                                    ? !ctx.toolRuntime.findTool(tc.name)
+                                                        ? unregisteredToolOutcome(tc.name, ctx.toolRuntime).output
+                                                        : `错误:当前 tool policy snapshot 不允许调用 ${tc.name}。`
                                                     : `错误:add_tool_groups 不能与写/执行工具 ${tc.name} 同批执行，本 step 已跳过该调用（其余只读调用与扩容已正常处理）；请在下一 step 重试 ${tc.name}。`,
                                                 changedFiles: [],
                                                 durationMs: 0,
@@ -526,10 +530,14 @@ export async function runAgentCoreLegacy(opts, historyManager, stages) {
                                     const currentCall = calls[i];
                                     if (isToolDeniedForStep(currentCall.name)) {
                                         hooks.onToolHeader?.(currentCall);
-                                        const error = t('task.disabled');
+                                        // registry 中根本不存在的名字(模型幻觉/拼写错误)给专门纠错提示,
+                                        // 不再复用 task.disabled 的 /subagent 误导文案;已注册但本步不允许才用 gate 文案。
+                                        const error = !ctx.toolRuntime.findTool(currentCall.name)
+                                            ? unregisteredToolOutcome(currentCall.name, ctx.toolRuntime).output
+                                            : t('task.disabled');
                                         const outcome = {
                                             status: 'denied',
-                                            code: 'TOOL_DISABLED',
+                                            code: !ctx.toolRuntime.findTool(currentCall.name) ? 'UNKNOWN_TOOL' : 'TOOL_DISABLED',
                                             retryable: false,
                                             output: error,
                                             changedFiles: [],

package/dist/agent/stages/history-manager.js

@@ -5,11 +5,19 @@ function replaceMessages(backing, messages) {
     backing.push(...replacement);
 }
 function assistantMessage(turn) {
+    const hasToolCalls = turn.toolCalls.length > 0;
     const message = {
         role: 'assistant',
-        content: turn.content,
+        // 无 tool_calls 时 content 不能是 null:那是 OpenAI 自己吐 tool_call 时的规范形状,
+        // 纯文本轮次写 null 会被严格 OpenAI 兼容网关整请求 400(实测 speedbear:
+        // "messages[N].content 不能为 null … 无文本请传空字符串"),且消息一旦落进 history
+        // 就每轮重发 → 整个会话永久中毒,换个会话同模型却正常。来源是 SSE 流中途结束
+        // (网关掐断)时 SDK 不抛错、content 停在 null 而 tool_calls 为空,框架仍当
+        // 「agent 完成了这一轮」写盘。构造点在此收敛,transport 边界另有兜底
+        // (src/llm/message-shape.ts)负责让存量中毒会话自愈。
+        content: !hasToolCalls && turn.content === null ? '' : turn.content,
     };
-    if (turn.toolCalls.length > 0) {
+    if (hasToolCalls) {
         // thoughtSignature 不是 OpenAI 字段，是 mocode 给 Gemini/Vertex 透传用的；
         // 挂在 tool_call 上随 history 落盘/回灌，Vertex encoder 会读回它。
         message.tool_calls = turn.toolCalls.map((call) => ({

package/dist/agent/stages/tool-dispatcher.js

@@ -7,7 +7,7 @@ import { summarizeToolArguments } from '../../session/index.js';
 import { getPlanDisabledTools } from '../../tools/constants.js';
 import { defaultToolRuntime } from '../../tools/registry.js';
 import { validateToolArguments } from '../../tools/validation.js';
-import { deniedOutcome, isParallelTool, isParallelOrchestrationCall, isResourceLockedCall, parseArgs, readDiffContext, } from '../tool-helpers.js';
+import { deniedOutcome, isParallelTool, isParallelOrchestrationCall, isResourceLockedCall, parseArgs, readDiffContext, unregisteredToolOutcome, } from '../tool-helpers.js';
 const DEFAULT_DEPENDENCIES = {
     toolRuntime: defaultToolRuntime,
     checkPermission: defaultCheckPermission,
@@ -119,10 +119,12 @@ class LegacyCompatibleToolDispatcher {
                     const call = calls[index];
                     const outcome = {
                         status: 'denied',
-                        code: 'TOOL_DISABLED',
+                        code: request.isDenied(call.name) && !toolRuntime.findTool(call.name) ? 'UNKNOWN_TOOL' : 'TOOL_DISABLED',
                         retryable: false,
                         output: request.isDenied(call.name)
-                            ? `错误:当前 tool policy snapshot 不允许调用 ${call.name}。`
+                            ? !toolRuntime.findTool(call.name)
+                                ? unregisteredToolOutcome(call.name, toolRuntime).output
+                                : `错误:当前 tool policy snapshot 不允许调用 ${call.name}。`
                             : `错误:add_tool_groups 不能与写/执行工具 ${call.name} 同批执行，本 step 已跳过该调用（其余只读调用与扩容已正常处理）；请在下一 step 重试 ${call.name}。`,
                         changedFiles: [],
                         durationMs: 0,
@@ -213,10 +215,12 @@ class LegacyCompatibleToolDispatcher {
             const current = calls[index];
             if (request.isDenied(current.name)) {
                 request.onEvent({ type: 'header', call: current });
-                const output = t('task.disabled');
+                // registry 中不存在的名字(幻觉/拼写错误)给纠错提示,不误导用户去开 /subagent。
+                const unregistered = !toolRuntime.findTool(current.name);
+                const output = unregistered ? unregisteredToolOutcome(current.name, toolRuntime).output : t('task.disabled');
                 const outcome = {
                     status: 'denied',
-                    code: 'TOOL_DISABLED',
+                    code: unregistered ? 'UNKNOWN_TOOL' : 'TOOL_DISABLED',
                     retryable: false,
                     output,
                     changedFiles: [],

package/dist/agent/tool-helpers.js

@@ -16,6 +16,7 @@ import { capToolResultForHistory } from '../session/compact.js';
 import { recordArtifact, knownEditTargets } from '../context/index.js';
 import { isToolResultSuccess } from '../context/utils.js';
 import { appendGuiAction } from '../session/gui-actions.js';
+import { t } from '../i18n/index.js';
 /** 解析工具 arguments JSON;非法或空返 null(调用方据此降级到普通 preview)。 */
 export function parseArgs(raw) {
     try {
@@ -76,6 +77,52 @@ export function deniedOutcome(name) {
         output: `错误:用户拒绝了工具 ${name} 的执行。`,
     };
 }
+/** 编辑距离(Levenshtein);名字很短时用上限截断避免 O(n²) 浪费。 */
+function editDistance(a, b, max = 4) {
+    if (Math.abs(a.length - b.length) > max)
+        return max + 1;
+    const prev = new Array(b.length + 1);
+    const curr = new Array(b.length + 1);
+    for (let j = 0; j <= b.length; j++)
+        prev[j] = j;
+    for (let i = 1; i <= a.length; i++) {
+        curr[0] = i;
+        let rowMin = curr[0];
+        for (let j = 1; j <= b.length; j++) {
+            curr[j] = Math.min(prev[j] + 1, curr[j - 1] + 1, prev[j - 1] + (a[i - 1] === b[j - 1] ? 0 : 1));
+            if (curr[j] < rowMin)
+                rowMin = curr[j];
+        }
+        if (rowMin > max)
+            return max + 1;
+        for (let j = 0; j <= b.length; j++)
+            prev[j] = curr[j];
+    }
+    return prev[b.length];
+}
+/**
+ * 未注册工具名(模型幻觉/拼写错误)的专门 denied 结果。
+ * isToolDeniedForStep 对不在 allowedToolNames 里的一切名字(含 registry 中不存在的)都返回
+ * true,旧路径一律复用 task.disabled 文案,误导用户去开 /subagent。此 helper 先查 registry:
+ * 名字根本不存在时给出「未注册 + 相近候选」的纠错提示;存在但本步不允许时才回落 gate 文案。
+ */
+export function unregisteredToolOutcome(name, toolRuntime) {
+    const registered = toolRuntime.tools.map((tool) => tool.name);
+    const ranked = registered
+        .map((candidate) => ({
+        candidate,
+        distance: editDistance(name.toLowerCase(), candidate.toLowerCase()),
+    }))
+        .sort((x, y) => x.distance - y.distance);
+    const close = ranked.filter((entry) => entry.distance <= 3).slice(0, 3);
+    const suggestions = close.length > 0 ? close.map((entry) => entry.candidate).join(', ') : t('toolError.noCloseMatch');
+    return {
+        status: 'denied',
+        code: 'UNKNOWN_TOOL',
+        retryable: false,
+        output: t('toolError.unregistered', { name, suggestions }),
+    };
+}
 /** mutation 执行前读旧内容供 diff:write_file 取整文件旧内容(不存在→null=新建),
  * edit_file 取 old_string 起始行号(供 diff 显示真实文件行号)。读不到则 diff 退化为相对行号。
  * 非 mutation 或参数非法返 { preWriteOld: null, editStartLine: 1 }。失败不阻断。 */

package/dist/context/vision-window.js

@@ -22,6 +22,13 @@ const ATTACHMENT_TAIL = '. Analyze the attached image content directly.';
 const UNKNOWN_FRAME_NAME = 'frame';
 /** 恢复提示只写进**第一条**被剪占位,避免 N 条占位重复同一句话侵蚀 token。 */
 const RECOVERY_HINT = ' Call computer{screenshot} if you need the current screen.';
+/**
+ * 帧被剪枝后占位行的固定前缀(见 pruneFrameMessage,完整行为 `[screenshot omitted: <帧名> · step N]`)。
+ * 剪枝会把合成附件消息整个 content 换成占位(前言 ATTACHMENT_PREAMBLE 随之消失),
+ * rollback 对齐真实用户轮时必须认出这个占位、不把它算成一轮——那里因循环依赖无法
+ * import 本模块,故在 rollback/store.ts 内联了同一行格式(按整行正则判定),修改此串时两处必须同步。
+ */
+const PRUNED_FRAME_PREFIX = '[screenshot omitted: ';
 /**
  * 白名单:参与滑动窗口的屏幕帧名前缀。
  *
@@ -139,11 +146,11 @@ function pruneFrameMessage(message, names, step, withHint) {
     for (const part of parts) {
         if (part.type !== 'image_url')
             continue;
-        lines.push(`[screenshot omitted: ${names[index] ?? UNKNOWN_FRAME_NAME} · step ${step}]`);
+        lines.push(`${PRUNED_FRAME_PREFIX}${names[index] ?? UNKNOWN_FRAME_NAME} · step ${step}]`);
         index++;
     }
     if (lines.length === 0)
-        lines.push(`[screenshot omitted: ${names[0] ?? UNKNOWN_FRAME_NAME} · step ${step}]`);
+        lines.push(`${PRUNED_FRAME_PREFIX}${names[0] ?? UNKNOWN_FRAME_NAME} · step ${step}]`);
     if (withHint)
         lines[0] = `${lines[0]}${RECOVERY_HINT}`;
     const content = [{ type: 'text', text: lines.join('\n') }];

package/dist/i18n/index.js

@@ -241,6 +241,8 @@ const zhCN = {
     'toolSummary.noOutput': '(无输出)',
     'toolSummary.imageAttached': '图片已作为视觉输入附加',
     'toolError.unknown': '错误:未知工具 "{name}"',
+    'toolError.unregistered': '错误:工具 "{name}" 未注册（不在本会话可用工具列表中，可能是拼写错误或模型幻觉出的名称）。相近的已注册工具:{suggestions}。请只调用 tools 列表中存在的名称，不要自造工具名。',
+    'toolError.noCloseMatch': '无相近的已注册工具名',
     'toolError.invalidJson': '错误:工具 {name} 的 arguments 不是合法 JSON: {arguments}',
     'toolError.execution': '错误:工具 {name} 执行失败: {message}',
     'command.outputTruncated': '...(输出已截断 {count} 字符，保留开头与结尾)...',
@@ -624,6 +626,8 @@ const en = {
     'toolSummary.noOutput': '(no output)',
     'toolSummary.imageAttached': 'Image attached as visual input',
     'toolError.unknown': 'Error: unknown tool "{name}"',
+    'toolError.unregistered': 'Error: tool "{name}" is not registered (it is not in this session\'s available tool list — likely a misspelling or a model-hallucinated name). Closest registered tools: {suggestions}. Only call names that appear in the tools list; never invent tool names.',
+    'toolError.noCloseMatch': 'no close match among registered tools',
     'toolError.invalidJson': 'Error: arguments for tool {name} are not valid JSON: {arguments}',
     'toolError.execution': 'Error: tool {name} failed: {message}',
     'command.outputTruncated': '...(output truncated by {count} characters; keeping the beginning and end)...',

package/dist/llm/index.js

@@ -5,6 +5,7 @@ import { getPlanDisabledTools, getProfileDisabledTools } from '../tools/constant
 import { imageSizeFromDataUrl } from '../attachments/image.js';
 import { ThinkTagFilter } from './think-filter.js';
 import { sanitizeToolSchemas } from './tool-schema.js';
+import { sanitizeAssistantContent } from './message-shape.js';
 import { isMarkedStreamInterrupted } from './stream-interrupt.js';
 import { defaultAnthropicFetch, anthropicChatOnce } from './providers/anthropic.js';
 import { vertexChatOnce } from './providers/vertex.js';
@@ -676,7 +677,7 @@ async function chatOnce(messages, handlers, signal, toolsOverride, runtime = def
         });
     const stream = await create({
         model: runtime.getModel(),
-        messages: normalizeImageDetail(messages),
+        messages: sanitizeAssistantContent(normalizeImageDetail(messages)),
         stream: true,
         // 空工具表(如摘要请求)不发 tools 字段——部分网关拒绝空数组。
         ...(activeTools.length > 0

package/dist/llm/message-shape.js

@@ -0,0 +1,42 @@
+/**
+ * 把「无文本、无 tool_calls」的 assistant 消息的 `content: null` 改写成空字符串。
+ *
+ * 背景:`content: null` 在 assistant 消息上**只在携带 tool_calls 时合法**(那是 OpenAI 自己
+ * 吐 tool_call 时的规范形状)。纯文本轮次写成 null 会被严格 OpenAI 兼容网关整请求拒绝。
+ * speedbear(https://speedbear.redbearai.com/api/v1)实测:
+ *   `{"error_code":"REQUEST_VALIDATION_FAILED",
+ *     "detail":"messages[12].content 不能为 null(assistant 消息仅在携带 tool_calls/
+ *               function_call 时允许省略 content;无文本请传空字符串 \"\")"}`
+ * 且形状探针逐条确认:`null`+tool_calls → 200;`content:[]` → 200;缺 content 字段 → 200;
+ * `content:""` → 200;连续 user 消息 → 200。**只有「null 且无 tool_calls」这一种被拒。**
+ *
+ * 在 agent 侧的表现极具迷惑性——「某个会话从某一轮起每一步都 400、换个会话同模型却正常」:
+ * 毒消息一旦写进 history 就会每轮重发,而它是**合法 JSON、合法 OpenAI 类型**,肉眼 review
+ * 抓不到;`/resume` 也救不回来(毒在落盘文件里)。更隐蔽的是它的来源:SSE 流中途结束
+ * (网关超时/上游掐断)时 SDK 不抛错,`content` 停在 null、tool_calls 为空,
+ * 框架把它当「agent 完成了这一轮」照写 history——于是一步正常的历史被永久污染。
+ *
+ * 与 `sanitizeToolSchemas`(剔 uniqueItems)同源同策:**放 transport 边界而非只修构造点**——
+ * 已经被旧版本写进 session.json 的中毒会话、外部注入的历史、resume 续接的会话都能自愈,
+ * 只修构造点救不了存量。构造点(`agent/stages/history-manager.ts`)同步收敛,保证新历史
+ * 不再生产这种形状,两层各司其职。
+ *
+ * 无需改写时返回**原数组引用**——history 参与前缀缓存,逐字节稳定才能命中;
+ * 每次新建对象会击穿缓存(同 `sanitizeToolSchemas` 的返回值约定)。
+ */
+export function sanitizeAssistantContent(messages) {
+    let changed = false;
+    const next = messages.map((message) => {
+        if (message.role !== 'assistant')
+            return message;
+        const raw = message;
+        // 带 tool_calls 时 null 是规范形状(OpenAI 自己就这么吐),原样保留。
+        if (Array.isArray(raw.tool_calls) && raw.tool_calls.length > 0)
+            return message;
+        if (raw.content !== null)
+            return message;
+        changed = true;
+        return { ...message, content: '' };
+    });
+    return changed ? next : messages;
+}

package/dist/repl/runtime.js

@@ -352,12 +352,6 @@ export async function startRepl(initialHistory, sessionId, sandboxRootOverride,
             layout.contentWrite(`${ui.dim}(没有可回滚的轮次)${ui.reset}\n`);
             return;
         }
-        // 各轮 user 全文(预填用;按 user 消息顺序与 turnList 对齐)
-        const userTexts = [];
-        for (const m of history) {
-            if (m.role === 'user')
-                userTexts.push(textOf(m.content));
-        }
         const items = turnList.map((t) => ({ firstLine: t.firstLine }));
         let picked;
         try {
@@ -368,8 +362,11 @@ export async function startRepl(initialHistory, sessionId, sandboxRootOverride,
         }
         if (picked === null)
             return; // Esc 取消
-        // picked(0-based)= 第 (picked+1) 轮:删该轮及之后(planRollback(picked) 保 1..picked),预填该轮 user 输入
-        const prefillText = userTexts[picked] ?? '';
+        // picked(0-based)= 第 (picked+1) 轮:删该轮及之后(planRollback(picked) 保前 picked 轮),
+        // 预填该轮 user 输入。必须经 store 按"尾部对齐的真实用户轮消息"定位——直接按 history 里
+        // role==='user' 数下标会把工具附件的合成 user 消息/被剪枝老轮算进去,预填错轮。
+        const pickedMessage = runtime.rollback.turnUserMessage(picked, history);
+        const prefillText = pickedMessage ? textOf(pickedMessage.content) : '';
         const plan = runtime.rollback.plan(picked, history);
         // 清屏(擦选轮菜单 + /rollback 回显)+ 复位 lastView(dim 空),给文件询问一个干净、resize 安全的画面
         layout.clearContent();

package/dist/rollback/store.js

@@ -47,6 +47,61 @@ const EXCLUDED_WORKSPACE_DIRS = Object.freeze([
     '.ruff_cache',
     '.gradle',
 ]);
+/**
+ * 工具经 modelAttachments 注入的合成 user 消息前言(见 agent/tool-turn.ts 的
+ * ATTACHMENT_PREAMBLE)。这类消息 role 也是 'user',但不对应 beginTurn 的真实用户轮,
+ * 回滚按 role==='user' 数轮次会与 turns 数组错位,导致"回退一条却连带删掉好几轮"。
+ * 两处常量必须保持一致;不 import tool-turn 是为避免 rollback→agent 的层级反向依赖。
+ */
+const TOOL_ATTACHMENT_PREAMBLE = 'The read_file tool loaded the following visual input: ';
+/**
+ * 视觉滑动窗口剪枝占位的机器固定格式(必须与 context/vision-window.ts 的
+ * pruneFrameMessage 输出逐字一致):一行或多行 `[screenshot omitted: <帧名> · step <数字>]`,
+ * 首行可能再跟固定恢复提示后缀。用整串正则而不是前缀匹配,避免把恰好以
+ * "[screenshot omitted: " 开头的真实用户输入误判成占位。
+ *
+ * 这里内联而不是 import vision-window:vision-window → llm → … → rollback/index 会形成
+ * 循环依赖,在共享进程的测试里触发 "Cannot access 'defaultRollbackStore' before initialization"。
+ */
+const PRUNED_FRAME_LINE_RE = /^\[screenshot omitted: .+? · step \d+\]$/;
+const PRUNED_FRAME_HINT_SUFFIX = ' Call computer{screenshot} if you need the current screen.';
+function isPrunedFrameText(text) {
+    if (typeof text !== 'string')
+        return false;
+    const lines = text.split('\n');
+    return lines.every((line, i) => {
+        const core = i === 0 && line.endsWith(PRUNED_FRAME_HINT_SUFFIX) ? line.slice(0, -PRUNED_FRAME_HINT_SUFFIX.length) : line;
+        return PRUNED_FRAME_LINE_RE.test(core);
+    });
+}
+/**
+ * 判断一条 user 消息是否对应一个真实用户轮(= beginTurn 记进 turns 的那一条)。
+ *
+ * 排除两种合成 user 消息(都是 role:'user' 但不计轮次):
+ *  1. 工具批次提交时由 modelAttachments 注入的附件消息:ContentPart[] 的 text part
+ *     以工具附件前言开头;
+ *  2. 上述附件消息经视觉滑动窗口剪枝后的占位:整个 content 被替换成
+ *     "[screenshot omitted: …]" 文本,前言已不存在(见 vision-window.pruneFrameMessage),
+ *     形态可能是数组 text part,也可能是纯字符串。
+ *
+ * 用户自己发的多模态消息没有这两个标记,不会被误判。
+ */
+function isRealTurnUserMessage(message) {
+    if (message.role !== 'user')
+        return false;
+    const content = message.content;
+    if (typeof content === 'string')
+        return !isPrunedFrameText(content);
+    if (!Array.isArray(content))
+        return false;
+    for (const part of content) {
+        if (part && typeof part === 'object' && part.type === 'text' && typeof part.text === 'string') {
+            if (part.text.startsWith(TOOL_ATTACHMENT_PREAMBLE) || isPrunedFrameText(part.text))
+                return false;
+        }
+    }
+    return true;
+}
 const CAPTURE_FILE_LIMIT = 1024 * 1024;
 const CAPTURE_TOTAL_LIMIT = 32 * 1024 * 1024;
 const CAPTURE_ENTRY_LIMIT = 20000;
@@ -440,6 +495,32 @@ export class RollbackStore {
     listTurns() {
         return this.turns.slice();
     }
+    /**
+     * 取菜单第 pickedIndex(0-based)轮对应的真实用户消息(用于 /rollback 后预填)。
+     * 与 findCutoffIndex 同一套尾对齐规则。无对应消息(续接历史缺轮)时返回 undefined。
+     */
+    turnUserMessage(pickedIndex, history) {
+        const index = this.findTurnUserIndex(pickedIndex, history);
+        return index < 0 ? undefined : history[index];
+    }
+    /**
+     * 菜单第 pickedIndex(0-based)轮对应的真实用户消息在 history 中的下标。
+     * turns 是真实轮次的尾部连续子集(滚动剪枝/压缩只丢旧轮),故菜单第 k 轮 =
+     * history 中倒数第 (turns.length-k) 条真实用户轮消息。找不到返回 -1。
+     */
+    findTurnUserIndex(pickedIndex, history) {
+        let wantReverseRank = this.turns.length - pickedIndex;
+        if (wantReverseRank <= 0)
+            return -1;
+        for (let i = history.length - 1; i >= 0; i--) {
+            if (!isRealTurnUserMessage(history[i]))
+                continue;
+            wantReverseRank -= 1;
+            if (wantReverseRank === 0)
+                return i;
+        }
+        return -1;
+    }
     /**
      * 只读侧门(供 /diff 渲染):返回 turnId > sinceTurnId 的全部快照,浅拷贝数组。
      * 快照内容含 before 原文,调用方不得 mutate 返回值;用于展示,不影响回滚语义。
@@ -447,19 +528,21 @@ export class RollbackStore {
     snapshotsSince(sinceTurnId) {
         return this.snapshots.filter((snapshot) => snapshot.turnId > sinceTurnId);
     }
+    /**
+     * 回滚切点:保留菜单前 n 轮,从第 n+1 轮(菜单下标 n,0-based)的真实 user 消息处切断。
+     *
+     * turns(菜单)= 当前仍可回滚的轮次,是真实轮次的**尾部连续子集**(滚动剪枝/压缩只丢旧轮),
+     * 故从尾部倒数定位,而不是正数第 n 条——压缩的「user 逐字通道」会把更老的 user 原文
+     * 捞回保留区,正数下标与 turns 不再连续对齐。找不到(无第 n+1 轮)时返回 history.length。
+     */
     findCutoffIndex(n, history) {
-        let seen = 0;
-        for (let i = 0; i < history.length; i++) {
-            if (history[i].role === 'user') {
-                seen += 1;
-                if (seen === n + 1)
-                    return i;
-            }
-        }
-        return history.length;
+        const index = this.findTurnUserIndex(n, history);
+        return index < 0 ? history.length : index;
     }
     planRollback(n, history) {
         const cutoffTurnId = this.turns[n - 1]?.turnId ?? 0;
+        // turns 与 history 真实 user 消息尾对齐后再取切点:滚动剪枝(>50 轮)/压缩/续接后
+        // turns 只是尾部子集,不能再把 n 当成全局第 n 条 user 消息,否则会多删 offset 轮。
         const cutoffIndex = this.findCutoffIndex(n, history);
         const order = [];
         const map = new Map();
@@ -587,7 +670,9 @@ export class RollbackStore {
         return { deletedMsgs, revertedFiles, conflictedFiles };
     }
     pruneAfterCompaction(history) {
-        const count = history.filter((message) => message.role === 'user').length;
+        // 只数真实用户轮(排除工具附件合成 user 消息);压缩会整体丢弃旧轮,
+        // 保留下来的总是最近的轮次,故 turns 同样从尾部对齐截取。
+        const count = history.filter((message) => isRealTurnUserMessage(message)).length;
         this.turns = count >= this.turns.length ? this.turns : this.turns.slice(-count);
         const alive = new Set(this.turns.map((turn) => turn.turnId));
         this.snapshots = this.snapshots.filter((snapshot) => alive.has(snapshot.turnId));
@@ -603,7 +688,9 @@ export class RollbackStore {
     rebuildFromHistory(history) {
         const rebuilt = [];
         for (const message of history) {
-            if (message.role !== 'user')
+            // 跳过工具附件注入的合成 user 消息,否则 turns 比真实轮次多,
+            // /rollback 菜单与 history 切点(planRollback 按 turns[n-1])整体错位。
+            if (!isRealTurnUserMessage(message))
                 continue;
             const first = toText(message.content).split('\n')[0] ?? '';
             rebuilt.push({ turnId: rebuilt.length + 1, firstLine: truncateDisplay(first, 40) });

package/dist/runtime/runtime.js

@@ -90,6 +90,10 @@ export class Runtime {
                 this.assertOpen();
                 return this.context.rollbackStore.listTurns();
             },
+            turnUserMessage: (pickedIndex, history) => {
+                this.assertOpen();
+                return this.context.rollbackStore.turnUserMessage(pickedIndex, history);
+            },
             plan: (n, history) => {
                 this.assertIdle('plan rollback');
                 const plan = this.context.rollbackStore.planRollback(n, history);

package/package.json

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