chatccc 0.2.203 → 0.2.205

package/README.md

@@ -133,7 +133,7 @@ Write-Host ''
 chatccc
 ```
 
-如果一切顺利，浏览器会自动打开 `http://127.0.0.1:18080` 的 Web 配置页面。按页面提示填入飞书 App ID / App Secret，点击"保存并启动"即可。
+如果一切顺利，系统默认浏览器会自动打开 `http://localhost:18080/` 的 Web 配置页面。按页面提示填入飞书 App ID / App Secret，点击"保存并启动"即可。
 
 > **只想装 ChatCCC 本体？** 如果你已经有 Node.js，直接 `npm install -g chatccc && chatccc` 即可，不需要跑上面的完整脚本。
 
@@ -151,7 +151,7 @@ chatccc
 
 旧版本留在仓库或包目录下的 `config.json`、`logs/`、`state/` 会在首次启动时自动迁移到用户目录。
 
-首次启动时，如果还没有有效配置，ChatCCC 会自动打开本地 Web 配置向导（默认 `http://127.0.0.1:18080`）。
+每次直接运行 `chatccc` 时，无论是否已经完成配置，ChatCCC 默认都会用系统默认浏览器打开本地 Web UI（默认 `http://localhost:18080/`，修改 `config.port` 后跟随实际端口）。可在首次配置向导或管理页的 **Web UI** 设置中关闭；关闭后从下一次直接启动起生效。由 `/restart`、`/update` 或 Web UI 发起的内部重启始终不会重复打开浏览器。Linux 服务器没有 `DISPLAY`/`WAYLAND_DISPLAY` 时会跳过打开，并在终端输出 SSH 隧道访问提示。主页顶部的 **Agent Team** 入口会跳转到独立的 `/agent-team` 页面。
 
 #### 从源码运行
 
@@ -260,11 +260,14 @@ Codex 的默认模型和推理强度可继续由 `~/.codex/config.toml` 管理
     "appId": "cli_xxxxxxxxxxxx",
     "appSecret": "xxxxxxxxxxxxxxxxxxxxxxxxxx"
   },
