ylib-wecom-openclaw-plugin 2026.4.29

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

@@ -0,0 +1,252 @@
+"use strict";
+/**
+ * smartpage_create 请求拦截器
+ *
+ * 核心逻辑：
+ * smartpage_create 的 pages 数组中，每个 page 可能包含 page_filepath 字段
+ * （指向本地 markdown 文件），用于避免在命令行传递大段文本内容。
+ * 本拦截器在 beforeCall 阶段遍历 pages 数组，逐个读取 page_filepath
+ * 指向的本地文件内容，填入 page_content 字段，并移除 page_filepath。
+ *
+ * 入参约定：
+ *   wecom_mcp call doc smartpage_create '{
+ *     "title": "主页标题",
+ *     "pages": [
+ *       {"page_title": "页面1", "page_filepath": "/tmp/page1.md", "content_type": "markdown"},
+ *       {"page_title": "页面2", "page_filepath": "/tmp/page2.md", "content_type": "markdown"}
+ *     ]
+ *   }'
+ *
+ * 拦截器行为：
+ *   1. 检测 args.pages 数组
+ *   2. 校验文件大小：单文件不超过 10MB，所有文件总计不超过 20MB
+ *   3. 遍历每个 page，若存在 page_filepath 则读取本地文件内容
+ *   4. 将文件内容填入 page_content 字段，移除 page_filepath
+ *   5. 返回修改后的完整 args
+ *
+ * 传给 MCP Server 的格式：
+ *   { "title": "...", "pages": [{"page_title": "...", "page_content": "...", "content_type": "..."}] }
+ */
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+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 };
+    }
+};
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+exports.__esModule = true;
+exports.smartpageCreateInterceptor = void 0;
+var fs = __importStar(require("node:fs/promises"));
+// ============================================================================
+// 常量
+// ============================================================================
+/** 单个 page_filepath 文件大小上限：10MB */
+var MAX_SINGLE_FILE_SIZE = 10 * 1024 * 1024;
+/** 所有 page_filepath 文件总大小上限：20MB */
+var MAX_TOTAL_FILE_SIZE = 20 * 1024 * 1024;
+// ============================================================================
+// 内部辅助函数
+// ============================================================================
+/**
+ * 校验所有 page_filepath 的文件大小
+ *
+ * 使用 fs.stat 在读取文件内容之前检查大小，避免超大文件被加载到内存。
+ * - 单文件 > 10MB → 报错
+ * - 所有文件累计 > 20MB → 报错
+ */
+function validateFileSize(pages) {
+    return __awaiter(this, void 0, void 0, function () {
+        var totalSize, i, filePath, stat, err_1;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    totalSize = 0;
+                    i = 0;
+                    _a.label = 1;
+                case 1:
+                    if (!(i < pages.length)) return [3 /*break*/, 7];
+                    filePath = pages[i].page_filepath;
+                    if (typeof filePath !== "string" || !filePath)
+                        return [3 /*break*/, 6];
+                    stat = void 0;
+                    _a.label = 2;
+                case 2:
+                    _a.trys.push([2, 4, , 5]);
+                    return [4 /*yield*/, fs.stat(filePath)];
+                case 3:
+                    stat = _a.sent();
+                    return [3 /*break*/, 5];
+                case 4:
+                    err_1 = _a.sent();
+                    // stat 失败不在这里处理，留给后续 readFile 阶段抛出更详细的错误
+                    return [3 /*break*/, 6];
+                case 5:
+                    if (stat.size > MAX_SINGLE_FILE_SIZE) {
+                        console.error("[mcp] smartpage_create: pages[" + i + "] \u6587\u4EF6 \"" + filePath + "\" " +
+                            ("\u5927\u5C0F " + (stat.size / 1024 / 1024).toFixed(1) + "MB \u8D85\u8FC7\u5355\u6587\u4EF6\u4E0A\u9650 10MB"));
+                        throw new Error("内容大小超出限制，无法创建");
+                    }
+                    totalSize += stat.size;
+                    if (totalSize > MAX_TOTAL_FILE_SIZE) {
+                        console.error("[mcp] smartpage_create: \u7D2F\u8BA1\u6587\u4EF6\u5927\u5C0F " + (totalSize / 1024 / 1024).toFixed(1) + "MB " +
+                            ("\u8D85\u8FC7\u603B\u4E0A\u9650 20MB\uFF08\u5728 pages[" + i + "] \"" + filePath + "\" \u5904\u8D85\u51FA\uFF09"));
+                        throw new Error("内容大小超出限制，无法创建");
+                    }
+                    _a.label = 6;
+                case 6:
+                    i++;
+                    return [3 /*break*/, 1];
+                case 7:
+                    if (totalSize > 0) {
+                        console.log("[mcp] smartpage_create: \u6587\u4EF6\u5927\u5C0F\u6821\u9A8C\u901A\u8FC7\uFF0C\u603B\u8BA1 " + (totalSize / 1024 / 1024).toFixed(2) + "MB");
+                    }
+                    return [2 /*return*/];
+            }
+        });
+    });
+}
+/** 异步解析 pages 中的 page_filepath，返回 BeforeCallOptions */
+function resolvePages(ctx, pages) {
+    return __awaiter(this, void 0, void 0, function () {
+        var resolvedPages;
+        var _this = this;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    console.log("[mcp] smartpage_create: \u5F00\u59CB\u89E3\u6790 " + pages.length + " \u4E2A page \u7684 page_filepath");
+                    // 阶段 1：文件大小校验（stat 阶段，不读内容）
+                    return [4 /*yield*/, validateFileSize(pages)];
+                case 1:
+                    // 阶段 1：文件大小校验（stat 阶段，不读内容）
+                    _a.sent();
+                    return [4 /*yield*/, Promise.all(pages.map(function (page, index) { return __awaiter(_this, void 0, void 0, function () {
+                            var filePath, fileContent, err_2, _, rest;
+                            return __generator(this, function (_a) {
+                                switch (_a.label) {
+                                    case 0:
+                                        filePath = page.page_filepath;
+                                        if (typeof filePath !== "string" || !filePath) {
+                                            // 该 page 没有 page_filepath，保留原样（可能已有 page_content）
+                                            return [2 /*return*/, page];
+                                        }
+                                        _a.label = 1;
+                                    case 1:
+                                        _a.trys.push([1, 3, , 4]);
+                                        return [4 /*yield*/, fs.readFile(filePath, "utf-8")];
+                                    case 2:
+                                        fileContent = _a.sent();
+                                        return [3 /*break*/, 4];
+                                    case 3:
+                                        err_2 = _a.sent();
+                                        throw new Error("smartpage_create: pages[" + index + "] \u65E0\u6CD5\u8BFB\u53D6\u6587\u4EF6 \"" + filePath + "\": " + (err_2 instanceof Error ? err_2.message : String(err_2)));
+                                    case 4:
+                                        console.log("[mcp] smartpage_create: pages[" + index + "] \u8BFB\u53D6\u6210\u529F \"" + filePath + "\" (" + fileContent.length + " chars)");
+                                        _ = page.page_filepath, rest = __rest(page, ["page_filepath"]);
+                                        return [2 /*return*/, __assign(__assign({}, rest), { page_content: fileContent })];
+                                }
+                            });
+                        }); }))];
+                case 2:
+                    resolvedPages = _a.sent();
+                    console.log("[mcp] smartpage_create: \u6240\u6709 page_filepath \u89E3\u6790\u5B8C\u6210");
+                    // 返回修改后的完整 args
+                    return [2 /*return*/, {
+                            args: __assign(__assign({}, ctx.args), { pages: resolvedPages })
+                        }];
+            }
+        });
+    });
+}
+// ============================================================================
+// 拦截器实现
+// ============================================================================
+exports.smartpageCreateInterceptor = {
+    name: "smartpage-create",
+    /** 仅对 doc 品类的 smartpage_create 方法生效 */
+    match: function (ctx) { return ctx.category === "doc" && ctx.method === "smartpage_create"; },
+    /** 遍历 pages 数组，逐个读取 page_filepath 填入 page_content */
+    beforeCall: function (ctx) {
+        var pages = ctx.args.pages;
+        if (!Array.isArray(pages) || pages.length === 0) {
+            // 没有 pages 数组，不做拦截
+            return undefined;
+        }
+        // 检查是否有任何 page 包含 page_filepath
+        var hasFilePath = pages.some(function (p) { return typeof p.page_filepath === "string" && p.page_filepath; });
+        if (!hasFilePath) {
+            // 所有 page 都没有 page_filepath（可能直接传了 page_content），不做拦截
+            return undefined;
+        }
+        return resolvePages(ctx, pages);
+    }
+};

