chatccc 0.1.6 → 0.2.0

package/README.md

@@ -96,25 +96,23 @@ cp .env.example .env
 编辑 `.env`，填入上一步拿到的凭证：
 
 ```env
-FEISHU_CLAUDER_APP_ID=cli_xxxxxxxxxxxx
-FEISHU_CLAUDER_APP_SECRET=xxxxxxxxxxxxxxxxxxxxxxxxxx
+CHATCCC_APP_ID=cli_xxxxxxxxxxxx
+CHATCCC_APP_SECRET=xxxxxxxxxxxxxxxxxxxxxxxxxx
 ```
 
-可选的高级配置：
+若你曾使用旧版变量名 `FEISHU_CLAUDER_APP_ID` / `FEISHU_CLAUDER_APP_SECRET`，请改为上表中的 `CHATCCC_APP_ID` / `CHATCCC_APP_SECRET`。
+
+可选：Claude 模型与思考深度（**默认均为 `default`**）：
 
 ```env
-# Claude 模型（见下方优先级说明）
-CHATCCC_ANTHROPIC_MODEL=dashscope/deepseek-v4-pro-anthropic
+# 网关或服务商文档中的 model；设为 default（任意大小写）或不写则交给 SDK/CLI 默认，且 /status 中显示为 default
+CHATCCC_ANTHROPIC_MODEL=default
 
-# 思考深度，可选值: low | medium | high | max
-CHATCCC_ANTHROPIC_EFFORT=max
+# 如 low / medium / high / max；设为 default（任意大小写）或不写则不向 SDK 传入 effort，/status 显示 default
+CHATCCC_ANTHROPIC_EFFORT=default
 ```
 
