chatccc 0.2.185 → 0.2.187

package/agent-prompts/cursor_specific.md

@@ -1,3 +1,14 @@
 ## 计划/问答模式权限规则
 
-如果用户消息以 `/plan` 或 `/ask` 开头，说明当前处于只读模式。**遇到任何需要用户同意的权限请求时，不要向用户申请权限，立即调用 stop-stuck-loop 接口提前结束本轮会话。**
+如果用户消息以 `/plan` 或 `/ask` 开头，说明当前处于只读模式。**遇到任何需要用户同意的权限请求时，不要向用户申请权限，立即调用 stop-stuck-loop 接口提前结束本轮会话。**
+
+## 用户问题澄清规则
+
+当需要在开始实现前向用户确认问题、让用户做选择，或用户要求“从第一性原理出发挖掘真实需求 / 判断需求是否合理 / 开始实现前有什么问题要问我”时，**不要调用 `AskQuestion`、多选表单或任何结构化选择工具**。
+
+必须直接用普通文本回复用户：
+
+- 先简要说明你理解到的真实需求和你对合理性的判断。
+- 再列出需要用户确认的问题；如果有推荐选项，就用文本说明“我建议 X，原因是 Y”。
+- 问题数量尽量少，只问会影响实现边界、风险或不可逆决策的问题。
+- 不要把这些问题放进工具调用参数里，也不要只在卡片/工具结果中呈现。

package/config.sample.json

@@ -15,6 +15,26 @@
   "port": 18080,
   "gitTimeoutSeconds": 180,
   "allowInterrupt": false,
+  "rawStreamLogs": {
+    "claude": {
+      "enabled": false,
+      "maxBytesPerTurn": 52428800,
+      "retentionDays": 7,
+      "keepCompleted": false
+    },
+    "cursor": {
+      "enabled": false,
+      "maxBytesPerTurn": 52428800,
+      "retentionDays": 7,
+      "keepCompleted": false
+    },
+    "codex": {
+      "enabled": false,
+      "maxBytesPerTurn": 52428800,
+      "retentionDays": 7,
+      "keepCompleted": false
+    }
+  },
   "claude": {
     "enabled": false,
     "defaultAgent": true,
@@ -30,6 +50,7 @@
     "defaultAgent": false,
     "path": "",
     "model": "",
+    "alternativeModel": "",
     "avatarBatteryMode": "apiPercent",
     "onDemandMonthlyBudget": 1000
   },
@@ -38,6 +59,7 @@
     "defaultAgent": false,
     "path": "",
     "model": "",
+    "alternativeModel": "",
     "effort": ""
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chatccc",
-  "version": "0.2.185",
+  "version": "0.2.187",
   "description": "Feishu bot bridge for Claude Code",
   "license": "Apache-2.0",
   "type": "module",

package/src/__tests__/config-reload.test.ts

@@ -22,6 +22,7 @@ import {
   ILINK_ENABLED,
   applyLoadedConfig,
   config,
+  getAllModelsForTool,
   resolveDefaultAgentTool,
   type AppConfig,
 } from "../config.ts";
