c0de-agent 1.10.0 → 1.11.0

package/README.md

@@ -13,7 +13,8 @@
 - **无感知热更新**：后台定期检查新版本，序列化当前会话 → npm 自更新 → 端口 handoff 接管，用户无感升级。
 - **Web 搜索**：内置 websearch 工具，支持多搜索引擎。
 - **斜杠命令**：`/compact`、`/model`、`/clear` 等可配置的斜杠命令。
-- **主题与多语言**：亮/暗主题，简体中文 / English。
+- **会话回收站**：删除会话软删除入回收站，30 天内可恢复。
+- **主题**：亮/暗/跟随系统主题。
 
 ## 安装
 
@@ -29,9 +30,11 @@ pnpm add -g c0de-agent
 
 ## 安全
 
-- **认证**：`security.authEnabled` 默认开启。首次启动自动生成认证 token（持久化于数据目录 `auth-token` 文件），浏览器访问时经启动打印的 URL `?token=` 参数自动保存到 localStorage 并从地址栏移除；后续 API 请求与终端 WebSocket 均携带该 token，服务端校验不通过返回 401。
+- **认证**：`security.authEnabled` 默认开启。首次启动自动生成 bootstrap token（持久化于数据目录 `auth-token` 文件），浏览器首访凭启动打印的 URL `?token=` 注册为**首台设备**，服务端随即**轮换 bootstrap token**（旧 token 立即失效，杜绝 URL/shell 历史泄漏）并下发设备 token；后续 API 请求与终端 WebSocket 均携带设备 token。新增设备无 token 时进入**配对流程**：新设备生成 6 位配对码，由已授权设备在「设备配对」弹窗中核对并批准后下发新设备 token。显式配置 `security.token` 时为静态模式（不轮换、不配对，适合 CI/脚本）。
   - token 解析优先级：`security.token` 配置 > 环境变量 `C0DE_AUTH_TOKEN` > 数据目录 token 文件 > 自动生成并持久化。
   - 显式关闭：`security.authEnabled: false`（本机单用户且端口仅本机可达时）。
+  - **设备管理**：`c0de auth list` 列出已授权设备；`c0de auth revoke <id>` 撤销设备（运行中的服务立即生效）；`c0de auth reset` 清除全部设备与 token。运行中的服务会热加载 `devices.json` 的变更。
+  - **丢失唯一设备的恢复**：若唯一设备的浏览器数据被清空（设备 token 丢失），配对流程因无已授权设备可批准而无法完成。恢复步骤：`c0de auth reset` → 重启 `c0de serve` → 打开启动日志打印的带 `?token=` 的 URL 重新注册首台设备。
 - **CORS/Origin 校验**：仅放行本机回环 origin 与 `security.allowedOrigins` 中显式配置的 origin；WebSocket 升级在服务端独立校验 Origin（浏览器 WS 不受 CORS 约束）。
 - **监听地址**：默认绑定 `0.0.0.0`（便于容器/远程访问），安全性由 token + allowedOrigins 保证；需要时可用 `security.allowedOrigins` 收紧或自行反向代理限制。
 - **热更新交接**：新实例经环境变量继承 token，请求旧实例 `/handoff` 时须携带匹配的 Bearer token，防止任意本地进程借 handoff 杀掉服务。

package/dist/cli/commands/acp.js

@@ -1,5 +1,5 @@
 import readline from 'node:readline/promises';
-import { createSession, listSessions } from '../../session/session.js';
+import { createSession, listAllSessions } from '../../session/session.js';
 import { formatACPEvent, runAcpLoop } from '../modes/acp.js';
 import { runPrintMode } from '../modes/print.js';
 /** 构造 ACP method → handler 映射。chat 复用 Print 模式。 */
