chatccc 0.2.55 → 0.2.56

package/README.md

@@ -158,7 +158,8 @@ Codex 的默认模型和推理强度可继续由 `~/.codex/config.toml` 管理
   "claude": {
     "enabled": false,
     "defaultAgent": true,
-    "model": "",
+    "model": "claude-sonnet-4-6",
+    "subagentModel": "",
     "effort": "",
     "apiKey": "",
     "baseUrl": ""
@@ -189,6 +190,7 @@ Codex 的默认模型和推理强度可继续由 `~/.codex/config.toml` 管理
 | `*.enabled` | 是否启用对应 AI Agent |
 | `*.defaultAgent` | `/new` 未指定 Agent 时使用哪个工具 |
 | `cursor.path` / `codex.path` | CLI 可执行文件路径；留空时自动探测或使用 PATH |
+| `claude.model` / `claude.subagentModel` | Claude Code 主模型 / subagent 模型；`subagentModel` 仅在第三方 API 模式下注入 `CLAUDE_CODE_SUBAGENT_MODEL` |
 | `claude.apiKey` / `claude.baseUrl` | 第三方 Anthropic 兼容网关配置；官方 Claude 用户留空 |
 
 > 当前 ChatCCC 以 `bypassPermissions` 模式运行，会跳过 Agent 操作确认。请只在可信环境中使用。

package/config.sample.json

@@ -13,7 +13,8 @@
   "claude": {
     "enabled": false,
     "defaultAgent": true,
-    "model": "",
+    "model": "claude-sonnet-4-6",
+    "subagentModel": "",
     "effort": "",
     "apiKey": "",
     "baseUrl": ""

package/package.json

@@ -1,59 +1,59 @@
-{
-  "name": "chatccc",
-  "version": "0.2.55",
-  "description": "Feishu bot bridge for Claude Code",
-  "license": "Apache-2.0",
-  "type": "module",
-  "main": "./src/index.ts",
-  "bin": {
-    "chatccc": "bin/chatccc.mjs"
-  },
-  "files": [
-    "src/",
-    "bin/",
-    "demo/ilink_echo_probe.ts",
-    "im-skills/",
-    "images/img_readme_*.jpg",
-    "images/img_readme_*.png",
-    "images/avatars/status_*.png",
-    "images/avatars/badges/",
-    "package.json",
-    "README.md",
-    "config.sample.json"
-  ],
-  "scripts": {
-    "dev": "tsx src/index.ts",
-    "chatccc": "tsx src/index.ts",
-    "start": "tsx src/index.ts",
-    "demo:bot-test": "tsx demo/bot_test.ts",
-    "demo:bot-test:local": "tsx demo/bot_test.ts --local",
-    "demo:create-group": "tsx src/index.ts",
-    "demo:create-group:local": "tsx src/index.ts --local",
-    "demo:permission-check": "tsx demo/permission_check.ts",
-    "demo:claude-hi": "tsx demo/claude_say_hi.ts",
-    "demo:codex-hi": "tsx demo/codex_say_hi.ts",
-    "demo:ilink-echo": "tsx demo/ilink_echo_probe.ts",
-    "test": "vitest run",
-    "test:watch": "vitest"
-  },
-  "dependencies": {
-    "@anthropic-ai/claude-agent-sdk": "0.2.133",
-    "@larksuiteoapi/node-sdk": "^1.59.0",
-    "@openilink/openilink-sdk-node": "^0.6.0",
-    "nodemailer": "^8.0.7",
-    "qrcode-terminal": "^0.12.0",
-    "sharp": "^0.34.5",
-    "tsx": "^4.0.0",
-    "ws": "^8.18.0"
-  },
-  "devDependencies": {
-    "@types/node": "^20.0.0",
-    "@types/qrcode-terminal": "^0.12.2",
-    "@types/ws": "^8.18.1",
-    "typescript": "^5.0.0",
-    "vitest": "^4.1.5"
-  },
-  "engines": {
-    "node": ">=20"
-  }
-}
+{
+  "name": "chatccc",
+  "version": "0.2.56",
+  "description": "Feishu bot bridge for Claude Code",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "./src/index.ts",
+  "bin": {
+    "chatccc": "bin/chatccc.mjs"
+  },
+  "files": [
+    "src/",
+    "bin/",
+    "demo/ilink_echo_probe.ts",
+    "im-skills/",
+    "images/img_readme_*.jpg",
+    "images/img_readme_*.png",
+    "images/avatars/status_*.png",
+    "images/avatars/badges/",
+    "package.json",
+    "README.md",
+    "config.sample.json"
+  ],
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "chatccc": "tsx src/index.ts",
+    "start": "tsx src/index.ts",
+    "demo:bot-test": "tsx demo/bot_test.ts",
+    "demo:bot-test:local": "tsx demo/bot_test.ts --local",
+    "demo:create-group": "tsx src/index.ts",
+    "demo:create-group:local": "tsx src/index.ts --local",
+    "demo:permission-check": "tsx demo/permission_check.ts",
+    "demo:claude-hi": "tsx demo/claude_say_hi.ts",
+    "demo:codex-hi": "tsx demo/codex_say_hi.ts",
+    "demo:ilink-echo": "tsx demo/ilink_echo_probe.ts",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "0.2.133",
+    "@larksuiteoapi/node-sdk": "^1.59.0",
+    "@openilink/openilink-sdk-node": "^0.6.0",
+    "nodemailer": "^8.0.7",
+    "qrcode-terminal": "^0.12.0",
+    "sharp": "^0.34.5",
+    "tsx": "^4.0.0",
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/qrcode-terminal": "^0.12.2",
+    "@types/ws": "^8.18.1",
+    "typescript": "^5.0.0",
+    "vitest": "^4.1.5"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}

package/src/__tests__/claude-adapter.test.ts

@@ -788,6 +788,45 @@ describe("createClaudeAdapter — env 注入", () => {
     expect(opts.env.ANTHROPIC_BASE_URL).toBe("https://gateway.example/anthropic");
   });
 
+  it("官方 API 模式下 subagentModel 不注入 env，也不覆盖 Claude 登录环境", async () => {
+    setupMockCreateSession();
+    process.env.CLAUDE_CODE_OAUTH_TOKEN = "oauth-from-login";
+    const adapter = createClaudeAdapter({
+      model: "claude-sonnet-4-6",
+      subagentModel: "claude-haiku-4-5-20251001",
+      effort: "",
+      isEmpty: (v) => v.trim() === "",
+      apiKey: "",
+      baseUrl: "",
+    });
+
+    await adapter.createSession("/cwd");
+
+    const opts = sdk.unstable_v2_createSession.mock.calls[0][0];
+    expect(opts).not.toHaveProperty("env");
+  });
+
+  it("第三方 API 模式下 subagentModel 通过 CLAUDE_CODE_SUBAGENT_MODEL 覆盖 Haiku", async () => {
+    setupMockCreateSession();
+    process.env.CLAUDE_CODE_OAUTH_TOKEN = "oauth-from-login";
+    const adapter = createClaudeAdapter({
+      model: "claude-sonnet-4-6",
+      subagentModel: "claude-haiku-4-5-20251001",
+      effort: "",
+      isEmpty: (v) => v.trim() === "",
+      apiKey: "sk-thirdparty",
+      baseUrl: "https://gateway.example/anthropic",
+    });
+
+    await adapter.createSession("/cwd");
+
+    const opts = sdk.unstable_v2_createSession.mock.calls[0][0];
+    expect(opts.model).toBe("claude-sonnet-4-6");
+    expect(opts.env.ANTHROPIC_API_KEY).toBe("sk-thirdparty");
+    expect(opts.env.CLAUDE_CODE_SUBAGENT_MODEL).toBe("claude-haiku-4-5-20251001");
+    expect(opts.env.CLAUDE_CODE_OAUTH_TOKEN).toBeUndefined();
+  });
+
   it("ChatCCC API config is isolated from Claude settings auth/model env", async () => {
     setupMockCreateSession();
     process.env.ANTHROPIC_AUTH_TOKEN = "token-from-claude-settings";

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

@@ -12,6 +12,7 @@ import {
   CLAUDE_BASE_URL,
   CLAUDE_EFFORT,
   CLAUDE_MODEL,
+  CLAUDE_SUBAGENT_MODEL,
   CURSOR_AGENT_ARGS,
   CURSOR_AGENT_COMMAND,
   FEISHU_ENABLED,
@@ -45,6 +46,7 @@ const baseAppConfig: AppConfig = {
     enabled: true,
     defaultAgent: true,
     model: "initial-model",
+    subagentModel: "initial-subagent-model",
     effort: "initial-effort",
     apiKey: "sk-initial",
     baseUrl: "https://initial.gw/anthropic",
@@ -78,20 +80,22 @@ describe("applyLoadedConfig — 刷新 export let 常量", () => {
     expect(APP_SECRET).toBe("NEW_APP_SECRET");
   });
 
-  it("更新 Claude 配置（model / effort / apiKey / baseUrl）", () => {
+  it("更新 Claude 配置（model / subagentModel / effort / apiKey / baseUrl）", () => {
     applyLoadedConfig({
       ...structuredClone(baseAppConfig),
       claude: {
         enabled: true,
         defaultAgent: true,
-        model: "deepseek-v4-pro",
+        model: "claude-sonnet-4-6",
+        subagentModel: "claude-haiku-4-5-20251001",
         effort: "high",
         apiKey: "sk-newkey",
         baseUrl: "https://gw2.example/anthropic",
       },
     });
 
-    expect(CLAUDE_MODEL).toBe("deepseek-v4-pro");
+    expect(CLAUDE_MODEL).toBe("claude-sonnet-4-6");
+    expect(CLAUDE_SUBAGENT_MODEL).toBe("claude-haiku-4-5-20251001");
     expect(CLAUDE_EFFORT).toBe("high");
     expect(CLAUDE_API_KEY).toBe("sk-newkey");
     expect(CLAUDE_BASE_URL).toBe("https://gw2.example/anthropic");

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

@@ -11,9 +11,20 @@ describe("config.sample.json", () => {
         feishu?: { enabled?: unknown };
         ilink?: { enabled?: unknown };
       };
+      claude?: { model?: unknown; subagentModel?: unknown };
     };
 
     expect(sample.platforms?.feishu?.enabled).toBe(true);
     expect(sample.platforms?.ilink?.enabled).toBe(true);
   });
+
+  it("uses an Anthropic official main model and leaves subagent override empty by default", () => {
+    const configSamplePath = join(process.cwd(), "config.sample.json");
+    const sample = JSON.parse(readFileSync(configSamplePath, "utf8")) as {
+      claude?: { model?: unknown; subagentModel?: unknown };
+    };
+
+    expect(sample.claude?.model).toBe("claude-sonnet-4-6");
+    expect(sample.claude?.subagentModel).toBe("");
+  });
 });

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

@@ -3,6 +3,7 @@ import {
   applyClaudeApiMode,
   chooseStartPath,
   detectClaudeApiMode,
+  unflattenConfig,
 } from "../web-ui.ts";
 
 // ---------------------------------------------------------------------------
@@ -129,6 +130,22 @@ describe("applyClaudeApiMode", () => {
   });
 });
 
+describe("unflattenConfig", () => {
+  it("maps Claude subagent model into claude.subagentModel", () => {
+    expect(
+      unflattenConfig({
+        CHATCCC_ANTHROPIC_MODEL: "claude-sonnet-4-6",
+        CHATCCC_ANTHROPIC_SUBAGENT_MODEL: "claude-haiku-4-5-20251001",
+      }),
+    ).toEqual({
+      claude: {
+        model: "claude-sonnet-4-6",
+        subagentModel: "claude-haiku-4-5-20251001",
+      },
+    });
+  });
+});
+
 // ---------------------------------------------------------------------------
 // chooseStartPath — /api/start 的路径选择
 // 关键护栏：

package/src/__tests__/wechat-platform.test.ts

@@ -29,4 +29,29 @@ describe("createWechatAdapter", () => {
     expect(text).toContain("/new");
     expect(log).toHaveBeenCalledWith("[WECHAT] sendRawCard degraded to text");
   });
+
+  it("reports unsent non-final messages after the claw limit", async () => {
+    const wire = {
+      push: vi.fn(async (_chatId: string, _text: string) => "msg-id"),
+      sendText: vi.fn(
+        async (_chatId: string, _text: string, _contextToken?: string) =>
+          "msg-id",
+      ),
+    };
+    const log = vi.fn();
+    const platform = createWechatAdapter({
+      getWire: () => wire,
+      log,
+    });
+
+    for (let i = 0; i < 10; i++) {
+      await expect(platform.sendText("wx-chat-limit", `chunk ${i}`)).resolves.toBe(true);
+    }
+
+    await expect(platform.sendText("wx-chat-limit", "chunk 10")).resolves.toBe(false);
+    expect(wire.push).toHaveBeenCalledTimes(10);
+    expect(log).toHaveBeenCalledWith(
+      "[WECHAT] sendText skipped (claw limit): chatId=wx-chat-limit count=11",
+    );
+  });
 });

package/src/adapters/claude-adapter.ts

@@ -53,6 +53,7 @@ interface SdkMessageLike {
 
 export interface ClaudeAdapterOptions {
   model: string;
+  subagentModel?: string;
   effort: string;
   /** 判断字段是否为"不传给 SDK"的占位（项目约定：空字符串/全空白） */
   isEmpty: (value: string) => boolean;
@@ -83,14 +84,17 @@ export interface ClaudeAdapterOptions {
 function buildSdkEnv(
   apiKey: string | undefined,
   baseUrl: string | undefined,
+  subagentModel: string | undefined,
 ): Record<string, string | undefined> | undefined {
   const apiKeyTrim = (apiKey ?? "").trim();
   const baseUrlTrim = (baseUrl ?? "").trim();
-  if (!apiKeyTrim && !baseUrlTrim) return undefined;
+  const subagentModelTrim = (subagentModel ?? "").trim();
+  const hasApiOverride = Boolean(apiKeyTrim || baseUrlTrim);
+  if (!hasApiOverride) return undefined;
 
   const env: Record<string, string | undefined> = { ...process.env };
-  // ChatCCC's Claude API config is authoritative when present. Remove Claude
-  // Code/user settings env that can silently override gateway/auth/model choice.
+  // ChatCCC's third-party Claude API config is authoritative when present.
+  // Remove Claude Code/user settings env that can silently override gateway/auth/model choice.
   delete env.ANTHROPIC_AUTH_TOKEN;
   delete env.CLAUDE_CODE_OAUTH_TOKEN;
   delete env.ANTHROPIC_MODEL;
@@ -101,8 +105,12 @@ function buildSdkEnv(
   delete env.CLAUDE_CODE_EFFORT_LEVEL;
 
   if (apiKeyTrim) env.ANTHROPIC_API_KEY = apiKeyTrim;
-  if (baseUrlTrim) env.ANTHROPIC_BASE_URL = baseUrlTrim;
-  else delete env.ANTHROPIC_BASE_URL;
+  if (baseUrlTrim) {
+    env.ANTHROPIC_BASE_URL = baseUrlTrim;
+  } else {
+    delete env.ANTHROPIC_BASE_URL;
+  }
+  if (subagentModelTrim) env.CLAUDE_CODE_SUBAGENT_MODEL = subagentModelTrim;
   return env;
 }
 
@@ -126,6 +134,7 @@ function buildSessionOptions(
   isEmpty: (value: string) => boolean,
   apiKey: string | undefined,
   baseUrl: string | undefined,
+  subagentModel: string | undefined,
 ): Record<string, unknown> {
   const o: Record<string, unknown> = {
     cwd,
@@ -136,7 +145,7 @@ function buildSessionOptions(
   };
   if (!isEmpty(model)) o.model = model;
   if (!isEmpty(effort)) o.effort = effort;
-  const env = buildSdkEnv(apiKey, baseUrl);
+  const env = buildSdkEnv(apiKey, baseUrl, subagentModel);
   if (env) o.env = env;
   return o;
 }
@@ -213,6 +222,7 @@ class ClaudeAdapter implements ToolAdapter {
   readonly sessionDescPrefix = "Claude Code Session:";
   private model: string;
   private effort: string;
+  private subagentModel: string | undefined;
   private isEmpty: (value: string) => boolean;
   private apiKey: string | undefined;
   private baseUrl: string | undefined;
@@ -220,6 +230,7 @@ class ClaudeAdapter implements ToolAdapter {
   constructor(options: ClaudeAdapterOptions) {
     this.model = options.model;
     this.effort = options.effort;
+    this.subagentModel = options.subagentModel;
     this.isEmpty = options.isEmpty;
     this.apiKey = options.apiKey;
     this.baseUrl = options.baseUrl;
@@ -233,6 +244,7 @@ class ClaudeAdapter implements ToolAdapter {
       this.isEmpty,
       this.apiKey,
       this.baseUrl,
+      this.subagentModel,
     );
     const session = unstable_v2_createSession(sessionOpts as any);
 
@@ -277,12 +289,20 @@ class ClaudeAdapter implements ToolAdapter {
       this.isEmpty,
       this.apiKey,
       this.baseUrl,
+      this.subagentModel,
     );
     const session = unstable_v2_resumeSession(
       sessionId,
       sessionOpts as any,
     );
 
+    if (signal?.aborted) {
+      session.close();
+      return;
+    }
+    const onAbort = () => { session.close(); };
+    signal?.addEventListener("abort", onAbort, { once: true });
+
     await session.send(userText);
 
     const stream = session.stream();
@@ -296,6 +316,7 @@ class ClaudeAdapter implements ToolAdapter {
         if (normalized) yield normalized;
       }
     } finally {
+      signal?.removeEventListener("abort", onAbort);
       session.close();
     }
   }

package/src/adapters/codex-adapter.ts

@@ -242,6 +242,9 @@ class CodexAdapter implements ToolAdapter {
 
     const proc = spawnCodex(args, cwd, userText);
 
+    const onAbort = () => { proc.kill(); };
+    signal?.addEventListener("abort", onAbort, { once: true });
+
     try {
       for await (const raw of readJsonLines(proc, signal)) {
         if (signal?.aborted) break;
@@ -261,6 +264,7 @@ class CodexAdapter implements ToolAdapter {
         if (normalized) yield normalized;
       }
     } finally {
+      signal?.removeEventListener("abort", onAbort);
       proc.kill();
     }
   }

package/src/adapters/cursor-adapter.ts

@@ -346,6 +346,9 @@ class CursorAdapter implements ToolAdapter {
     const proc = spawnAgent(["--resume", sessionId], cwd, userText);
     this.activeProcs.add(proc);
 
+    const onAbort = () => { proc.kill(); };
+    signal?.addEventListener("abort", onAbort, { once: true });
+
     try {
       for await (const raw of readJsonLines(proc, signal)) {
         if (signal?.aborted) break;
@@ -367,6 +370,7 @@ class CursorAdapter implements ToolAdapter {
         if (normalized) yield normalized;
       }
     } finally {
+      signal?.removeEventListener("abort", onAbort);
       proc.kill();
       this.activeProcs.delete(proc);
     }

package/src/config.ts

@@ -63,6 +63,7 @@ export interface ClaudeConfig {
   /** 是否作为 /new 未指定工具时使用的默认 Agent */
   defaultAgent: boolean;
   model: string;
+  subagentModel: string;
   effort: string;
   apiKey: string;
   baseUrl: string;
@@ -302,7 +303,7 @@ function loadConfig(): AppConfig {
     port: 18080,
     gitTimeoutSeconds: 180,
     allowInterrupt: false,
-    claude: { enabled: false, defaultAgent: true, model: "", effort: "", apiKey: "", baseUrl: "" },
+    claude: { enabled: false, defaultAgent: true, model: "", subagentModel: "", effort: "", apiKey: "", baseUrl: "" },
     cursor: { enabled: false, defaultAgent: false, path: "", model: "claude-opus-4-7-max" },
     codex: { enabled: false, defaultAgent: false, path: "", model: "", effort: "" },
   };
@@ -336,6 +337,9 @@ function loadConfig(): AppConfig {
   let raw: string;
   try {
     raw = readFileSync(CONFIG_FILE, "utf-8");
+    // 移除可能意外写入的 UTF-8 BOM（如通过记事本编辑等场景），
+    // 避免 JSON.parse 因 BOM 失败导致返回空默认值、丢失所有配置。
+    if (raw.charCodeAt(0) === 0xfeff) raw = raw.slice(1);
   } catch (err) {
     console.error(`[CONFIG] 无法读取 config.json: ${(err as Error).message}`);
     return defaults;
@@ -378,6 +382,7 @@ function loadConfig(): AppConfig {
   const claudeNonEmpty = (): boolean =>
     Boolean(
       (typeof claude.model === "string" && claude.model.trim()) ||
+      (typeof claude.subagentModel === "string" && claude.subagentModel.trim()) ||
       (typeof claude.effort === "string" && claude.effort.trim()) ||
       (typeof claude.apiKey === "string" && claude.apiKey.trim()) ||
       (typeof claude.baseUrl === "string" && claude.baseUrl.trim()),
@@ -438,6 +443,7 @@ function loadConfig(): AppConfig {
       enabled: claudeEnabled,
       defaultAgent: defaultTool === "claude",
       model: normalizeOptionalConfigField(claude.model, { label: "claude.model" }),
+      subagentModel: normalizeOptionalConfigField(claude.subagentModel, { label: "claude.subagentModel" }),
       effort: normalizeOptionalConfigField(claude.effort, { label: "claude.effort" }),
       apiKey: claude.apiKey ?? "",
       baseUrl: claude.baseUrl ?? "",
@@ -498,6 +504,7 @@ export const CHATCCC_PORT = config.port;
 export const LOCAL_RELAY_URL = `ws://127.0.0.1:${CHATCCC_PORT}`;
 
 export let CLAUDE_MODEL = config.claude.model;
+export let CLAUDE_SUBAGENT_MODEL = config.claude.subagentModel;
 export let CLAUDE_EFFORT = config.claude.effort;
 /** Anthropic 兼容网关的 API key（仅经 SDK 子进程 env 传递，从不写入主进程 process.env） */
 export let CLAUDE_API_KEY = config.claude.apiKey;
@@ -573,6 +580,7 @@ export function applyLoadedConfig(next: AppConfig): void {
   ILINK_ENABLED = next.platforms.ilink.enabled;
   ILINK_REUSE_TOKEN_ON_START = next.platforms.ilink.reuseTokenOnStart ?? true;
   CLAUDE_MODEL = next.claude.model;
+  CLAUDE_SUBAGENT_MODEL = next.claude.subagentModel;
   CLAUDE_EFFORT = next.claude.effort;
   CLAUDE_API_KEY = next.claude.apiKey;
   CLAUDE_BASE_URL = next.claude.baseUrl;
@@ -705,6 +713,11 @@ export function reportEnvironmentVariableReadout(): void {
     `         Claude 模型: ${anthropicConfigDisplay(CLAUDE_MODEL)}（留空时不向 SDK 传 model）`
   );
 
+  console.log(`  [默认] [可选] claude.subagentModel`);
+  console.log(
+    `         Claude Subagent 模型: ${anthropicConfigDisplay(CLAUDE_SUBAGENT_MODEL)}（留空时不向 SDK 传 CLAUDE_CODE_SUBAGENT_MODEL）`
+  );
+
   console.log(`  [默认] [可选] claude.effort`);
   console.log(
     `         思考深度: ${anthropicConfigDisplay(CLAUDE_EFFORT)}（留空时不向 SDK 传 effort）`

package/src/index.ts

@@ -85,6 +85,7 @@ import {
 } from "./cardkit.ts";
 import {
   MAX_PROCESSED,
+  clearAdapterCache,
   loadSessionRegistryForBinding,
   processedMessages,
   rebuildBindingsFromRegistry,
@@ -745,6 +746,7 @@ async function main(): Promise<void> {
   // 会话时自动看到新值）。setup 首次激活走 onActivate 路径，不依赖此 hook。
   setReloadConfigHook(() => {
     reloadConfigFromDisk();
+    clearAdapterCache();
     appendStartupTrace("reload-from-ui: config reloaded", {
       appIdMask: maskAppId(APP_ID),
     });
@@ -769,6 +771,7 @@ async function main(): Promise<void> {
       startSetupMode(CHATCCC_PORT, {
         onActivate: async (httpServer: Server) => {
           reloadConfigFromDisk();
+          clearAdapterCache();
           appendStartupTrace("setup-activate: reloaded config from disk", {
             appIdMaskAfterReload: maskAppId(APP_ID),
           });

package/src/session.ts

@@ -6,6 +6,7 @@ import {
   CLAUDE_BASE_URL,
   CLAUDE_EFFORT,
   CLAUDE_MODEL,
+  CLAUDE_SUBAGENT_MODEL,
   CHATCCC_PORT,
   PROJECT_ROOT,
   SESSIONS_FILE,
@@ -172,6 +173,7 @@ export function getAdapterForTool(tool: string): ToolAdapter {
   } else {
     adapter = createClaudeAdapter({
       model: CLAUDE_MODEL,
+      subagentModel: CLAUDE_SUBAGENT_MODEL,
       effort: CLAUDE_EFFORT,
       isEmpty: isAnthropicConfigEmpty,
       apiKey: CLAUDE_API_KEY,
@@ -606,7 +608,7 @@ function formatToolConfigForLog(tool: string, sessionModel?: string): string {
       : "effort=(由 codex config.toml 决定)";
     return `model=${modelStr}, ${effortStr}`;
   }
-  return `model=${anthropicConfigDisplay(CLAUDE_MODEL)}, effort=${anthropicConfigDisplay(CLAUDE_EFFORT)}`;
+  return `model=${anthropicConfigDisplay(CLAUDE_MODEL)}, subagentModel=${anthropicConfigDisplay(CLAUDE_SUBAGENT_MODEL)}, effort=${anthropicConfigDisplay(CLAUDE_EFFORT)}`;
 }
 
 export async function initClaudeSession(tool: string, overrideCwd?: string, chatId?: string): Promise<{ sessionId: string; cwd: string }> {
@@ -1322,6 +1324,10 @@ export function _setAdapterForToolForTest(tool: string, adapter: ToolAdapter): v
   adapterCache.set(tool, adapter);
 }
 
-export function _clearAdapterCacheForTest(): void {
+export function clearAdapterCache(): void {
   adapterCache.clear();
 }
+
+export function _clearAdapterCacheForTest(): void {
+  clearAdapterCache();
+}

package/src/web-ui.ts

@@ -31,7 +31,7 @@ interface AppConfig {
   platforms?: { feishu?: { enabled?: boolean }; ilink?: { enabled?: boolean } };
   port?: number;
   gitTimeoutSeconds?: number;
-  claude?: { enabled?: boolean; defaultAgent?: boolean; model?: string; effort?: string; apiKey?: string; baseUrl?: string };
+  claude?: { enabled?: boolean; defaultAgent?: boolean; model?: string; subagentModel?: string; effort?: string; apiKey?: string; baseUrl?: string };
   // `command` 是已废弃的旧字段名，保留只读以兼容升级前的 config.json
   cursor?: { enabled?: boolean; defaultAgent?: boolean; path?: string; command?: string; model?: string };
   codex?: { enabled?: boolean; defaultAgent?: boolean; path?: string; command?: string; model?: string; effort?: string };
@@ -126,7 +126,11 @@ function readToolPath(tool?: { path?: string; command?: string }): string {
 function loadConfig(): AppConfig {
   if (!existsSync(CONFIG_FILE)) return {};
   try {
-    return JSON.parse(readFileSync(CONFIG_FILE, "utf8"));
+    let raw = readFileSync(CONFIG_FILE, "utf8");
+    // 移除可能意外写入的 UTF-8 BOM，避免 JSON.parse 失败导致返回空对象、
+    // UI 显示所有配置为空。
+    if (raw.charCodeAt(0) === 0xfeff) raw = raw.slice(1);
+    return JSON.parse(raw);
   } catch {
     return {};
   }
@@ -330,7 +334,7 @@ function deepMerge(target: Record<string, unknown>, source: Record<string, unkno
 }
 
 // Convert flat key-value pairs to nested config structure
-function unflattenConfig(flat: Record<string, unknown>): Record<string, unknown> {
+export function unflattenConfig(flat: Record<string, unknown>): Record<string, unknown> {
   const result: Record<string, unknown> = {};
   for (const [key, val] of Object.entries(flat)) {
     if (key === "CHATCCC_APP_ID") {
@@ -360,6 +364,9 @@ function unflattenConfig(flat: Record<string, unknown>): Record<string, unknown>
     } else if (key === "CHATCCC_ANTHROPIC_MODEL") {
       result.claude = result.claude || {};
       (result.claude as Record<string, unknown>).model = val;
+    } else if (key === "CHATCCC_ANTHROPIC_SUBAGENT_MODEL") {
+      result.claude = result.claude || {};
+      (result.claude as Record<string, unknown>).subagentModel = val;
     } else if (key === "CHATCCC_ANTHROPIC_EFFORT") {
       result.claude = result.claude || {};
       (result.claude as Record<string, unknown>).effort = val;
@@ -705,6 +712,10 @@ header .badge{font-size:13px;padding:4px 12px;border-radius:12px;font-weight:500
               <label>模型</label>
               <input type="text" id="field-CHATCCC_ANTHROPIC_MODEL" placeholder="留空表示不向 SDK 传 model">
             </div>
+            <div class="form-group" id="claude-subagent-model-field">
+              <label>Subagent 模型</label>
+              <input type="text" id="field-CHATCCC_ANTHROPIC_SUBAGENT_MODEL" placeholder="留空表示不向 SDK 传 CLAUDE_CODE_SUBAGENT_MODEL">
+            </div>
             <div class="form-group">
               <label>思考深度 (Effort)</label>
               <input type="text" id="field-CHATCCC_ANTHROPIC_EFFORT" placeholder="留空表示不向 SDK 传 effort">
@@ -844,6 +855,7 @@ header .badge{font-size:13px;padding:4px 12px;border-radius:12px;font-weight:500
         <div class="config-row" id="cfg-row-CLAUDE_API_KEY"><span class="key">API Key</span><span class="val" id="cfg-CLAUDE_API_KEY">-</span></div>
         <div class="config-row" id="cfg-row-CLAUDE_BASE_URL"><span class="key">Base URL</span><span class="val" id="cfg-CLAUDE_BASE_URL">-</span></div>
         <div class="config-row"><span class="key">模型</span><span class="val" id="cfg-ANTHROPIC_MODEL">-</span></div>
+        <div class="config-row" id="cfg-row-ANTHROPIC_SUBAGENT_MODEL"><span class="key">Subagent 模型</span><span class="val" id="cfg-ANTHROPIC_SUBAGENT_MODEL">-</span></div>
         <div class="config-row"><span class="key">Effort</span><span class="val" id="cfg-ANTHROPIC_EFFORT">-</span></div>
         <label class="agent-default-row" style="margin-top:10px"><input type="checkbox" id="dash-default-claude" onchange="setDashboardDefaultAgent('claude', this.checked)"> 设为默认 Agent</label>
         <button class="btn btn-outline" style="margin-top:8px" onclick="editSection('claude')">编辑</button>
@@ -911,7 +923,7 @@ let state = {
 var step2InputBound = false;
 
 const AGENT_FIELDS = {
-  claude: ['CLAUDE_API_KEY','CLAUDE_BASE_URL','CHATCCC_ANTHROPIC_MODEL','CHATCCC_ANTHROPIC_EFFORT'],
+  claude: ['CLAUDE_API_KEY','CLAUDE_BASE_URL','CHATCCC_ANTHROPIC_MODEL','CHATCCC_ANTHROPIC_SUBAGENT_MODEL','CHATCCC_ANTHROPIC_EFFORT'],
   cursor: ['CHATCCC_CURSOR_PATH','CHATCCC_CURSOR_MODEL'],
   codex: ['CHATCCC_CODEX_PATH','CHATCCC_CODEX_MODEL','CHATCCC_CODEX_EFFORT']
 };
@@ -925,7 +937,11 @@ var claudeApiMode = 'official';
 // 示例只是引导）；官方模式不列举任何具体值，避免给出过期/不支持的取值产生误导。
 var CLAUDE_MODEL_PLACEHOLDER = {
   official: '留空表示不向 SDK 传 model',
-  thirdparty: 'deepseek-v4-pro'
+  thirdparty: 'claude-sonnet-4-6'
+};
+var CLAUDE_SUBAGENT_MODEL_PLACEHOLDER = {
+  official: '留空表示不向 SDK 传 CLAUDE_CODE_SUBAGENT_MODEL',
+  thirdparty: 'claude-haiku-4-5-20251001'
 };
 var CLAUDE_EFFORT_PLACEHOLDER = {
   official: '留空表示不向 SDK 传 effort',
@@ -943,13 +959,23 @@ function onClaudeApiModeChange(mode) {
   if (editThirdPartyEl) {
     editThirdPartyEl.classList.toggle('hidden', mode !== 'thirdparty');
   }
+  var wizardSubagentField = document.getElementById('claude-subagent-model-field');
+  if (wizardSubagentField) wizardSubagentField.classList.toggle('hidden', mode !== 'thirdparty');
+  document.querySelectorAll('[data-claude-subagent-field]').forEach(function(el){
+    el.classList.toggle('hidden', mode !== 'thirdparty');
+  });
   // 同步 model / effort 输入框的 placeholder（Wizard + Edit Modal 两处都更新）
   var modelPlaceholder = CLAUDE_MODEL_PLACEHOLDER[mode] || CLAUDE_MODEL_PLACEHOLDER.official;
+  var subagentModelPlaceholder = CLAUDE_SUBAGENT_MODEL_PLACEHOLDER[mode] || CLAUDE_SUBAGENT_MODEL_PLACEHOLDER.official;
   var effortPlaceholder = CLAUDE_EFFORT_PLACEHOLDER[mode] || CLAUDE_EFFORT_PLACEHOLDER.official;
   var wizardModelEl = document.getElementById('field-CHATCCC_ANTHROPIC_MODEL');
   if (wizardModelEl) wizardModelEl.placeholder = modelPlaceholder;
   var editModelEl = document.getElementById('edit-CHATCCC_ANTHROPIC_MODEL');
   if (editModelEl) editModelEl.placeholder = modelPlaceholder;
+  var wizardSubagentModelEl = document.getElementById('field-CHATCCC_ANTHROPIC_SUBAGENT_MODEL');
+  if (wizardSubagentModelEl) wizardSubagentModelEl.placeholder = subagentModelPlaceholder;
+  var editSubagentModelEl = document.getElementById('edit-CHATCCC_ANTHROPIC_SUBAGENT_MODEL');
+  if (editSubagentModelEl) editSubagentModelEl.placeholder = subagentModelPlaceholder;
   var wizardEffortEl = document.getElementById('field-CHATCCC_ANTHROPIC_EFFORT');
   if (wizardEffortEl) wizardEffortEl.placeholder = effortPlaceholder;
   var editEffortEl = document.getElementById('edit-CHATCCC_ANTHROPIC_EFFORT');
@@ -1200,7 +1226,7 @@ function isAgentEnabled(node, keys) {
   return false;
 }
 
-var CLAUDE_FALLBACK_KEYS = ['apiKey','baseUrl','model','effort'];
+var CLAUDE_FALLBACK_KEYS = ['apiKey','baseUrl','model','subagentModel','effort'];
 var CURSOR_FALLBACK_KEYS = ['path','command','model'];
 var CODEX_FALLBACK_KEYS = ['path','command','model','effort'];
 
@@ -1210,6 +1236,7 @@ function renderStep2() {
     prefillNested('field-CLAUDE_API_KEY', c.claude.apiKey);
     prefillNested('field-CLAUDE_BASE_URL', c.claude.baseUrl);
     prefillNested('field-CHATCCC_ANTHROPIC_MODEL', c.claude.model);
+    prefillNested('field-CHATCCC_ANTHROPIC_SUBAGENT_MODEL', c.claude.subagentModel);
     prefillNested('field-CHATCCC_ANTHROPIC_EFFORT', c.claude.effort);
   }
   // 按已有 apiKey/baseUrl 判定初始 API 模式，并相应显示/隐藏字段
@@ -1285,6 +1312,7 @@ function collectAllFields() {
   vars.CHATCCC_CODEX_DEFAULT_AGENT = state.defaultAgent === 'codex';
   if (state.agentsEnabled.claude) {
     AGENT_FIELDS.claude.forEach(function(key){
+      if (claudeApiMode !== 'thirdparty' && key === 'CHATCCC_ANTHROPIC_SUBAGENT_MODEL') return;
       var el = document.getElementById('field-' + key);
       if (el && el.value.trim()) vars[key] = el.value.trim();
     });
@@ -1345,6 +1373,7 @@ function renderStep3() {
       if (claudeApiMode === 'thirdparty') {
         lines.push('<div class="config-row"><span class="key">API Key</span><span class="val">' + (vars.CLAUDE_API_KEY ? '***已设置***' : '(未设置)') + '</span></div>');
         if (vars.CLAUDE_BASE_URL) lines.push('<div class="config-row"><span class="key">Base URL</span><span class="val">' + vars.CLAUDE_BASE_URL + '</span></div>');
+        lines.push('<div class="config-row"><span class="key">Subagent 模型</span><span class="val">' + (vars.CHATCCC_ANTHROPIC_SUBAGENT_MODEL || '(留空)') + '</span></div>');
       }
       lines.push('<div class="config-row"><span class="key">模型</span><span class="val">' + (vars.CHATCCC_ANTHROPIC_MODEL || '(留空)') + '</span></div>');
       lines.push('<div class="config-row"><span class="key">Effort</span><span class="val">' + (vars.CHATCCC_ANTHROPIC_EFFORT || '(留空)') + '</span></div>');
@@ -1542,6 +1571,8 @@ function updateDashboardUI() {
   document.getElementById('cfg-CLAUDE_API_KEY').textContent = claudeApiKey ? '***已设置***' : '-';
   document.getElementById('cfg-CLAUDE_BASE_URL').textContent = claudeBaseUrl || '-';
   document.getElementById('cfg-ANTHROPIC_MODEL').textContent = (c.claude && c.claude.model) || '(留空)';
+  document.getElementById('cfg-row-ANTHROPIC_SUBAGENT_MODEL').style.display = isThirdPartyClaude ? '' : 'none';
+  document.getElementById('cfg-ANTHROPIC_SUBAGENT_MODEL').textContent = (c.claude && c.claude.subagentModel) || '(留空)';
   document.getElementById('cfg-ANTHROPIC_EFFORT').textContent = (c.claude && c.claude.effort) || '(留空)';
   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) || '(留空)';
@@ -1603,7 +1634,7 @@ function editSection(section) {
   var labelMap = {
     'CHATCCC_APP_ID': 'App ID', 'CHATCCC_APP_SECRET': 'App Secret',
     'CLAUDE_API_KEY': 'API Key', 'CLAUDE_BASE_URL': 'Base URL',
-    'CHATCCC_ANTHROPIC_MODEL': '模型', 'CHATCCC_ANTHROPIC_EFFORT': 'Effort',
+    'CHATCCC_ANTHROPIC_MODEL': '模型', 'CHATCCC_ANTHROPIC_SUBAGENT_MODEL': 'Subagent 模型', 'CHATCCC_ANTHROPIC_EFFORT': 'Effort',
     'CHATCCC_CURSOR_PATH': 'CLI 路径', 'CHATCCC_CURSOR_MODEL': '模型',
     'CHATCCC_CODEX_PATH': 'CLI 路径', 'CHATCCC_CODEX_MODEL': '模型', 'CHATCCC_CODEX_EFFORT': 'Effort'
   };
@@ -1630,6 +1661,7 @@ function editSection(section) {
   }
 
   var thirdPartyOpened = false;
+  var thirdPartyClosed = false;
   fields.forEach(function(key){
     var val = state.config[key] || '';
     // Also check nested config
@@ -1641,6 +1673,7 @@ function editSection(section) {
         if (key === 'CLAUDE_API_KEY') val = state.config.claude.apiKey || '';
         else if (key === 'CLAUDE_BASE_URL') val = state.config.claude.baseUrl || '';
         else if (key === 'CHATCCC_ANTHROPIC_MODEL') val = state.config.claude.model || '';
+        else if (key === 'CHATCCC_ANTHROPIC_SUBAGENT_MODEL') val = state.config.claude.subagentModel || '';
         else if (key === 'CHATCCC_ANTHROPIC_EFFORT') val = state.config.claude.effort || '';
       } else if (section === 'cursor' && state.config.cursor) {
         if (key === 'CHATCCC_CURSOR_PATH') val = state.config.cursor.path || state.config.cursor.command || '';
@@ -1653,18 +1686,28 @@ function editSection(section) {
     }
     var isSecret = key.includes('SECRET') || key.includes('API_KEY');
     var isClaudeThirdPartyField = section === 'claude' && (key === 'CLAUDE_API_KEY' || key === 'CLAUDE_BASE_URL');
+    var isClaudeSubagentField = section === 'claude' && key === 'CHATCCC_ANTHROPIC_SUBAGENT_MODEL';
 
     if (isClaudeThirdPartyField && !thirdPartyOpened) {
       html += '<div id="edit-claude-thirdparty-fields"' + (claudeApiMode === 'thirdparty' ? '' : ' class="hidden"') + '>';
       thirdPartyOpened = true;
     }
 
-    html += '<div class="form-group"><label>' + (labelMap[key] || key) + '</label>';
+    // 在第三方字段之后、第一个通用字段之前闭合 wrapper，
+    // 避免 model / subagentModel / effort 被包裹在 hidden div 中。
+    if (thirdPartyOpened && !thirdPartyClosed && !isClaudeThirdPartyField) {
+      html += '</div>';
+      thirdPartyClosed = true;
+    }
+
+    var groupClass = 'form-group' + (isClaudeSubagentField && claudeApiMode !== 'thirdparty' ? ' hidden' : '');
+    var subagentAttr = isClaudeSubagentField ? ' data-claude-subagent-field="1"' : '';
+    html += '<div class="' + groupClass + '"' + subagentAttr + '><label>' + (labelMap[key] || key) + '</label>';
     html += '<input type="' + (isSecret ? 'password' : 'text') + '" id="edit-' + key + '" value="' + String(val).replace(/"/g,'&quot;') + '">';
     html += '</div>';
   });
 
-  if (thirdPartyOpened) html += '</div>';
+  if (thirdPartyOpened && !thirdPartyClosed) html += '</div>';
 
   document.getElementById('edit-modal-fields').innerHTML = html;
   document.getElementById('edit-modal').classList.remove('hidden');
@@ -1688,6 +1731,7 @@ async function saveEdit() {
 
   var vars = {};
   fields.forEach(function(key){
+    if (editSectionType === 'claude' && claudeApiMode !== 'thirdparty' && key === 'CHATCCC_ANTHROPIC_SUBAGENT_MODEL') return;
     var el = document.getElementById('edit-' + key);
     if (el) vars[key] = el.value.trim();
   });

package/src/wechat-platform.ts

@@ -157,7 +157,7 @@ export function createWechatAdapter(
 
       // 第10条且非最终消息：附加 claw 限制提示
       if (count === 10 && !isFinal) {
-        text = text + "\n━━━━━━━━━━━━━━━━━━━━\n后台工作中，由于微信claw机制限制，请唤醒我才能继续发送消息";
+        text = text + "\n━━ 后台工作中，由于微信claw机制限制，请唤醒我才能继续发送消息";
       }
 
       // 超过10条后非最终消息不再发送（claw 限制）