@wecom/wecom-openclaw-plugin 2026.3.30 → 2026.3.31-beta.1

package/dist/src/mcp/interceptors/smartpage-export.js

@@ -0,0 +1,87 @@
+/**
+ * smartpage_get_export_result 响应拦截器
+ *
+ * 核心逻辑：
+ * MCP Server 返回的 smartpage_get_export_result 响应中，当 task_done=true 时
+ * 会包含 content 字段（markdown 文本内容）。该内容可能很大，直接返回给 LLM
+ * 会消耗大量 token。
+ *
+ * 本拦截器在 afterCall 阶段：
+ * 1. 检测 task_done=true 且存在 content 字段
+ * 2. 将 content 保存到本地文件（使用与 msg-media 一致的媒体目录）
+ * 3. 用 content_path（文件路径）替换 content 字段
+ *
+ * 这样 LLM 只看到轻量的文件路径信息，Skill 可通过文件路径读取完整内容。
+ */
+import { getWeComRuntime } from "../../runtime.js";
+// ============================================================================
+// 拦截器实现
+// ============================================================================
+export const smartpageExportInterceptor = {
+    name: "smartpage-export",
+    /** 仅对 doc 品类的 smartpage_get_export_result 方法生效 */
+    match: (ctx) => ctx.category === "doc" && ctx.method === "smartpage_get_export_result",
+    /** 拦截响应：将 markdown content 保存为本地文件 */
+    async afterCall(_ctx, result) {
+        return interceptExportResponse(result);
+    },
+};
+// ============================================================================
+// 内部实现
+// ============================================================================
+/**
+ * 拦截 smartpage_get_export_result 的 MCP 响应
+ *
+ * 1. 从 MCP result 的 content[].text 中提取业务 JSON
+ * 2. 检测 task_done=true 且存在 content 字段
+ * 3. 将 content（markdown 文本）通过 saveMediaBuffer 保存到本地媒体目录
+ * 4. 构造新响应：移除 content，添加 content_path
+ */
+async function interceptExportResponse(result) {
+    // 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 或 task_done 不为 true 或无 content 时原样返回
+    if (bizData.errcode !== 0)
+        return result;
+    if (bizData.task_done !== true)
+        return result;
+    if (typeof bizData.content !== "string")
+        return result;
+    const markdownContent = bizData.content;
+    console.log(`[mcp] smartpage_get_export_result: 拦截 content (${markdownContent.length} chars)，保存到本地文件`);
+    // 4. 将 markdown 内容通过 saveMediaBuffer 保存到本地媒体目录
+    //    使用 text/markdown 类型，与 msg-media 拦截器保持一致的路径管理
+    const buffer = Buffer.from(markdownContent, "utf-8");
+    const core = getWeComRuntime();
+    const saved = await core.channel.media.saveMediaBuffer(buffer, "text/markdown", "inbound", undefined, // maxBytes: markdown 文本通常不大，使用默认限制
+    "smartpage_export.md");
+    console.log(`[mcp] smartpage_get_export_result: 已保存到 ${saved.path}`);
+    // 5. 构造新响应：移除 content，添加 content_path
+    const newBizData = {
+        errcode: bizData.errcode,
+        errmsg: bizData.errmsg ?? "ok",
+        task_done: true,
+        content_path: saved.path,
+    };
+    // 6. 返回修改后的 MCP result 结构
+    return {
+        content: [{
+                type: "text",
+                text: JSON.stringify(newBizData),
+            }],
+    };
+}

package/dist/src/mcp/interceptors/types.js

@@ -0,0 +1,7 @@
+/**
+ * MCP call 拦截器类型定义
+ *
+ * 拦截器用于在 tools/call 调用前后注入特殊逻辑，
+ * 如修改超时配置、变换响应结果等，避免在 tool.ts 中堆积 if/else。
+ */
+export {};

package/dist/src/mcp/schema.js

