chatccc 0.2.50 → 0.2.52

package/README.md

@@ -1,6 +1,6 @@
 # ChatCCC
 
-**飞书（Lark）聊天控制 Claude Code / Cursor / Codex**
+**飞书（推荐，体验丝滑）/ 微信 聊天控制 Claude Code / Cursor / Codex**
 
 ---
 
@@ -8,9 +8,10 @@
 
 传统的 Claude Code（尤其是使用第三方 API 的，如 DeepSeek），需要坐在电脑桌前才能用。**离开电脑就没法用了。**
 
-ChatCCC 把 Claude Code、Cursor Agent、Codex (OpenAI) 接入了飞书群聊：
+ChatCCC 把 Claude Code、Cursor Agent、Codex (OpenAI) 接入了飞书群聊和微信私聊：
 
-- **手机上也能用 Claude Code / Cursor / Codex** —— 在飞书群里发消息就等于在终端输入指令，AI 的思考和回复会流式展示在群卡片里
+- **手机上也能用 Claude Code / Cursor / Codex** —— 在飞书群或微信里发消息就等于在终端输入指令，AI 的思考和回复会流式展示在群卡片里（微信为文本模式）
+- **双平台支持** —— 飞书（群聊 + 卡片）和微信 iLink（私聊 + 文本），一套代码同时服务两个平台
 - **多会话并行** —— 一个群就是一个 AI 会话，完全隔离、互不干扰，并行工作效率更高
 - **多工具切换** —— `/new` 使用默认 Agent 创建会话，也可用 `/new claude`、`/new cursor`、`/new codex` 指定工具，各取所长
 
@@ -32,6 +33,45 @@ ChatCCC 把 Claude Code、Cursor Agent、Codex (OpenAI) 接入了飞书群聊：
 - **零配置成本** —— 单一 `config.json`，没有 TOML 也没有零散环境变量。`npm i -g chatccc` 后**任意目录**直接 `chatccc` 就跑，首次启动自动弹出本地 Web 配置向导
 - **群里能跑 git** —— `/git status`、`/git pull`、`/git log` 在飞书群里直接执行 stdout/stderr 回发，不用回电脑
 - **代码极简易改** —— 纯 TypeScript 实现，核心只有 20 多个文件，统一 `ToolAdapter` 接口屏蔽 Claude / Cursor / Codex 差异，看得懂、改得动
+- **微信 iLink 支持** —— 扫码登录微信个人号，即可在微信中与 AI 对话。微信端为纯文本模式（无卡片），生成过程中的内容以增量方式推送，避免重复刷屏。
+
+---
+
+## 微信 iLink 平台
+
+除了飞书，ChatCCC 也支持通过 [微信 iLink](https://github.com/openilink/openilink-sdk-node) 接入微信个人号。**微信模式无需任何配置，启动后扫码即可使用。**
+
+### 快速开始（微信）
+
+```bash
+chatccc                                # 启动 ChatCCC
+# → 控制台打印出微信扫码二维码
+# → 打开微信扫一扫 → 关注机器人
+# → 发送 /new 开始对话
+```
+
+就这么简单。**不用创建飞书应用、不用配置权限、不用订阅回调。** 扫一下控制台上的二维码就能用。
+
+### 微信与飞书的差异
+
+| 特性 | 飞书 | 微信 |
+| --- | --- | --- |
+| 会话类型 | 群聊（一群一会话） | 私聊（一对一） |
+| 消息展示 | CardKit 卡片（流式更新） | 纯文本（增量推送，结尾标记"━━━ 回答结束 ━━━"） |
+| `/new` 行为 | 创建新群聊 | 在当前私聊中创建新会话 |
+| `/newh` 行为 | 群内重置会话 | 私聊内重置会话 |
+| 非指令消息 | 走卡片进度展示 | 立即回复"生成中..."，增量推送结果 |
+| 群管理 | 创建/重命名/解散/设置头像 | 不支持 |
+| 启动方式 | 飞书应用凭证 + WebSocket | 扫码登录（QR 码） |
+| 连接保活 | WebSocket 长连接 | HTTP 长轮询 |
+
+### 启用微信
+
+`config.json` 中 `platforms.ilink.enabled` 设为 `true`（默认已开启）。启动 ChatCCC 后，终端会打印微信扫码登录二维码，使用微信扫描即可登录。
+
+> 微信 iLink 登录的 token 和 context 会持久化到 `state/ilink-auth.json`，下次启动时会自动尝试复用。token 过期后重新扫码即可。
+
+> 微信模式下无须配置飞书应用、无须订阅事件回调。只需启动 ChatCCC → 扫码 → 在微信中找到机器人即可对话。
 
 ---
 
@@ -229,6 +269,10 @@ ChatCCC 的所有运行参数都集中在包根目录的 `config.json`。
     "appId": "cli_xxxxxxxxxxxx",
     "appSecret": "xxxxxxxxxxxxxxxxxxxxxxxxxx"
   },
