mocode-ai 0.1.4 → 0.1.6

package/dist/repl/index.js

@@ -1,12 +1,17 @@
 import readline from 'node:readline/promises';
 import { emitKeypressEvents } from 'node:readline';
 import { stdin, stdout } from 'node:process';
-import { config } from '../config/index.js';
+import { config, PLAN_MODE_SUFFIX } from '../config/index.js';
+import { updateConfigKey } from '../config/file.js';
 import { runAgent } from '../agent/index.js';
-import { ui } from '../ui/theme.js';
+import { getAgentMode, setAgentMode, onModeChange } from '../agent/mode.js';
+import { setSandboxRoot } from '../sandbox/root.js';
+import { ui, setTheme, getTheme, listThemes, themeExists } from '../ui/theme.js';
 import { bannerString, displayWidth, padEndDisplay, summarizeToolCall, summarizeToolResult } from '../ui/render.js';
 import * as layout from '../ui/layout.js';
-import { promptWithSlashMenu, promptTurnPicker, promptSessionPicker, } from '../ui/prompt.js';
+import * as mouse from '../ui/mouse.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, estimateToolSchemaTokens, } from '../llm/index.js';
 import { compactHistory, contextState, newSessionId, saveSession, loadSession, listSessions, } from '../session/index.js';
@@ -26,40 +31,50 @@ const SLASH_COMMANDS = [
     { name: '/skills', desc: '列出已发现的 skill' },
     { name: '/compact', desc: '压缩历史(可带焦点 /compact …)' },
     { name: '/resume', desc: '续接已保存的会话' },
-    { name: '/think', desc: '展开折叠思考段(/think N)' },
     { name: '/rollback', desc: '菜单选轮次回滚(↑↓·Enter)' },
     { name: '/memory', desc: '记忆库:条目计数与近期索引' },
     { name: '/reflect', desc: '手动触发后台记忆反思 pass' },
     { name: '/init', desc: '扫描项目生成 MOCODE.md 项目记忆' },
+    { name: '/theme', desc: '切换颜色主题(↑↓·Enter)' },
+    { name: '/plan', desc: '切到 plan 模式(只读探查+产出计划)' },
+    { name: '/auto', desc: '切回 auto 模式(全工具执行)' },
 ];
+/** 主题名 → 一句描述(供 /theme 菜单 / 列表显示)。新增主题时在 src/ui/theme.ts THEMES 加键后于此补一句。 */
+const THEME_DESCRIPTIONS = {
+    default: '16 色原版(深底)',
+    light: '浅底终端',
+    solarized: 'Solarized 强调色',
+    gruvbox: 'Gruvbox 暖色',
+    nord: 'Nord 冷色',
+};
 /**
  * /init 指令:发给 agent 扫描项目并生成 MOCODE.md(对标 Claude Code /init 生成 CLAUDE.md,
  * 但 mocode 读 MOCODE.md)。已存在则让 agent 读后更新(不丢失事实)。写完供 memory 子系统下轮加载。
  */
