chatccc 0.2.20 → 0.2.21

package/package.json

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

package/src/feishu-api.ts

@@ -405,6 +405,80 @@ export async function setChatAvatar(token: string, chatId: string, tool: string,
   }
 }
 
+// ---------------------------------------------------------------------------
+// Image download & cache
+// ---------------------------------------------------------------------------
+
+const IMAGE_DOWNLOAD_DIR = resolvePath(PROJECT_ROOT, "images", "downloads");
+const IMAGE_CACHE_FILE = resolvePath(PROJECT_ROOT, "state", "image-cache.json");
+
+const imageCache = new Map<string, string>();
+let imageCacheLoaded = false;
+
+async function loadImageCache(): Promise<void> {
+  if (imageCacheLoaded) return;
+  imageCacheLoaded = true;
+  try {
+    const raw = await readFile(IMAGE_CACHE_FILE, "utf-8");
+    const parsed = JSON.parse(raw) as Record<string, unknown>;
+    for (const [key, value] of Object.entries(parsed)) {
+      if (typeof value === "string" && value.trim()) imageCache.set(key, value);
+    }
+  } catch { /* missing or malformed cache is not fatal */ }
+}
+
+async function persistImageCache(): Promise<void> {
+  await mkdir(dirname(IMAGE_CACHE_FILE), { recursive: true });
+  await writeFile(
+    IMAGE_CACHE_FILE,
+    JSON.stringify(Object.fromEntries(imageCache.entries()), null, 2),
+    "utf-8",
+  );
+}
+
+function extFromContentType(contentType: string | null): string {
+  if (!contentType) return ".png";
+  const mime = contentType.split(";")[0].trim().toLowerCase();
+  const map: Record<string, string> = {
+    "image/png": ".png",
+    "image/jpeg": ".jpg",
+    "image/webp": ".webp",
+    "image/gif": ".gif",
+    "image/bmp": ".bmp",
+    "image/svg+xml": ".svg",
+  };
+  return map[mime] ?? ".png";
+}
+
+async function downloadImage(token: string, messageId: string, fileKey: string): Promise<string> {
+  const resp = await fetch(`${BASE_URL}/im/v1/messages/${messageId}/resources/${fileKey}?type=image`, {
+    headers: { Authorization: `Bearer ${token}` },
+  });
+  if (!resp.ok) {
+    const text = await resp.text().catch(() => "");
+    throw new Error(`downloadImage HTTP ${resp.status}: ${text.slice(0, 200)}`);
+  }
+  const ext = extFromContentType(resp.headers.get("content-type"));
+  const buffer = Buffer.from(await resp.arrayBuffer());
+  await mkdir(IMAGE_DOWNLOAD_DIR, { recursive: true });
+  const localPath = resolvePath(IMAGE_DOWNLOAD_DIR, `${fileKey}${ext}`);
+  await writeFile(localPath, buffer);
+  return localPath;
+}
+
+export async function getOrDownloadImage(token: string, messageId: string, fileKey: string): Promise<string> {
+  await loadImageCache();
+  const cached = imageCache.get(fileKey);
+  if (cached) return cached;
+  const localPath = await downloadImage(token, messageId, fileKey);
+  imageCache.set(fileKey, localPath);
+  await persistImageCache().catch((err) => {
+    console.error(`[${ts()}] [IMAGE] persist cache FAIL: ${(err as Error).message}`);
+  });
+  console.log(`[${ts()}] [IMAGE] Downloaded ${fileKey} -> ${localPath}`);
+  return localPath;
+}
+
 // ---------------------------------------------------------------------------
 // Messaging
 // ---------------------------------------------------------------------------

package/src/index.ts

@@ -3,7 +3,7 @@
  * =================================================================
  * Supported tools: Claude Code, Cursor, Codex (OpenAI).
  *
- * When a user sends "/new [tool]" to the bot (omitting tool uses the configured default Agent):
+ * When a user sends "/new [tool]" to the bot (omitting tool uses the configured default Agent):
  *   1. Create an AI tool session via the corresponding adapter, get session ID
  *   2. Create a new Feishu group chat and add the user
  *   3. Rename the group (name + description) to the session ID