@@ -0,0 +1,99 @@
+/**
+ * MCP Schema 清洗模块
+ *
+ * 负责内联 $ref/$defs 引用并移除 Gemini 不支持的 JSON Schema 关键词，
+ * 防止 Gemini 模型解析 function response 时报 400 错误。
+ */
+/** Gemini 不支持的 JSON Schema 关键词 */
+const GEMINI_UNSUPPORTED_KEYWORDS = new Set([
+    "patternProperties", "additionalProperties", "$schema", "$id", "$ref", "$defs",
+    "definitions", "examples", "minLength", "maxLength", "minimum", "maximum",
+    "multipleOf", "pattern", "format", "minItems", "maxItems", "uniqueItems",
+    "minProperties", "maxProperties",
+]);
+/**
+ * 清洗 JSON Schema，内联 $ref 引用并移除 Gemini 不支持的关键词，
+ * 防止 Gemini 模型解析 function response 时报 400 错误。
+ */
+export function cleanSchemaForGemini(schema) {
+    if (!schema || typeof schema !== "object")
+        return schema;
+    if (Array.isArray(schema))
+        return schema.map(cleanSchemaForGemini);
+    const obj = schema;
+    // 收集 $defs/definitions 用于后续 $ref 内联解析
+    const defs = {
+        ...(obj.$defs && typeof obj.$defs === "object" ? obj.$defs : {}),
+        ...(obj.definitions && typeof obj.definitions === "object" ? obj.definitions : {}),
+    };
+    return cleanWithDefs(obj, defs, new Set());
+}
+function cleanWithDefs(schema, defs, refStack) {
+    if (!schema || typeof schema !== "object")
+        return schema;
+    if (Array.isArray(schema))
+        return schema.map((item) => cleanWithDefs(item, defs, refStack));
+    const obj = schema;
+    // 合并当前层级的 $defs/definitions 到 defs 中
+    if (obj.$defs && typeof obj.$defs === "object") {
+        Object.assign(defs, obj.$defs);
+    }
+    if (obj.definitions && typeof obj.definitions === "object") {
+        Object.assign(defs, obj.definitions);
+    }
+    // 处理 $ref 引用：尝试内联解析
+    if (typeof obj.$ref === "string") {
+        const ref = obj.$ref;
+        if (refStack.has(ref))
+            return {}; // 防止循环引用
+        const match = ref.match(/^#\/(?:\$defs|definitions)\/(.+)$/);
+        if (match && match[1] && defs[match[1]]) {
+            const nextStack = new Set(refStack);
+            nextStack.add(ref);
+            return cleanWithDefs(defs[match[1]], defs, nextStack);
+        }
+        return {}; // 无法解析的 $ref，返回空对象
+    }
+    const cleaned = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (GEMINI_UNSUPPORTED_KEYWORDS.has(key))
+            continue;
+        if (key === "const") {
+            cleaned.enum = [value];
+            continue;
+        }
+        if (key === "properties" && value && typeof value === "object" && !Array.isArray(value)) {
+            cleaned[key] = Object.fromEntries(Object.entries(value).map(([k, v]) => [
+                k, cleanWithDefs(v, defs, refStack),
+            ]));
+        }
+        else if (key === "items" && value) {
+            cleaned[key] = Array.isArray(value)
+                ? value.map((item) => cleanWithDefs(item, defs, refStack))
+                : cleanWithDefs(value, defs, refStack);
+        }
+        else if ((key === "anyOf" || key === "oneOf" || key === "allOf") && Array.isArray(value)) {
+            // 过滤掉 null 类型的变体
+            const nonNull = value.filter((v) => {
+                if (!v || typeof v !== "object")
+                    return true;
+                const r = v;
+                return r.type !== "null";
+            });
+            if (nonNull.length === 1) {
+                // 只剩一个变体时直接内联
+                const single = cleanWithDefs(nonNull[0], defs, refStack);
+                if (single && typeof single === "object" && !Array.isArray(single)) {
+                    Object.assign(cleaned, single);
+                }
+            }
+            else {
+                cleaned[key] = nonNull.map((v) => cleanWithDefs(v, defs, refStack));
+            }
+        }
+        else {
+            cleaned[key] = value;
+        }
+    }
+    return cleaned;
+}

package/dist/src/mcp/tool.js

