chatccc 0.2.222 → 0.2.224

package/src/config.ts

@@ -88,40 +88,45 @@ export interface CursorConfig {
   onDemandMonthlyBudget: number;
 }
 
-export interface CodexConfig {
-  /** 是否启用 Codex Agent；缺省时按"有任意字段非空"自动判定（向后兼容） */
-  enabled: boolean;
+export interface CodexConfig {
+  /** 是否启用 Codex Agent；缺省时按"有任意字段非空"自动判定（向后兼容） */
+  enabled: boolean;
   /** 是否作为 /new 未指定工具时使用的默认 Agent */
   defaultAgent: boolean;
   /** Codex CLI 可执行文件绝对路径；留空时退回到 PATH 中的 `codex` */
   path: string;
   model: string;
   /** /model 可切换的单个备选模型；留空则不加入候选列表 */
-  alternativeModel: string;
-  effort: string;
-  /** Codex Priority service tier. False explicitly forces the standard tier. */
-  fastMode: boolean;
-}
-
-export interface CccConfig {
-  /** Whether the built-in CCC Agent is available for new sessions. */
-  enabled: boolean;
-  /** Whether /new without an explicit tool should use CCC Agent. */
-  defaultAgent: boolean;
-  /** DeepSeek API Key for the ChatCCC self-developed agent. */
-  DEEPSEEK_API_KEY: string;
-  /** DeepSeek-compatible API Base URL for the ChatCCC self-developed agent. */
-  DEEPSEEK_BASE_URL: string;
-  /** Model used by the ChatCCC self-developed agent. */
-  model: string;
-  /** Optional model exposed through /model for manual per-session switching. */
-  alternativeModel: string;
-}
-
-export interface FeishuConfig {
-  appId: string;
-  appSecret: string;
-}
+  alternativeModel: string;
+  effort: string;
+  /** Codex Priority service tier. False explicitly forces the standard tier. */
+  fastMode: boolean;
+}
+
+export interface CccConfig {
+  /** Whether the built-in CCC Agent is available for new sessions. */
+  enabled: boolean;
+  /** Whether /new without an explicit tool should use CCC Agent. */
+  defaultAgent: boolean;
+  /** DeepSeek API Key for the ChatCCC self-developed agent. */
+  DEEPSEEK_API_KEY: string;
+  /** DeepSeek-compatible API Base URL for the ChatCCC self-developed agent. */
+  DEEPSEEK_BASE_URL: string;
+  /** Model used by the ChatCCC self-developed agent. */
+  model: string;
+  /** Optional model exposed through /model for manual per-session switching. */
+  alternativeModel: string;
+  /**
+   * Reasoning effort (none/minimal/low/medium/high/xhigh/max)，透传到
+   * DeepSeek reasoning_effort 请求字段；留空表示不传（服务端默认 medium）。
+   */
+  effort: string;
+}
+
+export interface FeishuConfig {
+  appId: string;
+  appSecret: string;
+}
 
 export interface PlatformConfig {
   enabled: boolean;
@@ -151,39 +156,39 @@ export interface RawStreamAgentLogConfig {
   keepCompleted: boolean;
 }
 
-export interface RawStreamLogsConfig {
-  claude: RawStreamAgentLogConfig;
-  cursor: RawStreamAgentLogConfig;
-  codex: RawStreamAgentLogConfig;
-  ccc: RawStreamAgentLogConfig;
-}
-
-export interface AppConfig {
-  feishu: FeishuConfig;
-  platforms: PlatformsConfig;
-  webUi: { openOnStart: boolean };
-  chromeDevtools: ChromeDevtoolsConfig;
+export interface RawStreamLogsConfig {
+  claude: RawStreamAgentLogConfig;
+  cursor: RawStreamAgentLogConfig;
+  codex: RawStreamAgentLogConfig;
+  ccc: RawStreamAgentLogConfig;
+}
+
+export interface AppConfig {
+  feishu: FeishuConfig;
+  platforms: PlatformsConfig;
+  webUi: { openOnStart: boolean };
+  chromeDevtools: ChromeDevtoolsConfig;
   port: number;
   gitTimeoutSeconds: number;
   /** 若为 false，AI 生成过程中用户发送消息不会打断，须先点「停止」再发送新消息 */
   allowInterrupt: boolean;
   rawStreamLogs: RawStreamLogsConfig;
-  claude: ClaudeConfig;
-  cursor: CursorConfig;
-  codex: CodexConfig;
-  ccc: CccConfig;
-}
-
-export type AgentTool = "claude" | "cursor" | "codex" | "ccc";
-export const AGENT_TOOLS: AgentTool[] = ["claude", "cursor", "codex", "ccc"];
+  claude: ClaudeConfig;
+  cursor: CursorConfig;
+  codex: CodexConfig;
+  ccc: CccConfig;
+}
+
+export type AgentTool = "claude" | "cursor" | "codex" | "ccc";
+export const AGENT_TOOLS: AgentTool[] = ["claude", "cursor", "codex", "ccc"];
 export type CursorAvatarBatteryMode = "apiPercent" | "onDemandUse";
 
 /** 获取指定 agent 配置中所有模型相关的值（最多 100 个，去重） */
-export function getAllModelsForTool(tool: string, cfg: AppConfig = config): string[] {
-  const seen = new Set<string>();
-  const collect = (v: unknown) => {
-    if (typeof v === "string" && v.trim()) seen.add(v.trim());
-  };
+export function getAllModelsForTool(tool: string, cfg: AppConfig = config): string[] {
+  const seen = new Set<string>();
+  const collect = (v: unknown) => {
+    if (typeof v === "string" && v.trim()) seen.add(v.trim());
+  };
 
   if (tool === "claude") {
     collect(cfg.claude.model);
@@ -191,36 +196,39 @@ export function getAllModelsForTool(tool: string, cfg: AppConfig = config): stri
   } else if (tool === "cursor") {
     collect(cfg.cursor.model);
     collect(cfg.cursor.alternativeModel);
-  } else if (tool === "codex") {
-    collect(cfg.codex.model);
-    collect(cfg.codex.alternativeModel);
-  } else if (tool === "ccc") {
-    collect(cfg.ccc.model);
-    collect(cfg.ccc.alternativeModel);
-  }
-
-  return Array.from(seen).slice(0, 100);
-}
-
-export const CLAUDE_EFFORT_LEVELS = ["low", "medium", "high", "xhigh", "max"] as const;
-export const CODEX_EFFORT_LEVELS = ["minimal", "low", "medium", "high", "xhigh"] as const;
-
-export function getAllEffortsForTool(tool: string): string[] {
-  if (tool === "claude") return [...CLAUDE_EFFORT_LEVELS];
-  if (tool === "codex") return [...CODEX_EFFORT_LEVELS];
-  return [];
-}
-
-export function getDefaultEffortForTool(tool: AgentTool, cfg: AppConfig = config): string {
-  if (tool === "claude") return cfg.claude.effort;
-  if (tool === "codex") return cfg.codex.effort;
-  return "";
-}
-
-const CONFIG_FILE = join(USER_DATA_DIR, "config.json");
-const CONFIG_SAMPLE_FILE = join(PROJECT_ROOT, "config.sample.json");
-export const DEFAULT_CCC_DEEPSEEK_BASE_URL = "https://api.deepseek.com/v1";
-export const DEFAULT_CCC_MODEL = "deepseek-v4-pro";
+  } else if (tool === "codex") {
+    collect(cfg.codex.model);
+    collect(cfg.codex.alternativeModel);
+  } else if (tool === "ccc") {
+    collect(cfg.ccc.model);
+    collect(cfg.ccc.alternativeModel);
+  }
+
+  return Array.from(seen).slice(0, 100);
+}
+
+export const CLAUDE_EFFORT_LEVELS = ["low", "medium", "high", "xhigh", "max"] as const;
+export const CODEX_EFFORT_LEVELS = ["minimal", "low", "medium", "high", "xhigh"] as const;
+export const CCC_EFFORT_LEVELS = ["none", "minimal", "low", "medium", "high", "xhigh", "max"] as const;
+
+export function getAllEffortsForTool(tool: string): string[] {
+  if (tool === "claude") return [...CLAUDE_EFFORT_LEVELS];
+  if (tool === "codex") return [...CODEX_EFFORT_LEVELS];
+  if (tool === "ccc") return [...CCC_EFFORT_LEVELS];
+  return [];
+}
+
+export function getDefaultEffortForTool(tool: AgentTool, cfg: AppConfig = config): string {
+  if (tool === "claude") return cfg.claude.effort;
+  if (tool === "codex") return cfg.codex.effort;
+  if (tool === "ccc") return cfg.ccc.effort;
+  return "";
+}
+
+const CONFIG_FILE = join(USER_DATA_DIR, "config.json");
+const CONFIG_SAMPLE_FILE = join(PROJECT_ROOT, "config.sample.json");
+export const DEFAULT_CCC_DEEPSEEK_BASE_URL = "https://api.deepseek.com/v1";
+export const DEFAULT_CCC_MODEL = "deepseek-v4-pro";
 
 /**
  * 将旧位置（PROJECT_ROOT）的持久化数据一次性迁移到 USER_DATA_DIR。
@@ -428,20 +436,20 @@ function normalizeRawStreamAgentLogConfig(raw: unknown): RawStreamAgentLogConfig
 
 function loadConfig(): AppConfig {
   const defaults: AppConfig = {
-    feishu: { appId: "", appSecret: "" },
-    platforms: { feishu: { enabled: true }, ilink: { enabled: true } },
-    webUi: { openOnStart: true },
-    chromeDevtools: { enabled: false, port: 15166, chromePath: "" },
+    feishu: { appId: "", appSecret: "" },
+    platforms: { feishu: { enabled: true }, ilink: { enabled: true } },
+    webUi: { openOnStart: 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 },
-      ccc: { enabled: false, maxBytesPerTurn: 50 * 1024 * 1024, retentionDays: 7, keepCompleted: false },
-    },
-    claude: { enabled: false, defaultAgent: true, model: "", subagentModel: "", effort: "", apiKey: "", baseUrl: "", maxTurn: 0 },
+    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 },
+      ccc: { 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,
@@ -450,17 +458,18 @@ function loadConfig(): AppConfig {
       alternativeModel: "",
       avatarBatteryMode: "apiPercent",
       onDemandMonthlyBudget: 1000,
-    },
-    codex: { enabled: false, defaultAgent: false, path: "", model: "", alternativeModel: "", effort: "", fastMode: false },
-    ccc: {
-      enabled: false,
-      defaultAgent: false,
-      DEEPSEEK_API_KEY: "",
-      DEEPSEEK_BASE_URL: DEFAULT_CCC_DEEPSEEK_BASE_URL,
-      model: DEFAULT_CCC_MODEL,
-      alternativeModel: "",
-    },
-  };
+    },
+    codex: { enabled: false, defaultAgent: false, path: "", model: "", alternativeModel: "", effort: "", fastMode: false },
+    ccc: {
+      enabled: false,
+      defaultAgent: false,
+      DEEPSEEK_API_KEY: "",
+      DEEPSEEK_BASE_URL: DEFAULT_CCC_DEEPSEEK_BASE_URL,
+      model: DEFAULT_CCC_MODEL,
+      alternativeModel: "",
+      effort: "",
+    },
+  };
 
   if (!IS_TEST_ENV) {
     migrateLegacyData();
@@ -510,20 +519,21 @@ function loadConfig(): AppConfig {
       alternativeModel?: unknown;
       avatarBatteryMode?: unknown;
       onDemandMonthlyBudget?: unknown;
-    };
-    codex?: { enabled?: unknown; defaultAgent?: unknown; path?: unknown; command?: unknown; model?: unknown; alternativeModel?: unknown; effort?: unknown; fastMode?: unknown };
-    ccc?: {
-      enabled?: unknown;
-      defaultAgent?: unknown;
-      DEEPSEEK_API_KEY?: unknown;
-      DEEPSEEK_BASE_URL?: unknown;
-      model?: unknown;
-      alternativeModel?: unknown;
-    };
-    webUi?: { openOnStart?: 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; fastMode?: unknown };
+    ccc?: {
+      enabled?: unknown;
+      defaultAgent?: unknown;
+      DEEPSEEK_API_KEY?: unknown;
+      DEEPSEEK_BASE_URL?: unknown;
+      model?: unknown;
+      alternativeModel?: unknown;
+      effort?: unknown;
+    };
+    webUi?: { openOnStart?: unknown };
+    chromeDevtools?: { enabled?: unknown; port?: unknown; chromePath?: unknown };
+    rawStreamLogs?: unknown;
+  };
   try {
     parsed = JSON.parse(raw);
   } catch (err) {
@@ -533,11 +543,11 @@ 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 cccRaw = (parsed.ccc ?? {}) as NonNullable<typeof parsed.ccc>;
-  const webUiRaw = (parsed.webUi ?? {}) as NonNullable<typeof parsed.webUi>;
-  const chromeDevtoolsRaw = (parsed.chromeDevtools ?? {}) as NonNullable<typeof parsed.chromeDevtools>;
+  const cursorRaw = (parsed.cursor ?? {}) as NonNullable<typeof parsed.cursor>;
+  const codexRaw = (parsed.codex ?? {}) as NonNullable<typeof parsed.codex>;
+  const cccRaw = (parsed.ccc ?? {}) as NonNullable<typeof parsed.ccc>;
+  const webUiRaw = (parsed.webUi ?? {}) as NonNullable<typeof parsed.webUi>;
+  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>
     : {};
@@ -574,36 +584,36 @@ function loadConfig(): AppConfig {
       (typeof cursorRaw.model === "string" && (cursorRaw.model as string).trim()) ||
       (typeof cursorRaw.alternativeModel === "string" && (cursorRaw.alternativeModel as string).trim()),
     );
-  const codexNonEmpty = (): boolean =>
+  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()) ||
-      codexRaw.fastMode === true,
-    );
-  // 旧版 ccc 配置没有 enabled。只用 API Key 推断启用，避免 sample 中自带的
-  // 默认 Base URL / model 让升级用户在未配置凭证时意外启用 CCC Agent。
-  const cccNonEmpty = (): boolean =>
-    Boolean(typeof cccRaw.DEEPSEEK_API_KEY === "string" && cccRaw.DEEPSEEK_API_KEY.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,
+    );
+  // 旧版 ccc 配置没有 enabled。只用 API Key 推断启用，避免 sample 中自带的
+  // 默认 Base URL / model 让升级用户在未配置凭证时意外启用 CCC Agent。
+  const cccNonEmpty = (): boolean =>
+    Boolean(typeof cccRaw.DEEPSEEK_API_KEY === "string" && cccRaw.DEEPSEEK_API_KEY.trim());
 
   const claudeEnabled = resolveEnabled(claude.enabled, claudeNonEmpty);
   const cursorEnabled = resolveEnabled(cursorRaw.enabled, cursorNonEmpty);
-  const codexEnabled = resolveEnabled(codexRaw.enabled, codexNonEmpty);
-  const cccEnabled = resolveEnabled(cccRaw.enabled, cccNonEmpty);
+  const codexEnabled = resolveEnabled(codexRaw.enabled, codexNonEmpty);
+  const cccEnabled = resolveEnabled(cccRaw.enabled, cccNonEmpty);
   const chromeDevtoolsPort = Number(chromeDevtoolsRaw.port);
   const explicitDefaultTool: AgentTool | null =
     typeof claude.defaultAgent === "boolean" && claude.defaultAgent && claudeEnabled ? "claude" :
     typeof cursorRaw.defaultAgent === "boolean" && cursorRaw.defaultAgent && cursorEnabled ? "cursor" :
-    typeof codexRaw.defaultAgent === "boolean" && codexRaw.defaultAgent && codexEnabled ? "codex" :
-    typeof cccRaw.defaultAgent === "boolean" && cccRaw.defaultAgent && cccEnabled ? "ccc" :
+    typeof codexRaw.defaultAgent === "boolean" && codexRaw.defaultAgent && codexEnabled ? "codex" :
+    typeof cccRaw.defaultAgent === "boolean" && cccRaw.defaultAgent && cccEnabled ? "ccc" :
     null;
   const fallbackDefaultTool: AgentTool =
     claudeEnabled ? "claude" :
     cursorEnabled ? "cursor" :
-    codexEnabled ? "codex" :
-    cccEnabled ? "ccc" :
+    codexEnabled ? "codex" :
+    cccEnabled ? "ccc" :
     "claude";
   const defaultTool = explicitDefaultTool ?? fallbackDefaultTool;
 
@@ -612,7 +622,7 @@ function loadConfig(): AppConfig {
       appId: feishu.appId ?? "",
       appSecret: feishu.appSecret ?? "",
     },
-    platforms: {
+    platforms: {
       feishu: {
         enabled: typeof (parsed.platforms as unknown as Record<string, unknown> | undefined)?.feishu === "object"
           ? Boolean(((parsed.platforms as unknown as Record<string, unknown>).feishu as Record<string, unknown>).enabled ?? true)
@@ -630,13 +640,13 @@ function loadConfig(): AppConfig {
         reuseTokenOnStart: typeof (parsed.platforms as unknown as Record<string, unknown> | undefined)?.ilink === "object"
           ? Boolean(((parsed.platforms as unknown as Record<string, unknown>).ilink as Record<string, unknown>).reuseTokenOnStart ?? true)
           : true,
-      },
-    },
-    webUi: {
-      // 兼容升级前没有 webUi 字段的 config.json：缺省仍按“自动打开”处理。
-      openOnStart: typeof webUiRaw.openOnStart === "boolean" ? webUiRaw.openOnStart : true,
-    },
-    chromeDevtools: {
+      },
+    },
+    webUi: {
+      // 兼容升级前没有 webUi 字段的 config.json：缺省仍按“自动打开”处理。
+      openOnStart: typeof webUiRaw.openOnStart === "boolean" ? webUiRaw.openOnStart : true,
+    },
+    chromeDevtools: {
       enabled: typeof chromeDevtoolsRaw.enabled === "boolean" ? chromeDevtoolsRaw.enabled : false,
       port: Number.isInteger(chromeDevtoolsPort) && chromeDevtoolsPort >= 1 && chromeDevtoolsPort <= 65535
         ? chromeDevtoolsPort
@@ -646,12 +656,12 @@ 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),
-      ccc: normalizeRawStreamAgentLogConfig(rawStreamLogsRaw.ccc),
-    },
+    rawStreamLogs: {
+      claude: normalizeRawStreamAgentLogConfig(rawStreamLogsRaw.claude),
+      cursor: normalizeRawStreamAgentLogConfig(rawStreamLogsRaw.cursor),
+      codex: normalizeRawStreamAgentLogConfig(rawStreamLogsRaw.codex),
+      ccc: normalizeRawStreamAgentLogConfig(rawStreamLogsRaw.ccc),
+    },
     claude: {
       enabled: claudeEnabled,
       defaultAgent: defaultTool === "claude",
@@ -673,28 +683,29 @@ function loadConfig(): AppConfig {
       avatarBatteryMode: normalizeCursorAvatarBatteryMode(cursorRaw.avatarBatteryMode),
       onDemandMonthlyBudget: normalizeCursorOnDemandMonthlyBudget(cursorRaw.onDemandMonthlyBudget),
     },
-    codex: {
-      enabled: codexEnabled,
-      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" }),
-      fastMode: codexRaw.fastMode === true,
-    },
-    ccc: {
-      enabled: cccEnabled,
-      defaultAgent: defaultTool === "ccc",
-      DEEPSEEK_API_KEY: normalizeOptionalConfigField(cccRaw.DEEPSEEK_API_KEY, { label: "ccc.DEEPSEEK_API_KEY" }),
-      DEEPSEEK_BASE_URL: normalizeOptionalConfigField(cccRaw.DEEPSEEK_BASE_URL, {
-        label: "ccc.DEEPSEEK_BASE_URL",
-        fallback: DEFAULT_CCC_DEEPSEEK_BASE_URL,
-      }),
-      model: normalizeOptionalConfigField(cccRaw.model, { label: "ccc.model", fallback: DEFAULT_CCC_MODEL }),
-      alternativeModel: normalizeOptionalConfigField(cccRaw.alternativeModel, { label: "ccc.alternativeModel" }),
-    },
-  };
-}
+    codex: {
+      enabled: codexEnabled,
+      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" }),
+      fastMode: codexRaw.fastMode === true,
+    },
+    ccc: {
+      enabled: cccEnabled,
+      defaultAgent: defaultTool === "ccc",
+      DEEPSEEK_API_KEY: normalizeOptionalConfigField(cccRaw.DEEPSEEK_API_KEY, { label: "ccc.DEEPSEEK_API_KEY" }),
+      DEEPSEEK_BASE_URL: normalizeOptionalConfigField(cccRaw.DEEPSEEK_BASE_URL, {
+        label: "ccc.DEEPSEEK_BASE_URL",
+        fallback: DEFAULT_CCC_DEEPSEEK_BASE_URL,
+      }),
+      model: normalizeOptionalConfigField(cccRaw.model, { label: "ccc.model", fallback: DEFAULT_CCC_MODEL }),
+      alternativeModel: normalizeOptionalConfigField(cccRaw.alternativeModel, { label: "ccc.alternativeModel" }),
+      effort: normalizeOptionalConfigField(cccRaw.effort, { label: "ccc.effort" }),
+    },
+  };
+}
 
 /**
  * 全局可变 config 对象。
@@ -1010,26 +1021,26 @@ export function explainMissingFeishuCredentialsAndExit(): never {
 export const CLAUDE_SESSION_PREFIX = "Claude Code Session:";
 /** 群描述中用于识别 Cursor 会话的前缀 */
 export const CURSOR_SESSION_PREFIX = "Cursor Session:";