@@ -54,12 +54,12 @@ import {
   maskAppId,
   setDefaultCwd,
   getRecentDirs,
-  addRecentDir,
-  sessionPrefixForTool,
-  resolveDefaultAgentTool,
-  toolDisplayName,
-  ts,
-} from "./config.ts";
+  addRecentDir,
+  sessionPrefixForTool,
+  resolveDefaultAgentTool,
+  toolDisplayName,
+  ts,
+} from "./config.ts";
 import { printServiceDidNotStart, printServiceRunningHint } from "./exit-banner.ts";
 import {
   addReaction,
@@ -74,6 +74,7 @@ import {
   setChatAvatar,
   updateCardMessage,
   updateChatInfo,
+  getOrDownloadImage,
   sendRestartCard,
   verifyAllPermissions,
   reportPermissionResults,
@@ -126,7 +127,7 @@ function getInnerEvent(data: Evt): InnerEvent {
  * 将飞书消息的原始 content JSON 结构转成可读文本，保留代码块等结构信息。
  * 未知类型直接返回 JSON 原文，让 AI 自行理解。
  */
-function formatMessageContent(message: { message_type?: string; content?: string }): string {
+async function formatMessageContent(message: { message_id?: string; message_type?: string; content?: string }): Promise<string> {
   const contentStr = message.content ?? "{}";
   let content: Record<string, unknown>;
   try { content = JSON.parse(contentStr); } catch { return ""; }
@@ -143,7 +144,21 @@ function formatMessageContent(message: { message_type?: string; content?: string
     return formatPostContent(content);
   }
 
-  // 其他类型（image, file, audio, media, sticker）直接给原始 JSON
+  if (message.message_type === "image") {
+    const imageKey = content.image_key as string | undefined;
+    const messageId = message.message_id;
+    if (!imageKey || !messageId) return contentStr;
+    try {
+      const token = await getTenantAccessToken();
+      const localPath = await getOrDownloadImage(token, messageId, imageKey);
+      return `[图片] ${localPath}`;
+    } catch (err) {
+      console.error(`[${ts()}] [IMAGE] download failed for ${imageKey}: ${(err as Error).message}`);
+      return `[图片: ${imageKey}]`;
+    }
+  }
+
+  // 其他类型（file, audio, media, sticker）直接给原始 JSON
   return contentStr;
 }
 
@@ -197,7 +212,7 @@ function parseCardAction(data: unknown): CardActionResult | null {
   }
   if (!cmd) return null;
 
-  const CMD_MAP: Record<string, string> = { stop: "/stop", new: "/new", "new claude": "/new claude", "new cursor": "/new cursor", "new codex": "/new codex", restart: "/restart", status: "/status", cd: "/cd", sessions: "/sessions", forget: "/forget" };
+  const CMD_MAP: Record<string, string> = { stop: "/stop", new: "/new", "new claude": "/new claude", "new cursor": "/new cursor", "new codex": "/new codex", restart: "/restart", status: "/status", cd: "/cd", sessions: "/sessions", forget: "/forget" };
   let text = CMD_MAP[cmd] ?? "";
   if (cmd === "cd" && typeof action.value === "object" && action.value !== null) {
     const path = (action.value as Record<string, string>).path;
@@ -723,8 +738,8 @@ async function startBotServiceCore(): Promise<void> {
   console.log(`${"=".repeat(60)}`);
   console.log(`  ChatCCC — Feishu Bot Bridge for Claude Code${modeTag}`);
   console.log(`${"=".repeat(60)}`);
-  console.log(`  Send "/new" to the bot to create a new group + ${toolDisplayName(resolveDefaultAgentTool())} session.`);
-  console.log(`  In a session group, send any message to resume & prompt.`);
+  console.log(`  Send "/new" to the bot to create a new group + ${toolDisplayName(resolveDefaultAgentTool())} session.`);
+  console.log(`  In a session group, send any message to resume & prompt.`);
   console.log(`${"=".repeat(60)}`);
 
   console.log(`\n[启动 4/7] 向飞书开放平台申请 tenant_access_token …`);
@@ -784,7 +799,7 @@ async function startBotServiceCore(): Promise<void> {
         }
       }
 
-      const text = formatMessageContent(message);
+      const text = await formatMessageContent(message);
       const sender = event.sender;
       const openId = sender?.sender_id?.open_id ?? "";
       const chatId = message.chat_id ?? "";
@@ -868,7 +883,7 @@ async function startBotServiceCore(): Promise<void> {
       console.log("[启动 7/7] 已连接本地中继，可接收转发事件。\n");
       printServiceRunningHint("local", `http://127.0.0.1:${CHATCCC_PORT}`);
     });
-    ws.on("message", (raw: Buffer) => {
+    ws.on("message", async (raw: Buffer) => {
       try {
         const data = JSON.parse(raw.toString()) as Evt;
         const action = parseCardAction(data);
@@ -881,7 +896,7 @@ async function startBotServiceCore(): Promise<void> {
         const event = getInnerEvent(data);
         const message = event.message;
         if (!message) return;
-        const text = formatMessageContent(message);
+        const text = await formatMessageContent(message);
         const openId = event.sender?.sender_id?.open_id ?? "";
         const chatId = message.chat_id ?? "";
         appendChatLog(chatId, openId, text);