mocode-ai 0.4.9 → 0.5.0

package/dist/project-snapshot/llm-snapshot.js

@@ -0,0 +1,127 @@
+import { spawnAgent } from '../agent/spawn.js';
+/**
+ * 子 agent 系统提示：让 agent 自主探索项目并生成 markdown 快照
+ */
+const SNAPSHOT_LLM_SUFFIX = `You are a project analysis agent. Your task is to explore this project and generate a concise markdown snapshot for an AI coding assistant.
+
+## Your Mission
+Explore the project using available tools (read_file, glob, grep) and generate a structured markdown snapshot that captures:
+- WHAT exists (project description, tech stack, commands, modules, directory structure)
+- WHERE it is (paths, locations)
+
+Do NOT explain WHY or HOW (that's Project Skill's job).
+
+## Exploration Strategy
+1. Read package.json, README.md, tsconfig.json (or equivalent for other languages)
+2. List top-level directories to identify modules
+3. Scan src/ directory structure (depth ≤3, directories only)
+4. Extract key commands from package.json scripts
+5. Identify tech stack from dependencies
+
+## Output Format
+Output a markdown document between these exact delimiters:
+
+\`\`\`snapshot-md
+# Project Snapshot
+
+## Description
+(一句话描述项目，≤80字，中文)
+
+## Tech Stack
+(关键技术栈，逗号分隔，含版本，≤15项)
+
+## Commands
+| Command | Description |
+|---------|-------------|
+| \`npm run build\` | 构建项目 |
+| \`npm test\` | 运行测试 |
+| ... | ... |
+
+## Modules
+- **module-name** — 一句话职责描述（≤20字）
+- **module-name** — 一句话职责描述
+- ...
+
+## Source Tree
+\`\`\`
+src/
+  agent/
+  tools/
+  ui/
+\`\`\`
+\`\`\`snapshot-md
+
+## Rules
+1. **Description**: ≤80字，中文，从 README 和 package.json description 提炼。不要"一个..."开头。
+2. **Tech Stack**: ≤15项，逗号分隔，含版本。格式如 "TypeScript 5.x, Node.js ≥18, openai@^4"。
+3. **Commands**: 5-8个最重要的命令，从 package.json scripts 提取。Description ≤15字。用表格格式。
+4. **Modules**: 每个顶层模块目录一条。职责≤20字，只写 WHAT（做什么）。
+5. **Source Tree**: 只列目录（不列文件），深度≤3，用缩进表示层级，放在代码块中。
+6. 不要包含：设计决策、注意事项、坑点、约定 → 这些是 Skill 的职责。
+7. 总 markdown ≤ 2500 字符。
+8. 使用中文。
+`;
+/**
+ * 生成 LLM 快照（markdown 格式）
+ * @param root 项目根目录
+ * @param signal AbortSignal
+ */
+export async function generateLLMSnapshot(root, signal) {
+    const prompt = `请探索项目 ${root}，生成项目快照（markdown 格式）。
+
+## 探索步骤
+1. 读取 package.json（或等效配置文件）
+2. 读取 README.md
+3. 列出顶层目录，识别模块
+4. 扫描 src/ 目录结构（深度≤3，只列目录）
+5. 从 package.json scripts 提取关键命令
+6. 从 dependencies 识别技术栈
+
+## 输出
+严格按照系统提示的 markdown 格式输出，不要添加额外解释。`;
+    try {
+        const result = await spawnAgent({
+            prompt,
+            systemPromptSuffix: SNAPSHOT_LLM_SUFFIX,
+            tools: ['read_file', 'glob', 'grep'], // 允许探索工具
+            maxSteps: 15, // 给足够的探索步数
+            signal,
+        });
+        if (!result.completed) {
+            return {
+                ok: false,
+                error: '子 agent 未完成（可能中断或超时）',
+                transcript: result.transcript,
+            };
+        }
+        if (!result.summary) {
+            return {
+                ok: false,
+                error: '子 agent 未返回内容',
+                transcript: result.transcript,
+            };
+        }
+        // 从 summary 中提取 markdown
+        const mdMatch = result.summary.match(/```snapshot-md\n([\s\S]*?)\n```snapshot-md/);
+        if (!mdMatch || !mdMatch[1]) {
+            // fallback: 尝试普通 markdown 代码块
+            const fallbackMatch = result.summary.match(/```markdown\n([\s\S]*?)\n```/);
+            if (!fallbackMatch || !fallbackMatch[1]) {
+                return {
+                    ok: false,
+                    error: '无法从子 agent 输出中提取 markdown',
+                    transcript: result.transcript,
+                };
+            }
+            return { ok: true, content: fallbackMatch[1].trim(), transcript: result.transcript };
+        }
+        return { ok: true, content: mdMatch[1].trim(), transcript: result.transcript };
+    }
+    catch (e) {
+        return {
+            ok: false,
+            error: e instanceof Error ? e.message : '未知错误',
+            transcript: '',
+        };
+    }
+}

