ylib-wecom-openclaw-plugin 2026.4.29

package/dist/src/media-uploader.js

@@ -0,0 +1,446 @@
+"use strict";
+/**
+ * 企业微信出站媒体上传工具模块
+ *
+ * 负责：
+ * - 从 mediaUrl 加载文件 buffer（远程 URL 或本地路径均支持）
+ * - 检测 MIME 类型并映射为企微媒体类型
+ * - 文件大小检查与降级策略
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (_) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+exports.__esModule = true;
+exports.uploadAndReplyMedia = exports.uploadAndSendMedia = exports.applyFileSizeLimits = exports.resolveMediaFile = exports.detectWeComMediaType = void 0;
+var openclaw_compat_js_1 = require("./openclaw-compat.js");
+var const_js_1 = require("./const.js");
+// ============================================================================
+// MIME → 企微媒体类型映射
+// ============================================================================
+/**
+ * 根据 MIME 类型检测企微媒体类型
+ *
+ * @param mimeType - MIME 类型字符串
+ * @returns 企微媒体类型
+ */
+function detectWeComMediaType(mimeType) {
+    var mime = mimeType.toLowerCase();
+    // 图片类型
+    if (mime.startsWith("image/")) {
+        return "image";
+    }
+    // 视频类型
+    if (mime.startsWith("video/")) {
+        return "video";
+    }
+    // 语音类型
+    if (mime.startsWith("audio/") ||
+        mime === "application/ogg" // OGG 音频容器
+    ) {
+        return "voice";
+    }
+    // 其他类型默认为文件
+    return "file";
+}
+exports.detectWeComMediaType = detectWeComMediaType;
+// ============================================================================
+// 媒体文件加载
+// ============================================================================
+/**
+ * 从 mediaUrl 加载媒体文件
+ *
+ * 支持远程 URL（http/https）和本地路径（file:// 或绝对路径），
+ * 利用 openclaw plugin-sdk 的 loadOutboundMediaFromUrl 统一处理。
+ *
+ * @param mediaUrl - 媒体文件的 URL 或本地路径
+ * @param mediaLocalRoots - 允许读取本地文件的安全白名单目录
+ * @returns 解析后的媒体文件信息
+ */
+function resolveMediaFile(mediaUrl, mediaLocalRoots, gatewayToken, gatewayBaseUrl) {
+    return __awaiter(this, void 0, void 0, function () {
+        var result, contentType, detected, fileName;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, openclaw_compat_js_1.loadOutboundMediaFromUrl(mediaUrl, {
+                        maxBytes: const_js_1.ABSOLUTE_MAX_BYTES,
+                        mediaLocalRoots: mediaLocalRoots,
+                        gatewayToken: gatewayToken,
+                        trustedGatewayBaseUrl: gatewayBaseUrl
+                    })];
+                case 1:
+                    result = _a.sent();
+                    if (!result.buffer || result.buffer.length === 0) {
+                        throw new Error("Failed to load media from " + mediaUrl + ": empty buffer");
+                    }
+                    contentType = result.contentType || "application/octet-stream";
+                    if (!(contentType === "application/octet-stream" ||
+                        contentType === "text/plain")) return [3 /*break*/, 3];
+                    return [4 /*yield*/, openclaw_compat_js_1.detectMime(result.buffer)];
+                case 2:
+                    detected = _a.sent();
+                    if (detected) {
+                        contentType = detected;
+                    }
+                    _a.label = 3;
+                case 3:
+                    fileName = extractFileName(mediaUrl, result.fileName, contentType);
+                    return [2 /*return*/, {
+                            buffer: result.buffer,
+                            contentType: contentType,
+                            fileName: fileName
+                        }];
+            }
+        });
+    });
+}
+exports.resolveMediaFile = resolveMediaFile;
+// ============================================================================
+// 文件大小检查与降级
+// ============================================================================
+/** 企微语音消息仅支持 AMR 格式 */
+var VOICE_SUPPORTED_MIMES = new Set(["audio/amr"]);
+/**
+ * 检查文件大小并执行降级策略
+ *
+ * 降级规则：
+ * - voice 非 AMR 格式 → 降级为 file（企微后台仅支持 AMR）
+ * - image 超过 10MB → 降级为 file
+ * - video 超过 10MB → 降级为 file
+ * - voice 超过 2MB → 降级为 file
+ * - file 超过 20MB → 拒绝发送
+ *
+ * @param fileSize - 文件大小（字节）
+ * @param detectedType - 检测到的企微媒体类型
+ * @param contentType - 文件的 MIME 类型（用于语音格式校验）
+ * @returns 大小检查结果
+ */
+function applyFileSizeLimits(fileSize, detectedType, contentType) {
+    var fileSizeMB = (fileSize / (1024 * 1024)).toFixed(2);
+    // 先检查绝对上限（20MB）
+    if (fileSize > const_js_1.ABSOLUTE_MAX_BYTES) {
+        return {
+            finalType: detectedType,
+            shouldReject: true,
+            rejectReason: "\u6587\u4EF6\u5927\u5C0F " + fileSizeMB + "MB \u8D85\u8FC7\u4E86\u4F01\u4E1A\u5FAE\u4FE1\u5141\u8BB8\u7684\u6700\u5927\u9650\u5236 20MB\uFF0C\u65E0\u6CD5\u53D1\u9001\u3002\u8BF7\u5C1D\u8BD5\u538B\u7F29\u6587\u4EF6\u6216\u51CF\u5C0F\u6587\u4EF6\u5927\u5C0F\u3002",
+            downgraded: false
+        };
+    }
+    // 按类型检查大小限制
+    switch (detectedType) {
+        case "image":
+            if (fileSize > const_js_1.IMAGE_MAX_BYTES) {
+                return {
+                    finalType: "file",
+                    shouldReject: false,
+                    downgraded: true,
+                    downgradeNote: "\u56FE\u7247\u5927\u5C0F " + fileSizeMB + "MB \u8D85\u8FC7 10MB \u9650\u5236\uFF0C\u5DF2\u8F6C\u4E3A\u6587\u4EF6\u683C\u5F0F\u53D1\u9001"
+                };
+            }
+            break;
+        case "video":
+            if (fileSize > const_js_1.VIDEO_MAX_BYTES) {
+                return {
+                    finalType: "file",
+                    shouldReject: false,
+                    downgraded: true,
+                    downgradeNote: "\u89C6\u9891\u5927\u5C0F " + fileSizeMB + "MB \u8D85\u8FC7 10MB \u9650\u5236\uFF0C\u5DF2\u8F6C\u4E3A\u6587\u4EF6\u683C\u5F0F\u53D1\u9001"
+                };
+            }
+            break;
+        case "voice":
+            // 企微语音消息仅支持 AMR 格式，非 AMR 一律降级为文件
+            if (contentType && !VOICE_SUPPORTED_MIMES.has(contentType.toLowerCase())) {
+                return {
+                    finalType: "file",
+                    shouldReject: false,
+                    downgraded: true,
+                    downgradeNote: "\u8BED\u97F3\u683C\u5F0F " + contentType + " \u4E0D\u652F\u6301\uFF0C\u4F01\u5FAE\u4EC5\u652F\u6301 AMR \u683C\u5F0F\uFF0C\u5DF2\u8F6C\u4E3A\u6587\u4EF6\u683C\u5F0F\u53D1\u9001"
+                };
+            }
+            if (fileSize > const_js_1.VOICE_MAX_BYTES) {
+                return {
+                    finalType: "file",
+                    shouldReject: false,
+                    downgraded: true,
+                    downgradeNote: "\u8BED\u97F3\u5927\u5C0F " + fileSizeMB + "MB \u8D85\u8FC7 2MB \u9650\u5236\uFF0C\u5DF2\u8F6C\u4E3A\u6587\u4EF6\u683C\u5F0F\u53D1\u9001"
+                };
+            }
+            break;
+        case "file":
+            // file 类型在绝对上限内即可
+            break;
+    }
+    // 无需降级
+    return {
+        finalType: detectedType,
+        shouldReject: false,
+        downgraded: false
+    };
+}
+exports.applyFileSizeLimits = applyFileSizeLimits;
+// ============================================================================
+// 辅助函数
+// ============================================================================
+/**
+ * 从 URL/路径中提取文件名
+ */
+function extractFileName(mediaUrl, providedFileName, contentType) {
+    // 优先使用提供的文件名
+    if (providedFileName) {
+        return sanitizeFileName(providedFileName);
+    }
+    // 尝试从 URL 中提取
+    try {
+        var urlObj = new URL(mediaUrl, "file://");
+        for (var _i = 0, _a = [
+            "relative_path",
+            "path",
+            "file_path",
+            "filepath",
+            "target_path",
+            "source_path",
+        ]; _i < _a.length; _i++) {
+            var key = _a[_i];
+            var rawPath = urlObj.searchParams.get(key);
+            if (!rawPath)
+                continue;
+            var fromQueryPath = sanitizeFileName(decodeURIComponent(rawPath));
+            if (fromQueryPath)
+                return appendExtensionIfMissing(fromQueryPath, contentType);
+        }
+        var fromPath = sanitizeFileName(decodeURIComponent(urlObj.pathname));
+        if (fromPath && fromPath.includes(".")) {
+            return appendExtensionIfMissing(fromPath, contentType);
+        }
+    }
+    catch (_b) {
+        // 尝试作为普通路径处理
+        var fromPath = sanitizeFileName(mediaUrl);
+        if (fromPath && fromPath.includes(".")) {
+            return appendExtensionIfMissing(fromPath, contentType);
+        }
+    }
+    // 使用 MIME 类型生成默认文件名
+    var ext = mimeToExtension(contentType || "application/octet-stream");
+    return "media_" + Date.now() + ext;
+}
+function sanitizeFileName(name) {
+    var trimmed = String(name || "").trim();
+    if (!trimmed)
+        return "";
+    var base = trimmed.replace(/\\/g, "/").split("/").filter(Boolean).pop() || "";
+    var safe = base.replace(/[\\/:*?"<>|\u0000-\u001f]/g, "_");
+    return safe === "." || safe === ".." ? "" : safe;
+}
+function appendExtensionIfMissing(name, contentType) {
+    if (!name)
+        return "";
+    if (name.includes("."))
+        return name;
+    var ext = mimeToExtension(contentType || "application/octet-stream");
+    return ext ? "" + name + ext : name;
+}
+/**
+ * MIME 类型转文件扩展名
+ */
+function mimeToExtension(mime) {
+    var map = {
+        "image/jpeg": ".jpg",
+        "image/png": ".png",
+        "image/gif": ".gif",
+        "image/webp": ".webp",
+        "image/bmp": ".bmp",
+        "image/svg+xml": ".svg",
+        "video/mp4": ".mp4",
+        "video/quicktime": ".mov",
+        "video/x-msvideo": ".avi",
+        "video/webm": ".webm",
+        "audio/mpeg": ".mp3",
+        "audio/ogg": ".ogg",
+        "audio/wav": ".wav",
+        "audio/amr": ".amr",
+        "audio/aac": ".aac",
+        "application/pdf": ".pdf",
+        "application/zip": ".zip",
+        "application/msword": ".doc",
+        "application/vnd.openxmlformats-officedocument.wordprocessingml.document": ".docx",
+        "application/vnd.ms-excel": ".xls",
+        "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": ".xlsx",
+        "text/plain": ".txt"
+    };
+    return map[mime] || ".bin";
+}
+/**
+ * 公共媒体上传+发送流程
+ *
+ * 统一处理：resolveMediaFile → detectType → sizeCheck → uploadMedia → sendMediaMessage
+ * 媒体消息统一走 aibot_send_msg 主动发送，避免多文件场景下 reqId 只能用一次的问题。
+ * channel.ts 的 sendMedia 和 monitor.ts 的 deliver 回调都使用此函数。
+ */
+function uploadAndSendMedia(options) {
+    var _a, _b;
+    return __awaiter(this, void 0, void 0, function () {
+        var wsClient, mediaUrl, chatId, mediaLocalRoots, gatewayToken, gatewayBaseUrl, log, errorLog, media, detectedType, sizeCheck, finalType, uploadResult, result, messageId, err_1, errMsg;
+        return __generator(this, function (_c) {
+            switch (_c.label) {
+                case 0:
+                    wsClient = options.wsClient, mediaUrl = options.mediaUrl, chatId = options.chatId, mediaLocalRoots = options.mediaLocalRoots, gatewayToken = options.gatewayToken, gatewayBaseUrl = options.gatewayBaseUrl, log = options.log, errorLog = options.errorLog;
+                    _c.label = 1;
+                case 1:
+                    _c.trys.push([1, 5, , 6]);
+                    // 1. 加载媒体文件
+                    log === null || log === void 0 ? void 0 : log("[wecom] Uploading media: url=" + mediaUrl);
+                    return [4 /*yield*/, resolveMediaFile(mediaUrl, mediaLocalRoots, gatewayToken, gatewayBaseUrl)];
+                case 2:
+                    media = _c.sent();
+                    detectedType = detectWeComMediaType(media.contentType);
+                    sizeCheck = applyFileSizeLimits(media.buffer.length, detectedType, media.contentType);
+                    if (sizeCheck.shouldReject) {
+                        errorLog === null || errorLog === void 0 ? void 0 : errorLog("[wecom] Media rejected: " + sizeCheck.rejectReason);
+                        return [2 /*return*/, {
+                                ok: false,
+                                rejected: true,
+                                rejectReason: sizeCheck.rejectReason,
+                                finalType: sizeCheck.finalType,
+                                fileName: media.fileName
+                            }];
+                    }
+                    finalType = sizeCheck.finalType;
+                    return [4 /*yield*/, wsClient.uploadMedia(media.buffer, {
+                            type: finalType,
+                            filename: media.fileName
+                        })];
+                case 3:
+                    uploadResult = _c.sent();
+                    log === null || log === void 0 ? void 0 : log("[wecom] Media uploaded: media_id=" + uploadResult.media_id + ", type=" + finalType);
+                    return [4 /*yield*/, wsClient.sendMediaMessage(chatId, finalType, uploadResult.media_id)];
+                case 4:
+                    result = _c.sent();
+                    messageId = (_b = (_a = result === null || result === void 0 ? void 0 : result.headers) === null || _a === void 0 ? void 0 : _a.req_id) !== null && _b !== void 0 ? _b : "wecom-media-" + Date.now();
+                    log === null || log === void 0 ? void 0 : log("[wecom] Media sent via sendMediaMessage: chatId=" + chatId + ", type=" + finalType);
+                    return [2 /*return*/, {
+                            ok: true,
+                            messageId: messageId,
+                            fileName: media.fileName,
+                            finalType: finalType,
+                            downgraded: sizeCheck.downgraded,
+                            downgradeNote: sizeCheck.downgradeNote
+                        }];
+                case 5:
+                    err_1 = _c.sent();
+                    errMsg = String(err_1);
+                    errorLog === null || errorLog === void 0 ? void 0 : errorLog("[wecom] Failed to upload/send media: url=" + mediaUrl + ", error=" + errMsg);
+                    return [2 /*return*/, {
+                            ok: false,
+                            error: errMsg
+                        }];
+                case 6: return [2 /*return*/];
+            }
+        });
+    });
+}
+exports.uploadAndSendMedia = uploadAndSendMedia;
+/**
+ * 被动回复媒体上传+发送流程
+ *
+ * 统一处理：resolveMediaFile → detectType → sizeCheck → uploadMedia → replyMedia
+ * 通过 aibot_respond_msg 被动回复通道发送媒体消息，可以覆盖之前的 THINKING_MESSAGE。
+ *
+ * 适用场景：回包只有媒体没有文本时，第一个媒体文件用此方法发送以清理 thinking 状态。
+ */
+function uploadAndReplyMedia(options) {
+    var _a, _b;
+    return __awaiter(this, void 0, void 0, function () {
+        var wsClient, mediaUrl, frame, mediaLocalRoots, gatewayToken, gatewayBaseUrl, log, errorLog, media, detectedType, sizeCheck, finalType, uploadResult, result, messageId, err_2, errMsg;
+        return __generator(this, function (_c) {
+            switch (_c.label) {
+                case 0:
+                    wsClient = options.wsClient, mediaUrl = options.mediaUrl, frame = options.frame, mediaLocalRoots = options.mediaLocalRoots, gatewayToken = options.gatewayToken, gatewayBaseUrl = options.gatewayBaseUrl, log = options.log, errorLog = options.errorLog;
+                    _c.label = 1;
+                case 1:
+                    _c.trys.push([1, 5, , 6]);
+                    // 1. 加载媒体文件
+                    log === null || log === void 0 ? void 0 : log("[wecom] Uploading media (reply mode): url=" + mediaUrl);
+                    return [4 /*yield*/, resolveMediaFile(mediaUrl, mediaLocalRoots, gatewayToken, gatewayBaseUrl)];
+                case 2:
+                    media = _c.sent();
+                    detectedType = detectWeComMediaType(media.contentType);
+                    sizeCheck = applyFileSizeLimits(media.buffer.length, detectedType, media.contentType);
+                    if (sizeCheck.shouldReject) {
+                        errorLog === null || errorLog === void 0 ? void 0 : errorLog("[wecom] Media rejected: " + sizeCheck.rejectReason);
+                        return [2 /*return*/, {
+                                ok: false,
+                                rejected: true,
+                                rejectReason: sizeCheck.rejectReason,
+                                finalType: sizeCheck.finalType,
+                                fileName: media.fileName
+                            }];
+                    }
+                    finalType = sizeCheck.finalType;
+                    return [4 /*yield*/, wsClient.uploadMedia(media.buffer, {
+                            type: finalType,
+                            filename: media.fileName
+                        })];
+                case 3:
+                    uploadResult = _c.sent();
+                    log === null || log === void 0 ? void 0 : log("[wecom] Media uploaded: media_id=" + uploadResult.media_id + ", type=" + finalType);
+                    return [4 /*yield*/, wsClient.replyMedia(frame, finalType, uploadResult.media_id)];
+                case 4:
+                    result = _c.sent();
+                    messageId = (_b = (_a = result === null || result === void 0 ? void 0 : result.headers) === null || _a === void 0 ? void 0 : _a.req_id) !== null && _b !== void 0 ? _b : "wecom-reply-media-" + Date.now();
+                    log === null || log === void 0 ? void 0 : log("[wecom] Media sent via replyMedia (passive reply): type=" + finalType);
+                    return [2 /*return*/, {
+                            ok: true,
+                            messageId: messageId,
+                            fileName: media.fileName,
+                            finalType: finalType,
+                            downgraded: sizeCheck.downgraded,
+                            downgradeNote: sizeCheck.downgradeNote
+                        }];
+                case 5:
+                    err_2 = _c.sent();
+                    errMsg = String(err_2);
+                    errorLog === null || errorLog === void 0 ? void 0 : errorLog("[wecom] Failed to upload/reply media: url=" + mediaUrl + ", error=" + errMsg);
+                    return [2 /*return*/, {
+                            ok: false,
+                            error: errMsg
+                        }];
+                case 6: return [2 /*return*/];
+            }
+        });
+    });
+}
+exports.uploadAndReplyMedia = uploadAndReplyMedia;

package/dist/src/message-parser.d.ts

@@ -0,0 +1,104 @@
+/**
+ * 企业微信消息内容解析模块
+ *
+ * 负责从 WsFrame 中提取文本、图片、引用等内容
+ */
+export interface MessageBody {
+    msgid: string;
+    aibotid?: string;
+    chatid?: string;
+    chattype: "single" | "group";
+    from: {
+        corpid?: string;
+        userid: string;
+        /** 会话 ID（权限变更事件回调中携带） */
+        chat_id?: string;
+    };
+    response_url?: string;
+    msgtype: string;
+    text?: {
+        content: string;
+    };
+    image?: {
+        url?: string;
+        aeskey?: string;
+    };
+    voice?: {
+        content?: string;
+    };
+    mixed?: {
+        msg_item: Array<{
+            msgtype: "text" | "image";
+            text?: {
+                content: string;
+            };
+            image?: {
+                url?: string;
+                aeskey?: string;
+            };
+        }>;
+    };
+    file?: {
+        url?: string;
+        aeskey?: string;
+    };
+    video?: {
+        url?: string;
+        aeskey?: string;
+    };
+    quote?: {
+        msgtype: string;
+        text?: {
+            content: string;
+        };
+        voice?: {
+            content: string;
+        };
+        image?: {
+            url?: string;
+            aeskey?: string;
+        };
+        file?: {
+            url?: string;
+            aeskey?: string;
+        };
+        video?: {
+            url?: string;
+            aeskey?: string;
+        };
+    };
+    event?: {
+        eventtype?: string;
+        template_card_event?: {
+            card_type?: string;
+            event_key?: string;
+            task_id?: string;
+            selected_items?: {
+                selected_item?: Array<{
+                    question_key?: string;
+                    option_ids?: {
+                        option_id?: string[];
+                    };
+                }>;
+            };
+        };
+        /** 权限变更事件回调（如文档授权） */
+        auth_change_event?: {
+            /** 当前权限列表：1-新建和编辑文档；2-获取成员文档内容 */
+            auth_list?: number[];
+        };
+    };
+}
+export interface ParsedMessageContent {
+    textParts: string[];
+    imageUrls: string[];
+    imageAesKeys: Map<string, string>;
+    fileUrls: string[];
+    fileAesKeys: Map<string, string>;
+    quoteContent: string | undefined;
+}
+/**
+ * 解析消息内容（支持单条消息、图文混排、事件回调和引用消息）
+ * @returns 提取的文本数组、图片URL数组和引用消息内容
+ */
+export declare function parseMessageContent(body: MessageBody): ParsedMessageContent;