-/** 群描述中用于识别 Codex 会话的前缀 */
-export const CODEX_SESSION_PREFIX = "Codex Session:";
-/** 群描述中用于识别 CCC Agent 会话的前缀 */
-export const CCC_SESSION_PREFIX = "CCC Session:";
+/** 群描述中用于识别 Codex 会话的前缀 */
+export const CODEX_SESSION_PREFIX = "Codex Session:";
+/** 群描述中用于识别 CCC Agent 会话的前缀 */
+export const CCC_SESSION_PREFIX = "CCC Session:";
 
 /** 根据 tool 名称返回对应的群描述前缀 */
-export function sessionPrefixForTool(tool: string): string {
-  if (tool === "cursor") return CURSOR_SESSION_PREFIX;
-  if (tool === "codex") return CODEX_SESSION_PREFIX;
-  if (tool === "ccc") return CCC_SESSION_PREFIX;
-  return CLAUDE_SESSION_PREFIX;
-}
+export function sessionPrefixForTool(tool: string): string {
+  if (tool === "cursor") return CURSOR_SESSION_PREFIX;
+  if (tool === "codex") return CODEX_SESSION_PREFIX;
+  if (tool === "ccc") return CCC_SESSION_PREFIX;
+  return CLAUDE_SESSION_PREFIX;
+}
 
 /** 根据 tool 名称返回用于状态展示的标签 */
