chatccc 0.2.213 → 0.2.215

package/src/__tests__/session.test.ts

@@ -126,9 +126,12 @@ import {
   _setFinalResponseCloseTimeoutForTest,
   _resetFinalResponseCloseTimeoutForTest,
   setSessionEffortOverride,
+  getEffectiveFastModeForTool,
+  setSessionFastModeOverride,
   RESPONSE_STALL_RECOVERY_PROMPT,
   RESPONSE_STALL_RECOVERY_EXHAUSTED_NOTICE,
 } from "../session.ts";
+import { config } from "../config.ts";
 import {
   activePrompts,
   bindChatToSession,
@@ -145,7 +148,26 @@ import {
 } from "../session-chat-binding.ts";
 import type { AccumulatorState } from "../session.ts";
 import type { ToolAdapter, ToolPromptOptions, UnifiedBlock, SessionInfo } from "../adapters/adapter-interface.ts";
-import type { PlatformAdapter } from "../platform-adapter.ts";
+import type { PlatformAdapter } from "../platform-adapter.ts";
+
+describe("Codex Fast mode overrides", () => {
+  it("uses the global default until the current session overrides it", () => {
+    const previousFastMode = config.codex.fastMode;
+    config.codex.fastMode = false;
+    resetState();
+
+    expect(getEffectiveFastModeForTool("codex", "sid-fast")).toBe(false);
+    setSessionFastModeOverride("sid-fast", true);
+    expect(getEffectiveFastModeForTool("codex", "sid-fast")).toBe(true);
+    setSessionFastModeOverride("sid-fast", false);
+    expect(getEffectiveFastModeForTool("codex", "sid-fast")).toBe(false);
+    expect(getEffectiveFastModeForTool("claude", "sid-fast")).toBe(false);
+
+    resetState();
+    expect(getEffectiveFastModeForTool("codex", "sid-fast")).toBe(false);
+    config.codex.fastMode = previousFastMode;
+  });
+});
 
 // Helper to create a mock active session entry
 function mockActiveSession(chatId: string, overrides: Partial<{
@@ -1274,7 +1296,7 @@ describe("runAgentSession response stall watchdog", () => {
     expect(consumeQueued).not.toHaveBeenCalled();
 
     await vi.advanceTimersByTimeAsync(200);
-    expect(consumeQueued).toHaveBeenCalledTimes(1);
+    await vi.waitFor(() => expect(consumeQueued).toHaveBeenCalledTimes(1));
     expect(consumeQueued).toHaveBeenCalledWith(
       platform,
       expect.objectContaining({ text: "queued user prompt" }),

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

@@ -68,11 +68,12 @@ describe("unflattenConfig", () => {
     });
   });
 
-  it("maps Cursor and Codex alternative models into agent config", () => {
+  it("maps Cursor and Codex runtime settings into agent config", () => {
     expect(
       unflattenConfig({
         CHATCCC_CURSOR_ALTERNATIVE_MODEL: "gpt-5.5-high",
         CHATCCC_CODEX_ALTERNATIVE_MODEL: "gpt-5.3-codex",
+        CHATCCC_CODEX_FAST_MODE: true,
       }),
     ).toEqual({
       cursor: {
@@ -80,6 +81,7 @@ describe("unflattenConfig", () => {
       },
       codex: {
         alternativeModel: "gpt-5.3-codex",
+        fastMode: true,
       },
     });
   });
@@ -149,6 +151,7 @@ describe("getRestartRequiredReasons", () => {
       model: "",
       alternativeModel: "",
       effort: "",
+      fastMode: false,
     },
   };
 
@@ -159,7 +162,13 @@ describe("getRestartRequiredReasons", () => {
         chromeDevtools: { enabled: true, port: 15167, chromePath: "C:/Chrome/chrome.exe" },
         claude: { ...baseConfig.claude, model: "claude-sonnet", apiKey: "sk-test", maxTurn: 8 },
         cursor: { ...baseConfig.cursor, path: "C:/cursor-agent.cmd", model: "cursor-model" },
-        codex: { ...baseConfig.codex, path: "C:/codex.cmd", model: "gpt-5.3-codex", effort: "high" },
+        codex: {
+          ...baseConfig.codex,
+          path: "C:/codex.cmd",
+          model: "gpt-5.3-codex",
+          effort: "high",
+          fastMode: true,
+        },
       }),
     ).toEqual([]);
   });
@@ -211,6 +220,12 @@ describe("dashboard edit modal", () => {
     expect(PAGE_HTML).toContain("生效范围：飞书开关、App ID、App Secret 或平台类型变更需要重启 ChatCCC");
   });
 
+  it("shows the Codex Fast mode switch in both the wizard and dashboard", () => {
+    expect(PAGE_HTML).toContain('id="field-CHATCCC_CODEX_FAST_MODE"');
+    expect(PAGE_HTML).toContain('id="cfg-CODEX_FAST_MODE"');
+    expect(PAGE_HTML).toContain("Fast 模式");
+  });
+
   it("shows the Web UI startup switch in both the wizard and dashboard", () => {
     expect(PAGE_HTML).toContain('id="field-CHATCCC_WEB_UI_OPEN_ON_START"');
     expect(PAGE_HTML).toContain('id="cfg-WEB_UI_OPEN_ON_START"');

package/src/adapters/codex-adapter.ts

@@ -199,13 +199,12 @@ export function normalizeCodexMessage(
 // 子进程辅助函数
 // ---------------------------------------------------------------------------
 
-function spawnCodex(
+export function buildCodexInvocationArgs(
   args: string[],
-  cwd?: string,
-  stdinText?: string,
   modelOverride?: string,
   effortOverride?: string,
-): ChildProcess {
+  fastModeOverride?: boolean,
+): string[] {
   const allArgs = [...args];
   const model = modelOverride ?? resolveCodexModel();
   if (model) {
@@ -217,6 +216,25 @@ function spawnCodex(
   if (effort) {
     allArgs.push("-c", `model_reasoning_effort="${effort}"`);
   }
+  const fastMode = fastModeOverride ?? config.codex.fastMode;
+  allArgs.push("-c", `service_tier="${fastMode ? "fast" : "default"}"`);
+  return allArgs;
+}
+
+function spawnCodex(
+  args: string[],
+  cwd?: string,
+  stdinText?: string,
+  modelOverride?: string,
+  effortOverride?: string,
+  fastModeOverride?: boolean,
+): ChildProcess {
+  const allArgs = buildCodexInvocationArgs(
+    args,
+    modelOverride,
+    effortOverride,
+    fastModeOverride,
+  );
 
   const proc = spawn(detectCodexCommand(), allArgs, {
     cwd,
@@ -269,11 +287,18 @@ class CodexAdapter implements ToolAdapter {
   private metaStore: CodexSessionMetaStore;
   private modelOverride: string | undefined;
   private effortOverride: string | undefined;
+  private fastModeOverride: boolean | undefined;
 
-  constructor(metaStore: CodexSessionMetaStore, modelOverride?: string, effortOverride?: string) {
+  constructor(
+    metaStore: CodexSessionMetaStore,
+    modelOverride?: string,
+    effortOverride?: string,
+    fastModeOverride?: boolean,
+  ) {
     this.metaStore = metaStore;
     this.modelOverride = modelOverride;
     this.effortOverride = effortOverride;
+    this.fastModeOverride = fastModeOverride;
   }
 
   // createSession: 生成 sessionId，记录 cwd，不创建 Codex 线程（延迟到首次 prompt）
@@ -304,7 +329,14 @@ class CodexAdapter implements ToolAdapter {
       ? [...baseArgs, "-C", cwd, "-"]
       : [...baseArgs, "resume", threadId, "-"];
 
-    const proc = spawnCodex(args, cwd, buildCodexPromptText(userText), this.modelOverride, this.effortOverride);
+    const proc = spawnCodex(
+      args,
+      cwd,
+      buildCodexPromptText(userText),
+      this.modelOverride,
+      this.effortOverride,
+      this.fastModeOverride,
+    );
     if (proc.pid !== undefined) options?.onProcessStart?.({ pid: proc.pid });
 
     const rawLogConfig = config.rawStreamLogs.codex;
@@ -379,6 +411,7 @@ export interface CreateCodexAdapterOptions {
   /** per-session 模型覆盖（/model 命令）；传了就用，不传走全局 codex.model */
   model?: string;
   effort?: string;
+  fastMode?: boolean;
 }
 
 export function createCodexAdapter(
@@ -388,5 +421,6 @@ export function createCodexAdapter(
     options.metaStore ?? defaultCodexSessionMetaStore,
     options.model,
     options.effort,
+    options.fastMode,
   );
 }

package/src/cards.ts

@@ -553,8 +553,12 @@ export function buildModelCard(
     lines.push("", "没有可切换的模型。请在 config.json 中配置模型字段。");
   }
 
-  const buttons: ButtonDef[] = [];
-  for (const m of models.slice(0, 20)) {
+  if (tool === "codex") {
+    lines.push("输入 `/fast` 查看或切换当前会话的 Fast 模式");
+  }
+
+  const buttons: ButtonDef[] = [];
+  for (const m of models.slice(0, 20)) {
     const shortName = m.includes("/") ? m.slice(m.lastIndexOf("/") + 1) : m;
     buttons.push({
       text: `/model ${shortName}`,
@@ -574,6 +578,43 @@ export function buildModelCard(
   });
 }
 
+export function buildFastModeCard(enabled: boolean): string {
+  const mode = enabled ? "ON (Fast)" : "OFF (Standard)";
+  return JSON.stringify({
+    config: { wide_screen_mode: true },
+    header: {
+      template: enabled ? "green" : "blue",
+      title: { content: "Codex Fast 模式", tag: "plain_text" },
+    },
+    elements: [
+      {
+        tag: "div",
+        text: {
+          tag: "lark_md",
+          content: [
+            `**当前模式:** ${mode}`,
+            "",
+            "切换将在下一条消息生效，当前生成不中断。",
+          ].join("\n"),
+        },
+      },
+      { tag: "hr" },
+      buildButtons([
+        {
+          text: "ON",
+          value: JSON.stringify({ cmd: "/fast on" }),
+          type: enabled ? "primary" : "default",
+        },
+        {
+          text: "OFF",
+          value: JSON.stringify({ cmd: "/fast off" }),
+          type: enabled ? "default" : "primary",
+        },
+      ]),
+    ],
+  });
+}
+
 export function buildEffortCard(
   currentEffort: string,
   efforts: string[],

package/src/config.ts

@@ -97,8 +97,10 @@ export interface CodexConfig {
   path: string;
   model: string;
   /** /model 可切换的单个备选模型；留空则不加入候选列表 */
-  alternativeModel: string;
+  alternativeModel: string;
   effort: string;
+  /** Codex Priority service tier. False explicitly forces the standard tier. */
+  fastMode: boolean;
 }
 
 export interface CccConfig {
@@ -442,7 +444,7 @@ function loadConfig(): AppConfig {
       avatarBatteryMode: "apiPercent",
       onDemandMonthlyBudget: 1000,
     },
-    codex: { enabled: false, defaultAgent: false, path: "", model: "", alternativeModel: "", effort: "" },
+    codex: { enabled: false, defaultAgent: false, path: "", model: "", alternativeModel: "", effort: "", fastMode: false },
     ccc: { DEEPSEEK_API_KEY: "", DEEPSEEK_BASE_URL: DEFAULT_CCC_DEEPSEEK_BASE_URL, model: DEFAULT_CCC_MODEL },
   };
 
@@ -495,7 +497,7 @@ function loadConfig(): AppConfig {
       avatarBatteryMode?: unknown;
       onDemandMonthlyBudget?: unknown;
     };
-    codex?: { enabled?: unknown; defaultAgent?: unknown; path?: unknown; command?: unknown; model?: unknown; alternativeModel?: unknown; effort?: unknown };
+    codex?: { enabled?: unknown; defaultAgent?: unknown; path?: unknown; command?: unknown; model?: unknown; alternativeModel?: unknown; effort?: unknown; fastMode?: unknown };
     ccc?: { DEEPSEEK_API_KEY?: unknown; DEEPSEEK_BASE_URL?: unknown; model?: unknown };
     webUi?: { openOnStart?: unknown };
     chromeDevtools?: { enabled?: unknown; port?: unknown; chromePath?: unknown };
@@ -555,9 +557,10 @@ function loadConfig(): AppConfig {
     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()),
+      (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()) ||
+      codexRaw.fastMode === true,
     );
 
   const claudeEnabled = resolveEnabled(claude.enabled, claudeNonEmpty);
@@ -649,6 +652,7 @@ function loadConfig(): AppConfig {
       model: normalizeOptionalConfigField(codexRaw.model, { label: "codex.model" }),
       alternativeModel: normalizeOptionalConfigField(codexRaw.alternativeModel, { label: "codex.alternativeModel" }),
       effort: normalizeOptionalConfigField(codexRaw.effort, { label: "codex.effort" }),
+      fastMode: codexRaw.fastMode === true,
     },
     ccc: {
       DEEPSEEK_API_KEY: normalizeOptionalConfigField(cccRaw.DEEPSEEK_API_KEY, { label: "ccc.DEEPSEEK_API_KEY" }),

package/src/orchestrator.ts

@@ -39,6 +39,7 @@ import {
 import {
   buildHelpCard,
   buildEffortCard,
+  buildFastModeCard,
   buildModelCard,
   buildStatusCard,
   buildCdContent,
@@ -69,6 +70,8 @@ import {
   getAdapterForTool,
   getEffectiveModelForTool,
   getEffectiveEffortForTool,
+  getEffectiveFastModeForTool,
+  setSessionFastModeOverride,
   stopSession,
   loadSessionRegistryForBinding,
   removeSessionRegistryRecord,
@@ -325,11 +328,33 @@ function formatCursorUsageSummary(usage: CursorUsageSummary): string {
   ].filter(Boolean).join("\n");
 }
 
-function usageHelpLine(tool: string): string {
+function usageHelpLine(tool: string): string {
   if (tool === "codex") return "\n发送 **/usage** 查看 Codex 实际存在的 5h/7天用量窗口，以及查询/使用主动重置卡。";
   if (tool === "cursor") return "\n发送 **/usage** 查看 Cursor 用量。";
-  return "";
-}
+  return "";
+}
+
+function fastHelpAfterModel(tool: string): string {
+  return tool === "codex"
+    ? "\n发送 **/fast** 查看或切换当前会话的 Fast 模式。"
+    : "";
+}
+
+async function sendFastModeStatus(
+  platform: PlatformAdapter,
+  chatId: string,
+  enabled: boolean,
+): Promise<void> {
+  if (platform.kind === "wechat") {
+    const mode = enabled ? "ON (Fast)" : "OFF (Standard)";
+    await platform.sendText(
+      chatId,
+      `Codex Fast 模式: ${mode}\n输入 /fast on 或 /fast off 切换。切换将在下一条消息生效，当前生成不中断。`,
+    );
+    return;
+  }
+  await platform.sendRawCard(chatId, buildFastModeCard(enabled));
+}
 
 async function resolveUsageTarget(chatId: string): Promise<{ tool: "codex" | "cursor"; sessionId?: string }> {
   try {
@@ -1021,7 +1046,7 @@ export async function handleCommand(
           `**工作目录:** \`${cwd}\`\n\n` +
           `直接在这里发消息即可与 ${toolLabel} 对话。\n\n` +
           `发送 **/cd** 切换新建会话的默认目录。\n` +
-          `发送 **/model** 查看或切换当前会话的模型。\n` +
+          `发送 **/model** 查看或切换当前会话的模型。${fastHelpAfterModel(tool)}\n` +
           `发送 **/new** 创建新会话，**/newh** 重置当前会话（沿用工作目录）。\n` +
           `发送 **/sessions** 查看所有会话状态。\n` +
           `发送 \`/git <子命令>\` 在本会话工作目录执行 git，例如 \`/git status\`、\`/git log --oneline -n 5\`。` +
@@ -1109,7 +1134,7 @@ export async function handleCommand(
         `**工作目录:** \`${cwd}\`\n\n` +
         `直接在这里发消息即可与 ${toolLabel} 对话。\n\n` +
         `发送 **/cd** 切换新建会话的默认目录。\n` +
-        `发送 **/model** 查看或切换当前会话的模型。\n` +
+        `发送 **/model** 查看或切换当前会话的模型。${fastHelpAfterModel(tool)}\n` +
         `发送 **/new** 创建新会话，**/newh** 重置当前会话（沿用工作目录）。\n` +
         `发送 **/sessions** 查看所有会话状态。\n` +
         `发送 \`/git <子命令>\` 在本会话工作目录执行 git，例如 \`/git status\`、\`/git log --oneline -n 5\`。` +
@@ -1531,7 +1556,7 @@ export async function handleCommand(
           `**工作目录:** \`${cwd}\`${isFeishuP2p(platform, chatType) ? "（飞书私聊固定使用系统用户目录）" : "（沿用当前会话目录）"}\n\n` +
           `直接在这里发消息即可继续对话。\n` +
           `发送 **/cd** 可切换新建会话的默认目录。\n` +
-          `发送 **/model** 查看或切换当前会话的模型。`,
+          `发送 **/model** 查看或切换当前会话的模型。${fastHelpAfterModel(descriptionTool)}`,
         "green",
       );
 
@@ -1705,7 +1730,7 @@ export async function handleCommand(
           `**Session ID:** ${target.sessionId}\n` +
           `**工作目录:** \`${cwd2}\`\n\n` +
           `直接在这里发消息即可继续对话。\n` +
-          `发送 **/model** 查看或切换当前会话的模型。${busyNote}`,
+          `发送 **/model** 查看或切换当前会话的模型。${fastHelpAfterModel(descriptionTool)}${busyNote}`,
         "green",
       );
 
@@ -1718,7 +1743,44 @@ export async function handleCommand(
       return;
     }
 
-    // /model clear — 清除当前 session 的模型覆盖
+    if (isCommandText && (textLower === "/fast" || textLower.startsWith("/fast "))) {
+      const fastArg = text.slice(5).trim().toLowerCase();
+      logTrace(tid, "BRANCH", { cmd: "/fast", arg: fastArg, sessionId, tool: descriptionTool });
+
+      if (descriptionTool !== "codex") {
+        const msg = `当前 ${toolLabel} 会话不支持 Fast 模式；/fast 仅适用于 Codex。`;
+        await (platform.kind === "wechat"
+          ? platform.sendText(chatId, msg)
+          : platform.sendCard(chatId, "Codex Fast 模式", msg, "yellow")
+        ).catch(() => {});
+        logTrace(tid, "DONE", { outcome: "fast_unsupported", tool: descriptionTool });
+        return;
+      }
+
+      if (fastArg && fastArg !== "on" && fastArg !== "off") {
+        const msg = "用法: /fast、/fast on 或 /fast off";
+        await (platform.kind === "wechat"
+          ? platform.sendText(chatId, msg)
+          : platform.sendCard(chatId, "Codex Fast 模式", msg, "yellow")
+        ).catch(() => {});
+        logTrace(tid, "DONE", { outcome: "fast_invalid", arg: fastArg });
+        return;
+      }
+
+      if (fastArg) {
+        setSessionFastModeOverride(sessionId, fastArg === "on");
+      }
+      const enabled = getEffectiveFastModeForTool("codex", sessionId);
+      await sendFastModeStatus(platform, chatId, enabled).catch(() => {});
+      logTrace(tid, "DONE", {
+        outcome: fastArg ? "fast_switched" : "fast_query",
+        enabled,
+        sessionId,
+      });
+      return;
+    }
+
+    // /model clear — 清除当前 session 的模型覆盖
     if (isCommandText && textLower === "/model clear") {
       logTrace(tid, "BRANCH", { cmd: "/model clear", sessionId });
       clearSessionModelOverride(sessionId);
@@ -1776,12 +1838,15 @@ export async function handleCommand(
       if (platform.kind === "wechat") {
         const lines = [currentModel ? `当前模型 (${toolLabel}): ${currentModel}` : `当前模型 (${toolLabel}): 未指定`];
         if (models.length > 0) {
-          lines.push("", "可切换模型:");
-          for (const m of models) lines.push(`  ${m}`);
-          lines.push("", "输入 /model <模型名> 切换模型");
-        } else {
-          lines.push("", "没有可切换的模型。请在 config.json 中配置模型字段。");
-        }
+          lines.push("", "可切换模型:");
+          for (const m of models) lines.push(`  ${m}`);
+          lines.push("", "输入 /model <模型名> 切换模型");
+        } else {
+          lines.push("", "没有可切换的模型。请在 config.json 中配置模型字段。");
+        }
+        if (descriptionTool === "codex") {
+          lines.push("输入 /fast 查看或切换当前会话的 Fast 模式");
+        }
         await platform.sendText(chatId, lines.join("\n")).catch(() => {});
       } else {
         const card = buildModelCard(currentModel, models, descriptionTool);
@@ -2022,7 +2087,34 @@ export async function handleCommand(
     return;
   }
 
-  // 无会话上下文 → 检查是否是 /model 查询
+  if (isCommandText && (textLower === "/fast" || textLower.startsWith("/fast "))) {
+    const defaultTool = resolveDefaultAgentTool();
+    const fastArg = text.slice(5).trim().toLowerCase();
+    if (defaultTool !== "codex") {
+      const msg = `当前默认 Agent (${toolDisplayName(defaultTool)}) 不支持 Fast 模式；/fast 仅适用于 Codex。`;
+      await (platform.kind === "wechat"
+        ? platform.sendText(chatId, msg)
+        : platform.sendCard(chatId, "Codex Fast 模式", msg, "yellow")
+      ).catch(() => {});
+      logTrace(tid, "DONE", { outcome: "fast_unsupported", defaultTool });
+      return;
+    }
+    if (fastArg) {
+      const msg = "当前没有绑定 Codex 会话，无法设置会话覆盖。请先创建或进入 Codex 会话；全局默认值可在 Web UI 中设置。";
+      await (platform.kind === "wechat"
+        ? platform.sendText(chatId, msg)
+        : platform.sendCard(chatId, "Codex Fast 模式", msg, "yellow")
+      ).catch(() => {});
+      logTrace(tid, "DONE", { outcome: "fast_no_session", arg: fastArg });
+      return;
+    }
+    const enabled = getEffectiveFastModeForTool("codex");
+    await sendFastModeStatus(platform, chatId, enabled).catch(() => {});
+    logTrace(tid, "DONE", { outcome: "fast_query", enabled, defaultTool });
+    return;
+  }
+
+  // 无会话上下文 → 检查是否是 /model 查询
   if (isCommandText && textLower === "/model") {
     const defaultTool = resolveDefaultAgentTool();
     const models = getAllModelsForTool(defaultTool);
@@ -2034,12 +2126,15 @@ export async function handleCommand(
     if (platform.kind === "wechat") {
       const lines = [currentModel ? `当前模型 (${defaultTool}): ${currentModel}` : `当前模型 (${defaultTool}): 未指定`];
       if (models.length > 0) {
-        lines.push("", "可切换模型:");
-        for (const m of models) lines.push(`  ${m}`);
-        lines.push("", "在会话中输入 /model <模型名> 切换模型");
-      } else {
-        lines.push("", "没有可切换的模型。请在 config.json 中配置模型字段。");
-      }
+        lines.push("", "可切换模型:");
+        for (const m of models) lines.push(`  ${m}`);
+        lines.push("", "在会话中输入 /model <模型名> 切换模型");
+      } else {
+        lines.push("", "没有可切换的模型。请在 config.json 中配置模型字段。");
+      }
+      if (defaultTool === "codex") {
+        lines.push("输入 /fast 查看当前 Codex Fast 模式");
+      }
       await platform.sendText(chatId, lines.join("\n")).catch(() => {});
     } else {
       const card = buildModelCard(currentModel, models, defaultTool);

package/src/session.ts

@@ -475,6 +475,7 @@ export function resetState(): void {
   displayCards.clear();
   sessionModelOverrides.clear();
   sessionEffortOverrides.clear();
+  sessionFastModeOverrides.clear();
   adapterCache.clear();
   stopUnifiedDisplayLoop();
   console.log(`[${ts()}] [RESET] State cleared (dedup + active sessions + bindings)`);
@@ -492,6 +493,7 @@ const adapterCache = new Map<string, ToolAdapter>();
 // Per-session 模型覆盖（/model 命令设置，不持久化）
 const sessionModelOverrides = new Map<string, string>();
 const sessionEffortOverrides = new Map<string, string>();
+const sessionFastModeOverrides = new Map<string, boolean>();
 
 /** 返回 session 的生效模型：优先 per-session 覆盖，其次全局配置（Claude） */
 function getModelForSession(sessionId?: string): string {
@@ -524,6 +526,14 @@ export function getEffectiveEffortForTool(tool: string, sessionId?: string): str
   }
   return "";
 }
+
+export function getEffectiveFastModeForTool(tool: string, sessionId?: string): boolean {
+  if (tool !== "codex") return false;
+  if (sessionId && sessionFastModeOverrides.has(sessionId)) {
+    return sessionFastModeOverrides.get(sessionId) === true;
+  }
+  return config.codex.fastMode;
+}
 
 /** 为指定 session 设置模型覆盖（/model <name>） */
 export function setSessionModelOverride(sessionId: string, model: string): void {
@@ -547,10 +557,16 @@ export function clearSessionEffortOverride(sessionId: string): void {
   adapterCache.clear();
 }
 
+export function setSessionFastModeOverride(sessionId: string, fastMode: boolean): void {
+  sessionFastModeOverrides.set(sessionId, fastMode);
+  adapterCache.clear();
+}
+
 export function getAdapterForTool(tool: string, sessionId?: string): ToolAdapter {
   const effectiveModel = getEffectiveModelForTool(tool, sessionId);
   const effectiveEffort = getEffectiveEffortForTool(tool, sessionId);
-  const cacheKey = `${tool}:${effectiveModel || ""}:${effectiveEffort || ""}`;
+  const effectiveFastMode = getEffectiveFastModeForTool(tool, sessionId);
+  const cacheKey = `${tool}:${effectiveModel || ""}:${effectiveEffort || ""}:${effectiveFastMode ? "fast" : "default"}`;
   const cached = adapterCache.get(cacheKey);
   if (cached) return cached;
 
@@ -558,7 +574,11 @@ export function getAdapterForTool(tool: string, sessionId?: string): ToolAdapter
   if (tool === "cursor") {
     adapter = createCursorAdapter({ model: effectiveModel || undefined });
   } else if (tool === "codex") {
-    adapter = createCodexAdapter({ model: effectiveModel || undefined, effort: effectiveEffort || undefined });
+    adapter = createCodexAdapter({
+      model: effectiveModel || undefined,
+      effort: effectiveEffort || undefined,
+      fastMode: effectiveFastMode,
+    });
   } else if (tool === "ccc") {
     adapter = createCccAdapter({ model: effectiveModel || undefined });
   } else {
@@ -1009,7 +1029,7 @@ function formatToolConfigForLog(tool: string, sessionModel?: string, sessionId?:
     const effortStr = e.trim() !== ""
       ? `effort=${e}`
       : "effort=(由 codex config.toml 决定)";
-    return `model=${modelStr}, ${effortStr}`;
+    return `model=${modelStr}, ${effortStr}, fast=${getEffectiveFastModeForTool(tool, sessionId) ? "on" : "off"}`;
   }
   if (tool === "ccc") {
     const m = getEffectiveModelForTool(tool, sessionId);
@@ -2406,9 +2426,10 @@ export async function getAllSessionsStatus(): Promise<SessionsListEntry[]> {
 export function _setAdapterForToolForTest(tool: string, adapter: ToolAdapter): void {
   adapterCache.set(tool, adapter);
   // 同时设置当前配置模型对应的 key（getAdapterForTool 会优先 lookup 含 model 的 key）
-  const effective = getEffectiveModelForTool(tool);
+  const effective = getEffectiveModelForTool(tool);
   const effort = getEffectiveEffortForTool(tool);
-  adapterCache.set(`${tool}:${effective || ""}:${effort || ""}`, adapter);
+  const fastMode = getEffectiveFastModeForTool(tool);
+  adapterCache.set(`${tool}:${effective || ""}:${effort || ""}:${fastMode ? "fast" : "default"}`, adapter);
   if (effective) adapterCache.set(`${tool}:${effective}`, adapter);
 }