@wwlocal/aibot-plugin-node 20260409.20.0

package/dist/cjs/src/media-loader.js

@@ -0,0 +1,271 @@
+'use strict';
+
+var fs = require('node:fs/promises');
+var path = require('node:path');
+var os = require('node:os');
+var node_url = require('node:url');
+
+function _interopNamespaceDefault(e) {
+    var n = Object.create(null);
+    if (e) {
+        Object.keys(e).forEach(function (k) {
+            if (k !== 'default') {
+                var d = Object.getOwnPropertyDescriptor(e, k);
+                Object.defineProperty(n, k, d.get ? d : {
+                    enumerable: true,
+                    get: function () { return e[k]; }
+                });
+            }
+        });
+    }
+    n.default = e;
+    return Object.freeze(n);
+}
+
+var fs__namespace = /*#__PURE__*/_interopNamespaceDefault(fs);
+var path__namespace = /*#__PURE__*/_interopNamespaceDefault(path);
+var os__namespace = /*#__PURE__*/_interopNamespaceDefault(os);
+
+/**
+ * 出站媒体文件加载器
+ *
+ * 内联 openclaw-compat.ts 的 fallback 实现：
+ * - loadOutboundMediaFromUrl（支持远程 URL 和本地文件）
+ * - detectMime（buffer 嗅探 + 扩展名映射）
+ * - assertLocalMediaAllowed（安全白名单检查）
+ *
+ * 不再有 OpenClaw SDK 探测逻辑，直接使用独立实现。
+ */
+// ============================================================================
+// MIME 检测
+// ============================================================================
+const MIME_BY_EXT = {
+    ".heic": "image/heic",
+    ".heif": "image/heif",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".png": "image/png",
+    ".webp": "image/webp",
+    ".gif": "image/gif",
+    ".ogg": "audio/ogg",
+    ".mp3": "audio/mpeg",
+    ".m4a": "audio/x-m4a",
+    ".mp4": "video/mp4",
+    ".mov": "video/quicktime",
+    ".pdf": "application/pdf",
+    ".json": "application/json",
+    ".zip": "application/zip",
+    ".gz": "application/gzip",
+    ".tar": "application/x-tar",
+    ".7z": "application/x-7z-compressed",
+    ".rar": "application/vnd.rar",
+    ".doc": "application/msword",
+    ".xls": "application/vnd.ms-excel",
+    ".ppt": "application/vnd.ms-powerpoint",
+    ".docx": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+    ".xlsx": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+    ".pptx": "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+    ".csv": "text/csv",
+    ".txt": "text/plain",
+    ".md": "text/markdown",
+    ".amr": "audio/amr",
+    ".aac": "audio/aac",
+    ".wav": "audio/wav",
+    ".webm": "video/webm",
+    ".avi": "video/x-msvideo",
+    ".bmp": "image/bmp",
+    ".svg": "image/svg+xml",
+};
+/** 通过 buffer 魔术字节嗅探 MIME 类型 */
+async function sniffMimeFromBuffer(buffer) {
+    try {
+        const { fileTypeFromBuffer } = await import('file-type');
+        const type = await fileTypeFromBuffer(buffer);
+        return type?.mime ?? undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * 检测 MIME 类型
+ *
+ * 支持两种调用签名：
+ * - detectMime(buffer)           → 仅 buffer 嗅探
+ * - detectMime({ buffer, headerMime, filePath }) → 完整参数
+ */
+async function detectMime(bufferOrOpts) {
+    const opts = Buffer.isBuffer(bufferOrOpts)
+        ? { buffer: bufferOrOpts }
+        : bufferOrOpts;
+    const ext = opts.filePath ? path__namespace.extname(opts.filePath).toLowerCase() : undefined;
+    const extMime = ext ? MIME_BY_EXT[ext] : undefined;
+    const sniffed = opts.buffer ? await sniffMimeFromBuffer(opts.buffer) : undefined;
+    const isGeneric = (m) => !m || m === "application/octet-stream" || m === "application/zip";
+    if (sniffed && (!isGeneric(sniffed) || !extMime)) {
+        return sniffed;
+    }
+    if (extMime) {
+        return extMime;
+    }
+    const headerMime = opts.headerMime?.split(";")?.[0]?.trim().toLowerCase();
+    if (headerMime && !isGeneric(headerMime)) {
+        return headerMime;
+    }
+    if (sniffed) {
+        return sniffed;
+    }
+    if (headerMime) {
+        return headerMime;
+    }
+    return undefined;
+}
+// ============================================================================
+// 本地文件安全校验
+// ============================================================================
+/**
+ * 校验本地媒体文件路径是否在允许的根目录列表内
+ */
+async function assertLocalMediaAllowed(mediaPath, localRoots) {
+    if (!localRoots || localRoots.length === 0) {
+        throw new Error(`Local media path is not under an allowed directory: ${mediaPath}`);
+    }
+    let resolved;
+    try {
+        resolved = await fs__namespace.realpath(mediaPath);
+    }
+    catch {
+        resolved = path__namespace.resolve(mediaPath);
+    }
+    for (const root of localRoots) {
+        let resolvedRoot;
+        try {
+            resolvedRoot = await fs__namespace.realpath(root);
+        }
+        catch {
+            resolvedRoot = path__namespace.resolve(root);
+        }
+        if (resolvedRoot === path__namespace.parse(resolvedRoot).root) {
+            continue;
+        }
+        if (resolved === resolvedRoot || resolved.startsWith(resolvedRoot + path__namespace.sep)) {
+            return;
+        }
+    }
+    throw new Error(`Local media path is not under an allowed directory: ${mediaPath}`);
+}
+// ============================================================================
+// 远程媒体下载
+// ============================================================================
+/** 从远程 URL 获取媒体 */
+async function fetchRemoteMedia(url, maxBytes) {
+    const res = await fetch(url, { redirect: "follow" });
+    if (!res.ok) {
+        throw new Error(`Failed to fetch media from ${url}: HTTP ${res.status} ${res.statusText}`);
+    }
+    const buffer = Buffer.from(await res.arrayBuffer());
+    if (maxBytes && buffer.length > maxBytes) {
+        throw new Error(`Media from ${url} exceeds max size (${buffer.length} > ${maxBytes})`);
+    }
+    const headerMime = res.headers.get("content-type")?.split(";")?.[0]?.trim();
+    let fileName;
+    const disposition = res.headers.get("content-disposition");
+    if (disposition) {
+        const match = /filename\*?\s*=\s*(?:UTF-8''|")?([^";]+)/i.exec(disposition);
+        if (match?.[1]) {
+            try {
+                fileName = path__namespace.basename(decodeURIComponent(match[1].replace(/["']/g, "").trim()));
+            }
+            catch {
+                fileName = path__namespace.basename(match[1].replace(/["']/g, "").trim());
+            }
+        }
+    }
+    if (!fileName) {
+        try {
+            const parsed = new URL(url);
+            const base = path__namespace.basename(parsed.pathname);
+            if (base && base.includes("."))
+                fileName = base;
+        }
+        catch { /* ignore */ }
+    }
+    const contentType = await detectMime({ buffer, headerMime, filePath: fileName ?? url });
+    return { buffer, contentType, fileName };
+}
+/** 展开 ~ 为用户主目录 */
+function resolveUserPath(p) {
+    if (p.startsWith("~")) {
+        return path__namespace.join(os__namespace.homedir(), p.slice(1));
+    }
+    return p;
+}
+// ============================================================================
+// 公开 API
+// ============================================================================
+/**
+ * 从 URL 或本地路径加载媒体文件
+ *
+ * 支持：
+ * - 远程 URL (http:// / https://)
+ * - 本地文件路径 (file:// 或绝对路径)
+ * - ~ 路径展开
+ */
+async function loadOutboundMediaFromUrl(mediaUrl, options = {}) {
+    const { maxBytes, mediaLocalRoots } = options;
+    // 去除 MEDIA: 前缀
+    mediaUrl = mediaUrl.replace(/^\s*MEDIA\s*:\s*/i, "");
+    // 处理 file:// URL
+    if (mediaUrl.startsWith("file://")) {
+        try {
+            mediaUrl = node_url.fileURLToPath(mediaUrl);
+        }
+        catch {
+            throw new Error(`Invalid file:// URL: ${mediaUrl}`);
+        }
+    }
+    // 远程 URL
+    if (/^https?:\/\//i.test(mediaUrl)) {
+        const fetched = await fetchRemoteMedia(mediaUrl, maxBytes);
+        return {
+            buffer: fetched.buffer,
+            contentType: fetched.contentType,
+            fileName: fetched.fileName,
+        };
+    }
+    // 展开 ~ 路径
+    if (mediaUrl.startsWith("~")) {
+        mediaUrl = resolveUserPath(mediaUrl);
+    }
+    // 本地文件：安全校验
+    await assertLocalMediaAllowed(mediaUrl, mediaLocalRoots);
+    // 读取本地文件
+    let data;
+    try {
+        const stat = await fs__namespace.stat(mediaUrl);
+        if (!stat.isFile()) {
+            throw new Error(`Local media path is not a file: ${mediaUrl}`);
+        }
+        data = await fs__namespace.readFile(mediaUrl);
+    }
+    catch (err) {
+        if (err?.code === "ENOENT") {
+            throw new Error(`Local media file not found: ${mediaUrl}`);
+        }
+        throw err;
+    }
+    if (maxBytes && data.length > maxBytes) {
+        throw new Error(`Local media exceeds max size (${data.length} > ${maxBytes})`);
+    }
+    const mime = await detectMime({ buffer: data, filePath: mediaUrl });
+    const fileName = path__namespace.basename(mediaUrl) || undefined;
+    return {
+        buffer: data,
+        contentType: mime,
+        fileName,
+    };
+}
+
+exports.assertLocalMediaAllowed = assertLocalMediaAllowed;
+exports.detectMime = detectMime;
+exports.loadOutboundMediaFromUrl = loadOutboundMediaFromUrl;

package/dist/cjs/src/media-storage.js

@@ -0,0 +1,165 @@
+'use strict';
+
+var fs = require('node:fs');
+var path = require('node:path');
+var fileType = require('file-type');
+
+function _interopNamespaceDefault(e) {
+    var n = Object.create(null);
+    if (e) {
+        Object.keys(e).forEach(function (k) {
+            if (k !== 'default') {
+                var d = Object.getOwnPropertyDescriptor(e, k);
+                Object.defineProperty(n, k, d.get ? d : {
+                    enumerable: true,
+                    get: function () { return e[k]; }
+                });
+            }
+        });
+    }
+    n.default = e;
+    return Object.freeze(n);
+}
+
+var fs__namespace = /*#__PURE__*/_interopNamespaceDefault(fs);
+var path__namespace = /*#__PURE__*/_interopNamespaceDefault(path);
+
+/**
+ * 本地文件媒体存储模块
+ *
+ * 替代 OpenClaw 的 core.channel.media.saveMediaBuffer
+ * 将媒体文件存储到本地文件系统，按日期/方向/类型组织目录
+ */
+// ============================================================================
+// 公开 API
+// ============================================================================
+/**
+ * 将媒体文件保存到本地文件系统
+ *
+ * 存储路径: {dataDir}/media/{direction}/{YYYY-MM-DD}/{filename}
+ *
+ * @param buffer - 文件数据
+ * @param contentType - 内容类型（如 image/jpeg）
+ * @param direction - 方向：inbound（入站）或 outbound（出站）
+ * @param maxBytes - 最大字节数限制
+ * @param originalFilename - 原始文件名（可选）
+ * @param dataDir - 数据目录路径
+ * @returns 保存结果
+ */
+async function saveMediaBuffer(buffer, contentType, direction, maxBytes, originalFilename, dataDir) {
+    // 大小检查
+    if (buffer.length > maxBytes) {
+        throw new Error(`Media file exceeds max size: ${buffer.length} bytes > ${maxBytes} bytes limit`);
+    }
+    // 如果 contentType 不够准确，尝试通过 buffer 嗅探
+    let finalContentType = contentType;
+    if (!contentType || contentType === "application/octet-stream") {
+        try {
+            const detected = await fileType.fileTypeFromBuffer(buffer);
+            if (detected?.mime) {
+                finalContentType = detected.mime;
+            }
+        }
+        catch {
+            // 嗅探失败，保持原始类型
+        }
+    }
+    // 生成文件名
+    // SDK downloadFile 返回的 filename 可能只是服务器内部标识（如 "aaaa"），没有扩展名，
+    // 此时根据 contentType 补上正确的扩展名，保证文件可被正确识别
+    const fileName = normalizeFileName(originalFilename, finalContentType);
+    // 构建存储路径
+    const dateStr = new Date().toISOString().slice(0, 10); // YYYY-MM-DD
+    const dirPath = path__namespace.join(dataDir, "media", direction, dateStr);
+    // 确保目录存在
+    if (!fs__namespace.existsSync(dirPath)) {
+        fs__namespace.mkdirSync(dirPath, { recursive: true });
+    }
+    // 避免文件名冲突
+    const uniqueFileName = ensureUniqueFileName(dirPath, fileName);
+    const filePath = path__namespace.join(dirPath, uniqueFileName);
+    // 写入文件
+    fs__namespace.writeFileSync(filePath, buffer);
+    return {
+        path: filePath,
+        contentType: finalContentType,
+        fileName: uniqueFileName,
+    };
+}
+// ============================================================================
+// 内部辅助函数
+// ============================================================================
+/**
+ * 规范化文件名：
+ * - 如果没有 originalFilename，自动生成带扩展名的文件名
+ * - 如果有 originalFilename 但缺少扩展名，根据 contentType 补上
+ */
+function normalizeFileName(originalFilename, contentType) {
+    if (!originalFilename) {
+        return generateFileName(contentType);
+    }
+    // 如果已有扩展名，直接使用
+    const ext = path__namespace.extname(originalFilename);
+    if (ext) {
+        return originalFilename;
+    }
+    // 没有扩展名，根据 contentType 补上
+    const inferredExt = mimeToExt(contentType);
+    return `${originalFilename}${inferredExt}`;
+}
+/**
+ * 根据 MIME 类型生成文件名
+ */
+function generateFileName(contentType) {
+    const ext = mimeToExt(contentType);
+    const rand = Math.random().toString(36).slice(2, 8);
+    return `media_${Date.now()}_${rand}${ext}`;
+}
+/**
+ * 确保文件名在目录中唯一
+ */
+function ensureUniqueFileName(dirPath, fileName) {
+    let candidate = fileName;
+    let counter = 1;
+    while (fs__namespace.existsSync(path__namespace.join(dirPath, candidate))) {
+        const ext = path__namespace.extname(fileName);
+        const base = path__namespace.basename(fileName, ext);
+        candidate = `${base}_${counter}${ext}`;
+        counter++;
+    }
+    return candidate;
+}
+/**
+ * MIME 类型转文件扩展名
+ */
+function mimeToExt(mime) {
+    const map = {
+        "image/jpeg": ".jpg",
+        "image/png": ".png",
+        "image/gif": ".gif",
+        "image/webp": ".webp",
+        "image/bmp": ".bmp",
+        "image/svg+xml": ".svg",
+        "image/heic": ".heic",
+        "image/heif": ".heif",
+        "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";
+}
+
+exports.saveMediaBuffer = saveMediaBuffer;

package/dist/cjs/src/media-uploader.js

@@ -0,0 +1,203 @@
+'use strict';
+
+var mediaLoader = require('./media-loader.js');
+var _const = require('./const.js');
+
+/**
+ * 出站媒体上传工具模块
+ *
+ * 负责：
+ * - 从 mediaUrl 加载文件 buffer（远程 URL 或本地路径均支持）
+ * - 检测 MIME 类型并映射为企微媒体类型
+ * - 文件大小检查与降级策略
+ * - 分片上传 + 发送
+ */
+// ============================================================================
+// MIME → 企微媒体类型映射
+// ============================================================================
+function detectWeComMediaType(mimeType) {
+    const mime = mimeType.toLowerCase();
+    if (mime.startsWith("image/"))
+        return "image";
+    if (mime.startsWith("video/"))
+        return "video";
+    if (mime.startsWith("audio/") || mime === "application/ogg")
+        return "voice";
+    return "file";
+}
+// ============================================================================
+// 媒体文件加载
+// ============================================================================
+async function resolveMediaFile(mediaUrl, mediaLocalRoots) {
+    const result = await mediaLoader.loadOutboundMediaFromUrl(mediaUrl, {
+        maxBytes: _const.ABSOLUTE_MAX_BYTES,
+        mediaLocalRoots,
+    });
+    if (!result.buffer || result.buffer.length === 0) {
+        throw new Error(`Failed to load media from ${mediaUrl}: empty buffer`);
+    }
+    let contentType = result.contentType || "application/octet-stream";
+    if (contentType === "application/octet-stream" || contentType === "text/plain") {
+        const detected = await mediaLoader.detectMime(result.buffer);
+        if (detected) {
+            contentType = detected;
+        }
+    }
+    const fileName = extractFileName(mediaUrl, result.fileName, contentType);
+    return { buffer: result.buffer, contentType, fileName };
+}
+// ============================================================================
+// 文件大小检查与降级
+// ============================================================================
+const VOICE_SUPPORTED_MIMES = new Set(["audio/amr"]);
+function applyFileSizeLimits(fileSize, detectedType, contentType) {
+    const fileSizeMB = (fileSize / (1024 * 1024)).toFixed(2);
+    if (fileSize > _const.ABSOLUTE_MAX_BYTES) {
+        return {
+            finalType: detectedType,
+            shouldReject: true,
+            rejectReason: `文件大小 ${fileSizeMB}MB 超过了企业微信私有部署允许的最大限制 20MB，无法发送。请尝试压缩文件或减小文件大小。`,
+            downgraded: false,
+        };
+    }
+    switch (detectedType) {
+        case "image":
+            if (fileSize > _const.IMAGE_MAX_BYTES) {
+                return {
+                    finalType: "file",
+                    shouldReject: false,
+                    downgraded: true,
+                    downgradeNote: `图片大小 ${fileSizeMB}MB 超过 10MB 限制，已转为文件格式发送`,
+                };
+            }
+            break;
+        case "video":
+            if (fileSize > _const.VIDEO_MAX_BYTES) {
+                return {
+                    finalType: "file",
+                    shouldReject: false,
+                    downgraded: true,
+                    downgradeNote: `视频大小 ${fileSizeMB}MB 超过 10MB 限制，已转为文件格式发送`,
+                };
+            }
+            break;
+        case "voice":
+            if (contentType && !VOICE_SUPPORTED_MIMES.has(contentType.toLowerCase())) {
+                return {
+                    finalType: "file",
+                    shouldReject: false,
+                    downgraded: true,
+                    downgradeNote: `语音格式 ${contentType} 不支持，企微仅支持 AMR 格式，已转为文件格式发送`,
+                };
+            }
+            if (fileSize > _const.VOICE_MAX_BYTES) {
+                return {
+                    finalType: "file",
+                    shouldReject: false,
+                    downgraded: true,
+                    downgradeNote: `语音大小 ${fileSizeMB}MB 超过 2MB 限制，已转为文件格式发送`,
+                };
+            }
+            break;
+    }
+    return { finalType: detectedType, shouldReject: false, downgraded: false };
+}
+// ============================================================================
+// 辅助函数
+// ============================================================================
+function extractFileName(mediaUrl, providedFileName, contentType) {
+    if (providedFileName)
+        return providedFileName;
+    try {
+        const urlObj = new URL(mediaUrl, "file://");
+        const pathParts = urlObj.pathname.split("/");
+        const lastPart = pathParts[pathParts.length - 1];
+        if (lastPart && lastPart.includes(".")) {
+            return decodeURIComponent(lastPart);
+        }
+    }
+    catch {
+        const parts = mediaUrl.split("/");
+        const lastPart = parts[parts.length - 1];
+        if (lastPart && lastPart.includes("."))
+            return lastPart;
+    }
+    const ext = mimeToExtension(contentType || "application/octet-stream");
+    return `media_${Date.now()}${ext}`;
+}
+function mimeToExtension(mime) {
+    const 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
+ */
+async function uploadAndSendMedia(options) {
+    const { wsClient, mediaUrl, chatId, mediaLocalRoots, log, errorLog } = options;
+    try {
+        log?.(`[wecom] Uploading media: url=${mediaUrl}`);
+        const media = await resolveMediaFile(mediaUrl, mediaLocalRoots);
+        const detectedType = detectWeComMediaType(media.contentType);
+        const sizeCheck = applyFileSizeLimits(media.buffer.length, detectedType, media.contentType);
+        if (sizeCheck.shouldReject) {
+            errorLog?.(`[wecom] Media rejected: ${sizeCheck.rejectReason}`);
+            return {
+                ok: false,
+                rejected: true,
+                rejectReason: sizeCheck.rejectReason,
+                finalType: sizeCheck.finalType,
+            };
+        }
+        const finalType = sizeCheck.finalType;
+        const uploadResult = await wsClient.uploadMedia(media.buffer, {
+            type: finalType,
+            filename: media.fileName,
+        });
+        log?.(`[wecom] Media uploaded: media_id=${uploadResult.media_id}, type=${finalType}`);
+        const result = await wsClient.sendMediaMessage(chatId, finalType, uploadResult.media_id);
+        const messageId = result?.headers?.req_id ?? `wecom-media-${Date.now()}`;
+        log?.(`[wecom] Media sent via sendMediaMessage: chatId=${chatId}, type=${finalType}`);
+        return {
+            ok: true,
+            messageId,
+            finalType,
+            downgraded: sizeCheck.downgraded,
+            downgradeNote: sizeCheck.downgradeNote,
+        };
+    }
+    catch (err) {
+        const errMsg = String(err);
+        errorLog?.(`[wecom] Failed to upload/send media: url=${mediaUrl}, error=${errMsg}`);
+        return { ok: false, error: errMsg };
+    }
+}
+
+exports.applyFileSizeLimits = applyFileSizeLimits;
+exports.detectWeComMediaType = detectWeComMediaType;
+exports.resolveMediaFile = resolveMediaFile;
+exports.uploadAndSendMedia = uploadAndSendMedia;