package/dist/repl/index.js

@@ -1,7 +1,7 @@
 import readline from 'node:readline/promises';
 import { emitKeypressEvents } from 'node:readline';
 import { stdin, stdout } from 'node:process';
-import { config, updateModelConfig, isModelConfigured, updateMemoryConfig, isMemoryEnabled, isProjectSkillEnabled, updateProjectSkillConfig, buildBasePrompt, getPlanModeSuffix, } from '../config/index.js';
+import { config, updateModelConfig, isModelConfigured, updateMemoryConfig, isMemoryEnabled, isProjectSkillEnabled, isProjectSnapshotEnabled, updateProjectSkillConfig, updateSnapshotConfig, buildBasePrompt, getPlanModeSuffix, } from '../config/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';
@@ -9,7 +9,7 @@ import { getAgentMode, setAgentMode, onModeChange } from '../agent/mode.js';
 import { togglePet, killPetProcess, listSkins, setSkin, sendState } from '../pet/bridge.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 { bannerLines, displayWidth, padEndDisplay, summarizeToolCall, summarizeToolResult } from '../ui/render.js';
 import * as layout from '../ui/layout.js';
 import * as mouse from '../ui/mouse.js';
 import * as batch from '../ui/batch.js';
@@ -24,7 +24,7 @@ import { listTurns, planRollback, applyRollback, persistSnapshots, loadSnapshots
 import { listSkills, effectiveSystemPrompt, } from '../skills/index.js';
 import { buildMemorySection, buildMemoryIndexSection, kickoffReflection, drainMemoryBackground, getLastReflectResult, clearLastReflectResult, snapshotTranscript, formatReflectResult, loadAll, } from '../memory/index.js';
 import { buildActivePlanSection, onActivePlanChange, hasActivePlan, getActivePlanSummary, } from '../plan/index.js';
-import { buildSnapshot as buildProjectSnapshot } from '../project-snapshot/index.js';
+import { buildSnapshot, clearSnapshotCache } from '../project-snapshot/index.js';
 /**
  * readline 的 prompt 必须是纯文本(无 ANSI):readline 按字符数算光标位置,
  * 颜色码会让光标错位、编辑时漂移。颜色只用在直接 stdout.write 的横幅 / 工具行 / 回复。
@@ -43,6 +43,7 @@ const SLASH_COMMANDS = [
     { 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 项目记忆(需先开启记忆)' },
@@ -51,7 +52,7 @@ const SLASH_COMMANDS = [
     { name: '/model switch', desc: '↑↓·Enter 在已配置预设间切换' },
     { name: '/model list', desc: '列出已经配置的模型' },
     { name: '/model delete <name>', desc: '删除已配置的模型' },
-    { name: '/refresh_snapshot', desc: '刷新项目快照(重新扫描静态文件,更新缓存)' },
+    { name: '/snapshot_refresh', desc: '刷新项目快照(重新扫描静态文件,重新生成 LLM 摘要)' },
     { name: '/plan', desc: '切到 plan 模式(只读探查+产出计划)' },
     { name: '/auto', desc: '切回 auto 模式(全工具执行)' },
     { name: '/pet', desc: '开关桌宠(独立悬浮窗,展示 agent 状态动画)' },
@@ -66,6 +67,12 @@ const THEME_DESCRIPTIONS = {
     solarized: 'Solarized 强调色',
     gruvbox: 'Gruvbox 暖色',
     nord: 'Nord 冷色',
+    orange: '南瓜橙(暖)',
+    rose: '玫红(暖紫)',
+    emerald: '翡翠绿(冷)',
+    amber: '琥珀金黄(暖)',
+    lavender: '薰衣草淡紫(冷)',
+    sunset: '日落珊瑚红(暖)',
 };
 /** /model 预设后端:选一个预填 baseURL,仍可逐项改。base_url 取自 README 常见表。 */
 const MODEL_PRESETS = [
@@ -138,7 +145,7 @@ function renderContextBar(history) {
     const bar = '█'.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;
+    const pctCol = pct >= config.compactThreshold ? ui.yellow : ui.accent;
     return `${ui.gray}[${pctCol}${bar}${ui.reset}] ${Math.round(pct * 100)}%  ${k(est)}/${k(win)} tokens · ${history.length} 条消息 (${src})${ui.reset}`;
 }
 /** 状态行用量条(精简版,进底栏):[bar] pct% k/k。
@@ -153,7 +160,7 @@ function renderContextBarInline(history) {
     const filled = Math.round(pct * W);
     const bar = '█'.repeat(filled) + '░'.repeat(W - filled);
     const k = (n) => `${Math.round(n / 1000)}k`;
-    const pctCol = pct >= config.compactThreshold ? ui.yellow : ui.cyan;
+    const pctCol = pct >= config.compactThreshold ? ui.yellow : ui.accent;
     return `${ui.gray}[${pctCol}${bar}${ui.reset}] ${pctCol}${Math.round(pct * 100)}%${ui.reset} ${ui.dim}${k(est)}/${k(win)}${ui.reset}`;
 }
 /** 状态行基线:模型 / context / cwd / 模式标识 / 活跃 plan chip / 本轮 token。repl 在轮次边界、切模式、plan 变更时调。 */
@@ -178,7 +185,7 @@ function runningStateFor(cmd) {
             return { status: '回滚', placeholder: '选择轮次…' };
         case '/init':
             return { status: '初始化', placeholder: '生成 MOCODE.md…' };
-        case '/refresh_snapshot':
+        case '/snapshot_refresh':
             return { status: '刷新快照', placeholder: '扫描项目文件中…' };
         case '/plan':
             return { status: '切 plan', placeholder: '…' };
@@ -198,6 +205,8 @@ function runningStateFor(cmd) {
             return { status: '查记忆状态', placeholder: '…' };
         case '/project_skill':
             return { status: '项目 Skill', placeholder: '处理中…' };
+        case '/snapshot':
+            return { status: '切快照开关', placeholder: '切换中…' };
         default:
             // 输入框留空(运行中可 typeahead 打字,dim 回显);运行状态由内联 spinner 承载(思考中/执行…),
             // 状态行只显走时——故常态 status 留空,不塞「处理」这种与内联重复的泛标签。
@@ -525,8 +534,10 @@ export function renderHistory(history) {
                     break;
                 }
             }
-            if (target)
+            if (target) {
                 target.resultSummary = preview;
+                target.fullOutput = output;
+            }
             // 不直接写屏——等 flushBatch 时出单行摘要
             continue;
         }
@@ -545,13 +556,11 @@ 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());
-    // 项目快照：sandboxRoot 设定后立即构建/加载（同步，小文件几十 ms）。
-    // 构建失败不阻断 REPL：snapshot 内部 catch 所有异常，此处再兜一层。
+    // 项目快照：sandboxRoot 设定后异步构建（完全由 LLM 生成）。
+    // 构建失败不阻断 REPL：snapshot 内部 catch 所有异常。
     if (config.projectSnapshotEnabled) {
-        try {
-            buildProjectSnapshot();
-        }
-        catch { /* ignore */ }
+        // 异步触发 LLM 快照生成（不阻塞 REPL 启动）
+        buildSnapshot().catch(() => { });
     }
     // 构造系统提示:auto 用 base;plan 在 base 后追加按当前开关现拼的 plan suffix。
     // 切模式时 applyMode 重算 history[0](history[0] 恒 system,compaction 保它,不破坏)。
@@ -592,6 +601,7 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null,
         baseURL: config.baseURL,
         cwd: process.cwd(),
         tools: toolsLine,
+        memoryEnabled: isMemoryEnabled(),
     });
     // 开场:按 config.theme 切主题(横幅 / 状态行 / 后续渲染皆用新色),再进 alt screen + 状态基线 + 清内容区。
     // --resume 有历史则渲染对话(仿 Claude Code),否则横幅。