@@ -7,11 +7,11 @@ function createAcpHandlers(config, deps, opts) {
     return {
         'session/create': async (params) => {
             const title = params.title ?? 'acp-session';
-            const session = await createSession(deps.db, title);
+            const session = await createSession(deps.db, title, undefined, undefined, 'cli');
             return { sessionId: session.id };
         },
         'session/list': async () => {
-            const sessions = await listSessions(deps.db);
+            const sessions = await listAllSessions(deps.db);
             return { sessions };
         },
         chat: async (params) => {

package/dist/cli/commands/auth.d.ts

@@ -0,0 +1,17 @@
+import type { CommandArgs } from '../parser.js';
+type DeviceRecord = {
+    id: string;
+    name: string;
+    tokenHash: string;
+    createdAt: number;
+};
+type AuthCommandContext = {
+    args: CommandArgs;
+    write?: (s: string) => void;
+};
+declare function devicesPath(): string;
+declare function readDevices(): DeviceRecord[];
+declare function writeDevices(devices: DeviceRecord[]): void;
+declare function runAuthCommand(ctx: AuthCommandContext): Promise<void>;
+export type { AuthCommandContext };
+export { devicesPath, readDevices, runAuthCommand, writeDevices };

package/dist/cli/commands/auth.js

@@ -0,0 +1,73 @@
+// src/cli/commands/auth.ts — 设备管理与认证恢复（P1-4/P2-5）。
+//
+// 本地终端是可信信道：唯一设备丢失（浏览器数据清空）导致配对死锁时，
+// 用户可通过 `c0de auth reset` 清除设备注册表，重启 serve 后用启动日志
+// 打印的带 token URL 重新注册首台设备。
+// 运行中的 serve 通过 authManager 的 devices.json watcher 热加载 revoke/reset 变更。
+import { existsSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { resolveDbDir } from '../../server/server.js';
+function devicesPath() {
+    return join(resolveDbDir(), 'devices.json');
+}
+function authTokenPath() {
+    return join(resolveDbDir(), 'auth-token');
+}
+function readDevices() {
+    try {
+        if (!existsSync(devicesPath()))
+            return [];
+        const raw = JSON.parse(readFileSync(devicesPath(), 'utf-8'));
+        return Array.isArray(raw.devices) ? raw.devices : [];
+    }
+    catch {
+        throw new Error('auth: 无法读取设备注册表（devices.json 损坏？）');
+    }
+}
+function writeDevices(devices) {
+    const file = { version: 1, devices };
+    writeFileSync(devicesPath(), JSON.stringify(file, null, 2), 'utf-8');
+}
+async function runAuthCommand(ctx) {
+    const write = ctx.write ?? ((s) => process.stdout.write(s));
+    const sub = ctx.args.positionals[0] ?? 'list';
+    if (sub === 'list') {
+        const devices = readDevices();
+        if (devices.length === 0) {
+            write('无已授权设备。\n');
+            return;
+        }
+        for (const d of devices) {
+            write(`- ${d.name}  (id: ${d.id}, 注册于 ${new Date(d.createdAt).toISOString()})\n`);
+        }
+        return;
+    }
+    if (sub === 'revoke') {
+        const id = ctx.args.positionals[1];
+        if (!id)
+            throw new Error('auth revoke: a device id is required (use `c0de auth list`)');
+        const devices = readDevices();
+        const target = devices.find((d) => d.id === id);
+        if (!target)
+            throw new Error(`auth revoke: device not found: ${id}`);
+        writeDevices(devices.filter((d) => d.id !== id));
+        write(`已撤销设备 "${target.name}"（${id}）。运行中的 serve 将立即生效。\n`);
+        return;
+    }
+    if (sub === 'reset') {
+        // 清除设备注册表 + bootstrap：恢复到「未注册」状态。
+        // 运行中的 serve 经 watcher 热清空内存设备；bootstrap 在重启后重新生成并打印。
+        try {
+            rmSync(devicesPath(), { force: true });
+            rmSync(authTokenPath(), { force: true });
+        }
+        catch (err) {
+            throw new Error(`auth reset: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        write('已清除全部已授权设备与认证 token。\n');
+        write('恢复步骤：重启 c0de serve，然后打开启动日志中打印的带 ?token= 的 URL 注册首台设备。\n');
+        return;
+    }
+    throw new Error(`auth: unknown subcommand "${sub}" (expected list|revoke|reset)`);
+}
+export { devicesPath, readDevices, runAuthCommand, writeDevices };

package/dist/cli/commands/chat.js

@@ -16,6 +16,14 @@ async function runChatCommand(ctx) {
                 err(`[tool] ${e.tool}\n`);
             else if (e._tag === 'thinking')
                 err(`[thinking] ${e.text}\n`);
+            else if (e._tag === 'tool_call_end') {
+                // P2-17：非交互模式被拒绝的工具调用，把拒绝原因直接可见地输出给用户
+                //（拒绝原因本身含 -y / serve 指引），而不是只留给模型转述。
+                const result = e.result;
+                if (result?._tag === 'deny') {
+                    err(`[tool] 工具调用已拒绝：${result.reason ?? '需要确认'}\n`);
+                }
+            }
         },
     });
     if (format === 'json') {

package/dist/cli/commands/config.d.ts

@@ -1,17 +1,10 @@
+import { coerce, getByPath, setPathPatch } from '../../core/config-path.js';
 import type { CommandArgs } from '../parser.js';
 type ConfigCommandContext = {
     args: CommandArgs;
     cwd: string;
     write?: (s: string) => void;
 };
-/** 按 a.b.c 点路径从对象取值；找不到抛错。 */
-declare function getByPath(obj: unknown, path: string): unknown;
-/** 按 a.b.c 点路径写值（创建中间对象）。 */
-declare function setByPath(obj: Record<string, unknown>, path: string, value: unknown): void;
-/** 把字符串解析为合适的标量类型。 */
-declare function coerce(value: string): unknown;
-/** 构造 a.b.c → { a: { b: { c: value } } } 的 patch 对象。 */
-declare function setPathPatch(path: string, value: unknown): Record<string, unknown>;
 declare function runConfigCommand(ctx: ConfigCommandContext): Promise<void>;
 export type { ConfigCommandContext };
-export { coerce, getByPath, runConfigCommand, setByPath, setPathPatch };
+export { coerce, getByPath, runConfigCommand, setPathPatch };

package/dist/cli/commands/config.js

@@ -1,50 +1,5 @@
-import { loadConfigScopes, mergeConfig, mergeRaw, saveConfigScoped, } from '../../core/config.js';
-/** 按 a.b.c 点路径从对象取值；找不到抛错。 */
-function getByPath(obj, path) {
-    const parts = path.split('.');
-    let cur = obj;
-    for (const p of parts) {
-        if (cur === null || typeof cur !== 'object')
-            throw new Error(`config: key "${path}" not found`);
-        cur = cur[p];
-        if (cur === undefined)
-            throw new Error(`config: key "${path}" not found`);
-    }
-    return cur;
-}
-/** 按 a.b.c 点路径写值（创建中间对象）。 */
-function setByPath(obj, path, value) {
-    const parts = path.split('.');
-    let cur = obj;
-    for (let i = 0; i < parts.length - 1; i++) {
-        const k = parts[i];
-        const next = cur[k];
-        cur[k] = (next !== null && typeof next === 'object' ? next : {});
-        cur = cur[k];
-    }
-    cur[parts[parts.length - 1]] = value;
-}
-/** 把字符串解析为合适的标量类型。 */
-function coerce(value) {
-    if (value === 'true')
-        return true;
-    if (value === 'false')
-        return false;
-    if (/^-?\d+(\.\d+)?$/.test(value))
-        return Number(value);
-    try {
-        return JSON.parse(value);
-    }
-    catch {
-        return value;
-    }
-}
-/** 构造 a.b.c → { a: { b: { c: value } } } 的 patch 对象。 */
-function setPathPatch(path, value) {
-    const root = {};
-    setByPath(root, path, value);
-    return root;
-}
+import { applyScopedPatch, loadConfigScopes, mergeConfig, saveConfigScoped, } from '../../core/config.js';
+import { coerce, getByPath, setPathPatch } from '../../core/config-path.js';
 async function runConfigCommand(ctx) {
     const write = ctx.write ?? process.stdout.write.bind(process.stdout);
     const sub = ctx.args.positionals[0];
@@ -63,19 +18,21 @@ async function runConfigCommand(ctx) {
     }
     if (sub === 'set') {
         const key = ctx.args.positionals[1];
-        const rawValue = ctx.args.positionals[2];
+        const rawArg = ctx.args.positionals[2];
         if (!key)
             throw new Error('config set: a key is required');
-        if (rawValue === undefined)
+        if (rawArg === undefined)
             throw new Error('config set: a value is required');
         const scope = ctx.args.options.global ? 'global' : 'project';
         // 只把 patch 合并进目标作用域的原始文件，不写入默认值与其他作用域的配置（P2-3）。
+        // 值为 null → 删除该键（作用域内取消覆盖，回落另一作用域/默认值）。
         const scopeCfg = scope === 'global' ? scopes.global : scopes.project;
-        const next = mergeRaw(scopeCfg ?? {}, setPathPatch(key, coerce(rawValue)));
+        const value = coerce(rawArg);
+        const next = applyScopedPatch(scopeCfg ?? {}, setPathPatch(key, value));
         await saveConfigScoped(scope, ctx.cwd, next);
-        write(`Set ${key} (scope: ${scope})\n`);
+        write(`${value === null ? 'Unset' : 'Set'} ${key} (scope: ${scope})\n`);
         return;
     }
     throw new Error(`config: unknown subcommand "${sub ?? ''}" (expected get|set)`);
 }
-export { coerce, getByPath, runConfigCommand, setByPath, setPathPatch };
+export { coerce, getByPath, runConfigCommand, setPathPatch };

package/dist/cli/commands/init.js

@@ -1,6 +1,6 @@
 import { existsSync } from 'node:fs';
 import { join } from 'node:path';
-import { DEFAULT_CONFIG, saveConfig } from '../../core/config.js';
+import { saveConfigScoped } from '../../core/config.js';
 async function runInitCommand(ctx) {
     const log = ctx.log ?? process.stdout.write.bind(process.stdout);
     const force = ctx.args.options.force ?? false;
@@ -8,7 +8,9 @@ async function runInitCommand(ctx) {
     if (existsSync(path) && !force) {
         throw new Error(`init: config already exists at ${path} (use --force to overwrite)`);
     }
-    await saveConfig(DEFAULT_CONFIG, 'project', ctx.cwd);
+    // P1-3：只写空配置——写入 DEFAULT_CONFIG 会把 providers: [] 等默认值固化进项目文件，
+    // 数组整体替换语义会覆盖全局 providers，使项目内 AI 服务失效。
+    await saveConfigScoped('project', ctx.cwd, {});
     log(`Created ${path}\n`);
 }
 export { runInitCommand };

package/dist/cli/commands/plugin.js

@@ -1,4 +1,4 @@
-import { loadConfig, saveConfig } from '../../core/config.js';
+import { applyScopedPatch, loadConfigScopes, mergeConfig } from '../../core/config.js';
 async function runPluginCommand(ctx) {
     const write = ctx.write ?? process.stdout.write.bind(process.stdout);
     const discover = ctx.discover ?? (async () => []);
@@ -18,11 +18,15 @@ async function runPluginCommand(ctx) {
         const name = ctx.args.positionals[1];
         if (!name)
             throw new Error('plugin install: a plugin name is required');
-        const config = await loadConfig(ctx.cwd);
-        const enabled = config.plugins.enabled;
+        // P1-2：只把 plugins.enabled 合并进 project 作用域文件，不整体落盘
+        //（saveConfig 全量写入会把默认值与全局配置固化进项目文件）。
+        const scopes = loadConfigScopes(ctx.cwd);
+        const enabled = [...(mergeConfig(scopes.global, scopes.project).plugins?.enabled ?? [])];
         if (!enabled.includes(name))
             enabled.push(name);
-        await saveConfig(config, 'project', ctx.cwd);
+        const next = applyScopedPatch(scopes.project ?? {}, { plugins: { enabled } });
+        const { saveConfigScoped } = await import('../../core/config.js');
+        await saveConfigScoped('project', ctx.cwd, next);
         write(`Enabled plugin "${name}".\n`);
         return;
     }

package/dist/cli/commands/sessions.d.ts

@@ -0,0 +1,10 @@
+import type { DB } from '../../db/client.js';
+import type { CommandArgs } from '../parser.js';
+type SessionsCommandContext = {
+    args: CommandArgs;
+    db: DB;
+    write?: (s: string) => void;
+};
+declare function runSessionsCommand(ctx: SessionsCommandContext): Promise<void>;
+export type { SessionsCommandContext };
+export { runSessionsCommand };

package/dist/cli/commands/sessions.js

@@ -0,0 +1,35 @@
+// src/cli/commands/sessions.ts — CLI 会话管理（P3：清理 print 模式积累的 CLI 会话）。
+//
+// c0de chat 每次运行都创建 source='cli' 会话且被 Web 会话树排除，
+// 此前无任何 CLI 途径列出/清理，垃圾数据只增不减。
+// 复用 withAgentDeps 的持久库生命周期（serve 占用时退化为内存库则明确报错）。
+import { listAllSessions, softDeleteSession } from '../../session/session.js';
+async function runSessionsCommand(ctx) {
+    const write = ctx.write ?? ((s) => process.stdout.write(s));
+    const sub = ctx.args.positionals[0] ?? 'list';
+    if (sub === 'list') {
+        const sessions = await listAllSessions(ctx.db);
+        if (sessions.length === 0) {
+            write('无会话。\n');
+            return;
+        }
+        for (const s of sessions) {
+            const source = s.source === 'cli' ? 'cli' : 'web';
+            const when = new Date(s.updatedAt).toISOString();
+            write(`- [${source}] ${s.title}  (id: ${s.id}, updated ${when})\n`);
+        }
+        return;
+    }
+    if (sub === 'delete') {
+        const id = ctx.args.positionals[1];
+        if (!id)
+            throw new Error('sessions delete: a session id is required (use `c0de sessions list`)');
+        const ok = await softDeleteSession(ctx.db, id);
+        if (!ok)
+            throw new Error(`sessions delete: session not found or already deleted: ${id}`);
+        write(`已删除会话 ${id}（移入回收站，30 天内可恢复）。\n`);
+        return;
+    }
+    throw new Error(`sessions: unknown subcommand "${sub}" (expected list|delete)`);
+}
+export { runSessionsCommand };

package/dist/cli/commands/update.js

@@ -1,4 +1,4 @@
-import { checkForUpdate, performHotUpdate, serializeSessions, } from '../../update/index.js';
+import { checkForUpdate, performHotUpdate, performInstall, serializeSessions, } from '../../update/index.js';
 /**
  * `c0de update`：检查 npm registry 新版本。
  * - 默认：check-only，报告有无更新。
@@ -19,16 +19,24 @@ async function runUpdateCommand(ctx) {
         out(`发现新版本 ${result.latestVersion}。加 --apply 执行热更新。`);
         return;
     }
+    // P2-7：无 db（独立 CLI，无活跃 serve）→ 仅安装，不 spawn `serve`。
+    // 此前会拉起一个用户未请求的常驻服务；活跃 serve 的热更新走 /api/update/apply。
+    if (!ctx.db) {
+        out(`发现新版本 ${result.latestVersion}，开始安装…`);
+        const r = await performInstall(ctx.updateOpts);
+        if (r._tag === 'success') {
+            out('安装完成。若 c0de serve 正在运行，请在页面顶部的更新横幅中应用热更新，或重启 serve。');
+        }
+        else if (r._tag === 'install_failed') {
+            out(`安装失败：${r.error}`);
+        }
+        else {
+            out(`无法自动安装（${r.error}）。请手动执行：${r.command}`);
+        }
+        return;
+    }
     out(`发现新版本 ${result.latestVersion}，开始热更新…`);
-    const snapshot = ctx.db
-        ? await serializeSessions(ctx.db, ctx.config)
-        : {
-            version: result.currentVersion,
-            sessions: [],
-            entries: [],
-            config: ctx.config ?? null,
-            timestamp: Date.now(),
-        };
+    const snapshot = await serializeSessions(ctx.db, ctx.config);
     const r = await performHotUpdate(snapshot, ctx.updateOpts);
     if (r._tag === 'success') {
         out(`热更新完成，快照写入 ${r.snapshotPath}。新实例将接管。`);

package/dist/cli/index.js

@@ -6,11 +6,13 @@ import { loadConfig } from '../core/config.js';
 import { createDB, migrateDB } from '../db/index.js';
 import { acquireDevDbLock, releaseDevDbLock, resolveDbDir } from '../server/server.js';
 import { runAcpCommand } from './commands/acp.js';
+import { runAuthCommand } from './commands/auth.js';
 import { runChatCommand } from './commands/chat.js';
 import { runConfigCommand } from './commands/config.js';
 import { runInitCommand } from './commands/init.js';
 import { runPluginCommand } from './commands/plugin.js';
 import { runServeCommand } from './commands/serve.js';
+import { runSessionsCommand } from './commands/sessions.js';
 import { runUpdateCommand } from './commands/update.js';
 import { buildAgentDeps } from './deps.js';
 import { parseCommand } from './parser.js';
@@ -50,6 +52,16 @@ const COMMANDS = [
         description: 'List or enable plugins.',
         options: [],
     },
+    {
+        name: 'auth',
+        description: 'Manage authorized devices (list / revoke / reset).',
+        options: [],
+    },
+    {
+        name: 'sessions',
+        description: 'Manage CLI/web sessions (list / delete).',
+        options: [],
+    },
     {
         name: 'acp',
         description: 'Run in Agent Client Protocol mode (editor integration).',
@@ -96,11 +108,15 @@ async function withAgentDeps(cwd, opts, fn) {
         holdLock = false;
         if (!isDbLockConflict(err))
             throw err;
+        if (opts.requirePersistent) {
+            throw new Error('c0de serve 正在运行并占用会话库。请通过 Web UI 管理会话，或停止 serve 后重试。');
+        }
         if (opts.continueSessionId) {
             throw new Error(`无法续聊会话 ${opts.continueSessionId}：持久库被 c0de serve 占用，内存模式无法续聊。\n` +
                 `请停止 serve 后重试，或去掉 --continue 开启新会话。`);
         }
-        process.stderr.write('[c0de] c0de serve 正在运行，本次会话不持久化（内存模式）\n');
+        process.stderr.write('[c0de] ⚠ c0de serve 正在运行：本次对话为临时模式，消息与工具调用不会保存。\n' +
+            '       停止 serve 后重试可持久化，或直接使用浏览器界面。\n');
         db = await createDB({ driver: 'pglite' });
         await migrateDB(db);
     }
@@ -139,7 +155,10 @@ async function dispatch(argv, overrides = {}) {
             // --yes / -y 显式放行写操作；否则按 config.permission.defaultMode 决定（默认 safe）。
             const strategy = args.options.yes ? 'full-auto' : undefined;
             const continueId = args.options.continue;
-            await withAgentDeps(cwd, { ...(strategy ? { strategy } : {}), ...(continueId ? { continueSessionId: continueId } : {}) }, (config, deps) => runChatCommand({ args, config, deps }));
+            await withAgentDeps(cwd, {
+                ...(strategy ? { strategy } : {}),
+                ...(continueId ? { continueSessionId: continueId } : {}),
+            }, (config, deps) => runChatCommand({ args, config, deps }));
             return;
         }
         case 'init': {
@@ -154,6 +173,15 @@ async function dispatch(argv, overrides = {}) {
             await runPluginCommand({ args, cwd });
             return;
         }
+        case 'auth': {
+            await runAuthCommand({ args });
+            return;
+        }
+        case 'sessions': {
+            // 需要持久库列出/清理会话；serve 运行时内存库不含数据，直接失败而不是列空表。
+            await withAgentDeps(cwd, { requirePersistent: true }, (_config, deps) => runSessionsCommand({ args, db: deps.db }));
+            return;
+        }
         case 'acp': {
             // ACP 非交互：所有工具放行（编辑器侧自行控制执行授权）。
             await withAgentDeps(cwd, { strategy: 'full-auto' }, (config, deps) => runAcpCommand({ config, deps }));

package/dist/cli/modes/print.js

@@ -1,4 +1,5 @@
 import { 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';
 /** 从事件流累积 assistant 文本。纯函数。 */
@@ -26,7 +27,7 @@ async function runPrintMode(config, message, deps, opts = {}) {
         session = existing;
     }
     else {
-        session = await createSession(deps.db, 'cli-print');
+        session = await createSession(deps.db, 'cli-print', undefined, undefined, 'cli');
     }
     const agentConfig = {
         provider: config.defaultProvider,
@@ -36,6 +37,15 @@ async function runPrintMode(config, message, deps, opts = {}) {
         plugins: config.plugins.enabled,
         ...(opts.maxTokens !== undefined ? { maxTokens: opts.maxTokens } : {}),
     };
+    // P3：首跑友好报错——未配置 provider 时不再让底层 NoRoute 异常裸抛，
+    // 给出与 Web 端一致的引导（c0de serve → 设置 → Provider）。
+    try {
+        resolveRoute(deps.llmRegistry, agentConfig.provider, agentConfig.model);
+    }
+    catch {
+        throw new Error('未配置可用的 AI 服务。请运行 `c0de serve` 并在「设置 → Provider」中添加 API 服务并测试连接，' +
+            '或使用 `c0de config set` 配置 providers。');
+    }
     const state = await createAgent(session, agentConfig, deps);
     const events = [];
     for await (const event of runAgent(state, [{ _tag: 'text', text: message }], deps)) {

package/dist/core/config-path.d.ts

@@ -0,0 +1,9 @@
+/** 按 a.b.c 点路径从对象取值；找不到抛错。 */
+declare function getByPath(obj: unknown, path: string): unknown;
+/** 按 a.b.c 点路径写值（创建中间对象）。 */
+declare function setByPath(obj: Record<string, unknown>, path: string, value: unknown): void;
+/** 把字符串解析为合适的标量类型。 */
+declare function coerce(value: string): unknown;
+/** 构造 a.b.c → { a: { b: { c: value } } } 的 patch 对象。 */
+declare function setPathPatch(path: string, value: unknown): Record<string, unknown>;
+export { coerce, getByPath, setByPath, setPathPatch };

package/dist/core/config-path.js

@@ -0,0 +1,48 @@
+// 配置点路径（a.b.c）读写工具：CLI `config set/get` 与斜杠 `/config` 共用。
+/** 按 a.b.c 点路径从对象取值；找不到抛错。 */
+function getByPath(obj, path) {
+    const parts = path.split('.');
+    let cur = obj;
+    for (const p of parts) {
+        if (cur === null || typeof cur !== 'object')
+            throw new Error(`config: key "${path}" not found`);
+        cur = cur[p];
+        if (cur === undefined)
+            throw new Error(`config: key "${path}" not found`);
+    }
+    return cur;
+}
+/** 按 a.b.c 点路径写值（创建中间对象）。 */
+function setByPath(obj, path, value) {
+    const parts = path.split('.');
+    let cur = obj;
+    for (let i = 0; i < parts.length - 1; i++) {
+        const k = parts[i];
+        const next = cur[k];
+        cur[k] = (next !== null && typeof next === 'object' ? next : {});
+        cur = cur[k];
+    }
+    cur[parts[parts.length - 1]] = value;
+}
+/** 把字符串解析为合适的标量类型。 */
+function coerce(value) {
+    if (value === 'true')
+        return true;
+    if (value === 'false')
+        return false;
+    if (/^-?\d+(\.\d+)?$/.test(value))
+        return Number(value);
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return value;
+    }
+}
+/** 构造 a.b.c → { a: { b: { c: value } } } 的 patch 对象。 */
+function setPathPatch(path, value) {
+    const root = {};
+    setByPath(root, path, value);
+    return root;
+}
+export { coerce, getByPath, setByPath, setPathPatch };

package/dist/core/config.d.ts

@@ -10,6 +10,15 @@ declare function loadConfigScopes(projectDir?: string): {
     global: Partial<Config> | undefined;
     project: Partial<Config> | undefined;
 };
+/**
+ * 把 patch 应用到某个作用域的原始配置（scoped patch，null=删除）：
+ * - 深合并：嵌套普通对象递归合并，数组整体替换（providers 等列表语义）；
+ * - 值为 undefined 的键跳过；
+ * - 值为 null 的键从结果中**删除**——作用域内取消覆盖，回落到另一作用域/默认值。
+ *   Config 各字段均无合法的 null 值（可选字段用 undefined），null 作为「unset」标记是安全的。
+ * 不注入默认值。CLI config set / 服务端 PATCH /api/config 共用。
+ */
+declare function applyScopedPatch(base: Record<string, unknown> | undefined, patch: Record<string, unknown>): Record<string, unknown>;
 /**
  * 不注入默认值的深合并：仅合并传入对象的自有键。
  * 数组整体替换（providers 等列表语义）；嵌套普通对象递归合并。
@@ -19,6 +28,5 @@ declare function mergeRaw(...cfgs: (Record<string, unknown> | undefined)[]): Rec
 /** 把 raw JSON 写回指定作用域配置文件（不含默认值）。 */
 declare function saveConfigScoped(scope: 'global' | 'project', projectDir: string | undefined, data: Record<string, unknown>): Promise<void>;
 declare function loadConfig(projectDir?: string): Promise<Config>;
-declare function saveConfig(config: Config, scope: 'global' | 'project', projectDir?: string): Promise<void>;
 export type { AgentsConfig, CompactionConfig, Config, MCPServerConfig, PermissionConfig, SecurityConfig, ToolMetricsConfig, UpdateConfig, WebSearchConfig, };
-export { DEFAULT_CONFIG, loadConfig, loadConfigScopes, mergeConfig, mergeRaw, saveConfig, saveConfigScoped, };
+export { applyScopedPatch, DEFAULT_CONFIG, loadConfig, loadConfigScopes, mergeConfig, mergeRaw, saveConfigScoped, };

package/dist/core/config.js

@@ -78,6 +78,37 @@ function loadConfigScopes(projectDir) {
     const projectPath = join(projectDir ?? process.cwd(), '.c0de', CONFIG_FILENAME);
     return { global: readJsonIfExists(globalPath), project: readJsonIfExists(projectPath) };
 }
+/**
+ * 把 patch 应用到某个作用域的原始配置（scoped patch，null=删除）：
+ * - 深合并：嵌套普通对象递归合并，数组整体替换（providers 等列表语义）；
+ * - 值为 undefined 的键跳过；
+ * - 值为 null 的键从结果中**删除**——作用域内取消覆盖，回落到另一作用域/默认值。
+ *   Config 各字段均无合法的 null 值（可选字段用 undefined），null 作为「unset」标记是安全的。
+ * 不注入默认值。CLI config set / 服务端 PATCH /api/config 共用。
+ */
+function applyScopedPatch(base, patch) {
+    const result = { ...(base ?? {}) };
+    for (const [key, val] of Object.entries(patch)) {
+        if (val === undefined)
+            continue;
+        if (val === null) {
+            delete result[key];
+            continue;
+        }
+        const current = result[key];
+        if (typeof val === 'object' &&
+            !Array.isArray(val) &&
+            current !== null &&
+            typeof current === 'object' &&
+            !Array.isArray(current)) {
+            result[key] = applyScopedPatch(current, val);
+        }
+        else {
+            result[key] = val;
+        }
+    }
+    return result;
+}
 /**
  * 不注入默认值的深合并：仅合并传入对象的自有键。
  * 数组整体替换（providers 等列表语义）；嵌套普通对象递归合并。
@@ -124,13 +155,4 @@ async function loadConfig(projectDir) {
     const project = readJsonIfExists(projectPath);
     return mergeConfig(global, project);
 }
-async function saveConfig(config, scope, projectDir) {
-    const dir = scope === 'global'
-        ? join(homedir(), GLOBAL_CONFIG_DIR)
-        : join(projectDir ?? process.cwd(), '.c0de');
-    if (!existsSync(dir))
-        mkdirSync(dir, { recursive: true });
-    const path = join(dir, CONFIG_FILENAME);
-    writeFileSync(path, JSON.stringify(config, null, 2), 'utf-8');
-}
-export { DEFAULT_CONFIG, loadConfig, loadConfigScopes, mergeConfig, mergeRaw, saveConfig, saveConfigScoped, };
+export { applyScopedPatch, DEFAULT_CONFIG, loadConfig, loadConfigScopes, mergeConfig, mergeRaw, saveConfigScoped, };

package/dist/core/index.d.ts

@@ -1,7 +1,7 @@
 export { abortAgent, createAgent, getAgentStatus, isAgentPaused, pauseAgent, resumeAgent, runAgent, } from './agent.js';
 export { createSummarizer, runCompaction } from './compact.js';
 export type { CompactionConfig, Config, MCPServerConfig } from './config.js';
-export { DEFAULT_CONFIG, loadConfig, mergeConfig, saveConfig } from './config.js';
+export { DEFAULT_CONFIG, loadConfig, mergeConfig } from './config.js';
 export { calibrateEstimate, createTokenBudget, estimateBudget, fitToBudget, shouldCompact, } from './context.js';
 export { agentLoop } from './loop.js';
 export { buildSystemPrompt } from './prompt.js';