mocode-ai 0.1.8 → 0.1.10

package/README.md

@@ -58,11 +58,13 @@ npm start
 mocode config
 ```
 
+也可直接 `mocode` 进入 REPL 后用 `/model` 命令配置(交互选后端预设 + 逐项填写,即时生效 + 持久化)。未配置时 REPL 仍能打开,会提示你跑 `/model`。
+
 也可手写配置文件。mocode 按以下优先级加载(后者覆盖前者,仅回填未设置的环境变量;shell 里 `export` 的永远最优先):
 
-1. `~/.mocode/config` — 全局(`mocode config` 写此文件)
-2. `<cwd>/.mocode/config` — 项目级覆盖
-3. `<cwd>/.env` — 旧用法兼容(源码仓库内有 `.env.example` 可参考)
+1. `<cwd>/.env` — 旧用法兼容,优先级最低(源码仓库内有 `.env.example` 可参考)
+2. `~/.mocode/config` — 全局(`/model` 与 `mocode config` 写此文件)
+3. `<cwd>/.mocode/config` — 项目级覆盖,优先级最高
 
 必填三项:
 
@@ -74,30 +76,35 @@ LLM_MODEL=glm-4.6                              # 换成你的模型名
 
 常见后端 `base_url`:
 
-| 后端 | base_url |
-|------|----------|
-| GLM(智谱) | `https://open.bigmodel.cn/api/v3` |
-| DeepSeek | `https://api.deepseek.com` |
-| Qwen(阿里) | `https://dashscope.aliyuncs.com/compatible-mode/v1` |
-| 本地 Ollama | `http://localhost:11434/v1` |
-| 本地 vLLM | `http://localhost:8000/v1` |
+| 后端        | base\_url                                           |
+| --------- | --------------------------------------------------- |
+| GLM(智谱)   | `https://open.bigmodel.cn/api/v3`                   |
+| DeepSeek  | `https://api.deepseek.com`                          |
+| Qwen(阿里)  | `https://dashscope.aliyuncs.com/compatible-mode/v1` |
+| 本地 Ollama | `http://localhost:11434/v1`                         |
+| 本地 vLLM   | `http://localhost:8000/v1`                          |
 
 > 模型必须支持 OpenAI 风格的 function calling,否则工具不会触发。
 
 ### 可选配置
 
-| 环境变量 | 说明 | 默认值 |
-|----------|------|--------|
-| `MAX_TOKENS` | 单次回复最大 token | 不限 |
-| `CONTEXT_WINDOW_TOKENS` | 模型上下文窗口,须对齐真实模型 | `128000` |
-| `COMPACT_THRESHOLD` | 自动压缩触发阈值(占窗口比例) | `0.85` |
-| `LLM_STREAM_USAGE` | 流式请求带 `stream_options.include_usage` 拿真实用量 | `true` |
-| `AUTO_COMPACT` | 自动压缩总开关 | `true` |
-| `AUTO_REFLECT` | 后台反思 pass 总开关(定期从会话挖掘记忆) | `true` |
-| `REFLECT_EVERY_N` | 每 N 轮触发一次后台反思(与 agent 并发,不阻塞) | `5` |
-| `ANYSEARCH_API_KEY` | 联网搜索 API key(不配走匿名免费额度) | 无 |
-| `ANYSEARCH_BASE_URL` | 搜索 API 端点 | `https://api.anysearch.com` |
-| `SKILLS_DIRS` | 覆盖默认 skill 扫描目录(平台分隔符) | 三目录自动扫描 |
+| 环境变量                    | 说明                                         | 默认值                         |
+| ----------------------- | ------------------------------------------ | --------------------------- |
+| `MAX_TOKENS`            | 单次回复最大 token                               | 不限                          |
+| `CONTEXT_WINDOW_TOKENS` | 模型上下文窗口,须对齐真实模型                            | `128000`                    |
+| `COMPACT_THRESHOLD`     | 自动压缩触发阈值(占窗口比例)                            | `0.85`                      |
+| `LLM_STREAM_USAGE`      | 流式请求带 `stream_options.include_usage` 拿真实用量 | `true`                      |
+| `AUTO_COMPACT`          | 自动压缩总开关                                    | `true`                      |
+| `AUTO_REFLECT`          | 后台反思 pass 总开关(定期从会话挖掘记忆)                   | `true`                      |
+| `REFLECT_EVERY_N`       | 每 N 轮触发一次后台反思(与 agent 并发,不阻塞)              | `5`                         |
+| `ANYSEARCH_API_KEY`     | 联网搜索 API key(不配走匿名免费额度)                    | 无                           |
+| `ANYSEARCH_BASE_URL`    | 搜索 API 端点                                  | `https://api.anysearch.com` |
+| `SKILLS_DIRS`           | 覆盖默认 skill 扫描目录(平台分隔符)                     | 三目录自动扫描                     |
+| `MOCODE_CONTEXT_OPTIMIZE` | 工具结果进 LLM 前的类型化编码(树/搜索/日志…),关掉则原样进(仅长度裁剪) | `true`                      |
+| `MAX_STEPS`             | 每轮 agent 循环最大步数(防无限循环)                    | `200`                       |
+| `SUB_AGENT_MAX_STEPS`   | 子 agent(task 工具派生)默认步数上限                  | `50`                        |
+| `SANDBOX_ROOT`          | 沙箱根目录(文件操作边界;未配则用 cwd 兜底)                | 无                           |
+| `MOCODE_THEME`          | 颜色主题(default/dark/light…;shell 设置优先于文件)      | `default`                   |
 
 ## 运行
 
