chatccc 0.2.178 → 0.2.180

package/README.md

@@ -144,7 +144,12 @@ npm install -g chatccc
 chatccc
 ```
 
-要求 Node.js >= 20。安装完成后，在任意目录执行 `chatccc` 即可启动。配置、日志和状态文件会保存在包目录下的 `config.json`、`logs/`、`state/`。
+要求 Node.js >= 20。安装完成后，在任意目录执行 `chatccc` 即可启动。配置、日志和状态文件会保存在用户目录的 `.chatccc` 下：
+
+- Windows：`C:\Users\<用户名>\.chatccc\`
+- macOS / Linux：`~/.chatccc/`
+
+旧版本留在仓库或包目录下的 `config.json`、`logs/`、`state/` 会在首次启动时自动迁移到用户目录。
 
 首次启动时，如果还没有有效配置，ChatCCC 会自动打开本地 Web 配置向导（默认 `http://127.0.0.1:18080`）。
 
@@ -197,7 +202,7 @@ chatccc
 # 在微信里找到机器人，发送 /new 开始对话
 ```
 
-微信登录信息会保存到 `state/ilink-auth.json`。token 过期后重新扫码即可。
+微信登录信息会保存到 `~/.chatccc/state/ilink-auth.json`。token 过期后重新扫码即可。
 
 ### 3. AI 工具配置
 
@@ -234,7 +239,7 @@ Codex 的默认模型和推理强度可继续由 `~/.codex/config.toml` 管理
 
 ### 4. `config.json`
 
-`config.json` 不存在时，ChatCCC 会从 `config.sample.json` 复制一份。常用结构如下：
+`~/.chatccc/config.json` 不存在时，ChatCCC 会从 `config.sample.json` 复制一份。常用结构如下：
 
 ```json
 {
@@ -242,28 +247,32 @@ Codex 的默认模型和推理强度可继续由 `~/.codex/config.toml` 管理
     "appId": "cli_xxxxxxxxxxxx",
     "appSecret": "xxxxxxxxxxxxxxxxxxxxxxxxxx"
   },
