chatccc 0.2.18 → 0.2.20

package/README.md

@@ -12,7 +12,7 @@ ChatCCC 把 Claude Code、Cursor Agent、Codex (OpenAI) 接入了飞书群聊：
 
 - **手机上也能用 Claude Code / Cursor / Codex** —— 在飞书群里发消息就等于在终端输入指令，AI 的思考和回复会流式展示在群卡片里
 - **多会话并行** —— 一个群就是一个 AI 会话，完全隔离、互不干扰，并行工作效率更高
-- **多工具切换** —— `/new claude` 创建 Claude Code 会话，`/new cursor` 创建 Cursor 会话，`/new codex` 创建 Codex 会话，各取所长
+- **多工具切换** —— `/new` 使用默认 Agent 创建会话，也可用 `/new claude`、`/new cursor`、`/new codex` 指定工具，各取所长
 
 一句话：**在任何设备上打开飞书，就能让 Claude Code / Cursor / Codex 帮你写代码、排查问题、分析项目。**
 
@@ -118,7 +118,7 @@ ChatCCC 启动时会按以下顺序确定 Cursor Agent CLI：
 
 > 旧版字段 `cursor.command` 仍可读取（启动时会打印一次 warning 提示改名），新配置请统一使用 `cursor.path`。
 
-> **说明**：只使用 Claude Code（`/new claude` 或 `/new`）的用户无需安装 Cursor CLI。
+> **说明**：只使用 Claude Code（`/new claude`，或把 Claude Code 设为默认 Agent 后使用 `/new`）的用户无需安装 Cursor CLI。
 
 #### Codex CLI（使用 Codex 会话时需要）
 
@@ -215,21 +215,24 @@ ChatCCC 的所有运行参数都集中在包根目录的 `config.json`。
   },
   "port": 18080,
   "gitTimeoutSeconds": 180,