@@ -116,39 +123,45 @@ agent 工作在**启动时所在的工作目录**——想让它操作某个项
 
 ## 工具
 
-| 工具 | 作用 |
-|------|------|
-| `read_file` | 读文件,带行号,支持 `offset` / `limit` |
-| `write_file` | 创建/覆盖文件,自动建父目录 |
-| `edit_file` | 精确字符串替换(`old_string` 须唯一匹配) |
-| `run_command` | 执行 shell 命令,合并 stdout+stderr,默认 120s 超时 |
-| `glob` | 按 glob 模式找文件(排除 node_modules/.git) |
-| `grep` | 内容正则搜索,纯 JS 实现,不依赖 `rg` |
-| `codegraph` | 已建 `.codegraph/` 索引时,查代码符号源码与调用链(比 read_file/grep 更准更省) |
-| `web_search` | 联网搜索(AnySearch),返回标题/URL/摘要/正文 |
-| `web_fetch` | 抓取指定 URL,HTML 清洗成纯文本 |
-| `use_skill` | 加载某 skill 的完整 SKILL.md 指令 |
-| `ask_human` | 决策点弹终端问答面板,用户选预设项或自由输入(阻塞至回应) |
-| `switch_mode` | 在 `plan`(只读规划)与 `auto`(全量执行)间切换;agent 可自行调用,先探查再动手 |
-| `task` | 派生子 agent 执行独立子任务(独立历史、可受限工具集、可设步数上限);连续多个自动并行,只回摘要 |
-| `memory_save` | 存一条跨会话长期记忆(标题进索引,正文按需取) |
-| `memory_search` | 按关键词搜记忆正文,命中即提升召回计数(影响遗忘衰减) |
-| `memory_list` | 列记忆索引(id/标题/摘要,无正文) |
-| `memory_update` | 原地改一条记忆(id 不变;纠正过时事实 / 改摘要 / 改 pin) |
-| `memory_forget` | 遗忘记忆:默认归档(可复活),`mode=delete` 硬删(pinned 拒删) |
+| 工具              | 作用                                                       |
+| --------------- | -------------------------------------------------------- |
+| `read_file`     | 读文件,带行号,支持 `offset` / `limit`                            |
+| `write_file`    | 创建/覆盖文件,自动建父目录                                           |
+| `edit_file`     | 精确字符串替换(`old_string` 须唯一匹配)                              |
+| `run_command`   | 执行 shell 命令,合并 stdout+stderr,默认 120s 超时                  |
+| `glob`          | 按 glob 模式找文件(排除 node\_modules/.git)                      |
+| `grep`          | 内容正则搜索,纯 JS 实现,不依赖 `rg`                                  |
+| `codegraph`     | 已建 `.codegraph/` 索引时,查代码符号源码与调用链(比 read\_file/grep 更准更省) |
+| `web_search`    | 联网搜索(AnySearch),返回标题/URL/摘要/正文                           |
+| `web_fetch`     | 抓取指定 URL,HTML 清洗成纯文本                                     |
+| `use_skill`     | 加载某 skill 的完整 SKILL.md 指令                                |
+| `ask_human`     | 决策点弹终端问答面板,用户选预设项或自由输入(阻塞至回应)                            |
+| `switch_mode`   | 在 `plan`(只读规划)与 `auto`(全量执行)间切换;agent 可自行调用,先探查再动手       |
+| `drop_context`  | 把历史里无关的旧工具结果替换为存根释放上下文(保 tool_call_id 配对,不动 system 与当前轮;幂等) |
+| `task`          | 派生子 agent 执行独立子任务(独立历史、可受限工具集、可设步数上限);连续多个自动并行,只回摘要      |
+| `memory_save`   | 存一条跨会话长期记忆(标题进索引,正文按需取)                                  |
+| `memory_search` | 按关键词搜记忆正文,命中即提升召回计数(影响遗忘衰减)                              |
+| `memory_list`   | 列记忆索引(id/标题/摘要,无正文)                                      |
+| `memory_update` | 原地改一条记忆(id 不变;纠正过时事实 / 改摘要 / 改 pin)                      |
+| `memory_forget` | 遗忘记忆:默认归档(可复活),`mode=delete` 硬删(pinned 拒删)               |
 
 ## 斜杠命令
 