-export function toolDisplayName(tool: string): string {
-  if (tool === "cursor") return "Cursor";
-  if (tool === "codex") return "Codex";
-  if (tool === "ccc") return "CCC Agent";
-  return "Claude Code";
-}
+export function toolDisplayName(tool: string): string {
+  if (tool === "cursor") return "Cursor";
+  if (tool === "codex") return "Codex";
+  if (tool === "ccc") return "CCC Agent";
+  return "Claude Code";
+}
 
 /** 解析 /new 未指定工具时使用的默认 Agent。旧配置缺省 defaultAgent 时保持 Claude 优先。 */
 export function resolveDefaultAgentTool(cfg: AppConfig = config): AgentTool {

package/src/progress/reducer.ts

@@ -0,0 +1,108 @@
+/**
+ * progress/reducer.ts — ChatEvent 事件流 → ProgressView 的增量合并
+ *
+ * 这是飞书与终端共享的唯一一份"事件 → 过程视图"公共逻辑：
+ * 终端 REPL 直接消费 ChatSession.chat() 的事件流，逐条 reduce；
+ * 飞书侧 display loop 若未来接入事件流，同样使用本 reducer，保证两端
+ * 看到的过程状态（正文累积、工具调用、终态判定）完全一致。
+ */
+
+import type { ChatEvent } from "../builtin/index.ts";
+import {
+  withProgressView,
+  type ProgressToolCall,
+  type ProgressView,
+} from "./view.ts";
+
+/** 工具调用 input 单行摘要（终端折叠行展示用） */
+export function summarizeToolInput(input: unknown, maxChars = 120): string {
+  let raw: string;
+  if (typeof input === "string") {
+    raw = input;
+  } else {
+    try {
+      raw = JSON.stringify(input);
+    } catch {
+      raw = String(input);
+    }
+  }
+  const oneLine = raw.replace(/\s+/g, " ").trim();
+  return oneLine.length > maxChars ? oneLine.slice(0, maxChars) + "…" : oneLine;
+}
+
+/** 工具结果单行摘要（成功/失败各取首行） */
+export function summarizeToolResult(content: unknown, maxChars = 120): string {
+  let raw: string;
+  if (typeof content === "string") {
+    raw = content;
+  } else if (content instanceof Error) {
+    raw = content.message;
+  } else {
+    try {
+      raw = JSON.stringify(content);
+    } catch {
+      raw = String(content);
+    }
+  }
+  const firstLine = raw.split("\n")[0] ?? "";
+  return firstLine.length > maxChars ? firstLine.slice(0, maxChars) + "…" : firstLine;
+}
+
+/**
+ * 把一条 ChatEvent 合并进 ProgressView，返回新视图（不可变更新）。
+ * 未识别的/不影响展示的事件（如 compact）返回原视图。
+ */
+export function reduceProgress(prev: ProgressView, event: ChatEvent): ProgressView {
+  switch (event.type) {
+    case "text":
+      // accumulated 是全文累积，直接全量替换，天然幂等
+      return withProgressView(prev, { text: event.accumulated });
+
+    case "tool_use": {
+      const tool: ProgressToolCall = {
+        id: event.id ?? `tool-${prev.tools.length + 1}`,
+        name: event.name,
+        status: "running",
+        detail: summarizeToolInput(event.input),
+      };
+      return withProgressView(prev, { tools: [...prev.tools, tool] });
+    }
+
+    case "tool_result": {
+      const nextStatus = event.is_error ? ("error" as const) : ("ok" as const);
+      const summary = summarizeToolResult(event.content);
+      let matched = false;
+      const tools = prev.tools.map((t) => {
+        if (matched || t.id !== event.tool_use_id) return t;
+        matched = true;
+        return { ...t, status: nextStatus, summary };
+      });
+      if (!matched) {
+        // id 缺失或失配：兜底更新最后一个 running 工具，避免状态悬挂
+        const lastRunning = [...prev.tools].reverse().findIndex((t) => t.status === "running");
+        if (lastRunning >= 0) {
+          const idx = prev.tools.length - 1 - lastRunning;
+          const updated = prev.tools.map((t, i) =>
+            i === idx ? { ...t, status: nextStatus, summary } : t,
+          );
+          return withProgressView(prev, { tools: updated });
+        }
+      }
+      return withProgressView(prev, { tools });
+    }
+
+    case "done":
+      return withProgressView(prev, {
+        status: "done",
+        showStop: false,
+        text: event.text,
+      });
+
+    case "error":
+      return withProgressView(prev, { status: "error", showStop: false });
+
+    case "compact":
+      // 旧上下文压缩不影响当前过程展示
+      return prev;
+  }
+}