-  "platforms": {
-    "feishu": { "enabled": true, "platformType": "feishu" },
-    "ilink": { "enabled": true, "reuseTokenOnStart": true }
-  },
-  "chromeDevtools": {
+  "platforms": {
+    "feishu": { "enabled": true, "platformType": "feishu" },
+    "ilink": { "enabled": true, "reuseTokenOnStart": true }
+  },
+  "webUi": {
+    "openOnStart": true
+  },
+  "chromeDevtools": {
     "enabled": false,
     "port": 15166,
     "chromePath": ""
@@ -305,9 +308,10 @@ Codex 的默认模型和推理强度可继续由 `~/.codex/config.toml` 管理
 | `feishu.appId` / `feishu.appSecret` | 飞书应用凭证 |
 | `platforms.feishu.enabled` | 是否启用飞书 |
 | `platforms.feishu.platformType` | 飞书平台类型，默认 `feishu` |
-| `platforms.ilink.enabled` | 是否启用微信 iLink |
-| `platforms.ilink.reuseTokenOnStart` | 启动时是否复用已有微信登录 token |
-| `chromeDevtools.enabled` | 是否启用常驻 Chrome CDP；默认 false |
+| `platforms.ilink.enabled` | 是否启用微信 iLink |
+| `platforms.ilink.reuseTokenOnStart` | 启动时是否复用已有微信登录 token |
+| `webUi.openOnStart` | 直接启动时是否打开系统默认浏览器；默认 true，内部重启始终跳过 |
+| `chromeDevtools.enabled` | 是否启用常驻 Chrome CDP；默认 false |
 | `chromeDevtools.port` | Chrome CDP 端口；默认 15166 |
 | `chromeDevtools.chromePath` | Chrome 可执行文件路径；留空时自动探测 |
 | `port` | 本地 Web 配置面板和中继服务端口 |

package/config.sample.json

@@ -3,11 +3,14 @@
     "appId": "",
     "appSecret": ""
   },
-  "platforms": {
-    "feishu": { "enabled": true, "platformType": "feishu" },
-    "ilink": { "enabled": true, "reuseTokenOnStart": true }
-  },
-  "chromeDevtools": {
+  "platforms": {
+    "feishu": { "enabled": true, "platformType": "feishu" },
+    "ilink": { "enabled": true, "reuseTokenOnStart": true }
+  },
+  "webUi": {
+    "openOnStart": true
+  },
+  "chromeDevtools": {
     "enabled": false,
     "port": 15166,
     "chromePath": ""

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chatccc",
-  "version": "0.2.203",
+  "version": "0.2.205",
   "description": "Feishu bot bridge for Claude Code",
   "license": "Apache-2.0",
   "type": "module",

package/src/__tests__/agent-activity.test.ts

@@ -0,0 +1,76 @@
+import { describe, expect, it } from "vitest";
+
+import {
+  createAgentActivityTracker,
+  formatAgentActivityTitle,
+  updateAgentActivity,
+} from "../agent-activity.ts";
+
+describe("agent activity", () => {
+  it("starts with an explicit startup status", () => {
+    const tracker = createAgentActivityTracker(1_000);
+
+    expect(formatAgentActivityTitle(tracker.activity, 4_000)).toBe("正在启动 Agent · 3秒");
+  });
+
+  it("keeps the thinking timer stable across repeated thinking blocks", () => {
+    const tracker = createAgentActivityTracker(1_000);
+
+    expect(updateAgentActivity(tracker, { type: "thinking", thinking: "first" }, 2_000)).toBe(true);
+    expect(updateAgentActivity(tracker, { type: "thinking", thinking: "second" }, 5_000)).toBe(false);
+    expect(formatAgentActivityTitle(tracker.activity, 8_000)).toBe("思考中 · 6秒");
+  });
+
+  it("shows the active tool name and elapsed time", () => {
+    const tracker = createAgentActivityTracker(1_000);
+
+    updateAgentActivity(tracker, {
+      type: "tool_use",
+      id: "tool-1",
+      name: "Bash",
+      input: { command: "npm test" },
+    }, 3_000);
+
+    expect(formatAgentActivityTitle(tracker.activity, 38_000)).toBe("正在执行 Bash · 35秒");
+  });
+
+  it("tracks parallel tools and keeps the remaining tool after one result", () => {
+    const tracker = createAgentActivityTracker(1_000);
+
+    updateAgentActivity(tracker, { type: "tool_use", id: "read", name: "Read", input: {} }, 2_000);
+    updateAgentActivity(tracker, { type: "tool_use", id: "grep", name: "Grep", input: {} }, 3_000);
+    expect(formatAgentActivityTitle(tracker.activity, 4_000)).toBe("正在执行 Read 等 2 项 · 2秒");
+
+    updateAgentActivity(tracker, {
+      type: "tool_result",
+      tool_use_id: "read",
+      content: "done",
+    }, 5_000);
+    expect(formatAgentActivityTitle(tracker.activity, 7_000)).toBe("正在执行 Grep · 4秒");
+
+    updateAgentActivity(tracker, {
+      type: "tool_result",
+      tool_use_id: "grep",
+      content: "done",
+    }, 8_000);
+    expect(formatAgentActivityTitle(tracker.activity, 10_000)).toBe("正在处理工具结果 · 2秒");
+  });
+
+  it("switches to response and context-compaction statuses", () => {
+    const tracker = createAgentActivityTracker(1_000);
+
+    updateAgentActivity(tracker, { type: "text", text: "answer" }, 2_000);
+    expect(formatAgentActivityTitle(tracker.activity, 3_000)).toBe("正在生成回复 · 1秒");
+
+    updateAgentActivity(tracker, {
+      type: "compact_boundary",
+      trigger: "auto",
+      pre_tokens: 100_000,
+    }, 4_000);
+    expect(formatAgentActivityTitle(tracker.activity, 5_000)).toBe("正在整理上下文 · 1秒");
+  });
+
+  it("formats longer elapsed time without decorative animation", () => {
+    expect(formatAgentActivityTitle({ kind: "thinking", startedAt: 1_000 }, 74_000)).toBe("思考中 · 1分13秒");
+  });
+});

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

@@ -76,12 +76,12 @@ describe("normalizeCodexMessage", () => {
         status: "in_progress",
       },
     });
-    expect(result).not.toBeNull();
-    expect(result!.type).toBe("assistant");
-    expect(result!.blocks).toEqual([
-      { type: "tool_use", name: "Bash", input: { command: "powershell.exe -Command ls" } },
-    ]);
-  });
+    expect(result).not.toBeNull();
+    expect(result!.type).toBe("assistant");
+    expect(result!.blocks).toEqual([
+      { type: "tool_use", id: "item_0", name: "Bash", input: { command: "powershell.exe -Command ls" } },
+    ]);
+  });
 
   it("normalizes command_execution completion as tool_result (success)", () => {
     const result = normalizeCodexMessage({
@@ -302,4 +302,4 @@ describe("createCodexAdapter", () => {
     });
     expect(await adapter.getSessionInfo("sid-C")).toBeUndefined();
   });
-});
+});

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

