chatccc 0.2.182 → 0.2.183

package/package.json

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

package/src/__tests__/format-message.test.ts

@@ -1,273 +1,316 @@
-import { describe, it, expect, vi, beforeEach } from "vitest";
-
-// Mock feishu-platform 以控制 API 行为
-const mockGetTenantAccessToken = vi.fn();
-const mockGetOrDownloadImage = vi.fn();
-const mockGetMergeForwardMessages = vi.fn();
-
-vi.mock("../feishu-platform.ts", () => ({
-  getTenantAccessToken: (...args: unknown[]) => mockGetTenantAccessToken(...args),
-  getOrDownloadImage: (...args: unknown[]) => mockGetOrDownloadImage(...args),
-  getMergeForwardMessages: (...args: unknown[]) => mockGetMergeForwardMessages(...args),
-}));
-
-import { formatMessageContent, formatPostContent, formatMergeForward } from "../format-message.ts";
-
-describe("formatMessageContent", () => {
-  beforeEach(() => {
-    vi.clearAllMocks();
-    mockGetTenantAccessToken.mockResolvedValue("mock_token");
-  });
-
-  it("解析文本消息", async () => {
-    const result = await formatMessageContent({
-      message_type: "text",
-      content: JSON.stringify({ text: "hello world" }),
-    });
-    expect(result).toBe("hello world");
-  });
-
-  it("去除 HTML 标签", async () => {
-    const result = await formatMessageContent({
-      message_type: "text",
-      content: JSON.stringify({ text: "<p>你好</p><br/>世界" }),
-    });
-    expect(result).toBe("你好\n世界");
-  });
-
-  it("解析 post 消息", async () => {
-    const result = await formatMessageContent({
-      message_type: "post",
-      content: JSON.stringify({
-        content: [[{ tag: "text", text: "第一条消息" }]],
-      }),
-    });
-    expect(result).toBe("第一条消息");
-  });
-
-  it("解析 post 中的代码块", async () => {
-    const result = await formatMessageContent({
-      message_type: "post",
-      content: JSON.stringify({
-        content: [[{ tag: "code_block", language: "ts", text: "const x = 1;" }]],
-      }),
-    });
-    expect(result).toBe("```ts\nconst x = 1;\n```");
-  });
-
-  it("解析 media 类型返回元数据", async () => {
-    const result = await formatMessageContent({
-      message_id: "om_test",
-      message_type: "media",
-      content: JSON.stringify({ file_key: "fk_001", file_name: "test.mp4" }),
-    });
-    expect(result).toContain("[视频]");
-    expect(result).toContain("om_test");
-    expect(result).toContain("fk_001");
-  });
-
-  it("解析 file 类型返回元数据", async () => {
-    const result = await formatMessageContent({
-      message_id: "om_test",
-      message_type: "file",
-      content: JSON.stringify({ file_key: "fk_001", file_name: "doc.pdf" }),
-    });
-    expect(result).toContain("[文件]");
-    expect(result).toContain("om_test");
-    expect(result).toContain("fk_001");
-  });
-
-  it("未知类型返回原始 JSON", async () => {
-    const result = await formatMessageContent({
-      message_type: "sticker",
-      content: JSON.stringify({ sticker_id: "stk_001" }),
-    });
-    expect(result).toBe(JSON.stringify({ sticker_id: "stk_001" }));
-  });
-
-  it("content 为空时返回空字符串", async () => {
-    const result = await formatMessageContent({
-      message_type: "text",
-    });
-    expect(result).toBe("");
-  });
-
-  it("content JSON 解析失败返回空字符串", async () => {
-    const result = await formatMessageContent({
-      message_type: "text",
-      content: "not valid json",
-    });
-    expect(result).toBe("");
-  });
-
-  it("merge_forward 的 content 为空时仍能走 API 路径", async () => {
-    mockGetMergeForwardMessages.mockResolvedValue([
-      { message_id: "om_root" },
-      {
-        message_id: "om_1",
-        msg_type: "text",
-        body: { content: JSON.stringify({ text: "hello" }) },
-        sender: { id: "ou_001" },
-        upper_message_id: "om_root",
-      },
-    ]);
-
-    const result = await formatMessageContent({
-      message_id: "om_mf",
-      message_type: "merge_forward",
-      content: "", // 空字符串
-    });
-
-    expect(result).toContain("[合并转发: 聊天记录]");
-    expect(result).toContain("hello");
-  });
-});
-
-describe("formatMergeForward", () => {
-  beforeEach(() => {
-    vi.clearAllMocks();
-    mockGetTenantAccessToken.mockResolvedValue("mock_token");
-  });
-
-  const preview = [
-    {
-      content: "第一条消息",
-      sender: { id: "ou_001", name: "张三", avatar_url: "" },
-    },
-    {
-      content: "第二条消息",
-      sender: { id: "ou_002", name: "李四", avatar_url: "" },
-    },
-  ];
-
-  it("API 成功：格式化子消息列表", async () => {
-    mockGetMergeForwardMessages.mockResolvedValue([
-      // 第一个 item: 合并转发消息自身（无 upper_message_id），会被跳过
-      { message_id: "om_root", msg_type: "merge_forward", body: { content: "{}" } },
-      {
-        message_id: "om_1",
-        msg_type: "text",
-        body: { content: JSON.stringify({ text: "你好" }) },
-        sender: { id: "ou_001" },
-        upper_message_id: "om_root",
-      },
-      {
-        message_id: "om_2",
-        msg_type: "text",
-        body: { content: JSON.stringify({ text: "在吗" }) },
-        sender: { id: "ou_002" },
-        upper_message_id: "om_root",
-      },
-    ]);
-
-    const result = await formatMergeForward("om_mf", {
-      title: "聊天记录",
-      preview,
-    });
-
-    expect(result).toContain("[合并转发: 聊天记录]");
-    expect(result).toContain("张三: 你好");
-    expect(result).toContain("李四: 在吗");
-    expect(mockGetMergeForwardMessages).toHaveBeenCalledWith("mock_token", "om_mf");
-  });
-
-  it("API 成功：跳过 merge_forward 自身 item", async () => {
-    mockGetMergeForwardMessages.mockResolvedValue([
-      { message_id: "om_root", msg_type: "merge_forward", body: { content: "{}" } },
-    ]);
-
-    const result = await formatMergeForward("om_mf", {
-      title: "空聊天记录",
-      preview: [],
-    });
-
-    // API 返回了 items 但只有根消息本身（无子消息），应该降级到 preview（也为空）
-    // → 返回原始 JSON
-    expect(result).toBe(JSON.stringify({ title: "空聊天记录", preview: [] }));
-  });
-
-  it("API 失败：降级使用 preview", async () => {
-    mockGetMergeForwardMessages.mockRejectedValue(new Error("permission denied"));
-
-    const result = await formatMergeForward("om_mf", {
-      title: "聊天记录",
-      preview,
-    });
-
-    expect(result).toContain("[合并转发: 聊天记录]");
-    expect(result).toContain("张三: 第一条消息");
-    expect(result).toContain("李四: 第二条消息");
-  });
-
-  it("API 失败 + preview 为空：返回原始 JSON", async () => {
-    mockGetMergeForwardMessages.mockRejectedValue(new Error("permission denied"));
-
-    const result = await formatMergeForward("om_mf", {
-      title: "聊天记录",
-    });
-
-    expect(result).toBe(JSON.stringify({ title: "聊天记录" }));
-  });
-
-  it("chat_name 出现在标题中", async () => {
-    mockGetMergeForwardMessages.mockRejectedValue(new Error("no permission"));
-
-    const result = await formatMergeForward("om_mf", {
-      title: "聊天记录",
-      chat_name: "技术群",
-      preview,
-    });
-
-    expect(result).toContain("[合并转发: 聊天记录 (技术群)]");
-  });
-
-  it("发送者名称从 preview 映射到 API items", async () => {
-    // API 返回的 sender 只有 id 没有 name，应该从 preview 映射名称
-    mockGetMergeForwardMessages.mockResolvedValue([
-      { message_id: "om_root" },
-      {
-        message_id: "om_1",
-        msg_type: "text",
-        body: { content: JSON.stringify({ text: "测试" }) },
-        sender: { id: "ou_001" }, // 只有 id，无 name
-        upper_message_id: "om_root",
-      },
-    ]);
-
-    const result = await formatMergeForward("om_mf", {
-      title: "测试",
-      preview: [{ content: "", sender: { id: "ou_001", name: "张三" } }],
-    });
-
-    expect(result).toContain("张三: 测试");
-  });
-
-  it("preview 发送者为空时使用默认名称", async () => {
-    mockGetMergeForwardMessages.mockRejectedValue(new Error("fail"));
-
-    const result = await formatMergeForward("om_mf", {
-      title: "测试",
-      preview: [{ content: "消息内容" }],
-    });
-
-    expect(result).toContain("未知用户: 消息内容");
-  });
-
-  it("嵌套合并转发递归深度限制", async () => {
-    // MAX_DEPTH=3，从 depth=3 开始调用应立即返回
-    const result = await formatMergeForward("om_mf", {}, 3);
-    expect(result).toBe("[合并转发: 超出最大嵌套深度 3]");
-  });
-});
-
-describe("formatPostContent", () => {
-  it("返回空段落数组时为空字符串", () => {
-    const result = formatPostContent({});
-    expect(result).toBe("");
-  });
-
-  it("跳过非数组元素", () => {
-    const result = formatPostContent({ content: [null, undefined, "string"] });
-    expect(result).toBe("");
-  });
-});
+import { describe, it, expect, vi, beforeEach } from "vitest";
+
+// Mock feishu-platform 以控制 API 行为
+const mockGetTenantAccessToken = vi.fn();
+const mockGetOrDownloadImage = vi.fn();
+const mockGetMergeForwardMessages = vi.fn();
+
+vi.mock("../feishu-platform.ts", () => ({
+  getTenantAccessToken: (...args: unknown[]) => mockGetTenantAccessToken(...args),
+  getOrDownloadImage: (...args: unknown[]) => mockGetOrDownloadImage(...args),
+  getMergeForwardMessages: (...args: unknown[]) => mockGetMergeForwardMessages(...args),
+}));
+
+import { formatMessageContent, formatPostContent, formatMergeForward } from "../format-message.ts";
+
+describe("formatMessageContent mixed post images", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+    mockGetTenantAccessToken.mockResolvedValue("mock_token");
+  });
+
+  it("includes downloaded images from mixed post messages", async () => {
+    mockGetOrDownloadImage.mockResolvedValue("C:\\tmp\\img_001.png");
+
+    const result = await formatMessageContent({
+      message_id: "om_post",
+      message_type: "post",
+      content: JSON.stringify({
+        content: [[
+          { tag: "text", text: "use this image" },
+          { tag: "img", image_key: "img_001" },
+        ]],
+      }),
+    });
+
+    expect(result).toBe("use this image\n[图片] C:\\tmp\\img_001.png");
+    expect(mockGetTenantAccessToken).toHaveBeenCalled();
+    expect(mockGetOrDownloadImage).toHaveBeenCalledWith("mock_token", "om_post", "img_001");
+  });
+
+  it("keeps post image key when mixed post image download fails", async () => {
+    mockGetOrDownloadImage.mockRejectedValue(new Error("download failed"));
+
+    const result = await formatMessageContent({
+      message_id: "om_post",
+      message_type: "post",
+      content: JSON.stringify({
+        content: [[
+          { tag: "text", text: "caption" },
+          { tag: "img", image_key: "img_002" },
+        ]],
+      }),
+    });
+
+    expect(result).toBe("caption\n[图片: img_002]");
+  });
+});
+
+describe("formatMessageContent", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+    mockGetTenantAccessToken.mockResolvedValue("mock_token");
+  });
+
+  it("解析文本消息", async () => {
+    const result = await formatMessageContent({
+      message_type: "text",
+      content: JSON.stringify({ text: "hello world" }),
+    });
+    expect(result).toBe("hello world");
+  });
+
+  it("去除 HTML 标签", async () => {
+    const result = await formatMessageContent({
+      message_type: "text",
+      content: JSON.stringify({ text: "<p>你好</p><br/>世界" }),
+    });
+    expect(result).toBe("你好\n世界");
+  });
+
+  it("解析 post 消息", async () => {
+    const result = await formatMessageContent({
+      message_type: "post",
+      content: JSON.stringify({
+        content: [[{ tag: "text", text: "第一条消息" }]],
+      }),
+    });
+    expect(result).toBe("第一条消息");
+  });
+
+  it("解析 post 中的代码块", async () => {
+    const result = await formatMessageContent({
+      message_type: "post",
+      content: JSON.stringify({
+        content: [[{ tag: "code_block", language: "ts", text: "const x = 1;" }]],
+      }),
+    });
+    expect(result).toBe("```ts\nconst x = 1;\n```");
+  });
+
+  it("解析 media 类型返回元数据", async () => {
+    const result = await formatMessageContent({
+      message_id: "om_test",
+      message_type: "media",
+      content: JSON.stringify({ file_key: "fk_001", file_name: "test.mp4" }),
+    });
+    expect(result).toContain("[视频]");
+    expect(result).toContain("om_test");
+    expect(result).toContain("fk_001");
+  });
+
+  it("解析 file 类型返回元数据", async () => {
+    const result = await formatMessageContent({
+      message_id: "om_test",
+      message_type: "file",
+      content: JSON.stringify({ file_key: "fk_001", file_name: "doc.pdf" }),
+    });
+    expect(result).toContain("[文件]");
+    expect(result).toContain("om_test");
+    expect(result).toContain("fk_001");
+  });
+
+  it("未知类型返回原始 JSON", async () => {
+    const result = await formatMessageContent({
+      message_type: "sticker",
+      content: JSON.stringify({ sticker_id: "stk_001" }),
+    });
+    expect(result).toBe(JSON.stringify({ sticker_id: "stk_001" }));
+  });
+
+  it("content 为空时返回空字符串", async () => {
+    const result = await formatMessageContent({
+      message_type: "text",
+    });
+    expect(result).toBe("");
+  });
+
+  it("content JSON 解析失败返回空字符串", async () => {
+    const result = await formatMessageContent({
+      message_type: "text",
+      content: "not valid json",
+    });
+    expect(result).toBe("");
+  });
+
+  it("merge_forward 的 content 为空时仍能走 API 路径", async () => {
+    mockGetMergeForwardMessages.mockResolvedValue([
+      { message_id: "om_root" },
+      {
+        message_id: "om_1",
+        msg_type: "text",
+        body: { content: JSON.stringify({ text: "hello" }) },
+        sender: { id: "ou_001" },
+        upper_message_id: "om_root",
+      },
+    ]);
+
+    const result = await formatMessageContent({
+      message_id: "om_mf",
+      message_type: "merge_forward",
+      content: "", // 空字符串
+    });
+
+    expect(result).toContain("[合并转发: 聊天记录]");
+    expect(result).toContain("hello");
+  });
+});
+
+describe("formatMergeForward", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+    mockGetTenantAccessToken.mockResolvedValue("mock_token");
+  });
+
+  const preview = [
+    {
+      content: "第一条消息",
+      sender: { id: "ou_001", name: "张三", avatar_url: "" },
+    },
+    {
+      content: "第二条消息",
+      sender: { id: "ou_002", name: "李四", avatar_url: "" },
+    },
+  ];
+
+  it("API 成功：格式化子消息列表", async () => {
+    mockGetMergeForwardMessages.mockResolvedValue([
+      // 第一个 item: 合并转发消息自身（无 upper_message_id），会被跳过
+      { message_id: "om_root", msg_type: "merge_forward", body: { content: "{}" } },
+      {
+        message_id: "om_1",
+        msg_type: "text",
+        body: { content: JSON.stringify({ text: "你好" }) },
+        sender: { id: "ou_001" },
+        upper_message_id: "om_root",
+      },
+      {
+        message_id: "om_2",
+        msg_type: "text",
+        body: { content: JSON.stringify({ text: "在吗" }) },
+        sender: { id: "ou_002" },
+        upper_message_id: "om_root",
+      },
+    ]);
+
+    const result = await formatMergeForward("om_mf", {
+      title: "聊天记录",
+      preview,
+    });
+
+    expect(result).toContain("[合并转发: 聊天记录]");
+    expect(result).toContain("张三: 你好");
+    expect(result).toContain("李四: 在吗");
+    expect(mockGetMergeForwardMessages).toHaveBeenCalledWith("mock_token", "om_mf");
+  });
+
+  it("API 成功：跳过 merge_forward 自身 item", async () => {
+    mockGetMergeForwardMessages.mockResolvedValue([
+      { message_id: "om_root", msg_type: "merge_forward", body: { content: "{}" } },
+    ]);
+
+    const result = await formatMergeForward("om_mf", {
+      title: "空聊天记录",
+      preview: [],
+    });
+
+    // API 返回了 items 但只有根消息本身（无子消息），应该降级到 preview（也为空）
+    // → 返回原始 JSON
+    expect(result).toBe(JSON.stringify({ title: "空聊天记录", preview: [] }));
+  });
+
+  it("API 失败：降级使用 preview", async () => {
+    mockGetMergeForwardMessages.mockRejectedValue(new Error("permission denied"));
+
+    const result = await formatMergeForward("om_mf", {
+      title: "聊天记录",
+      preview,
+    });
+
+    expect(result).toContain("[合并转发: 聊天记录]");
+    expect(result).toContain("张三: 第一条消息");
+    expect(result).toContain("李四: 第二条消息");
+  });
+
+  it("API 失败 + preview 为空：返回原始 JSON", async () => {
+    mockGetMergeForwardMessages.mockRejectedValue(new Error("permission denied"));
+
+    const result = await formatMergeForward("om_mf", {
+      title: "聊天记录",
+    });
+
+    expect(result).toBe(JSON.stringify({ title: "聊天记录" }));
+  });
+
+  it("chat_name 出现在标题中", async () => {
+    mockGetMergeForwardMessages.mockRejectedValue(new Error("no permission"));
+
+    const result = await formatMergeForward("om_mf", {
+      title: "聊天记录",
+      chat_name: "技术群",
+      preview,
+    });
+
+    expect(result).toContain("[合并转发: 聊天记录 (技术群)]");
+  });
+
+  it("发送者名称从 preview 映射到 API items", async () => {
+    // API 返回的 sender 只有 id 没有 name，应该从 preview 映射名称
+    mockGetMergeForwardMessages.mockResolvedValue([
+      { message_id: "om_root" },
+      {
+        message_id: "om_1",
+        msg_type: "text",
+        body: { content: JSON.stringify({ text: "测试" }) },
+        sender: { id: "ou_001" }, // 只有 id，无 name
+        upper_message_id: "om_root",
+      },
+    ]);
+
+    const result = await formatMergeForward("om_mf", {
+      title: "测试",
+      preview: [{ content: "", sender: { id: "ou_001", name: "张三" } }],
+    });
+
+    expect(result).toContain("张三: 测试");
+  });
+
+  it("preview 发送者为空时使用默认名称", async () => {
+    mockGetMergeForwardMessages.mockRejectedValue(new Error("fail"));
+
+    const result = await formatMergeForward("om_mf", {
+      title: "测试",
+      preview: [{ content: "消息内容" }],
+    });
+
+    expect(result).toContain("未知用户: 消息内容");
+  });
+
+  it("嵌套合并转发递归深度限制", async () => {
+    // MAX_DEPTH=3，从 depth=3 开始调用应立即返回
+    const result = await formatMergeForward("om_mf", {}, 3);
+    expect(result).toBe("[合并转发: 超出最大嵌套深度 3]");
+  });
+});
+
+describe("formatPostContent", () => {
+  it("返回空段落数组时为空字符串", () => {
+    const result = formatPostContent({});
+    expect(result).toBe("");
+  });
+
+  it("跳过非数组元素", () => {
+    const result = formatPostContent({ content: [null, undefined, "string"] });
+    expect(result).toBe("");
+  });
+});

