chatccc 0.2.218 → 0.2.220

package/README.md

@@ -1,8 +1,8 @@
 # ChatCCC
 
-**用飞书或微信聊天控制 Claude Code / Cursor / Codex。**
+**用飞书或微信聊天控制 Claude Code / Cursor / Codex / CCC Agent。**
 
-ChatCCC 把本地 AI 编程工具接入即时通讯软件。你可以在手机上发消息，让 Claude Code、Cursor Agent 或 Codex 继续写代码、查问题、跑命令；不用一直守在电脑前。
+ChatCCC 把本地 AI 编程工具接入即时通讯软件。你可以在手机上发消息，让 Claude Code、Cursor Agent、Codex 或内置 CCC Agent 继续写代码、查问题、跑命令；不用一直守在电脑前。
 
 飞书是推荐入口：直接私聊机器人即可持续使用同一个专属会话，需要并行任务时再用 `/new` 创建独立会话群；卡片能流式更新，体验完整。微信 iLink 更适合快速试用或临时使用：扫码即可接入，但只能走私聊文本模式。
 
@@ -21,7 +21,7 @@ ChatCCC 把本地 AI 编程工具接入即时通讯软件。你可以在手机
 - **手机上也能用 AI 编程工具**：在飞书或微信发消息，就像在终端给 Agent 下指令。
 - **飞书体验更完整**：私聊可持续对话，`/new` 创建的一群一会话支持多任务并行，CardKit 卡片可流式更新。
 - **微信接入更轻**：不用创建飞书应用，启动后扫码即可在微信私聊里使用。
-- **多 Agent 切换**：`/new` 使用默认 Agent，也可以用 `/new claude`、`/new cursor`、`/new codex` 指定工具。
+- **多 Agent 切换**：`/new` 使用默认 Agent，也可以用 `/new claude`、`/new cursor`、`/new codex`、`/new ccc` 指定工具。
 - **群里能跑 git**：`/git status`、`/git pull`、`/git log` 会在当前会话工作目录执行，并把输出发回聊天窗口。
 
 ## 飞书和微信的差异
@@ -208,7 +208,7 @@ chatccc
 
 ### 3. AI 工具配置
 
-ChatCCC 只负责把聊天消息转给本地 AI 工具，不捆绑这些 CLI。你只需要安装自己要用的 Agent。
+Claude Code、Cursor 和 Codex 需要对应的本地工具；CCC Agent 内置于 ChatCCC，只需配置 DeepSeek 兼容 API。
 
 #### Claude Code
 
@@ -237,7 +237,13 @@ codex login
 codex --version
 ```
 
-Codex 的默认模型和推理强度可继续由 `~/.codex/config.toml` 管理，也可以在 `config.json` 中覆盖。
+Codex 的默认模型和推理强度可继续由 `~/.codex/config.toml` 管理，也可以在 `config.json` 中覆盖。
+
+#### CCC Agent
+
+CCC Agent 是 ChatCCC 内置的编程 Agent，不需要额外安装 CLI。在首次配置向导或 Web 管理页中启用后，填写 DeepSeek 兼容 API Key、Base URL 和模型即可使用；它可以设为 `/new` 的默认 Agent，也可以通过 `/new ccc` 显式创建会话。
+
+`ccc.alternativeModel` 是单个备选模型，只会加入 `/model` 的人工切换列表，不会在请求失败时自动重试或切换，避免重复执行带副作用的工具调用。
 
 #### 可选：Chrome CDP
 
@@ -285,22 +291,32 @@ Codex 的默认模型和推理强度可继续由 `~/.codex/config.toml` 管理
     "baseUrl": "",
     "maxTurn": 0
   },
-  "cursor": {
+  "cursor": {
     "enabled": false,
     "defaultAgent": false,
-    "path": "",
-    "model": "",
-    "avatarBatteryMode": "apiPercent",
+    "path": "",
+    "model": "",
+    "alternativeModel": "",
+    "avatarBatteryMode": "apiPercent",
     "onDemandMonthlyBudget": 1000
   },
-  "codex": {
+  "codex": {
     "enabled": false,
     "defaultAgent": false,
     "path": "",
     "model": "",
+    "alternativeModel": "",
     "effort": "",
     "fastMode": false
-  }
+  },
+  "ccc": {
+    "enabled": false,
+    "defaultAgent": false,
+    "DEEPSEEK_API_KEY": "",
+    "DEEPSEEK_BASE_URL": "https://api.deepseek.com/v1",
+    "model": "deepseek-v4-pro",
+    "alternativeModel": ""
+  }
 }
 ```
 