@@ -38,10 +38,11 @@ import {
 //      原地切换复用同一 server，重新读端口只会引入混乱）
 // ---------------------------------------------------------------------------
 
-const baseAppConfig: AppConfig = {
-  feishu: { appId: "INITIAL_APP", appSecret: "INITIAL_SECRET" },
-  platforms: { feishu: { enabled: true }, ilink: { enabled: true } },
-  chromeDevtools: { enabled: false, port: 15166, chromePath: "" },
+const baseAppConfig: AppConfig = {
+  feishu: { appId: "INITIAL_APP", appSecret: "INITIAL_SECRET" },
+  platforms: { feishu: { enabled: true }, ilink: { enabled: true } },
+  webUi: { openOnStart: true },
+  chromeDevtools: { enabled: false, port: 15166, chromePath: "" },
   port: 18080,
   gitTimeoutSeconds: 180,
   allowInterrupt: false,
@@ -216,7 +217,7 @@ describe("applyLoadedConfig — config 对象引用契约", () => {
     expect(config.codex.path).toBe("/refresh/codex");
   });
 
-  it("刷新 chromeDevtools 配置但保持 config 引用", () => {
+  it("刷新 chromeDevtools 配置但保持 config 引用", () => {
     const refBefore = config;
 
     applyLoadedConfig({
@@ -226,7 +227,19 @@ describe("applyLoadedConfig — config 对象引用契约", () => {
 
     expect(config).toBe(refBefore);
     expect(config.chromeDevtools).toEqual({ enabled: true, port: 15166, chromePath: "C:/Chrome/chrome.exe" });
-  });
+  });
+
+  it("刷新 webUi 启动开关但保持 config 引用", () => {
+    const refBefore = config;
+
+    applyLoadedConfig({
+      ...structuredClone(baseAppConfig),
+      webUi: { openOnStart: false },
+    });
+
+    expect(config).toBe(refBefore);
+    expect(config.webUi).toEqual({ openOnStart: false });
+  });
 
   it("空 feishu 凭证也能正确刷入（向导回滚到空的反向场景）", () => {
     applyLoadedConfig({

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

@@ -59,7 +59,16 @@ describe("config.sample.json", () => {
     expect(sample.chromeDevtools?.enabled).toBe(false);
     expect(sample.chromeDevtools?.port).toBe(15166);
     expect(sample.chromeDevtools?.chromePath).toBe("");
-  });
+  });
+
+  it("opens the Web UI on direct startup by default", () => {
+    const configSamplePath = join(process.cwd(), "config.sample.json");
+    const sample = JSON.parse(readFileSync(configSamplePath, "utf8")) as {
+      webUi?: { openOnStart?: unknown };
+    };
+
+    expect(sample.webUi?.openOnStart).toBe(true);
+  });
 
   it("keeps raw stream logs disabled by default for every agent", () => {
     const configSamplePath = join(process.cwd(), "config.sample.json");

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

@@ -660,11 +660,11 @@ describe("Cursor stream fixture - 端到端不重复", () => {
       session_id: "sid",
       timestamp_ms: 1000,
     } as Parameters<typeof normalizeCursorMessage>[0]);
-    expect(result).not.toBeNull();
-    expect(result!.blocks).toEqual([
-      { type: "tool_use", name: "Bash", input: { command: "ls" } },
-    ]);
-  });
+    expect(result).not.toBeNull();
+    expect(result!.blocks).toEqual([
+      { type: "tool_use", id: "toolu_abc", name: "Bash", input: { command: "ls" } },
+    ]);
+  });
 
   it("normalizes tool_call completed → tool_result block (success)", () => {
     const result = normalizeCursorMessage({

package/src/__tests__/session.test.ts

@@ -4,10 +4,16 @@ import { tmpdir } from "node:os";
 import { dirname, join } from "node:path";
 
 // mock stream-state 以支持在测试中控制累积长度
-const mockStreamStates = new Map<string, {
-  accumulatedContent: string;
-  finalReply: string;
-  status?: "running" | "done" | "stopped" | "error";
+const mockStreamStates = new Map<string, {
+  accumulatedContent: string;
+  finalReply: string;
+  activity?: {
+    kind: "starting" | "thinking" | "tool" | "processing" | "responding" | "compacting";
+    startedAt: number;
+    toolName?: string;
+    toolCount?: number;
+  };
+  status?: "running" | "done" | "stopped" | "error";
   turnCount?: number;
   finalReplySentTurn?: number;
   finalReplySentAt?: number;
@@ -18,8 +24,9 @@ vi.mock("../stream-state.ts", () => ({
     if (!state) return null;
     return {
       sessionId: sid,
-      accumulatedContent: state.accumulatedContent,
-      finalReply: state.finalReply,
+      accumulatedContent: state.accumulatedContent,
+      finalReply: state.finalReply,
+      activity: state.activity,
       finalReplySentTurn: state.finalReplySentTurn,
       finalReplySentAt: state.finalReplySentAt,
       status: state.status ?? "running",
@@ -34,24 +41,31 @@ vi.mock("../stream-state.ts", () => ({
   writeStreamState: async (state: {
     sessionId: string;
     accumulatedContent: string;
-    finalReply: string;
+    finalReply: string;
+    activity?: {
+      kind: "starting" | "thinking" | "tool" | "processing" | "responding" | "compacting";
+      startedAt: number;
+      toolName?: string;
+      toolCount?: number;
+    };
     status?: "running" | "done" | "stopped" | "error";
     turnCount?: number;
     finalReplySentTurn?: number;
     finalReplySentAt?: number;
   }) => {
     mockStreamStates.set(state.sessionId, {
-      accumulatedContent: state.accumulatedContent,
-      finalReply: state.finalReply,
+      accumulatedContent: state.accumulatedContent,
+      finalReply: state.finalReply,
+      activity: state.activity,
       status: state.status,
       turnCount: state.turnCount,
       finalReplySentTurn: state.finalReplySentTurn,
       finalReplySentAt: state.finalReplySentAt,
     });
   },
-  createEmptyStreamState: (sid: string, cwd: string, tool: string, turnCount: number) => ({
-    sessionId: sid, status: "running" as const, accumulatedContent: "", finalReply: "", chunkCount: 0, turnCount, contextTokens: 0, updatedAt: Date.now(), cwd, tool,
-  }),
+  createEmptyStreamState: (sid: string, cwd: string, tool: string, turnCount: number) => ({
+    sessionId: sid, status: "running" as const, accumulatedContent: "", finalReply: "", activity: { kind: "starting" as const, startedAt: Date.now() }, chunkCount: 0, turnCount, contextTokens: 0, updatedAt: Date.now(), cwd, tool,
+  }),
   isFinalReplySentForTurn: (state: { turnCount: number; finalReplySentTurn?: number }) => state.finalReplySentTurn === state.turnCount,
   markFinalReplySent: async (sid: string, turnCount: number, sentAt = Date.now()) => {
     const state = mockStreamStates.get(sid);
@@ -569,7 +583,7 @@ describe("runAgentSession process monitor", () => {
   });
 });
 
-describe("unified display loop WeChat delta", () => {
+describe("unified display loop WeChat delta", () => {
   beforeEach(() => {
     vi.useFakeTimers();
     resetState();
@@ -636,10 +650,76 @@ describe("unified display loop WeChat delta", () => {
       "chat-wechat",
       "tool output",
     );
-  });
-});
-
-describe("unified display loop terminal card update", () => {
+  });
+});
+
+describe("unified display loop activity status", () => {
+  beforeEach(() => {
+    vi.useFakeTimers();
+    vi.setSystemTime(new Date("2026-07-16T08:00:00.000Z"));
+    resetState();
+    resetBindingState();
+    mockStreamStates.clear();
+  });
+
+  afterEach(() => {
+    stopUnifiedDisplayLoop();
+    resetBindingState();
+    vi.useRealTimers();
+  });
+
+  it("renders explicit activity and elapsed time alongside the liveness dots", async () => {
+    const platform = mockPlatform("feishu");
+    setSessionPlatform(platform);
+
+    bindChatToSession("sid-activity", "chat-activity");
+    recordLastActiveChat("sid-activity", "chat-activity");
+    sessionInfoMap.set("chat-activity", {
+      sessionId: "sid-activity",
+      turnCount: 1,
+      lastContextTokens: 0,
+      startTime: Date.now() - 12_000,
+      tool: "codex",
+    });
+    displayCards.set("chat-activity", {
+      cardId: "card-activity",
+      sequence: 1,
+      cardBusy: false,
+      cardCreatedAt: Date.now(),
+      lastSentContent: "",
+      streamErrorNotified: false,
+      sessionId: "sid-activity",
+      turnCount: 1,
+      dotCount: 0,
+    });
+    mockStreamStates.set("sid-activity", {
+      accumulatedContent: "正在检查日志",
+      finalReply: "",
+      activity: {
+        kind: "tool",
+        startedAt: Date.now() - 12_000,
+        toolName: "Shell",
+        toolCount: 1,
+      },
+      status: "running",
+      turnCount: 1,
+    });
+
+    startUnifiedDisplayLoop();
+    await vi.advanceTimersByTimeAsync(3_000);
+
+    const payload = vi.mocked(platform.cardUpdate).mock.calls[0]?.[1];
+    expect(payload).toBeTypeOf("string");
+    const card = JSON.parse(payload as string) as {
+      header: { title: { content: string } };
+      body: { elements: Array<{ tag: string; content?: string }> };
+    };
+    expect(card.header.title.content).toBe("正在执行 Shell · 15秒");
+    expect(card.body.elements[0]?.content).toBe("正在检查日志\n。");
+  });
+});
+
+describe("unified display loop terminal card update", () => {
   beforeEach(() => {
     vi.useFakeTimers();
     resetState();

package/src/__tests__/startup-lifecycle.test.ts

@@ -0,0 +1,98 @@
+import { describe, expect, it, vi } from "vitest";
+
+import {
+  INTERNAL_RESTART_ENV_VAR,
+  buildWebUiUrl,
+  createInternalRestartEnv,
+  openWebUiInDefaultBrowser,
+  shouldAutoOpenWebUi,
+} from "../startup-lifecycle.ts";
+
+describe("ChatCCC startup lifecycle", () => {
+  it("opens the Web UI by default for a direct start", () => {
+    expect(shouldAutoOpenWebUi({ env: {} })).toBe(true);
+    expect(shouldAutoOpenWebUi({ env: {}, openOnStart: true })).toBe(true);
+  });
+
+  it("respects the persisted openOnStart preference", () => {
+    expect(shouldAutoOpenWebUi({ env: {}, openOnStart: false })).toBe(false);
+  });
+
+  it("never opens the Web UI for an internal restart", () => {
+    expect(shouldAutoOpenWebUi({
+      env: { [INTERNAL_RESTART_ENV_VAR]: "1" },
+      openOnStart: true,
+    })).toBe(false);
+  });
+
+  it("marks internal restart children without losing the inherited environment", () => {
+    expect(createInternalRestartEnv({ PATH: "test-path", CUSTOM: "value" })).toEqual({
+      PATH: "test-path",
+      CUSTOM: "value",
+      [INTERNAL_RESTART_ENV_VAR]: "1",
+    });
+  });
+
+  it("uses localhost and the configured port for the Web UI URL", () => {
+    expect(buildWebUiUrl(18080)).toBe("http://localhost:18080/");
+    expect(buildWebUiUrl(18081)).toBe("http://localhost:18081/");
+  });
+
+  it("opens the configured URL in the Windows default browser", () => {
+    const child = {
+      on: vi.fn().mockReturnThis(),
+      unref: vi.fn(),
+    };
+    const spawnImpl = vi.fn(() => child as never);
+
+    expect(openWebUiInDefaultBrowser(18081, {
+      platform: "win32",
+      spawnImpl,
+    })).toBe(true);
+    expect(spawnImpl).toHaveBeenCalledWith(
+      "cmd.exe",
+      ["/c", "start", "", "http://localhost:18081/"],
+      {
+        detached: true,
+        stdio: "ignore",
+        windowsHide: true,
+      },
+    );
+    expect(child.on).toHaveBeenCalledWith("error", expect.any(Function));
+    expect(child.unref).toHaveBeenCalledOnce();
+  });
+
+  it("opens the configured URL with xdg-open on a Linux desktop", () => {
+    const child = {
+      on: vi.fn().mockReturnThis(),
+      unref: vi.fn(),
+    };
+    const spawnImpl = vi.fn(() => child as never);
+
+    expect(openWebUiInDefaultBrowser(18080, {
+      platform: "linux",
+      env: { DISPLAY: ":0" },
+      spawnImpl,
+    })).toBe(true);
+    expect(spawnImpl).toHaveBeenCalledWith(
+      "xdg-open",
+      ["http://localhost:18080/"],
+      { detached: true, stdio: "ignore" },
+    );
+  });
+
+  it("skips xdg-open and prints an SSH tunnel hint on headless Linux", () => {
+    const spawnImpl = vi.fn();
+    const onInfo = vi.fn();
+
+    expect(openWebUiInDefaultBrowser(18080, {
+      platform: "linux",
+      env: {},
+      spawnImpl,
+      onInfo,
+    })).toBe(false);
+    expect(spawnImpl).not.toHaveBeenCalled();
+    expect(onInfo).toHaveBeenCalledWith(expect.stringContaining("ssh -L 18080:127.0.0.1:18080"));
+    expect(onInfo).toHaveBeenCalledWith(expect.stringContaining("http://localhost:18080/"));
+  });
+});

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

@@ -1,11 +1,44 @@
+import { createServer } from "node:http";
+import type { AddressInfo } from "node:net";
 import { describe, it, expect } from "vitest";
 import {
+  AGENT_TEAM_PAGE_HTML,
   PAGE_HTML,
   chooseStartPath,
+  createUiRouter,
   getRestartRequiredReasons,
   unflattenConfig,
 } from "../web-ui.ts";
 
+describe("Agent Team page", () => {
+  it("adds a prominent global entry to the ChatCCC page", () => {
+    expect(PAGE_HTML).toContain('href="/agent-team"');
+    expect(PAGE_HTML).toContain('class="agent-team-entry"');
+    expect(PAGE_HTML).toContain("Agent Team");
+    expect(PAGE_HTML).toContain("linear-gradient");
+  });
+
+  it("contains only the Agent Team title as page content", () => {
+    expect(AGENT_TEAM_PAGE_HTML).toContain("<title>Agent Team</title>");
+    expect(AGENT_TEAM_PAGE_HTML).toContain("<h1>Agent Team</h1>");
+    expect(AGENT_TEAM_PAGE_HTML).not.toContain("dashboard-view");
+    expect(AGENT_TEAM_PAGE_HTML).not.toContain("wizard-view");
+  });
+
+  it("serves the Agent Team page from its own route", async () => {
+    const server = createServer(createUiRouter());
+    await new Promise<void>((resolve) => server.listen(0, "127.0.0.1", resolve));
+    const port = (server.address() as AddressInfo).port;
+    try {
+      const response = await fetch(`http://127.0.0.1:${port}/agent-team`);
+      expect(response.status).toBe(200);
+      expect(await response.text()).toBe(AGENT_TEAM_PAGE_HTML);
+    } finally {
+      await new Promise<void>((resolve, reject) => server.close((err) => err ? reject(err) : resolve()));
+    }
+  });
+});
+
 describe("unflattenConfig", () => {
   it("maps Claude subagent model into claude.subagentModel", () => {
     expect(
@@ -66,6 +99,18 @@ describe("unflattenConfig", () => {
       },
     });
   });
+
+  it("maps the Web UI startup preference into webUi config", () => {
+    expect(
+      unflattenConfig({
+        CHATCCC_WEB_UI_OPEN_ON_START: false,
+      }),
+    ).toEqual({
+      webUi: {
+        openOnStart: false,
+      },
+    });
+  });
 });
 
 describe("getRestartRequiredReasons", () => {
@@ -75,6 +120,7 @@ describe("getRestartRequiredReasons", () => {
       feishu: { enabled: true, platformType: "feishu" },
       ilink: { enabled: true, reuseTokenOnStart: true },
     },
+    webUi: { openOnStart: true },
     chromeDevtools: { enabled: false, port: 15166, chromePath: "" },
     port: 18080,
     claude: {
@@ -142,6 +188,12 @@ describe("getRestartRequiredReasons", () => {
 });
 
 describe("dashboard edit modal", () => {
+  it("keeps the embedded dashboard script syntactically valid", () => {
+    const script = PAGE_HTML.match(/<script>([\s\S]*)<\/script>/)?.[1];
+    expect(script).toBeTruthy();
+    expect(() => new Function(script ?? "")).not.toThrow();
+  });
+
   it("shows the edit modal and overlay when a section edit button is clicked", () => {
     expect(PAGE_HTML).toContain("function editSection(section)");
     expect(PAGE_HTML).toContain("document.getElementById('edit-modal').classList.remove('hidden');");
@@ -158,6 +210,13 @@ describe("dashboard edit modal", () => {
     expect(PAGE_HTML).toContain("生效范围：保存后下一条消息或下个新会话生效");
     expect(PAGE_HTML).toContain("生效范围：飞书开关、App ID、App Secret 或平台类型变更需要重启 ChatCCC");
   });
+
+  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"');
+    expect(PAGE_HTML).toContain("editSection('webUi')");
+    expect(PAGE_HTML).toContain("下次直接启动生效；内部重启始终不打开");
+  });
 });
 
 // ---------------------------------------------------------------------------

package/src/adapters/codex-adapter.ts

@@ -153,6 +153,7 @@ export function normalizeCodexMessage(
       blocks: [
         {
           type: "tool_use",
+          id: msg.item.id,
           name: "Bash",
           input: { command: msg.item.command },
         },

package/src/adapters/cursor-adapter.ts

@@ -297,6 +297,7 @@ export function normalizeCursorMessage(
         blocks: [
           {
             type: "tool_use",
+            id: msg.call_id,
             name: mapToolCallKey(toolKey),
             input: toolData.args ?? {},
           },