mocode-ai 0.6.8 → 0.6.10

package/dist/repl/index.js

@@ -1,7 +1,8 @@
 import readline from 'node:readline/promises';
 import { emitKeypressEvents } from 'node:readline';
 import { stdin, stdout } from 'node:process';
-import { config, updateModelConfig, isModelConfigured, updateMemoryConfig, isMemoryEnabled, isProjectSkillEnabled, isProjectSnapshotEnabled, updateProjectSkillConfig, updateSnapshotConfig, buildBasePrompt, getPlanModeSuffix, } from '../config/index.js';
+import { config, updateModelConfig, isModelConfigured, updateMemoryConfig, isMemoryEnabled, isProjectSkillEnabled, isProjectSnapshotEnabled, updateProjectSkillConfig, updateSnapshotConfig, updateLanguageConfig, languageFromShell, buildBasePrompt, getPlanModeSuffix, } from '../config/index.js';
+import { getLanguage, normalizeLanguage, t, } from '../i18n/index.js';
 import { updateConfigKey, writeConfigKeys, CONFIG_PATH } from '../config/file.js';
 import { deletePreset, getPreset, isValidPresetName, listPresets, migrateCurrentToPreset, savePreset, } from '../config/presets.js';
 import { runAgent } from '../agent/index.js';
@@ -15,8 +16,9 @@ import * as mouse from '../ui/mouse.js';
 import * as batch from '../ui/batch.js';
 import { promptWithSlashMenu, promptTurnPicker, promptSessionPicker, promptThemePicker, promptRevertChoice, } from '../ui/prompt.js';
 import { promptIntervention } from '../ui/intervention.js';
-import { tools } from '../tools/registry.js';
-import { estimateMessagesTokens, reconfigureClient, } from '../llm/index.js';
+import { tools, registerToolsExtension } from '../tools/registry.js';
+import { initializeAllMcp, getMcpTools, closeAllMcp } from '../mcp/index.js';
+import { estimateMessagesTokens, reconfigureClient, refreshChatTools, } from '../llm/index.js';
 import { loadImageAttachment, renderChip, MAX_INLINE_BYTES_DEFAULT, } from '../attachments/image.js';
 import { modelSupportsVision } from '../llm/capabilities.js';
 import { computePruneStats } from '../context/relevance.js';
@@ -34,50 +36,113 @@ import { setCurrentSessionId, getCurrentSessionId } from '../session/state.js';
  * 颜色码会让光标错位、编辑时漂移。颜色只用在直接 stdout.write 的横幅 / 工具行 / 回复。
  */
 const PROMPT = '❯ ';
