chatccc 0.2.186 → 0.2.187

package/config.sample.json

@@ -12,30 +12,30 @@
     "port": 15166,
     "chromePath": ""
   },
-  "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": {
+  "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,
     "model": "",
@@ -50,6 +50,7 @@
     "defaultAgent": false,
     "path": "",
     "model": "",
+    "alternativeModel": "",
     "avatarBatteryMode": "apiPercent",
     "onDemandMonthlyBudget": 1000
   },
@@ -58,6 +59,7 @@
     "defaultAgent": false,
     "path": "",
     "model": "",
+    "alternativeModel": "",
     "effort": ""
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chatccc",
-  "version": "0.2.186",
+  "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";
@@ -41,15 +42,15 @@ const baseAppConfig: AppConfig = {
   feishu: { appId: "INITIAL_APP", appSecret: "INITIAL_SECRET" },
   platforms: { feishu: { enabled: true }, ilink: { enabled: true } },
   chromeDevtools: { enabled: false, port: 15166, chromePath: "" },
-  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: {
+  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,
     model: "initial-model",
@@ -64,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 跑前重置回这个状态，避免污染相邻测试。
@@ -145,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']
@@ -157,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");
@@ -166,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({
@@ -191,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,7 +28,18 @@ describe("config.sample.json", () => {
     expect(sample.claude?.subagentModel).toBe("");
   });
 
-  it("keeps Chrome CDP guard disabled by default with port 15166", () => {
+  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 {
       chromeDevtools?: { enabled?: unknown; port?: unknown; chromePath?: unknown };
@@ -36,25 +47,25 @@ describe("config.sample.json", () => {
 
     expect(sample.chromeDevtools?.enabled).toBe(false);
     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);
-    }
-  });
-});
+    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__/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/config.ts

@@ -39,10 +39,10 @@ export const USER_DATA_DIR = join(homedir(), ".chatccc");
 export const PID_FILE = join(USER_DATA_DIR, "state", "runtime.pid");
 
 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 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 {
@@ -82,6 +82,8 @@ export interface CursorConfig {
   /** Cursor Agent CLI 可执行文件绝对路径；留空时由运行时按 LocalAppData / PATH 兜底 */
   path: string;
   model: string;
+  /** /model 可切换的单个备选模型；留空则不加入候选列表 */
+  alternativeModel: string;
   avatarBatteryMode: CursorAvatarBatteryMode;
   onDemandMonthlyBudget: number;
 }
@@ -94,6 +96,8 @@ export interface CodexConfig {
   /** Codex CLI 可执行文件绝对路径；留空时退回到 PATH 中的 `codex` */
   path: string;
   model: string;
+  /** /model 可切换的单个备选模型；留空则不加入候选列表 */
+  alternativeModel: string;
   effort: string;
 }
 
@@ -114,41 +118,41 @@ export interface PlatformsConfig {
   ilink: PlatformConfig;
 }
 
-export interface ChromeDevtoolsConfig {
+export interface ChromeDevtoolsConfig {
   /** 是否由 ChatCCC 守护一个常驻 Chrome CDP 实例 */
   enabled: boolean;
   /** Chrome remote debugging 端口，默认 15166 */
   port: number;
   /** Chrome 可执行文件路径；留空时按常见安装位置自动探测 */
-  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 {
+  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;
   chromeDevtools: ChromeDevtoolsConfig;
   port: number;
-  gitTimeoutSeconds: number;
-  /** 若为 false，AI 生成过程中用户发送消息不会打断，须先点「停止」再发送新消息 */
-  allowInterrupt: boolean;
-  rawStreamLogs: RawStreamLogsConfig;
-  claude: ClaudeConfig;
-  cursor: CursorConfig;
-  codex: CodexConfig;
-}
+  gitTimeoutSeconds: number;
+  /** 若为 false，AI 生成过程中用户发送消息不会打断，须先点「停止」再发送新消息 */
+  allowInterrupt: boolean;
+  rawStreamLogs: RawStreamLogsConfig;
+  claude: ClaudeConfig;
+  cursor: CursorConfig;
+  codex: CodexConfig;
+}
 
 export type AgentTool = "claude" | "cursor" | "codex";
 export const AGENT_TOOLS: AgentTool[] = ["claude", "cursor", "codex"];
@@ -166,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);
@@ -358,51 +364,52 @@ function normalizeCursorAvatarBatteryMode(raw: unknown): CursorAvatarBatteryMode
   return raw === "onDemandUse" ? "onDemandUse" : "apiPercent";
 }
 
-function normalizeCursorOnDemandMonthlyBudget(raw: unknown): number {
-  const value = typeof raw === "string" ? Number(raw.trim()) : Number(raw);
-  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: "" },
-    platforms: { feishu: { enabled: true }, ilink: { enabled: true } },
-    chromeDevtools: { enabled: false, port: 15166, chromePath: "" },
-    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 },
+function normalizeCursorOnDemandMonthlyBudget(raw: unknown): number {
+  const value = typeof raw === "string" ? Number(raw.trim()) : Number(raw);
+  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: "" },
+    platforms: { feishu: { enabled: true }, ilink: { enabled: true } },
+    chromeDevtools: { enabled: false, port: 15166, chromePath: "" },
+    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) {
@@ -450,13 +457,14 @@ 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 };
-    chromeDevtools?: { enabled?: unknown; port?: unknown; chromePath?: unknown };
-    rawStreamLogs?: 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);
   } catch (err) {
@@ -466,12 +474,12 @@ function loadConfig(): AppConfig {
 
   const feishu = parsed.feishu ?? { appId: "", appSecret: "" };
   const claude = parsed.claude ?? {} as Partial<ClaudeConfig>;
-  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>
-    : {};
+  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 => {
@@ -502,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()),
     );
 
@@ -560,15 +570,15 @@ function loadConfig(): AppConfig {
         : 15166,
       chromePath: normalizeOptionalConfigField(chromeDevtoolsRaw.chromePath, { label: "chromeDevtools.chromePath" }),
     },
-    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: {
+    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",
       model: normalizeOptionalConfigField(claude.model, { label: "claude.model" }),
@@ -585,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),
     },
@@ -593,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 || '';
       }
     }