package/src/format-message.ts

@@ -1,214 +1,293 @@
-/**
- * format-message.ts — 飞书消息内容格式化
- *
- * 从 index.ts 中提取，独立模块便于测试。
- */
-
-import { cardJsonToPlainText } from "./card-plain-text.ts";
-import { ts } from "./config.ts";
-import {
-  getTenantAccessToken,
-  getOrDownloadImage,
-  getMergeForwardMessages,
-} from "./feishu-platform.ts";
-
-/**
- * 根据消息类型格式化消息内容为可读文本。
- */
-export 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 {
-    // merge_forward 消息的 content 可能为空字符串，但可通过 message_id 调 API 获取子消息
-    if (message.message_type === "merge_forward") {
-      content = {};
-    } else {
-      return "";
-    }
-  }
-
-  if (message.message_type === "text") {
-    let text = (content.text ?? "") as string;
-    text = text.replace(/<\/?p[^>]*>/gi, "");
-    text = text.replace(/<br\s*\/?>/gi, "\n");
-    text = text.replace(/&nbsp;/gi, " ");
-    return text.trim();
-  }
-
-  if (message.message_type === "post") {
-    return formatPostContent(content);
-  }
-
-  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}]`;
-    }
-  }
-
-  if (message.message_type === "media") {
-    const fileKey = content.file_key as string | undefined;
-    const fileName = (content.file_name as string) || "video.mp4";
-    const messageId = message.message_id;
-    if (!fileKey || !messageId) return contentStr;
-    return `[视频] message_id=${messageId} file_key=${fileKey} file_name=${fileName}`;
-  }
-
-  if (message.message_type === "file") {
-    const fileKey = content.file_key as string | undefined;
-    const fileName = (content.file_name as string) || "download.bin";
-    const messageId = message.message_id;
-    if (!fileKey || !messageId) return contentStr;
-    return `[文件] message_id=${messageId} file_key=${fileKey} file_name=${fileName}`;
-  }
-
-  if (message.message_type === "interactive") {
-    const raw = JSON.stringify(content);
-    const text = cardJsonToPlainText(raw);
-    if (text) return `[卡片] ${text}`;
-    return contentStr;
-  }
-
-  if (message.message_type === "merge_forward") {
-    return formatMergeForward(message.message_id ?? "", content);
-  }
-
-  // 其他类型（audio, sticker 等）直接给原始 JSON
-  return contentStr;
-}
-
-export function formatPostContent(content: Record<string, unknown>): string {
-  const paragraphs = content.content as unknown[][];
-  if (!Array.isArray(paragraphs)) return "";
-
-  const parts: string[] = [];
-  for (const line of paragraphs) {
-    if (!Array.isArray(line)) continue;
-    for (const elem of line) {
-      const el = elem as Record<string, unknown>;
-      if (!el || typeof el !== "object") continue;
-      const t = typeof el.text === "string" ? el.text : "";
-
-      if (el.tag === "code_block") {
-        const lang = typeof el.language === "string" ? el.language : "";
-        parts.push("```" + lang + "\n" + t + "\n```");
-      } else if (el.tag === "p" || el.tag === "text") {
-        if (t) parts.push(t);
-      }
-    }
-  }
-  return parts.join("\n").trim();
-}
-
-// ---------------------------------------------------------------------------
-// 合并转发消息格式化
-// ---------------------------------------------------------------------------
-
-/**
- * 格式化合并转发消息。
- *
- * 三阶段降级策略：
- * 1. 调用 GET /im/v1/messages/{messageId} 获取完整子消息列表
- * 2. API 失败时降级使用 content.preview 字段
- * 3. preview 也为空时返回原始 JSON
- *
- * 递归深度限制 MAX_DEPTH=3，避免嵌套合并转发 API 爆炸。
- */
-export async function formatMergeForward(
-  messageId: string,
-  content: Record<string, unknown>,
-  depth: number = 0,
-): Promise<string> {
-  const MAX_DEPTH = 3;
-  if (depth >= MAX_DEPTH) {
-    return `[合并转发: 超出最大嵌套深度 ${MAX_DEPTH}]`;
-  }
-
-  const title = (content.title as string) || "聊天记录";
-  const chatName = (content.chat_name as string) || "";
-  const header = `[合并转发: ${title}${chatName ? ` (${chatName})` : ""}]`;
-
-  // 从 preview 构建 sender ID → name 映射表
-  const senderNameMap = new Map<string, string>();
-  const preview = content.preview;
-  if (Array.isArray(preview)) {
-    for (const entry of preview) {
-      const e = entry as Record<string, unknown>;
-      const s = e.sender as Record<string, unknown> | undefined;
-      if (s && typeof s.id === "string" && typeof s.name === "string") {
-        senderNameMap.set(s.id, s.name);
-      }
-    }
-  }
-
-  const lines: string[] = [];
-  let usedApi = false;
-
-  // Phase 1: 尝试通过 API 获取完整子消息列表
-  try {
-    const token = await getTenantAccessToken();
-    const items = await getMergeForwardMessages(token, messageId);
-
-    // 跳过第一个 item（合并转发消息自身，无 upper_message_id）
-    const subItems = items.filter((item) => item.upper_message_id);
-
-    if (subItems.length > 0) {
-      for (const item of subItems) {
-        const senderId = item.sender?.id ?? "unknown";
-        const senderName = senderNameMap.get(senderId) ?? senderId;
-
-        const subMsgType = item.msg_type ?? "";
-        const subContent = item.body?.content ?? "{}";
-
-        try {
-          const formatted = await formatMessageContent({
-            message_id: item.message_id,
-            message_type: subMsgType,
-            content: subContent,
-          });
-          lines.push(`${senderName}: ${formatted}`);
-        } catch {
-          lines.push(`${senderName}: ${subContent}`);
-        }
-      }
-      usedApi = true;
-    }
-  } catch (err) {
-    console.error(
-      `[${ts()}] [MERGE_FORWARD] API 获取子消息失败 (${messageId}), 降级使用 preview: ${(err as Error).message}`,
-    );
-  }
-
-  // Phase 2: API 失败或返回空时降级使用 preview
-  if (!usedApi) {
-    if (Array.isArray(preview) && preview.length > 0) {
-      for (const entry of preview) {
-        const e = entry as Record<string, unknown>;
-        const s = e.sender as Record<string, unknown> | undefined;
-        const senderName = (s?.name as string) ?? "未知用户";
-        const text = (e.content as string) ?? "";
-        lines.push(`${senderName}: ${text}`);
-      }
-    }
-  }
-
-  // Phase 3: 没有任何内容时返回原始 JSON
-  if (lines.length === 0) {
-    return JSON.stringify(content);
-  }
-
-  return header + "\n" + lines.join("\n");
-}
+/**
+ * format-message.ts — 飞书消息内容格式化
+ *
+ * 从 index.ts 中提取，独立模块便于测试。
+ */
+
+import { cardJsonToPlainText } from "./card-plain-text.ts";
+import { ts } from "./config.ts";
+import {
+  getTenantAccessToken,
+  getOrDownloadImage,
+  getMergeForwardMessages,
+} from "./feishu-platform.ts";
+
+/**
+ * 根据消息类型格式化消息内容为可读文本。
+ */
+export 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 {
+    // merge_forward 消息的 content 可能为空字符串，但可通过 message_id 调 API 获取子消息
+    if (message.message_type === "merge_forward") {
+      content = {};
+    } else {
+      return "";
+    }
+  }
+
+  if (message.message_type === "text") {
+    let text = (content.text ?? "") as string;
+    text = text.replace(/<\/?p[^>]*>/gi, "");
+    text = text.replace(/<br\s*\/?>/gi, "\n");
+    text = text.replace(/&nbsp;/gi, " ");
+    return text.trim();
+  }
+
+  if (message.message_type === "post") {
+    return formatPostContentWithImages(content, message.message_id);
+  }
+
+  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}]`;
+    }
+  }
+
+  if (message.message_type === "media") {
+    const fileKey = content.file_key as string | undefined;
+    const fileName = (content.file_name as string) || "video.mp4";
+    const messageId = message.message_id;
+    if (!fileKey || !messageId) return contentStr;
+    return `[视频] message_id=${messageId} file_key=${fileKey} file_name=${fileName}`;
+  }
+
+  if (message.message_type === "file") {
+    const fileKey = content.file_key as string | undefined;
+    const fileName = (content.file_name as string) || "download.bin";
+    const messageId = message.message_id;
+    if (!fileKey || !messageId) return contentStr;
+    return `[文件] message_id=${messageId} file_key=${fileKey} file_name=${fileName}`;
+  }
+
+  if (message.message_type === "interactive") {
+    const raw = JSON.stringify(content);
+    const text = cardJsonToPlainText(raw);
+    if (text) return `[卡片] ${text}`;
+    return contentStr;
+  }
+
+  if (message.message_type === "merge_forward") {
+    return formatMergeForward(message.message_id ?? "", content);
+  }
+
+  // 其他类型（audio, sticker 等）直接给原始 JSON
+  return contentStr;
+}
+
+export function formatPostContent(content: Record<string, unknown>): string {
+  const paragraphs = getPostParagraphs(content);
+  if (!Array.isArray(paragraphs)) return "";
+
+  const parts: string[] = [];
+  for (const line of paragraphs) {
+    if (!Array.isArray(line)) continue;
+    for (const elem of line) {
+      const el = elem as Record<string, unknown>;
+      if (!el || typeof el !== "object") continue;
+      const text = formatPostTextElement(el);
+      if (text) parts.push(text);
+    }
+  }
+  return parts.join("\n").trim();
+}
+
+function getPostParagraphs(content: Record<string, unknown>): unknown[][] {
+  const direct = content.content;
+  if (Array.isArray(direct)) return direct as unknown[][];
+
+  for (const locale of ["zh_cn", "en_us", "ja_jp"]) {
+    const localized = content[locale] as Record<string, unknown> | undefined;
+    if (localized && Array.isArray(localized.content)) {
+      return localized.content as unknown[][];
+    }
+  }
+
+  return [];
+}
+
+function formatPostTextElement(el: Record<string, unknown>): string {
+  const t = typeof el.text === "string" ? el.text : "";
+
+  if (el.tag === "code_block") {
+    const lang = typeof el.language === "string" ? el.language : "";
+    return "```" + lang + "\n" + t + "\n```";
+  }
+
+  if (el.tag === "p" || el.tag === "text") {
+    return t;
+  }
+
+  return "";
+}
+
+function getPostImageKey(el: Record<string, unknown>): string | undefined {
+  const imageKey = el.image_key;
+  if (typeof imageKey === "string" && imageKey.trim()) return imageKey;
+
+  if (el.tag === "img") {
+    const fileKey = el.file_key;
+    if (typeof fileKey === "string" && fileKey.trim()) return fileKey;
+  }
+
+  return undefined;
+}
+
+async function formatPostContentWithImages(
+  content: Record<string, unknown>,
+  messageId?: string,
+): Promise<string> {
+  const paragraphs = getPostParagraphs(content);
+  if (!Array.isArray(paragraphs)) return "";
+
+  const parts: string[] = [];
+  for (const line of paragraphs) {
+    if (!Array.isArray(line)) continue;
+    for (const elem of line) {
+      const el = elem as Record<string, unknown>;
+      if (!el || typeof el !== "object") continue;
+
+      const text = formatPostTextElement(el);
+      if (text) parts.push(text);
+
+      const imageKey = getPostImageKey(el);
+      if (imageKey) {
+        parts.push(await formatPostImageElement(messageId, imageKey));
+      }
+    }
+  }
+  return parts.join("\n").trim();
+}
+
+async function formatPostImageElement(
+  messageId: string | undefined,
+  imageKey: string,
+): Promise<string> {
+  if (!messageId) return `[图片: ${imageKey}]`;
+
+  try {
+    const token = await getTenantAccessToken();
+    const localPath = await getOrDownloadImage(token, messageId, imageKey);
+    return `[图片] ${localPath}`;
+  } catch (err) {
+    console.error(
+      `[${ts()}] [IMAGE] download failed for post image ${imageKey}: ${(err as Error).message}`,
+    );
+    return `[图片: ${imageKey}]`;
+  }
+}
+
+// ---------------------------------------------------------------------------
+// 合并转发消息格式化
+// ---------------------------------------------------------------------------
+
+/**
+ * 格式化合并转发消息。
+ *
+ * 三阶段降级策略：
+ * 1. 调用 GET /im/v1/messages/{messageId} 获取完整子消息列表
+ * 2. API 失败时降级使用 content.preview 字段
+ * 3. preview 也为空时返回原始 JSON
+ *
+ * 递归深度限制 MAX_DEPTH=3，避免嵌套合并转发 API 爆炸。
+ */
+export async function formatMergeForward(
+  messageId: string,
+  content: Record<string, unknown>,
+  depth: number = 0,
+): Promise<string> {
+  const MAX_DEPTH = 3;
+  if (depth >= MAX_DEPTH) {
+    return `[合并转发: 超出最大嵌套深度 ${MAX_DEPTH}]`;
+  }
+
+  const title = (content.title as string) || "聊天记录";
+  const chatName = (content.chat_name as string) || "";
+  const header = `[合并转发: ${title}${chatName ? ` (${chatName})` : ""}]`;
+
+  // 从 preview 构建 sender ID → name 映射表
+  const senderNameMap = new Map<string, string>();
+  const preview = content.preview;
+  if (Array.isArray(preview)) {
+    for (const entry of preview) {
+      const e = entry as Record<string, unknown>;
+      const s = e.sender as Record<string, unknown> | undefined;
+      if (s && typeof s.id === "string" && typeof s.name === "string") {
+        senderNameMap.set(s.id, s.name);
+      }
+    }
+  }
+
+  const lines: string[] = [];
+  let usedApi = false;
+
+  // Phase 1: 尝试通过 API 获取完整子消息列表
+  try {
+    const token = await getTenantAccessToken();
+    const items = await getMergeForwardMessages(token, messageId);
+
+    // 跳过第一个 item（合并转发消息自身，无 upper_message_id）
+    const subItems = items.filter((item) => item.upper_message_id);
+
+    if (subItems.length > 0) {
+      for (const item of subItems) {
+        const senderId = item.sender?.id ?? "unknown";
+        const senderName = senderNameMap.get(senderId) ?? senderId;
+
+        const subMsgType = item.msg_type ?? "";
+        const subContent = item.body?.content ?? "{}";
+
+        try {
+          const formatted = await formatMessageContent({
+            message_id: item.message_id,
+            message_type: subMsgType,
+            content: subContent,
+          });
+          lines.push(`${senderName}: ${formatted}`);
+        } catch {
+          lines.push(`${senderName}: ${subContent}`);
+        }
+      }
+      usedApi = true;
+    }
+  } catch (err) {
+    console.error(
+      `[${ts()}] [MERGE_FORWARD] API 获取子消息失败 (${messageId}), 降级使用 preview: ${(err as Error).message}`,
+    );
+  }
+
+  // Phase 2: API 失败或返回空时降级使用 preview
+  if (!usedApi) {
+    if (Array.isArray(preview) && preview.length > 0) {
+      for (const entry of preview) {
+        const e = entry as Record<string, unknown>;
+        const s = e.sender as Record<string, unknown> | undefined;
+        const senderName = (s?.name as string) ?? "未知用户";
+        const text = (e.content as string) ?? "";
+        lines.push(`${senderName}: ${text}`);
+      }
+    }
+  }
+
+  // Phase 3: 没有任何内容时返回原始 JSON
+  if (lines.length === 0) {
+    return JSON.stringify(content);
+  }
+
+  return header + "\n" + lines.join("\n");
+}