@@ -326,18 +342,23 @@ Codex 的默认模型和推理强度可继续由 `~/.codex/config.toml` 管理
 | `cursor.onDemandMonthlyBudget` | `avatarBatteryMode=onDemandUse` 时用于计算电量的月预算 |
 | `claude.model` / `claude.subagentModel` / `claude.effort` | 选填；设置后传给 Claude Agent SDK，留空以 `~/.claude/settings.json` 为准 |
 | `claude.apiKey` / `claude.baseUrl` | 选填；设置后传给 Claude Agent SDK，留空以 `~/.claude/settings.json` 为准 |
-| `claude.maxTurn` | 选填；Claude 最大对话轮数，默认 0（无限制），可在 Web UI 编辑 |
+| `claude.maxTurn` | 选填；Claude 最大对话轮数，默认 0（无限制），可在 Web UI 编辑 |
+| `cursor.alternativeModel` / `codex.alternativeModel` / `ccc.alternativeModel` | 单个备选模型；加入 `/model` 人工切换列表，不会自动故障转移 |
+| `ccc.DEEPSEEK_API_KEY` / `ccc.DEEPSEEK_BASE_URL` | CCC Agent 使用的 DeepSeek 兼容 API 凭证和服务地址 |
+| `ccc.model` | CCC Agent 默认模型 |
 
 > **权限控制**：普通消息以 `bypassPermissions` 模式运行，跳过 Agent 操作确认。使用 `/plan` 或 `/ask` 前缀时，ChatCCC 自动切换为只读模式：Claude SDK 仅放行 Read + stop-stuck-loop 网络请求，Codex 使用 `--sandbox read-only`，Cursor 使用 `--mode plan/ask`。请只在可信环境中使用。
 
 ### 5. 开始使用
 
-**飞书：** 找到机器人后直接发送普通消息，即可在当前私聊中创建并持续使用专属 AI 会话；私聊工作目录固定为运行 ChatCCC 的系统账号用户目录。默认 Agent 发生变化后，下一条私聊普通消息会触发切换并创建新的空会话；若旧 Agent 正在生成，该消息会先排队，待当前回复完成后再切换。命令不会触发自动切换。需要独立任务时，发送 `/new`、`/new claude`、`/new cursor` 或 `/new codex`，机器人会另外创建会话群。
+**飞书：** 找到机器人后直接发送普通消息，即可在当前私聊中创建并持续使用专属 AI 会话；私聊工作目录固定为运行 ChatCCC 的系统账号用户目录。默认 Agent 发生变化后，下一条私聊普通消息会触发切换并创建新的空会话；若旧 Agent 正在生成，该消息会先排队，待当前回复完成后再切换。命令不会触发自动切换。需要独立任务时，发送 `/new`、`/new claude`、`/new cursor`、`/new codex` 或 `/new ccc`，机器人会另外创建会话群。
 
 **微信：** 扫码登录后，在机器人私聊里发送 `/new` 或指定 Agent 的 `/new ...` 命令即可开始。功能与飞书基本一致，但展示为纯文本。
 
 **会话停滞保护：** 当 Agent 连续 3 分钟停在“正在启动 Agent”且没有任何事件，或停在“正在生成回复”且回复字符数没有变化，同时尚未报告权威终态时，ChatCCC 会结束旧 CLI，并优先补发一次“完成了吗？如果没完成继续”；恢复轮再次发生相同停滞时不再递归续跑。`/new claude` 和 `/new cursor` 在等待底层 init 事件时也使用 3 分钟超时并主动清理 SDK/CLI。思考、搜索和工具调用阶段不按回复字符数误判，由进程资源监控负责识别真正僵死。Codex 只有 `turn.completed` 才算权威终态，阶段性的 `agent_message` 不算；任一 Agent 报告权威终态后若输出流仍超过 10 秒未关闭，ChatCCC 会强制清理该 CLI 并按正常完成收尾，不会重复询问 Agent。
 
+**CCC Agent 代码搜索：** `search_code` 使用项目自带的跨平台 ripgrep，不要求系统另行安装 `rg`。如果当前平台没有可用的 bundled/system ripgrep，会自动降级为内置 Node 搜索，并继续支持常用正则、glob、结果上限、中止和超时控制。
+
 ## 可用指令
 
 | 指令 | 作用 |
