mocode-ai 0.6.7 → 0.6.9

package/dist/tools/registry.js

@@ -1,51 +1,87 @@
 import { builtinTools } from './builtins/index.js';
-import { recordMutation } from '../rollback/index.js';
+import { beginPathMutation, beginWorkspaceMutation, endPathMutation, endWorkspaceMutation, } from '../rollback/index.js';
 import { enforceSandbox } from '../sandbox/index.js';
+import { t } from '../i18n/index.js';
 /**
- * 工具注册表。当前 = 内置工具;
- * 未来可在此合并 MCP 工具、用户自定义工具等(见 src/mcp/)。
+ * 可扩展工具注册表。数组实例始终稳定，使已经持有 tools 引用的 agent/LLM 能看到运行时新增工具。
+ * 扩展按 source 替换，MCP 重连或配置刷新不会累积旧工具。
  */
-export const tools = builtinTools;
+const extensions = new Map();
+export const tools = [...builtinTools];
+export function registerToolsExtension(sourceOrAdditions, maybeAdditions) {
+    const source = typeof sourceOrAdditions === 'string' ? sourceOrAdditions : 'external';
+    const additions = typeof sourceOrAdditions === 'string' ? (maybeAdditions ?? []) : sourceOrAdditions;
+    extensions.set(source, additions);
+    const rejected = additions
+        .filter((tool) => builtinTools.some((builtin) => builtin.name === tool.name))
+        .map((tool) => tool.name);
+    rebuildTools();
+    return rejected;
+}
+export function clearToolsExtension(source) {
+    if (extensions.delete(source))
+        rebuildTools();
+}
+function rebuildTools() {
+    const names = new Set();
+    const next = [];
+    for (const tool of [...builtinTools, ...Array.from(extensions.values()).flat()]) {
+        if (names.has(tool.name))
+            continue;
+        names.add(tool.name);
+        next.push(tool);
+    }
+    tools.splice(0, tools.length, ...next);
+}
 /**
  * 按名调度工具,统一 try/catch + JSON 解析,返回字符串而非抛错。
  * signal 透传给 tool.execute(经 ctx):长任务工具(run_command/web_fetch)abort 即时取消,
  * 让用户 Ctrl+C 能跟手中断工具执行(而非等命令跑完 / 超时)。
- * opts.skipRollback:子 agent 逻辑隔离用——跳过 recordMutation,子 agent 改动不进主回滚快照链。
  * opts.dropContext:上下文剔除回调(drop_context 工具用),透传给 tool.execute 经 ctx。
  */
 export async function executeTool(name, argsRaw, signal, opts) {
     const tool = tools.find((t) => t.name === name);
     if (!tool)
-        return `错误:未知工具 "${name}"`;
+        return t('toolError.unknown', { name });
     let args;
     try {
         args = argsRaw.trim() ? JSON.parse(argsRaw) : {};
     }
     catch {
-        return `错误:工具 ${name} 的 arguments 不是合法 JSON: ${argsRaw}`;
+        return t('toolError.invalidJson', { name, arguments: argsRaw });
     }
     try {
-        // 沙箱:路径类工具(读/写/改)越界拒绝 + args.path 重写为牢内绝对;glob/grep pattern 校验。
-        // 返 string = 拒绝(直接喂 LLM,不执行);返 null = 放行(可能已重写 args.path)。
-        // 须在 recordMutation 前:让快照路径 = 牢内绝对路径,与回滚一致。不抛(契约:调度器永不抛错)。
+        // 沙箱先重写/校验路径，保证快照与实际执行目标完全一致。
         const sbErr = enforceSandbox(name, args);
         if (sbErr)
             return sbErr;
-        // 撤销回滚用:write_file/edit_file 改动前记 before 快照(回滚时恢复到轮末状态)。
-        // 子 agent(skipRollback)跳过:其改动不进主回滚链,主 /rollback 不撤销(靠 git 兜底)。
-        if (!opts?.skipRollback &&
-            (name === 'write_file' || name === 'edit_file') &&
+        const pathCapture = (name === 'write_file' || name === 'edit_file') &&
             typeof args.path === 'string' &&
-            args.path) {
-            recordMutation(args.path);
+            args.path
+            ? beginPathMutation(args.path)
+            : null;
+        // shell 与 MCP 的副作用无法从参数可靠推断：以工作区前后状态识别实际改动。
+        // task 本身不扫描；其子 agent 共享当前轮，并在各自真实写工具处记账。
+        const workspaceCapture = name === 'run_command' || name.startsWith('mcp__')
+            ? beginWorkspaceMutation()
+            : null;
+        try {
+            return await tool.execute(args, {
+                signal,
+                dropContext: opts?.dropContext,
+            });
+        }
+        finally {
+            if (pathCapture)
+                endPathMutation(pathCapture, name);
+            if (workspaceCapture)
+                endWorkspaceMutation(workspaceCapture, name);
         }
-        return await tool.execute(args, {
-            signal,
-            skipRollback: opts?.skipRollback,
-            dropContext: opts?.dropContext,
-        });
     }
     catch (e) {
-        return `错误:工具 ${name} 执行失败: ${e instanceof Error ? e.message : String(e)}`;
+        return t('toolError.execution', {
+            name,
+            message: e instanceof Error ? e.message : String(e),
+        });
     }
 }

package/dist/tools/result.js

@@ -0,0 +1,7 @@
+/**
+ * Tool results are still strings for LLM compatibility. Keep error detection
+ * language-independent while legacy built-ins are migrated to structured results.
+ */
+export function isToolErrorOutput(output) {
+    return /^(?:错误|Error):/.test(output.trimStart());
+}

package/dist/ui/intervention.js

@@ -5,15 +5,18 @@ import { displayWidth, truncateDisplay, visColToCharCol, wrapByDisplayWidth } fr
 import * as layout from './layout.js';
 import * as mouse from './mouse.js';
 import { Spinner } from './spinner.js';
+import { t } from '../i18n/index.js';
 const emitter = stdin;
-/** choice 末尾的"自定义输入"项标签(纯 ASCII,宽度安全)。选中后切到 input 子态。 */
-const CUSTOM_LABEL = '其他(自定义输入)';
+/** choice 末尾的本地化“自定义输入”项标签。 */
+const customLabel = () => t('intervention.custom');
 /** 弹出介入面板,阻塞直到用户完成选择。 */
 export async function promptIntervention(req) {
     // 非 TTY 降级:不阻塞,自动选默认。日志走 stderr(不污染 stdout 内容流)。
     if (!layout.isActive()) {
-        const kind = req.type === 'choice' ? '自动选默认项' : '自动返回空输入';
-        stderr.write(`[介入] ${req.title}(非交互环境,${kind})\n`);
+        const kind = req.type === 'choice'
+            ? t('intervention.defaultChoice')
+            : t('intervention.emptyInput');
+        stderr.write(`${t('intervention.nonInteractive', { title: req.title, kind })}\n`);
         if (req.type === 'choice') {
             const first = req.options?.[0];
             const value = typeof first === 'string' ? first : first?.label ?? '';
@@ -45,7 +48,7 @@ export async function promptIntervention(req) {
         const g = layout.getGeo();
         const cols = g.cols;
         const allowCustom = req.allowCustom !== false;
-        const items = allowCustom ? [...options, { label: CUSTOM_LABEL }] : [...options];
+        const items = allowCustom ? [...options, { label: customLabel() }] : [...options];
         const optionCount = items.length;
         // 每项占行数 = label + （detail）整体 wrap 到可用宽度后的实际行数(超长换行,不再省略)。
         // 短 label 仍只占 1 行;长 detail 自然占用多行,菜单总高度随之动态增长。
@@ -129,7 +132,9 @@ export async function promptIntervention(req) {
             if (dl.length > detailCap)
                 lines.push(`${ui.dim}…${ui.reset}`);
         }
-        lines.push(`${ui.dim}Enter 提交 · Esc ${cameFromChoice ? '返回选项' : '取消'} · Ctrl+C 取消${ui.reset}`);
+        lines.push(`${ui.dim}${t('prompt.submit', {
+            escape: cameFromChoice ? t('prompt.back') : t('prompt.cancel'),
+        })}${ui.reset}`);
         return lines;
     }
     /** 鼠标左键点击输入框 → 把 cursor 移到点击位置(与 prompt.ts 的 applyExternalCursor 同源逻辑)。
@@ -156,7 +161,7 @@ export async function promptIntervention(req) {
     }
     function redraw() {
         if (mode === 'choice') {
-            const hint = '↑↓ 选择 · Enter 确认 · 数字键直选 · Esc 取消';
+            const hint = t('prompt.chooseConfirm');
             layout.paintInput({
                 prompt: '❯ ',
                 lines: [hint],

package/dist/ui/layout.js

@@ -6,6 +6,7 @@ import * as mouse from './mouse.js';
 import { shiftBatchesAfter } from './batch.js';
 import { copyToClipboard, readClipboard } from './clipboard.js';
 import { renderMarkdown } from './markdown.js';
+import { t } from '../i18n/index.js';
 // ── 内部状态 ──
 let active = false;
 let mode = 'input';
@@ -1284,7 +1285,7 @@ function composeSpinnerLine(status, cols) {
     let tail = '';
     let tailW = 0;
     if (scrolled) {
-        tail = `历史 ↑${scrollOffset} (PgDn 回底)`;
+        tail = t('status.history', { count: scrollOffset });
         tailW = displayWidth(tail);
     }
     const rightStr = tail ? `${ui.yellow}${tail}${ui.reset}` : '';
@@ -1302,7 +1303,7 @@ function composeModelLine(status, cols) {
     const modePart = modeTag ? `${modeColor}${modeTag}${ui.reset}` : '';
     const modeW = modeTag ? displayWidth(modeTag) : 0;
     // 切换提示:告诉用户怎么切模式。灰(dim)降优先级,不与 modeTag 抢色;只在有 modeTag 时出现。
-    const HINT = 'Shift+Tab 切换';
+    const HINT = t('status.modeSwitch');
     const hintW = modeTag ? displayWidth(HINT) : 0;
     const hintPart = modeTag ? `${ui.dim}${HINT}${ui.reset}` : '';
     const tokChip = formatTurnTokenChip(status.lastTurnUsage);
@@ -1822,7 +1823,7 @@ export function repaint() {
         drawStatusBar();
 }
 /** 进入输入态:画空输入框 + 状态行,光标入输入框。 */
-export function enterInputMode(status = '空闲') {
+export function enterInputMode(status = t('repl.idle')) {
     mode = 'input';
     statusText = status;
     spinnerFrame = undefined;

package/dist/ui/prompt.js

@@ -4,6 +4,7 @@ import { ui } from './theme.js';
 import { displayWidth, padEndDisplay, truncateDisplay, visColToCharCol, wrapByDisplayWidth } from './render.js';
 import * as layout from './layout.js';
 import * as mouse from './mouse.js';
+import { t } from '../i18n/index.js';
 // ── 粘贴检测(块级 + 时间窗)──
 // 块级:多字节大块(len>8)或含 CR/LF 的小块 = 粘贴(键盘单键 1 字节,Enter=\r 单字节)。
 // 时间窗:每块重置 50ms 计时器,静默 50ms 即"粘贴结束"→ onPasteEnd。跨多块的大粘贴(块间 <50ms)累积进
@@ -101,18 +102,20 @@ export async function promptWithSlashMenu(opts) {
         else if (selected >= menuTop + visibleCount)
             menuTop = selected - visibleCount + 1;
         const windowItems = filtered.slice(menuTop, menuTop + visibleCount);
-        const maxName = Math.max(...windowItems.map((c) => displayWidth(c.name)));
+        const maxName = Math.max(...windowItems.map((item) => displayWidth(item.node.name + (item.node.children?.length ? ' ›' : ''))));
         const hasMoreAbove = menuTop > 0;
         const hasMoreBelow = menuTop + visibleCount < filtered.length;
-        return windowItems.map((c, i) => {
+        return windowItems.map((item, i) => {
+            const c = item.node;
             const globalIdx = menuTop + i;
             // 选中项:▸ 与文字均 cyan+bold(去 dim),未选中项保持 dim——选中行整体高亮。
             const isSel = globalIdx === selected;
             const color = isSel ? `${ui.accent}${ui.bold}` : ui.dim;
             const marker = isSel ? `${ui.accent}${ui.bold}▸${ui.reset}` : ' ';
-            const name = padEndDisplay(c.name, maxName);
+            const branchSuffix = c.children?.length ? ' ›' : '';
+            const name = padEndDisplay(c.name + branchSuffix, maxName);
             // 首/末附加滚动指示(▲/▼)而非替换整行
-            let desc = c.desc;
+            const desc = c.desc;
             let scrollHint = '';
             if (i === 0 && hasMoreAbove)
                 scrollHint = ' ▲';
@@ -135,8 +138,11 @@ export async function promptWithSlashMenu(opts) {
             return '';
         const lines = chip.split('\n').length;
         const chars = chip.length;
-        const charStr = chars < 1000 ? `${chars} 字符` : `${(chars / 1000).toFixed(1)}K 字符`;
-        return `[📋 ${lines} 行 · ${charStr}] `;
+        const lineText = t('prompt.lines', { count: lines });
+        const charText = t('prompt.chars', {
+            count: chars < 1000 ? chars : `${(chars / 1000).toFixed(1)}K`,
+        });
+        return `[📋 ${lineText} · ${charText}] `;
     }
     /** chipPre 按行拆分(粘贴发生前光标之前已有的文本,可能多行,原样保留在 chip 之前)。 */
     function chipPreLines() {
@@ -225,9 +231,24 @@ export async function promptWithSlashMenu(opts) {
             return;
         applyPastedText(text.replace(/\r\n/g, '\n').replace(/\r/g, '\n'));
     }
+    /** 根据输入文本找到当前层。prefix 始终包含已进入分支及末尾空格。 */
+    function menuContext(input) {
+        let nodes = opts.commands;
+        let prefix = '';
+        while (true) {
+            const branch = nodes.find((node) => node.children?.length && input.startsWith(`${prefix}${node.name} `));
+            if (!branch?.children)
+                return { nodes, prefix };
+            prefix = `${prefix}${branch.name} `;
+            nodes = branch.children;
+        }
+    }
     function computeFiltered() {
         if (cl === 0 && lines[0].startsWith('/')) {
-            filtered = opts.commands.filter((c) => c.name.startsWith(lines[0]));
+            const { nodes, prefix } = menuContext(lines[0]);
+            filtered = nodes
+                .map((node) => ({ node, input: `${prefix}${node.name}` }))
+                .filter((item) => item.input.startsWith(lines[0]));
             menuOpen = filtered.length > 0;
             if (selected >= filtered.length) {
                 selected = 0;
@@ -371,13 +392,38 @@ export async function promptWithSlashMenu(opts) {
         cleanup();
         resolve(value);
     }
-    /** 提交:菜单打开时先补全选中项到第 0 行。chipPre + chip + suffix 依次拼回全文(保留粘贴前后原有文字)。 */
-    function submit() {
-        if (menuOpen && filtered[selected]) {
-            lines = [filtered[selected].name];
+    /**
+     * 应用当前菜单项。分支节点只进入下一层；叶子节点补全 value/input。
+     * 返回 true 表示调用方应立即提交，false 表示仍留在输入态。
+     */
+    function applySelected(submitLeaf) {
+        const item = filtered[selected];
+        if (!menuOpen || !item)
+            return submitLeaf;
+        if (item.node.children?.length) {
+            lines = [`${item.input} `];
             cl = 0;
             cc = lines[0].length;
+            selected = 0;
+            menuTop = 0;
+            computeFiltered();
+            redraw();
+            return false;
+        }
+        lines = [item.node.value ?? item.input];
+        cl = 0;
+        cc = lines[0].length;
+        computeFiltered();
+        if (!submitLeaf || item.node.submit === false) {
+            redraw();
+            return false;
         }
+        return true;
+    }
+    /** 提交:菜单打开时先应用选中项；分支进入子菜单，需要参数的叶子只补全。 */
+    function submit() {
+        if (menuOpen && !applySelected(true))
+            return;
         const suffix = lines.join('\n');
         let content = suffix;
         if (chip) {
@@ -589,21 +635,29 @@ export async function promptWithSlashMenu(opts) {
                 }
                 return;
             case 'tab':
-                if (menuOpen && filtered[selected]) {
-                    lines[0] = filtered[selected].name;
+                if (menuOpen && filtered[selected])
+                    applySelected(false);
+                return;
+            case 'escape': {
+                const { prefix } = menuContext(lines[0]);
+                if (prefix) {
+                    // 子层 Esc 回到父节点；例如 /model sw → /model。
+                    lines = [prefix.trimEnd()];
                     cl = 0;
                     cc = lines[0].length;
+                    selected = 0;
+                    menuTop = 0;
                     computeFiltered();
-                    redraw();
                 }
-                return;
-            case 'escape':
-                menuOpen = false;
-                filtered = [];
-                selected = 0;
-                menuTop = 0;
+                else {
+                    menuOpen = false;
+                    filtered = [];
+                    selected = 0;
+                    menuTop = 0;
+                }
                 redraw();
                 return;
+            }
             case 'left':
                 if (cc > 0) {
                     cc--;
@@ -680,7 +734,7 @@ export async function promptTurnPicker(items) {
     if (!layout.isActive() || items.length === 0)
         return null;
     const emitter = stdin;
-    const hint = '↑↓ 选择 · Enter 回滚到该轮 · Esc 取消';
+    const hint = t('prompt.chooseRollback');
     let selected = items.length - 1; // 默认聚焦最新(末项,菜单底、靠近输入框)
     let resolved = false;
     let resolve;
@@ -804,12 +858,12 @@ export async function promptSessionPicker(items, recentCap = 10) {
     }
     /** 输入框行的操作提示;折叠态显「a 全部(N)」,展开态显「a 仅最近N」。不超 cap 时无 a 项。 */
     function hint() {
-        const base = '↑↓ 选择 · Enter 续接 · Esc 取消';
+        const base = t('prompt.chooseResume');
         if (!canToggle)
             return base;
         return showAll
-            ? `↑↓ 选择 · Enter 续接 · a 仅最近${cap} · Esc 取消`
-            : `↑↓ 选择 · Enter 续接 · a 全部(${items.length}) · Esc 取消`;
+            ? t('prompt.recent', { count: cap })
+            : t('prompt.all', { count: items.length });
     }
     /** 菜单行(带开窗):超屏高时以 selected 为中心取窗,保光标可见。行格式:▸ N  title  subtitle。 */
     function menuLines() {
@@ -951,7 +1005,7 @@ export async function promptThemePicker(items) {
     let resolved = false;
     let resolve;
     let reject;
-    const hint = '↑↓ 选择 · Enter 切换 · Esc 取消';
+    const hint = t('prompt.chooseSwitch');
     /** 菜单行(带开窗):超屏高时以 selected 为中心取窗,保光标可见。行格式:▸ N  title  subtitle。 */
     function menuLines() {
         const g = layout.getGeo();
@@ -1076,10 +1130,11 @@ export async function promptRevertChoice(fileCount) {
     if (!layout.isActive())
         return null;
     const emitter = stdin;
-    const hint = '↑↓ 选择 · Enter 确认 · Esc 保留文件';
+    const hint = t('prompt.keepFiles');
+    const detail = fileCount > 0 ? t('prompt.revertDetail', { count: fileCount }) : '';
     const items = [
-        `撤销文件改动${fileCount > 0 ? `(${fileCount} 个文件恢复到回滚前)` : ''}`,
-        '只撤销消息,保留文件改动',
+        t('prompt.revertFiles', { detail }),
+        t('prompt.messagesOnly'),
     ];
     let selected = 0; // 默认聚焦首项(撤销文件)
     let resolved = false;

package/dist/ui/render.js

@@ -1,6 +1,7 @@
 import { stdout } from 'node:process';
 import { createRequire } from 'node:module';
 import { ui } from './theme.js';
+import { t } from '../i18n/index.js';
 const VERSION = createRequire(import.meta.url)('../../package.json').version;
 /**
  * 清空整屏 + 滚动缓冲(向上滚动可见的历史输出),光标归位。
@@ -245,12 +246,12 @@ const LOGO_LINES = [
 function logoLine(idx) {
     return `${ui.accent}${padEndDisplay(LOGO_LINES[idx], LOGO_W)}${ui.reset}${' '.repeat(LOGO_GAP)}`;
 }
-function labelContent(label, value) {
-    return `${ui.dim}${padEndDisplay(label, 6)}${ui.reset}${value}`;
+function labelContent(label, value, width) {
+    return `${ui.dim}${padEndDisplay(label, width)}${ui.reset}${value}`;
 }
-/** 把布尔转成显式中文:banner 上避免「是/否」歧义,用「开/关」。 */
+/** 把记忆开关转成本地化标签。 */
 function memoryLabel(on) {
-    return on ? '开启' : '关闭';
+    return on ? t('banner.enabled') : t('banner.disabled');
 }
 /** 记忆状态染色:开启用 ui.accent(亮),关闭用 ui.dim(弱),让远观有差别。
  *  banner 里整体仍走 ui.reset 兜底——染色只贴在值那一列。 */
@@ -261,12 +262,14 @@ function memoryValue(on) {
  *  布局:大字 logo(4 行,块字符)左对齐,右侧并排放标题/信息(neofetch 风)。 */
 export function bannerString(info) {
     const title = `${ui.bold}${ui.accent}◆  MoCode${ui.reset}  ${ui.dim}v${VERSION}${ui.reset}`;
-    // 信息行 = 标题 + 模型 + 目录 + 记忆(共 4 行,与 4 行 logo 对齐)
+    const labels = [t('banner.model'), t('banner.directory'), t('banner.memory')];
+    // 标签列按当前语言最长文本动态定宽，并至少留两个空格；中文保持原 6 列，英文扩至 11 列。
+    const labelWidth = Math.max(...labels.map(displayWidth)) + 2;
     const rows = [
         logoLine(0) + title,
-        logoLine(1) + labelContent('模型', info.model),
-        logoLine(2) + labelContent('目录', truncateDisplay(info.cwd, 48)),
-        logoLine(3) + labelContent('记忆', memoryValue(info.memoryEnabled)),
+        logoLine(1) + labelContent(labels[0], info.model, labelWidth),
+        logoLine(2) + labelContent(labels[1], truncateDisplay(info.cwd, 48), labelWidth),
+        logoLine(3) + labelContent(labels[2], memoryValue(info.memoryEnabled), labelWidth),
     ];
     return rows.map((r) => MARGIN + r).join('\n') + '\n\n';
 }
@@ -331,13 +334,13 @@ export function summarizeToolResult(name, output) {
     const nonEmpty = output.split('\n').filter((l) => l.trim().length > 0);
     switch (name) {
         case 'read_file':
-            return nonEmpty.length ? `${nonEmpty.length} 行` : '(空文件)';
+            return nonEmpty.length ? t('toolSummary.lines', { count: nonEmpty.length }) : t('toolSummary.emptyFile');
         case 'glob':
-            return nonEmpty.length ? `${nonEmpty.length} 个文件` : '(无匹配)';
+            return nonEmpty.length ? t('toolSummary.files', { count: nonEmpty.length }) : t('toolSummary.noMatches');
         case 'grep':
-            return nonEmpty.length ? `${nonEmpty.length} 处匹配` : '(无匹配)';
+            return nonEmpty.length ? t('toolSummary.matches', { count: nonEmpty.length }) : t('toolSummary.noMatches');
         case 'run_command':
-            return truncateDisplay(nonEmpty[0] ?? '', 100) || '(无输出)';
+            return truncateDisplay(nonEmpty[0] ?? '', 100) || t('toolSummary.noOutput');
         default:
             return truncateDisplay(nonEmpty[0] ?? '', 100);
     }

package/package.json

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