mocode-ai 0.1.8 → 0.1.9

package/README.md

@@ -58,6 +58,8 @@ npm start
 mocode config
 ```
 
+也可直接 `mocode` 进入 REPL 后用 `/model` 命令配置(交互选后端预设 + 逐项填写,即时生效 + 持久化)。未配置时 REPL 仍能打开,会提示你跑 `/model`。
+
 也可手写配置文件。mocode 按以下优先级加载(后者覆盖前者,仅回填未设置的环境变量;shell 里 `export` 的永远最优先):
 
 1. `~/.mocode/config` — 全局(`mocode config` 写此文件)
@@ -149,6 +151,7 @@ agent 工作在**启动时所在的工作目录**——想让它操作某个项
 | `/resume` | 续接已保存的会话 |
 | `/think` | 展开折叠思考段(`/think N`) |
 | `/rollback` | 菜单选轮次回滚(↑↓ · Enter) |
+| `/model` | 配置大模型(baseURL / apiKey / model / 上下文窗口),即时生效 + 持久化 |
 
 输入 `/` 触发下拉菜单,继续打字过滤;Esc 取消。
 

package/dist/agent/core.js

@@ -9,7 +9,7 @@ import { chat, planChatTools, } from '../llm/index.js';
 import { executeTool } from '../tools/registry.js';
 import { PLAN_DISABLED_TOOLS } from '../tools/constants.js';
 import { getAgentMode, setAgentMode } from './mode.js';
-import { maybeCompact, contextState } from '../session/index.js';
+import { maybeCompact, contextState, dropContextFromHistory } from '../session/index.js';
 import { optimizeToolResult } from '../context/index.js';
 import { config } from '../config/index.js';
 import { jailResolve } from '../sandbox/index.js';
@@ -107,6 +107,10 @@ export async function runAgentCore(opts) {
     const t0 = Date.now();
     let done = false; // 正常完毕 / 达上限 true;中断 false(不显摘要)
     history.push({ role: 'user', content: userInput });
+    // drop_context 工具的上下文剔除回调:闭包捕获 history,原地剔除无关旧 tool 结果。
+    // 保护由 dropContextFromHistory 内部保证:history[0](system)+ 当前轮(最后 user 及其后)永不剔除。
+    // 子 agent 也在自己的 history 上操作(子 agent 独立 history);skipRollback 不影响此行为。
+    const dropContext = (filter) => dropContextFromHistory(history, filter);
     // 本轮流式状态:首个正文 token 到达即停 spinner(思考期间 spinner 持续转「思考中…」,不写思考内容)。
     let mode = 'idle';
     let gotText = false;
@@ -202,7 +206,7 @@ export async function runAgentCore(opts) {
                         while (j < calls.length && READ_TOOL_NAMES.has(calls[j].name))
                             j++;
                         const batch = calls.slice(i, j);
-                        const started = batch.map((tc) => executeTool(tc.name, tc.arguments, signal, { skipRollback }));
+                        const started = batch.map((tc) => executeTool(tc.name, tc.arguments, signal, { skipRollback, dropContext }));
                         for (let k = 0; k < batch.length; k++) {
                             const tc = batch[k];
                             hooks.onToolHeader?.(tc);
@@ -238,7 +242,7 @@ export async function runAgentCore(opts) {
                         while (j < calls.length && calls[j].name === 'task')
                             j++;
                         const batch = calls.slice(i, j);
-                        const started = batch.map((tc) => executeTool(tc.name, tc.arguments, signal, { skipRollback }));
+                        const started = batch.map((tc) => executeTool(tc.name, tc.arguments, signal, { skipRollback, dropContext }));
                         // 先批量打印所有头 + 启 spinner(多 task 并发,spinner 只显一个,但 ● 头都打出来)
                         for (const tc of batch) {
                             hooks.onToolHeader?.(tc);
@@ -273,7 +277,7 @@ export async function runAgentCore(opts) {
                             : null;
                         const { preWriteOld, editStartLine } = readDiffContext(tc, parsed);
                         hooks.onToolStart?.(tc.name);
-                        const output = await executeTool(tc.name, tc.arguments, signal, { skipRollback });
+                        const output = await executeTool(tc.name, tc.arguments, signal, { skipRollback, dropContext });
                         hooks.onToolDone?.();
                         hooks.onToolResult?.(tc, output, parsed, preWriteOld, editStartLine);
                         pushToolResult(history, tc, output);

package/dist/commands/config.js

@@ -9,7 +9,7 @@ function ask(rl, q) {
  * 首跑配置向导:交互填 LLM_BASE_URL / LLM_API_KEY / LLM_MODEL,写 ~/.mocode/config。
  * 只交互三键、保留文件里其它键(MAX_TOKENS / CONTEXT_WINDOW_TOKENS / MOCODE_THEME 等)。
  * prompt 全纯文本(readline 光标按字符算,不能含 ANSI)。
- * 由 index.ts 在 `mocode config` 时动态加载,故不 import config/index.ts(避免缺配置时 requireEnv
+ * 由 index.ts 在 `mocode config` 时动态加载,故不 import config/index.ts(避免触发 config 单例初始化 / loadEnvFiles,
  * 直接退出);只 import config/file.ts(纯 I/O 叶子,无 env 校验 / process.exit)。
  */
 export async function runConfigWizard() {

package/dist/config/file.js

@@ -5,7 +5,7 @@ import dotenv from 'dotenv';
 /**
  * ~/.mocode/config 全局 dotenv 配置的读写叶子(纯 node:fs / node:os / node:path + dotenv)。
  *
- * 独立于 `config/index.ts`——**不**触发 requireEnv / process.exit,故 `commands/config.ts`
+ * 独立于 `config/index.ts`——**不**触发 config 单例初始化 / loadEnvFiles,故 `commands/config.ts`
  * (首跑向导,刻意不 import config/index.ts)与 `repl/index.ts`(`/theme` 持久化)都能安全共享。
  * 主题等 UI 偏好走 `updateConfigKey` 单键写;向导多键一次性写走 `writeConfigKeys`。
  */

package/dist/config/index.js

@@ -30,14 +30,26 @@ function loadEnvFiles() {
 }
 // 在 loadEnvFiles 回填前捕获:MOCODE_THEME 是否由 shell 设置(决定 /theme 写文件是否下次启动生效)。
 const themeFromShell = process.env.MOCODE_THEME !== undefined;
+// 在 loadEnvFiles 回填前捕获:哪些 LLM 键由 shell 设置(决定 /model 写文件是否下次启动生效)。
+// 仿 themeFromShell 模式:shell export 的环境变量在 loadEnvFiles 中不被回填(优先级最高),
+// 故 /model 写入 ~/.mocode/config 的同名键下次启动会被 shell 值覆盖——据此给 dim 警告。
+const LLM_ENV_KEYS = ['LLM_BASE_URL', 'LLM_API_KEY', 'LLM_MODEL', 'CONTEXT_WINDOW_TOKENS'];
+const llmKeysFromShell = LLM_ENV_KEYS.filter((k) => process.env[k] !== undefined);
 loadEnvFiles();
+/**
+ * 取环境变量;缺则返回空字符串(不退出)。
+ * 历史上缺 LLM_BASE_URL/LLM_API_KEY 会 process.exit(1),但 /model 命令已能在 REPL 内配置模型,
+ * 故首次未配置也应让 REPL 起来,由开场提示引导用户跑 /model。发消息时 chat() 会抛错被 runTurn catch,不崩。
+ */
 function requireEnv(key) {
-    const v = process.env[key];
-    if (!v) {
-        console.error(`\n[config] 缺少 ${key}。运行 \`mocode config\` 初始化,或在 ~/.mocode/config / <cwd>/.env 中设置(参考 .env.example)。\n`);
-        process.exit(1);
-    }
-    return v;
+    return process.env[key] || '';
+}
+/**
+ * 模型是否已配置(baseURL + apiKey 非空)。REPL 开场据此决定是否提示 /model。
+ * 未配置时 config.model 仍回退 'gpt-4o-mini',但发消息会因 baseURL/apiKey 空而失败——由 runTurn catch 友好提示。
+ */
+export function isModelConfigured() {
+    return !!config.baseURL && !!config.apiKey;
 }
 const PLATFORM_NOTE = (() => {
     if (process.platform === 'win32') {
@@ -76,6 +88,7 @@ ${PLATFORM_NOTE}
 - Use web_search for information beyond training data (new versions, news, real-time data, latest APIs); don't answer potentially outdated info from memory.
 - Use web_fetch to read a specific URL (a link from search results, or a URL given by the user); it only fetches static HTML — if a JS-rendered page yields no body, switch to web_search (its results include cleaned body text).
 - Call ask_human when you hit a decision point requiring user input (multiple implementation approaches, unclear intent, or needing extra info to proceed) — list options for the user to pick (they can also choose "custom input" to answer freely). Don't call it frequently when the task is clear and you can decide yourself; if the user cancels, switch approach or proceed with available info — don't re-ask the same question.
+- **Drop irrelevant context** (use sparingly): call drop_context to stub-replace tool results in history that are BOTH (a) irrelevant to the current task AND (b) large (the freed tokens must clearly exceed the ~300 tokens the call itself costs — roughly only worth it when targeting ≥2 bulky results, e.g. wide grep/read sweeps that returned mostly-irrelevant hits). The call itself adds a tool-call round-trip, so don't call it for one small result or when you're near done. It preserves tool_call_id pairing (only content changes); the system prompt and current turn are never dropped. Use filters (toolNames / contains) to target precisely.
 
 ## Failure Handling
 - Tools return errors as strings (edit_file no match or non-unique, run_command non-zero exit, etc.). Analyze the root cause, adjust, then retry — don't resend the same call verbatim.
@@ -111,7 +124,7 @@ You are in PLAN mode: investigate and design only — do NOT execute or change a
 - Research thoroughly: locate the relevant code, trace call paths, and understand existing patterns and conventions before designing. Prefer codegraph when a .codegraph/ index exists.
 - Then produce a clear, actionable implementation plan: files to change (with paths), what to change in each and why, the ordered steps, edge cases to handle, and how to verify (typecheck / tests / build). Be specific enough to execute against.
 - Present the plan as your final reply and STOP, unless the user explicitly asked you to "plan first then execute" / "先 plan 再 auto" / autonomous execution: in that case, after presenting the plan, call the switch_mode tool with mode="auto" to switch back to auto mode WITHIN THE SAME TURN and continue implementing the plan yourself (your write/edit/command/memory-write tools become available again immediately). The user will see no approval prompt because you self-switched.
-- If the user entered plan mode manually (via /plan or Shift+Tab) for a safety review and did NOT ask for autonomous execution, do NOT call switch_mode — present the plan and STOP; the user will approve via a prompt and execution happens in a follow-up turn.`;
+- If the user entered plan mode manually (via /plan or Shift+Tab) for a safety review and did NOT ask for autonomous execution, do NOT call switch_mode — present the plan and STOP. Do NOT ask the user for confirmation or approval in your text reply (e.g. "is this plan OK?", "shall I proceed?", "需要你确认") — the REPL automatically shows an approval prompt after you STOP, so asking in text is redundant and forces the user to answer twice. Just present the plan and end your reply.`;
 export const config = {
     baseURL: requireEnv('LLM_BASE_URL'),
     apiKey: requireEnv('LLM_API_KEY'),
@@ -133,4 +146,31 @@ export const config = {
     searchBaseUrl: process.env.ANYSEARCH_BASE_URL || 'https://api.anysearch.com',
     theme: process.env.MOCODE_THEME || 'default',
     themeFromShell,
+    llmKeysFromShell,
 };
+/**
+ * 运行时更新模型相关配置(/model 命令调)。
+ * - 更新 config 对象字段(即时生效:chat() 读 config.model,reconfigureClient 读 config.baseURL/apiKey)。
+ * - 同步 process.env(保持内存一致:其他读 process.env 的路径也拿到新值;且使新值在下次启动的
+ *   loadEnvFiles 中被视为"已设",不被文件回填覆盖——即"优先拿这里的")。
+ * 持久化(写 ~/.mocode/config)由调用方走 writeConfigKeys,此处只管内存 + env。
+ * 重建 OpenAI 客户端(baseURL/apiKey 是构造时固化的实例字段)由调用方走 reconfigureClient。
+ */
+export function updateModelConfig(opts) {
+    if (opts.model !== undefined) {
+        config.model = opts.model;
+        process.env.LLM_MODEL = opts.model;
+    }
+    if (opts.baseURL !== undefined) {
+        config.baseURL = opts.baseURL;
+        process.env.LLM_BASE_URL = opts.baseURL;
+    }
+    if (opts.apiKey !== undefined) {
+        config.apiKey = opts.apiKey;
+        process.env.LLM_API_KEY = opts.apiKey;
+    }
+    if (opts.contextWindowTokens !== undefined) {
+        config.contextWindowTokens = opts.contextWindowTokens;
+        process.env.CONTEXT_WINDOW_TOKENS = String(opts.contextWindowTokens);
+    }
+}

package/dist/context/classifier.js

@@ -7,7 +7,7 @@
 //
 // 单一事实源风格(仿 tools/constants.ts 的 READ_TOOL_NAMES / PLAN_DISABLED_TOOLS)。
 // 加新工具:在 BY_NAME 加一行;或靠形状启发自动识别。
-/** 工具名 → ContextKind 的强先验表(覆盖全部 17 内置工具)。 */
+/** 工具名 → ContextKind 的强先验表(覆盖全部 18 内置工具)。 */
 const BY_NAME = {
     // tree:路径列表 → 缩进树
     glob: 'tree',
@@ -32,6 +32,7 @@ const BY_NAME = {
     write_file: 'status',
     ask_human: 'status',
     switch_mode: 'status',
+    drop_context: 'status',
     memory_save: 'status',
     memory_update: 'status',
     memory_forget: 'status',

package/dist/index.js

@@ -2,7 +2,8 @@ import { exitAltScreen } from './ui/layout.js';
 import { checkAndMaybeUpdate } from './updater/index.js';
 // 终端恢复兜底:任一退出 / 中断 / 未捕获异常路径都要恢复 alt screen,避免残留备用屏 + 滚动区域。
 // exitAltScreen 幂等(未激活时空操作),故全局注册安全——进 alt screen 前的路径(如 --resume 列表、缺环境变量、`mocode config`)调用它无副作用。
-// 仅 layout 是叶子(不依赖 config),故静态导入安全;repl / session 依赖 config(requireEnv 缺项即退出),改动态按需加载——`mocode config` 才能在零配置下跑。
+// 仅 layout 是叶子(不依赖 config),故静态导入安全;repl / session 依赖 config(模块加载触发 loadEnvFiles + config 单例初始化),
+// 改动态按需加载——`mocode config` 向导只需读写文件(走 config/file.ts 叶子),不经 config 单例初始化,零配置也能跑。
 process.on('exit', () => exitAltScreen());
 process.on('SIGINT', () => {
     exitAltScreen();

package/dist/llm/index.js

@@ -2,10 +2,22 @@ import OpenAI from 'openai';
 import { config } from '../config/index.js';
 import { tools } from '../tools/registry.js';
 import { PLAN_DISABLED_TOOLS } from '../tools/constants.js';
-const client = new OpenAI({
+let client = new OpenAI({
     baseURL: config.baseURL,
     apiKey: config.apiKey,
 });
+/**
+ * 运行时重建 OpenAI 客户端(/model 切换 baseURL/apiKey 后调)。
+ * config.model 已在 chat() 每次读取(热切),但 client 的 baseURL/apiKey 是构造时固化的实例字段,
+ * 改 config 后必须重建 client 才能让新 baseURL/apiKey 对后续请求生效。
+ * 子 agent 复用本模块 chat(),故只此一处重建即全链路生效。
+ */
+export function reconfigureClient() {
+    client = new OpenAI({
+        baseURL: config.baseURL,
+        apiKey: config.apiKey,
+    });
+}
 /** 把内部工具定义转成 OpenAI 的 tool 格式 */
 export const chatTools = tools.map((t) => ({
     type: 'function',

package/dist/repl/index.js

@@ -1,8 +1,8 @@
 import readline from 'node:readline/promises';
 import { emitKeypressEvents } from 'node:readline';
 import { stdin, stdout } from 'node:process';
-import { config, PLAN_MODE_SUFFIX } from '../config/index.js';
-import { updateConfigKey } from '../config/file.js';
+import { config, PLAN_MODE_SUFFIX, updateModelConfig, isModelConfigured } from '../config/index.js';
+import { updateConfigKey, writeConfigKeys, CONFIG_PATH } from '../config/file.js';
 import { runAgent } from '../agent/index.js';
 import { getAgentMode, setAgentMode, onModeChange } from '../agent/mode.js';
 import { setSandboxRoot } from '../sandbox/root.js';
@@ -13,7 +13,7 @@ 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, } from '../llm/index.js';
+import { estimateMessagesTokens, reconfigureClient, } from '../llm/index.js';
 import { compactHistory, contextState, newSessionId, saveSession, loadSession, listSessions, } from '../session/index.js';
 import { listTurns, planRollback, applyRollback, persistSnapshots, loadSnapshots, rebuildFromHistory, resetState, } from '../rollback/index.js';
 import { listSkills, effectiveSystemPrompt } from '../skills/index.js';
@@ -36,6 +36,7 @@ const SLASH_COMMANDS = [
     { name: '/reflect', desc: '手动触发后台记忆反思 pass' },
     { name: '/init', desc: '扫描项目生成 MOCODE.md 项目记忆' },
     { name: '/theme', desc: '切换颜色主题(↑↓·Enter)' },
+    { name: '/model', desc: '配置大模型(baseURL/key/model/窗口)' },
     { name: '/plan', desc: '切到 plan 模式(只读探查+产出计划)' },
     { name: '/auto', desc: '切回 auto 模式(全工具执行)' },
 ];
@@ -47,6 +48,23 @@ const THEME_DESCRIPTIONS = {
     gruvbox: 'Gruvbox 暖色',
     nord: 'Nord 冷色',
 };
+/** /model 预设后端:选一个预填 baseURL,仍可逐项改。base_url 取自 README 常见表。 */
+const MODEL_PRESETS = [
+    { label: 'GLM(智谱)', baseURL: 'https://open.bigmodel.cn/api/v3', model: 'glm-4.6', window: 128000 },
+    { label: 'DeepSeek', baseURL: 'https://api.deepseek.com', model: 'deepseek-chat', window: 64000 },
+    { label: 'Qwen(阿里)', baseURL: 'https://dashscope.aliyuncs.com/compatible-mode/v1', model: 'qwen-plus', window: 128000 },
+    { label: '本地 Ollama', baseURL: 'http://localhost:11434/v1', model: 'qwen2.5:7b', window: 32768 },
+    { label: '本地 vLLM', baseURL: 'http://localhost:8000/v1', model: 'default', window: 32768 },
+    { label: '自定义 base_url', baseURL: '', model: '', window: 128000 },
+];
+/** apiKey 脱敏:只露末 4 位,前面打星号(显示用,绝不把明文 key 写进内容区)。 */
+function maskKey(k) {
+    if (!k)
+        return '(未设置)';
+    if (k.length <= 8)
+        return '****';
+    return `${'='.repeat(Math.min(k.length - 4, 20))}${k.slice(-4)}`;
+}
 /**
  * /init 指令:发给 agent 扫描项目并生成 MOCODE.md(对标 Claude Code /init 生成 CLAUDE.md,
  * 但 mocode 读 MOCODE.md)。已存在则让 agent 读后更新(不丢失事实)。写完供 memory 子系统下轮加载。
@@ -144,6 +162,8 @@ function runningStateFor(cmd) {
             return { status: '清空', placeholder: '…' };
         case '/theme':
             return { status: '切主题', placeholder: '选择主题…' };
+        case '/model':
+            return { status: '配模型', placeholder: '配置中…' };
         default:
             // 输入框留空(运行中可 typeahead 打字,dim 回显);运行状态由内联 spinner 承载(思考中/执行…),
             // 状态行只显走时——故常态 status 留空,不塞「处理」这种与内联重复的泛标签。
@@ -396,6 +416,10 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null,
         // 自更新提示:开场静态段(进 INPUT 态前),dim 一行,不与流式 / 输入争用。
         layout.contentWrite(`  ${ui.gray}↳ ${updateNotice}${ui.reset}\n`);
     }
+    if (!isModelConfigured()) {
+        // 未配置 baseURL/apiKey:醒目提示引导 /model(不退出,REPL 仍可用;发消息会失败但不崩)。
+        layout.contentWrite(`${ui.yellow}  ⚠ 未配置大模型。输入 ${ui.cyan}/model${ui.yellow} 配置 baseURL / apiKey / model(即时生效),或退出后运行 ${ui.cyan}mocode config${ui.yellow} 走向导。${ui.reset}\n`);
+    }
     layout.contentWrite(`${ui.dim}  /plan · /auto · Shift+Tab 切换模式(plan:只读探查 + 产出计划,审批后切 auto 执行)${ui.reset}\n`);
     /**
      * 切换 agent 模式(Shift+Tab 触发,经 prompt.ts 的 onCycleMode 回调)。
@@ -772,6 +796,179 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null,
             }
             continue;
         }
+        if (line === '/model' || line.startsWith('/model ')) {
+            // /model:运行时配置大模型(baseURL/apiKey/model/contextWindowTokens)。
+            // 即时生效(updateModelConfig 改内存 + env,reconfigureClient 重建 OpenAI 实例)+ 持久化(writeConfigKeys 写 ~/.mocode/config)。
+            // 仿 /theme:promptIntervention 弹菜单/输入 → 改 config → refreshStatusBase 刷底栏 → clearContent+banner 重显横幅 → dim 警告(shell env 覆盖)。
+            const arg = line.startsWith('/model ') ? line.slice('/model '.length).trim() : '';
+            // /model list:显示当前四项配置(apiKey 脱敏)。
+            if (arg === 'list' || 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.dim}(配置文件: ${CONFIG_PATH})${ui.reset}\n`);
+                continue;
+            }
+            // 1) 选 provider 预设(预填 baseURL,后续仍可逐项改)。
+            let preset;
+            try {
+                const res = await promptIntervention({
+                    type: 'choice',
+                    title: '选择后端预设(预填 baseURL,后续可改)',
+                    detail: '选一个会预填 baseURL/model/窗口,之后逐项确认。选「自定义」全部手填。',
+                    options: MODEL_PRESETS.map((p) => p.label),
+                });
+                if (res.action === 'cancelled') {
+                    continue;
+                }
+                const idx = MODEL_PRESETS.findIndex((p) => p.label === res.value);
+                if (idx === -1) {
+                    continue;
+                }
+                preset = MODEL_PRESETS[idx];
+            }
+            catch {
+                continue; // Ctrl+C
+            }
+            // 1.5) 一键应用确认:非「自定义」预设(带预填值)给直接应用入口,免连按 4 次回车。
+            //      直接应用 = 用预设 model/baseURL/window + 保留当前 apiKey(等价于下方逐项链连按回车)。
+            //      逐项修改 / 自定义输入(promptIntervention choice 自动追加的「其他」项 submitted)→ 回落 4 步链。
+            //      「自定义」预设字段空,跳过确认直接进链。
+            let quickApply = false;
+            if (preset.model || preset.baseURL) {
+                try {
+                    const res = await promptIntervention({
+                        type: 'choice',
+                        title: `应用 ${preset.label}?`,
+                        detail: `model   ${preset.model}\nbaseURL ${preset.baseURL}\napiKey  ${maskKey(config.apiKey)}(直接应用=保留当前)\n窗口    ${preset.window}`,
+                        options: ['直接应用', '逐项修改'],
+                    });
+                    if (res.action === 'cancelled') {
+                        continue;
+                    }
+                    if (res.action === 'selected' && res.value === '直接应用') {
+                        quickApply = true;
+                    }
+                    // 其余(逐项修改 / 自定义输入 submitted)→ quickApply 保持 false,走下方逐项链
+                }
+                catch {
+                    continue; // Ctrl+C
+                }
+            }
+            // 2) 收集 baseURL / apiKey / model / contextWindowTokens。
+            //    quickApply:直接取预设值 + 当前 apiKey;否则逐项 input(预填 preset 值,回车=采纳;apiKey 不预填明文,回车=保留旧值)。
+            let baseURL;
+            let apiKey;
+            let model;
+            let window;
+            if (quickApply) {
+                baseURL = preset.baseURL;
+                apiKey = config.apiKey;
+                model = preset.model;
+                window = preset.window;
+            }
+            else {
+                // baseURL
+                {
+                    const res = await promptIntervention({
+                        type: 'input',
+                        title: 'LLM_BASE_URL',
+                        detail: 'OpenAI 兼容 API 端点。回车采纳预填值。',
+                        seed: preset.baseURL || config.baseURL,
+                    });
+                    if (res.action === 'cancelled') {
+                        continue;
+                    }
+                    baseURL = (res.value ?? '').trim() || preset.baseURL || config.baseURL;
+                }
+                if (!baseURL) {
+                    layout.contentWrite(`${ui.yellow}baseURL 不能为空,已取消。${ui.reset}\n`);
+                    continue;
+                }
+                // apiKey(不预填明文:回车=保留旧值,输入新值=覆盖)
+                {
+                    const res = await promptIntervention({
+                        type: 'input',
+                        title: 'LLM_API_KEY',
+                        detail: `回车保留当前 ${maskKey(config.apiKey)};输入新值则覆盖。`,
+                        seed: '',
+                    });
+                    if (res.action === 'cancelled') {
+                        continue;
+                    }
+                    const v = (res.value ?? '').trim();
+                    apiKey = v || config.apiKey;
+                }
+                if (!apiKey) {
+                    layout.contentWrite(`${ui.yellow}apiKey 不能为空,已取消。${ui.reset}\n`);
+                    continue;
+                }
+                // model
+                {
+                    const res = await promptIntervention({
+                        type: 'input',
+                        title: 'LLM_MODEL',
+                        detail: '模型名(须支持 function calling)。回车采纳预填值。',
+                        seed: preset.model || config.model,
+                    });
+                    if (res.action === 'cancelled') {
+                        continue;
+                    }
+                    model = (res.value ?? '').trim() || preset.model || config.model;
+                }
+                if (!model) {
+                    layout.contentWrite(`${ui.yellow}model 不能为空,已取消。${ui.reset}\n`);
+                    continue;
+                }
+                // contextWindowTokens
+                {
+                    const res = await promptIntervention({
+                        type: 'input',
+                        title: 'CONTEXT_WINDOW_TOKENS',
+                        detail: '模型上下文窗口(须对齐真实模型;GLM≈128k,DeepSeek-V3≈64k)。回车采纳预填值。',
+                        seed: String(preset.window || config.contextWindowTokens),
+                    });
+                    if (res.action === 'cancelled') {
+                        continue;
+                    }
+                    const v = (res.value ?? '').trim();
+                    const n = Number(v);
+                    if (!v || !Number.isFinite(n) || n <= 0) {
+                        // 非法输入:保留旧值,不阻断(用 preset.window 或当前值兜底)
+                        window = preset.window || config.contextWindowTokens;
+                    }
+                    else {
+                        window = Math.floor(n);
+                    }
+                }
+            }
+            // 3) 应用:内存 config + env(updateModelConfig)→ 持久化(writeConfigKeys)→ 重建 client(reconfigureClient)。
+            updateModelConfig({ model, baseURL, apiKey, contextWindowTokens: window });
+            writeConfigKeys({
+                LLM_BASE_URL: baseURL,
+                LLM_API_KEY: apiKey,
+                LLM_MODEL: model,
+                CONTEXT_WINDOW_TOKENS: String(window),
+            });
+            reconfigureClient();
+            // 4) 刷新 UI:底栏模型名 + 重显横幅(banner() 闭包实时读 config,自动反映新值)。
+            refreshStatusBase(history);
+            layout.clearContent();
+            if (history.some((m) => m.role === 'user')) {
+                renderHistory(history);
+            }
+            else {
+                layout.contentWrite(bannerString(banner()));
+            }
+            layout.contentWrite(`${ui.dim}(已切换模型 → ${model} @ ${baseURL})${ui.reset}\n`);
+            // 5) dim 警告:shell export 的 LLM 键下次启动会覆盖文件值。
+            if (config.llmKeysFromShell.length > 0) {
+                layout.contentWrite(`${ui.dim}(shell 环境变量已设 ${config.llmKeysFromShell.join(' / ')},文件写入下次启动被其覆盖;取消该 shell 设置后生效)${ui.reset}\n`);
+            }
+            continue;
+        }
         if (line === '/rollback' || line.startsWith('/rollback ')) {
             // /rollback:打开轮次菜单(↑/↓ 选,Enter 回滚到该轮并预填其输入,再 Enter 重新跑)。
             // 忽略任何数字参数(原「输数字选回滚」已删,统一走菜单)。无快照的旧轮次(/resume 重建)文件改动不可撤销。

package/dist/session/drop.js

@@ -0,0 +1,135 @@
+// 运行中上下文剔除(drop_context 工具的核心):把历史里无关的 tool 结果替换为存根。
+//
+// 与 compact 的区别:compact 是阈值触发的整体压缩(微截 + 摘要),drop_context 是 agent 主动、
+// 精准剔除"已判定无关"的具体 tool 结果——agent 检索到大量无关信息后主动调用,释放上下文。
+//
+// 不变量(对齐 compact.ts):
+//  - 永不动 history[0](system prompt)。
+//  - 永不动当前轮:从末尾向前找到最后一个 user 消息,该 user 及其之后的 tool 结果一律保留
+//    (agent 本轮还在用,踢了会丢失正在进行的上下文)。
+//  - tool_call_id 配对:只改 tool 消息的 content,不删消息、不动 tool_calls 数组结构、不改 id。
+//  - 原地修改 history(同 compact:length=0;push 重建,repl 持有同一引用)。
+//  - 永不抛错(对齐「调度器永不抛错」契约);无匹配 / 无可剔除 → 返 dropped=0。
+import { messageTokens, estimateTokens, } from '../llm/index.js';
+/** 把消息 content 拍平成字符串(OpenAI 可能 string / null / 多模态数组)。 */
+function toText(content) {
+    if (content == null)
+        return '';
+    if (typeof content === 'string')
+        return content;
+    try {
+        return JSON.stringify(content);
+    }
+    catch {
+        return String(content);
+    }
+}
+/**
+ * 从 history 末尾向前找最后一个 user 消息的索引;无 user 返 -1。
+ * 用于划定"当前轮保护区"——该 user 及其之后的消息一律不剔除。
+ */
+function lastUserIndex(history) {
+    for (let i = history.length - 1; i >= 1; i--) {
+        if (history[i].role === 'user')
+            return i;
+    }
+    return -1;
+}
+/** 取 tool 消息对应的工具名(从紧邻的前导 assistant.tool_calls 按 tool_call_id 配对找)。 */
+function toolNameOf(history, idx) {
+    const tcId = history[idx].tool_call_id;
+    if (!tcId)
+        return null;
+    for (let j = idx - 1; j >= 1; j--) {
+        const m = history[j];
+        if (m.role !== 'assistant')
+            continue;
+        const tcs = m
+            .tool_calls;
+        if (!tcs)
+            continue;
+        const hit = tcs.find((tc) => tc?.id === tcId);
+        if (hit)
+            return hit.function?.name ?? null;
+    }
+    return null;
+}
+/**
+ * 剔除历史里命中的旧 tool 结果(原地修改 history)。
+ *
+ * 筛选(各维度 AND 组合):
+ *  - toolNames:只剔除这些工具名的结果(空 = 不限)
+ *  - contains:只剔除内容包含所有这些词(AND、大小写不敏感)的结果(空 = 不限)
+ *
+ * 保护:history[0](system)+ 当前轮(最后一个 user 及其之后)永不剔除。
+ * 已是存根的 tool 消息(含「已剔除」标记)不重复剔除(幂等)。
+ *
+ * 永不抛错;无匹配返 dropped=0。
+ */
+export function dropContextFromHistory(history, filter) {
+    const toolNames = filter.toolNames && filter.toolNames.length > 0
+        ? new Set(filter.toolNames)
+        : null;
+    const contains = filter.contains && filter.contains.length > 0
+        ? filter.contains.map((s) => s.toLowerCase())
+        : null;
+    // 当前轮保护区:最后一个 user 及其之后一律保留(agent 还在用)。
+    const guard = lastUserIndex(history);
+    // guard <= 0 表示无 user 或 user 就是 history[0](不会):整段历史都可剔除(除 history[0])。
+    const protectedFrom = guard > 0 ? guard : 0; // < protectedFrom 的才可剔除(即 [1, protectedFrom)
+    const items = [];
+    let freedTokens = 0;
+    const STUB_PREFIX = '⌦[已剔除:与当前任务无关]';
+    for (let i = 1; i < protectedFrom; i++) {
+        const m = history[i];
+        if (m.role !== 'tool')
+            continue;
+        const content = toText(m.content);
+        // 幂等:已是存根(含标记)不重复剔除。
+        if (content.startsWith(STUB_PREFIX))
+            continue;
+        // 维度 1:工具名
+        const tname = toolNameOf(history, i);
+        if (toolNames && (!tname || !toolNames.has(tname)))
+            continue;
+        // 维度 2:内容关键词(AND)
+        if (contains) {
+            const lower = content.toLowerCase();
+            if (!contains.every((kw) => lower.includes(kw)))
+                continue;
+        }
+        // 命中 → 替换为存根(保 tool_call_id 不动,只改 content)
+        const before = messageTokens(m);
+        const id = m.tool_call_id ?? '';
+        const stub = `${STUB_PREFIX} 原 ${tname ?? 'tool'} 结果(${content.length} 字符,约 ${before} tokens)${id ? ` · id …${id.slice(-6)}` : ''}⌫`;
+        m.content = stub;
+        const after = messageTokens(m);
+        freedTokens += Math.max(0, before - after);
+        items.push({
+            toolName: tname ?? 'tool',
+            toolCallId: id.slice(-6),
+        });
+    }
+    return {
+        dropped: items.length,
+        freedTokens,
+        items,
+    };
+}
+/** 给 drop_context 工具结果格式化人类可读摘要(回灌给 agent)。 */
+export function formatDropResult(r) {
+    if (r.dropped === 0) {
+        return '未剔除任何工具结果(无匹配的旧 tool 消息,或均在当前轮保护区内不可剔除)。';
+    }
+    const lines = [
+        `已剔除 ${r.dropped} 条无关工具结果,释放约 ${r.freedTokens} tokens。`,
+        '被剔除项(已替换为存根,tool_call_id 配对不变):',
+    ];
+    for (const it of r.items) {
+        lines.push(`  - ${it.toolName} (id …${it.toolCallId})`);
+    }
+    lines.push('这些结果在后续上下文中仅保留存根标记,不再占用篇幅。');
+    return lines.join('\n');
+}
+// 供 drop_context 工具估算用(避免直接 import llm 的公开 API 造成耦合,这里重导出)。
+export { estimateTokens };

package/dist/session/index.js

@@ -5,4 +5,5 @@
  * 依赖方向:session → {llm(摘要复用 chat), config, ui};llm 不反向依赖 session。
  */
 export { compactHistory, maybeCompact, capToolResultForHistory, truncateMid, contextState, } from './compact.js';
+export { dropContextFromHistory, formatDropResult, } from './drop.js';
 export { newSessionId, saveSession, loadSession, listSessions, sessionDir, } from './persist.js';

package/dist/tools/builtins/ask-human.js

@@ -3,10 +3,10 @@ import { promptIntervention } from '../../ui/intervention.js';
 export const askHumanTool = {
     name: 'ask_human',
     description: [
-        'Call this tool when you hit a decision point during a task that requires human input — it pops up a question panel in the terminal for the user to choose.',
-        'Use when: multiple implementation approaches need a user decision, user intent is unclear and needs clarification, or extra info is needed to proceed.',
-        'Blocks until the user responds; the user can pick a preset option or choose "custom input" to answer freely; the result is returned as the tool result.',
-        'Do not call frequently when the task is clear and you can decide yourself — it interrupts the user. When options is omitted or empty, it becomes free-text input instead.',
+        'Ask the user for input at a decision point (blocks until they respond).',
+        ' Use when: multiple approaches need a user decision, intent is unclear, or extra info is needed.',
+        ' Don\'t call when the task is clear and you can decide — it interrupts the user.',
+        ' Options (2-6) let the user pick; omit/empty for free-text input. Their answer is returned as the result.',
     ].join(''),
     parameters: {
         type: 'object',

package/dist/tools/builtins/codegraph.js

@@ -50,9 +50,9 @@ function runCodegraph(args) {
 }
 export const codegraphTool = {
     name: 'codegraph',
-    description: 'Preferred tool for understanding/locating code, tracing call chains, and assessing the impact of changes in repos with a code index (.codegraph/).' +
-        ' Returns relevant symbol source + call paths in one shot — more accurate and economical than piecing together via read_file/grep.' +
-        ' Returns a hint when .codegraph/ is absent (build it first with `codegraph init`).',
+    description: 'Preferred for understanding/locating code, tracing call chains, assessing impact of changes in repos with a code index (.codegraph/).' +
+        ' Returns symbol source + call paths in one shot — more accurate/economical than read_file/grep.' +
+        ' Hints to run `codegraph init` when .codegraph/ is absent.',
     parameters: {
         type: 'object',
         properties: {

package/dist/tools/builtins/drop-context.js

@@ -0,0 +1,68 @@
+// ---------- drop_context ----------
+/**
+ * 运行中上下文剔除工具:agent 检索到大量无关信息后,主动把历史里无关的 tool 结果替换为存根,
+ * 释放上下文空间(保 tool_call_id 配对不变量,只改 content)。
+ *
+ * 与 compact 的区别:compact 是阈值触发的整体压缩(微截 + 摘要);drop_context 是 agent 主动、
+ * 精准剔除"已判定无关"的具体 tool 结果。
+ *
+ * 保护:history[0](system)与当前轮(最后一个 user 及其之后)永不剔除——agent 还在用。
+ * 已是存根的不重复剔除(幂等)。永不抛错。
+ *
+ * 筛选(各维度 AND 组合,全部可选;不传 = 剔除所有可剔除的旧 tool 结果):
+ *  - toolNames:只剔除这些工具名的结果(如 ["grep","read_file"])
+ *  - contains:只剔除内容包含所有这些词(AND、大小写不敏感)的结果
+ *
+ * plan 模式不禁用:纯上下文管理,无文件 / 命令副作用。
+ */
+export const dropContextTool = {
+    name: 'drop_context',
+    description: [
+        'Drop (stub-replace) irrelevant OLDER tool results from history to free context.',
+        'COST-AWARE: ~300-token round-trip; only call if freed tokens clearly exceed it — i.e. MULTIPLE bulky results (e.g. a wide grep/read sweep of mostly-irrelevant hits), not a single small one or near done.',
+        'Never dropped: system prompt and the CURRENT turn (last user message onward). Idempotent. Filters AND-combine; omit both = drop all droppable. Returns dropped count, freed tokens, tool names.',
+    ].join(' '),
+    parameters: {
+        type: 'object',
+        properties: {
+            toolNames: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Only drop results from these tool names (e.g. ["grep","read_file"]). Empty/omitted = no tool-name filter.',
+            },
+            contains: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Only drop results whose content contains ALL of these keywords (AND, case-insensitive). Empty/omitted = no content filter.',
+            },
+        },
+        required: [],
+    },
+    async execute(args, ctx) {
+        const dropContext = ctx?.dropContext;
+        if (!dropContext) {
+            // 无注入(理论上不会:runAgentCore 总注入)。降级:不改 history,告知 agent。
+            return '错误:上下文剔除回调不可用(未由 agent 循环注入),无法剔除。';
+        }
+        const filter = {};
+        if (Array.isArray(args.toolNames)) {
+            filter.toolNames = args.toolNames
+                .filter((v) => typeof v === 'string' && v.length > 0)
+                .map((v) => String(v));
+        }
+        if (Array.isArray(args.contains)) {
+            filter.contains = args.contains
+                .filter((v) => typeof v === 'string' && v.length > 0)
+                .map((v) => String(v));
+        }
+        const result = dropContext(filter);
+        return result.dropped === 0
+            ? '未剔除任何工具结果(无匹配的旧 tool 消息,或均在当前轮保护区内不可剔除)。'
+            : [
+                `已剔除 ${result.dropped} 条无关工具结果,释放约 ${result.freedTokens} tokens。`,
+                '被剔除项(已替换为存根,tool_call_id 配对不变):',
+                ...result.items.map((it) => `  - ${it.toolName} (id …${it.toolCallId})`),
+                '这些结果在后续上下文中仅保留存根标记,不再占用篇幅。',
+            ].join('\n');
+    },
+};

package/dist/tools/builtins/edit-file.js

@@ -3,7 +3,7 @@ import { resolve } from 'node:path';
 // ---------- edit_file ----------
 export const editFileTool = {
     name: 'edit_file',
-    description: 'Make a precise string replacement in a file. old_string must occur exactly once in the file and match exactly (including indentation/newlines). Use write_file for new files.',
+    description: 'Replace a string in a file. old_string must occur exactly once and match exactly (including indentation/newlines). Use write_file for new files.',
     parameters: {
         type: 'object',
         properties: {

package/dist/tools/builtins/glob.js

@@ -4,8 +4,8 @@ import { getSandboxRoot, isInsideRoot } from '../../sandbox/index.js';
 // ---------- glob ----------
 export const globTool = {
     name: 'glob',
-    description: 'Find file paths matching a glob pattern (e.g. **/*.ts). Returns a list of matches (auto-excludes node_modules / .git).' +
-        ' Note: when understanding code architecture/call chains, if a .codegraph/ index exists, prefer the codegraph tool over piecing together via glob one file at a time.',
+    description: 'Find files matching a glob pattern (e.g. **/*.ts). Auto-excludes node_modules/.git.' +
+        ' For architecture/call chains, prefer codegraph.',
     parameters: {
         type: 'object',
         properties: {

package/dist/tools/builtins/grep.js

@@ -5,8 +5,8 @@ import { getSandboxRoot, isInsideRoot, jailResolve } from '../../sandbox/index.j
 // ---------- grep ----------
 export const grepTool = {
     name: 'grep',
-    description: 'Search file contents by regex, returning file:line: matched lines. Recursively searches the current directory by default (excluding node_modules/.git). Optional glob to restrict file types.' +
-        ' Note: when understanding code architecture/call chains, if a .codegraph/ index exists, prefer the codegraph tool over piecing together via grep one file at a time.',
+    description: 'Search file contents by regex, returning file:line: matched lines. Recursively searches cwd excluding node_modules/.git. Optional glob restricts file types.' +
+        ' For architecture/call chains, prefer codegraph.',
     parameters: {
         type: 'object',
         properties: {

package/dist/tools/builtins/index.js

@@ -10,6 +10,7 @@ import { useSkillTool } from './use-skill.js';
 import { askHumanTool } from './ask-human.js';
 import { codegraphTool } from './codegraph.js';
 import { switchModeTool } from './switch-mode.js';
+import { dropContextTool } from './drop-context.js';
 import { memorySaveTool } from './memory-save.js';
 import { memorySearchTool } from './memory-search.js';
 import { memoryListTool } from './memory-list.js';
@@ -33,6 +34,7 @@ export const builtinTools = [
     useSkillTool,
     askHumanTool,
     switchModeTool, // plan↔auto 自切(两模式都可见,不进 PLAN_DISABLED_TOOLS;副作用控制工具→串行分支)
+    dropContextTool, // 运行中剔除无关 tool 结果(上下文管理,无副作用;两模式都可见,串行分支)
     memorySaveTool,
     memorySearchTool,
     memoryListTool,

package/dist/tools/builtins/memory-forget.js

@@ -3,7 +3,7 @@ import { forgetEntry } from '../../memory/store.js';
 // 遗忘:默认归档(archived,从索引/默认搜索隐藏,可复活);mode=delete 硬删。pinned 拒删。
 export const memoryForgetTool = {
     name: 'memory_forget',
-    description: 'Forget a memory entry: by default archives (archived, hidden from index and default search, can be revived via memory_update); mode=delete hard-deletes. Pinned entries cannot be deleted (first memory_update pinned=false to unpin).',
+    description: 'Forget a memory entry: default archive (hidden, revivable via memory_update); mode=delete hard-deletes. Pinned entries can\'t be deleted (unpin first).',
     parameters: {
         type: 'object',
         properties: {

package/dist/tools/builtins/memory-list.js

@@ -3,7 +3,7 @@ import { listEntries } from '../../memory/store.js';
 // 列索引(id/name/summary,无正文、不 bump recall)。用于浏览有哪些、拿 id 再 memory_search 取正文。
 export const memoryListTool = {
     name: 'memory_list',
-    description: 'List the memory index (id/name/summary, no body). Defaults to active. Get an id, then use memory_search to retrieve the full body.',
+    description: 'List the memory index (id/name/summary, no body). Get an id, then use memory_search for the full body.',
     parameters: {
         type: 'object',
         properties: {

package/dist/tools/builtins/memory-save.js

@@ -4,7 +4,7 @@ import { saveEntry } from '../../memory/store.js';
 // 撞库(name→id 已存在)拒绝,引导用 memory_update。
 export const memorySaveTool = {
     name: 'memory_save',
-    description: 'Save a long-term memory entry (cross-session). Store only non-obvious, long-term-useful facts/decisions/pitfalls. The title goes into the startup index; retrieve full body on demand via memory_search.',
+    description: 'Save a cross-session long-term memory entry. Store only non-obvious, useful facts/decisions/pitfalls. Title enters the startup index; retrieve body via memory_search.',
     parameters: {
         type: 'object',
         properties: {

package/dist/tools/builtins/memory-search.js

@@ -4,7 +4,7 @@ import { searchEntries } from '../../memory/store.js';
 // 结果走 capToolResultForHistory 的放宽上限(同 use_skill,保正文完整)。
 export const memorySearchTool = {
     name: 'memory_search',
-    description: 'Search memory entries by keyword (multi-word substring match, ranked by relevance), returning full body of matching entries. A hit bumps recall count (affects forgetting decay).',
+    description: 'Search memory entries by keyword (substring match), returning full body.',
     parameters: {
         type: 'object',
         properties: {

package/dist/tools/builtins/memory-update.js

@@ -3,7 +3,7 @@ import { updateEntry } from '../../memory/store.js';
 // 原地改一条记忆(id 不变)。反思的弱意义:干活时发现事实变了/过时即纠正。
 export const memoryUpdateTool = {
     name: 'memory_update',
-    description: 'Update a memory entry in place (id unchanged). Use when facts changed / correcting outdated info / updating summary or body / toggling pinned. Get id from memory_list or memory_search.',
+    description: 'Update a memory entry in place (id unchanged). Use when facts changed / correcting outdated info / toggling pinned. Get id from memory_list or memory_search.',
     parameters: {
         type: 'object',
         properties: {

package/dist/tools/builtins/read-file.js

@@ -4,8 +4,8 @@ import { MAX_FILE_LINES } from '../constants.js';
 // ---------- read_file ----------
 export const readFileTool = {
     name: 'read_file',
-    description: 'Read file content, returning text with line numbers. Read before editing code. Optional offset (start line, 1-based, default 1) and limit (number of lines, default 2000).' +
-        ' Note: when understanding code architecture/call chains, if a .codegraph/ index exists, prefer the codegraph tool over piecing together via read_file one file at a time.',
+    description: 'Read file content with line numbers. Read before editing. offset (1-based, default 1), limit (default 2000).' +
+        ' For architecture/call chains, prefer codegraph over reading files one at a time.',
     parameters: {
         type: 'object',
         properties: {

package/dist/tools/builtins/run-command.js

@@ -4,7 +4,7 @@ import { getSandboxRoot, filterEnv, isCommandDenied } from '../../sandbox/index.
 // ---------- run_command ----------
 export const runCommandTool = {
     name: 'run_command',
-    description: 'Execute a shell command, returning combined stdout+stderr. Default timeout 120s. Use for running tests, builds, git, etc.',
+    description: 'Run a shell command, merging stdout+stderr. Default timeout 120s. For tests, builds, git, etc.',
     parameters: {
         type: 'object',
         properties: {

package/dist/tools/builtins/switch-mode.js

@@ -3,11 +3,9 @@ import { setAgentMode, getAgentMode } from '../../agent/mode.js';
 export const switchModeTool = {
     name: 'switch_mode',
     description: [
-        'Switch the agent mode between "plan" (read-only investigation + planning) and "auto" (full tool execution).',
-        'In plan mode, write_file / edit_file / run_command / memory_save / memory_update / memory_forget are disabled; in auto mode, all tools are available.',
-        'Use this to autonomously transition from planning to execution WITHIN THE SAME TURN: investigate in plan mode, produce a plan, then call switch_mode("auto") and continue implementing it in the same turn — ONLY when the user has explicitly asked you to "plan first then execute" / "先 plan 再 auto" / autonomous execution.',
-        'Do NOT switch to auto if the user entered plan mode manually (via /plan or Shift+Tab) for a safety review — in that case present the plan and STOP; the user will approve via a prompt and execution happens in a follow-up turn.',
-        'Switching to plan from auto is rarely needed; do it only if you realize you should investigate before changing anything.',
+        'Switch agent mode between "plan" (read-only investigation) and "auto" (full tool execution).',
+        'Use to transition from planning to execution WITHIN THE SAME TURN: in plan, after presenting a plan, call switch_mode("auto") and continue — ONLY when the user asked for autonomous execution ("先 plan 再 auto" etc.).',
+        'If the user entered plan mode manually (/plan or Shift+Tab) for review, do NOT switch to auto — present the plan and STOP for approval.',
     ].join(' '),
     parameters: {
         type: 'object',

package/dist/tools/builtins/task.js

@@ -9,10 +9,9 @@ import { MAX_OUTPUT } from '../constants.js';
 export const taskTool = {
     name: 'task',
     description: [
-        'Spawn a sub-agent to handle an isolated sub-task with its own conversation history (independent of the main thread). The sub-agent runs to completion and returns a concise summary.',
-        'Use when: a task can be decomposed into independent sub-tasks, you want to explore multiple files/areas without polluting the main history, or a sub-task involves many tool calls that would bloat the main context window.',
-        'The sub-agent has its own history; only its final summary is returned to you as the tool result. It cannot recursively spawn further sub-agents (no "task" tool available to it).',
-        'Optionally restrict the sub-agent to a subset of tools (e.g. read-only tools for pure investigation) via the "tools" parameter.',
+        'Spawn a sub-agent for an isolated sub-task (independent history; only its final summary returns to you).',
+        'Use when a task splits into independent parts or its many tool calls would bloat your context.',
+        'Cannot recursively spawn sub-agents.',
     ].join(''),
     parameters: {
         type: 'object',
@@ -24,7 +23,7 @@ export const taskTool = {
             tools: {
                 type: 'array',
                 items: { type: 'string' },
-                description: 'Optional whitelist of tool names the sub-agent is allowed to use (e.g. ["read_file","glob","grep","codegraph"] for read-only investigation). Omit to allow all tools.',
+                description: 'Optional whitelist of tool names the sub-agent is allowed to use (e.g. ["read_file","glob","grep","codegraph"] for read-only investigation). Omit to allow all tools. If the sub-task needs verification/build/test (running scripts, typecheck, etc.), remember to include "run_command".',
             },
             maxSteps: {
                 type: 'number',

package/dist/tools/builtins/use-skill.js

@@ -4,7 +4,7 @@ import { getSkillBody } from '../../skills/index.js';
 // 系统提示里已列出可用 skill 的 name + description(何时用),模型据此决定调用。
 export const useSkillTool = {
     name: 'use_skill',
-    description: 'Load and return the full SKILL.md instructions for a given skill (pass name). See the skill list in the system prompt for when to use each.',
+    description: 'Load the full SKILL.md instructions for a given skill. See the skill list in the system prompt for when to use each.',
     parameters: {
         type: 'object',
         properties: {

package/dist/tools/builtins/web-fetch.js

@@ -4,7 +4,7 @@ const UA = 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML,
 // ---------- web_fetch ----------
 export const webFetchTool = {
     name: 'web_fetch',
-    description: 'Fetch the web page at a given URL and clean it into plain text (strips HTML tags/scripts/styles, keeps the body). Use to read a link from search results, or a specific URL given by the user.',
+    description: 'Fetch a URL and clean HTML to body text. Use to read a link from search results or a URL given by the user.',
     parameters: {
         type: 'object',
         properties: {

package/dist/tools/builtins/web-search.js

@@ -6,7 +6,7 @@ const MAX_CONTENT_CHARS = 800;
 // ---------- web_search ----------
 export const webSearchTool = {
     name: 'web_search',
-    description: 'Search the web (AnySearch). Returns title/url/snippet/body for each result. Optional tag to switch sub-domain capability (see tag param).',
+    description: 'Search the web (AnySearch). Returns title/url/snippet/body per result. Optional tag for sub-domain capability.',
     parameters: {
         type: 'object',
         properties: {

package/dist/tools/builtins/write-file.js

@@ -3,7 +3,7 @@ import { resolve, dirname } from 'node:path';
 // ---------- write_file ----------
 export const writeFileTool = {
     name: 'write_file',
-    description: 'Create or overwrite a file, creating parent directories as needed.',
+    description: 'Create or overwrite a file; parent dirs created.',
     parameters: {
         type: 'object',
         properties: {

package/dist/tools/registry.js

@@ -11,6 +11,7 @@ export const tools = builtinTools;
  * signal 透传给 tool.execute(经 ctx):长任务工具(run_command/web_fetch)abort 即时取消,
  * 让用户 Ctrl+C 能跟手中断工具执行(而非等命令跑完 / 超时)。
  * opts.skipRollback:子 agent 逻辑隔离用——跳过 recordMutation,子 agent 改动不进主回滚快照链。
+ * opts.dropContext:上下文剔除回调(drop_context 工具用),透传给 tool.execute 经 ctx。
  */
 export async function executeTool(name, argsRaw, signal, opts) {
     const tool = tools.find((t) => t.name === name);
@@ -38,7 +39,11 @@ export async function executeTool(name, argsRaw, signal, opts) {
             args.path) {
             recordMutation(args.path);
         }
-        return await tool.execute(args, { signal, skipRollback: opts?.skipRollback });
+        return await tool.execute(args, {
+            signal,
+            skipRollback: opts?.skipRollback,
+            dropContext: opts?.dropContext,
+        });
     }
     catch (e) {
         return `错误:工具 ${name} 执行失败: ${e instanceof Error ? e.message : String(e)}`;

package/package.json

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