-const INIT_PROMPT = `分析当前项目(process.cwd()),生成 MOCODE.md 项目记忆文件,供 mocode 后续会话自动加载——目标是让后续会话无需重新摸索就能上手。
-
-先探查(尽量少调用拿全貌):
-- read_file package.json(或 Cargo.toml/pyproject.toml/go.mod 等):scripts、依赖、入口、模块类型。
-- glob 顶层目录;read_file 入口文件 + 各子系统 index.ts/README。
-- 若有 .codegraph/:run_command codegraph explore "<架构或入口符号>" 一次拿相关源码+调用路径,别逐文件读。
-- 若 MOCODE.md 已存在:read_file 读它,在其基础上更新(补缺、修正过时),不丢已有准确事实。
-
-MOCODE.md 按以下结构写(每节简短,只写稳定、非显然的事实):
-## 项目
-一两句:是什么、技术栈、运行环境。
-## 命令
-install / dev / build / test / typecheck / lint 等——从 package.json scripts 提炼,写原样命令行(如 \`npm run typecheck\`);没有的注明"无测试"/"无 lint"。
-## 目录结构
-顶层各目录与子系统职责,一句话/个;不逐文件列。
-## 约定
-从代码与现有文档提炼的硬约定:模块系统(ESM?)、命名、错误处理、工具/函数契约、易踩坑点。只写非显然、会让人踩坑的;不写"保持简洁"这种正确废话。
-## 扩展点
-加工具/命令/provider/模块的接缝(改哪个文件、加在哪)。
-
-硬要求:
-- 从实际代码提炼,引用具体文件名/命令/符号;不编造、不泛泛。
-- 总长 ≤ 1500 字;只写后续会话有用的稳定事实,不写易变项(当前 bug、临时文件、未决 TODO)。
-- 用 write_file 写入项目根 MOCODE.md。
+const INIT_PROMPT = `分析当前项目(process.cwd()),生成 MOCODE.md 项目记忆文件,供 mocode 后续会话自动加载——目标是让后续会话无需重新摸索就能上手。
+
+先探查(尽量少调用拿全貌):
+- 若有 .codegraph/:用 codegraph 工具(explore "<架构或入口符号>")一次拿相关源码+调用路径,别逐文件读！！！
+- read_file package.json(或 Cargo.toml/pyproject.toml/go.mod 等):scripts、依赖、入口、模块类型。
+- glob 顶层目录;read_file 入口文件 + 各子系统 index.ts/README。
+- 若 MOCODE.md 已存在:read_file 读它,在其基础上更新(补缺、修正过时),不丢已有准确事实。
+
+MOCODE.md 按以下结构写(每节简短,只写稳定、非显然的事实):
+## 项目
+一两句:是什么、技术栈、运行环境。
+## 命令
+install / dev / build / test / typecheck / lint 等——从 package.json scripts 提炼,写原样命令行(如 \`npm run typecheck\`);没有的注明"无测试"/"无 lint"。
+## 目录结构
+顶层各目录与子系统职责,一句话/个;不逐文件列。
+## 约定
+从代码与现有文档提炼的硬约定:模块系统(ESM?)、命名、错误处理、工具/函数契约、易踩坑点。只写非显然、会让人踩坑的;不写"保持简洁"这种正确废话。
+## 扩展点
+加工具/命令/provider/模块的接缝(改哪个文件、加在哪)。
+
+硬要求:
+- 从实际代码提炼,引用具体文件名/命令/符号;不编造、不泛泛。
+- 总长 ≤ 1500 字;只写后续会话有用的稳定事实,不写易变项(当前 bug、临时文件、未决 TODO)。
+- 用 write_file 写入项目根 MOCODE.md。
 - 写完简述:写了哪几节 + 从代码里发现的 2-3 条非显然关键约定(供用户校验)。`;
 /** 临时 readline 读一行(cooked,用于子提问;主输入走 promptWithSlashMenu)。 */
 async function askLine(prompt) {
@@ -80,7 +95,7 @@ function renderContextBar(history) {
     const pct = Math.min(1, est / win);
     const W = 10;
     const filled = Math.round(pct * W);
-    const bar = '█'.repeat(filled) + '░'.repeat(W - filled);
+    const bar = filled === 0 ? ' '.repeat(W) : '█'.repeat(filled) + '░'.repeat(W - filled);
     const src = contextState.lastUsage ? '实测' : '估算';
     const k = (n) => `${Math.round(n / 1000)}k`;
     const pctCol = pct >= config.compactThreshold ? ui.yellow : ui.cyan;
@@ -95,17 +110,18 @@ function renderContextBarInline(history) {
     const pct = Math.min(1, est / win);
     const W = 10;
     const filled = Math.round(pct * W);
-    const bar = '█'.repeat(filled) + '░'.repeat(W - filled);
+    const bar = filled === 0 ? ' '.repeat(W) : '█'.repeat(filled) + '░'.repeat(W - filled);
     const k = (n) => `${Math.round(n / 1000)}k`;
     const pctCol = pct >= config.compactThreshold ? ui.yellow : ui.cyan;
     return `${ui.gray}[${pctCol}${bar}${ui.reset}] ${pctCol}${Math.round(pct * 100)}%${ui.reset} ${ui.dim}${k(est)}/${k(win)}${ui.reset}`;
 }
-/** 状态行基线:模型 / context / cwd。repl 在轮次边界调,刷新 context 用量。 */
+/** 状态行基线:模型 / context / cwd / 模式标识。repl 在轮次边界与切模式时调,刷新 context 用量与 mode chip。 */
 function refreshStatusBase(history) {
     layout.setStatusBase({
         model: config.model,
         contextBar: renderContextBarInline(history),
         cwd: process.cwd(),
+        modeTag: getAgentMode() === 'plan' ? 'plan' : 'auto',
     });
 }
 /** 命令 → 运行态状态文字 + 底栏 dim 占位。 */
@@ -119,12 +135,19 @@ function runningStateFor(cmd) {
             return { status: '回滚', placeholder: '选择轮次…' };
         case '/init':
             return { status: '初始化', placeholder: '生成 MOCODE.md…' };
+        case '/plan':
+            return { status: '切 plan', placeholder: '…' };
+        case '/auto':
+            return { status: '切 auto', placeholder: '…' };
         case '/clear':
             return { status: '清空', placeholder: '…' };
+        case '/theme':
+            return { status: '切主题', placeholder: '选择主题…' };
         default:
-            // 输入框留空(运行中可 typeahead 打字,dim 回显);运行状态由状态行 spinner 承载,
-            // 不再把「思考中… Ctrl+C 中断」塞进输入框占位——避免看起来像已有输入、妨碍正常输入。
-            return { status: '处理', placeholder: '' };
+            // 输入框留空(运行中可 typeahead 打字,dim 回显);运行状态由内联 spinner 承载(思考中/执行…),
+            // 状态行只显走时——故常态 status 留空,不塞「处理」这种与内联重复的泛标签。
+            // 不把「思考中… Ctrl+C 中断」塞进输入框占位——避免看起来像已有输入、妨碍正常输入。
+            return { status: '', placeholder: '' };
     }
 }
 const emitter = stdin;
@@ -134,11 +157,20 @@ let runningInput = ''; // 运行中已打字缓冲(单行;agent 结束后预填
 let runningPlaceholder = '';
 let currentAbort = null;
 let pendingPrefill = null; // /rollback 选中后预填的 user 输入(下轮 INPUT 态消费)
+// agent 模式状态已提到 src/agent/mode.ts(共享叶子:switch_mode 工具可写、agent 每步读、repl 注册 onModeChange 监听器)。
 /** 运行态按键:滚动优先,再 Ctrl+C 中断,再 typeahead 编辑(单行,Enter=无操作)。 */
 function onRunningKey(_str, key) {
     if (!key)
         return;
-    // 滚动回看键(优先;不触发回尾):PgUp/PgDn 翻页,↑/↓ 单行(含鼠标滚轮——alt 屏滚轮转发↑↓)。
+    // SGR 鼠标滚轮:readline 把 \x1B[<btn;col;rowM 拆成多 fragment,经 mouse.consumeMouse 重组;
+    // 滚轮 → scrollBy(±5)(不调 setUserActive——与键盘滚动一致;流式 flushTimer 在 scrollOffset>0 时不重画,安全)。
+    const _m = mouse.consumeMouse(key.sequence ?? '');
+    if (_m.suppress) {
+        if (_m.wheel)
+            layout.scrollBy(_m.wheel * 5);
+        return;
+    }
+    // 滚动回看键(优先;不触发回尾):PgUp/PgDn 翻页,↑/↓ 每次 5 行(键盘;鼠标滚轮已由上方守卫处理)。
     // 运行态无输入光标,↑/↓ 无其他用途,直接作滚动。
     if (key.name === 'pageup' ||
         key.name === 'pagedown' ||
@@ -150,17 +182,27 @@ function onRunningKey(_str, key) {
         else if (key.name === 'pagedown')
             layout.scrollBy(-pageH);
         else if (key.name === 'up')
-            layout.scrollBy(1);
+            layout.scrollBy(5);
         else
-            layout.scrollBy(-1);
+            layout.scrollBy(-5);
         return;
     }
+    // 用户在交互(非滚动键)→ 暂停流式物理写,避免光标去 contentRow 扰动 IME 候选窗(停手后自动 flush)
+    layout.setUserActive();
     // 其他键:若处于滚动回看,先回尾再处理(打字即回底)
     if (layout.isScrolled())
         layout.resetScroll();
-    // Ctrl+C 中断当前 agent 轮次(不退进程;raw 模式下 Ctrl+C 是按键,不触发 SIGINT)
+    // Ctrl+C 4 层语义(RUNNING 态):有 typeahead → 清空(层 1,不中断);空 → abort(层 2,中断 agent)。
+    // 两次 Ctrl+C 才中断(先清 typeahead 再 abort),与 INPUT 态 onCtrlC 的 fish 式一致。
+    // raw 模式下 Ctrl+C 是按键不触发 SIGINT;signal 经 executeTool 串进工具,run_command/web_fetch 即时被杀。
     if (key.ctrl && key.name === 'c') {
-        currentAbort?.abort();
+        if (runningInput.length > 0) {
+            runningInput = '';
+            layout.paintRunningInputEcho(runningInput, runningPlaceholder);
+        }
+        else {
+            currentAbort?.abort();
+        }
         return;
     }
     const s = key.sequence ?? '';
@@ -214,6 +256,7 @@ function stopRunningListener() {
  * 把用户消息格式化为带满宽背景色的文本(上滑时易辨认用户消息)。
  * 每行用 padEndDisplay 填充到终端宽度(含 ❯ / 缩进),背景色 SGR 包裹整行 + 行末 reset。
  * 满宽 pad 使终端背景色覆盖整行(含行尾空单元格),上滑滚动时用户消息呈连续色块、与 assistant 正文区分。
+ * 末尾多留一空行(\n\n 收尾):用户消息与后续(agent 流式输出 / 下条消息)之间空一行,仿 Claude Code。
  */
 function formatUserMessage(lines) {
     const cols = layout.getGeo().cols;
@@ -227,7 +270,7 @@ function formatUserMessage(lines) {
         const padded = padEndDisplay(full, cols);
         return `${userBg}${padded}${reset}`;
     })
-        .join('\n') + '\n');
+        .join('\n') + '\n\n');
 }
 /** 把多行提交输入回显进内容区(❯ 首行,续行按 prompt 宽度缩进)。仅 TUI 态回显(非 TTY 由 readline 自带回显)。 */
 function echoInput(lines) {
@@ -267,7 +310,7 @@ export function renderHistory(history) {
         if (m.role === 'assistant') {
             const text = textOf(m.content);
             if (text) {
-                layout.contentWrite(text);
+                layout.contentWriteMdOnce(text);
                 if (!text.endsWith('\n'))
                     layout.contentWrite('\n');
             }
@@ -299,17 +342,27 @@ export function renderHistory(history) {
  * contentWrite 落入内容区(滚动区域内自动滚动,底栏不动)。history 由本模块持有,在轮次间持久;
  * agent 只读取并追加(+ 经 session/ 压缩)。每轮成功结束后自动落盘,退出后可用 --resume / /resume 续接。
  */
-export async function startRepl(initialHistory, sessionId, updateNotice = null) {
+export async function startRepl(initialHistory, sessionId, updateNotice = null, sandboxRootOverride) {
+    // 模式重置:agentMode 不落盘,每个 REPL 会话从 auto 开始(/resume / --resume 亦重置)。
+    setAgentMode('auto');
+    // 沙箱根:文件操作边界。优先级 --sandbox-root > SANDBOX_ROOT env > process.cwd()。
+    // 纯边界记录(不 chdir),jail.ts 内部 resolve。子 agent 同进程继承全局 root。
+    setSandboxRoot(sandboxRootOverride ?? config.sandboxRoot ?? process.cwd());
+    // 构造系统提示:auto 用 base;plan 在 config.systemPrompt 后追加 PLAN_MODE_SUFFIX。
+    // 切模式时 applyMode 重算 history[0](history[0] 恒 system,compaction 保它,不破坏)。
+    const buildSystemMessage = (planMode) => effectiveSystemPrompt(config.systemPrompt +
+        (planMode ? PLAN_MODE_SUFFIX : '') +
+        buildMemorySection() +
+        buildMemoryIndexSection());
     // 有预加载(--resume)则用它,并把 history[0] 刷成当前 system prompt(config 可能已变);
-    // 否则新会话只塞 system 提示。
-    const systemPrompt = effectiveSystemPrompt(config.systemPrompt + buildMemorySection() + buildMemoryIndexSection());
+    // 否则新会话只塞 system 提示(默认 auto)。
     const history = initialHistory && initialHistory.length
         ? initialHistory
-        : [{ role: 'system', content: systemPrompt }];
+        : [{ role: 'system', content: buildSystemMessage(false) }];
     if (initialHistory &&
         initialHistory.length &&
         history[0]?.role === 'system') {
-        history[0] = { role: 'system', content: systemPrompt };
+        history[0] = { role: 'system', content: buildSystemMessage(false) };
     }
     // --resume:读回该会话的轮次/快照;无文件则从 history 重建 turns(无快照→旧轮次文件改动不可撤销)
     if (sessionId && initialHistory && initialHistory.length) {
@@ -319,8 +372,6 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null)
     let currentSessionId = sessionId;
     // 反思 cadence 计数:每 reflectEveryN 轮 fire-and-forget 一次后台反思 pass。
     let turnCount = 0;
-    // 本会话累积的折叠思考段,供 /think N 重打原文。
-    const collapsedThinkings = [];
     const toolsLine = tools.map((t) => t.name).join(' · ');
     const banner = () => ({
         model: config.model,
@@ -328,7 +379,9 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null)
         cwd: process.cwd(),
         tools: toolsLine,
     });
-    // 开场:进 alt screen + 状态基线 + 清内容区。--resume 有历史则渲染对话(仿 Claude Code),否则横幅。
+    // 开场:按 config.theme 切主题(横幅 / 状态行 / 后续渲染皆用新色),再进 alt screen + 状态基线 + 清内容区。
+    // --resume 有历史则渲染对话(仿 Claude Code),否则横幅。
+    setTheme(config.theme);
     layout.enterAltScreen();
     refreshStatusBase(history);
     layout.clearContent();
@@ -343,10 +396,29 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null)
         // 自更新提示:开场静态段(进 INPUT 态前),dim 一行,不与流式 / 输入争用。
         layout.contentWrite(`  ${ui.gray}↳ ${updateNotice}${ui.reset}\n`);
     }
+    layout.contentWrite(`${ui.dim}  /plan · /auto · Shift+Tab 切换模式(plan:只读探查 + 产出计划,审批后切 auto 执行)${ui.reset}\n`);
+    /**
+     * 切换 agent 模式(Shift+Tab 触发,经 prompt.ts 的 onCycleMode 回调)。
+     * cycleMode 翻 agentMode + applyMode 重写 history[0] + refreshStatusBase 设状态行 modeTag;
+     * 随后 prompt.ts 自调 redraw() 经 paintInput 把 chip 画出来(光标留输入框,不调 drawStatusBar)。
+     */
+    const applyMode = (planMode) => {
+        history[0] = { role: 'system', content: buildSystemMessage(planMode) };
+    };
+    const cycleMode = () => {
+        setAgentMode(getAgentMode() === 'plan' ? 'auto' : 'plan'); // listener 接手 applyMode + refreshStatusBase
+    };
+    // 注册模式变更监听器:switch_mode 工具 / cycleMode / /plan / /auto / runTurn 调 setAgentMode 时同步触发,
+    // 重写 history[0] 系统提示(切 plan 追加 PLAN_MODE_SUFFIX)+ 刷状态行 modeTag。
+    // 不调 drawStatusBar:INPUT 态靠 prompt.ts redraw 画 chip;RUNNING 态(switch_mode 中途切)靠 200ms turnTimer 兜底。
+    onModeChange((m) => {
+        applyMode(m === 'plan');
+        refreshStatusBase(history);
+    });
     /**
      * 回滚子流程(由 /rollback 触发):菜单(↑/↓)选轮次 → 选中第 X 轮 = 删第 X 轮及之后 + 预填第 X 轮 user 输入
-     * (仿 Claude Code rewind,Enter 重新跑该轮);被删轮次的文件改动仍逐个「保留/撤销」询问(cooked readline)。
-     * 选轮菜单走 promptTurnPicker(raw mode);文件询问走 askLine(cooked)。预填经 pendingPrefill 注入下轮 INPUT。
+     * (仿 Claude Code rewind,Enter 重新跑该轮);被删轮次的文件改动走二选一菜单(promptRevertChoice:
+     * 撤销文件 / 只撤销消息)。选轮 + 方式菜单均走 raw mode。预填经 pendingPrefill 注入下轮 INPUT。
      */
     const rollbackFlow = async () => {
         const turnList = listTurns();
@@ -384,24 +456,25 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null)
             dim: true,
         });
         const revertPaths = new Set();
-        for (const c of plan.changes) {
-            layout.contentWrite(`  ${ui.cyan}${c.path}${ui.reset} ${ui.dim}(${c.ops.join(', ')})${ui.reset}\n`);
-            let ans = '';
+        // 文件撤销:二选一菜单(1=撤销文件改动 / 2=只撤销消息保留文件)
+        // 返回 true=撤销文件(把 changes 里所有可撤销的路径加入 revertPaths);
+        // false/null(取消/非 TTY/Ctrl+C)=只撤销消息,保留文件改动。
+        const changes = plan.changes;
+        const revertable = changes.filter((c) => c.snapshotAvailable);
+        let revertFiles = false;
+        if (changes.length > 0) {
             try {
-                ans = (await askLine('  保留/撤销 [k/u](回车=保留): ')).trim();
+                const choice = await promptRevertChoice(revertable.length);
+                revertFiles = choice === true;
             }
             catch {
-                continue;
-            }
-            if (ans.startsWith('u') || ans.startsWith('U')) {
-                if (c.snapshotAvailable) {
-                    revertPaths.add(c.path);
-                }
-                else {
-                    layout.contentWrite(`${ui.dim}  (无快照,无法撤销——保留)${ui.reset}\n`);
-                }
+                revertFiles = false; // Ctrl+C(SIGINT)→ 保留文件,只撤销消息
             }
         }
+        if (revertFiles) {
+            for (const c of revertable)
+                revertPaths.add(c.path);
+        }
         applyRollback(plan, history, revertPaths);
         if (!currentSessionId)
             currentSessionId = newSessionId();
@@ -417,6 +490,52 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null)
         renderHistory(history);
         pendingPrefill = prefillText.split('\n');
     };
+    /**
+     * 跑一轮 agent(enterRunningMode 已由调用方完成):startRunningListener → runAgent → autosave / reflect。
+     * plan 模式传 planMode=true(runAgent 用 planChatTools 只读子集)。返 ok=正常结束(未中断 / 未抛错),
+     * 供调用方决定是否弹审批面板。execute 轮的合成输入也走这里。
+     */
+    const runTurn = async (input, planMode, placeholder) => {
+        let ok = false;
+        try {
+            const signal = startRunningListener(placeholder);
+            // 入口设定本轮初始模式(合成执行轮传 false→auto;用户轮传当前 mode)。
+            // setAgentMode 触发 listener 重写 history[0];LLM 可在轮中调 switch_mode 切模式,runAgent 每步读实时值。
+            setAgentMode(planMode ? 'plan' : 'auto');
+            // 运行中每步 chat() 返回后刷新状态行 context 用量条(用 fresh lastUsage / 估算),
+            // 否则整轮冻结在轮首 refreshStatusBase 的值,「执行 grep」时 2k/1000k 不动。
+            await runAgent(history, input, signal, () => {
+                refreshStatusBase(history);
+                layout.drawStatusBar();
+            });
+            ok = !signal.aborted; // 中断(Ctrl+C)→ runAgent 已还原 history,ok=false 不弹审批
+            // 成功轮次自动落盘(崩溃也保住上一轮);新会话首轮分配 id
+            if (!currentSessionId)
+                currentSessionId = newSessionId();
+            try {
+                saveSession(history, currentSessionId);
+            }
+            catch {
+                // 落盘失败不阻断 REPL
+            }
+            persistSnapshots(currentSessionId); // 随会话落盘回滚快照(/resume 后仍可撤销)
+            // 后台反思:每 reflectEveryN 轮 fire-and-forget 一次(与下一轮 agent 并发,不阻塞)。
+            // 已有在飞任务 / autoReflect 关 → kickoff 内部自守卫。快照同步取(避免下一轮 mutate history 竞态)。
+            turnCount++;
+            if (turnCount % config.reflectEveryN === 0) {
+                kickoffReflection(snapshotTranscript(history, 20));
+            }
+        }
+        catch (e) {
+            ok = false;
+            layout.contentWrite(`${ui.red}[错误]${ui.reset} ${e instanceof Error ? e.message : String(e)}\n`);
+        }
+        finally {
+            stopRunningListener();
+        }
+        layout.contentWrite('\n'); // 轮次之间空行
+        return ok;
+    };
     while (true) {
         // INPUT 态:画底栏输入框 + 状态行,光标入输入框
         refreshStatusBase(history);
@@ -433,6 +552,7 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null)
             input = await promptWithSlashMenu({
                 prompt: PROMPT,
                 commands: SLASH_COMMANDS,
+                onCycleMode: cycleMode,
                 // /rollback 预填优先;否则上一轮运行中 typeahead 打的字 → 预填进输入框,用户可改可发
                 ...(pendingPrefill
                     ? { initialLines: pendingPrefill }
@@ -464,9 +584,30 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null)
             // /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,命令不受影响。
+            if (getAgentMode() === 'plan') {
+                layout.contentWrite(`${ui.dim}(已在 plan 模式)${ui.reset}\n`);
+            }
+            else {
+                setAgentMode('plan'); // listener 接手 applyMode + refreshStatusBase
+                layout.contentWrite(`${ui.dim}(已切到 plan 模式:只读探查 + 产出计划,审批后切 auto 执行。/auto 或 Shift+Tab 切回)${ui.reset}\n`);
+            }
+            continue;
+        }
+        if (line === '/auto') {
+            if (getAgentMode() === 'auto') {
+                layout.contentWrite(`${ui.dim}(已在 auto 模式)${ui.reset}\n`);
+            }
+            else {
+                setAgentMode('auto'); // listener 接手 applyMode + refreshStatusBase
+                layout.contentWrite(`${ui.dim}(已切回 auto 模式:全工具执行)${ui.reset}\n`);
+            }
+            continue;
+        }
         if (line === '/clear') {
             history.length = 1; // 保留 system 提示
-            collapsedThinkings.length = 0; // 同步清空折叠的思考段
             resetState(); // 同步清空回滚轮次/快照
             currentSessionId = undefined; // 下轮起新会话文件
             turnCount = 0; // 反思 cadence 重新计数
@@ -565,37 +706,70 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null)
                 continue;
             }
             if (loaded.history[0]?.role === 'system') {
-                loaded.history[0] = { role: 'system', content: systemPrompt };
+                loaded.history[0] = { role: 'system', content: buildSystemMessage(false) };
             }
             history.length = 0;
             history.push(...loaded.history);
+            setAgentMode('auto'); // /resume 重置为 auto(mode 不落盘;listener 重写 history[0] 回 auto,与 loaded 幂等)
             currentSessionId = loaded.id;
             // 读回该会话的轮次/快照;无文件则从 history 重建 turns(无快照→旧轮次文件改动不可撤销)
             if (!loadSnapshots(loaded.id))
                 rebuildFromHistory(history);
             contextState.lastUsage = undefined;
-            collapsedThinkings.length = 0;
             layout.clearContent();
             renderHistory(history);
             layout.contentWrite(`${ui.dim}(已续接会话 ${loaded.id})${ui.reset}\n`);
             continue;
         }
-        if (line === '/think' || line.startsWith('/think ')) {
-            const arg = line.split(/\s+/)[1];
-            if (!arg) {
-                layout.contentWrite(`${ui.dim}折叠思考段: ${collapsedThinkings.length} 段  ·  用法: /think N (展开第 N 段)${ui.reset}\n`);
-                continue;
+        if (line === '/theme' || line.startsWith('/theme ')) {
+            // /theme:无参开菜单(↑↓ 选,Enter 切换,Esc 取消);/theme <name> 直切;/theme list 或未知名 → 列出。
+            const arg = line.startsWith('/theme ') ? line.slice('/theme '.length).trim() : '';
+            let name;
+            if (arg === '') {
+                // 无参:菜单选(仿 /resume /rollback 的 picker)
+                const items = listThemes().map((t) => ({
+                    id: t,
+                    title: t,
+                    subtitle: THEME_DESCRIPTIONS[t] ?? '',
+                }));
+                let pick;
+                try {
+                    pick = await promptThemePicker(items);
+                }
+                catch {
+                    continue; // Ctrl+C(SIGINT)→ 取消
+                }
+                name = pick?.id ?? null;
             }
-            const idx = Number(arg);
-            if (!Number.isInteger(idx) || idx < 1 || idx > collapsedThinkings.length) {
-                layout.contentWrite(`${ui.yellow}无第 ${arg} 段(共 ${collapsedThinkings.length})${ui.reset}\n`);
+            else if (arg === 'list' || !themeExists(arg)) {
+                layout.contentWrite(`${ui.dim}可用主题:${ui.reset}\n`);
+                for (const t of listThemes()) {
+                    layout.contentWrite(`  ${ui.cyan}${t}${ui.reset}  ${ui.dim}${THEME_DESCRIPTIONS[t] ?? ''}${ui.reset}\n`);
+                }
+                layout.contentWrite(`${ui.dim}(当前:${getTheme()};用 /theme <名称> 切换)${ui.reset}\n`);
                 continue;
             }
-            const content = collapsedThinkings[idx - 1];
-            layout.contentWrite(`${ui.dim}▎ 思考 ▾ (第 ${idx} 段)${ui.reset}\n`);
-            layout.contentWrite(`${ui.dim}${content}${ui.reset}\n`);
-            if (!content.endsWith('\n'))
-                layout.contentWrite('\n');
+            else {
+                name = arg;
+            }
+            if (name === null)
+                continue; // Esc / Ctrl+D 取消
+            // 切:setTheme → 重算状态行(新色)→ 清内容重绘(历史 / 横幅,镜像启动 + /resume)→ 确认 → 持久化。
+            // markdown MEMO 按 themeVersion 自动失效,故 renderHistory 取新色;状态栏 / 输入框由 continue 回 INPUT 态时读 getter 刷。
+            setTheme(name);
+            refreshStatusBase(history);
+            layout.clearContent();
+            if (history.some((m) => m.role === 'user')) {
+                renderHistory(history);
+            }
+            else {
+                layout.contentWrite(bannerString(banner()));
+            }
+            layout.contentWrite(`${ui.dim}(已切换主题 ${name})${ui.reset}\n`);
+            updateConfigKey('MOCODE_THEME', name);
+            if (config.themeFromShell) {
+                layout.contentWrite(`${ui.dim}(shell 环境变量 MOCODE_THEME 已设,文件写入下次启动被其覆盖;取消该 shell 设置后生效)${ui.reset}\n`);
+            }
             continue;
         }
         if (line === '/rollback' || line.startsWith('/rollback ')) {
@@ -604,38 +778,24 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null)
             await rollbackFlow();
             continue;
         }
-        try {
-            const signal = startRunningListener(placeholder);
-            // 运行中每步 chat() 返回后刷新状态行 context 用量条(用 fresh lastUsage / 估算),
-            // 否则整轮冻结在轮首 refreshStatusBase 的值,「执行 grep」时 2k/1000k 不动。
-            await runAgent(history, joined, collapsedThinkings, signal, () => {
-                refreshStatusBase(history);
-                layout.drawStatusBar();
+        const initialPlan = getAgentMode() === 'plan'; // 轮首模式(在 runTurn 之前读)
+        const ok = await runTurn(joined, initialPlan, placeholder);
+        // plan 轮正常结束(未中断 / 未抛错)→ 看轮末模式决定:
+        //  - 仍 plan:LLM 没自切(只产计划就 STOP)→ 弹审批面板(原行为)。
+        //  - 已 auto:LLM 调了 switch_mode('auto') 在同轮自主执行了 → 跳过审批,不重复打扰。
+        if (initialPlan && ok && getAgentMode() === 'plan') {
+            const res = await promptIntervention({
+                type: 'choice',
+                title: '计划已就绪',
+                detail: '切换到 auto 模式按上述计划执行?(plan 模式只读探查,执行需切 auto)',
+                options: ['切 auto 执行', '留 plan 细化'],
             });
-            // 成功轮次自动落盘(崩溃也保住上一轮);新会话首轮分配 id
-            if (!currentSessionId)
-                currentSessionId = newSessionId();
-            try {
-                saveSession(history, currentSessionId);
-            }
-            catch {
-                // 落盘失败不阻断 REPL
+            if (res.action === 'selected' && res.value === '切 auto 执行') {
+                // setAgentMode('auto') 由 runTurn 入口做(listener 重写 history[0] 回 auto);这里只切运行态 + 合成执行轮。
+                layout.enterRunningMode('执行', '按计划执行…');
+                await runTurn('请按上述计划执行。', false, '按计划执行…');
             }
-            persistSnapshots(currentSessionId); // 随会话落盘回滚快照(/resume 后仍可撤销)
-            // 后台反思:每 reflectEveryN 轮 fire-and-forget 一次(与下一轮 agent 并发,不阻塞)。
-            // 已有在飞任务 / autoReflect 关 → kickoff 内部自守卫。快照同步取(避免下一轮 mutate history 竞态)。
-            turnCount++;
-            if (turnCount % config.reflectEveryN === 0) {
-                kickoffReflection(snapshotTranscript(history, 20));
-            }
-        }
-        catch (e) {
-            layout.contentWrite(`${ui.red}[错误]${ui.reset} ${e instanceof Error ? e.message : String(e)}\n`);
-        }
-        finally {
-            stopRunningListener();
         }
-        layout.contentWrite('\n'); // 轮次之间空行
     }
     // 退出前等在飞反思收尾(Ctrl+C 走 SIGINT 直退不等;fire-and-forget 不承诺中断时完成)。
     await drainMemoryBackground();

package/dist/sandbox/command.js

@@ -0,0 +1,41 @@
+// run_command 的 best-effort 命令层原语。**非安全边界**——只挡误操作与低水平 prompt 注入,
+// 真隔离需 OS jailer(bwrap/firejail/sandbox-exec/docker,本次不做)。cwd 钉死由 run_command
+// 自己用 getSandboxRoot() 做;本模块只提供 env 脱敏与灾难命令 denylist。
+/** env 脱敏 denylist:删敏感键(*KEY / *TOKEN / *SECRET / *CREDENTIAL / *PASSWORD / LLM_*)。
+ *  防 LLM_API_KEY / ANYSEARCH_API_KEY 泄给子进程。用 denylist——白名单会误杀 npm/git 需要的
+ *  PATH/HOME/USERPROFILE 等 vars,不稳。 */
+const ENV_DENY = /^(.*_?KEY|.*TOKEN|.*SECRET|.*CREDENTIAL|.*PASSWORD|LLM_.*)$/i;
+/** 返回 env 浅拷贝,删敏感键。 */
+export function filterEnv(env) {
+    const out = {};
+    for (const [k, v] of Object.entries(env)) {
+        if (ENV_DENY.test(k))
+            continue;
+        out[k] = v;
+    }
+    return out;
+}
+/**
+ * 灾难性文件操作 denylist:仅挡最明显的 fs 破坏(rm -rf /、rm -rf ~、rm -rf /*、fork bomb、
+ * mkfs、dd of=/dev/、chmod -R 777 /)。**不挡 curl/wget/sudo**——用户目标是 fs 隔离,不是网络/提权;
+ * curl 写到 cwd 不算逃逸。大小写无关、粗匹配。刻意者可绕($IFS / base64 / env var 拼接),
+ * 故文档明确:非安全边界。返 string = 拒绝原因;null = 放行。
+ */
+const CMD_DENY = [
+    // rm -rf /  (flags 含 r 与 f,任序;目标 = 根、根*、家目录)
+    /\brm\s+-[a-z]*r[a-z]*f[a-z]*\s+\/(\s|$|\*)/i,
+    /\brm\s+-[a-z]*f[a-z]*r[a-z]*\s+\/(\s|$|\*)/i,
+    /\brm\s+-[a-z]*r[a-z]*f[a-z]*\s+~(\s|$)/i,
+    /\brm\s+-[a-z]*f[a-z]*r[a-z]*\s+~(\s|$)/i,
+    /:\s*\(\)\s*\{/i, // :(){ fork bomb
+    /\bmkfs\b/i,
+    /\bdd\b.*of=\/dev\//i,
+    /\bchmod\s+-R\s+777\s+\/(\s|$)/i,
+];
+export function isCommandDenied(cmd) {
+    for (const re of CMD_DENY) {
+        if (re.test(cmd))
+            return `命令被沙箱拒绝(灾难性文件操作): ${cmd}`;
+    }
+    return null;
+}

package/dist/sandbox/index.js

@@ -0,0 +1,5 @@
+// 沙箱子系统 barrel。叶子:仅 node:path / node:fs,不反向依赖业务。
+export { getSandboxRoot, setSandboxRoot } from './root.js';
+export { jailResolve, jailGlobPattern, isInsideRoot } from './jail.js';
+export { filterEnv, isCommandDenied } from './command.js';
+export { SANDBOX_EXEMPT_TOOLS, SANDBOX_PATH_TOOLS, enforceSandbox, } from './policy.js';