@@ -346,6 +367,7 @@ Codex 的默认模型和推理强度可继续由 `~/.codex/config.toml` 管理
 | `/new claude` | 创建 Claude Code 会话；飞书中会创建新群 |
 | `/new cursor` | 创建 Cursor 会话；飞书中会创建新群 |
 | `/new codex` | 创建 Codex 会话；飞书中会创建新群 |
+| `/new ccc` | 创建内置 CCC Agent 会话；飞书中会创建新群 |
 | `/newh` | 在当前聊天原地重置会话；群聊保留工作目录，飞书私聊固定使用系统用户目录 |
 | `/model` | 查看或切换当前会话的模型 |
 | `/fast` | 查看当前 Codex 会话的 Fast 模式；使用 `/fast on` 或 `/fast off` 切换 |
@@ -355,7 +377,7 @@ Codex 的默认模型和推理强度可继续由 `~/.codex/config.toml` 管理
 | `/cd` | 查看或设置后续新建会话的默认工作目录，不改变当前会话；飞书私聊自身始终使用系统用户目录 |
 | `/sessions` | 查看所有会话状态 |
 | `/session <数字>` | 将当前群聊切换到 `/sessions` 列表中的指定会话；飞书私聊不支持切换 |
-| `/usage` | 查看当前会话对应 Agent 的用量；Codex 按接口实际返回显示 5h/7天窗口（缺失窗口不显示），若 Chrome CDP 可用且 ChatGPT 已登录，会额外显示订阅到期时间；Cursor 显示当前周期用量 |
+| `/usage` | 查看当前会话对应 Agent 的用量；Codex 显示 5h/7天窗口，Cursor 显示当前周期用量，使用官方 DeepSeek API 的 CCC Agent 显示账户余额 |
 | `/git <子命令>` | 在当前会话工作目录执行 `git ...` 并回传输出 |
 | `/abd<内容>` | 去掉 `/abd` 前缀后把内容发给 Agent，并在消息末尾追加第一性原理需求澄清提示 |
 | `/plan <内容>` | 只读计划模式：仅允许读文件和 stop-stuck-loop 请求，不执行任何写操作 |
@@ -366,7 +388,7 @@ Codex 的默认模型和推理强度可继续由 `~/.codex/config.toml` 管理
 
 `/update` 会在执行 npm 更新前把飞书消息或按钮事件 ID 原子写入 `~/.chatccc/state/update-command-guard.json`。同一 ID 跨重启重投时会静默忽略；用户主动发送的新 `/update` 因事件 ID 不同，仍可立即执行。该保护仅作用于 `/update`，普通消息与 `/restart` 的处理不变。
 
-> **模型切换**：`/model` 查看当前会话 Agent 的可选模型清单，`/model <名称>` 模糊匹配切换，`/model clear` 恢复默认。可选模型来自当前 Agent 的配置：Claude 使用 `claude.model` / `claude.subagentModel`，Cursor 使用 `cursor.model`，Codex 使用 `codex.model`。
+> **模型切换**：`/model` 查看当前会话 Agent 的可选模型清单，`/model <名称>` 模糊匹配切换，`/model clear` 恢复默认。可选模型来自当前 Agent 的配置：Claude 使用 `claude.model` / `claude.subagentModel`；Cursor、Codex 和 CCC Agent 使用各自的 `model` / `alternativeModel`。
 
 > **Codex Fast 模式**：Web UI 中的“Fast 模式”设置新 Codex 会话的全局默认值，默认关闭。进入 Codex 会话后，`/fast` 查询当前状态，`/fast on` 和 `/fast off` 只覆盖当前会话并从下一条消息生效。ChatCCC 会显式向 Codex CLI 传入 `service_tier="fast"` 或 `service_tier="default"`，因此关闭时不会继承用户 `config.toml` 中可能开启的 Fast。
 
@@ -374,4 +396,4 @@ Codex 的默认模型和推理强度可继续由 `~/.codex/config.toml` 管理
 
 ## 技术栈
 
-TypeScript / Node.js >= 20 / tsx / Anthropic Claude Agent SDK / Cursor Agent CLI / Codex CLI / 飞书 WebSocket API / CardKit / 微信 iLink
+TypeScript / Node.js >= 20 / tsx / AI SDK / Anthropic Claude Agent SDK / Cursor Agent CLI / Codex CLI / 飞书 WebSocket API / CardKit / 微信 iLink

