c0de-agent 1.9.0 → 1.11.0

package/README.md

@@ -8,12 +8,13 @@
 - **本地优先**：会话与索引存储在 PGLite（浏览器/进程内 PostgreSQL），数据随用随取。
 - **多项目**：工作区隔离的多项目管理，每个项目独立会话历史与配置。
 - **工具系统**：内置文件读写、bash、grep、glob、编辑等工具，可按需启用/禁用。
-- **权限模式**：`default` / `yolo` 等授权模式，控制工具执行前是否需用户确认。
+- **权限模式**：`default` / `auto` 等授权模式，控制工具执行前是否需用户确认。
 - **会话可恢复**：会话快照序列化/反序列化，支持进程重启后无缝恢复。
 - **无感知热更新**：后台定期检查新版本，序列化当前会话 → npm 自更新 → 端口 handoff 接管，用户无感升级。
 - **Web 搜索**：内置 websearch 工具，支持多搜索引擎。
 - **斜杠命令**：`/compact`、`/model`、`/clear` 等可配置的斜杠命令。
-- **主题与多语言**：亮/暗主题，简体中文 / English。
+- **会话回收站**：删除会话软删除入回收站，30 天内可恢复。
+- **主题**：亮/暗/跟随系统主题。
 
 ## 安装
 
@@ -27,6 +28,17 @@ pnpm add -g c0de-agent
 
 要求 Node.js >= 22.0.0。
 
+## 安全
+
+- **认证**：`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 杀掉服务。
+
 ## 使用
 
 ```bash