-  "platforms": {
-    "feishu": { "enabled": true },
-    "ilink": { "enabled": true }
-  },
-  "port": 18080,
-  "gitTimeoutSeconds": 180,
-  "claude": {
-    "enabled": false,
-    "defaultAgent": true,
-    "model": "claude-sonnet-4-6",
-    "subagentModel": "",
-    "effort": "",
-    "apiKey": "",
-    "baseUrl": ""
-  },
-  "cursor": {
-    "enabled": false,
-    "defaultAgent": false,
-    "path": "",
-    "model": ""
-  },
-  "codex": {
+  "platforms": {
+    "feishu": { "enabled": true, "platformType": "feishu" },
+    "ilink": { "enabled": true, "reuseTokenOnStart": true }
+  },
+  "port": 18080,
+  "gitTimeoutSeconds": 180,
+  "allowInterrupt": false,
+  "claude": {
+    "enabled": false,
+    "defaultAgent": true,
+    "model": "claude-sonnet-4-6",
+    "subagentModel": "",
+    "effort": "",
+    "apiKey": "",
+    "baseUrl": "",
+    "maxTurn": 0
+  },
+  "cursor": {
+    "enabled": false,
+    "defaultAgent": false,
+    "path": "",
+    "model": "",
+    "avatarBatteryMode": "apiPercent",
+    "onDemandMonthlyBudget": 1000
+  },
+  "codex": {
     "enabled": false,
     "defaultAgent": false,
     "path": "",
@@ -276,16 +285,21 @@ Codex 的默认模型和推理强度可继续由 `~/.codex/config.toml` 管理
 | 字段 | 说明 |
 | --- | --- |
 | `feishu.appId` / `feishu.appSecret` | 飞书应用凭证 |
-| `platforms.feishu.enabled` | 是否启用飞书 |
-| `platforms.ilink.enabled` | 是否启用微信 iLink |
-| `port` | 本地 Web 配置面板和中继服务端口 |
-| `gitTimeoutSeconds` | `/git` 命令超时时间，默认 180 秒 |
-| `*.enabled` | 是否启用对应 AI Agent |
-| `*.defaultAgent` | `/new` 未指定 Agent 时使用哪个工具 |
-| `cursor.path` / `codex.path` | CLI 可执行文件路径；留空时自动探测或使用 PATH |
-| `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 编辑 |
+| `platforms.feishu.enabled` | 是否启用飞书 |
+| `platforms.feishu.platformType` | 飞书平台类型，默认 `feishu` |
+| `platforms.ilink.enabled` | 是否启用微信 iLink |
+| `platforms.ilink.reuseTokenOnStart` | 启动时是否复用已有微信登录 token |
+| `port` | 本地 Web 配置面板和中继服务端口 |
+| `gitTimeoutSeconds` | `/git` 命令超时时间，默认 180 秒 |
+| `allowInterrupt` | 是否允许新消息中断正在运行的任务；默认 false |
+| `*.enabled` | 是否启用对应 AI Agent |
+| `*.defaultAgent` | `/new` 未指定 Agent 时使用哪个工具 |
+| `cursor.path` / `codex.path` | CLI 可执行文件路径；留空时自动探测或使用 PATH |
+| `cursor.avatarBatteryMode` | Cursor 头像电量显示来源：`apiPercent` 或 `onDemandUse` |
+| `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 编辑 |
 
 > **权限控制**：普通消息以 `bypassPermissions` 模式运行，跳过 Agent 操作确认。使用 `/plan` 或 `/ask` 前缀时，ChatCCC 自动切换为只读模式：Claude SDK 仅放行 Read + stop-stuck-loop 网络请求，Codex 使用 `--sandbox read-only`，Cursor 使用 `--mode plan/ask`。请只在可信环境中使用。
 
@@ -301,22 +315,26 @@ Codex 的默认模型和推理强度可继续由 `~/.codex/config.toml` 管理
 | --- | --- |
 | `/new` | 使用默认 Agent 创建新会话 |
 | `/new claude` | 创建 Claude Code 会话 |
-| `/new cursor` | 创建 Cursor 会话 |
-| `/new codex` | 创建 Codex 会话 |
-| `/newh` | 重置当前会话，保留工作目录 |
-| `/model` | 查看或切换当前会话的模型 |
-| `/stop` | 停止当前回复 |
-| `/state` | 查看当前会话状态 |
-| `/cd` | 查看或设置当前会话工作目录 |
+| `/new cursor` | 创建 Cursor 会话 |
+| `/new codex` | 创建 Codex 会话 |
+| `/newh` | 重置当前会话，保留工作目录 |
+| `/model` | 查看或切换当前会话的模型 |
+| `/stop` | 停止当前回复 |
+| `/cancel` | 取消当前会话里排队等待处理的消息 |
+| `/state` | 查看当前会话状态 |
+| `/cd` | 查看或设置当前会话工作目录 |
 | `/sessions` | 查看所有会话状态 |
-| `/usage` | 查看 Codex 5h 用量和周用量 |
+| `/session <数字>` | 将当前群聊切换到 `/sessions` 列表中的指定会话 |
+| `/usage` | 查看当前会话对应 Agent 的用量；Codex 显示 5h/周用量，Cursor 显示当前周期用量 |
 | `/git <子命令>` | 在当前会话工作目录执行 `git ...` 并回传输出 |
-| `/plan <内容>` | 只读计划模式：仅允许读文件和 stop-stuck-loop 请求，不执行任何写操作 |
-| `/ask <内容>` | 只读问答模式：与 /plan 相同，仅允许读文件和 stop-stuck-loop 请求 |
-| `/restart` | 重启机器人进程 |
-| `/updateg` | 更新 npm 全局包并重启（仅限 `npm install -g chatccc` 安装的全局进程） |
-
-> **模型切换**：`/model` 查看可选模型清单，`/model <名称>` 模糊匹配切换，`/model clear` 恢复默认。当前仅 Claude Code 支持模型切换（需同时填写 `claude.model` 和 `claude.subagentModel`），Cursor / Codex 切换正在开发中。
+| `/abd<内容>` | 去掉 `/abd` 前缀后把内容发给 Agent，并在消息末尾追加第一性原理需求澄清提示 |
+| `/plan <内容>` | 只读计划模式：仅允许读文件和 stop-stuck-loop 请求，不执行任何写操作 |
+| `/ask <内容>` | 只读问答模式：与 /plan 相同，仅允许读文件和 stop-stuck-loop 请求 |
+| `/restart` | 重启机器人进程 |
+| `/update` | 更新 npm 全局包并重启（仅限 `npm install -g chatccc` 安装的全局进程） |
+| `/deleteg` | 解散当前飞书会话群；Agent 会话记录保留 |
+
+> **模型切换**：`/model` 查看当前会话 Agent 的可选模型清单，`/model <名称>` 模糊匹配切换，`/model clear` 恢复默认。可选模型来自当前 Agent 的配置：Claude 使用 `claude.model` / `claude.subagentModel`，Cursor 使用 `cursor.model`，Codex 使用 `codex.model`。
 
 ---
 

package/config.sample.json

@@ -24,7 +24,9 @@
     "enabled": false,
     "defaultAgent": false,
     "path": "",
-    "model": ""
+    "model": "",
+    "avatarBatteryMode": "apiPercent",
+    "onDemandMonthlyBudget": 1000
   },
   "codex": {
     "enabled": false,

package/package.json

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

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

@@ -16,10 +16,11 @@ describe("cardJsonToPlainText", () => {
     expect(text).toContain("/new");
     expect(text).toContain("/new cursor");
     expect(text).toContain("/new codex");
-    expect(text).toContain("/restart");
-    expect(text).toContain("/updateg");
-    expect(text).toContain("/cd");
-  });
+    expect(text).toContain("/restart");
+    expect(text).toContain("/update");
+    expect(text).toContain("/cd");
+    expect(text).toContain("/abd");
+  });
 
   it("converts status cards from v1 card format", () => {
     const text = cardJsonToPlainText(buildStatusCard("status body", "green"));

package/src/__tests__/cards.test.ts

@@ -1,15 +1,16 @@
 import { describe, it, expect } from "vitest";
-import {
-  buildProgressCard,
-  buildHelpCard,
+import {
+  buildProgressCard,
+  buildHelpCard,
   buildCdContent,
   buildCdCard,
   buildSessionsCard,
   buildStatusCard,
   buildButtons,
   truncateContent,
-  getToolEmoji,
-} from "../cards.ts";
+  getToolEmoji,
+} from "../cards.ts";
+import { ABD_HELP_LINE } from "../shared-prefix.ts";
 
 // ---------------------------------------------------------------------------
 // truncateContent
@@ -151,14 +152,22 @@ describe("buildHelpCard", () => {
     expect(parsed.elements[0].text.content).toContain("你好");
   });
 
-  it("includes action buttons", () => {
-    const card = buildHelpCard("test");
-    const parsed = JSON.parse(card);
-    const action = parsed.elements[2];
-    expect(action.tag).toBe("action");
-    expect(action.actions).toHaveLength(7);
-  });
-});
+  it("includes action buttons", () => {
+    const card = buildHelpCard("test");
+    const parsed = JSON.parse(card);
+    const action = parsed.elements[2];
+    expect(action.tag).toBe("action");
+    expect(action.actions).toHaveLength(7);
+  });
+
+  it("adds ABD prefix help as the final help line", () => {
+    const card = buildHelpCard("test");
+    const parsed = JSON.parse(card);
+    const lines = parsed.elements[1].text.content.split("\n");
+
+    expect(lines.at(-1)).toBe(ABD_HELP_LINE);
+  });
+});
 
 // ---------------------------------------------------------------------------
 // buildCdContent

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

