mocode-ai 1.3.9 → 1.4.0

package/dist/agent/trace-state.js

@@ -0,0 +1,118 @@
+/**
+ * agent 单轮的 trace / token-usage 状态聚合(从 core.ts 提取,2.0 步骤2 深拆第一刀)。
+ *
+ * runAgentCore 原本把 emitTrace / addUsage / reportLive 写成函数内闭包,捕获
+ * traceSessionId / traceTurnId / currentTraceStep / abortTraced / turnUsage 等一坨可变局部量。
+ * 这里把这坨状态收敛进一个对象,runAgentCore 持有实例并调用方法,行为与字节级事件 payload 不变。
+ *
+ * 设计约束:
+ *  - emit() 的 currentTraceStep 三元逻辑逐字保留——trace 事件落盘格式是观测契约,不能漂移。
+ *  - addUsage() 的逐字段累加(含 cacheCreationTokens 的 ?? 0 兜底)逐字保留。
+ *  - reportLive() 的 onLiveUsage 上报警文结构与 turnUsage 闭包累加口径一致(实时 chip 显示)。
+ *  - turnId 类型为 number | undefined:traceTurnId 兜底链可能产出 undefined(--no-session)。
+ */
+import { createTraceEvent } from '../session/index.js';
+export class TurnTraceState {
+    sessionId;
+    turnId;
+    /** 当前步序号;循环每步开头赋值,finally 归 undefined。stepId 由此拼。 */
+    currentTraceStep;
+    /** abort 事件只记一次的幂等旗标。 */
+    abortTraced = false;
+    /** 本轮工具调用总数(turn_end 摘要用)。 */
+    toolCallCount = 0;
+    /** 本轮 token 累计;未开启 include_usage 或全失败时为 undefined。 */
+    turnUsage;
+    onTraceEvent;
+    constructor(init) {
+        this.sessionId = init.sessionId;
+        this.turnId = init.turnId;
+        this.onTraceEvent = init.onTraceEvent;
+    }
+    /** 记一条 trace 事件。best-effort:回调抛错被吞,绝不改变执行路径。 */
+    emit(type, data = {}, ids = {}) {
+        const turnId = this.turnId;
+        if (turnId === undefined)
+            return; // 无会话上下文(--no-session)不产生事件,与原闭包行为一致
+        try {
+            this.onTraceEvent?.(createTraceEvent({
+                sessionId: this.sessionId,
+                turnId,
+                type,
+                ...(this.currentTraceStep === undefined
+                    ? {}
+                    : {
+                        step: this.currentTraceStep,
+                        stepId: `${turnId}:step:${this.currentTraceStep}`,
+                    }),
+                ...ids,
+                data,
+            }));
+        }
+        catch {
+            // Trace is best-effort and must never alter execution.
+        }
+    }
+    /** 累加一次 chat 返回的真实 usage 到本轮 turnUsage。 */
+    addUsage(u) {
+        if (!u)
+            return;
+        this.turnUsage = this.turnUsage
+            ? {
+                promptTokens: this.turnUsage.promptTokens + u.promptTokens,
+                completionTokens: this.turnUsage.completionTokens + u.completionTokens,
+                totalTokens: this.turnUsage.totalTokens + u.totalTokens,
+                cachedTokens: this.turnUsage.cachedTokens + u.cachedTokens,
+                cacheCreationTokens: (this.turnUsage.cacheCreationTokens ?? 0) + (u.cacheCreationTokens ?? 0),
+                reasoningTokens: this.turnUsage.reasoningTokens + u.reasoningTokens,
+            }
+            : u;
+    }
+    /**
+     * 实时用量上报:onLiveUsage 推送「已完成步实测(turnUsage) + 当前步(prompt 估算/实测 + 流式 completion)」。
+     * turnUsage 在本对象内被 addUsage 原地累加,这里每次读最新值,口径与轮末摘要一致。
+     */
+    reportLive(hooks, stepPromptEst, lastStepPromptTokens, providerCacheSeen, p) {
+        // 当前步 prompt:末尾 usage chunk 到达后用实测,流式期间用估算(含校准)。
+        // 当前步 cache 命中同理:上报即用实测;流式期间按前缀缓存估算 ≈ 上一步实测 prompt
+        // (当前 prompt 总含其为前缀),不超过当前步 prompt;后端从不报 cache 时不估算。
+        // 口径与轮末摘要一致:chip ↑ 显计费 prompt(裸 - cached),↓/↻ 同。
+        const curPrompt = p.promptTokens ?? stepPromptEst;
+        const curCached = p.cachedTokens ?? (providerCacheSeen ? Math.min(lastStepPromptTokens, curPrompt) : 0);
+        hooks.onLiveUsage?.({
+            promptTokens: (this.turnUsage?.promptTokens ?? 0) + curPrompt,
+            completionTokens: (this.turnUsage?.completionTokens ?? 0) + p.completionTokens,
+            totalTokens: (this.turnUsage?.totalTokens ?? 0) + curPrompt + p.completionTokens,
+            cachedTokens: (this.turnUsage?.cachedTokens ?? 0) + curCached,
+        });
+    }
+    /**
+     * 中断还原:记一次 abort 事件(幂等)→ onAbort 钩子 → history 回滚到快照 → 模式还原。
+     * 与 core.ts 原 abortRestore 闭包逐字一致(含调用顺序);traceStatus 赋值留在 core
+     * (它是 core 局部 let,turn_end 埋点还要读)。
+     */
+    abortRestore(deps) {
+        if (!this.abortTraced) {
+            this.emit('abort', { phase: 'observed', reason: 'signal' });
+            this.abortTraced = true;
+        }
+        deps.hooks.onAbort?.();
+        deps.history.length = 0;
+        deps.history.push(...deps.savedHistory);
+        deps.ctx.setAgentMode(deps.savedMode);
+    }
+    /**
+     * 构造中断返回值(completed=false / terminationReason='aborted' / finalText=null)。
+     * core.ts 两处 aborted-return 块逐字节相同,收敛到此处;mutation 由调用方现取
+     * (ctx.getCurrentTurnMutationState()),保证读取时点与原内联代码一致。
+     */
+    buildAbortedResult(mutation) {
+        return {
+            completed: false,
+            terminationReason: 'aborted',
+            finalText: null,
+            usage: this.turnUsage,
+            changedFiles: mutation.changedFiles.map((item) => item.path),
+        };
+    }
+}

