chatccc 0.2.1 → 0.2.3

package/README.md

@@ -67,21 +67,29 @@ npm run dev
 
 **添加应用能力**：开启「机器人」功能。
 
-**权限配置**（在「权限管理」中搜索并开通以下权限）：
+**权限配置（重要）**（在「权限管理」中按前缀搜索，**将以下三类前缀开头的权限全部开通**）：
 
+| 前缀 | 用途（简要） |
+| ---- | ------------ |
+| `im:message` | 收发与读取消息、以机器人身份发言、与会话相关的消息能力等 |
+| `im:chat` | 创建与管理群聊、与会话绑定、群成员与聊天场景相关能力等 |
+| `cardkit:` | 群卡片展示、流式更新、卡片按钮与交互回调相关能力等 |
 
-| 权限                              | 用途        |
-| ------------------------------- | --------- |
-| `im:chat`                       | 创建和管理群聊   |
-| `im:message`                    | 收发消息      |
-| `im:message:send_as_bot`        | 以机器人身份发消息 |
-| `im:message.p2p_msg:readonly`   | 读取私聊消息    |
-| `im:message.group_msg:readonly` | 读取群聊消息    |
+控制台中同一前缀下往往有多条子权限，请逐项勾选开通，避免遗漏导致收不到消息或卡片异常。
 
+<p align="center">
+  <img src="images/img_readme_permission.png" alt="飞书应用权限配置" width="280" />
+</p>
+
+**事件订阅（重要）**（在「事件与回调」中）：订阅 `im.message.receive_v1` 和 `card.action.trigger` 事件。
 
-**事件订阅**（在「事件与回调」中）：订阅 `im.message.receive_v1` 和 `card.action.trigger` 事件。
+<p align="center">
+  <img src="images/img_readme_event.png" alt="飞书事件订阅" width="280" />
+  &emsp;
+  <img src="images/img_readme_callback.png" alt="飞书请求网址与回调" width="280" />
+</p>
 
-**发布版本**：配置完成后创建应用版本并发布（仅企业内部可用即可）。
+**发布版本（不要忘了）**：配置完成后创建应用版本并发布（仅企业内部可用即可）。
 
 ### 3. 获取凭证
 