@@ -8,11 +8,11 @@ import {
   APP_ID,
   APP_SECRET,
   CHATCCC_PORT,
-  CLAUDE_API_KEY,
-  CLAUDE_BASE_URL,
-  CLAUDE_EFFORT,
-  CLAUDE_MAX_TURN,
-  CLAUDE_MODEL,
+  CLAUDE_API_KEY,
+  CLAUDE_BASE_URL,
+  CLAUDE_EFFORT,
+  CLAUDE_MAX_TURN,
+  CLAUDE_MODEL,
   CLAUDE_SUBAGENT_MODEL,
   CURSOR_AGENT_ARGS,
   CURSOR_AGENT_COMMAND,
@@ -53,7 +53,14 @@ const baseAppConfig: AppConfig = {
     baseUrl: "",
     maxTurn: 0,
   },
-  cursor: { enabled: true, defaultAgent: false, path: "/initial/cursor", model: "initial-cursor-model" },
+  cursor: {
+    enabled: true,
+    defaultAgent: false,
+    path: "/initial/cursor",
+    model: "initial-cursor-model",
+    avatarBatteryMode: "apiPercent",
+    onDemandMonthlyBudget: 1000,
+  },
   codex: { enabled: true, defaultAgent: false, path: "/initial/codex", model: "initial-codex-model", effort: "initial-codex-effort" },
 };
 