@@ -604,7 +614,7 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null,
         renderHistory(history);
     }
     else {
-        layout.contentWrite(bannerString(banner()));
+        layout.writeBanner(bannerLines(banner()));
     }
     if (!isModelConfigured()) {
         // 未配置 baseURL/apiKey:醒目提示引导 /model(不退出,REPL 仍可用;发消息会失败但不崩)。
@@ -630,7 +640,6 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null,
             }
         }
     }
-    layout.contentWrite(`${ui.dim}  /plan · /auto · Shift+Tab 切换模式(plan:只读探查 + 产出计划,审批后切 auto 执行)${ui.reset}\n`);
     if (updateNotice) {
         // 自更新提示:放 /plan · /auto 行下方,黄色(警示色)突出"你正在用的版本较旧",与 dim 提示区分。
         // 开场静态段(进 INPUT 态前),一行,纯文本不与流式 / 输入争用。
@@ -811,7 +820,7 @@ 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.cyan}${config.model}${ui.reset} 不支持视觉输入。${ui.dim}原始:${msg}${ui.reset}\n`);
+                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`);
             }
             else {
@@ -979,7 +988,7 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null,
             lastTurnUsage = undefined; // 清空旧轮的 token 累计
             pendingAttachments = []; // 一并清空待发图片
             layout.clearContent();
-            layout.contentWrite(bannerString(banner()));
+            layout.writeBanner(bannerLines(banner()));
             layout.contentWrite(`${ui.dim}(历史已清空,保留系统提示)${ui.reset}\n`);
             continue;
         }