@@ -77,14 +89,19 @@ pnpm format
 
 ```
 src/
-├── cli/           # CLI 入口与命令（serve / chat / update）
-├── core/          # 配置、agent 注册、权限、工具注册
-├── llm/           # LLM provider 抽象与调用
-├── server/        # Hono HTTP 服务、SSE 流、路由、handoff
-├── session/       # 会话上下文与消息转换
+├── cli/           # CLI 入口与命令（serve / chat / acp / update / config / init / plugin）
+├── core/          # 配置、agent 注册与主循环（loop/ 子模块）、权限、prompt、工作流、斜杠命令
+├── llm/           # LLM provider 抽象、registry 与重试策略
+├── server/        # Hono HTTP 服务、SSE 流、路由、鉴权/CORS、交互式权限、终端（node-pty）
+├── session/       # 会话上下文、消息、compaction、branch/squash、快照
+├── project/       # 多项目解析与检测（.git、package.json 等）
+├── db/            # Drizzle schema 与迁移（PGLite）
+├── tools/         # 内置工具实现（read/write/edit/bash/grep/glob/todo/kanban/dap/websearch…）
+├── plugins/       # 插件系统（12 个生命周期钩子）
+├── dap/           # Debug Adapter Protocol 会话与协议编解码
 ├── shared/        # 前后端共享类型
-├── tools/         # 内置工具实现
 ├── update/        # 版本检查、热更新调度器、会话快照
+├── kanban/        # 看板状态存储
 └── web/           # React 前端（组件、视图、服务、hooks）
 ```
 

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,18 +7,20 @@ 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) => {
             const message = params.message;
             if (!message)
                 throw new Error('chat: message is required');
+            const sessionId = params.sessionId;
             const text = await runPrintMode(config, message, deps, {
+                ...(sessionId ? { sessionId } : {}),
                 onEvent: (e) => opts.onEvent('event', e),
             });
             return { text };

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

@@ -7,13 +7,23 @@ async function runChatCommand(ctx) {
     const err = ctx.stderr ?? process.stderr.write.bind(process.stderr);
     const format = ctx.args.options.format ?? 'text';
     const model = ctx.args.options.model;
+    const continueId = ctx.args.options.continue;
     const text = await runPrintMode(ctx.config, message, ctx.deps, {
         ...(model ? { model } : {}),
+        ...(continueId ? { sessionId: continueId } : {}),
         onEvent: (e) => {
             if (e._tag === 'tool_call_start')
                 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,54 +1,11 @@
-import { loadConfig, mergeConfig, saveConfig } 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];
-    const config = await loadConfig(ctx.cwd);
+    const scopes = loadConfigScopes(ctx.cwd);
+    // get 展示用合并视图（global ← project，含默认值），与 loadConfig 语义一致。
+    const config = mergeConfig(scopes.global, scopes.project);
     if (sub === 'get') {
         const key = ctx.args.positionals[1];
         if (!key) {
@@ -61,17 +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';
-        const merged = mergeConfig(config, setPathPatch(key, coerce(rawValue)));
-        await saveConfig(merged, scope, ctx.cwd);
-        write(`Set ${key} (scope: ${scope})\n`);
+        // 只把 patch 合并进目标作用域的原始文件，不写入默认值与其他作用域的配置（P2-3）。
+        // 值为 null → 删除该键（作用域内取消覆盖，回落另一作用域/默认值）。
+        const scopeCfg = scope === 'global' ? scopes.global : scopes.project;
+        const value = coerce(rawArg);
+        const next = applyScopedPatch(scopeCfg ?? {}, setPathPatch(key, value));
+        await saveConfigScoped(scope, ctx.cwd, next);
+        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/serve.d.ts

@@ -2,6 +2,7 @@ import type { StartServerOptions } from '../../server/index.js';
 import type { CommandArgs } from '../parser.js';
 type RunningHandle = {
     port: number;
+    authToken?: string;
     close(): Promise<void>;
 };
 type ServeCommandContext = {

package/dist/cli/commands/serve.js

@@ -12,7 +12,10 @@ async function runServeCommand(ctx) {
         ...(restore ? { restoreFrom: restore } : {}),
         ...(handoffPort ? { handoffPort } : {}),
     });
-    const url = `http://localhost:${handle.port}`;
+    // P0-3：认证 token（authEnabled 显式关闭时为 undefined）挂到 URL，
+    // 浏览器首访存入 localStorage 并从地址栏移除。
+    const tokenQuery = handle.authToken ? `?token=${encodeURIComponent(handle.authToken)}` : '';
+    const url = `http://localhost:${handle.port}${tokenQuery}`;
     (ctx.banner ?? printStartupBanner)(url);
     if (shouldOpen) {
         const opener = ctx.opener ?? ((u) => openBrowser(u));

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/deps.d.ts

@@ -9,10 +9,12 @@ import type { PermissionChecker } from '../tools/types.js';
 type PermissionStrategy = 'full-auto' | 'safe';
 /** 真正非交互模式（print/acp）：所有工具无条件放行（命令由用户显式触发）。 */
 declare const fullyAutoApproveChecker: PermissionChecker;
-/** 安全策略：只读工具（permission: 'auto'，如 read/grep/glob/websearch）自动放行；
- * 写/执行工具（permission: 'ask'，如 bash/write/edit）返回 ask 需确认；
- * permission: 'deny' 拒绝。复用 tools 层 autoAllowChecker（按工具自身声明的权限分级）。 */
-declare const readOnlySafeChecker: PermissionChecker;
+/**
+ * 非交互模式（print）安全策略（P1-6）：ask 工具**直接拒绝**并给出可操作提示
+ * （-y 或 serve），而非返回 permission_required 让 LLM 在无确认通道下无限重试。
+ * 拒绝原因作为 tool result 交给模型，模型会向用户转述。
+ */
+declare const nonInteractiveSafeChecker: PermissionChecker;
 /** 把 config.providers 注册到新建的 LLM registry。 */
 declare function buildLLMRegistry(config: Config): Registry;
 type BuildDepsOptions = {
@@ -27,4 +29,4 @@ type BuildDepsOptions = {
 /** 组装完整 LoopDeps（默认 safe 放行 + 默认工具注册表）。 */
 declare function buildAgentDeps(config: Config, opts: BuildDepsOptions): Promise<LoopDeps>;
 export type { BuildDepsOptions, PermissionStrategy };
-export { buildAgentDeps, buildLLMRegistry, fullyAutoApproveChecker, readOnlySafeChecker };
+export { buildAgentDeps, buildLLMRegistry, fullyAutoApproveChecker, nonInteractiveSafeChecker };

package/dist/cli/deps.js

@@ -10,10 +10,24 @@ const fullyAutoApproveChecker = {
     },
     confirm: (_toolCallId, _approved) => { },
 };
-/** 安全策略：只读工具（permission: 'auto'，如 read/grep/glob/websearch）自动放行；
- * 写/执行工具（permission: 'ask'，如 bash/write/edit）返回 ask 需确认；
- * permission: 'deny' 拒绝。复用 tools 层 autoAllowChecker（按工具自身声明的权限分级）。 */
-const readOnlySafeChecker = autoAllowChecker;
+/**
+ * 非交互模式（print）安全策略（P1-6）：ask 工具**直接拒绝**并给出可操作提示
+ * （-y 或 serve），而非返回 permission_required 让 LLM 在无确认通道下无限重试。
+ * 拒绝原因作为 tool result 交给模型，模型会向用户转述。
+ */
+const nonInteractiveSafeChecker = {
+    check: async (tool, _input, _ctx) => {
+        const result = await autoAllowChecker.check(tool, _input, _ctx);
+        if (result._tag === 'ask') {
+            return {
+                _tag: 'deny',
+                reason: `非交互模式：工具 "${tool.name}" 需要确认。请加 -y 放行写操作，或使用 c0de serve 交互确认`,
+            };
+        }
+        return result;
+    },
+    confirm: autoAllowChecker.confirm,
+};
 /** 把 config.providers 注册到新建的 LLM registry。 */
 function buildLLMRegistry(config) {
     const registry = createRegistry();
@@ -44,8 +58,10 @@ function resolvePermissionChecker(config, strategy) {
     if (strategy === 'full-auto')
         return fullyAutoApproveChecker;
     if (strategy === 'safe')
-        return readOnlySafeChecker;
-    return config.permission.defaultMode === 'auto' ? fullyAutoApproveChecker : readOnlySafeChecker;
+        return nonInteractiveSafeChecker;
+    return config.permission.defaultMode === 'auto'
+        ? fullyAutoApproveChecker
+        : nonInteractiveSafeChecker;
 }
 /** 组装完整 LoopDeps（默认 safe 放行 + 默认工具注册表）。 */
 async function buildAgentDeps(config, opts) {
@@ -70,4 +86,4 @@ async function buildAgentDeps(config, opts) {
     };
     return deps;
 }
-export { buildAgentDeps, buildLLMRegistry, fullyAutoApproveChecker, readOnlySafeChecker };
+export { buildAgentDeps, buildLLMRegistry, fullyAutoApproveChecker, nonInteractiveSafeChecker };

package/dist/cli/index.d.ts

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import type { CommandSpec } from './parser.js';
+import { type CommandSpec } from './parser.js';
 declare const COMMANDS: CommandSpec[];
 type DispatchOverrides = {
     runServe?: () => Promise<void>;