package/dist/agents/coordinator.js

@@ -33,7 +33,12 @@ function diffToChangeSet(before, after) {
         else if (oldValue && !newValue)
             changes.push({ path: file, operation: 'delete', expectedHash: contentHash(oldValue) });
         else if (oldValue && newValue)
-            changes.push({ path: file, operation: 'update', expectedHash: contentHash(oldValue), replacement: text(newValue) });
+            changes.push({
+                path: file,
+                operation: 'update',
+                expectedHash: contentHash(oldValue),
+                replacement: text(newValue),
+            });
     }
     return changes.length ? createChangeSet(changes) : null;
 }

package/dist/changeset/index.js

@@ -1,10 +1,10 @@
 import { randomUUID } from 'node:crypto';
-import { chmod, copyFile, mkdir, readFile, rename, rm, rmdir, stat, writeFile, } from 'node:fs/promises';
+import { chmod, copyFile, mkdir, readFile, rename, rm, rmdir, stat, writeFile } from 'node:fs/promises';
 import path from 'node:path';
 import { createHash } from 'node:crypto';
 import { jailResolve } from '../sandbox/index.js';
 import { beginPathMutation, endPathMutation } from '../rollback/index.js';
-import { canonicalFileResourceKey, toolResourceLockManager, } from '../tools/resource-lock.js';
+import { canonicalFileResourceKey, toolResourceLockManager } from '../tools/resource-lock.js';
 export function contentHash(content) {
     const data = typeof content === 'string' ? Buffer.from(content, 'utf8') : content;
     return `sha256:${createHash('sha256').update(data).digest('hex')}`;
@@ -19,8 +19,11 @@ function applyTextEdits(source, edits) {
     let cursor = 0;
     let output = '';
     for (const edit of ordered) {
-        if (!Number.isInteger(edit.start) || !Number.isInteger(edit.end) ||
-            edit.start < cursor || edit.end < edit.start || edit.end > source.length) {
+        if (!Number.isInteger(edit.start) ||
+            !Number.isInteger(edit.end) ||
+            edit.start < cursor ||
+            edit.end < edit.start ||
+            edit.end > source.length) {
             throw new Error(`无效或重叠的 TextEdit 范围: ${edit.start}..${edit.end}`);
         }
         output += source.slice(cursor, edit.start) + edit.newText;
@@ -111,9 +114,7 @@ export async function dryRunChangeSet(changeSet) {
             });
         }
     }
-    return conflicts.length > 0
-        ? { ok: false, conflicts }
-        : { ok: true, changeSet: { ...changeSet, prepared } };
+    return conflicts.length > 0 ? { ok: false, conflicts } : { ok: true, changeSet: { ...changeSet, prepared } };
 }
 async function removeIfPresent(target) {
     await rm(target, { recursive: true, force: true });
@@ -222,7 +223,7 @@ export async function commitChangeSet(changeSet, signal) {
                     if (temp)
                         await rename(temp, change.absolutePath);
                 }
-                for (const { change, capture } of captures)
+                for (const { capture } of captures)
                     endPathMutation(capture, `changeset:${changeSet.id}`);
                 for (const backup of backupByPath.values()) {
                     await removeIfPresent(backup).catch(() => undefined);

package/dist/config/index.js

@@ -7,7 +7,8 @@ import { getNotesFilePath, extractActiveNotesSections } from '../session/notes.j
 import { buildWorkDisciplineSection, inferModelFamily } from '../agent/work-discipline.js';
 import { buildValidationCommandsSection } from '../verification/prompt.js';
 import { getActivePresetName, readPreset } from './presets.js';
-import { detectLanguage, setLanguage, t, } from '../i18n/index.js';
+import { detectLanguage, setLanguage, t } from '../i18n/index.js';
+import { isProfileName, profileHasGroup } from './profiles.js';
 /**
  * 按优先级加载配置文件并回填 process.env:
  *   候选(后者覆盖前者,优先级升序):<cwd>/.env(兼容旧用法,最低)→ ~/.mocode/config(全局)→ <cwd>/.mocode/config(项目级覆盖,最高)。
@@ -42,10 +43,25 @@ export const languageFromShell = process.env.MOCODE_LANGUAGE !== undefined;
 // 在 loadEnvFiles 回填前捕获:哪些 LLM 键由 shell 设置(决定 /model 写文件是否下次启动生效)。
 // 仿 themeFromShell 模式:shell export 的环境变量在 loadEnvFiles 中不被回填(优先级最高),
 // 故 /model 写入 ~/.mocode/config 的同名键下次启动会被 shell 值覆盖——据此给 dim 警告。
-const LLM_ENV_KEYS = ['LLM_PROVIDER', 'LLM_BASE_URL', 'LLM_API_KEY', 'LLM_MODEL', 'CONTEXT_WINDOW_TOKENS', 'ANTHROPIC_PROMPT_CACHE'];
+const LLM_ENV_KEYS = [
+    'LLM_PROVIDER',
+    'LLM_BASE_URL',
+    'LLM_API_KEY',
+    'LLM_MODEL',
+    'CONTEXT_WINDOW_TOKENS',
+    'ANTHROPIC_PROMPT_CACHE',
+];
 export const DEFAULT_CONTEXT_WINDOW_TOKENS = 256000;
 const llmKeysFromShell = LLM_ENV_KEYS.filter((k) => process.env[k] !== undefined);
 loadEnvFiles();
+/**
+ * 旧 profile 兼容状态：仅供未传 ToolPolicy 的嵌入调用与迁移测试。官方 TUI/stdio
+ * 每个真实用户 turn 都使用 LLM route，且不再提供 /profile 用户命令。
+ */
+let activeProfile = isProfileName(process.env.MOCODE_MODE) ? process.env.MOCODE_MODE : 'coding';
+if (process.env.MOCODE_MODE !== undefined && !isProfileName(process.env.MOCODE_MODE)) {
+    console.warn(`[mocode] 未知 MOCODE_MODE="${process.env.MOCODE_MODE}",回退 coding(可选: coding|frontend|computer-use|research|full)`);
+}
 /**
  * 激活预设覆盖:若用户曾用 /model 激活过预设,启动时让上下文窗口等配置**跟随该预设文件**,
  * 而不是只信 config 文件里上一组裸 LLM 键——这正是"切换后窗口不再退回 256k"的关键。
@@ -123,11 +139,6 @@ function readPersonaFile() {
 function buildVoiceSection() {
     return readPersonaFile() || DEFAULT_VOICE;
 }
-/**
- * 基础系统提示的"记忆段落":开 isMemoryEnabled() 时才拼。
- * 默认关(新用户零侵入):这段 + 工具表里的 5 个 memory_* + 系统提示尾部的 Memory Index
- * 都不出现;打开 /memory_switch 后下一次新建 system message 才注入。
- */
 /**
  * Session notepad 段落：读取 .mocode/sessions/<sessionId>/notes.md，只注入 ## 标题行作为目录摘要。
  * Agent 用 write_file/edit_file/read_file 维护此文件，抗 compact（在 context window 之外）。
@@ -147,8 +158,9 @@ export function buildNotepadSection(sessionId = getCurrentSessionId()) {
         if (!content)
             return '';
         // 1) 提取 ## 标题行（最多 15 个，按文件出现顺序保留）
-        const headers = content.split('\n')
-            .filter(l => /^##\s/.test(l))
+        const headers = content
+            .split('\n')
+            .filter((l) => /^##\s/.test(l))
             .slice(0, 15);
         // 2) 分桶：Done: 开头 → archived；其余 → active
         //    "## Plan:" 和 "## Open Questions" 视为永久 active（不需要改名为 Done）。
@@ -167,11 +179,11 @@ export function buildNotepadSection(sessionId = getCurrentSessionId()) {
             '',
             `## Session Notepad index (${totalCount} section${totalCount === 1 ? '' : 's'} — read \`.mocode/sessions/${sessionId}/notes.md\` to recover full context; surviving compact is the whole point of this file)`,
             `Active (${active.length}):`,
-            ...(active.length ? active.map(h => `  - ${h.replace(/^##\s+/, '')}`) : ['  - (none)']),
+            ...(active.length ? active.map((h) => `  - ${h.replace(/^##\s+/, '')}`) : ['  - (none)']),
         ];
         if (archived.length) {
             lines.push(`Done (${archived.length}):`);
-            lines.push(...archived.map(h => `  - ${h.replace(/^##\s+/, '')}`));
+            lines.push(...archived.map((h) => `  - ${h.replace(/^##\s+/, '')}`));
         }
         lines.push('');
         return lines.join('\n');
@@ -295,11 +307,6 @@ export function buildSessionStateReminder(sessionId = getCurrentSessionId()) {
     ];
     return parts.join('\n\n');
 }
-const SYSTEM_PROMPT_MEMORY_SECTION = `
-## Memory (cross-session facts)
-- The prompt may contain a title/summary index; retrieve details with memory_search or inspect all with memory_list. memory_search also surfaces knowledge-graph facts (relations between entities) alongside entry bodies.
-- Save only stable, non-obvious cross-session facts. Search before saving; update an existing entry instead of duplicating it, and archive stale entries.
-- A knowledge-graph layer links entities across memories: explore relations/neighbors with memory_graph (neighbors/add/stats), and attach meaningful links via the links parameter of memory_save when saving.`;
 /** AGENTS.md 自动导入正文上限:system 位于 history[0] 且 compactHistory 不压缩 system,超长需截断防占窗口(见 memory/README.md)。 */
 const MAX_AGENTS_IMPORT_CHARS = 20000;
 /**
@@ -324,30 +331,16 @@ function buildAgentsImportSection() {
         return ''; // 读失败静默跳过:不让导入破坏 prompt 构建
     }
 }
-/**
- * Memory 检索指导段(与 AGENTS.md 导入无关):开 isMemoryEnabled() 时才拼,
- * 注入 memory_search/list/graph 的使用指导。默认关(新用户零侵入)。
- */
-function buildMemoryPromptSection() {
-    if (!isMemoryEnabled())
-        return '';
-    return SYSTEM_PROMPT_MEMORY_SECTION;
-}
 /**
  * plan 模式追加到系统提示末尾的指令(切到 plan 模式时由 repl 拼进 history[0])。
  * 与 SYSTEM_PROMPT 同语种(英文),指示:只读探查、产出步骤化计划、不执行、审批后回 auto。
  *
- * memoryEnabled=false 时:memory_save/update/forget 三个写工具名字 + "memory-write tools" 这
- * 句都不出现,且 read-only 列表里的 memory_search/memory_list 也移除——避免提示词里出现
- * 根本不存在的工具名引起 LLM 调不到。
+ * 工具名不在这里静态枚举；plan snapshot 会从当前自动路由结果中剔除所有写入/执行能力。
  *
- * .codegraph/ 存在性也动态决定:有索引时引导 LLM 优先用 codegraph skill(免去逐文件扫);
- * 没索引时干脆不提,避免 LLM 调出失败。函数化(非 const)以便在 buildPlanModeSuffix 里现拼。
+ * .codegraph/ 存在性动态决定是否提示 codegraph skill。
  */
 function buildPlanResearchRules() {
-    const cg = hasCodegraphIndex()
-        ? ' Prefer the available codegraph skill for call paths and blast radius.'
-        : '';
+    const cg = hasCodegraphIndex() ? ' Prefer the available codegraph skill for call paths and blast radius.' : '';
     return `
 - Locate relevant code and conventions without repeating retrieved work.${cg}
 - Return an actionable plan with affected files, ordered steps, edge cases, and verification.
@@ -363,7 +356,6 @@ ${buildPlanResearchRules()}`;
 /** 兼容旧名字:repl 的 buildSystemMessage 仍引 PLAN_MODE_SUFFIX(变量)。运行时按需现拼。 */
 export function buildBasePrompt(sessionId = getCurrentSessionId()) {
     const agentsImportSection = buildAgentsImportSection();
-    const memorySection = buildMemoryPromptSection();
     const notepadSection = buildNotepadSection(sessionId);
     // 静态主体:稳定段落集中在前,让支持 prompt caching 的后端能命中前缀缓存(#12)。
     // 约束:staticBody 的前缀段(尤其 ## Identity 第一行)必须是纯静态文本,
@@ -382,7 +374,7 @@ Complete programming tasks through an "analyze → call tool → observe result
 
 ## Workflow
 - Understand: use existing conversation and tool evidence before gathering more; inspect only what supports the next decision, do not guess.
-- Plan: for tasks with 3+ steps or context-loss risk, record the plan with the \`plan_update\` tool (see Session state); keep each step self-contained.
+- Plan: for tasks with 3+ steps or context-loss risk, record the plan with the \`plan_update\` tool (see Session state); give each step a short title plus a self-contained content.
 - Implement: make the smallest coherent change; edit against a fresh read (see Tool policy); avoid unrelated refactors.
 - Verify: decide whether validation is useful by risk and scope; run the smallest relevant check, not broad test/build suites by default.
 - Report: stop when done and give honest conclusions with path:line references (see Reporting).
@@ -419,10 +411,9 @@ ${buildVoiceSection()}
 - **No flattery / no preamble in conclusions**: skip "Sure", "好的", "我已经完成了" and similar no-information prefixes — jump straight to substance.
 - Report honestly: say success when successful, say where you're stuck when failing, and mention anything skipped. Reference code in "path:line" format (e.g., src/index.ts:42). Keep it concise.
 ${t('assistant.languageInstruction')}`;
-    // 动态段(置于末尾):AGENTS.md 项目记忆(无条件) + memory 索引(按开关) + notepad 索引 + notepad 使用说明。
+    // 动态段(置于末尾):AGENTS.md 项目记忆 + notepad 索引/说明。工具簇特定指导由
+    // ToolPolicyController.reminder() 按当前 turn 的 route 注入，避免旧全局 profile 与真实 schema 分裂。
     // 按需注入(#13):有内容的索引才拼对应标题,避免空标题噪声。
-    //   - "## Project context" 仅当 agentsImportSection/memorySection/notepadSection 任一非空(notepad 索引依赖 notes.md 存在);
-    //   - "## Session state" 使用说明**无条件**注入(放在动态尾段首位):否则会陷入"说明依赖 notes.md 存在 → 模型不知要建 → 文件永不存在"的鸡生蛋循环,功能对模型不可见。动态段在静态前缀之后,不影响 prompt 缓存。
     const dynamicParts = [];
     // 会话级私有尾段(子 agent 切片会丢弃):Session state 说明无条件注入在前,Project context 按需在后。
     dynamicParts.push(`## Session state (\`.mocode/sessions/${sessionId ?? '<id>'}/notes.md\`)\n` +
@@ -432,17 +423,18 @@ ${t('assistant.languageInstruction')}`;
         '## Plan: <title>\n' +
         'Goal: <outcome>\n' +
         '### Steps\n' +
-        '- [ ] 1. <self-contained step: target file/symbol, the change, and how to verify>\n' +
+        '- [ ] 1. **<short label, ≤20 chars>** — <self-contained step: target file/symbol, the change, and how to verify>\n' +
         '### Progress\n' +
         '- <completed/total>\n' +
         '```\n' +
+        'Give every step a short `title` (≤20 chars, e.g. "编写测试" / "修 status bar") that shows in the status bar, and keep the full detail in `content` — the label is for scanning, the content is what must survive compaction. ' +
         'Keep at most one step in_progress, and mark a step completed as soon as its work is done — do not batch updates to the end of the turn. ' +
         'Write each step so a teammate who lost the conversation could pick it up cold: name the file or symbol, the exact change, and the verification, so the plan survives context compaction. ' +
         'plan_update creates notes.md for you when the task warrants it; read_file the full notes.md whenever you need to recover context after compaction. ' +
         'When every step is completed, plan_update settles the plan to `## Done:` automatically. Keep other notes concise and session-specific; use memory for stable cross-session facts.\n' +
         '## Session notes (resident memory)\n' +
         'For non-obvious, lasting-value discoveries — subtle constraints, decisions with downstream impact, open questions blocking a choice, or risks affecting later steps — call `note_append` IMMEDIATELY when you make the discovery. The note is written to the same notes.md and its body is re-injected into the prompt automatically (within a 5k-token budget), surviving compaction so you keep remembering what you found/decided this session. Do NOT use it for routine progress (that is the plan) or stable cross-session facts (that is memory_save). Each call appends one item.');
-    const ctxContent = `${agentsImportSection}${memorySection}${notepadSection}`.trimEnd();
+    const ctxContent = `${agentsImportSection}${notepadSection}`.trimEnd();
     if (ctxContent) {
         dynamicParts.push(`## Project context\n${ctxContent}`);
     }
@@ -477,14 +469,8 @@ export function buildMocodeCorePrompt() {
     return full.slice(0, dropStart).trimEnd();
 }
 /**
- * plan 模式追加到系统提示末尾的指令。
- * 历史曾是 `export const PLAN_MODE_SUFFIX`(顶层字面量);现改为按 isMemoryEnabled()
- * 动态拼:false 时不出现 memory_* 工具名,避免 LLM 想调不存在的工具。
- *
- * 注意:已改为 getter(每次访问现拼),让运行时切 /memory_switch 后立即生效。
- * 旧 import `PLAN_MODE_SUFFIX` 路径不变;repl 推荐改用 getPlanModeSuffix()(语义更清晰)。
- * 不能直接 `export const PLAN_MODE_SUFFIX = buildPlanModeSuffix()`:
- * 该表达式在模块初始化时立即求值,而 buildPlanModeSuffix 内部读 config,config 还未求值 → TDZ。
+ * plan 模式追加到系统提示末尾的指令。真实工具集合由当前 ToolPolicy snapshot 与
+ * PLAN_DISABLED_TOOLS 求交；本 getter 只描述只读行为，不枚举可能不存在的工具名。
  */
 export function getPlanModeSuffix() {
     return buildPlanModeSuffix();
@@ -500,19 +486,21 @@ export const config = {
         ? requireEnv('LLM_API_KEY')
         : (__activePreset?.apiKey ?? requireEnv('LLM_API_KEY')),
     model: llmKeysFromShell.includes('LLM_MODEL')
-        ? (process.env.LLM_MODEL || 'gpt-4o-mini')
+        ? process.env.LLM_MODEL || 'gpt-4o-mini'
         : (__activePreset?.model ?? process.env.LLM_MODEL ?? 'gpt-4o-mini'),
     maxTokens: process.env.MAX_TOKENS ? Number(process.env.MAX_TOKENS) : undefined,
-    // 用 getter 而非 buildBasePrompt() 立即求值:因为本对象字面量求值时 buildBasePrompt 读 config.memoryEnabled,
-    // 而 config 还没完成初始化(TDZ)。Getter 让每次访问都现拼,运行时 /memory_switch 立即生效。
+    // 用 getter 而非 buildBasePrompt() 立即求值：对象字面量初始化期间 buildBasePrompt 会读取
+    // config.model 等字段，直接调用会触发 TDZ。Getter 也让语言、persona 等运行时变化在下一轮生效。
     get systemPrompt() {
         return buildBasePrompt();
     },
     contextWindowTokens: llmKeysFromShell.includes('CONTEXT_WINDOW_TOKENS')
-        ? (Number(process.env.CONTEXT_WINDOW_TOKENS) || DEFAULT_CONTEXT_WINDOW_TOKENS)
-        : (__activePreset?.contextWindow
-            ?? Number(process.env.CONTEXT_WINDOW_TOKENS)
-            ?? DEFAULT_CONTEXT_WINDOW_TOKENS),
+        ? Number(process.env.CONTEXT_WINDOW_TOKENS) || DEFAULT_CONTEXT_WINDOW_TOKENS
+        : __activePreset?.contextWindow ||
+            // 必须用 ||:Number() 永不返回 null/undefined,?? 的右支是死代码;
+            // 且环境变量写成非数字时 Number() 得 NaN,?? 会把 NaN 直接放行到 contextWindow。
+            Number(process.env.CONTEXT_WINDOW_TOKENS) ||
+            DEFAULT_CONTEXT_WINDOW_TOKENS,
     includeUsage: process.env.LLM_STREAM_USAGE !== 'false',
     anthropicPromptCache: llmKeysFromShell.includes('ANTHROPIC_PROMPT_CACHE')
         ? process.env.ANTHROPIC_PROMPT_CACHE !== 'false'
@@ -529,14 +517,13 @@ export const config = {
     subAgentEnabled: process.env.MOCODE_SUBAGENT_ENABLED === 'true',
     subAgentMaxSteps: Number(process.env.SUB_AGENT_MAX_STEPS) || Number(process.env.MAX_STEPS) || 1000,
     frontendToolsEnabled: process.env.MOCODE_FRONTEND_TOOLS_ENABLED === 'true',
+    computerUseEnabled: process.env.MOCODE_COMPUTER_USE_ENABLED === 'true',
     mcpEnabled: process.env.MOCODE_MCP_ENABLED !== 'false',
     sessionDir: path.join(process.cwd(), '.mocode', 'sessions'),
     searchApiKey: process.env.ANYSEARCH_API_KEY,
     sandboxRoot: process.env.SANDBOX_ROOT || undefined,
     searchBaseUrl: process.env.ANYSEARCH_BASE_URL || 'https://api.anysearch.com',
-    maxImageBytes: process.env.MOCODE_MAX_IMAGE_BYTES
-        ? Number(process.env.MOCODE_MAX_IMAGE_BYTES)
-        : undefined,
+    maxImageBytes: process.env.MOCODE_MAX_IMAGE_BYTES ? Number(process.env.MOCODE_MAX_IMAGE_BYTES) : undefined,
     theme: process.env.MOCODE_THEME || 'default',
     themeFromShell,
     llmKeysFromShell,
@@ -596,24 +583,73 @@ export function updateModelConfig(opts) {
         process.env.ANTHROPIC_PROMPT_CACHE = opts.anthropicPromptCache ? 'true' : 'false';
     }
 }
-/** 子 Agent 总开关；默认 false，关闭时 sub-agent 不进入模型工具表。 */
+/** legacy 嵌入路径的 profile 查询；官方主 Agent 不读取。 */
+export function getActiveProfile() {
+    return activeProfile;
+}
+/** legacy 嵌入/测试用 profile setter；不再暴露对应 REPL 命令。 */
+export function setActiveProfile(p) {
+    if (!isProfileName(p))
+        throw new Error(`unknown profile: ${String(p)}`);
+    activeProfile = p;
+}
+/** 自动路由 capability gate：只有显式字符串 false 才是硬否决；unset/true 均允许按需选择。 */
+function isRouteCapabilityAllowed(envName) {
+    return process.env[envName] !== 'false';
+}
+export function isSubAgentRouteAllowed() {
+    return isRouteCapabilityAllowed('MOCODE_SUBAGENT_ENABLED');
+}
+export function isFrontendRouteAllowed() {
+    return isRouteCapabilityAllowed('MOCODE_FRONTEND_TOOLS_ENABLED');
+}
+export function isComputerUseRouteAllowed() {
+    return isRouteCapabilityAllowed('MOCODE_COMPUTER_USE_ENABLED');
+}
+/** memory-read / memory-write 的自动路由 gate；与 Memory Index 是否注入分开显示。 */
+export function isMemoryRouteAllowed() {
+    return isRouteCapabilityAllowed('MEMORY_ENABLED');
+}
+/**
+ * 子 Agent legacy 可见性：仅供没有 ToolPolicy 的兼容路径。官方 TUI/stdio 使用
+ * isSubAgentRouteAllowed() + 每 turn ToolPolicy，不再由 activeProfile 决定。
+ */
 export function isSubAgentEnabled() {
-    return config.subAgentEnabled;
+    if (process.env.MOCODE_SUBAGENT_ENABLED !== undefined)
+        return process.env.MOCODE_SUBAGENT_ENABLED === 'true';
+    return profileHasGroup(activeProfile, 'subagent');
+}
+/** 自动工具路由执行面的硬否决；未设置或 true 时由当前 ToolPolicy 决定是否暴露 orchestration。 */
+export function isSubAgentHardDisabled() {
+    return !isSubAgentRouteAllowed();
 }
-/** 运行时切换子 Agent；工具 schema 刷新与持久化由 REPL 调用方完成。 */
+/** /subagent 的持久化写入口：更新兼容字段与 capability gate；不会把 orchestration 常驻 schema。 */
 export function updateSubAgentConfig(enabled) {
     config.subAgentEnabled = enabled;
     process.env.MOCODE_SUBAGENT_ENABLED = enabled ? 'true' : 'false';
 }
-/** 前端工具簇总开关；默认 false，关闭时 browser/dev_server/screenshot/view_image 不进入模型工具表。 */
+/** 前端工具簇的 legacy 可见性；官方自动路由使用 isFrontendRouteAllowed()。 */
 export function isFrontendToolsEnabled() {
-    return config.frontendToolsEnabled;
+    if (process.env.MOCODE_FRONTEND_TOOLS_ENABLED !== undefined)
+        return process.env.MOCODE_FRONTEND_TOOLS_ENABLED === 'true';
+    return profileHasGroup(activeProfile, 'frontend');
 }
-/** 运行时切换前端工具簇；工具 schema 刷新与持久化由 REPL 调用方完成。 */
+/** /fe 的持久化写入口；官方路径把 false 当硬否决，true 仅允许按需路由。 */
 export function updateFrontendToolsConfig(enabled) {
     config.frontendToolsEnabled = enabled;
     process.env.MOCODE_FRONTEND_TOOLS_ENABLED = enabled ? 'true' : 'false';
 }
+/** Computer Use 的 legacy 可见性；官方自动路由使用 isComputerUseRouteAllowed()。 */
+export function isComputerUseEnabled() {
+    if (process.env.MOCODE_COMPUTER_USE_ENABLED !== undefined)
+        return process.env.MOCODE_COMPUTER_USE_ENABLED === 'true';
+    return profileHasGroup(activeProfile, 'computer');
+}
+/** /cu 的持久化写入口；官方路径把 false 当硬否决，true 仅允许按需路由。 */
+export function updateComputerUseConfig(enabled) {
+    config.computerUseEnabled = enabled;
+    process.env.MOCODE_COMPUTER_USE_ENABLED = enabled ? 'true' : 'false';
+}
 /** MCP 总开关；关闭时下次启动跳过 MCP 配置读取与服务连接。 */
 export function isMcpEnabled() {
     return config.mcpEnabled;
@@ -624,12 +660,14 @@ export function updateMcpConfig(enabled) {
     process.env.MOCODE_MCP_ENABLED = enabled ? 'true' : 'false';
 }
 /**
- * 记忆子系统总开关:单一来源。/memory_switch、/memory_status、buildSystemPrompt、
- * tools/builtins/index.ts、tools/constants.ts 的 plan-mode 列表都从这里查。
- * 默认 false(新用户零侵入)。
+ * Memory Index / 反思开关。它不等于自动路由 gate：官方 ToolPolicy 通过
+ * isMemoryRouteAllowed() 判定 memory-read / memory-write 是否可选；这里决定索引和反思是否启用。
+ * legacy profile fallback 仍保留给未传 ToolPolicy 的嵌入调用。
  */
 export function isMemoryEnabled() {
-    return config.memoryEnabled;
+    if (process.env.MEMORY_ENABLED !== undefined)
+        return process.env.MEMORY_ENABLED === 'true';
+    return profileHasGroup(activeProfile, 'memory');
 }
 /**
  * .codegraph/ 索引存在性:仅查 cwd 顶层 .codegraph(目录或文件均可,codegraph CLI
@@ -658,15 +696,9 @@ export function buildCodegraphSection() {
     ].join('\n');
 }
 /**
- * 切换记忆子系统开关(/memory_switch on|off 调)。
- * - 更新 config 单例字段(其它模块下次调 isMemoryEnabled() 即拿新值)。
- * - 同步 process.env.MEMORY_ENABLED(下次启动 loadEnvFiles 不被文件回填)。
- * 持久化(写 ~/.mocode/config 的 MEMORY_ENABLED 键)由调用方走 writeConfigKeys。
- *
- * 注:开关切换对当前会话的 tool list / 已拼好的 systemPrompt 不会自动重算 —
- * 工具表在 REPL 启动时构建,systemPrompt 在每轮 chat() 拼时按 isMemoryEnabled()
- * 现查现拼(关掉时该轮拼出来的 prompt 即不带 memory_* 段)。所以切换在「下一轮
- * agent 调用」起即时生效,本轮已发出的请求不会回滚。
+ * /memory_switch 的写入口：同步 Memory Index 状态与自动路由 capability gate。
+ * 内置 memory_* 工具始终注册但默认不暴露；当前已发出的 immutable policy snapshot 不变，
+ * 下一真实用户 turn 会按新 gate 重路由并重建系统提示。持久化由调用方写 MEMORY_ENABLED。
  */
 export function updateMemoryConfig(enabled) {
     config.memoryEnabled = enabled;

package/dist/config/presets.js

@@ -129,7 +129,9 @@ export function deletePreset(name) {
             try {
                 fs.unlinkSync(ACTIVE_PRESET_PATH);
             }
-            catch { /* 指针已不在,忽略 */ }
+            catch {
+                /* 指针已不在,忽略 */
+            }
         }
         return true;
     }