package/dist/src/mcp/interceptors/smartpage-export.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 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 type { CallInterceptor } from "./types.js";
+export declare const smartpageExportInterceptor: CallInterceptor;

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

@@ -0,0 +1,135 @@
+"use strict";
+/**
+ * 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 可通过文件路径读取完整内容。
+ */
+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.smartpageExportInterceptor = void 0;
+var runtime_js_1 = require("../../runtime.js");
+// ============================================================================
+// 拦截器实现
+// ============================================================================
+exports.smartpageExportInterceptor = {
+    name: "smartpage-export",
+    /** 仅对 doc 品类的 smartpage_get_export_result 方法生效 */
+    match: function (ctx) { return ctx.category === "doc" && ctx.method === "smartpage_get_export_result"; },
+    /** 拦截响应：将 markdown content 保存为本地文件 */
+    afterCall: function (_ctx, result) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                return [2 /*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
+ */
+function interceptExportResponse(result) {
+    var _a, _b;
+    return __awaiter(this, void 0, void 0, function () {
+        var content, textItem, bizData, markdownContent, buffer, core, saved, newBizData;
+        return __generator(this, function (_c) {
+            switch (_c.label) {
+                case 0:
+                    content = (_a = result) === null || _a === void 0 ? void 0 : _a.content;
+                    if (!Array.isArray(content))
+                        return [2 /*return*/, result];
+                    textItem = content.find(function (c) { return c.type === "text" && typeof c.text === "string"; });
+                    if (!textItem)
+                        return [2 /*return*/, result];
+                    try {
+                        bizData = JSON.parse(textItem.text);
+                    }
+                    catch (_d) {
+                        // 非 JSON 格式，原样返回
+                        return [2 /*return*/, result];
+                    }
+                    // 3. 校验：errcode !== 0 或 task_done 不为 true 或无 content 时原样返回
+                    if (bizData.errcode !== 0)
+                        return [2 /*return*/, result];
+                    if (bizData.task_done !== true)
+                        return [2 /*return*/, result];
+                    if (typeof bizData.content !== "string")
+                        return [2 /*return*/, result];
+                    markdownContent = bizData.content;
+                    console.log("[mcp] smartpage_get_export_result: \u62E6\u622A content (" + markdownContent.length + " chars)\uFF0C\u4FDD\u5B58\u5230\u672C\u5730\u6587\u4EF6");
+                    buffer = Buffer.from(markdownContent, "utf-8");
+                    core = runtime_js_1.getWeComRuntime();
+                    return [4 /*yield*/, core.channel.media.saveMediaBuffer(buffer, "text/markdown", "inbound", undefined, // maxBytes: markdown 文本通常不大，使用默认限制
+                        "smartpage_export.md")];
+                case 1:
+                    saved = _c.sent();
+                    console.log("[mcp] smartpage_get_export_result: \u5DF2\u4FDD\u5B58\u5230 " + saved.path);
+                    newBizData = {
+                        errcode: bizData.errcode,
+                        errmsg: (_b = bizData.errmsg) !== null && _b !== void 0 ? _b : "ok",
+                        task_done: true,
+                        content_path: saved.path
+                    };
+                    // 6. 返回修改后的 MCP result 结构
+                    return [2 /*return*/, {
+                            content: [{
+                                    type: "text",
+                                    text: JSON.stringify(newBizData)
+                                }]
+                        }];
+            }
+        });
+    });
+}

package/dist/src/mcp/interceptors/smartsheet-upload.d.ts

@@ -0,0 +1,22 @@
+/**
+ * smartsheet_add_records / smartsheet_update_records 本地文件上传拦截器
+ *
+ * 核心逻辑：
+ * 大模型在调用 smartsheet_add_records / smartsheet_update_records 时，
+ * 可在 CellImageValue 中传入 image_path（本地图片路径）代替 image_url/title，
+ * 或在 CellAttachmentValue 中传入 file_path（本地文件路径）代替 file_id。
+ *
+ * 本拦截器在 beforeCall 阶段：
+ *   1. 深度扫描 records[].values 中的所有字段值，收集含 image_path / file_path 的单元格
+ *   2. 校验文件大小：单文件不超过 10MB，所有文件总计不超过 20MB
+ *   3. 并行读取本地文件 → base64 编码 → 调用 MCP 上传接口
+ *      - image_path → upload_doc_image → 获取 image_url
+ *      - file_path → upload_doc_file → 获取 file_id
+ *   4. 用上传结果替换原字段，移除 image_path / file_path
+ *   5. 返回修改后的完整 args
+ *
+ * 传给 MCP Server 的始终是标准协议格式（image_url / file_id），
+ * MCP Server 不需要感知 image_path / file_path 的存在。
+ */
+import type { CallInterceptor } from "./types.js";
+export declare const smartsheetUploadInterceptor: CallInterceptor;