-| 命令 | 作用 |
-|------|------|
-| `/exit` `/quit` | 退出 mocode |
-| `/clear` | 清空历史(保留系统提示)+ 清屏 |
-| `/context` | 显示上下文用量条(token / 消息数 / 估算或实测) |
-| `/skills` | 列出已发现的 skill |
-| `/compact` | 压缩历史(可带焦点 `/compact …`) |
-| `/resume` | 续接已保存的会话 |
-| `/think` | 展开折叠思考段(`/think N`) |
-| `/rollback` | 菜单选轮次回滚(↑↓ · Enter) |
+| 命令              | 作用                                                 |
+| --------------- | -------------------------------------------------- |
+| `/exit` `/quit` | 退出 mocode                                          |
+| `/clear`        | 清空历史(保留系统提示)+ 清屏                                   |
+| `/context`      | 显示上下文用量条(token / 消息数 / 估算或实测)                      |
+| `/skills`       | 列出已发现的 skill                                       |
+| `/compact`      | 压缩历史(可带焦点 `/compact …`)                            |
+| `/resume`       | 续接已保存的会话                                           |
+| `/think`        | 展开折叠思考段(`/think N`)                                |
+| `/rollback`     | 菜单选轮次回滚(↑↓ · Enter)                                |
+| `/model`        | 配置大模型(baseURL / apiKey / model / 上下文窗口),即时生效 + 持久化 |
+| `/init`         | 扫描项目生成 `MOCODE.md` 项目记忆(发给 agent 执行)               |
+| `/theme`        | 切换颜色主题(↑↓ · Enter,或 `/theme <name>` 直切)            |
+| `/plan`         | 切到 plan 模式(只读探查 + 产出计划,审批后切 auto 执行)              |
+| `/auto`         | 切回 auto 模式(全量工具执行)                                  |
 
 输入 `/` 触发下拉菜单,继续打字过滤;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/agent/index.js

@@ -55,16 +55,11 @@ onContextUpdate) {
     // 开新轮次(回滚用):首行截断 40,供 /rollback 轮次菜单展示。
     beginTurn(truncateDisplay(userInput.split('\n')[0] ?? '', 40));
     layout.contentMode(); // 防御性:运行态光标归输入框光标位供 IME 锚定(enterRunningMode 已置,这里兜底)
-    // spinner:续写位内联转圈(思考中 / 执行 工具时,内容区不再「干等」)。
-    // 只走内联 paintLiveAtCursor——不调 setStatus,状态行不重复 spinner 文字(状态行只显走时,
-    // 由 turnTimer 200ms 续刷);内联帧不进缓冲、停时清掉,随后结果即写在该行——故 spinner 不入历史、PgUp 看不到。
+    // spinner:状态行最前面转圈(思考中 / 生成 / 执行 工具时,状态栏 lead 位显帧 + 文字)。
+    // 经 setStatus 注入状态行(spinnerFrame + statusText),composeStatus 把帧 + 文字放 lead 位;
+    // 不画内容区续写位——内容区在等待期间保持干净,首 token 到达即从续写位开始写正文。
     const spinner = new Spinner((msg, frame) => {
-        if (frame) {
-            layout.paintLiveAtCursor(`  ${ui.brightMagenta}${frame}${ui.reset} ${ui.dim}${msg}…${ui.reset}`);
-        }
-        else {
-            layout.clearLiveAtCursor();
-        }
+        layout.setStatus(frame ? `${msg}…` : '', frame ?? undefined);
     });
     // lastChar 镜像:core 跟踪流式末字符决定补换行,但 TUI hooks 需读它决定 layout.contentWrite('\n')。
     // core 的 onTextEnd hook 只在 lastChar !== '\n' 时才调,调后置 '\n';镜像与此同步。
@@ -84,7 +79,7 @@ onContextUpdate) {
                 lastChar = '\n';
             }
             if (name)