@@ -1051,7 +1060,7 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null,
                 .sort((a, b) => (b.updatedAt || '').localeCompare(a.updatedAt || ''))
                 .slice(0, 10);
             for (const e of recent) {
-                layout.contentWrite(`  ${ui.cyan}${e.id}${ui.reset}  ${ui.dim}${e.name} — ${e.summary}${ui.reset}\n`);
+                layout.contentWrite(`  ${ui.accent}${e.id}${ui.reset}  ${ui.dim}${e.name} — ${e.summary}${ui.reset}\n`);
             }
             if (active.length === 0)
                 layout.contentWrite(`${ui.dim}(无 active 记忆;用 memory_save 存,或 /init 生成 MOCODE.md)${ui.reset}\n`);
@@ -1077,7 +1086,7 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null,
             else {
                 layout.contentWrite(`${ui.dim}已发现 ${skills.length} 个 skill:${ui.reset}\n`);
                 for (const s of skills) {
-                    layout.contentWrite(`  ${ui.cyan}${s.name}${ui.reset}  ${ui.dim}${s.description}${ui.reset}\n`);
+                    layout.contentWrite(`  ${ui.accent}${s.name}${ui.reset}  ${ui.dim}${s.description}${ui.reset}\n`);
                 }
                 layout.contentWrite(`${ui.dim}(用 use_skill 工具加载某 skill 的完整指令)${ui.reset}\n`);
             }
@@ -1150,24 +1159,33 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null,
             }
             continue;
         }