+  "platforms": {
+    "feishu": { "enabled": true },
+    "ilink": { "enabled": true }
+  },
   "port": 18080,
   "gitTimeoutSeconds": 180,
   "claude": {
@@ -260,6 +304,7 @@ ChatCCC 的所有运行参数都集中在包根目录的 `config.json`。
 | 字段 | 必填 | 说明 |
 | --- | --- | --- |
 | `feishu.appId` / `feishu.appSecret` | 是 | 飞书应用「凭证与基础信息」中的 App ID / App Secret |
+| `platforms.feishu.enabled` / `platforms.ilink.enabled` | 否 | IM 平台开关；默认同时开启飞书和微信 iLink。开启微信后启动时会显示扫码登录二维码 |
 | `port` | 否 | 本地 WebSocket 中继 + Web 向导监听端口，默认 `18080`；同机多实例时改成不同值即可 |
 | `gitTimeoutSeconds` | 否 | `/git` 命令在会话工作目录执行时的单次超时秒数，默认 `180`，允许范围 `1–3600`，超时会被 `SIGKILL` 强制终止 |
 | `claude.enabled` / `cursor.enabled` / `codex.enabled` | 否 | 是否启用对应 AI Agent；Web 向导/管理页只展示 `enabled: true` 的 agent 卡片。字段缺省时按「任一配置字段非空」自动判定（向后兼容） |
@@ -309,7 +354,9 @@ ChatCCC 的所有运行参数都集中在包根目录的 `config.json`。
 
 ### 5. 开始使用
 
-在飞书中找到你的机器人，发送 `/new`（使用 `config.json` 中 `defaultAgent: true` 的默认 Agent）或 `/new claude` / `/new cursor` / `/new codex`，机器人会自动创建一个群聊并把 AI 会话绑定到该群。之后直接在群里发消息就能对话。
+**飞书：** 在飞书中找到你的机器人，发送 `/new`（使用默认 Agent）或 `/new claude` / `/new cursor` / `/new codex`，机器人会自动创建一个群聊并把 AI 会话绑定到该群。之后直接在群里发消息就能对话。
+
+**微信：** 启动 `chatccc` 后，控制台会打印微信扫码二维码。打开微信扫一扫关注机器人，直接发送 `/new` 或 `/new claude` 等指令即可在私聊中开始对话。所有命令与飞书端完全一致。
 
 ### 可用指令
 

package/config.sample.json

@@ -1,30 +1,34 @@
-{
-  "feishu": {
-    "appId": "",
-    "appSecret": ""
-  },
-  "port": 18080,
-  "gitTimeoutSeconds": 180,
-  "allowInterrupt": false,
-  "claude": {
-    "enabled": false,
-    "defaultAgent": true,
-    "model": "",
-    "effort": "",
-    "apiKey": "",
-    "baseUrl": ""
-  },
-  "cursor": {
-    "enabled": false,
-    "defaultAgent": false,
-    "path": "",
-    "model": ""
-  },
-  "codex": {
-    "enabled": false,
-    "defaultAgent": false,
-    "path": "",
-    "model": "",
-    "effort": ""
-  }
-}
+{
+  "feishu": {
+    "appId": "",
+    "appSecret": ""
+  },
+  "platforms": {
+    "feishu": { "enabled": true },
+    "ilink": { "enabled": true, "reuseTokenOnStart": true }
+  },
+  "port": 18080,
+  "gitTimeoutSeconds": 180,
+  "allowInterrupt": false,
+  "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.50",
+  "version": "0.2.52",
   "description": "Feishu bot bridge for Claude Code",
   "license": "Apache-2.0",
   "type": "module",

package/src/__tests__/card-plain-text.test.ts

@@ -0,0 +1,42 @@
+import { describe, expect, it } from "vitest";
+
+import { cardJsonToPlainText } from "../card-plain-text.ts";
+import {
+  buildHelpCard,
+  buildProgressCard,
+  buildStatusCard,
+} from "../cards.ts";
+
+describe("cardJsonToPlainText", () => {
+  it("converts help cards to readable text with commands", () => {
+    const text = cardJsonToPlainText(buildHelpCard("hello"));
+
+    expect(text).toContain("# ChatCCC");
+    expect(text).toContain("hello");
+    expect(text).toContain("/new");
+    expect(text).toContain("/new cursor");
+    expect(text).toContain("/new codex");
+    expect(text).toContain("/restart");
+    expect(text).toContain("/cd");
+  });
+
+  it("converts status cards from v1 card format", () => {
+    const text = cardJsonToPlainText(buildStatusCard("status body", "green"));
+
+    expect(text).toContain("# 会话状态");
+    expect(text).toContain("status body");
+  });
+
+  it("converts schema 2.0 progress cards", () => {
+    const text = cardJsonToPlainText(buildProgressCard("stream body"));
+
+    expect(text).toContain("# 生成中...");
+    expect(text).toContain("stream body");
+    expect(text).toContain("/status");
+    expect(text).toContain("/stop");
+  });
+
+  it("returns null for invalid card json", () => {
+    expect(cardJsonToPlainText("{bad json")).toBeNull();
+  });
+});

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

@@ -685,6 +685,14 @@ describe("createClaudeAdapter — env 注入", () => {
     // 确保每个用例从干净的 process.env 起步
     delete process.env.ANTHROPIC_API_KEY;
     delete process.env.ANTHROPIC_BASE_URL;
+    delete process.env.ANTHROPIC_AUTH_TOKEN;
+    delete process.env.CLAUDE_CODE_OAUTH_TOKEN;
+    delete process.env.ANTHROPIC_MODEL;
+    delete process.env.ANTHROPIC_DEFAULT_OPUS_MODEL;
+    delete process.env.ANTHROPIC_DEFAULT_SONNET_MODEL;
+    delete process.env.ANTHROPIC_DEFAULT_HAIKU_MODEL;
+    delete process.env.CLAUDE_CODE_SUBAGENT_MODEL;
+    delete process.env.CLAUDE_CODE_EFFORT_LEVEL;
   });
 
   // 用例之间清掉我们写入的 env，避免互相污染
@@ -780,6 +788,51 @@ describe("createClaudeAdapter — env 注入", () => {
     expect(opts.env.ANTHROPIC_BASE_URL).toBe("https://gateway.example/anthropic");
   });
 
+  it("ChatCCC API config is isolated from Claude settings auth/model env", async () => {
+    setupMockCreateSession();
+    process.env.ANTHROPIC_AUTH_TOKEN = "token-from-claude-settings";
+    process.env.CLAUDE_CODE_OAUTH_TOKEN = "oauth-from-claude-settings";
+    process.env.ANTHROPIC_MODEL = "model-from-claude-settings";
+    process.env.ANTHROPIC_DEFAULT_SONNET_MODEL = "sonnet-from-claude-settings";
+    process.env.CLAUDE_CODE_SUBAGENT_MODEL = "subagent-from-claude-settings";
+    process.env.CLAUDE_CODE_EFFORT_LEVEL = "max";
+    const adapter = createClaudeAdapter({
+      model: "chatccc-model",
+      effort: "high",
+      isEmpty: (v) => v.trim() === "",
+      apiKey: "sk-chatccc",
+      baseUrl: "https://chatccc-gateway.example/anthropic",
+    });
+
+    await adapter.createSession("/cwd");
+
+    const opts = sdk.unstable_v2_createSession.mock.calls[0][0];
+    expect(opts.env.ANTHROPIC_API_KEY).toBe("sk-chatccc");
+    expect(opts.env.ANTHROPIC_BASE_URL).toBe("https://chatccc-gateway.example/anthropic");
+    expect(opts.env.ANTHROPIC_AUTH_TOKEN).toBeUndefined();
+    expect(opts.env.CLAUDE_CODE_OAUTH_TOKEN).toBeUndefined();
+    expect(opts.env.ANTHROPIC_MODEL).toBeUndefined();
+    expect(opts.env.ANTHROPIC_DEFAULT_SONNET_MODEL).toBeUndefined();
+    expect(opts.env.CLAUDE_CODE_SUBAGENT_MODEL).toBeUndefined();
+    expect(opts.env.CLAUDE_CODE_EFFORT_LEVEL).toBeUndefined();
+  });
+
+  it("第三方 API 配置时仍然加载 CLAUDE.md（settingSources 始终为 project+local）", async () => {
+    setupMockCreateSession();
+    const adapter = createClaudeAdapter({
+      model: "",
+      effort: "",
+      isEmpty: (v) => v.trim() === "",
+      apiKey: "sk-chatccc",
+      baseUrl: "https://chatccc-gateway.example/anthropic",
+    });
+
+    await adapter.createSession("/cwd");
+
+    const opts = sdk.unstable_v2_createSession.mock.calls[0][0];
+    expect(opts.settingSources).toEqual(["project", "local"]);
+  });
+
   it("不修改主进程 process.env（永不污染）", async () => {
     setupMockCreateSession();
     const before = { ...process.env };
@@ -817,4 +870,4 @@ describe("createClaudeAdapter — env 注入", () => {
     expect(opts.env.ANTHROPIC_API_KEY).toBe("from-system-env");
     expect(opts.env.ANTHROPIC_BASE_URL).toBe("https://override.example/anthropic");
   });
-});
+});

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

