chatccc 0.2.186 → 0.2.188

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,25 +82,38 @@ export interface CursorConfig {
   /** Cursor Agent CLI 可执行文件绝对路径；留空时由运行时按 LocalAppData / PATH 兜底 */
   path: string;
   model: string;
+  /** /model 可切换的单个备选模型；留空则不加入候选列表 */
+  alternativeModel: string;
   avatarBatteryMode: CursorAvatarBatteryMode;
   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;
-  effort: string;
-}
-
-export interface FeishuConfig {
-  appId: string;
-  appSecret: string;
-}
+  /** /model 可切换的单个备选模型；留空则不加入候选列表 */
+  alternativeModel: string;
+  effort: string;
+}
+
+export interface CccConfig {
+  /** 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;
+}
+
+export interface FeishuConfig {
+  appId: string;
+  appSecret: string;
+}
 
 export interface PlatformConfig {
   enabled: boolean;
@@ -114,40 +127,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;
+  gitTimeoutSeconds: number;
+  /** 若为 false，AI 生成过程中用户发送消息不会打断，须先点「停止」再发送新消息 */
+  allowInterrupt: boolean;
+  rawStreamLogs: RawStreamLogsConfig;
   claude: ClaudeConfig;
   cursor: CursorConfig;
   codex: CodexConfig;
+  ccc: CccConfig;
 }
 
 export type AgentTool = "claude" | "cursor" | "codex";
@@ -155,26 +169,45 @@ export const AGENT_TOOLS: AgentTool[] = ["claude", "cursor", "codex"];
 export type CursorAvatarBatteryMode = "apiPercent" | "onDemandUse";
 
 /** 获取指定 agent 配置中所有模型相关的值（最多 100 个，去重） */
-export function getAllModelsForTool(tool: AgentTool, 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: AgentTool, 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);
     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);
-}
-
-const CONFIG_FILE = join(USER_DATA_DIR, "config.json");
-const CONFIG_SAMPLE_FILE = join(PROJECT_ROOT, "config.sample.json");
+
+  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: AgentTool): 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[1m]";
 
 /**
  * 将旧位置（PROJECT_ROOT）的持久化数据一次性迁移到 USER_DATA_DIR。
@@ -358,40 +391,40 @@ 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 },
+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: {
@@ -399,11 +432,13 @@ function loadConfig(): AppConfig {
       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: "" },
+    ccc: { DEEPSEEK_API_KEY: "", DEEPSEEK_BASE_URL: DEFAULT_CCC_DEEPSEEK_BASE_URL, model: DEFAULT_CCC_MODEL },
+  };
 
   if (!IS_TEST_ENV) {
     migrateLegacyData();
@@ -450,10 +485,12 @@ 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 };
+    ccc?: { DEEPSEEK_API_KEY?: unknown; DEEPSEEK_BASE_URL?: unknown; model?: unknown };
     chromeDevtools?: { enabled?: unknown; port?: unknown; chromePath?: unknown };
     rawStreamLogs?: unknown;
   };
@@ -468,10 +505,11 @@ function loadConfig(): AppConfig {
   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 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 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 +540,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 +600,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,18 +625,28 @@ 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),
     },
-    codex: {
-      enabled: codexEnabled,
-      defaultAgent: defaultTool === "codex",
-      path: readToolCliPath(codexRaw, { label: "codex", onLegacyField }),
-      model: normalizeOptionalConfigField(codexRaw.model, { label: "codex.model" }),
-      effort: normalizeOptionalConfigField(codexRaw.effort, { label: "codex.effort" }),
-    },
-  };
-}
+    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" }),
+    },
+    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 }),
+    },
+  };
+}
 
 /**
  * 全局可变 config 对象。