@@ -0,0 +1,202 @@
+/**
+ * wecom_mcp — 模拟 MCP 调用的 Agent Tool
+ *
+ * 通过 MCP Streamable HTTP 传输协议调用企业微信 MCP Server，
+ * 提供 list（列出所有工具）和 call（调用工具）两个操作。
+ *
+ * 在 skills 中的使用方式：
+ *   wecom_mcp list <category>
+ *   wecom_mcp call <category> <method> '<jsonArgs>'
+ *
+ * 示例：
+ *   wecom_mcp list contact
+ *   wecom_mcp call contact getContact '{}'
+ */
+import { sendJsonRpc } from "./transport.js";
+import { cleanSchemaForGemini } from "./schema.js";
+import { resolveBeforeCall, runAfterCall } from "./interceptors/index.js";
+// ============================================================================
+// 响应构造辅助
+// ============================================================================
+/** 构造统一的文本响应结构 */
+const textResult = (data) => ({
+    content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+});
+/** 构造错误响应 */
+const errorResult = (err) => {
+    // 适配企业微信 API 返回的 { errcode, errmsg } 结构
+    if (err && typeof err === "object" && "errcode" in err) {
+        const { errcode, errmsg } = err;
+        return textResult({ error: errmsg ?? `错误码: ${errcode}`, errcode });
+    }
+    const message = err instanceof Error ? err.message : String(err);
+    return textResult({ error: message });
+};
+// ============================================================================
+// list 操作：列出某品类的所有 MCP 工具
+// ============================================================================
+const handleList = async (category) => {
+    const result = await sendJsonRpc(category, "tools/list");
+    const tools = result?.tools ?? [];
+    if (tools.length === 0) {
+        return { message: `品类 "${category}" 下暂无可用工具`, tools: [] };
+    }
+    return {
+        category,
+        count: tools.length,
+        tools: tools.map((t) => ({
+            name: t.name,
+            description: t.description ?? "",
+            // 清洗 inputSchema，内联 $ref/$defs 引用并移除 Gemini 不支持的关键词，
+            // 避免 Gemini 模型解析 function response 时报 400 错误
+            inputSchema: t.inputSchema ? cleanSchemaForGemini(t.inputSchema) : undefined,
+        })),
+    };
+};
+// ============================================================================
+// call 操作：调用某品类的某个 MCP 工具
+// ============================================================================
+const handleCall = async (category, method, args) => {
+    const ctx = { category, method, args };
+    const callStart = performance.now();
+    console.log(`[mcp] handleCall ${category}/${method} 入参: ${JSON.stringify(args)}`);
+    // 1. 收集拦截器的 beforeCall 配置（如超时时间、替换 args）
+    const { options, args: resolvedArgs } = await resolveBeforeCall(ctx);
+    const finalArgs = resolvedArgs ?? args;
+    if (resolvedArgs) {
+        console.log(`[mcp] handleCall ${category}/${method} 拦截器替换 args: ${JSON.stringify(resolvedArgs).slice(0, 500)}` +
+            (JSON.stringify(resolvedArgs).length > 500 ? "...(truncated)" : ""));
+    }
+    if (options) {
+        console.log(`[mcp] handleCall ${category}/${method} 拦截器选项: ${JSON.stringify(options)}`);
+    }
+    // 2. 执行 MCP 调用
+    const result = await sendJsonRpc(category, "tools/call", {
+        name: method,
+        arguments: finalArgs,
+    }, options);
+    const rpcDone = performance.now();
+    const rpcMs = (rpcDone - callStart).toFixed(1);
+    const resultStr = JSON.stringify(result);
+    console.log(`[mcp] handleCall ${category}/${method} MCP 响应 (${rpcMs}ms): ${resultStr.slice(0, 800)}` +
+        (resultStr.length > 800 ? "...(truncated)" : ""));
+    // 3. 管道式执行 afterCall 拦截器（业务错误码检查、响应变换等）
+    const finalResult = await runAfterCall(ctx, result);
+    const totalMs = (performance.now() - callStart).toFixed(1);
+    const interceptMs = (performance.now() - rpcDone).toFixed(1);
+    // 有拦截器处理时打印详细耗时，否则只打印 RPC 耗时
+    if (finalResult !== result) {
+        const finalStr = JSON.stringify(finalResult);
+        console.log(`[mcp] handleCall ${category}/${method} afterCall 变换后 (${interceptMs}ms): ${finalStr.slice(0, 500)}` +
+            (finalStr.length > 500 ? "...(truncated)" : ""));
+        console.log(`[mcp] handleCall ${category}/${method} 总耗时: ${totalMs}ms` +
+            ` (MCP请求: ${rpcMs}ms, 拦截处理: ${interceptMs}ms)`);
+    }
+    else {
+        console.log(`[mcp] handleCall ${category}/${method} 耗时: ${rpcMs}ms`);
+    }
+    return finalResult;
+};
+// ============================================================================
+// 参数解析
+// ============================================================================
+/**
+ * 解析 args 参数：支持 JSON 字符串或直接的对象
+ */
+const parseArgs = (args) => {
+    if (!args)
+        return {};
+    if (typeof args === "object")
+        return args;
+    try {
+        return JSON.parse(args);
+    }
+    catch (err) {
+        const detail = err instanceof SyntaxError ? err.message : String(err);
+        throw new Error(`args 参数不是合法的 JSON: ${args} (${detail})`);
+    }
+};
+// ============================================================================
+// 工具定义 & 导出
+// ============================================================================
+/**
+ * 创建 wecom_mcp Agent Tool 定义
+ */
+export function createWeComMcpTool() {
+    return {
+        name: "wecom_mcp",
+        label: "企业微信 MCP 工具",
+        description: [
+            "通过 HTTP 直接调用企业微信 MCP Server。",
+            "支持两种操作：",
+            "  - list: 列出指定品类的所有 MCP 工具",
+            "  - call: 调用指定品类的某个 MCP 工具",
+            "",
+            "使用方式：",
+            "  wecom_mcp list <category>",
+            "  wecom_mcp call <category> <method> '<jsonArgs>'",
+            "",
+            "示例：",
+            "  列出 contact 品类所有工具：wecom_mcp list contact",
+            "  调用 contact 的 getContact：wecom_mcp call contact getContact '{}'",
+        ].join("\n"),
+        parameters: {
+            type: "object",
+            properties: {
+                action: {
+                    type: "string",
+                    enum: ["list", "call"],
+                    description: "操作类型：list（列出工具）或 call（调用工具）",
+                },
+                category: {
+                    type: "string",
+                    description: "MCP 品类名称，如 doc、contact 等，对应 mcpConfig 中的 key",
+                },
+                method: {
+                    type: "string",
+                    description: "要调用的 MCP 方法名（action=call 时必填）",
+                },
+                args: {
+                    type: ["string", "object"],
+                    description: "调用 MCP 方法的参数，可以是 JSON 字符串或对象（action=call 时使用，默认 {}）",
+                },
+            },
+            required: ["action", "category"],
+        },
+        async execute(_toolCallId, params) {
+            const p = params;
+            console.log(`[mcp] execute: action=${p.action}, category=${p.category}` +
+                (p.method ? `, method=${p.method}` : "") +
+                (p.args ? `, args=${typeof p.args === "string" ? p.args : JSON.stringify(p.args)}` : ""));
+            try {
+                let result;
+                switch (p.action) {
+                    case "list":
+                        result = textResult(await handleList(p.category));
+                        break;
+                    case "call": {
+                        if (!p.method) {
+                            result = textResult({ error: "action 为 call 时必须提供 method 参数" });
+                            break;
+                        }
+                        const args = parseArgs(p.args);
+                        result = textResult(await handleCall(p.category, p.method, args));
+                        break;
+                    }
+                    default:
+                        result = textResult({ error: `未知操作类型: ${String(p.action)}，支持 list 和 call` });
+                }
+                console.log(`[mcp] execute: action=${p.action}, category=${p.category}` +
+                    (p.method ? `, method=${p.method}` : "") +
+                    ` → 响应长度=${result.content[0].text.length} chars`);
+                return result;
+            }
+            catch (err) {
+                console.error(`[mcp] execute: action=${p.action}, category=${p.category}` +
+                    (p.method ? `, method=${p.method}` : "") +
+                    ` → 异常: ${err instanceof Error ? err.message : String(err)}`);
+                return errorResult(err);
+            }
+        },
+    };
+}