@wecom/wecom-openclaw-plugin 2026.3.20-beta.1 → 2026.3.20-beta.4

package/dist/index.esm.js

@@ -2666,6 +2666,8 @@ const wecomPlugin = {
 // ============================================================================
 /** HTTP 请求超时时间（毫秒） */
 const HTTP_REQUEST_TIMEOUT_MS = 30000;
+/** 媒体下载请求超时时间（毫秒），base64 编码的媒体文件最大可达 ~27MB */
+const MEDIA_DOWNLOAD_TIMEOUT_MS = 120000;
 /** 日志前缀 */
 const LOG_TAG = "[mcp]";
 /**
@@ -2772,9 +2774,9 @@ async function getMcpUrl(category) {
  * 自动携带 Mcp-Session-Id 请求头（如果有），
  * 并从响应头中更新 sessionId。
  */
-async function sendRawJsonRpc(url, session, body) {
+async function sendRawJsonRpc(url, session, body, timeoutMs = HTTP_REQUEST_TIMEOUT_MS) {
     const controller = new AbortController();
-    const timeoutId = setTimeout(() => controller.abort(), HTTP_REQUEST_TIMEOUT_MS);
+    const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
     const headers = {
         "Content-Type": "application/json",
         Accept: "application/json, text/event-stream",
@@ -2794,7 +2796,7 @@ async function sendRawJsonRpc(url, session, body) {
     }
     catch (err) {
         if (err instanceof DOMException && err.name === "AbortError") {
-            throw new Error(`MCP 请求超时 (${HTTP_REQUEST_TIMEOUT_MS}ms)`);
+            throw new Error(`MCP 请求超时 (${timeoutMs}ms)`);
         }
         throw new Error(`MCP 网络请求失败: ${err instanceof Error ? err.message : String(err)}`);
     }
@@ -2986,10 +2988,12 @@ function clearCategoryCache(category) {
  * @param category - MCP 品类名称
  * @param method - JSON-RPC 方法名
  * @param params - JSON-RPC 参数
+ * @param options - 可选配置（如自定义超时）
  * @returns JSON-RPC result
  */
-async function sendJsonRpc(category, method, params) {
+async function sendJsonRpc(category, method, params, options) {
     const url = await getMcpUrl(category);
+    const timeoutMs = options?.timeoutMs;
     const body = {
         jsonrpc: "2.0",
         id: generateReqId("mcp_rpc"),
@@ -2998,7 +3002,7 @@ async function sendJsonRpc(category, method, params) {
     };
     let session = await getOrCreateSession(url, category);
     try {
-        const { rpcResult, newSessionId } = await sendRawJsonRpc(url, session, body);
+        const { rpcResult, newSessionId } = await sendRawJsonRpc(url, session, body, timeoutMs);
         // 用最新的 sessionId 更新 session
         if (newSessionId) {
             session.sessionId = newSessionId;
@@ -3020,7 +3024,7 @@ async function sendJsonRpc(category, method, params) {
             mcpSessionCache.delete(category);
             // 使用 rebuildSession 合并并发的 session 重建请求，避免竞态条件
             session = await rebuildSession(url, category);
-            const { rpcResult, newSessionId } = await sendRawJsonRpc(url, session, body);
+            const { rpcResult, newSessionId } = await sendRawJsonRpc(url, session, body, timeoutMs);
             if (newSessionId) {
                 session.sessionId = newSessionId;
             }
@@ -3240,13 +3244,130 @@ const checkBizErrorAndClearCache = (result, category) => {
         }
     }
 };
+// ============================================================================
+// get_msg_media 响应拦截：base64 → 本地文件
+// ============================================================================
+/**
+ * 拦截 get_msg_media 的 MCP 响应
+ *
+ * 核心逻辑：
+ * 1. 从 MCP result 的 content[].text 中提取业务 JSON
+ * 2. 提取 media_item.base64_data，解码为 Buffer
+ * 3. 通过 openclaw SDK 的 saveMediaBuffer 保存到本地媒体目录
+ * 4. 替换响应：移除 base64_data，加入 local_path
+ *
+ * 这样大模型只看到轻量的文件路径信息，不会被 base64 数据消耗 token。
+ */
+async function interceptMediaResponse(result) {
+    const t0 = performance.now();
+    // 1. 提取 MCP result 中的 content 数组
+    const content = result?.content;
+    if (!Array.isArray(content))
+        return result;
+    const textItem = content.find((c) => c.type === "text" && typeof c.text === "string");
+    if (!textItem)
+        return result;
+    // 2. 解析业务 JSON
+    let bizData;
+    try {
+        bizData = JSON.parse(textItem.text);
+    }
+    catch {
+        // 非 JSON 格式，原样返回
+        return result;
+    }
+    // 3. 校验业务响应：errcode !== 0 或无 media_item 时原样返回
+    if (bizData.errcode !== 0)
+        return result;
+    const mediaItem = bizData.media_item;
+    if (!mediaItem || typeof mediaItem.base64_data !== "string")
+        return result;
+    const base64Data = mediaItem.base64_data;
+    const mediaName = mediaItem.name;
+    const mediaType = mediaItem.type;
+    const mediaId = mediaItem.media_id;
+    const tParsed = performance.now();
+    // 4. 解码 base64 → Buffer
+    const buffer = Buffer.from(base64Data, "base64");
+    const tDecoded = performance.now();
+    // 5. 检测 contentType，并通过 saveMediaBuffer 保存到本地媒体目录
+    const contentType = await detectMime({ buffer, filePath: mediaName }) ?? "application/octet-stream";
+    const tMimeDetected = performance.now();
+    const core = getWeComRuntime();
+    const saved = await core.channel.media.saveMediaBuffer(buffer, contentType, "inbound", undefined, // maxBytes: 使用 saveMediaBuffer 内部默认值
+    mediaName);
+    // 5.1 补偿：核心库 EXT_BY_MIME 可能缺少某些格式映射（如 audio/amr），
+    //     导致保存的文件没有后缀。此处检测并修复。
+    const MIME_EXT_PATCH = {
+        "audio/amr": ".amr",
+    };
+    const patchExt = MIME_EXT_PATCH[contentType];
+    if (patchExt && !path.extname(saved.path)) {
+        const newPath = saved.path + patchExt;
+        try {
+            await fs.rename(saved.path, newPath);
+            saved.path = newPath;
+        }
+        catch {
+            // rename 失败不影响主流程，文件仍可用
+        }
+    }
+    const tSaved = performance.now();
+    // 6. 构造精简响应，移除 base64_data，加入本地路径
+    const newBizData = {
+        errcode: 0,
+        errmsg: "ok",
+        media_item: {
+            media_id: mediaId,
+            name: mediaName ?? saved.path.split("/").pop(),
+            type: mediaType,
+            local_path: saved.path,
+            size: buffer.length,
+            content_type: saved.contentType,
+        },
+    };
+    const tEnd = performance.now();
+    // 耗时日志：各环节耗时（ms）
+    console.log(`[mcp] get_msg_media 拦截成功: media_id=${mediaId ?? "unknown"}, ` +
+        `type=${mediaType ?? "unknown"}, size=${buffer.length}, saved=${saved.path}\n` +
+        `  ⏱ 耗时明细 (总 ${(tEnd - t0).toFixed(1)}ms):\n` +
+        `    解析响应 JSON:   ${(tParsed - t0).toFixed(1)}ms\n` +
+        `    base64 解码:     ${(tDecoded - tParsed).toFixed(1)}ms  (${(base64Data.length / 1024).toFixed(0)}KB base64 → ${(buffer.length / 1024).toFixed(0)}KB buffer)\n` +
+        `    MIME 检测:       ${(tMimeDetected - tDecoded).toFixed(1)}ms  (${contentType})\n` +
+        `    saveMediaBuffer: ${(tSaved - tMimeDetected).toFixed(1)}ms\n` +
+        `    构造响应:        ${(tEnd - tSaved).toFixed(1)}ms`);
+    // 7. 返回修改后的 MCP result 结构
+    return {
+        content: [{
+                type: "text",
+                text: JSON.stringify(newBizData),
+            }],
+    };
+}
+// ============================================================================
+// call 操作：调用某品类的某个 MCP 工具
+// ============================================================================
 const handleCall = async (category, method, args) => {
+    const callStart = performance.now();
+    // get_msg_media 使用延长的超时时间（120s），因为返回的 base64 数据可达 ~27MB
+    const options = method === "get_msg_media" ? { timeoutMs: MEDIA_DOWNLOAD_TIMEOUT_MS } : undefined;
     const result = await sendJsonRpc(category, "tools/call", {
         name: method,
         arguments: args,
-    });
+    }, options);
+    const rpcDone = performance.now();
+    const rpcMs = (rpcDone - callStart).toFixed(1);
     // 检查业务层错误码，必要时清理缓存
     checkBizErrorAndClearCache(result, category);
+    // 对 get_msg_media 响应进行 base64 拦截：解码存本地，只返回路径给大模型
+    if (method === "get_msg_media") {
+        const intercepted = await interceptMediaResponse(result);
+        const totalMs = (performance.now() - callStart).toFixed(1);
+        console.log(`[mcp] handleCall ${category}/${method} 总耗时: ${totalMs}ms` +
+            ` (MCP请求: ${rpcMs}ms, 拦截处理: ${(performance.now() - rpcDone).toFixed(1)}ms)`);
+        return intercepted;
+    }
+    console.log(`[mcp] handleCall ${category}/${method} 耗时: ${rpcMs}ms`);
     return result;
 };
 // ============================================================================
@@ -3363,51 +3484,7 @@ const plugin = {
             }
             return {
                 appendSystemContext: [
-                    "## MEDIA 指令：向用户发送本地文件",
-                    "",
-                    "当需要向用户发送图片、视频、语音或文件时，在回复中使用 `MEDIA:` 指令。系统会自动识别文件类型，以对应的消息格式（图片/视频/语音/文件消息）发送。",
-                    "",
-                    "### 语法",
-                    "",
-                    "```",
-                    "MEDIA: <本地文件绝对路径>",
-                    "```",
-                    "",
-                    "### 规则",
-                    "",
-                    "1. 如果文件路径前已经有 `MEDIA:` 指令，无需再重复添加，保持原样即可",
-                    "2. `MEDIA:` 必须置于行首，与路径之间用一个空格分隔",
-                    "3. 路径必须为本地文件的绝对路径（支持 `~` 展开），不支持 URL",
-                    "4. 路径含空格时用反引号包裹：MEDIA: `/path/to/my file.png`",
-                    "5. 每个文件独占一行，不可在同一行发送多个文件",
-                    "6. 可在 `MEDIA:` 指令前后附加文字说明，文字与指令各占独立行",
-                    "",
-                    "### 文件存放",
-                    "",
-                    "生成的文件优先存放至 `~/.openclaw/workspace/` 目录。",
-                    "",
-                    "### 大小与格式限制",
-                    "",
-                    "| 类型 | 上限 | 格式要求 |",
-                    "|------|------|----------|",
-                    "| 图片 | 10MB | 常见图片格式 |",
-                    "| 视频 | 10MB | 常见视频格式 |",
-                    "| 语音 | 2MB  | 仅 AMR（.amr） |",
-                    "| 文件 | 20MB | 不限 |",
-                    "",
-                    "- 图片/视频/语音超出各自上限时，系统自动降级为文件消息发送，请主动告知用户。",
-                    "- 文件超过 20MB 无法发送，请告知用户并尝试压缩或拆分。",
-                    "- 非 AMR 格式的音频会以文件消息发送。",
-                    "",
-                    "### 示例",
-                    "",
-                    "```",
-                    "以下是生成的图表：",
-                    "MEDIA: ~/.openclaw/workspace/output.png",
-                    "",
-                    "报告已生成，请查收：",
-                    "MEDIA: ~/.openclaw/workspace/report.pdf",
-                    "```",
+                    "重要：涉及发送图片/视频/语音/文件给用户时，请务必使用 `MEDIA：` 指令。详见  wecom-send-media 这个 skill（技能）。"
                 ].join("\n"),
             };
         });