-/** 斜杠命令菜单(仅用于输入时下拉显示与过滤;分发仍走下方 if 链)。 */
-const SLASH_COMMANDS = [
-    { name: '/exit', desc: '退出 mocode(同 /quit)' },
-    { name: '/clear', desc: '清空历史(保留系统提示)' },
-    { name: '/context', desc: '显示上下文用量条' },
-    { name: '/skills', desc: '列出已发现的 skill' },
-    { name: '/compact', desc: '压缩历史(可带焦点 /compact …)' },
-    { name: '/resume', desc: '续接最近 10 个已保存会话(快速)' },
-    { name: '/sessions', desc: '浏览全部已保存会话(慢,翻历史用)' },
-    { name: '/rollback', desc: '菜单选轮次回滚(↑↓·Enter)' },
-    { name: '/memory', desc: '记忆库:条目计数与近期索引(关闭时提示先开 /memory_switch)' },
-    { name: '/memory_switch', desc: '切换记忆子系统开关(无参=切换;/on 或 /off 显式;持久化 MEMORY_ENABLED)' },
-    { name: '/project_skill', desc: '项目专属 Skill 开关 + 查看/初始化(无参=切换;/on·/off·/view·/init)' },
-    { name: '/snapshot', desc: '切换项目快照开关(无参=切换;/on·/off·/status;持久化 MOCODE_PROJECT_SNAPSHOT)' },
-    { name: '/memory_status', desc: '查看记忆子系统当前开关与原理' },
-    { name: '/reflect', desc: '手动触发后台记忆反思 pass(需先开启记忆)' },
-    { name: '/init', desc: '扫描项目生成 MOCODE.md 项目记忆(需先开启记忆)' },
-    { name: '/theme', desc: '切换颜色主题(↑↓·Enter)' },
-    { name: '/model', desc: '配置新模型(向导);/model switch·list·delete 管理已配置预设' },
-    { name: '/model switch', desc: '↑↓·Enter 在已配置预设间切换' },
-    { name: '/model list', desc: '列出已经配置的模型' },
-    { name: '/model delete <name>', desc: '删除已配置的模型' },
-    { name: '/snapshot_refresh', desc: '刷新项目快照(重新扫描静态文件,重新生成 LLM 摘要)' },
-    { name: '/plan', desc: '切到 plan 模式(只读探查+产出计划)' },
-    { name: '/auto', desc: '切回 auto 模式(全工具执行)' },
-    { name: '/pet', desc: '开关桌宠(独立悬浮窗,展示 agent 状态动画)' },
-    { name: '/pet skin', desc: '选择桌宠皮肤(↑↓·Enter)' },
-    { name: '/pet quit', desc: '完全关闭桌宠进程(而非仅断开本连接)' },
-    { name: '/image', desc: '附加本地图片到下一条消息(/image <path> · list · clear)' },
-];
-/** 主题名 → 一句描述(供 /theme 菜单 / 列表显示)。新增主题时在 src/ui/theme.ts THEMES 加键后于此补一句。 */
-const THEME_DESCRIPTIONS = {
-    default: '16 色原版(深底)',
-    light: '浅底终端',
-    solarized: 'Solarized 强调色',
-    gruvbox: 'Gruvbox 暖色',
-    nord: 'Nord 冷色',
-    orange: '南瓜橙(暖)',
-    rose: '玫红(暖紫)',
-    emerald: '翡翠绿(冷)',
-    amber: '琥珀金黄(暖)',
-    lavender: '薰衣草淡紫(冷)',
-    sunset: '日落珊瑚红(暖)',
-};
+/**
+ * 斜杠命令树(仅用于输入菜单；分发仍走下方 if 链)。
+ * 分支节点只负责导航，叶子的 value 保持现有命令文本，因此不破坏命令兼容性。
+ */
+function buildSlashCommands() {
+    const d = (key) => t(key);
+    return [
+        { name: '/help', desc: d('commands.help') },
+        { name: '/exit', desc: d('commands.exit') },
+        { name: '/clear', desc: d('commands.clear') },
+        { name: '/context', desc: d('commands.context') },
+        { name: '/skills', desc: d('commands.skills') },
+        { name: '/compact', desc: d('commands.compact') },
+        { name: '/resume', desc: d('commands.sessionResume') },
+        { name: '/sessions', desc: d('commands.sessionBrowse') },
+        { name: '/rollback', desc: d('commands.sessionRollback') },
+        {
+            name: '/memory', desc: d('commands.memory'), children: [
+                { name: 'overview', value: '/memory', desc: d('commands.memoryOverview') },
+                { name: 'toggle', value: '/memory_switch', desc: d('commands.memoryToggle') },
+                { name: 'on', value: '/memory_switch on', desc: d('commands.memoryOn') },
+                { name: 'off', value: '/memory_switch off', desc: d('commands.memoryOff') },
+                { name: 'status', value: '/memory_status', desc: d('commands.memoryStatus') },
+                { name: 'reflect', value: '/reflect', desc: d('commands.memoryReflect') },
+                { name: 'init', value: '/init', desc: d('commands.memoryInit') },
+            ],
+        },
+        {
+            name: '/project_skill', desc: d('commands.skill'), children: [
+                { name: 'toggle', value: '/project_skill', desc: d('commands.toggle') },
+                { name: 'on', value: '/project_skill on', desc: d('commands.skillOn') },
+                { name: 'off', value: '/project_skill off', desc: d('commands.skillOff') },
+                { name: 'view', value: '/project_skill view', desc: d('commands.skillView') },
+                { name: 'init', value: '/project_skill init', desc: d('commands.skillInit') },
+            ],
+        },
+        {
+            name: '/snapshot', desc: d('commands.snapshot'), children: [
+                { name: 'toggle', value: '/snapshot', desc: d('commands.snapshotToggle') },
+                { name: 'on', value: '/snapshot on', desc: d('commands.snapshotOn') },
+                { name: 'off', value: '/snapshot off', desc: d('commands.snapshotOff') },
+                { name: 'status', value: '/snapshot status', desc: d('commands.snapshotStatus') },
+                { name: 'refresh', value: '/snapshot_refresh', desc: d('commands.snapshotRefresh') },
+            ],
+        },
+        { name: '/theme', desc: d('commands.theme') },
+        {
+            name: '/model', desc: d('commands.model'), children: [
+                { name: 'configure', value: '/model', desc: d('commands.modelConfigure') },
+                { name: 'switch', value: '/model switch', desc: d('commands.modelSwitch') },
+                { name: 'list', value: '/model list', desc: d('commands.modelList') },
+                { name: 'show', value: '/model show', desc: d('commands.modelShow') },
+                { name: 'use <name>', value: '/model use ', submit: false, desc: d('commands.modelUse') },
+                { name: 'delete <name>', value: '/model delete ', submit: false, desc: d('commands.modelDelete') },
+            ],
+        },
+        {
+            name: '/mode', desc: d('commands.mode'), children: [
+                { name: 'plan', value: '/plan', desc: d('commands.modePlan') },
+                { name: 'auto', value: '/auto', desc: d('commands.modeAuto') },
+            ],
+        },
+        {
+            name: '/pet', desc: d('commands.pet'), children: [
+                { name: 'toggle', value: '/pet', desc: d('commands.petToggle') },
+                { name: 'skin', value: '/pet skin', desc: d('commands.petSkin') },
+                { name: 'quit', value: '/pet quit', desc: d('commands.petQuit') },
+            ],
+        },
+        {
+            name: '/image', desc: d('commands.image'), children: [
+                { name: 'attach <path>', value: '/image ', submit: false, desc: d('commands.imageAttach') },
+                { name: 'list', value: '/image list', desc: d('commands.imageList') },
+                { name: 'clear', value: '/image clear', desc: d('commands.imageClear') },
+            ],
+        },
+        {
+            name: '/language', desc: d('commands.language'), children: [
+                { name: 'zh-CN', value: '/language zh-CN', desc: d('commands.languageZh') },
+                { name: 'en', value: '/language en', desc: d('commands.languageEn') },
+            ],
+        },
+    ];
+}
+/** 从菜单树递归生成 /help 内容；叶子 value 与菜单路径不同则同时展示真实命令。 */
+function slashHelpLines(nodes = buildSlashCommands(), parentPath = '', depth = 0) {
+    const lines = [];
+    for (const node of nodes) {
+        const menuPath = parentPath ? `${parentPath} ${node.name}` : node.name;
+        const isBranch = Boolean(node.children?.length);
+        const actual = node.value?.trimEnd();
+        const mapping = actual && actual !== menuPath ? ` ${ui.dim}→ ${actual}${ui.reset}` : '';
+        const marker = isBranch ? ` ${ui.dim}›${ui.reset}` : '';
+        lines.push(`${'  '.repeat(depth)}${ui.accent}${menuPath}${ui.reset}${marker}${mapping}  ${ui.dim}${node.desc}${ui.reset}`);
+        if (node.children?.length)
+            lines.push(...slashHelpLines(node.children, menuPath, depth + 1));
+    }
+    return lines;
+}
+/** 主题名 → 本地化描述。 */
+function themeDescription(name) {
+    const key = `theme.${name}`;
+    return name in {
+        default: 1, light: 1, solarized: 1, gruvbox: 1, nord: 1, orange: 1,
+        rose: 1, emerald: 1, amber: 1, lavender: 1, sunset: 1,
+    } ? t(key) : '';
+}
 /** /model 预设后端:选一个预填 baseURL,仍可逐项改。base_url 取自 README 常见表。 */
 const MODEL_PRESETS = [
     { label: 'GLM(智谱)', baseURL: 'https://open.bigmodel.cn/api/v3', model: 'glm-4.6', window: 128000 },
@@ -146,7 +211,7 @@ function renderContextBar(history) {
     const W = 10;
     const filled = Math.round(pct * W);
     const bar = '█'.repeat(filled) + '░'.repeat(W - filled);
-    const src = contextState.lastUsage ? '实测' : '估算';
+    const src = contextState.lastUsage ? t('status.measured') : t('status.estimated');
     const k = (n) => `${Math.round(n / 1000)}k`;
     const pctCol = pct >= config.compactThreshold ? ui.yellow : ui.accent;
     const lifecycle = contextState.lifecycleStats;
@@ -155,7 +220,7 @@ function renderContextBar(history) {
         ? `\n  lifecycle · live ${lifecycle.live} · referenced ${lifecycle.referenced} · digested ${lifecycle.digested} · stubbed ${lifecycle.stubbed}`
         : '\n  lifecycle · no active snapshot (run a tool-enabled turn first)';
     const archiveLine = `\n  archived tool results · ${archived.stubbed}`;
-    return `${ui.gray}[${pctCol}${bar}${ui.reset}] ${Math.round(pct * 100)}%  ${k(est)}/${k(win)} tokens · ${history.length} 条消息 (${src})${ui.reset}${lifecycleLine}${archiveLine}`;
+    return `${ui.gray}[${pctCol}${bar}${ui.reset}] ${Math.round(pct * 100)}%  ${k(est)}/${k(win)} tokens · ${t('status.messages', { count: history.length })} (${src})${ui.reset}${lifecycleLine}${archiveLine}`;
 }
 /** 状态行用量条(精简版,进底栏):[bar] pct% k/k。
  * 只计算对话内容(不含 system prompt),让用户感知"我发了多少、agent 回复了多少"占用 context。 */
@@ -209,39 +274,38 @@ function refreshStatusBase(history, lastTurnUsage) {
 function runningStateFor(cmd) {
     switch (cmd) {
         case '/compact':
-            return { status: '压缩', placeholder: '压缩中…' };
+            return { status: t('running.compact'), placeholder: t('running.compacting') };
         case '/resume':
-            return { status: '续接', placeholder: '选择会话…' };
+            return { status: t('running.resume'), placeholder: t('running.chooseSession') };
         case '/rollback':
-            return { status: '回滚', placeholder: '选择轮次…' };
+            return { status: t('running.rollback'), placeholder: t('running.chooseTurn') };
         case '/init':
-            return { status: '初始化', placeholder: '生成 MOCODE.md…' };
+            return { status: t('running.init'), placeholder: t('running.generateMemory') };
         case '/snapshot_refresh':
-            return { status: '刷新快照', placeholder: '扫描项目文件中…' };
+            return { status: t('running.snapshot'), placeholder: t('running.scanning') };
         case '/plan':
-            return { status: '切 plan', placeholder: '…' };
+            return { status: t('running.plan'), placeholder: '…' };
         case '/auto':
-            return { status: '切 auto', placeholder: '…' };
+            return { status: t('running.auto'), placeholder: '…' };
         case '/clear':
-            return { status: '清空', placeholder: '…' };
+            return { status: t('running.clear'), placeholder: '…' };
         case '/theme':
-            return { status: '切主题', placeholder: '选择主题…' };
+            return { status: t('running.theme'), placeholder: t('running.chooseTheme') };
         case '/model':
-            return { status: '配模型', placeholder: '配置中…' };
+            return { status: t('running.model'), placeholder: t('running.configuring') };
         case '/pet':
-            return { status: '桌宠', placeholder: '处理中…' };
+            return { status: t('running.pet'), placeholder: t('running.processing') };
         case '/memory_switch':
-            return { status: '切记忆开关', placeholder: '切换中…' };
+            return { status: t('running.memory'), placeholder: t('running.switching') };
         case '/memory_status':
-            return { status: '查记忆状态', placeholder: '…' };
+            return { status: t('running.memoryStatus'), placeholder: '…' };
         case '/project_skill':
-            return { status: '项目 Skill', placeholder: '处理中…' };
+            return { status: t('running.skill'), placeholder: t('running.processing') };
         case '/snapshot':
-            return { status: '切快照开关', placeholder: '切换中…' };
+            return { status: t('running.snapshot'), placeholder: t('running.switching') };
+        case '/language':
+            return { status: t('running.language'), placeholder: t('running.chooseLanguage') };
         default:
-            // 输入框留空(运行中可 typeahead 打字,dim 回显);运行状态由内联 spinner 承载(思考中/执行…),
-            // 状态行只显走时——故常态 status 留空,不塞「处理」这种与内联重复的泛标签。
-            // 不把「思考中… Ctrl+C 中断」塞进输入框占位——避免看起来像已有输入、妨碍正常输入。
             return { status: '', placeholder: '' };
     }
 }
@@ -365,7 +429,7 @@ function stopRunningListener() {
  * 满宽 pad 使终端背景色覆盖整行(含行尾空单元格),上滑滚动时用户消息呈连续色块、与 assistant 正文区分。
  * 末尾多留一空行(\n\n 收尾):用户消息与后续(agent 流式输出 / 下条消息)之间空一行。
  */
-function formatUserMessage(lines) {
+function formatUserMessage(lines, trailingBlank = true) {
     const cols = layout.getGeo().cols;
     const promptW = displayWidth(PROMPT);
     const indent = ' '.repeat(promptW);
@@ -377,13 +441,13 @@ function formatUserMessage(lines) {
         const padded = padEndDisplay(full, cols);
         return `${userBg}${padded}${reset}`;
     })
-        .join('\n') + '\n\n');
+        .join('\n') + (trailingBlank ? '\n\n' : '\n'));
 }
 /** 把多行提交输入回显进内容区(❯ 首行,续行按 prompt 宽度缩进)。仅 TUI 态回显(非 TTY 由 readline 自带回显)。 */
-function echoInput(lines) {
+function echoInput(lines, trailingBlank = true) {
     if (!layout.isActive())
         return;
-    layout.contentWrite(formatUserMessage(lines));
+    layout.contentWrite(formatUserMessage(lines, trailingBlank));
     // 多模态附件:每张一行 chip 跟在 user bubble 后(原 /rollback /resume 复显一致)
     for (const a of pendingAttachments) {
         layout.contentWrite(`  ${ui.dim}${renderChip(a)}${ui.reset}\n`);
@@ -406,7 +470,7 @@ function echoInput(lines) {
  */
 function awaitPendingRecall(input, attachmentsCount, placeholder) {
     pendingRecall = { lines: input, attachmentsCount, placeholder };
-    layout.setStatus('发送中…  (Esc / Ctrl+C 撤回)', '●');
+    layout.setStatus(t('agent.sending'), '●');
     // 非 TTY:setRawMode 抛错 → window=0 直返 true(向后退化,不走 raw + 不挂监听)。
     let ttyReady = false;
     try {
@@ -591,6 +655,10 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null,
     // 沙箱根:文件操作边界。优先级 --sandbox-root > SANDBOX_ROOT env > process.cwd()。
     // 纯边界记录(不 chdir),jail.ts 内部 resolve。子 agent 同进程继承全局 root。
     setSandboxRoot(sandboxRootOverride ?? config.sandboxRoot ?? process.cwd());
+    // MCP 在工具表和 LLM schema 创建前连接；失败的单个 server 只给提示，不阻断 REPL。
+    const mcpReport = await initializeAllMcp();
+    registerToolsExtension('mcp', getMcpTools());
+    refreshChatTools();
     // 项目快照：sandboxRoot 设定后异步构建（完全由 LLM 生成）。
     // 构建失败不阻断 REPL：snapshot 内部 catch 所有异常。
     if (config.projectSnapshotEnabled) {
@@ -653,6 +721,12 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null,
     else {
         layout.writeBanner(bannerLines(banner()));
     }
+    if (mcpReport.connected.length > 0) {
+        layout.contentWrite(`${ui.dim}  ↳ 已连接 MCP: ${mcpReport.connected.join(', ')} (${getMcpTools().length} 个工具;外部工具每次均需授权)${ui.reset}\n`);
+    }
+    for (const warning of mcpReport.warnings) {
+        layout.contentWrite(`${ui.yellow}  ⚠ ${warning}${ui.reset}\n`);
+    }
     if (!isModelConfigured()) {
         // 未配置 baseURL/apiKey:醒目提示引导 /model(不退出,REPL 仍可用;发消息会失败但不崩)。
         layout.contentWrite(`${ui.yellow}  ⚠ 未配置大模型。输入 ${ui.cyan}/model${ui.yellow} 配置 baseURL / apiKey / model(即时生效),或退出后运行 ${ui.cyan}mocode config${ui.yellow} 走向导。${ui.reset}\n`);
@@ -854,11 +928,11 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null,
                 /不支持(视觉|图片|图像|多模态)/.test(msg) ||
                 (/图片|图像|视觉|多模态/.test(msg) && /不支持|invalid|reject|fail/i.test(lower));
             if (looksLikeImageError) {
-                layout.contentWrite(`${ui.red}[错误]${ui.reset} 当前模型 ${ui.accent}${config.model}${ui.reset} 不支持视觉输入。${ui.dim}原始:${msg}${ui.reset}\n`);
-                layout.contentWrite(`${ui.dim}提示:运行 /model 切换到支持视觉的模型(如 gpt-4o / claude-3.5-sonnet / gemini-1.5-pro)。${ui.reset}\n`);
+                layout.contentWrite(`${ui.red}${t('repl.errorLabel')}${ui.reset} ${t('repl.visionUnsupported', { model: `${ui.accent}${config.model}${ui.reset}` })}${ui.dim}${t('repl.originalError', { message: msg })}${ui.reset}\n`);
+                layout.contentWrite(`${ui.dim}${t('repl.visionHint')}${ui.reset}\n`);
             }
             else {
-                layout.contentWrite(`${ui.red}[错误]${ui.reset} ${msg}\n`);
+                layout.contentWrite(`${ui.red}${t('repl.errorLabel')}${ui.reset} ${msg}\n`);
             }
         }
         finally {
@@ -873,7 +947,7 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null,
             return; // Esc / Ctrl+D 取消
         const loaded = loadSession(pick.id);
         if (!loaded || !loaded.history.length) {
-            layout.contentWrite(`${ui.yellow}(加载失败)${ui.reset}\n`);
+            layout.contentWrite(`${ui.yellow}${t('repl.loadFailed')}${ui.reset}\n`);
             return;
         }
         if (loaded.history[0]?.role === 'system') {
@@ -893,7 +967,7 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null,
         layout.clearContent();
         renderHistory(history);
         // 末尾 \n\n:与后续用户消息(❯ bubble)之间空一行。
-        layout.contentWrite(`${ui.dim}(已续接会话 ${loaded.id})${ui.reset}\n\n`);
+        layout.contentWrite(`${ui.dim}${t('repl.resumed', { id: loaded.id })}${ui.reset}\n\n`);
     }
     while (true) {
         // INPUT 态:画底栏输入框 + 状态行,光标入输入框
@@ -905,12 +979,12 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null,
             layout.contentWrite(`  ${ui.gray}↳ ${formatReflectResult(reflectRes)}${ui.reset}\n`);
             clearLastReflectResult();
         }
-        layout.enterInputMode('空闲');
+        layout.enterInputMode(t('repl.idle'));
         let input = null;
         try {
             input = await promptWithSlashMenu({
                 prompt: PROMPT,
-                commands: SLASH_COMMANDS,
+                commands: buildSlashCommands(),
                 onCycleMode: cycleMode,
                 // /rollback 预填优先;否则上一轮运行中 typeahead 打的字 → 预填进输入框,用户可改可发
                 ...(pendingPrefill
@@ -934,34 +1008,69 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null,
         if (line === '/exit' || line === '/quit')
             break;
         // RUNNING 态:回显输入 → 底栏改 dim 占位、光标回内容续写位
-        echoInput(input);
         const cmd = line.split(/\s+/)[0];
-        const { status, placeholder } = runningStateFor(cmd);
+        // 语言命令把视觉分隔放在确认文案之后；避免回显后先空一行、下一条命令却紧贴确认。
+        echoInput(input, cmd !== '/language');
+        const state = runningStateFor(cmd);
+        const placeholder = line === '/snapshot_refresh' || line === '/project_skill init'
+            ? ''
+            : state.placeholder;
         refreshStatusBase(history);
-        layout.enterRunningMode(status, placeholder);
+        layout.enterRunningMode(state.status, placeholder);
+        if (line === '/help') {
+            layout.contentWrite(`${ui.bold}${t('help.title')}${ui.reset}\n`);
+            layout.contentWrite(`${ui.dim}${t('help.hint')}${ui.reset}\n`);
+            layout.contentWrite(`${slashHelpLines().join('\n')}\n`);
+            continue;
+        }
+        if (line === '/language' || line.startsWith('/language ')) {
+            const arg = line === '/language' ? '' : line.slice('/language '.length).trim();
+            if (!arg) {
+                const currentName = getLanguage() === 'zh-CN' ? t('language.zh') : t('language.en');
+                layout.contentWrite(`${ui.dim}${t('language.current', { language: currentName })}${ui.reset}\n`);
+                layout.contentWrite(`${ui.dim}${t('language.usage')}${ui.reset}\n\n`);
+                continue;
+            }
+            const next = normalizeLanguage(arg);
+            if (!next) {
+                layout.contentWrite(`${ui.yellow}${t('language.invalid', { value: arg })}${ui.reset}\n\n`);
+                continue;
+            }
+            updateLanguageConfig(next);
+            updateConfigKey('MOCODE_LANGUAGE', next);
+            history[0] = { role: 'system', content: buildSystemMessage(getAgentMode() === 'plan') };
+            refreshStatusBase(history);
+            // 横幅是内容缓冲顶部的固定区域；语言切换后等长原地替换，不移动后续对话。
+            layout.rewriteBanner(bannerLines(banner()));
+            layout.contentWrite(`${ui.cyan}${t('language.changed')}${ui.reset}\n`);
+            if (languageFromShell) {
+                layout.contentWrite(`${ui.dim}${t('language.shellOverride')}${ui.reset}\n`);
+            }
+            layout.contentWrite('\n');
+            continue;
+        }
         if (line === '/init') {
             // /init:把 init 指令当 user 输入发给 agent(扫描项目 + 生成 MOCODE.md),fall through 走 runAgent
             joined = INIT_PROMPT;
         }
         if (line === '/plan') {
-            // /plan:切到 plan 模式(只读探查 + 产出计划)。Shift+Tab 的可靠后备——
-            // 中文 IME(微软拼音用 Shift 切中英)与部分终端会吞掉 Shift+Tab 的 \x1b[Z,命令不受影响。
+            // /plan:切到 plan 模式(只读探查 + 产出计划)。
             if (getAgentMode() === 'plan') {
-                layout.contentWrite(`${ui.dim}(已在 plan 模式)${ui.reset}\n`);
+                layout.contentWrite(`${ui.dim}${t('repl.planAlready')}${ui.reset}\n`);
             }
             else {
-                setAgentMode('plan'); // listener 接手 applyMode + refreshStatusBase
-                layout.contentWrite(`${ui.dim}(已切到 plan 模式:只读探查 + 产出计划,审批后切 auto 执行。/auto 或 Shift+Tab 切回)${ui.reset}\n`);
+                setAgentMode('plan');
+                layout.contentWrite(`${ui.dim}${t('repl.planChanged')}${ui.reset}\n`);
             }
             continue;
         }
         if (line === '/auto') {
             if (getAgentMode() === 'auto') {
-                layout.contentWrite(`${ui.dim}(已在 auto 模式)${ui.reset}\n`);
+                layout.contentWrite(`${ui.dim}${t('repl.autoAlready')}${ui.reset}\n`);
             }
             else {
-                setAgentMode('auto'); // listener 接手 applyMode + refreshStatusBase
-                layout.contentWrite(`${ui.dim}(已切回 auto 模式:全工具执行)${ui.reset}\n`);
+                setAgentMode('auto');
+                layout.contentWrite(`${ui.dim}${t('repl.autoChanged')}${ui.reset}\n`);
             }
             continue;
         }
@@ -1028,7 +1137,7 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null,
             pendingAttachments = []; // 一并清空待发图片
             layout.clearContent();
             layout.writeBanner(bannerLines(banner()));
-            layout.contentWrite(`${ui.dim}(历史已清空,保留系统提示)${ui.reset}\n`);
+            layout.contentWrite(`${ui.dim}${t('repl.historyCleared')}${ui.reset}\n`);
             continue;
         }
         // /image:附加本地图片到下一条 user 消息(支持 /image <path> · /image list · /image clear)。
@@ -1205,10 +1314,11 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null,
             }
             // buildSnapshot 是异步操作(完全由 LLM 生成)，显示进度提示
             layout.contentWrite(`${ui.dim}正在重新生成项目快照 (LLM 分析中)...${ui.reset}\n`);
+            const signal = startRunningListener('');
             try {
                 // 清除缓存，强制重新生成
                 clearSnapshotCache();
-                const result = await buildSnapshot(undefined, true);
+                const result = await buildSnapshot(signal, true);
                 if (result.snapshot) {
                     layout.contentWrite(`${ui.cyan}✓ 项目快照已刷新${ui.reset} (${result.snapshot.builtAt})\n`);
                     layout.contentWrite(`${ui.dim}已生成 markdown 快照，注入到系统提示词中${ui.reset}\n`);
@@ -1230,6 +1340,9 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null,
                 const msg = e instanceof Error ? e.message : String(e);
                 layout.contentWrite(`${ui.red}[错误]${ui.reset} 刷新快照失败: ${msg}\n`);
             }
+            finally {
+                stopRunningListener();
+            }
             continue;
         }
         if (line === '/sessions') {
@@ -1290,7 +1403,7 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null,
                 const items = listThemes().map((t) => ({
                     id: t,
                     title: t,
-                    subtitle: THEME_DESCRIPTIONS[t] ?? '',
+                    subtitle: themeDescription(t),
                 }));
                 let pick;
                 try {
@@ -1302,11 +1415,11 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null,
                 name = pick?.id ?? null;
             }
             else if (arg === 'list' || !themeExists(arg)) {
-                layout.contentWrite(`${ui.dim}可用主题:${ui.reset}\n`);
-                for (const t of listThemes()) {
-                    layout.contentWrite(`  ${ui.accent}${t}${ui.reset}  ${ui.dim}${THEME_DESCRIPTIONS[t] ?? ''}${ui.reset}\n`);
+                layout.contentWrite(`${ui.dim}${t('repl.themeList')}${ui.reset}\n`);
+                for (const theme of listThemes()) {
+                    layout.contentWrite(`  ${ui.accent}${theme}${ui.reset}  ${ui.dim}${themeDescription(theme)}${ui.reset}\n`);
                 }
-                layout.contentWrite(`${ui.dim}(当前:${getTheme()};用 /theme <名称> 切换)${ui.reset}\n`);
+                layout.contentWrite(`${ui.dim}${t('repl.themeCurrent', { theme: getTheme() })}${ui.reset}\n`);
                 continue;
             }
             else {
@@ -1326,7 +1439,7 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null,
             else {
                 layout.writeBanner(bannerLines(banner()));
             }
-            layout.contentWrite(`${ui.dim}(已切换主题 ${name})${ui.reset}\n`);
+            layout.contentWrite(`${ui.dim}${t('repl.themeChanged', { theme: name })}${ui.reset}\n`);
             updateConfigKey('MOCODE_THEME', name);
             if (config.themeFromShell) {
                 layout.contentWrite(`${ui.dim}(shell 环境变量 MOCODE_THEME 已设,文件写入下次启动被其覆盖;取消该 shell 设置后生效)${ui.reset}\n`);
@@ -1797,48 +1910,29 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null,
                     }
                     continue;
                 }
-                // /project_skill init — 扫描项目并生成/优化 skill
+                // /project_skill init — 作为一条普通主 Agent 请求生成/优化 skill，不再派生高消耗子 agent。
                 if (arg === 'init') {
                     if (!isProjectSkillEnabled()) {
                         layout.contentWrite(`${ui.yellow}⚠ 项目专属 Skill 尚未开启${ui.reset}，请先运行 ${ui.cyan}/project_skill on${ui.reset}\n`);
                         continue;
                     }
-                    const { readProjectSkill, writeProjectSkill } = await import('../project-skill/index.js');
-                    const existing = readProjectSkill();
-                    if (existing) {
-                        layout.contentWrite(`${ui.cyan}⏳ 正在深度探索项目并优化现有 skill...${ui.reset}\n`);
-                    }
-                    else {
-                        layout.contentWrite(`${ui.cyan}⏳ 正在深度探索项目（子 agent 将使用工具扫描代码、架构、配置等）...${ui.reset}\n`);
-                    }
-                    layout.contentWrite(`${ui.dim}提示: 按 Ctrl+C 可中断${ui.reset}\n\n`);
-                    // 派生子 agent 深度探索项目
-                    const { generateInitialSkill } = await import('../project-skill/initializer.js');
-                    const result = await generateInitialSkill(existing ?? undefined, currentAbort?.signal);
-                    // 显示探索过程日志
-                    if (result.transcript) {
-                        layout.contentWrite(`${ui.dim}--- 探索过程 ---${ui.reset}\n`);
-                        layout.contentWrite(result.transcript);
-                        layout.contentWrite(`${ui.dim}--- 探索结束 ---${ui.reset}\n\n`);
-                    }
-                    if (result.ok && result.content) {
-                        const writeResult = writeProjectSkill(result.content);
-                        if (writeResult.ok) {
-                            layout.contentWrite(`${ui.green}✓ 项目 Skill 已生成${ui.reset}\n`);
-                            layout.contentWrite(`${ui.dim}内容预览:${ui.reset}\n${result.content.slice(0, 500)}${result.content.length > 500 ? '...' : ''}\n`);
-                            layout.contentWrite(`\n${ui.dim}文件: ${ui.accent}.mocode/project-skill.md${ui.reset} (${result.content.length} 字符)\n`);
-                            layout.contentWrite(`${ui.dim}下次启动时会自动注入到系统提示词。Agent 也会在开发过程中持续更新。${ui.reset}\n`);
-                            layout.contentWrite(`${ui.dim}提示: 可用 ${ui.cyan}/project_skill view${ui.reset} 查看完整内容，或手动编辑文件完善。${ui.dim}${ui.reset}\n`);
-                        }
-                        else {
-                            layout.contentWrite(`${ui.red}✗ 写入失败:${ui.reset} ${writeResult.error}\n`);
-                        }
+                    const initPrompt = `请直接初始化或优化当前项目的 Project Skill，并完成写入。
+
+要求：
+1. 直接由你完成，禁止调用 task 工具或派生任何子 agent。
+2. 优先利用系统提示中已有的 Project Snapshot 和 Project Skill；不要重复扫描其中已有的目录、依赖、命令和模块清单。
+3. 最多进行 1 次 codegraph 探索；只有缺少关键依据时，才额外进行少量定点 read_file/grep。禁止全仓 glob 和逐文件扫描。
+4. Skill 只记录 Snapshot 无法提供的 WHY/HOW/GOTCHAS/CONVENTIONS：设计取舍、关键调用链、非直觉边界、项目约定和可操作坑点。使用具体路径和例子，删除重复或过时内容。
+5. 最终内容应完整、结构清晰。调用 project_skill_update，使用 action=write 一次性写入完整内容。
+6. 写入成功后只简短说明更新了哪些关键洞察，不要输出完整 Skill。`;
+                    const previousMode = getAgentMode();
+                    try {
+                        await runTurn(initPrompt, false, '');
                     }
-                    else {
-                        layout.contentWrite(`${ui.red}✗ 探索失败:${ui.reset} ${result.error}\n`);
-                        if (result.transcript) {
-                            layout.contentWrite(`${ui.dim}子 agent 输出了部分内容（见上方），但未能生成完整的 skill 文档。${ui.reset}\n`);
-                        }
+                    finally {
+                        // init 是一次明确写操作，临时使用 auto；完成后恢复用户原来的模式。
+                        if (previousMode === 'plan')
+                            setAgentMode('plan');
                     }
                     continue;
                 }
@@ -1988,7 +2082,7 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null,
             // (runTurn 入口的 pendingAttachments.flush 仍按现有逻辑把附件塞进 userInput)。
             layout.rewindContent(bubbleRows);
             pendingPrefill = input;
-            layout.enterInputMode('空闲');
+            layout.enterInputMode(t('repl.idle'));
             continue;
         }
         const initialPlan = getAgentMode() === 'plan'; // 轮首模式(在 runTurn 之前读)
@@ -2000,21 +2094,23 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null,
             // 桌宠:计划审批面板弹出期间广播 waiting_human(红灯闪烁);面板不在 runAgent/hooks 体系内,
             // 需在此单独广播——用户响应后由下一次 /pet 状态事件(或 idle 兜底)覆盖。
             sendState('waiting_human');
+            const executePlanOption = t('plan.execute');
             const res = await promptIntervention({
                 type: 'choice',
-                title: '计划已就绪',
-                detail: '切换到 auto 模式按上述计划执行?(plan 模式只读探查,执行需切 auto)',
-                options: ['切 auto 执行', '留 plan 细化'],
+                title: t('plan.ready'),
+                detail: t('plan.approvalDetail'),
+                options: [executePlanOption, t('plan.refine')],
             });
             sendState('idle');
-            if (res.action === 'selected' && res.value === '切 auto 执行') {
+            if (res.action === 'selected' && res.value === executePlanOption) {
                 // setAgentMode('auto') 由 runTurn 入口做(listener 重写 history[0] 回 auto);这里只切运行态 + 合成执行轮。
-                layout.enterRunningMode('执行', '按计划执行…');
-                await runTurn('请按上述计划执行。', false, '按计划执行…');
+                layout.enterRunningMode(t('plan.running'), t('plan.executing'));
+                await runTurn(t('plan.executePrompt'), false, t('plan.executing'));
             }
         }
     }
     // 退出前等在飞反思收尾(Ctrl+C 走 SIGINT 直退不等;fire-and-forget 不承诺中断时完成)。
     await drainMemoryBackground();
+    await closeAllMcp();
     layout.exitAltScreen();
 }