-                spinner.start(`生成 ${name}…`);
+                spinner.start(`生成 ${name}`);
         },
         onStepStart: () => spinner.start('思考中'),
         onChatDone: () => spinner.stop(),

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

@@ -4,15 +4,17 @@ import path from 'node:path';
 import dotenv from 'dotenv';
 /**
  * 按优先级加载配置文件并回填 process.env:
- *   候选(文件内升序、后者覆盖前者):~/.mocode/config(全局)→ <cwd>/.mocode/config → <cwd>/.env(兼容旧用法)。
+ *   候选(后者覆盖前者,优先级升序):<cwd>/.env(兼容旧用法,最低)→ ~/.mocode/config(全局)→ <cwd>/.mocode/config(项目级覆盖,最高)。
  *   合并后只回填 process.env 里**尚未设置**的键——shell 里 export 的环境变量永远优先。
- * 故 `mocode` 可在任意目录 / 任意终端启动:全局配置(~/.mocode/config)兜底,项目级文件按需覆盖。
+ * 故 `mocode` 可在任意目录 / 任意终端启动:全局配置(~/.mocode/config)兜底(/model 与 mocode config 写此),
+ *   项目级 .mocode/config 按需覆盖全局;旧用法 .env 优先级最低,不再盖过全局 config——
+ *   否则 /model 写入 ~/.mocode/config 的 LLM 键会被项目 .env 里的同名旧值盖回。
  */
 function loadEnvFiles() {
     const candidates = [
-        path.join(os.homedir(), '.mocode', 'config'),
-        path.join(process.cwd(), '.mocode', 'config'),
-        path.join(process.cwd(), '.env'),
+        path.join(process.cwd(), '.env'), // 兼容旧用法,优先级最低
+        path.join(os.homedir(), '.mocode', 'config'), // 全局(/model 与 mocode config 写此)
+        path.join(process.cwd(), '.mocode', 'config'), // 项目级覆盖,优先级最高
     ];
     const fromFiles = {};
     for (const p of candidates) {
@@ -30,14 +32,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') {
@@ -63,6 +77,7 @@ ${PLATFORM_NOTE}
 
 ## Workflow
 - Understand before acting: when unsure about requirements or code state, explore first; don't assume.
+- **Code exploration first action**: before reading files with read_file or searching with grep, check if a .codegraph/ index exists. If it does, use the codegraph tool (explore for questions/features, node for a specific symbol) as your FIRST step — it returns source + call paths in one shot. Only fall back to read_file/grep when codegraph misses, you need just-changed content, or you're editing a known small file. Build the index with \`codegraph init\` if none exists.
 - Small steps: break tasks into verifiable sub-steps. Before each step, think clearly about what to change and why.
 - Verify after change: run typecheck / tests / build via run_command to confirm it works. Never claim done without verification.
 
@@ -76,6 +91,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.
@@ -108,10 +124,10 @@ export const PLAN_MODE_SUFFIX = `
 ## ⛯ PLAN MODE (active now)
 You are in PLAN mode: investigate and design only — do NOT execute or change anything.
 - Your editing / command / memory-write tools (write_file, edit_file, run_command, memory_save, memory_update, memory_forget) have been REMOVED from your tool list. Use only the read-only tools available to you (read_file, glob, grep, codegraph, web_search, web_fetch, use_skill, ask_human, memory_search, memory_list) to investigate.
-- Research thoroughly: locate the relevant code, trace call paths, and understand existing patterns and conventions before designing. Prefer codegraph when a .codegraph/ index exists.
+- Research thoroughly: locate the relevant code, trace call paths, and understand existing patterns and conventions before designing. Your FIRST action for code exploration should be the codegraph tool (explore/node) when a .codegraph/ index exists — not read_file/grep. Use read_file/grep only to fill gaps codegraph leaves.
 - 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 +149,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',