c0de-agent 1.11.0 → 1.13.0

package/dist/cli/modes/print.d.ts

@@ -9,6 +9,9 @@ type PrintOptions = {
     sessionId?: string;
     /** 事件观察回调（CLI 用于把 tool/thinking 写到 stderr）。 */
     onEvent?: (event: AgentEvent) => void;
+    /** P2-4：外部中止信号（ACP abort）——触发即中止 run 并抛错，
+     *  让调用方如实返回失败而非谎报 ok。 */
+    abortSignal?: AbortSignal;
 };
 /** 从事件流累积 assistant 文本。纯函数。 */
 declare function collectAssistantText(events: AgentEvent[]): string;

package/dist/cli/modes/print.js

@@ -1,7 +1,9 @@
-import { createAgent, runAgent } from '../../core/agent.js';
+import { resolve } from 'node:path';
+import { abortAgent, createAgent, runAgent } from '../../core/agent.js';
 import { resolveRoute } from '../../llm/registry.js';
-import { createSession, getSession } from '../../session/session.js';
-import { resolveEnabledToolNames } from '../../tools/index.js';
+import { getByDirectory } from '../../project/index.js';
+import { createSession, getSession, upgradeTemporarySession } from '../../session/session.js';
+import { PROJECT_BOUND_TOOLS, resolveEnabledToolNames } from '../../tools/index.js';
 /** 从事件流累积 assistant 文本。纯函数。 */
 function collectAssistantText(events) {
     let text = '';
@@ -24,34 +26,102 @@ async function runPrintMode(config, message, deps, opts = {}) {
         const existing = await getSession(deps.db, opts.sessionId);
         if (!existing)
             throw new Error(`session not found: ${opts.sessionId}`);
+        // M2：会话在回收站（Web 已删除）时拒绝续接——否则消息会写入一个 Web 树
+        // 不可见的会话，与「删除」心智模型冲突。给出可操作的恢复途径。
+        if (existing.deletedAt) {
+            throw new Error(`该会话在回收站中（已删除）。请先在 Web 界面回收站中恢复，` +
+                `或停止 serve 后运行 \`c0de sessions restore ${opts.sessionId}\` 恢复，再续接。`);
+        }
+        // P2-6 修复：cwd 与会话 worktree 不一致时拒绝——文件工具在 cwd 执行，
+        // 而 kanban/预算等绑定 session.projectId，同一会话上下文会分裂到两个目录，
+        // 且毫无提示。给出切换目录的可操作指引，避免用户在错误目录误改文件。
+        const worktree = existing.worktreePath;
+        if (worktree && resolve(worktree) !== resolve(deps.cwd)) {
+            throw new Error(`该会话的工作目录（${worktree}）与当前目录（${deps.cwd}）不一致。` +
+                `请先切换到会话目录再续接：\n  cd "${worktree}"\n` +
+                `（会话绑定项目时，工具必须在原目录执行，否则看板与文件操作会分裂到两个目录）`);
+        }
+        // 续接即升级为持久会话：30 天临时清理不再触及（P1：此前 --continue 的
+        // 会话同样会在 30 天不活动后被物理删除，用户显式续接的历史静默丢失）。
+        // P1-3：workflow 会话同口径——Web 继续追问的 workflow 会话此前无升级路径。
+        if (existing.agentType === 'print' || existing.agentType === 'workflow') {
+            await upgradeTemporarySession(deps.db, opts.sessionId);
+        }
         session = existing;
     }
     else {
-        session = await createSession(deps.db, 'cli-print', undefined, undefined, 'cli');
+        // agentType='print'：一次性 print 会话标记。purgeTemporarySessions 仅清理
+        // print/workflow 会话；普通 CLI 会话（ACP 等）与 --continue 续接的历史永不误删。
+        // P1-2 CLI/Web 同树：cwd 已注册为项目时直接绑定（续接后 Web 树按项目可见）；
+        // worktreePath 落盘——Web 打开时工具在原目录执行，而非回退 serve cwd。
+        const existing = await getByDirectory(deps.db, deps.cwd);
+        session = await createSession(deps.db, 'cli-print', existing?.id, 'print', 'cli', undefined, deps.cwd);
     }
     const agentConfig = {
         provider: config.defaultProvider,
         model: opts.model ?? config.defaultModel,
-        // 工具集：enabled 非空 → enabled ∩ registered；空 → 全部 registered（disabled 已在 registry 层过滤）。
-        tools: resolveEnabledToolNames(deps.toolRegistry, config),
+        // 工具集：enabled 含 '*' → 全部 registered；空 → 无工具（fail-closed）；否则 enabled ∩ registered
+        // （disabled 已在 registry 层过滤）。无项目绑定（cwd 未注册为项目）时剔除
+        // 项目绑定工具（kanban 等）——其 store 不会被注入，调用必失败。
+        tools: resolveEnabledToolNames(deps.toolRegistry, config).filter((n) => Boolean(session.projectId) || !PROJECT_BOUND_TOOLS.has(n)),
         plugins: config.plugins.enabled,
         ...(opts.maxTokens !== undefined ? { maxTokens: opts.maxTokens } : {}),
     };
     // P3：首跑友好报错——未配置 provider 时不再让底层 NoRoute 异常裸抛，
     // 给出与 Web 端一致的引导（c0de serve → 设置 → Provider）。
+    // P1-3：区分三种失败（此前一律报「未配置」，配置了 provider 的用户被误导）：
+    //  - 完全没有配置 provider → 引导添加；
+    //  - provider 名不匹配（如 defaultProvider 仍是默认 'openai'，只配了 anthropic）
+    //    → 列出已配置清单 + 修正指引（与 Web PROVIDER_NOT_FOUND 对齐）；
+    //  - provider 声明了模型清单但请求模型不在其中 → 列出可用模型（与 Web
+    //    MODEL_NOT_FOUND 对齐）。
     try {
         resolveRoute(deps.llmRegistry, agentConfig.provider, agentConfig.model);
     }
     catch {
-        throw new Error('未配置可用的 AI 服务。请运行 `c0de serve` 并在「设置 → Provider」中添加 API 服务并测试连接，' +
-            '或使用 `c0de config set` 配置 providers。');
+        if (config.providers.length === 0) {
+            throw new Error('未配置可用的 AI 服务。请运行 `c0de serve` 并在「设置 → Provider」中添加 API 服务并测试连接，' +
+                '或使用 `c0de config set` 配置 providers。');
+        }
+        const configured = config.providers
+            .map((p) => p.name)
+            .filter(Boolean)
+            .join(', ');
+        throw new Error(`未找到名为「${agentConfig.provider}」的 AI 服务。已配置：${configured}。` +
+            `请检查拼写，或用 \`c0de config set defaultProvider <name>\` 修正默认服务。`);
+    }
+    const providerDef = config.providers.find((p) => p.name === agentConfig.provider);
+    const modelNames = providerDef?.models ? Object.keys(providerDef.models) : undefined;
+    if (modelNames && modelNames.length > 0 && !modelNames.includes(agentConfig.model)) {
+        throw new Error(`provider「${agentConfig.provider}」没有名为「${agentConfig.model}」的模型。` +
+            `已配置模型：${modelNames.join(', ')}（可用 \`c0de chat --model <model>\` 指定）。`);
     }
     const state = await createAgent(session, agentConfig, deps);
+    // P2-4：ACP abort 真中止——把外部信号桥接到该 run 的 abortController。
+    // abortAgent 会使 loop 在 turn/流边界 unwind，runAgent 随即结束。
+    if (opts.abortSignal) {
+        if (opts.abortSignal.aborted) {
+            throw new Error('已中止');
+        }
+        opts.abortSignal.addEventListener('abort', () => {
+            abortAgent(state);
+        }, { once: true });
+    }
     const events = [];
     for await (const event of runAgent(state, [{ _tag: 'text', text: message }], deps)) {
         events.push(event);
         opts.onEvent?.(event);
     }
+    // P2-4：中止后如实报错（ACP 客户端收到 error 响应，而非谎报 ok 的完成结果）。
+    if (opts.abortSignal?.aborted) {
+        throw new Error('已中止');
+    }
+    // 终态错误（unexpected，含预算中止）必须反馈给用户而非静默返回半截文本——
+    // 抛出后 dispatch 打印 message 并以非零码退出（预算超支中止等硬性护栏由此可见）。
+    const terminal = events.find((e) => e._tag === 'error' && e.error._tag === 'unexpected');
+    if (terminal && terminal._tag === 'error' && terminal.error._tag === 'unexpected') {
+        throw new Error(terminal.error.message);
+    }
     return collectAssistantText(events);
 }
 export { collectAssistantText, runPrintMode };

