chatccc 0.2.251 → 0.2.253

package/src/feishu-message-ingress.ts

@@ -1,195 +0,0 @@
-import { homedir } from "node:os";
-import { dirname, join } from "node:path";
-import { mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
-
-export const MAX_PROCESSED = 5000;
-
-export type FeishuMessageDisposition = "accepted" | "duplicate" | "stale";
-
-export interface FeishuMessageIdentity {
-  messageId?: string;
-  chatId: string;
-  createTime: number;
-}
-
-interface PersistedMessageEntry {
-  messageId: string;
-  chatId: string;
-  createTime: number;
-}
-
-interface PersistedMessageLedger {
-  version: 1;
-  entries: PersistedMessageEntry[];
-}
-
-type ScheduleTask = (task: () => void) => void;
-
-const defaultSchedule: ScheduleTask = (task) => {
-  setImmediate(task);
-};
-
-/**
- * The Feishu SDK waits for an event handler's return value before sending its
- * WebSocket response. Schedule the real work for the next event-loop turn so
- * the SDK callback can return and acknowledge the event immediately.
- */
-export function createAckFirstEventHandler<T>(
-  worker: (data: T) => Promise<void>,
-  onError: (error: unknown) => void,
-  schedule: ScheduleTask = defaultSchedule,
-): (data: T) => Promise<void> {
-  return async (data) => {
-    schedule(() => {
-      void worker(data).catch(onError);
-    });
-  };
-}
-
-function isPersistedEntry(value: unknown): value is PersistedMessageEntry {
-  if (!value || typeof value !== "object") return false;
-  const entry = value as Record<string, unknown>;
-  return typeof entry.messageId === "string"
-    && entry.messageId.length > 0
-    && typeof entry.chatId === "string"
-    && typeof entry.createTime === "number"
-    && Number.isFinite(entry.createTime);
-}
-
-export class FeishuMessageLedger {
-  private readonly messageIds: Set<string>;
-  private entries: PersistedMessageEntry[] = [];
-  private latestCreateTimeByChat = new Map<string, number>();
-  private persistTail: Promise<void> = Promise.resolve();
-
-  constructor(
-    public readonly filePath: string,
-    private readonly maxEntries = MAX_PROCESSED,
-    messageIds?: Set<string>,
-  ) {
-    this.messageIds = messageIds ?? new Set<string>();
-  }
-
-  async load(): Promise<void> {
-    this.clearMemory();
-
-    try {
-      const raw = await readFile(this.filePath, "utf-8");
-      const parsed = JSON.parse(raw) as Partial<PersistedMessageLedger>;
-      const entries = Array.isArray(parsed.entries)
-        ? parsed.entries.filter(isPersistedEntry)
-        : [];
-      this.entries = entries.slice(-this.maxEntries);
-      this.rebuildIndexes();
-
-      if (entries.length > this.maxEntries) {
-        await this.persist();
-      }
-    } catch (error) {
-      if ((error as NodeJS.ErrnoException).code !== "ENOENT") {
-        console.error(
-          `[FEISHU-DEDUP] Failed to load ${this.filePath}: ${(error as Error).message}`,
-        );
-      }
-    }
-  }
-
-  async accept(identity: FeishuMessageIdentity): Promise<FeishuMessageDisposition> {
-    const { messageId, chatId, createTime } = identity;
-
-    if (messageId && this.messageIds.has(messageId)) {
-      return "duplicate";
-    }
-
-    const latestCreateTime = this.latestCreateTimeByChat.get(chatId);
-    if (latestCreateTime !== undefined && createTime < latestCreateTime) {
-      return "stale";
-    }
-
-    if (!messageId) {
-      this.recordLatestCreateTime(chatId, createTime);
-      return "accepted";
-    }
-
-    this.entries.push({ messageId, chatId, createTime });
-    this.messageIds.add(messageId);
-    this.recordLatestCreateTime(chatId, createTime);
-
-    if (this.entries.length > this.maxEntries) {
-      this.entries = this.entries.slice(-this.maxEntries);
-      this.rebuildIndexes();
-    }
-
-    try {
-      await this.persist();
-    } catch (error) {
-      console.error(
-        `[FEISHU-DEDUP] Failed to persist ${this.filePath}: ${(error as Error).message}`,
-      );
-    }
-    return "accepted";
-  }
-
-  clearMemory(): void {
-    this.entries = [];
-    this.messageIds.clear();
-    this.latestCreateTimeByChat.clear();
-    this.persistTail = Promise.resolve();
-  }
-
-  private recordLatestCreateTime(chatId: string, createTime: number): void {
-    const current = this.latestCreateTimeByChat.get(chatId);
-    if (current === undefined || createTime > current) {
-      this.latestCreateTimeByChat.set(chatId, createTime);
-    }
-  }
-
-  private rebuildIndexes(): void {
-    this.messageIds.clear();
-    this.latestCreateTimeByChat.clear();
-    for (const entry of this.entries) {
-      this.messageIds.add(entry.messageId);
-      this.recordLatestCreateTime(entry.chatId, entry.createTime);
-    }
-  }
-
-  private persist(): Promise<void> {
-    const snapshot: PersistedMessageLedger = {
-      version: 1,
-      entries: this.entries.map((entry) => ({ ...entry })),
-    };
-
-    const nextPersist = this.persistTail
-      .catch(() => {})
-      .then(async () => {
-        await mkdir(dirname(this.filePath), { recursive: true });
-        const tempPath = `${this.filePath}.${process.pid}.tmp`;
-        try {
-          await writeFile(tempPath, JSON.stringify(snapshot), "utf-8");
-          await rename(tempPath, this.filePath);
-        } finally {
-          await rm(tempPath, { force: true }).catch(() => {});
-        }
-      });
-    this.persistTail = nextPersist;
-    return nextPersist;
-  }
-}
-
-const defaultLedgerPath = join(
-  homedir(),
-  ".chatccc",
-  "state",
-  "feishu-message-ledger.json",
-);
-
-export const processedMessages = new Set<string>();
-export const feishuMessageLedger = new FeishuMessageLedger(
-  defaultLedgerPath,
-  MAX_PROCESSED,
-  processedMessages,
-);
-
-export function clearFeishuMessageLedgerMemory(): void {
-  feishuMessageLedger.clearMemory();
-}

package/src/feishu-platform.ts

@@ -1,159 +0,0 @@
-/**
- * feishu-platform.ts — 可替换的飞书 API 实现层
- *
- * 默认情况下所有函数直接委托给 feishu-api.ts（真实飞书 API）。
- * 在 --simulate 模式下通过 setPlatform() 整体替换为 SimulatedPlatform。
- *
- * 设计：每个导出函数都是一个"通过 _impl 代理"的包装器，
- * 消费者不需要感知底层是真实飞书还是模拟实现。
- */
-
-import * as realApi from "./feishu-api.ts";
-
-// ---------------------------------------------------------------------------
-// 平台接口：覆盖 feishu-api.ts 的所有公开导出函数签名
-// ---------------------------------------------------------------------------
-
-export interface FeishuPlatform {
-  getTenantAccessToken: typeof realApi.getTenantAccessToken;
-  sendTextReply: typeof realApi.sendTextReply;
-  sendCardReply: typeof realApi.sendCardReply;
-  sendRawCard: typeof realApi.sendRawCard;
-  sendPostMessage: typeof realApi.sendPostMessage;
-  sendImageReply: typeof realApi.sendImageReply;
-  sendFileReply: typeof realApi.sendFileReply;
-  addReaction: typeof realApi.addReaction;
-  recallMessage: typeof realApi.recallMessage;
-  updateCardMessage: typeof realApi.updateCardMessage;
-  createGroupChat: typeof realApi.createGroupChat;
-  updateChatInfo: typeof realApi.updateChatInfo;
-  getChatInfo: typeof realApi.getChatInfo;
-  disbandChat: typeof realApi.disbandChat;
-  setChatAvatar: typeof realApi.setChatAvatar;
-  getCodexUsageSummary: typeof realApi.getCodexUsageSummary;
-  consumeCodexRateLimitResetCredit: typeof realApi.consumeCodexRateLimitResetCredit;
-  getOrDownloadImage: typeof realApi.getOrDownloadImage;
-  verifyAllPermissions: typeof realApi.verifyAllPermissions;
-  reportPermissionResults: typeof realApi.reportPermissionResults;
-  extractSessionInfo: typeof realApi.extractSessionInfo;
-  extractSessionId: typeof realApi.extractSessionId;
-  formatDelayNotice: typeof realApi.formatDelayNotice;
-  sendRestartCard: typeof realApi.sendRestartCard;
-  getMergeForwardMessages: typeof realApi.getMergeForwardMessages;
-}
-
-let _impl: FeishuPlatform = realApi;
-
-/** 替换当前平台实现（模拟模式入口） */
-export function setPlatform(impl: FeishuPlatform): void {
-  _impl = impl;
-}
-
-/** 获取当前平台实现（仅供诊断/测试） */
-export function getPlatform(): FeishuPlatform {
-  return _impl;
-}
-
-// ---------------------------------------------------------------------------
-// 包装器：每个函数直接委托到 _impl，签名与原函数完全一致
-// ---------------------------------------------------------------------------
-
-export function getTenantAccessToken(): ReturnType<typeof realApi.getTenantAccessToken> {
-  return _impl.getTenantAccessToken();
-}
-
-export function sendTextReply(...args: Parameters<typeof realApi.sendTextReply>): ReturnType<typeof realApi.sendTextReply> {
-  return _impl.sendTextReply(...args);
-}
-
-export function sendCardReply(...args: Parameters<typeof realApi.sendCardReply>): ReturnType<typeof realApi.sendCardReply> {
-  return _impl.sendCardReply(...args);
-}
-
-export function sendRawCard(...args: Parameters<typeof realApi.sendRawCard>): ReturnType<typeof realApi.sendRawCard> {
-  return _impl.sendRawCard(...args);
-}
-
-export function sendImageReply(...args: Parameters<typeof realApi.sendImageReply>): ReturnType<typeof realApi.sendImageReply> {
-  return _impl.sendImageReply(...args);
-}
-
-export function sendFileReply(...args: Parameters<typeof realApi.sendFileReply>): ReturnType<typeof realApi.sendFileReply> {
-  return _impl.sendFileReply(...args);
-}
-
-export function addReaction(...args: Parameters<typeof realApi.addReaction>): ReturnType<typeof realApi.addReaction> {
-  return _impl.addReaction(...args);
-}
-
-export function recallMessage(...args: Parameters<typeof realApi.recallMessage>): ReturnType<typeof realApi.recallMessage> {
-  return _impl.recallMessage(...args);
-}
-
-export function updateCardMessage(...args: Parameters<typeof realApi.updateCardMessage>): ReturnType<typeof realApi.updateCardMessage> {
-  return _impl.updateCardMessage(...args);
-}
-
-export function createGroupChat(...args: Parameters<typeof realApi.createGroupChat>): ReturnType<typeof realApi.createGroupChat> {
-  return _impl.createGroupChat(...args);
-}
-
-export function updateChatInfo(...args: Parameters<typeof realApi.updateChatInfo>): ReturnType<typeof realApi.updateChatInfo> {
-  return _impl.updateChatInfo(...args);
-}
-
-export function getChatInfo(...args: Parameters<typeof realApi.getChatInfo>): ReturnType<typeof realApi.getChatInfo> {
-  return _impl.getChatInfo(...args);
-}
-
-export function disbandChat(...args: Parameters<typeof realApi.disbandChat>): ReturnType<typeof realApi.disbandChat> {
-  return _impl.disbandChat(...args);
-}
-
-export function setChatAvatar(...args: Parameters<typeof realApi.setChatAvatar>): ReturnType<typeof realApi.setChatAvatar> {
-  return _impl.setChatAvatar(...args);
-}
-
-export function getCodexUsageSummary(...args: Parameters<typeof realApi.getCodexUsageSummary>): ReturnType<typeof realApi.getCodexUsageSummary> {
-  return _impl.getCodexUsageSummary(...args);
-}
-
-export function consumeCodexRateLimitResetCredit(...args: Parameters<typeof realApi.consumeCodexRateLimitResetCredit>): ReturnType<typeof realApi.consumeCodexRateLimitResetCredit> {
-  return _impl.consumeCodexRateLimitResetCredit(...args);
-}
-
-export function getOrDownloadImage(...args: Parameters<typeof realApi.getOrDownloadImage>): ReturnType<typeof realApi.getOrDownloadImage> {
-  return _impl.getOrDownloadImage(...args);
-}
-
-export function verifyAllPermissions(...args: Parameters<typeof realApi.verifyAllPermissions>): ReturnType<typeof realApi.verifyAllPermissions> {
-  return _impl.verifyAllPermissions(...args);
-}
-
-export function reportPermissionResults(...args: Parameters<typeof realApi.reportPermissionResults>): ReturnType<typeof realApi.reportPermissionResults> {
-  return _impl.reportPermissionResults(...args);
-}
-
-export function extractSessionInfo(...args: Parameters<typeof realApi.extractSessionInfo>): ReturnType<typeof realApi.extractSessionInfo> {
-  return _impl.extractSessionInfo(...args);
-}
-
-export function extractSessionId(...args: Parameters<typeof realApi.extractSessionId>): ReturnType<typeof realApi.extractSessionId> {
-  return _impl.extractSessionId(...args);
-}
-
-export function formatDelayNotice(...args: Parameters<typeof realApi.formatDelayNotice>): ReturnType<typeof realApi.formatDelayNotice> {
-  return _impl.formatDelayNotice(...args);
-}
-
-export function sendPostMessage(...args: Parameters<typeof realApi.sendPostMessage>): ReturnType<typeof realApi.sendPostMessage> {
-  return _impl.sendPostMessage(...args);
-}
-
-export function sendRestartCard(...args: Parameters<typeof realApi.sendRestartCard>): ReturnType<typeof realApi.sendRestartCard> {
-  return _impl.sendRestartCard(...args);
-}
-
-export function getMergeForwardMessages(...args: Parameters<typeof realApi.getMergeForwardMessages>): ReturnType<typeof realApi.getMergeForwardMessages> {
-  return _impl.getMergeForwardMessages(...args);
-}

package/src/format-message.ts

@@ -1,293 +0,0 @@
-/**
- * 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");
-}