@@ -112,6 +120,36 @@ CHATCCC_ANTHROPIC_MODEL=default
 CHATCCC_ANTHROPIC_EFFORT=default
 ```
 
+#### 注意！第三方 API（如 DeepSeek）与鉴权 403
+
+若你通过 **Anthropic 兼容网关**（例如 DeepSeek 的 `/anthropic` 端点）调用模型，除了官方 Claude 以外，需要配置 **`ANTHROPIC_API_KEY`**（API 密钥）与 **`ANTHROPIC_BASE_URL`**（写入系统环境变量，见下表）。
+
+不少用户会把这些写在 **`~/.claude/settings.json`**（Windows 一般为 `C:\Users\<用户名>\.claude\settings.json`）的 `env` 字段里，供本机 **交互式 Claude Code** 使用。但 **Claude Agent SDK 在启动时拉起的是子进程**，其行为与直接打开终端跑 Claude Code 并不完全一致，**子进程未必会按你预期读取 `.claude` 目录下 `settings.json` 里的 `ANTHROPIC_API_KEY`、`ANTHROPIC_BASE_URL` 等**，从而出现类似：
+
+`Failed to authenticate. API Error: 403 Request not allowed`
+
+**建议（最稳妥）**：把 **`ANTHROPIC_BASE_URL`** 与 **`ANTHROPIC_API_KEY`**（API 密钥）写进 **操作系统环境变量**（当前用户的「用户变量」即可，一般无需管理员），例如：
+
+| 变量名 | 说明 |
+| ------ | ---- |
+| `ANTHROPIC_API_KEY` | 在服务商控制台获取的 **API 密钥**，填入本环境变量。Anthropic 兼容网关普遍使用该名称；若服务商文档要求使用其它环境变量名，以文档为准。 |
+| `ANTHROPIC_BASE_URL` | 兼容 Anthropic API 的 base URL，例如 DeepSeek：`https://api.deepseek.com/anthropic` |
+
+若你在 `settings.json` 里还为 Sonnet/Haiku/Opus 配置了默认模型名，可一并同步到用户环境变量（如 `ANTHROPIC_MODEL`、`ANTHROPIC_DEFAULT_SONNET_MODEL` 等），与文档及网关要求保持一致。
+
+修改环境变量后，请 **完全退出并重新打开** 终端、IDE（如 Cursor）以及 ChatCCC 进程，再试飞书对话或本地 `npm run demo:claude-hi`，确保子进程继承到新变量。
+
+在 **Windows** 上可用 PowerShell 写入当前用户的持久变量（示例，请把第二行里的字符串换成你在服务商控制台复制的 **API 密钥**，即 **`ANTHROPIC_API_KEY`** 的值）：
+
+```powershell
+[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.deepseek.com/anthropic", "User")
+[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "你的_API_密钥", "User")
+```
+
+也可在 **系统属性 → 环境变量** 中手动添加。Linux / macOS 可将 `export` 写入 `~/.bashrc`、`~/.zshrc` 等，或使用 systemd、`launchctl` 等按你的部署方式注入。
+
+> **说明**：项目根目录的 `.env` 若通过 `tsx --env-file=.env` 加载，其中的变量会进入 Node 进程环境，**多数情况下**会随进程继承给 SDK 子进程；但各家网关与 Claude Code 版本组合较多，**仍推荐**将 **`ANTHROPIC_API_KEY`** 与 **`ANTHROPIC_BASE_URL`** 放在系统/用户环境变量中，与 `settings.json` 形成双保险，避免仅依赖 `.claude/settings.json` 时在 SDK 场景下踩坑。
+
 `**CHATCCC_PORT`（可选）**：默认端口为 `18080`。若在一台机器上同时运行多个 ChatCCC 实例，可在各自的 `.env` 中设置不同端口：
 
 ```env

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chatccc",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "Feishu bot bridge for Claude Code",
   "license": "Apache-2.0",
   "type": "module",
@@ -22,10 +22,11 @@
     "demo:bot-test:local": "tsx --env-file=.env demo/bot_test.ts --local",
     "demo:create-group": "tsx --env-file=.env src/index.ts",
     "demo:create-group:local": "tsx --env-file=.env src/index.ts --local",
-    "demo:permission-check": "tsx --env-file=.env demo/permission_check.ts"
+    "demo:permission-check": "tsx --env-file=.env demo/permission_check.ts",
+    "demo:claude-hi": "tsx --env-file=.env demo/claude_say_hi.ts"
   },
   "dependencies": {
-    "@anthropic-ai/claude-agent-sdk": "^0.2.133",
+    "@anthropic-ai/claude-agent-sdk": "0.2.133",
     "@larksuiteoapi/node-sdk": "^1.59.0",
     "tsx": "^4.0.0",
     "ws": "^8.18.0"

package/src/cards.ts

@@ -126,17 +126,24 @@ export function buildCdContent(
   dirPath: string,
   entries: { name: string; isDir: boolean }[],
   isUpdate: boolean,
+  currentCwd?: string,
   maxFiles = 100
 ): string {
   const display = entries.slice(0, maxFiles);
   const overflow = entries.length > maxFiles ? `\n...（共 ${entries.length} 个条目，仅显示前 ${maxFiles} 个）` : "";
   const listing = display.map(e => e.isDir ? `📁 ${e.name}/` : `📄 ${e.name}`).join("\n");
 
+  const currentLine = currentCwd
+    ? `**当前会话工作路径:** \`${currentCwd}\``
+    : "";
+
   const statusLine = isUpdate
-    ? `**新会话工作路径已切换至:** \`${dirPath}\``
+    ? `**新会话默认工作路径（已切换）:** \`${dirPath}\``
     : `**新会话默认工作路径:** \`${dirPath}\``;
 
-  return [
+  const lines: string[] = [];
+  if (currentLine) lines.push(currentLine, "");
+  lines.push(
     statusLine,
     ``,
     `此路径持久化在配置文件中，仅影响**新建会话**的工作路径。`,
@@ -145,7 +152,9 @@ export function buildCdContent(
     `**目录内容** (最多 ${maxFiles} 个):`,
     listing,
     overflow,
-  ].join("\n");
+  );
+
+  return lines.join("\n");
 }
 
 // 所有会话列表卡片