package/dist/core/agent.d.ts

@@ -3,7 +3,7 @@ import type { MessageContent, Session } from '../shared/types/message.js';
 import type { AgentDependencies } from './types.js';
 declare function createAgent(session: Session, config: AgentConfig, deps: AgentDependencies): Promise<AgentState>;
 declare function runAgent(state: AgentState, userInput: MessageContent[], deps: AgentDependencies): AsyncGenerator<AgentEvent>;
-declare function pauseAgent(state: AgentState): void;
+declare function pauseAgent(state: AgentState, reason?: string): void;
 declare function resumeAgent(state: AgentState): void;
 declare function abortAgent(state: AgentState): void;
 declare function getAgentStatus(state: AgentState): AgentStatus;

package/dist/core/agent.js

@@ -51,13 +51,18 @@ async function createAgent(session, config, deps) {
 }
 async function* runAgent(state, userInput, deps) {
     // 幂等重发保护：若 DB 末尾已是相同 user message（服务重启后续传场景），
-    // 跳过 append 避免重复。比较 text parts 内容即可区分不同消息。
+    // 跳过 append 避免重复。比较 text/image parts 全量内容——纯文本比较会在
+    // 「含图片消息重发」时误判为不同消息而追加重复条目（P1-2 修复）。
     const last = state.messages[state.messages.length - 1];
     const isDupUser = last?.role === 'user' &&
         last.content.length === userInput.length &&
         last.content.every((p, i) => {
             const q = userInput[i];
-            return p._tag === 'text' && q?._tag === 'text' ? p.text === q.text : false;
+            if (p._tag === 'text' && q?._tag === 'text')
+                return p.text === q.text;
+            if (p._tag === 'image' && q?._tag === 'image')
+                return p.mediaType === q.mediaType && p.data === q.data;
+            return false;
         });
     if (!isDupUser) {
         await appendMessage(deps.db, state.session.id, {
@@ -84,10 +89,10 @@ async function* runAgent(state, userInput, deps) {
     state.status = { _tag: 'running', turnCount: 0 };
     yield* agentLoop(state, deps);
 }
-function pauseAgent(state) {
+function pauseAgent(state, reason) {
     if (state.status._tag !== 'running')
         return;
-    state.status = { _tag: 'paused', pauseReason: 'User requested pause' };
+    state.status = { _tag: 'paused', pauseReason: reason ?? 'User requested pause' };
 }
 function resumeAgent(state) {
     if (state.status._tag !== 'paused')

package/dist/core/agents/builtin.js

@@ -19,7 +19,7 @@ const PLAN_ROLE = `You are c0de-agent in **Plan Mode**. Your job is to investiga
 - Use read-only tools (grep/glob/read) to understand the structure and relevant code.
 - Ask clarifying questions when requirements are ambiguous.
 - When ready, present a concrete implementation plan (files to touch, approach, risks).
-- Do NOT use edit/write tools to modify code. You may run bash for investigation only.`;
+- You have NO shell access and NO write tools in this mode. If investigation requires running a command or modifying files, note it as a step for the user to execute in default mode.`;
 /** 6 个内置 agent（2 primary + 4 subagent）。 */
 const BUILTIN_AGENTS = [
     {
@@ -32,7 +32,7 @@ const BUILTIN_AGENTS = [
     {
         name: 'plan',
         description: '计划模式（只读）。专注调研与方案设计，不直接改代码。',
-        tools: ['read', 'grep', 'glob', 'bash'],
+        tools: ['read', 'grep', 'glob'],
         systemPrompt: PLAN_ROLE,
         mode: 'primary',
         source: 'builtin',

package/dist/core/agents/index.d.ts

@@ -1,5 +1,4 @@
 export { BUILTIN_AGENTS, WORKER_BASE } from './builtin.js';
-export { loadAgentFile, loadAgents } from './discovery.js';
 export type { ParallelResult } from './parallel.js';
 export { mapWithConcurrencyLimit } from './parallel.js';
 export { createAgentRegistry } from './registry.js';

package/dist/core/agents/index.js

@@ -1,4 +1,3 @@
 export { BUILTIN_AGENTS, WORKER_BASE } from './builtin.js';
-export { loadAgentFile, loadAgents } from './discovery.js';
 export { mapWithConcurrencyLimit } from './parallel.js';
 export { createAgentRegistry } from './registry.js';

package/dist/core/compact.d.ts

@@ -1,10 +1,12 @@
 import type { DB } from '../db/client.js';
 import type { Registry } from '../llm/registry.js';
+import type { FallbackChain } from '../llm/routing.js';
 import type { CompactionConfig, CompactionResult, Summarizer } from '../session/types.js';
 /** Create a Summarizer backed by an LLM streaming call. */
 declare function createSummarizer(registry: Registry, provider: string, model: string, opts?: {
     maxTokens?: number;
     signal?: AbortSignal;
+    fallback?: FallbackChain;
 }): Summarizer;
 /** Run compaction on a session using the provided summarizer. */
 declare function runCompaction(db: DB, sessionId: string, summarizer: Summarizer, config?: Partial<CompactionConfig>): Promise<CompactionResult>;

package/dist/core/compact.js

@@ -13,6 +13,7 @@ function createSummarizer(registry, provider, model, opts) {
         for await (const chunk of chatStream({ registry, signal: opts?.signal }, request, {
             provider,
             model,
+            ...(opts?.fallback ? { fallback: opts.fallback } : {}),
         })) {
             if (chunk._tag === 'text') {
                 chunks.push(chunk);

package/dist/core/config.d.ts

@@ -1,10 +1,43 @@
 import type { AgentsConfig, CompactionConfig, Config, MCPServerConfig, PermissionConfig, SecurityConfig, ToolMetricsConfig, UpdateConfig, WebSearchConfig } from '../shared/types/config.js';
+/**
+ * 全局配置根目录：默认 `~/.c0de`；C0DE_CONFIG_DIR 环境变量可整体重定向
+ * （相对路径按进程 cwd 解析），全局工作流/插件同样落于此根下。
+ * 与 C0DE_DB_DIR 同口径——开发隔离场景把全局配置从安装版默认位置切到独立目录。
+ */
+declare function resolveGlobalConfigDir(): string;
 declare const DEFAULT_CONFIG: Config;
 declare function mergeConfig(...configs: (Partial<Config> | undefined)[]): Config;
+/**
+ * usage 下「全局口径」预算键——仅 global 作用域生效。项目作用域写入这些键
+ * 会被忽略（作用域收敛）：此前「项目配置里设全局预算无意义但会生效」既造成
+ * 双预算语义混乱，又会随 git clone 传播、未被信任门禁拦截。收敛后项目作用域
+ * 的这两键不再进入任何合并视图，也不随 clone 影响本机护栏。
+ */
+declare const GLOBAL_ONLY_USAGE_KEYS: readonly ["globalMonthlyBudgetUsd", "globalMonthlyTokenBudget"];
+/** 从项目作用域原始配置中剥离「服务端/全局」键（security 顶层键 + usage 全局口径预算键）。
+ *  浅拷贝，不改入参；无剥离键时原样返回（保持身份，调用方可安全比较）。 */
+declare function stripProjectServerKeys(project: Partial<Config> | undefined): Partial<Config> | undefined;
+/**
+ * 返回项目作用域**原始文件**中出现的全局口径预算键名（strip 前的原始内容）。
+ * 供设置页告警展示：这些键来自旧版本或手动编辑，加载时已被剥离、不再生效。
+ */
+declare function projectGlobalOnlyUsageKeys(projectDir?: string): string[];
+/**
+ * 返回项目作用域**原始文件**中出现的 security 子键名（strip 前的原始内容）。
+ * 供设置页告警展示：security 是服务端全局参数，随项目配置出现时已被剥离、不再生效。
+ */
+declare function projectSecurityKeys(projectDir?: string): string[];
+/**
+ * 读取项目作用域原始文件内容（不剥离 security/全局键）。
+ * 供「文件原文」敏感的检查使用——被剥离的键仍可能携带明文密钥（如 security.token），
+ * 配置落在 git 仓库内同样要防误提交，不能因键不生效而漏掉警告。
+ */
+declare function loadProjectRawScope(projectDir?: string): Partial<Config> | undefined;
 /**
  * 读取 global/project 两个作用域的**原始文件内容**（不经 DEFAULT 合并）。
  * 供配置持久化使用：写回某个作用域时只落该作用域应有的键，
  * 避免把合并结果（含默认值与另一作用域的配置）整体序列化进文件。
+ * 项目作用域经 stripProjectServerKeys 收敛——security 与全局口径预算键只会从 global 读。
  */
 declare function loadConfigScopes(projectDir?: string): {
     global: Partial<Config> | undefined;
@@ -25,8 +58,26 @@ declare function applyScopedPatch(base: Record<string, unknown> | undefined, pat
  * 用于「patch 合并进某个作用域的原始文件」后再写盘。
  */
 declare function mergeRaw(...cfgs: (Record<string, unknown> | undefined)[]): Record<string, unknown>;
-/** 把 raw JSON 写回指定作用域配置文件（不含默认值）。 */
+/** 把 raw JSON 写回指定作用域配置文件（不含默认值）。
+ *  - 落盘前对 providers[].apiKey 加密（已带 enc: 前缀/空值透传）——
+ *    CLI config set 与 /config 斜杠命令共用此路径，保证「apiKey 不明文落盘」全链路成立。
+ *  - 写入后 chmod 600：配置文件可能含 token/加密密钥，默认 0644 同机可读。 */
 declare function saveConfigScoped(scope: 'global' | 'project', projectDir: string | undefined, data: Record<string, unknown>): Promise<void>;
 declare function loadConfig(projectDir?: string): Promise<Config>;
+/**
+ * P0-1：配置迁移告警（返回值，供 Web 设置页 warnings 展示；CLI 侧 console.warn
+ * 复用）。检测语义翻转/易混淆键：
+ *  - tools.enabled: [] —— 旧版含义「启用全部」已改为「禁用全部」（fail-closed），
+ *    老用户升级后会静默失去全部工具，必须在 Web 界面可见（不只落在 stderr）。
+ *  - slashCommands.enabled: [] —— 旧版含义「全部启用」已同步改为「禁用全部」
+ *    （与 tools.enabled 语义统一），升级后斜杠命令将全部失效，须显式引导。
+ */
+export declare function collectConfigMigrationWarnings(scope: 'global' | 'project', data: Record<string, unknown> | undefined): string[];
+/** Config 全部顶层键（DEFAULT_CONFIG + 可选键）。未知顶层键校验与告警共用。 */
+declare const KNOWN_CONFIG_KEYS: Set<string>;
+/** 收集对象中不属于 Config 顶层键的未知键。 */
+declare function collectUnknownConfigKeys(data: Record<string, unknown> | undefined): string[];
+/** 加载配置时对未知顶层键告警（拼写错误/旧版键静默失效的唯一提示）。 */
+declare function warnUnknownConfigKeys(scope: 'global' | 'project', data: Record<string, unknown> | undefined): void;
 export type { AgentsConfig, CompactionConfig, Config, MCPServerConfig, PermissionConfig, SecurityConfig, ToolMetricsConfig, UpdateConfig, WebSearchConfig, };
-export { applyScopedPatch, DEFAULT_CONFIG, loadConfig, loadConfigScopes, mergeConfig, mergeRaw, saveConfigScoped, };
+export { applyScopedPatch, collectUnknownConfigKeys, DEFAULT_CONFIG, GLOBAL_ONLY_USAGE_KEYS, KNOWN_CONFIG_KEYS, loadConfig, loadConfigScopes, loadProjectRawScope, mergeConfig, mergeRaw, projectGlobalOnlyUsageKeys, projectSecurityKeys, resolveGlobalConfigDir, saveConfigScoped, stripProjectServerKeys, warnUnknownConfigKeys, };

package/dist/core/config.js

@@ -1,8 +1,20 @@
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { homedir } from 'node:os';
-import { join } from 'node:path';
+import { isAbsolute, join, resolve } from 'node:path';
+import { encryptSecret, isEncryptedSecret } from './secret.js';
 const GLOBAL_CONFIG_DIR = '.c0de';
 const CONFIG_FILENAME = 'config.json';
+/**
+ * 全局配置根目录：默认 `~/.c0de`；C0DE_CONFIG_DIR 环境变量可整体重定向
+ * （相对路径按进程 cwd 解析），全局工作流/插件同样落于此根下。
+ * 与 C0DE_DB_DIR 同口径——开发隔离场景把全局配置从安装版默认位置切到独立目录。
+ */
+function resolveGlobalConfigDir() {
+    const envDir = process.env.C0DE_CONFIG_DIR?.trim();
+    if (envDir)
+        return isAbsolute(envDir) ? envDir : resolve(envDir);
+    return join(homedir(), GLOBAL_CONFIG_DIR);
+}
 const DEFAULT_CONFIG = {
     providers: [],
     defaultProvider: 'openai',
@@ -16,20 +28,29 @@ const DEFAULT_CONFIG = {
         keepRecentTokens: 4000,
         midTurnEnabled: false,
     },
-    // enabled 为空 = 启用全部注册工具（registry 层过滤 disabled）。
-    // 非空 = 默认工具集。CLI print 与 Web chat 统一经 resolveEnabledToolNames 解析。
-    tools: { enabled: [], disabled: [] },
+    // enabled 语义（P1-1 修复「空=全部」安全陷阱）：
+    //   ['*']（通配）= 启用全部注册工具（默认）；[] = 无工具（fail-closed）；
+    //   非空名单 = 默认工具集。CLI print 与 Web chat 统一经 resolveEnabledToolNames 解析。
+    tools: { enabled: ['*'], disabled: [] },
     plugins: { enabled: [] },
     mcpServers: [],
-    slashCommands: { enabled: ['/compact', '/model', '/clear', '/help', '/fork', '/config'] },
+    slashCommands: {
+        enabled: ['/compact', '/model', '/clear', '/help', '/fork', '/config', '/workflow'],
+    },
     toolMetrics: { enabled: true, threshold: 0.8, minSamples: 5 },
     security: { authEnabled: true, allowedOrigins: [] },
     websearch: { provider: 'auto' },
-    agents: { dir: '.c0de/agents', subagentConcurrency: 3 },
-    permission: { defaultMode: 'default' },
+    agents: { subagentConcurrency: 3 },
+    permission: { defaultMode: 'default', timeoutAction: 'pause' },
+    usage: {
+        monthlyBudgetUsd: 0,
+        globalMonthlyBudgetUsd: 0,
+        monthlyTokenBudget: 0,
+        globalMonthlyTokenBudget: 0,
+        budgetAction: 'warn',
+    },
     update: { enabled: true, intervalMs: 60 * 60 * 1000, initialDelayMs: 10_000 },
     theme: 'system',
-    locale: 'en',
 };
 function mergeConfig(...configs) {
     const result = structuredClone(DEFAULT_CONFIG);
@@ -68,15 +89,95 @@ function readJsonIfExists(path) {
         return undefined;
     }
 }
+/**
+ * usage 下「全局口径」预算键——仅 global 作用域生效。项目作用域写入这些键
+ * 会被忽略（作用域收敛）：此前「项目配置里设全局预算无意义但会生效」既造成
+ * 双预算语义混乱，又会随 git clone 传播、未被信任门禁拦截。收敛后项目作用域
+ * 的这两键不再进入任何合并视图，也不随 clone 影响本机护栏。
+ */
+const GLOBAL_ONLY_USAGE_KEYS = ['globalMonthlyBudgetUsd', 'globalMonthlyTokenBudget'];
+/**
+ * 项目作用域中「服务端/全局生效、随 git clone 传播有安全风险」的顶层键：整体剥离。
+ * `security` 是服务级信任边界（鉴权开关 / token / CORS origin / 首设备窗口）——单进程
+ * 多项目架构下不存在「按项目」的安全参数。此前项目配置可静默改写服务端安全参数
+ * （如 authEnabled:false、security.token 静态弱 token、allowedOrigins 放宽），且这些键
+ * 不在信任门禁的风险 kind（trust.ts summarizeProjectRisk）内，克隆仓库即可无确认生效。
+ * 收敛为 global-only：security 仅从全局作用域读取。
+ */
+const PROJECT_SERVER_ONLY_KEYS = ['security'];
+/** 从项目作用域原始配置中剥离「服务端/全局」键（security 顶层键 + usage 全局口径预算键）。
+ *  浅拷贝，不改入参；无剥离键时原样返回（保持身份，调用方可安全比较）。 */
+function stripProjectServerKeys(project) {
+    if (!project)
+        return project;
+    let stripped = false;
+    const next = { ...project };
+    // 顶层「服务端/全局」键整体移除（见 PROJECT_SERVER_ONLY_KEYS）。
+    for (const k of PROJECT_SERVER_ONLY_KEYS) {
+        if (k in next) {
+            delete next[k];
+            stripped = true;
+        }
+    }
+    // usage 下全局口径预算键移除（仅 global 作用域生效）。
+    const usage = project.usage;
+    if (typeof usage === 'object' && usage !== null && !Array.isArray(usage)) {
+        const u = { ...usage };
+        for (const k of GLOBAL_ONLY_USAGE_KEYS) {
+            if (k in u) {
+                delete u[k];
+                stripped = true;
+            }
+        }
+        next.usage = u;
+    }
+    if (!stripped)
+        return project;
+    return next;
+}
+/**
+ * 返回项目作用域**原始文件**中出现的全局口径预算键名（strip 前的原始内容）。
+ * 供设置页告警展示：这些键来自旧版本或手动编辑，加载时已被剥离、不再生效。
+ */
+function projectGlobalOnlyUsageKeys(projectDir) {
+    const raw = readJsonIfExists(join(projectDir ?? process.cwd(), '.c0de', CONFIG_FILENAME));
+    const usage = raw?.usage;
+    if (typeof usage !== 'object' || usage === null || Array.isArray(usage))
+        return [];
+    return GLOBAL_ONLY_USAGE_KEYS.filter((k) => k in usage);
+}
+/**
+ * 返回项目作用域**原始文件**中出现的 security 子键名（strip 前的原始内容）。
+ * 供设置页告警展示：security 是服务端全局参数，随项目配置出现时已被剥离、不再生效。
+ */
+function projectSecurityKeys(projectDir) {
+    const raw = readJsonIfExists(join(projectDir ?? process.cwd(), '.c0de', CONFIG_FILENAME));
+    const sec = raw?.security;
+    if (typeof sec !== 'object' || sec === null || Array.isArray(sec))
+        return [];
+    return Object.keys(sec);
+}
+/**
+ * 读取项目作用域原始文件内容（不剥离 security/全局键）。
+ * 供「文件原文」敏感的检查使用——被剥离的键仍可能携带明文密钥（如 security.token），
+ * 配置落在 git 仓库内同样要防误提交，不能因键不生效而漏掉警告。
+ */
+function loadProjectRawScope(projectDir) {
+    return readJsonIfExists(join(projectDir ?? process.cwd(), '.c0de', CONFIG_FILENAME));
+}
 /**
  * 读取 global/project 两个作用域的**原始文件内容**（不经 DEFAULT 合并）。
  * 供配置持久化使用：写回某个作用域时只落该作用域应有的键，
  * 避免把合并结果（含默认值与另一作用域的配置）整体序列化进文件。
+ * 项目作用域经 stripProjectServerKeys 收敛——security 与全局口径预算键只会从 global 读。
  */
 function loadConfigScopes(projectDir) {
-    const globalPath = join(homedir(), GLOBAL_CONFIG_DIR, CONFIG_FILENAME);
+    const globalPath = join(resolveGlobalConfigDir(), CONFIG_FILENAME);
     const projectPath = join(projectDir ?? process.cwd(), '.c0de', CONFIG_FILENAME);
-    return { global: readJsonIfExists(globalPath), project: readJsonIfExists(projectPath) };
+    return {
+        global: readJsonIfExists(globalPath),
+        project: stripProjectServerKeys(readJsonIfExists(projectPath)),
+    };
 }
 /**
  * 把 patch 应用到某个作用域的原始配置（scoped patch，null=删除）：
@@ -138,21 +239,136 @@ function mergeRaw(...cfgs) {
     }
     return result;
 }
-/** 把 raw JSON 写回指定作用域配置文件（不含默认值）。 */
+/** 把 raw JSON 写回指定作用域配置文件（不含默认值）。
+ *  - 落盘前对 providers[].apiKey 加密（已带 enc: 前缀/空值透传）——
+ *    CLI config set 与 /config 斜杠命令共用此路径，保证「apiKey 不明文落盘」全链路成立。
+ *  - 写入后 chmod 600：配置文件可能含 token/加密密钥，默认 0644 同机可读。 */
 async function saveConfigScoped(scope, projectDir, data) {
-    const dir = scope === 'global'
-        ? join(homedir(), GLOBAL_CONFIG_DIR)
-        : join(projectDir ?? process.cwd(), '.c0de');
+    const dir = scope === 'global' ? resolveGlobalConfigDir() : join(projectDir ?? process.cwd(), '.c0de');
     if (!existsSync(dir))
         mkdirSync(dir, { recursive: true });
     const path = join(dir, CONFIG_FILENAME);
-    writeFileSync(path, JSON.stringify(data, null, 2), 'utf-8');
+    const hardened = redactSensitiveOnSave(data);
+    writeFileSync(path, JSON.stringify(hardened, null, 2), 'utf-8');
+    try {
+        chmodSync(path, 0o600);
+    }
+    catch {
+        // 平台不支持（Windows 等）时忽略；内容仍已加密。
+    }
+}
+/** 落盘前的敏感值处理：providers[].apiKey 与 websearch 后端 key 明文 → enc: 加密
+ *  （spec §24.2；此前 websearch.tavilyApiKey/braveApiKey 明文落盘，与 provider
+ *  apiKey 安全叙事不一致——git 误提交警告会命中它们，加密却不会）。 */
+function redactSensitiveOnSave(data) {
+    const out = {};
+    for (const [key, val] of Object.entries(data)) {
+        if (key === 'providers' && Array.isArray(val)) {
+            out[key] = val.map((p) => {
+                if (p === null || typeof p !== 'object')
+                    return p;
+                const apiKey = p.apiKey;
+                if (typeof apiKey === 'string' && apiKey.length > 0 && !isEncryptedSecret(apiKey)) {
+                    return { ...p, apiKey: encryptSecret(apiKey) };
+                }
+                return p;
+            });
+            continue;
+        }
+        if (key === 'websearch' && val !== null && typeof val === 'object') {
+            const ws = { ...val };
+            for (const k of ['tavilyApiKey', 'braveApiKey']) {
+                const v = ws[k];
+                if (typeof v === 'string' && v.length > 0 && !isEncryptedSecret(v)) {
+                    ws[k] = encryptSecret(v);
+                }
+            }
+            out[key] = ws;
+            continue;
+        }
+        out[key] = val;
+    }
+    return out;
 }
 async function loadConfig(projectDir) {
-    const globalPath = join(homedir(), GLOBAL_CONFIG_DIR, CONFIG_FILENAME);
+    const globalPath = join(resolveGlobalConfigDir(), CONFIG_FILENAME);
     const projectPath = join(projectDir ?? process.cwd(), '.c0de', CONFIG_FILENAME);
     const global = readJsonIfExists(globalPath);
-    const project = readJsonIfExists(projectPath);
+    // 与 loadConfigScopes 同口径剥离：security 与 usage 全局口径预算键不进合并视图
+    // （此前 loadConfig 不剥离，服务启动目录项目的 security/全局预算键会静默生效——
+    //  安全键可被克隆仓库无确认改写，全局预算可被项目作用域注入）。
+    const projectRaw = readJsonIfExists(projectPath);
+    const project = stripProjectServerKeys(projectRaw);
+    // 项目配置遗留 security 键（旧版本/手动编辑/克隆仓库自带）→ CLI 侧明示已忽略，
+    // 与 Web 设置页 securityWarnings 同口径（stderr 可见，不必等到打开设置页）。
+    const rawSecurity = projectRaw?.security;
+    if (typeof rawSecurity === 'object' && rawSecurity !== null && !Array.isArray(rawSecurity)) {
+        const keys = Object.keys(rawSecurity);
+        if (keys.length > 0) {
+            console.warn(`[config] 项目配置含 security 键（${keys.join('、')}，服务端全局参数），已忽略——` +
+                `请在全局配置（${join(resolveGlobalConfigDir(), CONFIG_FILENAME)}）或 c0de config set --global 设置。`);
+        }
+    }
+    warnUnknownConfigKeys('global', global);
+    warnUnknownConfigKeys('project', project);
+    for (const [scope, data] of [
+        ['global', global],
+        ['project', project],
+    ]) {
+        for (const w of collectConfigMigrationWarnings(scope, data))
+            console.warn(`[config] ${w}`);
+    }
     return mergeConfig(global, project);
 }
-export { applyScopedPatch, DEFAULT_CONFIG, loadConfig, loadConfigScopes, mergeConfig, mergeRaw, saveConfigScoped, };
+/**
+ * P0-1：配置迁移告警（返回值，供 Web 设置页 warnings 展示；CLI 侧 console.warn
+ * 复用）。检测语义翻转/易混淆键：
+ *  - tools.enabled: [] —— 旧版含义「启用全部」已改为「禁用全部」（fail-closed），
+ *    老用户升级后会静默失去全部工具，必须在 Web 界面可见（不只落在 stderr）。
+ *  - slashCommands.enabled: [] —— 旧版含义「全部启用」已同步改为「禁用全部」
+ *    （与 tools.enabled 语义统一），升级后斜杠命令将全部失效，须显式引导。
+ */
+export function collectConfigMigrationWarnings(scope, data) {
+    if (!data)
+        return [];
+    const scopeLabel = scope === 'global' ? '全局' : '项目';
+    const out = [];
+    const tools = data.tools;
+    if (typeof tools === 'object' && tools !== null && !Array.isArray(tools)) {
+        const enabled = tools.enabled;
+        if (Array.isArray(enabled) && enabled.length === 0) {
+            out.push(`${scopeLabel}配置的 tools.enabled 为空数组：旧版含义「启用全部」已改为「禁用全部」——` +
+                `如需启用全部，请改为 ["*"]，或删除该键恢复默认值。`);
+        }
+    }
+    const slash = data.slashCommands;
+    if (typeof slash === 'object' && slash !== null && !Array.isArray(slash)) {
+        const enabled = slash.enabled;
+        if (Array.isArray(enabled) && enabled.length === 0) {
+            out.push(`${scopeLabel}配置的 slashCommands.enabled 为空数组：旧版含义「全部启用」已改为「禁用全部」` +
+                `（与 tools.enabled 语义统一）——如需启用全部，请改为 ["*"]，或删除该键恢复默认值。`);
+        }
+    }
+    return out;
+}
+/** Config 全部顶层键（DEFAULT_CONFIG + 可选键）。未知顶层键校验与告警共用。 */
+const KNOWN_CONFIG_KEYS = new Set([
+    ...Object.keys(DEFAULT_CONFIG),
+    // 可选键不在 DEFAULT_CONFIG 中（缺失=未配置），但属于合法键。
+    'commitModel',
+]);
+/** 收集对象中不属于 Config 顶层键的未知键。 */
+function collectUnknownConfigKeys(data) {
+    if (!data)
+        return [];
+    return Object.keys(data).filter((k) => !KNOWN_CONFIG_KEYS.has(k));
+}
+/** 加载配置时对未知顶层键告警（拼写错误/旧版键静默失效的唯一提示）。 */
+function warnUnknownConfigKeys(scope, data) {
+    const unknown = collectUnknownConfigKeys(data);
+    if (unknown.length === 0)
+        return;
+    console.warn(`[config] ${scope} 配置包含未知键：${unknown.join(', ')}。` +
+        `这些键不会生效——请检查拼写，或移除过时配置。有效顶层键：${[...KNOWN_CONFIG_KEYS].join(', ')}`);
+}
+export { applyScopedPatch, collectUnknownConfigKeys, DEFAULT_CONFIG, GLOBAL_ONLY_USAGE_KEYS, KNOWN_CONFIG_KEYS, loadConfig, loadConfigScopes, loadProjectRawScope, mergeConfig, mergeRaw, projectGlobalOnlyUsageKeys, projectSecurityKeys, resolveGlobalConfigDir, saveConfigScoped, stripProjectServerKeys, warnUnknownConfigKeys, };

package/dist/core/loop/compaction.d.ts

@@ -27,5 +27,6 @@ export declare function recoverFromOverflow(state: AgentState, deps: LoopDeps):
  *    死锁在下一轮用户输入（agentLoop 重入）时重置。
  *  - mid-turn：midTurnEnabled 单独 opt-in（默认关闭）时按 enabled:true 阈值静默压缩，
  *    复用 shouldCompact 逻辑但不发 error/warning，压缩后刷新内存消息视图。
- *  两者都静默消费 compactContext 的 text_delta 通知（不透传给用户）。 */
+ *  两者都静默消费 compactContext 的 text_delta 通知，但把 compaction_done 透传给前端，
+ *  让用户在上下文被改写时得到提示（可在归档面板查看原始内容）。 */
 export declare function runCompactionIfNeeded(state: AgentState, deps: LoopDeps, latestMessages: Message[]): AsyncGenerator<AgentEvent>;