-  "claude": {
-    "enabled": false,
-    "model": "",
+  "claude": {
+    "enabled": false,
+    "defaultAgent": true,
+    "model": "",
     "effort": "",
     "apiKey": "",
     "baseUrl": ""
   },
-  "cursor": {
-    "enabled": false,
-    "path": "",
+  "cursor": {
+    "enabled": false,
+    "defaultAgent": false,
+    "path": "",
     "model": ""
   },
-  "codex": {
-    "enabled": false,
-    "path": "",
+  "codex": {
+    "enabled": false,
+    "defaultAgent": false,
+    "path": "",
     "model": "",
     "effort": ""
   }
@@ -242,9 +245,10 @@ ChatCCC 的所有运行参数都集中在包根目录的 `config.json`。
 | --- | --- | --- |
 | `feishu.appId` / `feishu.appSecret` | 是 | 飞书应用「凭证与基础信息」中的 App ID / App Secret |
 | `port` | 否 | 本地 WebSocket 中继 + Web 向导监听端口，默认 `18080`；同机多实例时改成不同值即可 |
-| `gitTimeoutSeconds` | 否 | `/git` 命令在会话工作目录执行时的单次超时秒数，默认 `180`，允许范围 `1–3600`，超时会被 `SIGKILL` 强制终止 |
-| `claude.enabled` / `cursor.enabled` / `codex.enabled` | 否 | 是否启用对应 AI Agent；Web 向导/管理页只展示 `enabled: true` 的 agent 卡片。字段缺省时按「任一配置字段非空」自动判定（向后兼容） |
-| `claude.model` | 否 | Claude Code 会话使用的模型；留空（`""` / 全空白）→ 不向 SDK 传 `model`，由 SDK / 服务商默认决定 |
+| `gitTimeoutSeconds` | 否 | `/git` 命令在会话工作目录执行时的单次超时秒数，默认 `180`，允许范围 `1–3600`，超时会被 `SIGKILL` 强制终止 |
+| `claude.enabled` / `cursor.enabled` / `codex.enabled` | 否 | 是否启用对应 AI Agent；Web 向导/管理页只展示 `enabled: true` 的 agent 卡片。字段缺省时按「任一配置字段非空」自动判定（向后兼容） |
+| `claude.defaultAgent` / `cursor.defaultAgent` / `codex.defaultAgent` | 否 | `/new` 未指定具体 Agent 时使用哪个默认 Agent；同一时间应只有一个为 `true`。Web 配置页切换某个 Agent 为默认时会自动关闭其它 Agent 的默认开关 |
+| `claude.model` | 否 | Claude Code 会话使用的模型；留空（`""` / 全空白）→ 不向 SDK 传 `model`，由 SDK / 服务商默认决定 |
 | `claude.effort` | 否 | Claude 思考深度（如 `low` / `medium` / `high` / `max`）；留空 → 不向 SDK 传 `effort` |
 | `claude.apiKey` | 否 | 第三方 Anthropic 兼容网关的 API 密钥；**官方 Claude 用户保持 `""` 即可**，详见下文「第三方 API」一节 |
 | `claude.baseUrl` | 否 | 第三方 Anthropic 兼容网关的 base URL（例如 `https://api.deepseek.com/anthropic`）；**官方 Claude 用户保持 `""` 即可** |
@@ -289,14 +293,14 @@ ChatCCC 的所有运行参数都集中在包根目录的 `config.json`。
 
 ### 5. 开始使用
 
-在飞书中找到你的机器人，发送 `/new`（默认 Claude Code）或 `/new claude` / `/new cursor` / `/new codex`，机器人会自动创建一个群聊并把 AI 会话绑定到该群。之后直接在群里发消息就能对话。
+在飞书中找到你的机器人，发送 `/new`（使用 `config.json` 中 `defaultAgent: true` 的默认 Agent）或 `/new claude` / `/new cursor` / `/new codex`，机器人会自动创建一个群聊并把 AI 会话绑定到该群。之后直接在群里发消息就能对话。
 
 ### 可用指令
 
 
 | 指令            | 作用                           |
 | --------------- | ---------------------------- |
-| `/new`          | 创建新的 Claude Code 会话（默认）    |
+| `/new`          | 使用默认 Agent 创建新会话            |
 | `/new claude`   | 创建新的 Claude Code 会话          |
 | `/new cursor`   | 创建新的 Cursor 会话               |
 | `/new codex`    | 创建新的 Codex 会话（OpenAI）         |
@@ -313,4 +317,4 @@ ChatCCC 的所有运行参数都集中在包根目录的 `config.json`。
 
 ## 技术栈
 
-TypeScript / Node.js >= 20 / tsx / Anthropic Claude Agent SDK / Cursor Agent CLI / Codex CLI (OpenAI) / 飞书 WebSocket API / CardKit
+TypeScript / Node.js >= 20 / tsx / Anthropic Claude Agent SDK / Cursor Agent CLI / Codex CLI (OpenAI) / 飞书 WebSocket API / CardKit

package/bin/chatccc.mjs

@@ -1,24 +1,24 @@
-#!/usr/bin/env node
-import { spawnSync } from "node:child_process";
-import { createRequire } from "node:module";
-import { dirname, join } from "node:path";
-
-const require = createRequire(import.meta.url);
-// 相对 bin/chatccc.mjs 解析 package.json，包根目录不依赖 cwd，也不会多退一级到 node_modules
-const pkgRoot = dirname(require.resolve("../package.json"));
-const indexTs = join(pkgRoot, "src", "index.ts");
-const tsxCli = require.resolve("tsx/cli");
-
-const result = spawnSync(process.execPath, [tsxCli, indexTs, ...process.argv.slice(2)], {
-  stdio: "inherit",
-  cwd: process.cwd(),
-  env: process.env,
-});
-
-const code = result.status === null ? 1 : result.status;
-if (code !== 0) {
-  console.error("[ 未启动 ]");
-  console.error("chatccc 子进程已结束，服务没有在后台运行。");
-}
-
+#!/usr/bin/env node
+import { spawnSync } from "node:child_process";
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
+
+const require = createRequire(import.meta.url);
+// 相对 bin/chatccc.mjs 解析 package.json，包根目录不依赖 cwd，也不会多退一级到 node_modules
+const pkgRoot = dirname(require.resolve("../package.json"));
+const indexTs = join(pkgRoot, "src", "index.ts");
+const tsxCli = require.resolve("tsx/cli");
+
+const result = spawnSync(process.execPath, [tsxCli, indexTs, ...process.argv.slice(2)], {
+  stdio: "inherit",
+  cwd: process.cwd(),
+  env: process.env,
+});
+
+const code = result.status === null ? 1 : result.status;
+if (code !== 0) {
+  console.error("[ 未启动 ]");
+  console.error("chatccc 子进程已结束，服务没有在后台运行。");
+}
+
 process.exit(code);

package/config.sample.json

@@ -1,26 +1,29 @@
-{
-  "feishu": {
-    "appId": "",
-    "appSecret": ""
-  },
-  "port": 18080,
-  "gitTimeoutSeconds": 180,
-  "claude": {
-    "enabled": false,
-    "model": "",
-    "effort": "",
-    "apiKey": "",
-    "baseUrl": ""
-  },
-  "cursor": {
-    "enabled": false,
-    "path": "",
-    "model": ""
-  },
-  "codex": {
-    "enabled": false,
-    "path": "",
-    "model": "",
-    "effort": ""
-  }
-}
+{
+  "feishu": {
+    "appId": "",
+    "appSecret": ""
+  },
+  "port": 18080,
+  "gitTimeoutSeconds": 180,
+  "claude": {
+    "enabled": false,
+    "defaultAgent": true,
+    "model": "",
+    "effort": "",
+    "apiKey": "",
+    "baseUrl": ""
+  },
+  "cursor": {
+    "enabled": false,
+    "defaultAgent": false,
+    "path": "",
+    "model": ""
+  },
+  "codex": {
+    "enabled": false,
+    "defaultAgent": false,
+    "path": "",
+    "model": "",
+    "effort": ""
+  }
+}

package/package.json

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

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

@@ -16,10 +16,11 @@ import {
   CURSOR_AGENT_COMMAND,
   GIT_TIMEOUT_MS,
   GIT_TIMEOUT_SECONDS,
-  applyLoadedConfig,
-  config,
-  type AppConfig,
-} from "../config.ts";
+  applyLoadedConfig,
+  config,
+  resolveDefaultAgentTool,
+  type AppConfig,
+} from "../config.ts";
 
 // ---------------------------------------------------------------------------
 // applyLoadedConfig — setup → service「在线切换」时刷新进程内 config 的核心机制
@@ -36,15 +37,16 @@ const baseAppConfig: AppConfig = {
   feishu: { appId: "INITIAL_APP", appSecret: "INITIAL_SECRET" },
   port: 18080,
   gitTimeoutSeconds: 180,
-  claude: {
-    enabled: true,
-    model: "initial-model",
+  claude: {
+    enabled: true,
+    defaultAgent: true,
+    model: "initial-model",
     effort: "initial-effort",
     apiKey: "sk-initial",
     baseUrl: "https://initial.gw/anthropic",
   },
-  cursor: { enabled: true, path: "/initial/cursor", model: "initial-cursor-model" },
-  codex: { enabled: true, path: "/initial/codex", model: "initial-codex-model", effort: "initial-codex-effort" },
+  cursor: { enabled: true, defaultAgent: false, path: "/initial/cursor", model: "initial-cursor-model" },
+  codex: { enabled: true, defaultAgent: false, path: "/initial/codex", model: "initial-codex-model", effort: "initial-codex-effort" },
 };
 
 // 把 module 状态抢救快照：每个 it 跑前重置回这个状态，避免污染相邻测试。
@@ -75,9 +77,10 @@ describe("applyLoadedConfig — 刷新 export let 常量", () => {
   it("更新 Claude 配置（model / effort / apiKey / baseUrl）", () => {
     applyLoadedConfig({
       ...structuredClone(baseAppConfig),
-      claude: {
-        enabled: true,
-        model: "deepseek-v4-pro",
+      claude: {
+        enabled: true,
+        defaultAgent: true,
+        model: "deepseek-v4-pro",
         effort: "high",
         apiKey: "sk-newkey",
         baseUrl: "https://gw2.example/anthropic",
@@ -104,7 +107,7 @@ describe("applyLoadedConfig — 刷新 export let 常量", () => {
   it("CURSOR_AGENT_ARGS 跟随 cursor.model 重新解析", () => {
     applyLoadedConfig({
       ...structuredClone(baseAppConfig),
-      cursor: { enabled: true, path: "/x/cursor", model: "claude-3.7-sonnet" },
+      cursor: { enabled: true, defaultAgent: false, path: "/x/cursor", model: "claude-3.7-sonnet" },
     });
 
     // CURSOR_AGENT_ARGS 是 ['-p', '--force', ..., '--model', 'claude-3.7-sonnet']
@@ -115,7 +118,7 @@ describe("applyLoadedConfig — 刷新 export let 常量", () => {
   it("cursor.model 留空时 CURSOR_AGENT_ARGS 不含 --model", () => {
     applyLoadedConfig({
       ...structuredClone(baseAppConfig),
-      cursor: { enabled: true, path: "/x/cursor", model: "" },
+      cursor: { enabled: true, defaultAgent: false, path: "/x/cursor", model: "" },
     });
 
     expect(CURSOR_AGENT_ARGS).not.toContain("--model");
@@ -124,7 +127,7 @@ describe("applyLoadedConfig — 刷新 export let 常量", () => {
   it("CURSOR_AGENT_COMMAND 优先取 config.cursor.path", () => {
     applyLoadedConfig({
       ...structuredClone(baseAppConfig),
-      cursor: { enabled: true, path: "C:/custom/cursor.exe", model: "" },
+      cursor: { enabled: true, defaultAgent: false, path: "C:/custom/cursor.exe", model: "" },
     });
 
     expect(CURSOR_AGENT_COMMAND).toBe("C:/custom/cursor.exe");
@@ -142,14 +145,14 @@ describe("applyLoadedConfig — 刷新 export let 常量", () => {
   });
 });
 
-describe("applyLoadedConfig — config 对象引用契约", () => {
+describe("applyLoadedConfig — config 对象引用契约", () => {
   it("config 引用保持不变（就地更新），但字段被刷新", () => {
     const refBefore = config;
 
     applyLoadedConfig({
       ...structuredClone(baseAppConfig),
       feishu: { appId: "REF_TEST_APP", appSecret: "REF_TEST_SECRET" },
-      codex: { enabled: true, path: "/refresh/codex", model: "fresh-model", effort: "low" },
+      codex: { enabled: true, defaultAgent: false, path: "/refresh/codex", model: "fresh-model", effort: "low" },
     });
 
     // 必须是同一个引用：codex-adapter 等下游模块"直接 import config"，
@@ -167,5 +170,24 @@ describe("applyLoadedConfig — config 对象引用契约", () => {
     expect(APP_ID).toBe("");
     expect(APP_SECRET).toBe("");
     expect(config.feishu.appId).toBe("");
-  });
-});
+  });
+});
+
+describe("resolveDefaultAgentTool", () => {
+  it("优先使用显式 defaultAgent 且已启用的 Agent", () => {
+    const cfg = structuredClone(baseAppConfig);
+    cfg.claude.defaultAgent = false;
+    cfg.cursor.defaultAgent = true;
+
+    expect(resolveDefaultAgentTool(cfg)).toBe("cursor");
+  });
+
+  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");
+  });
+});