package/src/config.ts

@@ -1,4 +1,5 @@
 import { existsSync } from "node:fs";
+import { homedir } from "node:os";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { appendFile, mkdir, readFile, stat, writeFile } from "node:fs/promises";
@@ -65,7 +66,7 @@ export const CLAUDE_EFFORT = process.env.CHATCCC_ANTHROPIC_EFFORT?.trim() || "de
 // 该路径仅影响通过 /new 新建的 Claude 会话，不影响已有会话的 resume。
 export const DEFAULT_CWD_FILE = join(PROJECT_ROOT, ".claude", "working_dir.txt");
 
-/** 读取 /cd 设置的默认工作路径。若文件不存在或路径已失效，回退到 PROJECT_ROOT。 */
+/** 读取 /cd 设置的默认工作路径。若文件不存在或路径已失效，回退到用户主目录。 */
 export async function getDefaultCwd(): Promise<string> {
   try {
     const content = await readFile(DEFAULT_CWD_FILE, "utf-8");
@@ -77,7 +78,9 @@ export async function getDefaultCwd(): Promise<string> {
       } catch { /* path gone, fall through */ }
     }
   } catch { /* file doesn't exist yet */ }
-  return PROJECT_ROOT;
+  // 用户未通过 /cd 设置过工作路径时，回退到操作系统用户主目录
+  // Windows: C:\Users\<用户名>   Linux: /home/<用户名>
+  return homedir();
 }
 
 /** 设置新建会话的默认工作路径（由 /cd 命令调用） */

package/src/index.ts

@@ -22,6 +22,7 @@
  */
 
 import { spawn } from "node:child_process";
+import { getSessionInfo } from "@anthropic-ai/claude-agent-sdk";
 import { readdir, stat } from "node:fs/promises";
 import { resolve, dirname, basename } from "node:path";
 
@@ -182,6 +183,18 @@ async function handleCommand(text: string, chatId: string, openId: string, msgTi
   if (text === "/cd" || text.startsWith("/cd ")) {
     const cdToken = await getTenantAccessToken();
     const currentDir = await getDefaultCwd();
+
+    // 获取当前会话的实际工作路径（若在会话群内）
+    let sessionCwd: string | undefined;
+    try {
+      const chatInfo = await getChatInfo(cdToken, chatId);
+      const sid = extractSessionId(chatInfo.description);
+      if (sid) {
+        const info = await getSessionInfo(sid);
+        sessionCwd = info?.cwd;
+      }
+    } catch { /* 非会话群或获取失败，不显示 */ }
+
     const arg = text.slice(3).trim(); // everything after "/cd" (may be empty)
 
     // Resolve target directory
@@ -234,7 +247,7 @@ async function handleCommand(text: string, chatId: string, openId: string, msgTi
       return a.name.localeCompare(b.name);
     });
 
-    const content = buildCdContent(targetDir, withStats, isUpdate);
+    const content = buildCdContent(targetDir, withStats, isUpdate, sessionCwd);
     await sendCardReply(cdToken, chatId, "新会话工作路径", content, "blue");
     return;
   }
@@ -513,9 +526,11 @@ async function main(): Promise<void> {
     console.error("  失败：无法获取 tenant_access_token。");
     console.error(`  接口: POST ${BASE_URL}/auth/v3/tenant_access_token/internal`);
     console.error("  常见原因:");
+    console.error(
+      "    - 本机网络无法访问 open.feishu.cn（可尝试：关闭系统/终端代理、检查防火墙；Windows 可管理员运行 netsh winsock reset 后重启）",
+    );
     console.error("    - App ID / App Secret 与开放平台「凭证与基础信息」不一致");
     console.error("    - 自建应用尚未创建/发布可用版本");
-    console.error("    - 本机网络无法访问 open.feishu.cn");
     console.error(`  详情: ${msg}`);
     printServiceDidNotStart("无法从飞书开放平台获取 tenant_access_token（凭证或网络问题）");
     process.exit(1);