mocode-ai 1.2.5 → 1.2.7

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, isSubAgentEnabled, updateSubAgentConfig, isFrontendToolsEnabled, updateFrontendToolsConfig, updateLanguageConfig, languageFromShell, buildBasePrompt, getPlanModeSuffix, hasCodegraphIndex, reinjectActivePlanIntoSystem, DEFAULT_CONTEXT_WINDOW_TOKENS, } from '../config/index.js';
+import { config, updateModelConfig, isModelConfigured, updateMemoryConfig, isMemoryEnabled, isSubAgentEnabled, updateSubAgentConfig, isFrontendToolsEnabled, updateFrontendToolsConfig, updateLanguageConfig, languageFromShell, buildBasePrompt, getPlanModeSuffix, hasCodegraphIndex, DEFAULT_CONTEXT_WINDOW_TOKENS, pinSessionModel, } from '../config/index.js';
 import { getLanguage, normalizeLanguage, t, } from '../i18n/index.js';
 import { DEFAULT_BUDGET_POLICY } from '../context/budget.js';
 import { updateConfigKey, writeConfigKeys, CONFIG_PATH } from '../config/file.js';
@@ -66,9 +66,9 @@ function buildSlashCommands() {
                 { 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: '/init', desc: d('commands.memoryInit') },
         {
             name: '/subagent', desc: d('commands.subagent'), children: [
                 { name: 'on', value: '/subagent on', desc: d('commands.subagentOn') },
@@ -152,17 +152,18 @@ function themeDescription(name) {
         rose: 1, emerald: 1, amber: 1, lavender: 1, sunset: 1,
     } ? t(key) : '';
 }
-/** /model 预设后端:选一个预填 baseURL,仍可逐项改。base_url 取自 README 常见表。 */
+/** /model 预设后端：同时声明原生协议；旧服务继续走 OpenAI-compatible。 */
 const MODEL_PRESETS = [
-    { label: 'GLM(智谱)', baseURL: 'https://open.bigmodel.cn/api/v3', model: 'glm-4.6', window: DEFAULT_CONTEXT_WINDOW_TOKENS },
-    { label: 'DeepSeek', baseURL: 'https://api.deepseek.com', model: 'deepseek-chat', window: DEFAULT_CONTEXT_WINDOW_TOKENS },
-    { label: 'Qwen(阿里)', baseURL: 'https://dashscope.aliyuncs.com/compatible-mode/v1', model: 'qwen-plus', window: DEFAULT_CONTEXT_WINDOW_TOKENS },
+    { label: 'Anthropic Claude', provider: 'anthropic', baseURL: 'https://api.anthropic.com', model: 'claude-sonnet-4-5', window: 200000, anthropicPromptCache: true },
+    { label: 'GLM(智谱)', provider: 'openai', baseURL: 'https://open.bigmodel.cn/api/v3', model: 'glm-4.6', window: DEFAULT_CONTEXT_WINDOW_TOKENS, anthropicPromptCache: false },
+    { label: 'DeepSeek', provider: 'openai', baseURL: 'https://api.deepseek.com', model: 'deepseek-chat', window: DEFAULT_CONTEXT_WINDOW_TOKENS, anthropicPromptCache: false },
+    { label: 'Qwen(阿里)', provider: 'openai', baseURL: 'https://dashscope.aliyuncs.com/compatible-mode/v1', model: 'qwen-plus', window: DEFAULT_CONTEXT_WINDOW_TOKENS, anthropicPromptCache: false },
     // MiniMax OpenAI 兼容端点(https://platform.minimax.io/docs/api-reference/text-openai-api)。
     // MiniMax-M3 为唯一支持图片/视频输入的模型;M2 系列纯文本(见 llm/capabilities.ts KNOWN_TEXT_ONLY_PREFIXES)。
-    { label: 'MiniMax', baseURL: 'https://api.minimax.io/v1', model: 'MiniMax-M3', window: DEFAULT_CONTEXT_WINDOW_TOKENS },
-    { label: '本地 Ollama', baseURL: 'http://localhost:11434/v1', model: 'qwen2.5:7b', window: DEFAULT_CONTEXT_WINDOW_TOKENS },
-    { label: '本地 vLLM', baseURL: 'http://localhost:8000/v1', model: 'default', window: DEFAULT_CONTEXT_WINDOW_TOKENS },
-    { label: '自定义 base_url', baseURL: '', model: '', window: DEFAULT_CONTEXT_WINDOW_TOKENS },
+    { label: 'MiniMax', provider: 'openai', baseURL: 'https://api.minimax.io/v1', model: 'MiniMax-M3', window: DEFAULT_CONTEXT_WINDOW_TOKENS, anthropicPromptCache: false },
+    { label: '本地 Ollama', provider: 'openai', baseURL: 'http://localhost:11434/v1', model: 'qwen2.5:7b', window: DEFAULT_CONTEXT_WINDOW_TOKENS, anthropicPromptCache: false },
+    { label: '本地 vLLM', provider: 'openai', baseURL: 'http://localhost:8000/v1', model: 'default', window: DEFAULT_CONTEXT_WINDOW_TOKENS, anthropicPromptCache: false },
+    { label: '自定义 base_url', provider: 'openai', baseURL: '', model: '', window: DEFAULT_CONTEXT_WINDOW_TOKENS, anthropicPromptCache: false },
 ];
 /** apiKey 脱敏:只露末 4 位,前面打星号(显示用,绝不把明文 key 写进内容区)。 */
 function maskKey(k) {
@@ -173,7 +174,7 @@ function maskKey(k) {
     return `${'='.repeat(Math.min(k.length - 4, 20))}${k.slice(-4)}`;
 }
 /**
- * /init 指令:发给 agent 扫描项目并生成 MOCODE.md。已存在则让 agent 读后更新(不丢失事实)。写完供 memory 子系统下轮加载。
+ * /init 指令:发给 agent 扫描项目并生成 AGENTS.md。已存在则让 agent 读后更新(不丢失事实)。写完供 memory 子系统下轮加载。
  *
  * 函数化(非 const):.codegraph/ 索引是否存在的探测放在调用瞬间,没索引时不提 codegraph,
  * 避免 LLM 调出失败。/init 是冷启动动作,IO 开销可忽略。
@@ -182,14 +183,14 @@ function buildInitPrompt() {
     const cg = hasCodegraphIndex()
         ? '- 若有 .codegraph/:用 use_skill 加载 codegraph skill 后用 run_command 调 codegraph explore "<架构或入口符号>" 一次拿相关源码+调用路径,别逐文件读！！！\n'
         : '';
-    return `分析当前项目(process.cwd()),生成 MOCODE.md 项目记忆文件,供 mocode 后续会话自动加载——目标是让后续会话无需重新摸索就能上手。
+    return `分析当前项目(process.cwd()),生成 AGENTS.md 项目记忆文件,供 mocode 后续会话自动加载——目标是让后续会话无需重新摸索就能上手。
 
 先探查(尽量少调用拿全貌):
 ${cg}- read_file package.json(或 Cargo.toml/pyproject.toml/go.mod 等):scripts、依赖、入口、模块类型。
 - glob 顶层目录;read_file 入口文件 + 各子系统 index.ts/README。
-- 若 MOCODE.md 已存在:read_file 读它,在其基础上更新(补缺、修正过时),不丢已有准确事实。
+- 若 AGENTS.md 已存在:read_file 读它,在其基础上更新(补缺、修正过时),不丢已有准确事实。
 
-MOCODE.md 按以下结构写(每节简短,只写稳定、非显然的事实):
+AGENTS.md 按以下结构写(每节简短,只写稳定、非显然的事实):
 ## 项目
 一两句:是什么、技术栈、运行环境。
 ## 命令
@@ -204,7 +205,7 @@ install / dev / build / test / typecheck / lint 等——从 package.json script
 硬要求:
 - 从实际代码提炼,引用具体文件名/命令/符号;不编造、不泛泛。
 - 总长 ≤ 3000 字;只写后续会话有用的稳定事实,不写易变项(当前 bug、临时文件、未决 TODO)。
-- 用 write_file 写入项目根 MOCODE.md。
+- 用 write_file 写入项目根 AGENTS.md。
 - 写完简述:写了哪几节 + 从代码里发现的 2-3 条非显然关键约定(供用户校验)。`;
 }
 /** 临时 readline 读一行(cooked,用于子提问;主输入走 promptWithSlashMenu)。 */
@@ -750,6 +751,8 @@ export function renderHistory(history) {
 export async function startRepl(initialHistory, sessionId, sandboxRootOverride, initialQueryHistory) {
     // 模式重置:agentMode 不落盘,每个 REPL 会话从 auto 开始(/resume / --resume 亦重置)。
     setAgentMode('auto');
+    // 钉死本会话模型：之后运行中 agent 一律用此值，其它窗口的 /model switch 不会影响本窗口。
+    pinSessionModel();
     // 沙箱根:文件操作边界。优先级 --sandbox-root > SANDBOX_ROOT env > process.cwd()。
     // 纯边界记录(不 chdir),jail.ts 内部 resolve。子 agent 同进程继承全局 root。
     setSandboxRoot(sandboxRootOverride ?? config.sandboxRoot ?? process.cwd());
@@ -768,7 +771,7 @@ export async function startRepl(initialHistory, sessionId, sandboxRootOverride,
     //
     // 与开关联动:① base 用 buildBasePrompt() 取代 config.systemPrompt(后者是启动时一次性
     // 求值的常量,运行时 /memory_switch 不会刷新);② plan suffix 走 getPlanModeSuffix() 现拼;
-    // ③ MOCODE.md 只在 base 中提示按需 read_file，不注入正文；④ Memory Index 按开关注入。
+    // ③ AGENTS.md 存在工作区根时由 base 无条件自动导入正文(超长截断，与 memory 开关无关)；④ Memory Index 按开关注入。
     const buildSystemMessage = (planMode) => effectiveSystemPrompt(buildBasePrompt(currentSessionId) +
         (planMode ? getPlanModeSuffix() : '') +
         buildMemoryIndexSection(isMemoryEnabled()));
@@ -834,10 +837,12 @@ export async function startRepl(initialHistory, sessionId, sandboxRootOverride,
         if (listPresets().length === 0) {
             try {
                 const migrated = migrateCurrentToPreset({
+                    provider: config.provider,
                     baseURL: config.baseURL,
                     apiKey: config.apiKey,
                     model: config.model,
                     contextWindow: config.contextWindowTokens,
+                    anthropicPromptCache: config.anthropicPromptCache,
                 });
                 if (migrated) {
                     layout.contentWrite(`${ui.dim}  ↳ 检测到老配置,已自动迁为预设 “${migrated}”(${ui.cyan}/model list${ui.dim} 查看 · /model switch 切换)${ui.reset}\n`);
@@ -1199,7 +1204,7 @@ export async function startRepl(initialHistory, sessionId, sandboxRootOverride,
             continue;
         }
         if (line === '/init') {
-            // /init:把 init 指令当 user 输入发给 agent(扫描项目 + 生成 MOCODE.md),fall through 走 runAgent
+            // /init:把 init 指令当 user 输入发给 agent(扫描项目 + 生成 AGENTS.md),fall through 走 runAgent
             joined = buildInitPrompt();
         }
         if (line === '/upgrade' || line.startsWith('/upgrade ')) {
@@ -1438,7 +1443,7 @@ export async function startRepl(initialHistory, sessionId, sandboxRootOverride,
                 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`);
+                layout.contentWrite(`${ui.dim}(无 active 记忆;用 memory_save 存,或 /init 生成 AGENTS.md)${ui.reset}\n`);
             layout.contentWrite(`${ui.dim}(详情用 memory_search;启动索引已注入 systemPrompt)${ui.reset}\n`);
             continue;
         }
@@ -1545,9 +1550,9 @@ export async function startRepl(initialHistory, sessionId, sandboxRootOverride,
             // focus 透传到 compact_history action 的 LLM 摘要 prompt。
             // 返回 SchedulerRunLog 给 UI 显示决策;退化路径(开关关时)在 manualCompact 内部走 compactHistory。
             const log = await manualCompact(history, focus, { force });
-            // ② compact 后把活跃 plan 重注入系统提示（history[0]），避免 agent 因上下文压缩丢失执行计划。
-            if (log.compactHistoryCalled)
-                reinjectActivePlanIntoSystem(history);
+            // 会话状态(plan + 笔记段)不在此处回写 history[0]:agent/core 每步都在 requestHistory
+            // 末尾注入最新副本(buildSessionStateReminder),压缩后下一步自然恢复,且系统提示保持
+            // 逐字节稳定以命中 prompt 缓存。
             const d = log.compactDetail;
             appendCurrentSessionRuntimeEvent('compact', {
                 source: 'manual',
@@ -1716,16 +1721,20 @@ export async function startRepl(initialHistory, sessionId, sandboxRootOverride,
             // 共用:apply 一个预设到 config + 持久化 + 重建 client + 重显横幅。无参 /model 选菜单和 /model use 都走这里。
             const applyPresetAndPersist = (target) => {
                 updateModelConfig({
+                    provider: target.provider,
                     model: target.model,
                     baseURL: target.baseURL,
                     apiKey: target.apiKey,
                     contextWindowTokens: target.contextWindow,
+                    anthropicPromptCache: target.anthropicPromptCache,
                 });
                 writeConfigKeys({
+                    LLM_PROVIDER: target.provider,
                     LLM_BASE_URL: target.baseURL,
                     LLM_API_KEY: target.apiKey,
                     LLM_MODEL: target.model,
                     CONTEXT_WINDOW_TOKENS: String(target.contextWindow),
+                    ANTHROPIC_PROMPT_CACHE: target.anthropicPromptCache ? 'true' : 'false',
                 });
                 reconfigureClient();
                 refreshStatusBase(history);
@@ -1736,20 +1745,22 @@ export async function startRepl(initialHistory, sessionId, sandboxRootOverride,
                 else {
                     layout.writeBanner(bannerLines(banner()));
                 }
-                layout.contentWrite(`${ui.dim}(已切换到预设 “${target.name}” → ${target.model} @ ${target.baseURL})${ui.reset}\n`);
+                const cacheLabel = target.provider === 'anthropic'
+                    ? ` · Prompt Cache ${target.anthropicPromptCache ? 'on' : 'off'}`
+                    : '';
+                layout.contentWrite(`${ui.dim}(已切换到预设 “${target.name}” → ${target.model} · ${target.provider}${cacheLabel} @ ${target.baseURL})${ui.reset}\n`);
                 if (config.llmKeysFromShell.length > 0) {
                     layout.contentWrite(`${ui.dim}(shell 环境变量已设 ${config.llmKeysFromShell.join(' / ')},文件写入下次启动被其覆盖)${ui.reset}\n`);
                 }
             };
-            // 决定自动存的预设名:用 desired(model 字段),若与已有预设四元组完全相同则不重复存(返 null);
-            // 否则若 desired 已存在则追加 -2/-3/...。desired 含非法字符(如 glm-4.6 的 '.')时先 sanitize(. → -),
-            // sanitize 后仍空才退化到 'preset'。
-            const uniquePresetName = (desired, baseURL, apiKey, model, contextWindow) => {
+            // 决定自动存的预设名:协议、缓存配置和连接四元组都一致时不重复存。
+            const uniquePresetName = (desired, provider, baseURL, apiKey, model, contextWindow, anthropicPromptCache) => {
                 const existing = listPresets();
-                const sameEntry = existing.find((p) => p.baseURL === baseURL && p.apiKey === apiKey && p.model === model && p.contextWindow === contextWindow);
+                const sameEntry = existing.find((p) => p.provider === provider && p.baseURL === baseURL && p.apiKey === apiKey
+                    && p.model === model && p.contextWindow === contextWindow
+                    && p.anthropicPromptCache === anthropicPromptCache);
                 if (sameEntry)
-                    return null; // 完全相同,不重复存
-                // sanitize:把非 [a-zA-Z0-9_-] 字符(如 glm-4.6 的 '.')替换为 -,压缩两端 -,裁 1-32。
+                    return null;
                 const sanitized = desired
                     .replace(/[^a-zA-Z0-9_-]+/g, '-')
                     .replace(/^-+|-+$/g, '')
@@ -1773,14 +1784,17 @@ export async function startRepl(initialHistory, sessionId, sandboxRootOverride,
                     layout.contentWrite(`${ui.dim}(还没有预设;先跑 /model 添加一个)${ui.reset}\n`);
                     continue;
                 }
-                const isCurrent = (p) => p.baseURL === config.baseURL &&
+                const isCurrent = (p) => p.provider === config.provider &&
+                    p.baseURL === config.baseURL &&
                     p.apiKey === config.apiKey &&
                     p.model === config.model &&
-                    p.contextWindow === config.contextWindowTokens;
+                    p.contextWindow === config.contextWindowTokens &&
+                    p.anthropicPromptCache === (config.provider === 'anthropic' && config.anthropicPromptCache);
                 const cols = layout.getGeo().cols;
                 const labelFor = (p) => {
                     const tag = isCurrent(p) ? ' ★current' : '';
-                    const right = `${p.model} @ ${p.baseURL}`;
+                    const cache = p.provider === 'anthropic' ? ` · cache ${p.anthropicPromptCache ? 'on' : 'off'}` : '';
+                    const right = `${p.provider}${cache} · ${p.model} @ ${p.baseURL}`;
                     const left = `${p.name}${tag}`;
                     const sep = left.length + 1 + right.length;
                     if (sep <= cols - 2)
@@ -1790,7 +1804,7 @@ export async function startRepl(initialHistory, sessionId, sandboxRootOverride,
                 const choice = await promptIntervention({
                     type: 'choice',
                     title: '切换模型预设',
-                    detail: `当前: ${config.model} @ ${config.baseURL}(★ = 已匹配)`,
+                    detail: `当前: ${config.provider} · ${config.model} @ ${config.baseURL}(★ = 已匹配)`,
                     options: presets.map(labelFor),
                     allowCustom: false, // 纯切换,不需要「其他」干扰
                 });
@@ -1812,19 +1826,30 @@ export async function startRepl(initialHistory, sessionId, sandboxRootOverride,
                 }
                 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.accent}${p.name}${ui.reset}${star}  ${ui.dim}${p.model} @ ${p.baseURL}${ui.reset}\n`);
+                    const current = p.provider === config.provider
+                        && p.baseURL === config.baseURL
+                        && p.apiKey === config.apiKey
+                        && p.model === config.model
+                        && p.contextWindow === config.contextWindowTokens
+                        && p.anthropicPromptCache === (config.provider === 'anthropic' && config.anthropicPromptCache);
+                    const star = current ? ' ★' : '';
+                    const cache = p.provider === 'anthropic' ? ` · cache ${p.anthropicPromptCache ? 'on' : 'off'}` : '';
+                    layout.contentWrite(`  ${ui.accent}${p.name}${ui.reset}${star}  ${ui.dim}${p.provider}${cache} · ${p.model} @ ${p.baseURL}${ui.reset}\n`);
                 }
-                layout.contentWrite(`${ui.dim}(★ = 与当前一致;切换用 /model switch)${ui.reset}\n`);
+                layout.contentWrite(`${ui.dim}(★ = 与当前协议及缓存配置一致;切换用 /model switch)${ui.reset}\n`);
                 continue;
             }
-            // /model show:显示当前四项配置(apiKey 脱敏)。
+            // /model show:显示当前协议、连接与缓存配置(apiKey 脱敏)。
             if (arg === 'show') {
                 layout.contentWrite(`${ui.dim}当前模型配置:${ui.reset}\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.accent}provider${ui.reset}  ${config.provider}\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`);
+                if (config.provider === 'anthropic') {
+                    layout.contentWrite(`  ${ui.accent}缓存    ${ui.reset}  Prompt Cache ${config.anthropicPromptCache ? 'on' : 'off'}\n`);
+                }
                 layout.contentWrite(`${ui.dim}(配置文件: ${CONFIG_PATH})${ui.reset}\n`);
                 continue;
             }
@@ -2017,25 +2042,42 @@ export async function startRepl(initialHistory, sessionId, sandboxRootOverride,
                     }
                 }
             }
-            // 3) 应用:内存 config + env(updateModelConfig)→ 持久化(writeConfigKeys)→ 重建 client(reconfigureClient)。
-            updateModelConfig({ model, baseURL, apiKey, contextWindowTokens: window });
+            // 3) 应用协议、连接与缓存配置；Anthropic 原生协议无需重建 OpenAI client，但统一刷新无害。
+            const provider = preset.provider;
+            const anthropicPromptCache = provider === 'anthropic' && preset.anthropicPromptCache;
+            updateModelConfig({
+                provider,
+                model,
+                baseURL,
+                apiKey,
+                contextWindowTokens: window,
+                anthropicPromptCache,
+            });
             writeConfigKeys({
+                LLM_PROVIDER: provider,
                 LLM_BASE_URL: baseURL,
                 LLM_API_KEY: apiKey,
                 LLM_MODEL: model,
                 CONTEXT_WINDOW_TOKENS: String(window),
+                ANTHROPIC_PROMPT_CACHE: anthropicPromptCache ? 'true' : 'false',
             });
             reconfigureClient();
-            // 3.5) 自动存为命名预设:用 model 字段,重名追加 -2/-3,完全相同的四元组不重复存。
-            //     让 /model 跑一次就多一份可切换的预设,/model switch 切回去。
+            // 3.5) 自动存为命名预设；协议与缓存策略也是去重键的一部分。
             let savedName = null;
             try {
-                const finalName = uniquePresetName(model, baseURL, apiKey, model, window);
+                const finalName = uniquePresetName(model, provider, baseURL, apiKey, model, window, anthropicPromptCache);
                 if (finalName) {
-                    savePreset({ name: finalName, baseURL, apiKey, model, contextWindow: window });
+                    savePreset({
+                        name: finalName,
+                        provider,
+                        baseURL,
+                        apiKey,
+                        model,
+                        contextWindow: window,
+                        anthropicPromptCache,
+                    });
                     savedName = finalName;
                 }
-                // finalName === null 表示与某个已存在预设完全一致,不再重复保存。
             }
             catch (e) {
                 layout.contentWrite(`${ui.red}保存预设失败: ${e.message}${ui.reset}\n`);
@@ -2049,7 +2091,10 @@ export async function startRepl(initialHistory, sessionId, sandboxRootOverride,
             else {
                 layout.writeBanner(bannerLines(banner()));
             }
-            layout.contentWrite(`${ui.dim}(已切换模型 → ${model} @ ${baseURL})${ui.reset}\n`);
+            const cacheLabel = provider === 'anthropic'
+                ? ` · Prompt Cache ${anthropicPromptCache ? 'on' : 'off'}`
+                : '';
+            layout.contentWrite(`${ui.dim}(已切换模型 → ${model} · ${provider}${cacheLabel} @ ${baseURL})${ui.reset}\n`);
             if (savedName) {
                 layout.contentWrite(`${ui.dim}(已保存为预设 “${savedName}”,下次 /model use ${savedName} 一键切回)${ui.reset}\n`);
             }

package/dist/session/compact.js

@@ -292,10 +292,22 @@ export async function compactHistory(history, opts) {
     let oldGroups = groups.slice(0, groups.length - kept.length);
     // force(硬闸/手动强压):保护区不豁免——常规切分无旧区时只保最后一组,
     // 其余全部进可压区(首轮/当前轮也一样)。仍按 group 边界切,不破坏 tool_call 配对。
+    // **必须保留最早 user 所在 group**:LLM API(OpenAI / Anthropic)要求 messages 至少
+    //  含一条非空 user 消息,否则 400。force 旧实现把所有 user 丢进摘要 → 重建后 history
+    //  无 user → 下一轮 chat() 被后端拒绝。保最早 user(而非最后一个)因为它是最原始的
+    //  请求上下文,摘要器已覆盖后续交互。
     if (oldGroups.length === 0 && opts.force && groups.length >= 2) {
         kept.length = 0;
-        kept.push(groups[groups.length - 1]);
-        oldGroups = groups.slice(0, groups.length - 1);
+        const lastIdx = groups.length - 1;
+        const firstUserIdx = groups.findIndex((g) => g.assistant?.role === 'user');
+        if (firstUserIdx >= 0 && firstUserIdx !== lastIdx) {
+            kept.push(groups[firstUserIdx], groups[lastIdx]);
+            oldGroups = groups.filter((_, i) => i !== firstUserIdx && i !== lastIdx);
+        }
+        else {
+            kept.push(groups[lastIdx]);
+            oldGroups = groups.slice(0, groups.length - 1);
+        }
     }
     const noop = {
         compacted: false,
@@ -319,6 +331,8 @@ export async function compactHistory(history, opts) {
                 const estimateAfter = estimatePromptTokens(history, activeTools, state.correction);
                 state.lastEstimate = estimateAfter;
                 state.lastUsage = undefined;
+                if (!layout.isLastContentRowBlank())
+                    layout.contentWrite('\n');
                 layout.contentWrite(`  ${ui.bold}${ui.accent}●${ui.reset} ${ui.accent}强制微压缩(单组)${ui.reset}  ${ui.dim}${estimateBefore} → ${estimateAfter} tokens${ui.reset}\n`);
                 return {
                     compacted: true,
@@ -339,6 +353,8 @@ export async function compactHistory(history, opts) {
         }
         // history 有内容但全在保护区(系统 + 当前轮)
         if (estimateBefore >= opts.threshold * opts.window) {
+            if (!layout.isLastContentRowBlank())
+                layout.contentWrite('\n');
             layout.contentWrite(`  ${ui.yellow}●${ui.reset} ${ui.yellow}上下文已超阈但无可压缩项(全在保护区),建议 /clear 或缩短输入。${ui.reset}\n`);
             return { ...noop, reason: 'noop-shrunk-too-large', protectedRatio };
         }
@@ -383,6 +399,10 @@ export async function compactHistory(history, opts) {
         const estimateAfter = estimatePromptTokens(history, activeTools, state.correction);
         state.lastEstimate = estimateAfter;
         state.lastUsage = undefined; // 压缩后旧 usage 失效,/context 改用校正估算
+        // 压缩行与上一个工具批次摘要行之间补空行分隔(compact 在 core step 循环顶部触发,
+        // 上一步的 batch 可能尚未 flush,缓冲末行仍是 ● 工具摘要行 → 两行黏在一起)。
+        if (!layout.isLastContentRowBlank())
+            layout.contentWrite('\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) {
@@ -402,6 +422,8 @@ export async function compactHistory(history, opts) {
     state.lastEstimate = estimateAfter;
     state.lastUsage = undefined; // token 数已变,旧 usage 失效
     if (microcompactDone) {
+        if (!layout.isLastContentRowBlank())
+            layout.contentWrite('\n');
         layout.contentWrite(`  ${ui.bold}${ui.accent}●${ui.reset} ${ui.accent}微压缩旧工具结果${ui.reset}  ${ui.dim}${estimateBefore} → ${estimateAfter} tokens${ui.reset}\n`);
         return {
             compacted: true,

package/dist/session/notes.js

@@ -105,3 +105,236 @@ export function writePlanToNotes(plan, sessionId = getCurrentSessionId()) {
     }
     return { path: p, settled: plan.steps.length > 0 && plan.steps.every((s) => s.status === 'completed') };
 }
+// ── Session notes(单会话永久记忆):note_append 写入,reinject 常驻 system ──────
+// 设计:notes.md 不止放 Plan。note_append 往预设笔记段追加一条 finding/decision/
+// open_question/risk;extractActiveNotesSections 读出活跃笔记段正文(排除 Plan/Done),
+// 按 5k token 预算裁剪后由 reinjectSessionStateIntoSystem 注入 system prompt——compact
+// 后仍能恢复,让 agent 始终记得本会话做过什么、发现过什么(单会话永久记忆)。
+/** note_append 接受的预设段 key → 渲染标题。 */
+const NOTE_SECTION_TITLES = {
+    findings: 'Findings',
+    decisions: 'Decisions',
+    open_questions: 'Open Questions',
+    risks: 'Risks',
+};
+/** 预设段 key 列表(供工具 schema enum 与校验用)。 */
+export const NOTE_SECTION_KEYS = Object.keys(NOTE_SECTION_TITLES);
+/** 段注入优先级:数值越大越先占预算、越后丢弃正文。Risks 最重要。 */
+const SECTION_PRIORITY = {
+    risks: 4, findings: 3, decisions: 2, open_questions: 1,
+};
+/** 常驻笔记正文总预算(token)。5k:占百万级 context 的 0.5%,可常驻相当量笔记。 */
+const NOTES_INJECT_BUDGET_TOKENS = 5000;
+/** 单段正文上限(token):防单段独占预算。 */
+const NOTES_PER_SECTION_TOKENS = 2000;
+/** 单条笔记上限(token):防一条过长吃掉整段预算。 */
+const NOTES_PER_ENTRY_TOKENS = 800;
+/**
+ * 轻量 token 估算(启发式,不依赖 tokenizer):CJK ≈ 0.6 token/字,
+ * ASCII ≈ 0.25 token/字。对 GLM/DeepSeek/Qwen 等中文偏多的后端略偏保守
+ * (估算略高于实际 → 注入实际 token 略低于预算 → 安全侧)。仅供笔记 cap 用,
+ * 不替换 llm/estimatePromptTokens 的主口径。
+ */
+function estimateTokens(text) {
+    let cjk = 0;
+    let other = 0;
+    for (let i = 0; i < text.length; i++) {
+        const c = text.charCodeAt(i);
+        if ((c >= 0x3000 && c <= 0x9fff) || (c >= 0xff00 && c <= 0xffef))
+            cjk++;
+        else
+            other++;
+    }
+    return Math.ceil(cjk * 0.6 + other * 0.25);
+}
+/** 把标题映射回预设 key(非预设段返 '',优先级 0,最后注入)。 */
+function matchSectionKey(title) {
+    const t = title.trim().toLowerCase();
+    for (const [k, v] of Object.entries(NOTE_SECTION_TITLES)) {
+        if (v.toLowerCase() === t)
+            return k;
+    }
+    return '';
+}
+/**
+ * 往 notes.md 的指定笔记段追加一条。段存在则在其末尾追加(保留其它段不动);
+ * 段不存在则在文件末新建。返回 { path } 或 { error }。
+ */
+export function appendNoteToSection(section, entry, tag, sessionId = getCurrentSessionId()) {
+    const title = NOTE_SECTION_TITLES[section];
+    if (!title)
+        return { error: `unknown note section "${section}"` };
+    const p = getNotesFilePath(sessionId);
+    if (!p)
+        return { error: 'no active session' };
+    const line = tag ? `- **[${tag}]** ${entry}` : `- ${entry}`;
+    let existing = '';
+    try {
+        existing = fs.readFileSync(p, 'utf8').replace(/\r\n?/g, '\n');
+    }
+    catch {
+        existing = '';
+    }
+    const header = `## ${title}`;
+    const lines = existing.split('\n');
+    const start = lines.findIndex((l) => l.trim() === header);
+    let next;
+    if (start >= 0) {
+        // 段末 = 下一个 ## 或文件末
+        let end = lines.length;
+        for (let k = start + 1; k < lines.length; k++) {
+            if (/^##\s/.test(lines[k])) {
+                end = k;
+                break;
+            }
+        }
+        const before = lines.slice(0, start).join('\n').replace(/\s+$/, '');
+        const sectionLines = lines.slice(start, end);
+        // 去段尾空行后追加新条目
+        while (sectionLines.length && sectionLines[sectionLines.length - 1].trim() === '')
+            sectionLines.pop();
+        sectionLines.push(line);
+        const section = sectionLines.join('\n');
+        const after = lines.slice(end).join('\n').replace(/^\s+/, '');
+        next = [before, section, after].filter((s) => s.length > 0).join('\n\n') + '\n';
+    }
+    else {
+        // 新建段:放文件末,与已有内容以空行分隔
+        const rest = existing.trim();
+        const newSection = `${header}\n${line}`;
+        next = rest ? `${rest}\n\n${newSection}\n` : `${newSection}\n`;
+    }
+    try {
+        fs.mkdirSync(path.dirname(p), { recursive: true });
+        fs.writeFileSync(p, next, 'utf8');
+    }
+    catch (e) {
+        return { error: e instanceof Error ? e.message : String(e) };
+    }
+    return { path: p };
+}
+/** 按字符二分截断条目到 token 上限,加省略标记。条目不长,线性二分足够。 */
+function truncateEntry(entry, maxTokens) {
+    if (estimateTokens(entry) <= maxTokens)
+        return entry;
+    let lo = 0;
+    let hi = entry.length;
+    while (lo < hi) {
+        const mid = Math.ceil((lo + hi) / 2);
+        if (estimateTokens(entry.slice(0, mid)) <= maxTokens)
+            lo = mid;
+        else
+            hi = mid - 1;
+    }
+    return entry.slice(0, lo).replace(/\s+$/, '') + ' …[truncated]';
+}
+/** 把单段正文按条目分割,从末尾(最近)保留,丢最旧,裁到 token 预算内。 */
+function trimSectionToBudget(body, budgetTokens) {
+    if (budgetTokens <= 0)
+        return null;
+    const bodyLines = body.split('\n');
+    const header = bodyLines[0] ?? '';
+    const rest = bodyLines.slice(1);
+    // 分条目:以 "- " 开头为一条起始,后续非 "- " 行归入该条
+    const entries = [];
+    let cur = [];
+    for (const ln of rest) {
+        if (/^-\s+/.test(ln)) {
+            if (cur.length)
+                entries.push(cur.join('\n'));
+            cur = [ln];
+        }
+        else {
+            cur.push(ln);
+        }
+    }
+    if (cur.length)
+        entries.push(cur.join('\n'));
+    const kept = [];
+    let used = estimateTokens(header);
+    for (let k = entries.length - 1; k >= 0; k--) {
+        let e = entries[k];
+        if (estimateTokens(e) > NOTES_PER_ENTRY_TOKENS) {
+            e = truncateEntry(e, NOTES_PER_ENTRY_TOKENS);
+        }
+        const t = estimateTokens(e);
+        if (used + t > budgetTokens)
+            break;
+        kept.unshift(e);
+        used += t;
+    }
+    if (kept.length === 0)
+        return null;
+    return `${header}\n${kept.join('\n')}`;
+}
+/**
+ * 读 notes.md,提取所有活跃笔记段正文(排除 `## Plan:` 与 `## Done:`),
+ * 按 NOTES_INJECT_BUDGET_TOKENS 裁剪后返回——供 reinject 注入 system prompt。
+ * 裁剪策略:段按优先级排序(Risks>Findings>Decisions>Open Questions>自定义),
+ * 逐段注入累计 token;单段超 per-section 则段内从最近条目保留丢最旧;
+ * 总预算用尽则后续段不注入正文(其标题仍由 buildNotepadSection 索引常驻,
+ * agent 可 read_file 取细节)。这样 5k 预算内"写了就常驻",超出降级为索引+按需 read。
+ */
+export function extractActiveNotesSections(budget = NOTES_INJECT_BUDGET_TOKENS, sessionId = getCurrentSessionId()) {
+    const p = getNotesFilePath(sessionId);
+    if (!p)
+        return '';
+    let content = '';
+    try {
+        content = fs.readFileSync(p, 'utf8').replace(/\r\n?/g, '\n');
+    }
+    catch {
+        return '';
+    }
+    const lines = content.split('\n');
+    const sections = [];
+    let i = 0;
+    while (i < lines.length) {
+        const m = lines[i].match(/^##\s+(.+?)\s*$/);
+        if (!m) {
+            i++;
+            continue;
+        }
+        const title = m[1];
+        // 跳过 Plan/Done 段(Plan 有专属 ACTIVE_PLAN_MARKER 重注入;Done 是归档不常驻)
+        if (/^Plan:/.test(title) || /^Done:/.test(title)) {
+            i++;
+            while (i < lines.length && !/^##\s/.test(lines[i]))
+                i++;
+            continue;
+        }
+        const start = i;
+        i++;
+        while (i < lines.length && !/^##\s/.test(lines[i]))
+            i++;
+        const body = lines.slice(start, i).join('\n').trim();
+        if (body)
+            sections.push({ key: matchSectionKey(title), body });
+    }
+    // 按优先级降序(优先级高的先占预算)
+    sections.sort((a, b) => (SECTION_PRIORITY[b.key] ?? 0) - (SECTION_PRIORITY[a.key] ?? 0));
+    let used = 0;
+    const out = [];
+    for (const s of sections) {
+        const remaining = budget - used;
+        if (remaining <= 0)
+            break;
+        const bodyTokens = estimateTokens(s.body);
+        if (bodyTokens <= Math.min(remaining, NOTES_PER_SECTION_TOKENS)) {
+            out.push(s.body);
+            used += bodyTokens;
+            continue;
+        }
+        // 段超预算:段内裁条目(从最近保留)
+        const cap = Math.min(remaining, NOTES_PER_SECTION_TOKENS);
+        const trimmed = trimSectionToBudget(s.body, cap);
+        if (trimmed) {
+            out.push(trimmed);
+            used += estimateTokens(trimmed);
+        }
+        // 预算用尽则后续段不再注入正文(降级为索引)
+        if (used >= budget)
+            break;
+    }
+    return out.join('\n\n');
+}

package/dist/session/persist.js

@@ -1,6 +1,6 @@
 import { existsSync, mkdirSync, readFileSync, readdirSync, unlinkSync, writeFileSync, } from 'node:fs';
 import path from 'node:path';
-import { config } from '../config/index.js';
+import { config, getActiveModel } from '../config/index.js';
 import { truncateDisplay } from '../ui/render.js';
 /** 会话目录(确保存在)。 */
 export function sessionDir() {
@@ -49,7 +49,7 @@ export function saveSession(history, id, queryHistory = []) {
     const meta = {
         id,
         createdAt: idToIso(id),
-        model: config.model,
+        model: getActiveModel(),
         firstUser: history.length > 1
             ? firstUserOf(history)
             : truncateDisplay((queryHistory[0] ?? '').replace(/\n/g, ' ').trim(), 40),