package/config.sample.json

@@ -73,8 +73,11 @@
     "fastMode": false
   },
   "ccc": {
+    "enabled": false,
+    "defaultAgent": false,
     "DEEPSEEK_API_KEY": "",
     "DEEPSEEK_BASE_URL": "https://api.deepseek.com/v1",
-    "model": "deepseek-v4-pro"
+    "model": "deepseek-v4-pro",
+    "alternativeModel": ""
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chatccc",
-  "version": "0.2.218",
+  "version": "0.2.220",
   "description": "Feishu bot bridge for Claude Code",
   "license": "Apache-2.0",
   "type": "module",
@@ -51,6 +51,7 @@
     "@anthropic-ai/claude-agent-sdk": "0.2.133",
     "@larksuiteoapi/node-sdk": "^1.59.0",
     "@openilink/openilink-sdk-node": "^0.6.0",
+    "@vscode/ripgrep": "^1.18.0",
     "ai": "^6.0.184",
     "nodemailer": "^8.0.7",
     "qrcode-terminal": "^0.12.0",

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

@@ -18,9 +18,12 @@ afterEach(() => {
 describe("builtin ChatSession config", () => {
   it("does not fall back to DEEPSEEK_API_KEY environment variable", () => {
     config.ccc = {
+      enabled: false,
+      defaultAgent: false,
       DEEPSEEK_API_KEY: "",
       DEEPSEEK_BASE_URL: "https://api.deepseek.com/v1",
       model: "deepseek-v4-pro",
+      alternativeModel: "",
     };
     process.env.DEEPSEEK_API_KEY = "sk-env-should-not-be-used";
 

package/src/__tests__/builtin-file-tools.test.ts

@@ -1,9 +1,7 @@
-import { execFile } from "node:child_process";
 import { createHash } from "node:crypto";
-import { mkdtemp, readFile, rm, stat, writeFile } from "node:fs/promises";
+import { mkdir, mkdtemp, readFile, rm, stat, writeFile } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
-import { promisify } from "node:util";
 
 import { afterEach, describe, expect, it } from "vitest";
 
@@ -19,7 +17,6 @@ import {
   searchCodeForTool,
 } from "../builtin/file-tools.ts";
 
-const execFileAsync = promisify(execFile);
 const tempDirs: string[] = [];
 
 async function makeTempDir(): Promise<string> {
@@ -28,15 +25,6 @@ async function makeTempDir(): Promise<string> {
   return dir;
 }
 
-async function hasRg(): Promise<boolean> {
-  try {
-    await execFileAsync("rg", ["--version"]);
-    return true;
-  } catch {
-    return false;
-  }
-}
-
 function sha256(text: string): string {
   return createHash("sha256").update(text).digest("hex");
 }
@@ -75,20 +63,52 @@ describe("builtin file tools", () => {
     }));
   });
 
-  it("searches code with rg without using a shell", async () => {
-    if (!await hasRg()) return;
-
+  it("searches with the project-bundled ripgrep even when rg is absent from PATH", async () => {
     const dir = await makeTempDir();
     await writeFile(join(dir, "a.ts"), "const marker = 1;\n", "utf8");
+    const originalPath = process.env.PATH;
+    process.env.PATH = "";
+
+    try {
+      const result = await searchCodeForTool(dir, { query: "marker", glob: "*.ts" });
+
+      expect(result.matches).toEqual([
+        expect.objectContaining({
+          line: 1,
+          column: 7,
+          text: "const marker = 1;",
+        }),
+      ]);
+    } finally {
+      process.env.PATH = originalPath;
+    }
+  });
 
-    const result = await searchCodeForTool(dir, { query: "marker", glob: "*.ts" });
-
-    expect(result.matches).toEqual([
-      expect.objectContaining({
-        line: 1,
-        text: "const marker = 1;",
-      }),
-    ]);
+  it("falls back to Node search when no ripgrep executable can be used", async () => {
+    const dir = await makeTempDir();
+    await writeFile(join(dir, "a.ts"), "const marker = 1;\n", "utf8");
+    await mkdir(join(dir, "nested"));
+    await writeFile(join(dir, "nested", "b.md"), "xx marker = 2\n", "utf8");
+    await writeFile(join(dir, "ignored.txt"), "marker = 3\n", "utf8");
+    const originalPath = process.env.PATH;
+    process.env.PATH = "";
+
+    try {
+      const result = await searchCodeForTool(
+        dir,
+        { query: "marker\\s*=\\s*\\d", glob: "**/*.{ts,md}", maxResults: 10 },
+        undefined,
+        { ripgrepCommands: [join(dir, "missing-rg")] },
+      );
+
+      expect(result.matches).toEqual([
+        expect.objectContaining({ path: join(dir, "a.ts"), line: 1, column: 7 }),
+        expect.objectContaining({ path: join(dir, "nested", "b.md"), line: 1, column: 4 }),
+      ]);
+      expect(result.truncated).toBe(false);
+    } finally {
+      process.env.PATH = originalPath;
+    }
   });
 
   it("runs non-interactive shell commands in the requested cwd", async () => {

package/src/__tests__/cards.test.ts

@@ -161,7 +161,7 @@ describe("buildHelpCard", () => {
     const parsed = JSON.parse(card);
     const action = parsed.elements[2];
     expect(action.tag).toBe("action");
-    expect(action.actions).toHaveLength(7);
+    expect(action.actions).toHaveLength(8);
   });
 
   it("adds ABD prefix help as the final help line", () => {
@@ -169,17 +169,17 @@ describe("buildHelpCard", () => {
     const parsed = JSON.parse(card);
     const lines = parsed.elements[1].text.content.split("\n");
 
-    expect(lines).toContain("发送 **/usage** 查看 Codex 实际存在的 5h/7天用量窗口，以及查询/使用主动重置卡");
+    expect(lines).toContain("发送 **/usage** 查看当前 Agent 的用量或余额");
     expect(lines.at(-1)).toBe(ABD_HELP_LINE);
   });
 
-  it("does not advertise the hidden ccc agent", () => {
+  it("advertises CCC Agent as a normal session option", () => {
     const card = buildHelpCard("test");
     const parsed = JSON.parse(card);
     const text = JSON.stringify(parsed);
 
-    expect(text).not.toContain("/new ccc");
-    expect(text).not.toContain("CCC Agent");
+    expect(text).toContain("/new ccc");
+    expect(text).toContain("CCC Agent");
   });
 });
 
@@ -419,7 +419,7 @@ describe("buildSessionsCard", () => {
     expect(content).not.toContain("Cursor 会话");
   });
 
-  it("labels hidden ccc sessions without grouping them as Claude Code", () => {
+  it("labels CCC sessions without grouping them as Claude Code", () => {
     const card = buildSessionsCard([
       { sessionId: "session-20260702-121530-a1b2c3", chatName: "", chatId: "oc_ccc", active: false, turnCount: 1, elapsedSeconds: null, model: "deepseek-v4-pro", tool: "ccc" },
     ]);

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

@@ -72,7 +72,7 @@ const baseAppConfig: AppConfig = {
     onDemandMonthlyBudget: 1000,
   },
   codex: { enabled: true, defaultAgent: false, path: "/initial/codex", model: "initial-codex-model", alternativeModel: "initial-codex-alt-model", effort: "initial-codex-effort", fastMode: false },
-  ccc: { DEEPSEEK_API_KEY: "initial-ccc-key", DEEPSEEK_BASE_URL: "https://initial.deepseek.test/v1", model: "initial-ccc-model" },
+  ccc: { enabled: true, defaultAgent: false, DEEPSEEK_API_KEY: "initial-ccc-key", DEEPSEEK_BASE_URL: "https://initial.deepseek.test/v1", model: "initial-ccc-model", alternativeModel: "initial-ccc-alt-model" },
 };
 
 // 把 module 状态抢救快照：每个 it 跑前重置回这个状态，避免污染相邻测试。
@@ -177,15 +177,18 @@ describe("applyLoadedConfig — 刷新 export let 常量", () => {
     expect(CURSOR_AGENT_COMMAND).toBe("C:/custom/cursor.exe");
   });
 
-  it("/model 候选列表包含 Cursor/Codex 的单个备选模型并保持主模型优先", () => {
+  it("/model 候选列表包含 Cursor/Codex/CCC 的单个备选模型并保持主模型优先", () => {
     const cfg = structuredClone(baseAppConfig);
     cfg.cursor.model = "cursor-main";
     cfg.cursor.alternativeModel = "cursor-alt";
     cfg.codex.model = "codex-main";
-    cfg.codex.alternativeModel = "codex-main";
+    cfg.codex.alternativeModel = "codex-main";
+    cfg.ccc.model = "ccc-main";
+    cfg.ccc.alternativeModel = "ccc-alt";
 
     expect(getAllModelsForTool("cursor", cfg)).toEqual(["cursor-main", "cursor-alt"]);
-    expect(getAllModelsForTool("codex", cfg)).toEqual(["codex-main"]);
+    expect(getAllModelsForTool("codex", cfg)).toEqual(["codex-main"]);
+    expect(getAllModelsForTool("ccc", cfg)).toEqual(["ccc-main", "ccc-alt"]);
   });
 
   it("不修改 CHATCCC_PORT（端口在 setup 切换时必须保持不变）", () => {
@@ -262,12 +265,20 @@ describe("resolveDefaultAgentTool", () => {
     expect(resolveDefaultAgentTool(cfg)).toBe("cursor");
   });
 
-  it("defaultAgent 指向未启用 Agent 时回退到第一个已启用 Agent", () => {
+  it("defaultAgent 指向未启用 Agent 时回退到第一个已启用 Agent", () => {
     const cfg = structuredClone(baseAppConfig);
     cfg.claude.enabled = false;
     cfg.claude.defaultAgent = true;
     cfg.cursor.defaultAgent = false;
 
-    expect(resolveDefaultAgentTool(cfg)).toBe("cursor");
-  });
-});
+    expect(resolveDefaultAgentTool(cfg)).toBe("cursor");
+  });
+
+  it("支持把已启用的 CCC Agent 设为默认 Agent", () => {
+    const cfg = structuredClone(baseAppConfig);
+    for (const tool of ["claude", "cursor", "codex"] as const) cfg[tool].defaultAgent = false;
+    cfg.ccc.defaultAgent = true;
+
+    expect(resolveDefaultAgentTool(cfg)).toBe("ccc");
+  });
+});

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

@@ -33,19 +33,23 @@ describe("config.sample.json", () => {
     const sample = JSON.parse(readFileSync(configSamplePath, "utf8")) as {
       cursor?: { alternativeModel?: unknown };
       codex?: { alternativeModel?: unknown; fastMode?: unknown };
+      ccc?: { alternativeModel?: unknown };
     };
 
     expect(sample.cursor?.alternativeModel).toBe("");
     expect(sample.codex?.alternativeModel).toBe("");
+    expect(sample.ccc?.alternativeModel).toBe("");
     expect(sample.codex?.fastMode).toBe(false);
   });
 
   it("sets ccc agent DeepSeek defaults in the sample config", () => {
     const configSamplePath = join(process.cwd(), "config.sample.json");
     const sample = JSON.parse(readFileSync(configSamplePath, "utf8")) as {
-      ccc?: { DEEPSEEK_API_KEY?: unknown; DEEPSEEK_BASE_URL?: unknown; model?: unknown };
+      ccc?: { enabled?: unknown; defaultAgent?: unknown; DEEPSEEK_API_KEY?: unknown; DEEPSEEK_BASE_URL?: unknown; model?: unknown };
     };
 
+    expect(sample.ccc?.enabled).toBe(false);
+    expect(sample.ccc?.defaultAgent).toBe(false);
     expect(sample.ccc?.DEEPSEEK_API_KEY).toBe("");
     expect(sample.ccc?.DEEPSEEK_BASE_URL).toBe("https://api.deepseek.com/v1");
     expect(sample.ccc?.model).toBe("deepseek-v4-pro");
@@ -89,4 +93,4 @@ describe("config.sample.json", () => {
       expect(sample.rawStreamLogs?.[tool]?.keepCompleted).toBe(false);
     }
   });
-});
+});

package/src/__tests__/orchestrator.test.ts

@@ -148,6 +148,12 @@ describe("handleCommand WeChat processing ack", () => {
     config.cursor.defaultAgent = false;
     config.codex.defaultAgent = false;
     config.codex.fastMode = false;
+    config.ccc.enabled = true;
+    config.ccc.defaultAgent = false;
+    config.ccc.DEEPSEEK_API_KEY = "sk-test-ccc";
+    config.ccc.DEEPSEEK_BASE_URL = "https://api.deepseek.com/v1";
+    config.ccc.model = "deepseek-v4-pro";
+    config.ccc.alternativeModel = "deepseek-v4-flash";
     mockStreamStates.clear();
     mockGetCodexUsageSummary.mockReset();
     mockGetCursorUsageSummary.mockReset();
@@ -204,7 +210,8 @@ describe("handleCommand WeChat processing ack", () => {
     _clearAdapterCacheForTest();
     _resetSessionRegistryFileForTest();
     _resetSessionToolsFileForTest();
-    vi.useRealTimers();
+    vi.useRealTimers();
+    vi.unstubAllGlobals();
     await rm(tempDir, { recursive: true, force: true });
   });
 
@@ -1013,7 +1020,7 @@ describe("handleCommand WeChat processing ack", () => {
     expect(card.elements[0].text.content).toContain("ChatGPT browser session has no access token.");
   });
 
-  it("handles /usage as Cursor usage in Cursor chats", async () => {
+  it("handles /usage as Cursor usage in Cursor chats", async () => {
     const platform = mockPlatform("feishu");
     await recordSessionRegistry({
       chatId: "cursor-chat",
@@ -1113,6 +1120,64 @@ describe("handleCommand WeChat processing ack", () => {
     expect(claudeReadyCall?.[2]).not.toContain("/usage");
   });
 
+  it("handles /usage as DeepSeek balance in CCC Agent chats", async () => {
+    const platform = mockPlatform("feishu");
+    const fetchMock = vi.fn(async () => new Response(JSON.stringify({
+      is_available: true,
+      balance_infos: [{
+        currency: "CNY",
+        total_balance: "12.34",
+        topped_up_balance: "10.00",
+        granted_balance: "2.34",
+      }],
+    }), { status: 200 }));
+    vi.stubGlobal("fetch", fetchMock);
+    await recordSessionRegistry({
+      chatId: "ccc-chat",
+      sessionId: "sid-ccc",
+      tool: "ccc",
+      chatName: "ccc-session",
+      running: false,
+    });
+
+    await handleCommand(platform, "/usage", "ccc-chat", "ou-user", Date.now(), "group");
+
+    expect(fetchMock).toHaveBeenCalledWith(
+      "https://api.deepseek.com/user/balance",
+      expect.objectContaining({ headers: { Authorization: "Bearer sk-test-ccc" } }),
+    );
+    expect(platform.sendCard).toHaveBeenCalledWith(
+      "ccc-chat",
+      "CCC Usage",
+      expect.stringContaining("总余额: 12.34"),
+      "blue",
+    );
+  });
+
+  it("does not query balance for a non-official CCC API endpoint", async () => {
+    const platform = mockPlatform("feishu");
+    const fetchMock = vi.fn();
+    vi.stubGlobal("fetch", fetchMock);
+    config.ccc.DEEPSEEK_BASE_URL = "https://deepseek-proxy.example.com/v1";
+    await recordSessionRegistry({
+      chatId: "ccc-proxy-chat",
+      sessionId: "sid-ccc-proxy",
+      tool: "ccc",
+      chatName: "ccc-proxy-session",
+      running: false,
+    });
+
+    await handleCommand(platform, "/usage", "ccc-proxy-chat", "ou-user", Date.now(), "group");
+
+    expect(fetchMock).not.toHaveBeenCalled();
+    expect(platform.sendCard).toHaveBeenCalledWith(
+      "ccc-proxy-chat",
+      "CCC Usage",
+      expect.stringContaining("仅支持官方 DeepSeek API"),
+      "blue",
+    );
+  });
+
   it("reloads runtime config for the exact /reload command", async () => {
     const platform = mockPlatform("feishu");
 
@@ -1129,7 +1194,7 @@ describe("handleCommand WeChat processing ack", () => {
     );
   });
 
-  it("allows the hidden /new ccc entry without advertising it in normal help", async () => {
+  it("allows and advertises the /new ccc entry", async () => {
     const platform = mockPlatform("feishu");
     _setAdapterForToolForTest("ccc", mockAdapter("session-20260702-121530-a1b2c3"));
 
@@ -1150,7 +1215,21 @@ describe("handleCommand WeChat processing ack", () => {
     const helpPlatform = mockPlatform("feishu");
     await handleCommand(helpPlatform, "hello", "feishu-group-help", "ou-user", Date.now(), "group");
     const helpCard = vi.mocked(helpPlatform.sendRawCard).mock.calls.at(-1)?.[1] as string;
-    expect(helpCard).not.toContain("/new ccc");
-    expect(helpCard).not.toContain("CCC Agent");
+    expect(helpCard).toContain("/new ccc");
+    expect(helpCard).toContain("CCC Agent");
+  });
+
+  it("shows the CCC model list when CCC Agent is the unbound default", async () => {
+    const platform = mockPlatform("feishu");
+    config.claude.defaultAgent = false;
+    config.cursor.defaultAgent = false;
+    config.codex.defaultAgent = false;
+    config.ccc.defaultAgent = true;
+
+    await handleCommand(platform, "/model", "feishu-p2p-ccc-model", "ou-user", Date.now(), "p2p");
+
+    const card = vi.mocked(platform.sendRawCard).mock.calls.at(-1)?.[1] as string;
+    expect(card).toContain("deepseek-v4-pro");
+    expect(card).toContain("deepseek-v4-flash");
   });
 });

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

@@ -80,4 +80,14 @@ describe("SimulatedPlatform", () => {
     // 近期消息不触发
     expect(SimulatedPlatform.formatDelayNotice(Date.now(), "test")).toBeNull();
   });
+
+  it("formatDelayNotice 边界：恰好 15 分钟触发，未来时间戳不触发", () => {
+    const now = Date.now();
+    // 恰好等于阈值（15 分钟）应触发提醒
+    expect(SimulatedPlatform.formatDelayNotice(now - 15 * 60 * 1000, "边界", now)).not.toBeNull();
+    // 14 分 59 秒不触发
+    expect(SimulatedPlatform.formatDelayNotice(now - (15 * 60 * 1000 - 1000), "边界", now)).toBeNull();
+    // 未来时间戳（时钟偏移）不触发
+    expect(SimulatedPlatform.formatDelayNotice(now + 60 * 1000, "边界", now)).toBeNull();
+  });
 });

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

@@ -86,6 +86,28 @@ describe("unflattenConfig", () => {
     });
   });
 
+  it("maps CCC Agent settings into ccc config", () => {
+    expect(
+      unflattenConfig({
+        CHATCCC_CCC_ENABLED: true,
+        CHATCCC_CCC_DEFAULT_AGENT: true,
+        CHATCCC_CCC_API_KEY: "sk-test-ccc",
+        CHATCCC_CCC_BASE_URL: "https://api.deepseek.com/v1",
+        CHATCCC_CCC_MODEL: "deepseek-v4-flash",
+        CHATCCC_CCC_ALTERNATIVE_MODEL: "deepseek-v4-pro",
+      }),
+    ).toEqual({
+      ccc: {
+        enabled: true,
+        defaultAgent: true,
+        DEEPSEEK_API_KEY: "sk-test-ccc",
+        DEEPSEEK_BASE_URL: "https://api.deepseek.com/v1",
+        model: "deepseek-v4-flash",
+        alternativeModel: "deepseek-v4-pro",
+      },
+    });
+  });
+
   it("maps Chrome CDP guard fields into chromeDevtools config", () => {
     expect(
       unflattenConfig({
@@ -153,6 +175,14 @@ describe("getRestartRequiredReasons", () => {
       effort: "",
       fastMode: false,
     },
+    ccc: {
+      enabled: true,
+      defaultAgent: false,
+      DEEPSEEK_API_KEY: "sk-test-ccc",
+      DEEPSEEK_BASE_URL: "https://api.deepseek.com/v1",
+      model: "deepseek-v4-pro",
+      alternativeModel: "",
+    },
   };
 
   it("does not require restart for agent and Chrome runtime settings", () => {
@@ -215,6 +245,16 @@ describe("dashboard edit modal", () => {
     expect(PAGE_HTML).toContain("备选模型");
   });
 
+  it("shows CCC Agent in the wizard and dashboard with model switching fields", () => {
+    expect(PAGE_HTML).toContain('id="agent-card-ccc"');
+    expect(PAGE_HTML).toContain('id="agent-enable-ccc"');
+    expect(PAGE_HTML).toContain('id="agent-default-ccc"');
+    expect(PAGE_HTML).toContain('id="field-CHATCCC_CCC_MODEL"');
+    expect(PAGE_HTML).toContain('id="field-CHATCCC_CCC_ALTERNATIVE_MODEL"');
+    expect(PAGE_HTML).toContain('id="dash-ccc"');
+    expect(PAGE_HTML).toContain("editSection('ccc')");
+  });
+
   it("shows config effect scope hints", () => {
     expect(PAGE_HTML).toContain("生效范围：保存后下一条消息或下个新会话生效");
     expect(PAGE_HTML).toContain("生效范围：飞书开关、App ID、App Secret 或平台类型变更需要重启 ChatCCC");