-`**CHATCCC_ANTHROPIC_MODEL` 优先级**：环境变量设置的值 > 代码内默认值 `dashscope/deepseek-v4-pro-anthropic`。不设或设为空白时自动使用默认模型。
-
-`**CHATCCC_ANTHROPIC_EFFORT` 优先级**：环境变量设置的值 > 代码内默认值 `max`。
-
-`**CHATCCC_PORT` 端口配置**：默认端口为 `18080`。如果你需要在一台机器上同时运行多个 ChatCCC 实例（例如用不同飞书应用分别接入不同项目），可以在各自的 `.env` 中设置不同的端口：
+`**CHATCCC_PORT`（可选）**：默认端口为 `18080`。若在一台机器上同时运行多个 ChatCCC 实例，可在各自的 `.env` 中设置不同端口：
 
 ```env
 # 实例 A（项目1）的 .env

package/bin/chatccc.mjs

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import { spawnSync } from "node:child_process";
+import { existsSync } from "node:fs";
 import { createRequire } from "node:module";
 import { dirname, join } from "node:path";
 
@@ -9,10 +10,27 @@ 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 }
-);
+// 与 npm run dev 一致：当前工作目录下的 .env 会被加载（全局安装时 cwd 一般为你的项目根）
+const envFile = join(process.cwd(), ".env");
+if (!existsSync(envFile)) {
+  console.error(`[chatccc] 当前目录下未找到 .env，不会自动加载环境变量： ${envFile}`);
+  console.error("  将只使用系统/用户环境变量。若未设置 CHATCCC_APP_ID / CHATCCC_APP_SECRET，启动会失败。");
+  console.error("  建议: cd 到项目根目录，复制 .env.example 为 .env 并填写后再运行 chatccc。\n");
+}
+const tsxArgs = existsSync(envFile)
+  ? [tsxCli, "--env-file", envFile, indexTs, ...process.argv.slice(2)]
+  : [tsxCli, indexTs, ...process.argv.slice(2)];
 
-process.exit(result.status === null ? 1 : result.status);
+const result = spawnSync(process.execPath, tsxArgs, {
+  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/package.json

@@ -1,7 +1,8 @@
 {
   "name": "chatccc",
-  "version": "0.1.6",
+  "version": "0.2.0",
   "description": "Feishu bot bridge for Claude Code",
+  "license": "Apache-2.0",
   "type": "module",
   "main": "./src/index.ts",
   "bin": {

package/src/cardkit.ts

@@ -1,158 +1,158 @@
-import { BASE_URL, fileLog, ts } from "./config.ts";
-
-// CardKit 是飞书的卡片流式更新 API，通过 cardElement.content 端点
-// 对卡片上指定 element_id 的元素进行增量内容更新，实现打字机效果。
-// 与普通卡片 PATCH 的区别：PATCH 是全量替换卡片 JSON，CardKit 是
-// 由飞书客户端自行渲染增量文本，用户看到的是逐字出现的效果。
-// 参考: https://open.feishu.cn/document/uYjLw4iNukDO6YDN4ITM4MjM
-
-export async function createCardKitCard(token: string, cardJson: string): Promise<string> {
-  const body = JSON.stringify({ type: "card_json", data: cardJson });
-  const resp = await fetch(`${BASE_URL}/cardkit/v1/cards`, {
-    method: "POST",
-    headers: {
-      Authorization: `Bearer ${token}`,
-      "Content-Type": "application/json",
-    },
-    body,
-  });
-  const respText = await resp.text();
-  let data: { code: number; msg?: string; data?: { card_id?: string } };
-  try {
-    data = JSON.parse(respText);
-  } catch {
-    console.error(`[${ts()}] [CARDIKT] createCard: invalid JSON response (status=${resp.status}) body=${respText.slice(0, 500)}`);
-    fileLog.flush();
-    throw new Error(`CardKit create: invalid JSON response (status=${resp.status})`);
-  }
-  if (data.code !== 0) {
-    console.error(`[${ts()}] [CARDIKT] createCard FAIL: status=${resp.status} code=${data.code} msg="${data.msg}" body=${respText.slice(0, 500)}`);
-    fileLog.flush();
-    throw new Error(`CardKit create: [${data.code}] ${data.msg}`);
-  }
-  console.log(`[${ts()}] [CARDIKT] createCard OK cardId=${data.data?.card_id ?? "(none)"}`);
-  return data.data?.card_id ?? "";
-}
-
-export async function setCardKitSettings(
-  token: string,
-  cardId: string,
-  settings: Record<string, unknown>,
-  sequence: number
-): Promise<void> {
-  const resp = await fetch(`${BASE_URL}/cardkit/v1/cards/${cardId}/settings`, {
-    method: "PATCH",
-    headers: {
-      Authorization: `Bearer ${token}`,
-      "Content-Type": "application/json",
-    },
-    body: JSON.stringify({ settings: JSON.stringify(settings), sequence }),
-  });
-  const respText = await resp.text();
-  let data: { code: number; msg?: string };
-  try { data = JSON.parse(respText); } catch {
-    console.error(`[${ts()}] [CARDIKT] settings FAIL: invalid JSON cardId=${cardId} seq=${sequence} status=${resp.status}`);
-    fileLog.flush();
-    throw new Error(`CardKit settings: invalid JSON (status=${resp.status})`);
-  }
-  if (data.code !== 0) {
-    console.error(`[${ts()}] [CARDIKT] settings FAIL: cardId=${cardId} seq=${sequence} status=${resp.status} code=${data.code} msg="${data.msg}"`);
-    fileLog.flush();
-    throw new Error(`CardKit settings: [${data.code}] ${data.msg}`);
-  }
-  console.log(`[${ts()}] [CARDIKT] settings OK cardId=${cardId} seq=${sequence}`);
-}
-
-export async function streamCardKitElement(
-  token: string,
-  cardId: string,
-  elementId: string,
-  content: string,
-  sequence: number
-): Promise<void> {
-  const resp = await fetch(
-    `${BASE_URL}/cardkit/v1/cards/${cardId}/elements/${elementId}/content`,
-    {
-      method: "PUT",
-      headers: {
-        Authorization: `Bearer ${token}`,
-        "Content-Type": "application/json",
-      },
-      body: JSON.stringify({ content, sequence }),
-    }
-  );
-  const respText = await resp.text();
-  let data: { code: number; msg?: string };
-  try { data = JSON.parse(respText); } catch {
-    console.error(`[${ts()}] [CARDIKT] streamElement FAIL: invalid JSON cardId=${cardId} element=${elementId} seq=${sequence} status=${resp.status}`);
-    fileLog.flush();
-    throw new Error(`CardKit stream: invalid JSON (status=${resp.status})`);
-  }
-  if (data.code !== 0) {
-    console.error(`[${ts()}] [CARDIKT] streamElement FAIL: cardId=${cardId} element=${elementId} seq=${sequence} status=${resp.status} code=${data.code} msg="${data.msg}"`);
-    fileLog.flush();
-    throw new Error(`CardKit stream: [${data.code}] ${data.msg}`);
-  }
-  // success log is intentionally sparse — uncomment to debug streaming throughput
-  // console.log(`[${ts()}] [CARDIKT] streamElement OK cardId=${cardId} seq=${sequence}`);
-}
-
-export async function updateCardKitCard(
-  token: string,
-  cardId: string,
-  cardJson: string,
-  sequence: number
-): Promise<void> {
-  const resp = await fetch(`${BASE_URL}/cardkit/v1/cards/${cardId}`, {
-    method: "PUT",
-    headers: {
-      Authorization: `Bearer ${token}`,
-      "Content-Type": "application/json",
-    },
-    body: JSON.stringify({ card: { type: "card_json", data: cardJson }, sequence }),
-  });
-  const respText = await resp.text();
-  let data: { code: number; msg?: string };
-  try { data = JSON.parse(respText); } catch {
-    console.error(`[${ts()}] [CARDIKT] updateCard FAIL: invalid JSON cardId=${cardId} seq=${sequence} status=${resp.status}`);
-    fileLog.flush();
-    throw new Error(`CardKit update: invalid JSON (status=${resp.status})`);
-  }
-  if (data.code !== 0) {
-    console.error(`[${ts()}] [CARDIKT] updateCard FAIL: cardId=${cardId} seq=${sequence} status=${resp.status} code=${data.code} msg="${data.msg}"`);
-    fileLog.flush();
-    throw new Error(`CardKit update: [${data.code}] ${data.msg}`);
-  }
-  console.log(`[${ts()}] [CARDIKT] updateCard OK cardId=${cardId} seq=${sequence}`);
-}
-
-export async function sendCardKitMessage(
-  token: string,
-  chatId: string,
-  cardId: string
-): Promise<string> {
-  const payload = { receive_id: chatId, msg_type: "interactive", content: JSON.stringify({ type: "card", data: { card_id: cardId } }) };
-  const url = `${BASE_URL}/im/v1/messages?receive_id_type=chat_id`;
-  const resp = await fetch(url, {
-    method: "POST",
-    headers: {
-      Authorization: `Bearer ${token}`,
-      "Content-Type": "application/json",
-    },
-    body: JSON.stringify(payload),
-  });
-  const respText = await resp.text();
-  let data: { code: number; msg?: string; data?: { message_id?: string } };
-  try { data = JSON.parse(respText); } catch {
-    console.error(`[${ts()}] [CARDIKT] sendMessage FAIL: invalid JSON cardId=${cardId} chatId=${chatId} status=${resp.status}`);
-    fileLog.flush();
-    throw new Error(`sendCardKitMessage: invalid JSON (status=${resp.status})`);
-  }
-  if (data.code !== 0) {
-    console.error(`[${ts()}] [CARDIKT] sendMessage FAIL: status=${resp.status} code=${data.code} msg="${data.msg}" cardId=${cardId} chatId=${chatId}`);
-    fileLog.flush();
-    throw new Error(`[${data.code}] ${data.msg}`);
-  }
-  console.log(`[${ts()}] [CARDIKT] sendMessage OK cardId=${cardId} chatId=${chatId} msgId=${data.data?.message_id ?? "(none)"}`);
-  return data.data?.message_id ?? "";
+import { BASE_URL, fileLog, ts } from "./config.ts";
+
+// CardKit 是飞书的卡片流式更新 API，通过 cardElement.content 端点
+// 对卡片上指定 element_id 的元素进行增量内容更新，实现打字机效果。
+// 与普通卡片 PATCH 的区别：PATCH 是全量替换卡片 JSON，CardKit 是
+// 由飞书客户端自行渲染增量文本，用户看到的是逐字出现的效果。
+// 参考: https://open.feishu.cn/document/uYjLw4iNukDO6YDN4ITM4MjM
+
+export async function createCardKitCard(token: string, cardJson: string): Promise<string> {
+  const body = JSON.stringify({ type: "card_json", data: cardJson });
+  const resp = await fetch(`${BASE_URL}/cardkit/v1/cards`, {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${token}`,
+      "Content-Type": "application/json",
+    },
+    body,
+  });
+  const respText = await resp.text();
+  let data: { code: number; msg?: string; data?: { card_id?: string } };
+  try {
+    data = JSON.parse(respText);
+  } catch {
+    console.error(`[${ts()}] [CARDIKT] createCard: invalid JSON response (status=${resp.status}) body=${respText.slice(0, 500)}`);
+    fileLog.flush();
+    throw new Error(`CardKit create: invalid JSON response (status=${resp.status})`);
+  }
+  if (data.code !== 0) {
+    console.error(`[${ts()}] [CARDIKT] createCard FAIL: status=${resp.status} code=${data.code} msg="${data.msg}" body=${respText.slice(0, 500)}`);
+    fileLog.flush();
+    throw new Error(`CardKit create: [${data.code}] ${data.msg}`);
+  }
+  console.log(`[${ts()}] [CARDIKT] createCard OK cardId=${data.data?.card_id ?? "(none)"}`);
+  return data.data?.card_id ?? "";
+}
+
+export async function setCardKitSettings(
+  token: string,
+  cardId: string,
+  settings: Record<string, unknown>,
+  sequence: number
+): Promise<void> {
+  const resp = await fetch(`${BASE_URL}/cardkit/v1/cards/${cardId}/settings`, {
+    method: "PATCH",
+    headers: {
+      Authorization: `Bearer ${token}`,
+      "Content-Type": "application/json",
+    },
+    body: JSON.stringify({ settings: JSON.stringify(settings), sequence }),
+  });
+  const respText = await resp.text();
+  let data: { code: number; msg?: string };
+  try { data = JSON.parse(respText); } catch {
+    console.error(`[${ts()}] [CARDIKT] settings FAIL: invalid JSON cardId=${cardId} seq=${sequence} status=${resp.status}`);
+    fileLog.flush();
+    throw new Error(`CardKit settings: invalid JSON (status=${resp.status})`);
+  }
+  if (data.code !== 0) {
+    console.error(`[${ts()}] [CARDIKT] settings FAIL: cardId=${cardId} seq=${sequence} status=${resp.status} code=${data.code} msg="${data.msg}"`);
+    fileLog.flush();
+    throw new Error(`CardKit settings: [${data.code}] ${data.msg}`);
+  }
+  console.log(`[${ts()}] [CARDIKT] settings OK cardId=${cardId} seq=${sequence}`);
+}
+
+export async function streamCardKitElement(
+  token: string,
+  cardId: string,
+  elementId: string,
+  content: string,
+  sequence: number
+): Promise<void> {
+  const resp = await fetch(
+    `${BASE_URL}/cardkit/v1/cards/${cardId}/elements/${elementId}/content`,
+    {
+      method: "PUT",
+      headers: {
+        Authorization: `Bearer ${token}`,
+        "Content-Type": "application/json",
+      },
+      body: JSON.stringify({ content, sequence }),
+    }
+  );
+  const respText = await resp.text();
+  let data: { code: number; msg?: string };
+  try { data = JSON.parse(respText); } catch {
+    console.error(`[${ts()}] [CARDIKT] streamElement FAIL: invalid JSON cardId=${cardId} element=${elementId} seq=${sequence} status=${resp.status}`);
+    fileLog.flush();
+    throw new Error(`CardKit stream: invalid JSON (status=${resp.status})`);
+  }
+  if (data.code !== 0) {
+    console.error(`[${ts()}] [CARDIKT] streamElement FAIL: cardId=${cardId} element=${elementId} seq=${sequence} status=${resp.status} code=${data.code} msg="${data.msg}"`);
+    fileLog.flush();
+    throw new Error(`CardKit stream: [${data.code}] ${data.msg}`);
+  }
+  // success log is intentionally sparse — uncomment to debug streaming throughput
+  // console.log(`[${ts()}] [CARDIKT] streamElement OK cardId=${cardId} seq=${sequence}`);
+}
+
+export async function updateCardKitCard(
+  token: string,
+  cardId: string,
+  cardJson: string,
+  sequence: number
+): Promise<void> {
+  const resp = await fetch(`${BASE_URL}/cardkit/v1/cards/${cardId}`, {
+    method: "PUT",
+    headers: {
+      Authorization: `Bearer ${token}`,
+      "Content-Type": "application/json",
+    },
+    body: JSON.stringify({ card: { type: "card_json", data: cardJson }, sequence }),
+  });
+  const respText = await resp.text();
+  let data: { code: number; msg?: string };
+  try { data = JSON.parse(respText); } catch {
+    console.error(`[${ts()}] [CARDIKT] updateCard FAIL: invalid JSON cardId=${cardId} seq=${sequence} status=${resp.status}`);
+    fileLog.flush();
+    throw new Error(`CardKit update: invalid JSON (status=${resp.status})`);
+  }
+  if (data.code !== 0) {
+    console.error(`[${ts()}] [CARDIKT] updateCard FAIL: cardId=${cardId} seq=${sequence} status=${resp.status} code=${data.code} msg="${data.msg}"`);
+    fileLog.flush();
+    throw new Error(`CardKit update: [${data.code}] ${data.msg}`);
+  }
+  console.log(`[${ts()}] [CARDIKT] updateCard OK cardId=${cardId} seq=${sequence}`);
+}
+
+export async function sendCardKitMessage(
+  token: string,
+  chatId: string,
+  cardId: string
+): Promise<string> {
+  const payload = { receive_id: chatId, msg_type: "interactive", content: JSON.stringify({ type: "card", data: { card_id: cardId } }) };
+  const url = `${BASE_URL}/im/v1/messages?receive_id_type=chat_id`;
+  const resp = await fetch(url, {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${token}`,
+      "Content-Type": "application/json",
+    },
+    body: JSON.stringify(payload),
+  });
+  const respText = await resp.text();
+  let data: { code: number; msg?: string; data?: { message_id?: string } };
+  try { data = JSON.parse(respText); } catch {
+    console.error(`[${ts()}] [CARDIKT] sendMessage FAIL: invalid JSON cardId=${cardId} chatId=${chatId} status=${resp.status}`);
+    fileLog.flush();
+    throw new Error(`sendCardKitMessage: invalid JSON (status=${resp.status})`);
+  }
+  if (data.code !== 0) {
+    console.error(`[${ts()}] [CARDIKT] sendMessage FAIL: status=${resp.status} code=${data.code} msg="${data.msg}" cardId=${cardId} chatId=${chatId}`);
+    fileLog.flush();
+    throw new Error(`[${data.code}] ${data.msg}`);
+  }
+  console.log(`[${ts()}] [CARDIKT] sendMessage OK cardId=${cardId} chatId=${chatId} msgId=${data.data?.message_id ?? "(none)"}`);
+  return data.data?.message_id ?? "";
 }