-        if (line === '/refresh_snapshot') {
+        if (line === '/snapshot_refresh') {
             if (!config.projectSnapshotEnabled) {
                 layout.contentWrite(`${ui.dim}(项目快照功能已关闭,MOCODE_PROJECT_SNAPSHOT=false)${ui.reset}\n`);
                 continue;
             }
-            // buildProjectSnapshot 是同步操作(扫顶层小文件,几十 ms),不需要 spinner
+            // buildSnapshot 是异步操作(完全由 LLM 生成)，显示进度提示
+            layout.contentWrite(`${ui.dim}正在重新生成项目快照 (LLM 分析中)...${ui.reset}\n`);
             try {
-                const snap = buildProjectSnapshot();
-                const fileCount = Object.keys(snap.files).length;
-                const moduleCount = snap.structure.modules.length;
-                const configCount = snap.structure.configFiles.length;
-                layout.contentWrite(`${ui.cyan}✓ 项目快照已刷新${ui.reset}: ${fileCount} 个静态文件 · ${moduleCount} 个模块 · ${configCount} 个配置文件\n`);
-                layout.contentWrite(`${ui.dim}文件: ${Object.keys(snap.files).join(', ')}${ui.reset}\n`);
-                layout.contentWrite(`${ui.dim}模块: ${snap.structure.modules.join(', ')}${ui.reset}\n`);
-                // 刷新 history[0]：buildSnapshotSection 内部 loadSnapshot() 会拿到新快照，
-                // buildSystemMessage 重新拼 system prompt，快照段落就更新了。
-                history[0] = { role: 'system', content: buildSystemMessage(getAgentMode() === 'plan') };
-                layout.contentWrite(`${ui.dim}(system prompt 已同步刷新)${ui.reset}\n`);
+                // 清除缓存，强制重新生成
+                clearSnapshotCache();
+                const result = await buildSnapshot(undefined, true);
+                if (result.snapshot) {
+                    layout.contentWrite(`${ui.cyan}✓ 项目快照已刷新${ui.reset} (${result.snapshot.builtAt})\n`);
+                    layout.contentWrite(`${ui.dim}已生成 markdown 快照，注入到系统提示词中${ui.reset}\n`);
+                    // 刷新 history[0]：buildSnapshotSection 内部 loadSnapshot() 会拿到新快照，
+                    // buildSystemMessage 重新拼 system prompt，快照段落就更新了。
+                    history[0] = { role: 'system', content: buildSystemMessage(getAgentMode() === 'plan') };
+                    layout.contentWrite(`${ui.dim}(system prompt 已同步刷新)${ui.reset}\n`);
+                }
+                else {
+                    layout.contentWrite(`${ui.red}✗ 快照生成失败${ui.reset}: ${result.error || '未知错误'}\n`);
+                    if (result.transcript) {
+                        layout.contentWrite(`${ui.dim}--- 子 agent 日志 ---${ui.reset}\n`);
+                        layout.contentWrite(`${ui.dim}${result.transcript}${ui.reset}\n`);
+                        layout.contentWrite(`${ui.dim}--- 日志结束 ---${ui.reset}\n`);
+                    }
+                }
             }
             catch (e) {
                 const msg = e instanceof Error ? e.message : String(e);
@@ -1247,7 +1265,7 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null,
             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.accent}${t}${ui.reset}  ${ui.dim}${THEME_DESCRIPTIONS[t] ?? ''}${ui.reset}\n`);
                 }
                 layout.contentWrite(`${ui.dim}(当前:${getTheme()};用 /theme <名称> 切换)${ui.reset}\n`);
                 continue;
@@ -1266,7 +1284,7 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null,
                 renderHistory(history);
             }
             else {
-                layout.contentWrite(bannerString(banner()));
+                layout.writeBanner(bannerLines(banner()));
             }
             layout.contentWrite(`${ui.dim}(已切换主题 ${name})${ui.reset}\n`);
             updateConfigKey('MOCODE_THEME', name);
@@ -1302,7 +1320,7 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null,
                     renderHistory(history);
                 }
                 else {
-                    layout.contentWrite(bannerString(banner()));
+                    layout.writeBanner(bannerLines(banner()));
                 }
                 layout.contentWrite(`${ui.dim}(已切换到预设 “${target.name}” → ${target.model} @ ${target.baseURL})${ui.reset}\n`);
                 if (config.llmKeysFromShell.length > 0) {
@@ -1381,7 +1399,7 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null,
                 layout.contentWrite(`${ui.dim}已配置 ${ps.length} 个预设:${ui.reset}\n`);
                 for (const p of ps) {
                     const star = p.baseURL === config.baseURL && p.apiKey === config.apiKey && p.model === config.model ? ' ★' : '';
-                    layout.contentWrite(`  ${ui.cyan}${p.name}${ui.reset}${star}  ${ui.dim}${p.model} @ ${p.baseURL}${ui.reset}\n`);
+                    layout.contentWrite(`  ${ui.accent}${p.name}${ui.reset}${star}  ${ui.dim}${p.model} @ ${p.baseURL}${ui.reset}\n`);
                 }
                 layout.contentWrite(`${ui.dim}(★ = 与当前一致;切换用 /model switch)${ui.reset}\n`);
                 continue;
@@ -1389,10 +1407,10 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null,
             // /model show:显示当前四项配置(apiKey 脱敏)。
             if (arg === 'show') {
                 layout.contentWrite(`${ui.dim}当前模型配置:${ui.reset}\n`);
-                layout.contentWrite(`  ${ui.cyan}baseURL${ui.reset}  ${config.baseURL}\n`);
-                layout.contentWrite(`  ${ui.cyan}apiKey ${ui.reset}  ${maskKey(config.apiKey)}\n`);
-                layout.contentWrite(`  ${ui.cyan}model  ${ui.reset}  ${config.model}\n`);
-                layout.contentWrite(`  ${ui.cyan}窗口   ${ui.reset}  ${config.contextWindowTokens} tokens\n`);
+                layout.contentWrite(`  ${ui.accent}baseURL${ui.reset}  ${config.baseURL}\n`);
+                layout.contentWrite(`  ${ui.accent}apiKey ${ui.reset}  ${maskKey(config.apiKey)}\n`);
+                layout.contentWrite(`  ${ui.accent}model  ${ui.reset}  ${config.model}\n`);
+                layout.contentWrite(`  ${ui.accent}窗口   ${ui.reset}  ${config.contextWindowTokens} tokens\n`);
                 layout.contentWrite(`${ui.dim}(配置文件: ${CONFIG_PATH})${ui.reset}\n`);
                 continue;
             }
@@ -1615,7 +1633,7 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null,
                 renderHistory(history);
             }
             else {
-                layout.contentWrite(bannerString(banner()));
+                layout.writeBanner(bannerLines(banner()));
             }
             layout.contentWrite(`${ui.dim}(已切换模型 → ${model} @ ${baseURL})${ui.reset}\n`);
             if (savedName) {
@@ -1650,9 +1668,9 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null,
             try {
                 if (line === '/memory_status' || line.startsWith('/memory_status ')) {
                     const on = isMemoryEnabled();
-                    layout.contentWrite(`${ui.cyan}记忆子系统:${ui.reset} ${on ? `${ui.green}开启` : `${ui.yellow}关闭`}${ui.reset}\n`);
+                    layout.contentWrite(`${ui.accent}记忆子系统:${ui.reset} ${on ? `${ui.green}开启` : `${ui.yellow}关闭`}${ui.reset}\n`);
                     layout.contentWrite(`${ui.dim}  单一来源 isMemoryEnabled()(${config.memoryEnabled});` +
-                        `持久化 ${ui.cyan}MEMORY_ENABLED${ui.dim};` +
+                        `持久化 ${ui.accent}MEMORY_ENABLED${ui.dim};` +
                         `配置文件 ${CONFIG_PATH}${ui.reset}\n`);
                     layout.contentWrite(`${ui.dim}  关闭时:memory_*_save/_search/_list/_update/_forget 五个工具整体不进工具表;` +
                         `buildBasePrompt() 不含「## Memory」段;` +
@@ -1699,6 +1717,9 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null,
                     (process.env.MEMORY_ENABLED
                         ? `${ui.dim}同 session shell 未 export,文件写入即时生效)${ui.reset}\n`
                         : `${ui.dim}下次启动仍生效)${ui.reset}\n`));
+                // 即时刷 banner(原地替换顶部 bannerH 行,不留副本):banner() 闭包实时读
+                // isMemoryEnabled(),无需重启 REPL。buffer 中 bannerH 之下的对话历史位置不动。
+                layout.rewriteBanner(bannerLines(banner()));
             }
             catch (e) {
                 layout.contentWrite(`${ui.red}/memory_switch 失败:${ui.reset} ${e.message}\n`);
@@ -1720,7 +1741,7 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null,
                 // /project_skill view — 查看当前内容
                 if (arg === 'view') {
                     const enabled = isProjectSkillEnabled();
-                    layout.contentWrite(`${ui.cyan}项目专属 Skill:${ui.reset} ${enabled ? `${ui.green}开启` : `${ui.yellow}关闭`}${ui.reset}\n`);
+                    layout.contentWrite(`${ui.accent}项目专属 Skill:${ui.reset} ${enabled ? `${ui.green}开启` : `${ui.yellow}关闭`}${ui.reset}\n`);
                     if (enabled) {
                         const { readProjectSkill } = await import('../project-skill/index.js');
                         const content = readProjectSkill();
@@ -1765,7 +1786,7 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null,
                         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.cyan}.mocode/project-skill.md${ui.reset} (${result.content.length} 字符)\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`);
                         }
@@ -1823,6 +1844,102 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null,
             }
             continue;
         }
+        if (line === '/snapshot' ||
+            line.startsWith('/snapshot ')) {
+            // /snapshot — 项目快照总开关。无参切换 on/off;/on 或 /off 显式;/status 只读。
+            //
+            // 设计原则(与 /project_skill / /memory_switch 对齐):
+            //  - 单一来源 config.projectSnapshotEnabled(被 buildSnapshotSection() 现拼 +
+            //    read_file 工具每次 execute 现读);改完下一轮 chat 的 system prompt 即时反映。
+            //  - 持久化字段 MOCODE_PROJECT_SNAPSHOT,默认值 true(默认开启,启动 lazy build)。
+            //  - 关闭时:system prompt 不注入快照段,read_file 不查 cache 直接走真实 readFile。
+            //  - 开启时:若还没有 snapshot.json,主动 buildProjectSnapshot() 一次(仿 startRepl
+            //    655-658 的 lazy build 模式),否则 buildSnapshotSection() 会因 loadSnapshot=null
+            //    返空串,用户感知不到自己刚打开的开关已经生效。
+            try {
+                const arg = line.startsWith('/snapshot ')
+                    ? line.slice('/snapshot '.length).trim().toLowerCase()
+                    : '';
+                // /snapshot status — 只读查询
+                if (arg === 'status') {
+                    const on = isProjectSnapshotEnabled();
+                    layout.contentWrite(`${ui.accent}项目快照:${ui.reset} ${on ? `${ui.green}开启` : `${ui.yellow}关闭`}${ui.reset}\n`);
+                    layout.contentWrite(`${ui.dim}  单一来源 config.projectSnapshotEnabled(${on ? 'true' : 'false'});` +
+                        `持久化 ${ui.accent}MOCODE_PROJECT_SNAPSHOT${ui.dim};` +
+                        `配置文件 ${CONFIG_PATH}${ui.reset}\n`);
+                    layout.contentWrite(`${ui.dim}  关闭时:buildBasePrompt() 不含「## Project Snapshot」段;` +
+                        `read_file 工具直接走真实 readFile,不走 snapshot cache。${ui.reset}\n`);
+                    layout.contentWrite(`${ui.dim}  切换后下次 chat 即时反映(本轮已发出的请求不会回滚)。${ui.reset}\n`);
+                    continue;
+                }
+                // /snapshot(无参=切换;有参=按值设)
+                let nextEnabled;
+                if (arg === '') {
+                    nextEnabled = !isProjectSnapshotEnabled();
+                }
+                else if (['on', 'true', '1', 'yes', 'y', 'enable', 'enabled'].includes(arg)) {
+                    nextEnabled = true;
+                }
+                else if (['off', 'false', '0', 'no', 'n', 'disable', 'disabled'].includes(arg)) {
+                    nextEnabled = false;
+                }
+                else {
+                    layout.contentWrite(`${ui.yellow}/snapshot 用法:${ui.reset}\n` +
+                        `  /snapshot                  切换(开↔关)\n` +
+                        `  /snapshot on|off           显式设值\n` +
+                        `  /snapshot status           查看当前状态\n`);
+                    continue;
+                }
+                const prev = isProjectSnapshotEnabled();
+                if (nextEnabled === prev) {
+                    layout.contentWrite(`${ui.dim}(已是 ${nextEnabled ? '开启' : '关闭'},未变更 — 持久化字段未写入)${ui.reset}\n`);
+                    continue;
+                }
+                updateSnapshotConfig(nextEnabled);
+                updateConfigKey('MOCODE_PROJECT_SNAPSHOT', nextEnabled ? 'true' : 'false');
+                // 开启时异步 build 一次,避免 buildSnapshotSection 因 loadSnapshot=null 返空串。
+                let built = false;
+                if (nextEnabled) {
+                    try {
+                        clearSnapshotCache();
+                        const result = await buildSnapshot();
+                        if (result.snapshot) {
+                            built = true;
+                        }
+                        else {
+                            layout.contentWrite(`${ui.yellow}⚠ 快照构建失败:${ui.reset} ${result.error || '未知错误'} ` +
+                                `${ui.dim}(开关已切换,系统提示词中的快照段将为空,稍后可用 /snapshot_refresh 重试)${ui.reset}\n`);
+                        }
+                    }
+                    catch (e) {
+                        layout.contentWrite(`${ui.yellow}⚠ 快照构建失败:${ui.reset} ${e.message} ` +
+                            `${ui.dim}(开关已切换,系统提示词中的快照段将为空,稍后可用 /snapshot_refresh 重试)${ui.reset}\n`);
+                    }
+                }
+                // 刷新 history[0] 使 system prompt 立即反映新值(仿 /snapshot_refresh)。
+                history[0] = { role: 'system', content: buildSystemMessage(getAgentMode() === 'plan') };
+                const note = nextEnabled
+                    ? `${ui.green}已开启项目快照${ui.reset} — ` +
+                        `system prompt 将在下次 chat 注入「## Project Snapshot」段;` +
+                        `read_file 工具优先走 snapshot cache(mtime 校验失败时回退真实 readFile)。`
+                    : `${ui.yellow}已关闭项目快照${ui.reset} — ` +
+                        `system prompt 不再注入「## Project Snapshot」段;` +
+                        `read_file 工具直接走真实 readFile,不再查 cache。`;
+                let extra = '';
+                if (nextEnabled && built) {
+                    extra = `${ui.dim}(已构建快照;如需刷新用 /snapshot_refresh)${ui.reset}\n`;
+                }
+                layout.contentWrite(`${note}\n${extra}`);
+                layout.contentWrite(`${ui.dim}(写入 ${CONFIG_PATH}:MOCODE_PROJECT_SNAPSHOT=${nextEnabled ? 'true' : 'false'};` +
+                    (process.env.MOCODE_PROJECT_SNAPSHOT
+                        ? `${ui.dim}同 session shell 已 export MOCODE_PROJECT_SNAPSHOT,文件写入下次启动仍以 shell 值为准;取消 shell 设置后生效)${ui.reset}\n`
+                        : `${ui.dim}下次启动仍生效)${ui.reset}\n`));
+            }
+            catch (e) {
+                layout.contentWrite(`${ui.red}/snapshot 失败:${ui.reset} ${e.message}\n`);
+            }
+            continue;
+        }
         const bubbleRows = input.length + 2 + pendingAttachments.length; // N 行 message + 2 行尾随空(含 \n\n 留下的 open current 行) + 每附件 1 行
         const shouldCommit = await awaitPendingRecall(input, pendingAttachments.length, placeholder);
         if (!shouldCommit) {

package/dist/session/compact.js

@@ -323,7 +323,7 @@ export async function compactHistory(history, opts) {
             const estimateAfter = estimateMessagesTokens(history) + schemaTokens;
             contextState.lastEstimate = estimateAfter;
             contextState.lastUsage = undefined;
-            layout.contentWrite(`  ${ui.brightMagenta}●${ui.reset} ${ui.cyan}强制压缩(focus on early history)${ui.reset}  ${ui.dim}${estimateBefore} → ${estimateAfter} tokens${ui.reset}\n`);
+            layout.contentWrite(`  ${ui.bold}${ui.accent}●${ui.reset} ${ui.accent}强制压缩(focus on early history)${ui.reset}  ${ui.dim}${estimateBefore} → ${estimateAfter} tokens${ui.reset}\n`);
             return {
                 compacted: true,
                 summarized: false,
@@ -409,7 +409,7 @@ export async function compactHistory(history, opts) {
         const estimateAfter = estimateMessagesTokens(history) + schemaTokens;
         contextState.lastEstimate = estimateAfter;
         contextState.lastUsage = undefined; // 压缩后旧 usage 失效,/context 改用估算
-        layout.contentWrite(`  ${ui.brightMagenta}●${ui.reset} ${ui.cyan}压缩上下文${ui.reset}  ${ui.dim}${estimateBefore} → ${estimateAfter} tokens${ui.reset}\n`);
+        layout.contentWrite(`  ${ui.bold}${ui.accent}●${ui.reset} ${ui.accent}压缩上下文${ui.reset}  ${ui.dim}${estimateBefore} → ${estimateAfter} tokens${ui.reset}\n`);
         // 抖动保护:压缩后仍超阈 → 提示 /clear,不死循环
         if (estimateAfter >= opts.threshold * opts.window) {
             layout.contentWrite(`  ${ui.yellow}●${ui.reset} ${ui.yellow}压缩后仍超阈,可能存在超大单条;建议 /clear。${ui.reset}\n`);
@@ -427,7 +427,7 @@ export async function compactHistory(history, opts) {
     contextState.lastEstimate = estimateAfter;
     contextState.lastUsage = undefined; // 结构虽未变,但 token 数已变,旧 usage 失效
     if (microcompactDone) {
-        layout.contentWrite(`  ${ui.brightMagenta}●${ui.reset} ${ui.cyan}微压缩旧工具结果${ui.reset}  ${ui.dim}${estimateBefore} → ${estimateAfter} tokens${ui.reset}\n`);
+        layout.contentWrite(`  ${ui.bold}${ui.accent}●${ui.reset} ${ui.accent}微压缩旧工具结果${ui.reset}  ${ui.dim}${estimateBefore} → ${estimateAfter} tokens${ui.reset}\n`);
         return {
             compacted: true,
             summarized: false,