@@ -82,7 +89,7 @@ describe("applyLoadedConfig — 刷新 export let 常量", () => {
     expect(APP_SECRET).toBe("NEW_APP_SECRET");
   });
 
-  it("更新 Claude 配置（model / subagentModel / effort / maxTurn / apiKey / baseUrl）", () => {
+  it("更新 Claude 配置（model / subagentModel / effort / maxTurn / apiKey / baseUrl）", () => {
     applyLoadedConfig({
       ...structuredClone(baseAppConfig),
       claude: {
@@ -90,18 +97,18 @@ describe("applyLoadedConfig — 刷新 export let 常量", () => {
         defaultAgent: true,
         model: "claude-sonnet-4-6",
         subagentModel: "claude-haiku-4-5-20251001",
-        effort: "high",
-        apiKey: "sk-test",
-        baseUrl: "https://api.example.com",
-        maxTurn: 7,
-      },
-    });
-
-    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_MAX_TURN).toBe(7);
-    expect(CLAUDE_API_KEY).toBe("sk-test");
+        effort: "high",
+        apiKey: "sk-test",
+        baseUrl: "https://api.example.com",
+        maxTurn: 7,
+      },
+    });
+
+    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_MAX_TURN).toBe(7);
+    expect(CLAUDE_API_KEY).toBe("sk-test");
     expect(CLAUDE_BASE_URL).toBe("https://api.example.com");
   });
 
@@ -132,7 +139,7 @@ describe("applyLoadedConfig — 刷新 export let 常量", () => {
   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", avatarBatteryMode: "apiPercent", onDemandMonthlyBudget: 1000 },
     });
 
     // CURSOR_AGENT_ARGS 是 ['-p', '--force', '--approve-mcps', ..., '--model', 'claude-3.7-sonnet']
@@ -144,7 +151,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: "", avatarBatteryMode: "apiPercent", onDemandMonthlyBudget: 1000 },
     });
 
     expect(CURSOR_AGENT_ARGS).not.toContain("--model");
@@ -153,7 +160,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: "", avatarBatteryMode: "apiPercent", onDemandMonthlyBudget: 1000 },
     });
 
     expect(CURSOR_AGENT_COMMAND).toBe("C:/custom/cursor.exe");