@@ -12,15 +12,17 @@ import {
   CLAUDE_BASE_URL,
   CLAUDE_EFFORT,
   CLAUDE_MODEL,
-  CURSOR_AGENT_ARGS,
-  CURSOR_AGENT_COMMAND,
-  GIT_TIMEOUT_MS,
-  GIT_TIMEOUT_SECONDS,
+  CURSOR_AGENT_ARGS,
+  CURSOR_AGENT_COMMAND,
+  FEISHU_ENABLED,
+  GIT_TIMEOUT_MS,
+  GIT_TIMEOUT_SECONDS,
+  ILINK_ENABLED,
   applyLoadedConfig,
   config,
-  resolveDefaultAgentTool,
-  type AppConfig,
-} from "../config.ts";
+  resolveDefaultAgentTool,
+  type AppConfig,
+} from "../config.ts";
 
 // ---------------------------------------------------------------------------
 // applyLoadedConfig — setup → service「在线切换」时刷新进程内 config 的核心机制
@@ -33,20 +35,22 @@ import {
 //      原地切换复用同一 server，重新读端口只会引入混乱）
 // ---------------------------------------------------------------------------
 
-const baseAppConfig: AppConfig = {
-  feishu: { appId: "INITIAL_APP", appSecret: "INITIAL_SECRET" },
+const baseAppConfig: AppConfig = {
+  feishu: { appId: "INITIAL_APP", appSecret: "INITIAL_SECRET" },
+  platforms: { feishu: { enabled: true }, ilink: { enabled: true } },
   port: 18080,
   gitTimeoutSeconds: 180,
-  claude: {
-    enabled: true,
-    defaultAgent: true,
-    model: "initial-model",
+  allowInterrupt: false,
+  claude: {
+    enabled: true,
+    defaultAgent: true,
+    model: "initial-model",
     effort: "initial-effort",
     apiKey: "sk-initial",
     baseUrl: "https://initial.gw/anthropic",
   },
-  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" },
+  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 跑前重置回这个状态，避免污染相邻测试。
@@ -77,10 +81,10 @@ describe("applyLoadedConfig — 刷新 export let 常量", () => {
   it("更新 Claude 配置（model / effort / apiKey / baseUrl）", () => {
     applyLoadedConfig({
       ...structuredClone(baseAppConfig),
-      claude: {
-        enabled: true,
-        defaultAgent: true,
-        model: "deepseek-v4-pro",
+      claude: {
+        enabled: true,
+        defaultAgent: true,
+        model: "deepseek-v4-pro",
         effort: "high",
         apiKey: "sk-newkey",
         baseUrl: "https://gw2.example/anthropic",
@@ -93,7 +97,7 @@ describe("applyLoadedConfig — 刷新 export let 常量", () => {
     expect(CLAUDE_BASE_URL).toBe("https://gw2.example/anthropic");
   });
 
-  it("更新 GIT_TIMEOUT_SECONDS 与 GIT_TIMEOUT_MS（毫秒派生值同步刷新）", () => {
+  it("更新 GIT_TIMEOUT_SECONDS 与 GIT_TIMEOUT_MS（毫秒派生值同步刷新）", () => {
     applyLoadedConfig({
       ...structuredClone(baseAppConfig),
       gitTimeoutSeconds: 240,
@@ -102,12 +106,25 @@ describe("applyLoadedConfig — 刷新 export let 常量", () => {
     expect(GIT_TIMEOUT_SECONDS).toBe(240);
     // 派生值必须跟着更新，否则 /git 仍然按旧 timeout 运行
     expect(GIT_TIMEOUT_MS).toBe(240 * 1000);
-  });
+  });
+
+  it("更新平台开关（默认飞书和微信都开启）", () => {
+    expect(FEISHU_ENABLED).toBe(true);
+    expect(ILINK_ENABLED).toBe(true);
+
+    applyLoadedConfig({
+      ...structuredClone(baseAppConfig),
+      platforms: { feishu: { enabled: false }, ilink: { enabled: true } },
+    });
+
+    expect(FEISHU_ENABLED).toBe(false);
+    expect(ILINK_ENABLED).toBe(true);
+  });
 
   it("CURSOR_AGENT_ARGS 跟随 cursor.model 重新解析", () => {
     applyLoadedConfig({
       ...structuredClone(baseAppConfig),
-      cursor: { enabled: true, defaultAgent: false, 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']
@@ -118,7 +135,7 @@ describe("applyLoadedConfig — 刷新 export let 常量", () => {
   it("cursor.model 留空时 CURSOR_AGENT_ARGS 不含 --model", () => {
     applyLoadedConfig({
       ...structuredClone(baseAppConfig),
-      cursor: { enabled: true, defaultAgent: false, path: "/x/cursor", model: "" },
+      cursor: { enabled: true, defaultAgent: false, path: "/x/cursor", model: "" },
     });
 
     expect(CURSOR_AGENT_ARGS).not.toContain("--model");
@@ -127,7 +144,7 @@ describe("applyLoadedConfig — 刷新 export let 常量", () => {
   it("CURSOR_AGENT_COMMAND 优先取 config.cursor.path", () => {
     applyLoadedConfig({
       ...structuredClone(baseAppConfig),
-      cursor: { enabled: true, defaultAgent: false, 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");
@@ -145,14 +162,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, defaultAgent: false, 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"，
@@ -170,24 +187,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");
-  });
-});
+  });
+});
+
+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");
+  });
+});

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

@@ -0,0 +1,19 @@
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+
+import { describe, expect, it } from "vitest";
+
+describe("config.sample.json", () => {
+  it("enables Feishu and WeChat iLink by default", () => {
+    const configSamplePath = join(process.cwd(), "config.sample.json");
+    const sample = JSON.parse(readFileSync(configSamplePath, "utf8")) as {
+      platforms?: {
+        feishu?: { enabled?: unknown };
+        ilink?: { enabled?: unknown };
+      };
+    };
+
+    expect(sample.platforms?.feishu?.enabled).toBe(true);
+    expect(sample.platforms?.ilink?.enabled).toBe(true);
+  });
+});