chatccc 0.2.252 → 0.2.253

package/dist/src/feishu-message-ingress.js

@@ -0,0 +1,137 @@
+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;
+const defaultSchedule = (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(worker, onError, schedule = defaultSchedule) {
+    return async (data) => {
+        schedule(() => {
+            void worker(data).catch(onError);
+        });
+    };
+}
+function isPersistedEntry(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const entry = value;
+    return typeof entry.messageId === "string"
+        && entry.messageId.length > 0
+        && typeof entry.chatId === "string"
+        && typeof entry.createTime === "number"
+        && Number.isFinite(entry.createTime);
+}
+export class FeishuMessageLedger {
+    filePath;
+    maxEntries;
+    messageIds;
+    entries = [];
+    latestCreateTimeByChat = new Map();
+    persistTail = Promise.resolve();
+    constructor(filePath, maxEntries = MAX_PROCESSED, messageIds) {
+        this.filePath = filePath;
+        this.maxEntries = maxEntries;
+        this.messageIds = messageIds ?? new Set();
+    }
+    async load() {
+        this.clearMemory();
+        try {
+            const raw = await readFile(this.filePath, "utf-8");
+            const parsed = JSON.parse(raw);
+            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.code !== "ENOENT") {
+                console.error(`[FEISHU-DEDUP] Failed to load ${this.filePath}: ${error.message}`);
+            }
+        }
+    }
+    async accept(identity) {
+        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.message}`);
+        }
+        return "accepted";
+    }
+    clearMemory() {
+        this.entries = [];
+        this.messageIds.clear();
+        this.latestCreateTimeByChat.clear();
+        this.persistTail = Promise.resolve();
+    }
+    recordLatestCreateTime(chatId, createTime) {
+        const current = this.latestCreateTimeByChat.get(chatId);
+        if (current === undefined || createTime > current) {
+            this.latestCreateTimeByChat.set(chatId, createTime);
+        }
+    }
+    rebuildIndexes() {
+        this.messageIds.clear();
+        this.latestCreateTimeByChat.clear();
+        for (const entry of this.entries) {
+            this.messageIds.add(entry.messageId);
+            this.recordLatestCreateTime(entry.chatId, entry.createTime);
+        }
+    }
+    persist() {
+        const snapshot = {
+            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();
+export const feishuMessageLedger = new FeishuMessageLedger(defaultLedgerPath, MAX_PROCESSED, processedMessages);
+export function clearFeishuMessageLedgerMemory() {
+    feishuMessageLedger.clearMemory();
+}

package/dist/src/feishu-platform.js

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

package/dist/src/format-message.js

@@ -0,0 +1,252 @@
+/**
+ * format-message.ts — 飞书消息内容格式化
+ *
+ * 从 index.ts 中提取，独立模块便于测试。
+ */
+import { cardJsonToPlainText } from "./card-plain-text.js";
+import { ts } from "./config.js";
+import { getTenantAccessToken, getOrDownloadImage, getMergeForwardMessages, } from "./feishu-platform.js";
+/**
+ * 根据消息类型格式化消息内容为可读文本。
+ */
+export async function formatMessageContent(message) {
+    const contentStr = message.content ?? "{}";
+    let content;
+    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 ?? "");
+        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;
+        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.message}`);
+            return `[图片: ${imageKey}]`;
+        }
+    }
+    if (message.message_type === "media") {
+        const fileKey = content.file_key;
+        const fileName = content.file_name || "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;
+        const fileName = content.file_name || "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) {
+    const paragraphs = getPostParagraphs(content);
+    if (!Array.isArray(paragraphs))
+        return "";
+    const parts = [];
+    for (const line of paragraphs) {
+        if (!Array.isArray(line))
+            continue;
+        for (const elem of line) {
+            const el = elem;
+            if (!el || typeof el !== "object")
+                continue;
+            const text = formatPostTextElement(el);
+            if (text)
+                parts.push(text);
+        }
+    }
+    return parts.join("\n").trim();
+}
+function getPostParagraphs(content) {
+    const direct = content.content;
+    if (Array.isArray(direct))
+        return direct;
+    for (const locale of ["zh_cn", "en_us", "ja_jp"]) {
+        const localized = content[locale];
+        if (localized && Array.isArray(localized.content)) {
+            return localized.content;
+        }
+    }
+    return [];
+}
+function formatPostTextElement(el) {
+    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) {
+    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, messageId) {
+    const paragraphs = getPostParagraphs(content);
+    if (!Array.isArray(paragraphs))
+        return "";
+    const parts = [];
+    for (const line of paragraphs) {
+        if (!Array.isArray(line))
+            continue;
+        for (const elem of line) {
+            const el = elem;
+            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, imageKey) {
+    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.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, content, depth = 0) {
+    const MAX_DEPTH = 3;
+    if (depth >= MAX_DEPTH) {
+        return `[合并转发: 超出最大嵌套深度 ${MAX_DEPTH}]`;
+    }
+    const title = content.title || "聊天记录";
+    const chatName = content.chat_name || "";
+    const header = `[合并转发: ${title}${chatName ? ` (${chatName})` : ""}]`;
+    // 从 preview 构建 sender ID → name 映射表
+    const senderNameMap = new Map();
+    const preview = content.preview;
+    if (Array.isArray(preview)) {
+        for (const entry of preview) {
+            const e = entry;
+            const s = e.sender;
+            if (s && typeof s.id === "string" && typeof s.name === "string") {
+                senderNameMap.set(s.id, s.name);
+            }
+        }
+    }
+    const lines = [];
+    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.message}`);
+    }
+    // Phase 2: API 失败或返回空时降级使用 preview
+    if (!usedApi) {
+        if (Array.isArray(preview) && preview.length > 0) {
+            for (const entry of preview) {
+                const e = entry;
+                const s = e.sender;
+                const senderName = s?.name ?? "未知用户";
+                const text = e.content ?? "";
+                lines.push(`${senderName}: ${text}`);
+            }
+        }
+    }
+    // Phase 3: 没有任何内容时返回原始 JSON
+    if (lines.length === 0) {
+        return JSON.stringify(content);
+    }
+    return header + "\n" + lines.join("\n");
+}

package/dist/src/git-command.js

@@ -0,0 +1,155 @@
+// =============================================================================
+// git-command.ts — /git 命令的执行与结果格式化
+// =============================================================================
+// 解析自 /git 后的原始字符串作为 shell 参数，在指定 cwd 下通过 shell 调起
+// `git ...`，收集 stdout/stderr 与退出码。带超时（kill）与逐路输出字节上限
+// （超过即截断），避免长输出撑爆内存或刷屏。
+//
+// 抽成独立模块是为了便于在不依赖飞书 SDK / 网络的前提下跑单元测试。
+// =============================================================================
+import { spawn } from "node:child_process";
+import { truncateContent } from "./cards.js";
+// ---------------------------------------------------------------------------
+// runGitCommand —— 在 cwd 下执行 `git <args>`
+// ---------------------------------------------------------------------------
+/**
+ * 在 `cwd` 目录下执行 `git <args>`。
+ * - 通过 shell 执行（`shell: true`），允许用户使用引号、管道等 shell 语法
+ * - stdout/stderr 各自最多采集 `maxBytes` 字节，超过则置 truncated=true 并丢弃后续片段
+ * - 超时则 SIGKILL 并置 timedOut=true，仍返回已收集的部分输出
+ *
+ * 注意：本函数 **不会抛错**——任何失败都通过返回值传递（退出码、spawnError 等），
+ * 调用方需通过 exitCode/spawnError/timedOut/truncated 判断结果。
+ */
+export function runGitCommand(args, cwd, opts = {}) {
+    const timeoutMs = opts.timeoutMs ?? 60_000;
+    const maxBytes = opts.maxBytes ?? 64 * 1024;
+    const spawnImpl = opts.spawnImpl ?? spawn;
+    const startTime = Date.now();
+    return new Promise((resolve) => {
+        let child;
+        try {
+            child = spawnImpl(`git ${args}`, {
+                cwd,
+                shell: true,
+                windowsHide: true,
+            });
+        }
+        catch (err) {
+            resolve({
+                exitCode: null,
+                stdout: "",
+                stderr: "",
+                durationMs: Date.now() - startTime,
+                truncated: false,
+                timedOut: false,
+                spawnError: err instanceof Error ? err.message : String(err),
+            });
+            return;
+        }
+        let stdout = "";
+        let stderr = "";
+        let stdoutBytes = 0;
+        let stderrBytes = 0;
+        let truncated = false;
+        let timedOut = false;
+        let spawnError;
+        const collect = (chunk, current) => {
+            const room = maxBytes - current.bytes;
+            if (room <= 0) {
+                truncated = true;
+                return;
+            }
+            const slice = chunk.length <= room ? chunk : chunk.subarray(0, room);
+            current.text += slice.toString("utf-8");
+            current.bytes += slice.length;
+            if (chunk.length > room)
+                truncated = true;
+        };
+        const stdoutState = { bytes: 0, text: "" };
+        const stderrState = { bytes: 0, text: "" };
+        child.stdout?.on("data", (chunk) => {
+            collect(chunk, stdoutState);
+            stdout = stdoutState.text;
+            stdoutBytes = stdoutState.bytes;
+        });
+        child.stderr?.on("data", (chunk) => {
+            collect(chunk, stderrState);
+            stderr = stderrState.text;
+            stderrBytes = stderrState.bytes;
+        });
+        const killTimer = setTimeout(() => {
+            timedOut = true;
+            try {
+                child.kill("SIGKILL");
+            }
+            catch {
+                // ignore: 进程可能已退出
+            }
+        }, timeoutMs);
+        child.on("error", (err) => {
+            spawnError = err.message;
+        });
+        child.on("close", (code) => {
+            clearTimeout(killTimer);
+            // 仅引用未直接使用的字节计数变量以避免编译告警
+            void stdoutBytes;
+            void stderrBytes;
+            resolve({
+                exitCode: code,
+                stdout,
+                stderr,
+                durationMs: Date.now() - startTime,
+                truncated,
+                timedOut,
+                spawnError,
+            });
+        });
+    });
+}
+// ---------------------------------------------------------------------------
+// formatGitResult —— 把执行结果渲染为飞书卡片用的 markdown
+// ---------------------------------------------------------------------------
+/**
+ * 渲染 `/git` 执行结果为发送给用户的 markdown 字符串。
+ * stdout/stderr 单路各最多保留 `maxLines` 行 / `maxChars` 字符（沿用 truncateContent），
+ * 命令本身的截断状态（truncated/timedOut/spawnError）也会在头部说明。
+ */
+export function formatGitResult(args, cwd, result, opts = {}) {
+    const maxLines = opts.maxLines ?? 50;
+    const maxChars = opts.maxChars ?? 6000;
+    const sec = (result.durationMs / 1000).toFixed(2);
+    const lines = [];
+    lines.push(`**\$ git ${args}**`);
+    lines.push(`工作目录: \`${cwd}\``);
+    const exitDisplay = result.exitCode === null ? "(无)" : String(result.exitCode);
+    lines.push(`退出码: \`${exitDisplay}\` | 用时: \`${sec}s\``);
+    if (result.timedOut)
+        lines.push(`⏱️ 命令超时被强制终止`);
+    if (result.truncated)
+        lines.push(`⚠️ 输出超出采集上限，已截断`);
+    if (result.spawnError)
+        lines.push(`❌ 启动失败: ${result.spawnError}`);
+    const stdoutTrim = result.stdout.trim();
+    const stderrTrim = result.stderr.trim();
+    if (stdoutTrim) {
+        lines.push("", "**stdout:**", "```", truncateContent(stdoutTrim, maxLines, maxChars), "```");
+    }
+    if (stderrTrim) {
+        lines.push("", "**stderr:**", "```", truncateContent(stderrTrim, maxLines, maxChars), "```");
+    }
+    if (!stdoutTrim && !stderrTrim && !result.spawnError) {
+        lines.push("", "_(命令无输出)_");
+    }
+    return lines.join("\n");
+}
+// ---------------------------------------------------------------------------
+// 头部颜色：成功绿色，失败红色，超时黄色
+// ---------------------------------------------------------------------------
+export function gitResultHeaderTemplate(result) {
+    if (result.timedOut || result.spawnError)
+        return "yellow";
+    if (result.exitCode === 0)
+        return "green";
+    return "red";
+}