@@ -44,6 +45,11 @@ const baseAppConfig: AppConfig = {
   port: 18080,
   gitTimeoutSeconds: 180,
   allowInterrupt: false,
+  rawStreamLogs: {
+    claude: { enabled: false, maxBytesPerTurn: 52_428_800, retentionDays: 7, keepCompleted: false },
+    cursor: { enabled: false, maxBytesPerTurn: 52_428_800, retentionDays: 7, keepCompleted: false },
+    codex: { enabled: false, maxBytesPerTurn: 52_428_800, retentionDays: 7, keepCompleted: false },
+  },
   claude: {
     enabled: true,
     defaultAgent: true,
@@ -59,10 +65,11 @@ const baseAppConfig: AppConfig = {
     defaultAgent: false,
     path: "/initial/cursor",
     model: "initial-cursor-model",
+    alternativeModel: "initial-cursor-alt-model",
     avatarBatteryMode: "apiPercent",
     onDemandMonthlyBudget: 1000,
   },
-  codex: { enabled: true, defaultAgent: false, path: "/initial/codex", model: "initial-codex-model", effort: "initial-codex-effort" },
+  codex: { enabled: true, defaultAgent: false, path: "/initial/codex", model: "initial-codex-model", alternativeModel: "initial-codex-alt-model", effort: "initial-codex-effort" },
 };
 
 // 把 module 状态抢救快照：每个 it 跑前重置回这个状态，避免污染相邻测试。
@@ -140,7 +147,7 @@ describe("applyLoadedConfig — 刷新 export let 常量", () => {
   it("CURSOR_AGENT_ARGS 跟随 cursor.model 重新解析", () => {
     applyLoadedConfig({
       ...structuredClone(baseAppConfig),
-      cursor: { enabled: true, defaultAgent: false, path: "/x/cursor", model: "claude-3.7-sonnet", avatarBatteryMode: "apiPercent", onDemandMonthlyBudget: 1000 },
+      cursor: { enabled: true, defaultAgent: false, path: "/x/cursor", model: "claude-3.7-sonnet", alternativeModel: "", avatarBatteryMode: "apiPercent", onDemandMonthlyBudget: 1000 },
     });
 
     // CURSOR_AGENT_ARGS 是 ['-p', '--force', '--approve-mcps', ..., '--model', 'claude-3.7-sonnet']
@@ -152,7 +159,7 @@ describe("applyLoadedConfig — 刷新 export let 常量", () => {
   it("cursor.model 留空时 CURSOR_AGENT_ARGS 不含 --model", () => {
     applyLoadedConfig({
       ...structuredClone(baseAppConfig),
-      cursor: { enabled: true, defaultAgent: false, path: "/x/cursor", model: "", avatarBatteryMode: "apiPercent", onDemandMonthlyBudget: 1000 },
+      cursor: { enabled: true, defaultAgent: false, path: "/x/cursor", model: "", alternativeModel: "", avatarBatteryMode: "apiPercent", onDemandMonthlyBudget: 1000 },
     });
 
     expect(CURSOR_AGENT_ARGS).not.toContain("--model");
@@ -161,12 +168,23 @@ describe("applyLoadedConfig — 刷新 export let 常量", () => {
   it("CURSOR_AGENT_COMMAND 优先取 config.cursor.path", () => {
     applyLoadedConfig({
       ...structuredClone(baseAppConfig),
-      cursor: { enabled: true, defaultAgent: false, path: "C:/custom/cursor.exe", model: "", avatarBatteryMode: "apiPercent", onDemandMonthlyBudget: 1000 },
+      cursor: { enabled: true, defaultAgent: false, path: "C:/custom/cursor.exe", model: "", alternativeModel: "", avatarBatteryMode: "apiPercent", onDemandMonthlyBudget: 1000 },
     });
 
     expect(CURSOR_AGENT_COMMAND).toBe("C:/custom/cursor.exe");
   });
 
+  it("/model 候选列表包含 Cursor/Codex 的单个备选模型并保持主模型优先", () => {
+    const cfg = structuredClone(baseAppConfig);
+    cfg.cursor.model = "cursor-main";
+    cfg.cursor.alternativeModel = "cursor-alt";
+    cfg.codex.model = "codex-main";
+    cfg.codex.alternativeModel = "codex-main";
+
+    expect(getAllModelsForTool("cursor", cfg)).toEqual(["cursor-main", "cursor-alt"]);
+    expect(getAllModelsForTool("codex", cfg)).toEqual(["codex-main"]);
+  });
+
   it("不修改 CHATCCC_PORT（端口在 setup 切换时必须保持不变）", () => {
     const portBefore = CHATCCC_PORT;
     applyLoadedConfig({
@@ -186,7 +204,7 @@ describe("applyLoadedConfig — config 对象引用契约", () => {
     applyLoadedConfig({
       ...structuredClone(baseAppConfig),
       feishu: { appId: "REF_TEST_APP", appSecret: "REF_TEST_SECRET" },
-      codex: { enabled: true, defaultAgent: false, path: "/refresh/codex", model: "fresh-model", effort: "low" },
+      codex: { enabled: true, defaultAgent: false, path: "/refresh/codex", model: "fresh-model", alternativeModel: "", effort: "low" },
     });
 
     // 必须是同一个引用：codex-adapter 等下游模块"直接 import config"，

package/src/__tests__/config-sample.test.ts

@@ -28,6 +28,17 @@ describe("config.sample.json", () => {
     expect(sample.claude?.subagentModel).toBe("");
   });
 
+  it("leaves Cursor and Codex alternative models empty by default", () => {
+    const configSamplePath = join(process.cwd(), "config.sample.json");
+    const sample = JSON.parse(readFileSync(configSamplePath, "utf8")) as {
+      cursor?: { alternativeModel?: unknown };
+      codex?: { alternativeModel?: unknown };
+    };
+
+    expect(sample.cursor?.alternativeModel).toBe("");
+    expect(sample.codex?.alternativeModel).toBe("");
+  });
+
   it("keeps Chrome CDP guard disabled by default with port 15166", () => {
     const configSamplePath = join(process.cwd(), "config.sample.json");
     const sample = JSON.parse(readFileSync(configSamplePath, "utf8")) as {
@@ -38,4 +49,23 @@ describe("config.sample.json", () => {
     expect(sample.chromeDevtools?.port).toBe(15166);
     expect(sample.chromeDevtools?.chromePath).toBe("");
   });
+
+  it("keeps raw stream logs disabled by default for every agent", () => {
+    const configSamplePath = join(process.cwd(), "config.sample.json");
+    const sample = JSON.parse(readFileSync(configSamplePath, "utf8")) as {
+      rawStreamLogs?: Record<string, {
+        enabled?: unknown;
+        maxBytesPerTurn?: unknown;
+        retentionDays?: unknown;
+        keepCompleted?: unknown;
+      }>;
+    };
+
+    for (const tool of ["claude", "cursor", "codex"]) {
+      expect(sample.rawStreamLogs?.[tool]?.enabled).toBe(false);
+      expect(sample.rawStreamLogs?.[tool]?.maxBytesPerTurn).toBe(52_428_800);
+      expect(sample.rawStreamLogs?.[tool]?.retentionDays).toBe(7);
+      expect(sample.rawStreamLogs?.[tool]?.keepCompleted).toBe(false);
+    }
+  });
 });

package/src/__tests__/raw-stream-log.test.ts

@@ -0,0 +1,106 @@
+import { gunzipSync } from "node:zlib";
+import { mkdtemp, readFile, rm, stat, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+
+import { describe, expect, it } from "vitest";
+
+import {
+  createRawStreamLog,
+  sanitizeLogPathSegment,
+} from "../adapters/raw-stream-log.ts";
+
+describe("raw stream log", () => {
+  it("does nothing when disabled", async () => {
+    const root = await mkdtemp(join(tmpdir(), "chatccc-raw-log-"));
+    try {
+      const log = await createRawStreamLog({
+        enabled: false,
+        rootDir: root,
+        tool: "cursor",
+        sessionId: "sid",
+        label: "turn",
+        maxBytesPerTurn: 1024,
+        retentionDays: 7,
+      });
+      expect(log).toBeNull();
+    } finally {
+      await rm(root, { recursive: true, force: true });
+    }
+  });
+
+  it("writes gzipped JSONL and can keep the file", async () => {
+    const root = await mkdtemp(join(tmpdir(), "chatccc-raw-log-"));
+    try {
+      const log = await createRawStreamLog({
+        enabled: true,
+        rootDir: root,
+        tool: "cursor",
+        sessionId: "sid/unsafe",
+        label: "turn:1",
+        maxBytesPerTurn: 1024,
+        retentionDays: 7,
+      });
+      expect(log).not.toBeNull();
+      log!.writeLine('{"type":"assistant","text":"hello"}');
+      await log!.close({ keep: true });
+
+      const raw = gunzipSync(await readFile(log!.filePath)).toString("utf-8");
+      expect(raw).toBe('{"type":"assistant","text":"hello"}\n');
+      expect(await stat(log!.filePath)).toBeTruthy();
+    } finally {
+      await rm(root, { recursive: true, force: true });
+    }
+  });
+
+  it("writes a truncation marker once maxBytesPerTurn is exceeded", async () => {
+    const root = await mkdtemp(join(tmpdir(), "chatccc-raw-log-"));
+    try {
+      const log = await createRawStreamLog({
+        enabled: true,
+        rootDir: root,
+        tool: "cursor",
+        sessionId: "sid",
+        label: "turn",
+        maxBytesPerTurn: 12,
+        retentionDays: 7,
+      });
+      log!.writeLine('{"a":1}');
+      log!.writeLine('{"too":"large"}');
+      log!.writeLine('{"ignored":true}');
+      await log!.close({ keep: true });
+
+      const raw = gunzipSync(await readFile(log!.filePath)).toString("utf-8");
+      expect(raw).toContain('{"a":1}');
+      expect(raw).toContain("chatccc_raw_stream_log_truncated");
+      expect(raw).not.toContain("ignored");
+    } finally {
+      await rm(root, { recursive: true, force: true });
+    }
+  });
+
+  it("removes the file when keep is false", async () => {
+    const root = await mkdtemp(join(tmpdir(), "chatccc-raw-log-"));
+    try {
+      const log = await createRawStreamLog({
+        enabled: true,
+        rootDir: root,
+        tool: "cursor",
+        sessionId: "sid",
+        label: "turn",
+        maxBytesPerTurn: 1024,
+        retentionDays: 7,
+      });
+      log!.writeLine('{"type":"result"}');
+      await log!.close({ keep: false });
+      await expect(stat(log!.filePath)).rejects.toThrow();
+    } finally {
+      await rm(root, { recursive: true, force: true });
+    }
+  });
+
+  it("sanitizes path segments", () => {
+    expect(sanitizeLogPathSegment("../sid:1/2")).toBe("sid_1_2");
+    expect(sanitizeLogPathSegment("")).toBe("unknown");
+  });
+});

package/src/__tests__/web-ui.test.ts

@@ -34,6 +34,22 @@ describe("unflattenConfig", () => {
     });
   });
 
+  it("maps Cursor and Codex alternative models into agent config", () => {
+    expect(
+      unflattenConfig({
+        CHATCCC_CURSOR_ALTERNATIVE_MODEL: "gpt-5.5-high",
+        CHATCCC_CODEX_ALTERNATIVE_MODEL: "gpt-5.3-codex",
+      }),
+    ).toEqual({
+      cursor: {
+        alternativeModel: "gpt-5.5-high",
+      },
+      codex: {
+        alternativeModel: "gpt-5.3-codex",
+      },
+    });
+  });
+
   it("maps Chrome CDP guard fields into chromeDevtools config", () => {
     expect(
       unflattenConfig({
@@ -57,6 +73,12 @@ describe("dashboard edit modal", () => {
     expect(PAGE_HTML).toContain("document.getElementById('edit-modal').classList.remove('hidden');");
     expect(PAGE_HTML).toContain("document.getElementById('edit-overlay').classList.remove('hidden');");
   });
+
+  it("uses plain alternative model labels for Cursor and Codex", () => {
+    expect(PAGE_HTML).toContain("field-CHATCCC_CURSOR_ALTERNATIVE_MODEL");
+    expect(PAGE_HTML).toContain("field-CHATCCC_CODEX_ALTERNATIVE_MODEL");
+    expect(PAGE_HTML).toContain("备选模型");
+  });
 });
 
 // ---------------------------------------------------------------------------

package/src/adapters/cursor-adapter.ts

@@ -20,12 +20,16 @@ import type {
   SessionInfo,
 } from "./adapter-interface.ts";
 import { parseUserCommand } from "./adapter-interface.ts";
-import { CURSOR_AGENT_COMMAND, CURSOR_AGENT_ARGS } from "../config.ts";
+import { config, CURSOR_AGENT_COMMAND, CURSOR_AGENT_ARGS, RAW_STREAM_LOGS_DIR } from "../config.ts";
 import {
   defaultCursorSessionMetaStore,
   type CursorSessionMetaStore,
 } from "./cursor-session-meta-store.ts";
-import { killProcessTree } from "./proc-tree-kill.ts";
+import { killProcessTree } from "./proc-tree-kill.ts";
+import {
+  createRawStreamLog,
+  type RawStreamLogHandle,
+} from "./raw-stream-log.ts";
 
 // ---------------------------------------------------------------------------
 // 特殊注入提示
@@ -344,11 +348,12 @@ function spawnAgent(
   return proc;
 }
 
-async function* readJsonLines(
-  proc: ChildProcess,
-  signal?: AbortSignal,
-  debugTag?: string,
-): AsyncGenerator<CursorMessageLine> {
+async function* readJsonLines(
+  proc: ChildProcess,
+  signal?: AbortSignal,
+  debugTag?: string,
+  rawLog?: RawStreamLogHandle | null,
+): AsyncGenerator<CursorMessageLine> {
   const tag = debugTag ?? "cursor";
   const rl = createInterface({ input: proc.stdout!, crlfDelay: Infinity });
   // abort 时主动 close readline，避免等待 Windows 管道自然关闭（可能延迟数分钟）
@@ -359,9 +364,10 @@ async function* readJsonLines(
     for await (const line of rl) {
       if (signal?.aborted) break;
       lineCount++;
-      const trimmed = line.trim();
-      if (!trimmed) continue;
-      try {
+      const trimmed = line.trim();
+      if (!trimmed) continue;
+      rawLog?.writeLine(trimmed);
+      try {
         yield JSON.parse(trimmed) as CursorMessageLine;
       } catch { /* 非 JSON 行静默跳过 */ }
     }
@@ -426,15 +432,32 @@ class CursorAdapter implements ToolAdapter {
       cmd.mode ?? undefined,
     );
     this.activeProcs.add(proc);
-    if (proc.pid !== undefined) options?.onProcessStart?.({ pid: proc.pid });
+    if (proc.pid !== undefined) options?.onProcessStart?.({ pid: proc.pid });
+
+    const rawLogConfig = config.rawStreamLogs.cursor;
+    let rawLog: RawStreamLogHandle | null = null;
+    try {
+      rawLog = await createRawStreamLog({
+        enabled: rawLogConfig.enabled,
+        rootDir: RAW_STREAM_LOGS_DIR,
+        tool: "cursor",
+        sessionId,
+        label: "prompt",
+        maxBytesPerTurn: rawLogConfig.maxBytesPerTurn,
+        retentionDays: rawLogConfig.retentionDays,
+      });
+    } catch (err) {
+      console.error(`[Cursor raw stream log] create failed: ${(err as Error).message}`);
+    }
 
     // 见 codex-adapter.ts 同位置注释：spawn 用了 shell:true，必须杀整棵树，
     // 否则 abort 后真正在跑的孙进程 cursor-agent 还会继续输出 & 占用资源。
-    const onAbort = () => { void killProcessTree(proc.pid); };
-    signal?.addEventListener("abort", onAbort, { once: true });
-
-    try {
-      for await (const raw of readJsonLines(proc, signal, sessionId)) {
+    const onAbort = () => { void killProcessTree(proc.pid); };
+    signal?.addEventListener("abort", onAbort, { once: true });
+    let sawResult = false;
+
+    try {
+      for await (const raw of readJsonLines(proc, signal, sessionId, rawLog)) {
         if (signal?.aborted) break;
         if (
           raw.type === "system" &&
@@ -450,15 +473,17 @@ class CursorAdapter implements ToolAdapter {
         if (normalized) yield normalized;
 
         // result 是流末事件，收到后立即结束进程，防止 CLI 僵死导致 readline 挂起。
-        if (raw.type === "result") {
-          void killProcessTree(proc.pid);
+        if (raw.type === "result") {
+          sawResult = true;
+          void killProcessTree(proc.pid);
           break;
         }
       }
     } finally {
       signal?.removeEventListener("abort", onAbort);
-      await killProcessTree(proc.pid);
-      this.activeProcs.delete(proc);
+      await killProcessTree(proc.pid);
+      await rawLog?.close({ keep: rawLogConfig.keepCompleted || signal?.aborted === true || !sawResult });
+      this.activeProcs.delete(proc);
       if (proc.pid !== undefined) options?.onProcessExit?.({ pid: proc.pid });
       console.log(`[Cursor debug] prompt end: sessionId=${sessionId}, signalAborted=${signal?.aborted ?? false}`);
     }
@@ -494,4 +519,4 @@ export function createCursorAdapter(
   options: CreateCursorAdapterOptions = {},
 ): ToolAdapter {
   return new CursorAdapter(options.metaStore ?? defaultCursorSessionMetaStore, options.model);
-}
+}

package/src/adapters/raw-stream-log.ts

@@ -0,0 +1,124 @@
+import { createWriteStream, type Dirent } from "node:fs";
+import { mkdir, readdir, rm, stat, unlink } from "node:fs/promises";
+import { once } from "node:events";
+import { join } from "node:path";
+import { createGzip } from "node:zlib";
+
+export interface RawStreamLogOptions {
+  enabled: boolean;
+  rootDir: string;
+  tool: string;
+  sessionId: string;
+  label: string;
+  maxBytesPerTurn: number;
+  retentionDays: number;
+}
+
+export interface RawStreamLogHandle {
+  filePath: string;
+  writeLine(line: string): void;
+  close(options: { keep: boolean }): Promise<void>;
+}
+
+export function sanitizeLogPathSegment(value: string): string {
+  const safe = value.replace(/[^a-zA-Z0-9._-]+/g, "_").replace(/^[._]+|_+$/g, "");
+  return safe || "unknown";
+}
+
+async function cleanupOldRawStreamLogs(rootDir: string, retentionDays: number): Promise<void> {
+  if (!Number.isFinite(retentionDays) || retentionDays <= 0) return;
+  const cutoff = Date.now() - retentionDays * 24 * 60 * 60 * 1000;
+
+  const visit = async (dir: string): Promise<void> => {
+    let entries: Dirent[];
+    try {
+      entries = await readdir(dir, { withFileTypes: true });
+    } catch {
+      return;
+    }
+
+    await Promise.all(entries.map(async (entry) => {
+      const path = join(dir, entry.name);
+      if (entry.isDirectory()) {
+        await visit(path);
+        try {
+          await rm(path, { recursive: false });
+        } catch {
+          // Directory is not empty or already gone.
+        }
+        return;
+      }
+
+      if (!entry.isFile()) return;
+      try {
+        const info = await stat(path);
+        if (info.mtimeMs < cutoff) await rm(path, { force: true });
+      } catch {
+        // Best-effort cleanup only.
+      }
+    }));
+  };
+
+  await visit(rootDir);
+}
+
+export async function createRawStreamLog(options: RawStreamLogOptions): Promise<RawStreamLogHandle | null> {
+  if (!options.enabled) return null;
+
+  const maxBytes = Math.max(0, Math.floor(options.maxBytesPerTurn));
+  const tool = sanitizeLogPathSegment(options.tool);
+  const session = sanitizeLogPathSegment(options.sessionId);
+  const label = sanitizeLogPathSegment(options.label);
+  const dir = join(options.rootDir, tool, session);
+  await mkdir(dir, { recursive: true });
+  void cleanupOldRawStreamLogs(join(options.rootDir, tool), options.retentionDays);
+
+  const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
+  const filePath = join(dir, `${timestamp}-${label}.jsonl.gz`);
+  const output = createWriteStream(filePath);
+  const gzip = createGzip();
+  gzip.pipe(output);
+
+  let bytes = 0;
+  let truncated = false;
+  let ended = false;
+
+  const writeLine = (line: string): void => {
+    if (ended || truncated) return;
+    const payload = `${line}\n`;
+    const payloadBytes = Buffer.byteLength(payload, "utf-8");
+    if (maxBytes > 0 && bytes + payloadBytes > maxBytes) {
+      const marker = JSON.stringify({
+        type: "chatccc_raw_stream_log_truncated",
+        reason: "max_bytes_per_turn_exceeded",
+        maxBytesPerTurn: maxBytes,
+        writtenBytes: bytes,
+      });
+      gzip.write(`${marker}\n`);
+      truncated = true;
+      return;
+    }
+    bytes += payloadBytes;
+    gzip.write(payload);
+  };
+
+  const close = async ({ keep }: { keep: boolean }): Promise<void> => {
+    if (ended) return;
+    ended = true;
+    gzip.end();
+    try {
+      await once(output, "finish");
+    } catch {
+      // Ignore close errors; caller cannot recover from debug log failures.
+    }
+    if (!keep) {
+      try {
+        await unlink(filePath);
+      } catch {
+        // Best-effort cleanup only.
+      }
+    }
+  };
+
+  return { filePath, writeLine, close };
+}

package/src/config.ts

@@ -42,6 +42,7 @@ export const LOG_DIR = join(USER_DATA_DIR, "logs");
 export const fileLog = setupFileLogging(LOG_DIR, "index");
 
 export const CHAT_LOGS_DIR = join(USER_DATA_DIR, "state", "chat_logs");
+export const RAW_STREAM_LOGS_DIR = join(LOG_DIR, "raw-streams");
 
 export async function appendChatLog(chatId: string, sender: string, text: string): Promise<void> {
   try {
@@ -81,6 +82,8 @@ export interface CursorConfig {
   /** Cursor Agent CLI 可执行文件绝对路径；留空时由运行时按 LocalAppData / PATH 兜底 */
   path: string;
   model: string;
+  /** /model 可切换的单个备选模型；留空则不加入候选列表 */
+  alternativeModel: string;
   avatarBatteryMode: CursorAvatarBatteryMode;
   onDemandMonthlyBudget: number;
 }
@@ -93,6 +96,8 @@ export interface CodexConfig {
   /** Codex CLI 可执行文件绝对路径；留空时退回到 PATH 中的 `codex` */
   path: string;
   model: string;
+  /** /model 可切换的单个备选模型；留空则不加入候选列表 */
+  alternativeModel: string;
   effort: string;
 }
 
@@ -122,6 +127,19 @@ export interface ChromeDevtoolsConfig {
   chromePath: string;
 }
 
+export interface RawStreamAgentLogConfig {
+  enabled: boolean;
+  maxBytesPerTurn: number;
+  retentionDays: number;
+  keepCompleted: boolean;
+}
+
+export interface RawStreamLogsConfig {
+  claude: RawStreamAgentLogConfig;
+  cursor: RawStreamAgentLogConfig;
+  codex: RawStreamAgentLogConfig;
+}
+
 export interface AppConfig {
   feishu: FeishuConfig;
   platforms: PlatformsConfig;
@@ -130,6 +148,7 @@ export interface AppConfig {
   gitTimeoutSeconds: number;
   /** 若为 false，AI 生成过程中用户发送消息不会打断，须先点「停止」再发送新消息 */
   allowInterrupt: boolean;
+  rawStreamLogs: RawStreamLogsConfig;
   claude: ClaudeConfig;
   cursor: CursorConfig;
   codex: CodexConfig;
@@ -151,8 +170,10 @@ export function getAllModelsForTool(tool: AgentTool, cfg: AppConfig = config): s
     collect(cfg.claude.subagentModel);
   } else if (tool === "cursor") {
     collect(cfg.cursor.model);
+    collect(cfg.cursor.alternativeModel);
   } else if (tool === "codex") {
     collect(cfg.codex.model);
+    collect(cfg.codex.alternativeModel);
   }
 
   return Array.from(seen).slice(0, 100);
@@ -348,6 +369,23 @@ function normalizeCursorOnDemandMonthlyBudget(raw: unknown): number {
   return Number.isFinite(value) && value > 0 ? value : 1000;
 }
 
+function normalizePositiveInteger(raw: unknown, fallback: number): number {
+  const value = typeof raw === "string" ? Number(raw.trim()) : Number(raw);
+  return Number.isInteger(value) && value > 0 ? value : fallback;
+}
+
+function normalizeRawStreamAgentLogConfig(raw: unknown): RawStreamAgentLogConfig {
+  const obj = typeof raw === "object" && raw !== null
+    ? raw as Record<string, unknown>
+    : {};
+  return {
+    enabled: typeof obj.enabled === "boolean" ? obj.enabled : false,
+    maxBytesPerTurn: normalizePositiveInteger(obj.maxBytesPerTurn, 50 * 1024 * 1024),
+    retentionDays: normalizePositiveInteger(obj.retentionDays, 7),
+    keepCompleted: typeof obj.keepCompleted === "boolean" ? obj.keepCompleted : false,
+  };
+}
+
 function loadConfig(): AppConfig {
   const defaults: AppConfig = {
     feishu: { appId: "", appSecret: "" },
@@ -356,16 +394,22 @@ function loadConfig(): AppConfig {
     port: 18080,
     gitTimeoutSeconds: 180,
     allowInterrupt: false,
+    rawStreamLogs: {
+      claude: { enabled: false, maxBytesPerTurn: 50 * 1024 * 1024, retentionDays: 7, keepCompleted: false },
+      cursor: { enabled: false, maxBytesPerTurn: 50 * 1024 * 1024, retentionDays: 7, keepCompleted: false },
+      codex: { enabled: false, maxBytesPerTurn: 50 * 1024 * 1024, retentionDays: 7, keepCompleted: false },
+    },
     claude: { enabled: false, defaultAgent: true, model: "", subagentModel: "", effort: "", apiKey: "", baseUrl: "", maxTurn: 0 },
     cursor: {
       enabled: false,
       defaultAgent: false,
       path: "",
       model: "claude-opus-4-7-max",
+      alternativeModel: "",
       avatarBatteryMode: "apiPercent",
       onDemandMonthlyBudget: 1000,
     },
-    codex: { enabled: false, defaultAgent: false, path: "", model: "", effort: "" },
+    codex: { enabled: false, defaultAgent: false, path: "", model: "", alternativeModel: "", effort: "" },
   };
 
   if (!IS_TEST_ENV) {
@@ -413,11 +457,13 @@ function loadConfig(): AppConfig {
       path?: unknown;
       command?: unknown;
       model?: unknown;
+      alternativeModel?: unknown;
       avatarBatteryMode?: unknown;
       onDemandMonthlyBudget?: unknown;
     };
-    codex?: { enabled?: unknown; defaultAgent?: unknown; path?: unknown; command?: unknown; model?: unknown; effort?: unknown };
+    codex?: { enabled?: unknown; defaultAgent?: unknown; path?: unknown; command?: unknown; model?: unknown; alternativeModel?: unknown; effort?: unknown };
     chromeDevtools?: { enabled?: unknown; port?: unknown; chromePath?: unknown };
+    rawStreamLogs?: unknown;
   };
   try {
     parsed = JSON.parse(raw);
@@ -431,6 +477,9 @@ function loadConfig(): AppConfig {
   const cursorRaw = (parsed.cursor ?? {}) as NonNullable<typeof parsed.cursor>;
   const codexRaw = (parsed.codex ?? {}) as NonNullable<typeof parsed.codex>;
   const chromeDevtoolsRaw = (parsed.chromeDevtools ?? {}) as NonNullable<typeof parsed.chromeDevtools>;
+  const rawStreamLogsRaw = typeof parsed.rawStreamLogs === "object" && parsed.rawStreamLogs !== null
+    ? parsed.rawStreamLogs as unknown as Record<string, unknown>
+    : {};
 
   // 兼容旧字段 `command`：命中时打印一次性 warning 提示用户改名
   const onLegacyField = (label: string, value: string): void => {
@@ -461,13 +510,15 @@ function loadConfig(): AppConfig {
     Boolean(
       (typeof cursorRaw.path === "string" && cursorRaw.path.trim()) ||
       (typeof cursorRaw.command === "string" && (cursorRaw.command as string).trim()) ||
-      (typeof cursorRaw.model === "string" && (cursorRaw.model as string).trim()),
+      (typeof cursorRaw.model === "string" && (cursorRaw.model as string).trim()) ||
+      (typeof cursorRaw.alternativeModel === "string" && (cursorRaw.alternativeModel as string).trim()),
     );
   const codexNonEmpty = (): boolean =>
     Boolean(
       (typeof codexRaw.path === "string" && codexRaw.path.trim()) ||
       (typeof codexRaw.command === "string" && (codexRaw.command as string).trim()) ||
       (typeof codexRaw.model === "string" && (codexRaw.model as string).trim()) ||
+      (typeof codexRaw.alternativeModel === "string" && (codexRaw.alternativeModel as string).trim()) ||
       (typeof codexRaw.effort === "string" && (codexRaw.effort as string).trim()),
     );
 
@@ -522,6 +573,11 @@ function loadConfig(): AppConfig {
     port: typeof parsed.port === "number" ? parsed.port : 18080,
     gitTimeoutSeconds: typeof parsed.gitTimeoutSeconds === "number" ? parsed.gitTimeoutSeconds : 180,
     allowInterrupt: typeof parsed.allowInterrupt === "boolean" ? parsed.allowInterrupt : false,
+    rawStreamLogs: {
+      claude: normalizeRawStreamAgentLogConfig(rawStreamLogsRaw.claude),
+      cursor: normalizeRawStreamAgentLogConfig(rawStreamLogsRaw.cursor),
+      codex: normalizeRawStreamAgentLogConfig(rawStreamLogsRaw.codex),
+    },
     claude: {
       enabled: claudeEnabled,
       defaultAgent: defaultTool === "claude",
@@ -539,6 +595,7 @@ function loadConfig(): AppConfig {
       defaultAgent: defaultTool === "cursor",
       path: readToolCliPath(cursorRaw, { label: "cursor", onLegacyField }),
       model: normalizeOptionalConfigField(cursorRaw.model, { label: "cursor.model", fallback: "claude-opus-4-7-max" }),
+      alternativeModel: normalizeOptionalConfigField(cursorRaw.alternativeModel, { label: "cursor.alternativeModel" }),
       avatarBatteryMode: normalizeCursorAvatarBatteryMode(cursorRaw.avatarBatteryMode),
       onDemandMonthlyBudget: normalizeCursorOnDemandMonthlyBudget(cursorRaw.onDemandMonthlyBudget),
     },
@@ -547,6 +604,7 @@ function loadConfig(): AppConfig {
       defaultAgent: defaultTool === "codex",
       path: readToolCliPath(codexRaw, { label: "codex", onLegacyField }),
       model: normalizeOptionalConfigField(codexRaw.model, { label: "codex.model" }),
+      alternativeModel: normalizeOptionalConfigField(codexRaw.alternativeModel, { label: "codex.alternativeModel" }),
       effort: normalizeOptionalConfigField(codexRaw.effort, { label: "codex.effort" }),
     },
   };

package/src/web-ui.ts

@@ -40,10 +40,11 @@ interface AppConfig {
     path?: string;
     command?: string;
     model?: string;
+    alternativeModel?: string;
     avatarBatteryMode?: string;
     onDemandMonthlyBudget?: number;
   };
-  codex?: { enabled?: boolean; defaultAgent?: boolean; path?: string; command?: string; model?: string; effort?: string };
+  codex?: { enabled?: boolean; defaultAgent?: boolean; path?: string; command?: string; model?: string; alternativeModel?: string; effort?: string };
 }
 
 // ---------------------------------------------------------------------------
@@ -380,6 +381,9 @@ export function unflattenConfig(flat: Record<string, unknown>): Record<string, u
     } else if (key === "CHATCCC_CURSOR_MODEL") {
       result.cursor = result.cursor || {};
       (result.cursor as Record<string, unknown>).model = val;
+    } else if (key === "CHATCCC_CURSOR_ALTERNATIVE_MODEL") {
+      result.cursor = result.cursor || {};
+      (result.cursor as Record<string, unknown>).alternativeModel = val;
     } else if (key === "CHATCCC_CURSOR_AVATAR_BATTERY_MODE") {
       result.cursor = result.cursor || {};
       (result.cursor as Record<string, unknown>).avatarBatteryMode = val;
@@ -398,6 +402,9 @@ export function unflattenConfig(flat: Record<string, unknown>): Record<string, u
     } else if (key === "CHATCCC_CODEX_MODEL") {
       result.codex = result.codex || {};
       (result.codex as Record<string, unknown>).model = val;
+    } else if (key === "CHATCCC_CODEX_ALTERNATIVE_MODEL") {
+      result.codex = result.codex || {};
+      (result.codex as Record<string, unknown>).alternativeModel = val;
     } else if (key === "CHATCCC_CODEX_EFFORT") {
       result.codex = result.codex || {};
       (result.codex as Record<string, unknown>).effort = val;
@@ -747,6 +754,10 @@ header .badge{font-size:13px;padding:4px 12px;border-radius:12px;font-weight:500
               <label>模型</label>
               <input type="text" id="field-CHATCCC_CURSOR_MODEL" placeholder="留空表示不传 --model">
             </div>
+            <div class="form-group">
+              <label>备选模型（选填）</label>
+              <input type="text" id="field-CHATCCC_CURSOR_ALTERNATIVE_MODEL" placeholder="加入 /model 列表，便于会话内切换">
+            </div>
             <div class="form-group">
               <label>头像电池电量</label>
               <select id="field-CHATCCC_CURSOR_AVATAR_BATTERY_MODE" onchange="onCursorBatteryModeChange('field-', this.value)" style="width:100%;padding:8px 12px;border:1px solid #cbd5e1;border-radius:8px;font-size:14px;outline:none">
@@ -785,6 +796,10 @@ header .badge{font-size:13px;padding:4px 12px;border-radius:12px;font-weight:500
               <label>模型</label>
               <input type="text" id="field-CHATCCC_CODEX_MODEL" placeholder="留空由 codex config.toml 决定">
             </div>
+            <div class="form-group">
+              <label>备选模型（选填）</label>
+              <input type="text" id="field-CHATCCC_CODEX_ALTERNATIVE_MODEL" placeholder="加入 /model 列表，便于会话内切换">
+            </div>
             <div class="form-group">
               <label>努力程度 (Effort)</label>
               <input type="text" id="field-CHATCCC_CODEX_EFFORT" placeholder="留空由 codex config.toml 决定">
@@ -891,6 +906,7 @@ header .badge{font-size:13px;padding:4px 12px;border-radius:12px;font-weight:500
       <div class="section-detail">
         <div class="config-row"><span class="key">CLI 路径</span><span class="val" id="cfg-CURSOR_PATH">-</span></div>
         <div class="config-row"><span class="key">模型</span><span class="val" id="cfg-CURSOR_MODEL">-</span></div>
+        <div class="config-row"><span class="key">备选模型</span><span class="val" id="cfg-CURSOR_ALTERNATIVE_MODEL">-</span></div>
         <div class="config-row"><span class="key">头像电池电量</span><span class="val" id="cfg-CURSOR_AVATAR_BATTERY_MODE">-</span></div>
         <div class="config-row" id="cfg-CURSOR_ON_DEMAND_MONTHLY_BUDGET_ROW"><span class="key">每月On demand use预算</span><span class="val" id="cfg-CURSOR_ON_DEMAND_MONTHLY_BUDGET">-</span></div>
         <label class="agent-default-row" style="margin-top:10px"><input type="checkbox" id="dash-default-cursor" onchange="setDashboardDefaultAgent('cursor', this.checked)"> 设为默认 Agent</label>
@@ -903,6 +919,7 @@ header .badge{font-size:13px;padding:4px 12px;border-radius:12px;font-weight:500
       <div class="section-detail">
         <div class="config-row"><span class="key">CLI 路径</span><span class="val" id="cfg-CODEX_PATH">-</span></div>
         <div class="config-row"><span class="key">模型</span><span class="val" id="cfg-CODEX_MODEL">-</span></div>
+        <div class="config-row"><span class="key">备选模型</span><span class="val" id="cfg-CODEX_ALTERNATIVE_MODEL">-</span></div>
         <div class="config-row"><span class="key">Effort</span><span class="val" id="cfg-CODEX_EFFORT">-</span></div>
         <label class="agent-default-row" style="margin-top:10px"><input type="checkbox" id="dash-default-codex" onchange="setDashboardDefaultAgent('codex', this.checked)"> 设为默认 Agent</label>
         <button class="btn btn-outline" style="margin-top:8px" onclick="editSection('codex')">编辑</button>
@@ -950,8 +967,8 @@ var step2InputBound = false;
 
 const AGENT_FIELDS = {
   claude: ['CHATCCC_ANTHROPIC_MODEL','CHATCCC_ANTHROPIC_SUBAGENT_MODEL','CHATCCC_ANTHROPIC_EFFORT','CHATCCC_ANTHROPIC_API_KEY','CHATCCC_ANTHROPIC_BASE_URL','CHATCCC_ANTHROPIC_MAX_TURN'],
-  cursor: ['CHATCCC_CURSOR_PATH','CHATCCC_CURSOR_MODEL','CHATCCC_CURSOR_AVATAR_BATTERY_MODE','CHATCCC_CURSOR_ON_DEMAND_MONTHLY_BUDGET'],
-  codex: ['CHATCCC_CODEX_PATH','CHATCCC_CODEX_MODEL','CHATCCC_CODEX_EFFORT']
+  cursor: ['CHATCCC_CURSOR_PATH','CHATCCC_CURSOR_MODEL','CHATCCC_CURSOR_ALTERNATIVE_MODEL','CHATCCC_CURSOR_AVATAR_BATTERY_MODE','CHATCCC_CURSOR_ON_DEMAND_MONTHLY_BUDGET'],
+  codex: ['CHATCCC_CODEX_PATH','CHATCCC_CODEX_MODEL','CHATCCC_CODEX_ALTERNATIVE_MODEL','CHATCCC_CODEX_EFFORT']
 };
 const FEISHU_FIELDS = ['CHATCCC_APP_ID','CHATCCC_APP_SECRET'];
 const CHROME_DEVTOOLS_FIELDS = ['CHATCCC_CHROME_DEVTOOLS_ENABLED','CHATCCC_CHROME_DEVTOOLS_PORT','CHATCCC_CHROME_DEVTOOLS_PATH'];
@@ -1217,8 +1234,8 @@ function isAgentEnabled(node, keys) {
 }
 
 var CLAUDE_FALLBACK_KEYS = ['model','subagentModel','effort','maxTurn'];
-var CURSOR_FALLBACK_KEYS = ['path','command','model'];
-var CODEX_FALLBACK_KEYS = ['path','command','model','effort'];
+var CURSOR_FALLBACK_KEYS = ['path','command','model','alternativeModel'];
+var CODEX_FALLBACK_KEYS = ['path','command','model','alternativeModel','effort'];
 
 function renderStep2() {
   var c = state.config || {};
@@ -1230,6 +1247,7 @@ function renderStep2() {
   if (c.cursor) {
     prefillNested('field-CHATCCC_CURSOR_PATH', c.cursor.path || c.cursor.command);
     prefillNested('field-CHATCCC_CURSOR_MODEL', c.cursor.model);
+    prefillNested('field-CHATCCC_CURSOR_ALTERNATIVE_MODEL', c.cursor.alternativeModel);
     var cursorMode = c.cursor.avatarBatteryMode || 'apiPercent';
     var cursorModeInput = document.getElementById('field-CHATCCC_CURSOR_AVATAR_BATTERY_MODE');
     if (cursorModeInput) cursorModeInput.value = cursorMode;
@@ -1245,6 +1263,7 @@ function renderStep2() {
   if (c.codex) {
     prefillNested('field-CHATCCC_CODEX_PATH', c.codex.path || c.codex.command);
     prefillNested('field-CHATCCC_CODEX_MODEL', c.codex.model);
+    prefillNested('field-CHATCCC_CODEX_ALTERNATIVE_MODEL', c.codex.alternativeModel);
     prefillNested('field-CHATCCC_CODEX_EFFORT', c.codex.effort);
   }
 
@@ -1385,6 +1404,7 @@ function renderStep3() {
       lines.push('<h4 style="margin:10px 0 4px;color:#334155">Cursor</h4>');
       if (vars.CHATCCC_CURSOR_PATH) lines.push('<div class="config-row"><span class="key">CLI 路径</span><span class="val">' + vars.CHATCCC_CURSOR_PATH + '</span></div>');
       lines.push('<div class="config-row"><span class="key">模型</span><span class="val">' + (vars.CHATCCC_CURSOR_MODEL || '(留空)') + '</span></div>');
+      lines.push('<div class="config-row"><span class="key">备选模型</span><span class="val">' + (vars.CHATCCC_CURSOR_ALTERNATIVE_MODEL || '(留空)') + '</span></div>');
       lines.push('<div class="config-row"><span class="key">头像电池电量</span><span class="val">' + cursorBatteryModeLabel(vars.CHATCCC_CURSOR_AVATAR_BATTERY_MODE) + '</span></div>');
       if (vars.CHATCCC_CURSOR_AVATAR_BATTERY_MODE === 'onDemandUse') {
         lines.push('<div class="config-row"><span class="key">每月On demand use预算</span><span class="val">' + (vars.CHATCCC_CURSOR_ON_DEMAND_MONTHLY_BUDGET || '1000') + '</span></div>');
@@ -1393,6 +1413,7 @@ function renderStep3() {
       lines.push('<h4 style="margin:10px 0 4px;color:#334155">Codex</h4>');
       if (vars.CHATCCC_CODEX_PATH) lines.push('<div class="config-row"><span class="key">CLI 路径</span><span class="val">' + vars.CHATCCC_CODEX_PATH + '</span></div>');
       lines.push('<div class="config-row"><span class="key">模型</span><span class="val">' + (vars.CHATCCC_CODEX_MODEL || '(留空)') + '</span></div>');
+      lines.push('<div class="config-row"><span class="key">备选模型</span><span class="val">' + (vars.CHATCCC_CODEX_ALTERNATIVE_MODEL || '(留空)') + '</span></div>');
       lines.push('<div class="config-row"><span class="key">Effort</span><span class="val">' + (vars.CHATCCC_CODEX_EFFORT || '(留空)') + '</span></div>');
     }
   });
@@ -1578,6 +1599,7 @@ function updateDashboardUI() {
   document.getElementById('cfg-ANTHROPIC_MAX_TURN').textContent = (c.claude && c.claude.maxTurn != null) ? String(c.claude.maxTurn) : '0';
   document.getElementById('cfg-CURSOR_PATH').textContent = (c.cursor && (c.cursor.path || c.cursor.command)) || '-';
   document.getElementById('cfg-CURSOR_MODEL').textContent = (c.cursor && c.cursor.model) || '(留空)';
+  document.getElementById('cfg-CURSOR_ALTERNATIVE_MODEL').textContent = (c.cursor && c.cursor.alternativeModel) || '(留空)';
   var cursorBatteryMode = (c.cursor && c.cursor.avatarBatteryMode) || 'apiPercent';
   document.getElementById('cfg-CURSOR_AVATAR_BATTERY_MODE').textContent = cursorBatteryModeLabel(cursorBatteryMode);
   var cursorBudgetRow = document.getElementById('cfg-CURSOR_ON_DEMAND_MONTHLY_BUDGET_ROW');
@@ -1585,6 +1607,7 @@ function updateDashboardUI() {
   document.getElementById('cfg-CURSOR_ON_DEMAND_MONTHLY_BUDGET').textContent = String((c.cursor && c.cursor.onDemandMonthlyBudget) || 1000);
   document.getElementById('cfg-CODEX_PATH').textContent = (c.codex && (c.codex.path || c.codex.command)) || 'codex';
   document.getElementById('cfg-CODEX_MODEL').textContent = (c.codex && c.codex.model) || '(留空)';
+  document.getElementById('cfg-CODEX_ALTERNATIVE_MODEL').textContent = (c.codex && c.codex.alternativeModel) || '(留空)';
   document.getElementById('cfg-CODEX_EFFORT').textContent = (c.codex && c.codex.effort) || '(留空)';
 }
 
@@ -1651,10 +1674,10 @@ function editSection(section) {
     'CHATCCC_CHROME_DEVTOOLS_PATH': 'Chrome 路径（选填）',
     'CHATCCC_ANTHROPIC_MODEL': '模型', 'CHATCCC_ANTHROPIC_SUBAGENT_MODEL': 'Subagent 模型', 'CHATCCC_ANTHROPIC_EFFORT': 'Effort',
     'CHATCCC_ANTHROPIC_API_KEY': 'API Key', 'CHATCCC_ANTHROPIC_BASE_URL': 'Base URL', 'CHATCCC_ANTHROPIC_MAX_TURN': 'Max Turns (0=无限制)',
-    'CHATCCC_CURSOR_PATH': 'CLI 路径', 'CHATCCC_CURSOR_MODEL': '模型',
+    'CHATCCC_CURSOR_PATH': 'CLI 路径', 'CHATCCC_CURSOR_MODEL': '模型', 'CHATCCC_CURSOR_ALTERNATIVE_MODEL': '备选模型',
     'CHATCCC_CURSOR_AVATAR_BATTERY_MODE': '头像电池电量',
     'CHATCCC_CURSOR_ON_DEMAND_MONTHLY_BUDGET': '每月On demand use预算',
-    'CHATCCC_CODEX_PATH': 'CLI 路径', 'CHATCCC_CODEX_MODEL': '模型', 'CHATCCC_CODEX_EFFORT': 'Effort'
+    'CHATCCC_CODEX_PATH': 'CLI 路径', 'CHATCCC_CODEX_MODEL': '模型', 'CHATCCC_CODEX_ALTERNATIVE_MODEL': '备选模型', 'CHATCCC_CODEX_EFFORT': 'Effort'
   };
   var hintMap = {
     'CHATCCC_CHROME_DEVTOOLS_ENABLED': '依赖：本机 Google Chrome；ChatGPT 订阅到期查询需要在该 CDP Chrome 中登录 ChatGPT。',
@@ -1687,11 +1710,13 @@ function editSection(section) {
       } else if (section === 'cursor' && state.config.cursor) {
         if (key === 'CHATCCC_CURSOR_PATH') val = state.config.cursor.path || state.config.cursor.command || '';
         else if (key === 'CHATCCC_CURSOR_MODEL') val = state.config.cursor.model || '';
+        else if (key === 'CHATCCC_CURSOR_ALTERNATIVE_MODEL') val = state.config.cursor.alternativeModel || '';
         else if (key === 'CHATCCC_CURSOR_AVATAR_BATTERY_MODE') val = state.config.cursor.avatarBatteryMode || 'apiPercent';
         else if (key === 'CHATCCC_CURSOR_ON_DEMAND_MONTHLY_BUDGET') val = (state.config.cursor.onDemandMonthlyBudget != null) ? String(state.config.cursor.onDemandMonthlyBudget) : '1000';
       } else if (section === 'codex' && state.config.codex) {
         if (key === 'CHATCCC_CODEX_PATH') val = state.config.codex.path || state.config.codex.command || '';
         else if (key === 'CHATCCC_CODEX_MODEL') val = state.config.codex.model || '';
+        else if (key === 'CHATCCC_CODEX_ALTERNATIVE_MODEL') val = state.config.codex.alternativeModel || '';
         else if (key === 'CHATCCC_CODEX_EFFORT') val = state.config.codex.effort || '';
       }
     }