ylib-wecom-openclaw-plugin 2026.4.29

package/dist/src/template-card-manager.js

@@ -0,0 +1,316 @@
+"use strict";
+/**
+ * 模板卡片管理器
+ *
+ * 负责：
+ * - 模板卡片缓存管理（内存级，带 TTL 和大小限制）
+ * - 卡片交互事件处理（更新卡片 UI 状态）
+ * - 模板卡片发送（通过 wsClient.sendMessage 主动推送）
+ * - 从 LLM 回复中检测并处理模板卡片
+ */
+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 __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 __spreadArrays = (this && this.__spreadArrays) || function () {
+    for (var s = 0, i = 0, il = arguments.length; i < il; i++) s += arguments[i].length;
+    for (var r = Array(s), k = 0, i = 0; i < il; i++)
+        for (var a = arguments[i], j = 0, jl = a.length; j < jl; j++, k++)
+            r[k] = a[j];
+    return r;
+};
+exports.__esModule = true;
+exports.processTemplateCardsIfNeeded = exports.sendTemplateCards = exports.updateTemplateCardOnEvent = exports.getTemplateCardFromCache = exports.saveTemplateCardToCache = void 0;
+var template_card_parser_js_1 = require("./template-card-parser.js");
+var const_js_1 = require("./const.js");
+var sentTemplateCardByTaskId = new Map();
+function getTemplateCardCacheKey(accountId, taskId) {
+    return accountId + ":" + taskId;
+}
+function pruneTemplateCardCache() {
+    var now = Date.now();
+    for (var _i = 0, sentTemplateCardByTaskId_1 = sentTemplateCardByTaskId; _i < sentTemplateCardByTaskId_1.length; _i++) {
+        var _a = sentTemplateCardByTaskId_1[_i], key = _a[0], entry = _a[1];
+        if (now - entry.createdAt >= const_js_1.TEMPLATE_CARD_CACHE_TTL_MS) {
+            sentTemplateCardByTaskId["delete"](key);
+        }
+    }
+    if (sentTemplateCardByTaskId.size <= const_js_1.TEMPLATE_CARD_CACHE_MAX_SIZE) {
+        return;
+    }
+    var sortedEntries = __spreadArrays(sentTemplateCardByTaskId.entries()).sort(function (a, b) { return a[1].createdAt - b[1].createdAt; });
+    var removeCount = sentTemplateCardByTaskId.size - const_js_1.TEMPLATE_CARD_CACHE_MAX_SIZE;
+    for (var _b = 0, _c = sortedEntries.slice(0, removeCount); _b < _c.length; _b++) {
+        var key = _c[_b][0];
+        sentTemplateCardByTaskId["delete"](key);
+    }
+}
+function cloneTemplateCard(card) {
+    return JSON.parse(JSON.stringify(card));
+}
+function saveTemplateCardToCache(params) {
+    var _a;
+    var accountId = params.accountId, templateCard = params.templateCard, runtime = params.runtime;
+    var taskId = templateCard.task_id;
+    if (!taskId) {
+        (_a = runtime.log) === null || _a === void 0 ? void 0 : _a.call(runtime, "[wecom][template-card] Skip cache: template card has no task_id");
+        return;
+    }
+    sentTemplateCardByTaskId.set(getTemplateCardCacheKey(accountId, taskId), {
+        templateCard: cloneTemplateCard(templateCard),
+        createdAt: Date.now()
+    });
+    pruneTemplateCardCache();
+}
+exports.saveTemplateCardToCache = saveTemplateCardToCache;
+function getTemplateCardFromCache(accountId, taskId) {
+    pruneTemplateCardCache();
+    var cached = sentTemplateCardByTaskId.get(getTemplateCardCacheKey(accountId, taskId));
+    if (!cached) {
+        return undefined;
+    }
+    return cloneTemplateCard(cached.templateCard);
+}
+exports.getTemplateCardFromCache = getTemplateCardFromCache;
+function buildSelectedOptionMap(templateCardEvent) {
+    var _a, _b, _c, _d, _e, _f;
+    var selectedMap = new Map();
+    var selectedItems = (_b = (_a = templateCardEvent === null || templateCardEvent === void 0 ? void 0 : templateCardEvent.selected_items) === null || _a === void 0 ? void 0 : _a.selected_item) !== null && _b !== void 0 ? _b : [];
+    for (var _i = 0, selectedItems_1 = selectedItems; _i < selectedItems_1.length; _i++) {
+        var item = selectedItems_1[_i];
+        var questionKey = (_c = item.question_key) === null || _c === void 0 ? void 0 : _c.trim();
+        if (!questionKey) {
+            continue;
+        }
+        var optionIds = (_f = (_e = (_d = item.option_ids) === null || _d === void 0 ? void 0 : _d.option_id) === null || _e === void 0 ? void 0 : _e.filter(Boolean)) !== null && _f !== void 0 ? _f : [];
+        selectedMap.set(questionKey, optionIds);
+    }
+    return selectedMap;
+}
+function applySelectedStateToTemplateCard(params) {
+    var _a, _b, _c, _d, _e;
+    var templateCard = params.templateCard, selectedMap = params.selectedMap, templateCardEvent = params.templateCardEvent;
+    var nextCard = cloneTemplateCard(templateCard);
+    if (templateCardEvent === null || templateCardEvent === void 0 ? void 0 : templateCardEvent.task_id) {
+        nextCard.task_id = templateCardEvent.task_id;
+    }
+    if (templateCardEvent === null || templateCardEvent === void 0 ? void 0 : templateCardEvent.card_type) {
+        nextCard.card_type = templateCardEvent.card_type;
+    }
+    if ((_a = nextCard.submit_button) === null || _a === void 0 ? void 0 : _a.text) {
+        nextCard.submit_button.text = "已提交";
+    }
+    if ((_b = nextCard.checkbox) === null || _b === void 0 ? void 0 : _b.question_key) {
+        var selectedIds_1 = (_c = selectedMap.get(nextCard.checkbox.question_key)) !== null && _c !== void 0 ? _c : [];
+        nextCard.checkbox.disable = true;
+        if (Array.isArray(nextCard.checkbox.option_list)) {
+            nextCard.checkbox.option_list = nextCard.checkbox.option_list.map(function (option) { return (__assign(__assign({}, option), { is_checked: selectedIds_1.includes(option.id) })); });
+        }
+    }
+    if (Array.isArray(nextCard.select_list)) {
+        nextCard.select_list = nextCard.select_list.map(function (selection) {
+            var _a, _b;
+            var selectedIds = (_a = selectedMap.get(selection.question_key)) !== null && _a !== void 0 ? _a : [];
+            return __assign(__assign({}, selection), { disable: true, selected_id: (_b = selectedIds[0]) !== null && _b !== void 0 ? _b : selection.selected_id });
+        });
+    }
+    if ((_d = nextCard.button_selection) === null || _d === void 0 ? void 0 : _d.question_key) {
+        var selectedIds = (_e = selectedMap.get(nextCard.button_selection.question_key)) !== null && _e !== void 0 ? _e : [];
+        nextCard.button_selection.disable = true;
+        if (selectedIds[0]) {
+            nextCard.button_selection.selected_id = selectedIds[0];
+        }
+    }
+    return nextCard;
+}
+function updateTemplateCardOnEvent(params) {
+    var _a, _b, _c, _d;
+    return __awaiter(this, void 0, void 0, function () {
+        var frame, accountId, runtime, wsClient, body, templateCardEvent, taskId, cachedCard, selectedMap, updatedCard;
+        return __generator(this, function (_e) {
+            switch (_e.label) {
+                case 0:
+                    frame = params.frame, accountId = params.accountId, runtime = params.runtime, wsClient = params.wsClient;
+                    body = frame.body;
+                    templateCardEvent = (_a = body.event) === null || _a === void 0 ? void 0 : _a.template_card_event;
+                    taskId = templateCardEvent === null || templateCardEvent === void 0 ? void 0 : templateCardEvent.task_id;
+                    if (!taskId) {
+                        (_b = runtime.log) === null || _b === void 0 ? void 0 : _b.call(runtime, "[" + accountId + "] [template-card-update] Skip update: missing task_id in callback");
+                        return [2 /*return*/];
+                    }
+                    cachedCard = getTemplateCardFromCache(accountId, taskId);
+                    if (!cachedCard) {
+                        (_c = runtime.log) === null || _c === void 0 ? void 0 : _c.call(runtime, "[" + accountId + "] [template-card-update] Skip update: task_id=" + taskId + " not found in cache (cache is in-memory only, may have been cleared after restart)");
+                        return [2 /*return*/];
+                    }
+                    selectedMap = buildSelectedOptionMap(templateCardEvent);
+                    updatedCard = applySelectedStateToTemplateCard({
+                        templateCard: cachedCard,
+                        selectedMap: selectedMap,
+                        templateCardEvent: templateCardEvent
+                    });
+                    return [4 /*yield*/, wsClient.updateTemplateCard(frame, updatedCard, [body.from.userid])];
+                case 1:
+                    _e.sent();
+                    (_d = runtime.log) === null || _d === void 0 ? void 0 : _d.call(runtime, "[" + accountId + "] [template-card-update] Updated card by task_id=" + taskId);
+                    saveTemplateCardToCache({
+                        accountId: accountId,
+                        templateCard: updatedCard,
+                        runtime: runtime
+                    });
+                    return [2 /*return*/];
+            }
+        });
+    });
+}
+exports.updateTemplateCardOnEvent = updateTemplateCardOnEvent;
+// ============================================================================
+// 模板卡片发送
+// ============================================================================
+/**
+ * 逐个发送已提取的模板卡片（通过 wsClient.sendMessage 主动推送）
+ *
+ * 发送失败不阻塞流程，仅记录错误日志。
+ */
+function sendTemplateCards(params) {
+    var _a, _b, _c, _d;
+    return __awaiter(this, void 0, void 0, function () {
+        var wsClient, frame, state, runtime, account, cards, body, chatId, _i, cards_1, card, rawTemplateCard, templateCard, err_1;
+        return __generator(this, function (_e) {
+            switch (_e.label) {
+                case 0:
+                    wsClient = params.wsClient, frame = params.frame, state = params.state, runtime = params.runtime, account = params.account, cards = params.cards;
+                    body = frame.body;
+                    chatId = body.chatid || body.from.userid;
+                    _i = 0, cards_1 = cards;
+                    _e.label = 1;
+                case 1:
+                    if (!(_i < cards_1.length)) return [3 /*break*/, 6];
+                    card = cards_1[_i];
+                    _e.label = 2;
+                case 2:
+                    _e.trys.push([2, 4, , 5]);
+                    (_a = runtime.log) === null || _a === void 0 ? void 0 : _a.call(runtime, "[wecom][template-card] Sending card_type=" + card.cardType + " to chatId=" + chatId);
+                    rawTemplateCard = card.cardJson;
+                    if (typeof rawTemplateCard.card_type !== "string") {
+                        (_b = runtime.error) === null || _b === void 0 ? void 0 : _b.call(runtime, "[wecom][template-card] Skip sending invalid card: missing card_type");
+                        return [3 /*break*/, 5];
+                    }
+                    templateCard = rawTemplateCard;
+                    return [4 /*yield*/, wsClient.sendMessage(chatId, {
+                            msgtype: "template_card",
+                            template_card: templateCard
+                        })];
+                case 3:
+                    _e.sent();
+                    state.hasTemplateCard = true;
+                    saveTemplateCardToCache({
+                        accountId: account.accountId,
+                        templateCard: templateCard,
+                        runtime: runtime
+                    });
+                    (_c = runtime.log) === null || _c === void 0 ? void 0 : _c.call(runtime, "[wecom][template-card] Card sent successfully: card_type=" + card.cardType);
+                    return [3 /*break*/, 5];
+                case 4:
+                    err_1 = _e.sent();
+                    (_d = runtime.error) === null || _d === void 0 ? void 0 : _d.call(runtime, "[wecom][template-card] Failed to send card: card_type=" + card.cardType + ", error=" + JSON.stringify(err_1));
+                    return [3 /*break*/, 5];
+                case 5:
+                    _i++;
+                    return [3 /*break*/, 1];
+                case 6: return [2 /*return*/];
+            }
+        });
+    });
+}
+exports.sendTemplateCards = sendTemplateCards;
+// ============================================================================
+// 模板卡片检测与处理（从 finishThinkingStream 中分离）
+// ============================================================================
+/**
+ * 从累积文本中检测并发送模板卡片。
+ *
+ * 在 finishThinkingStream 之前调用，将卡片处理和流关闭解耦。
+ *
+ * @returns 移除卡片代码块后的剩余文本（如果没有卡片则返回 null，表示无需修改）
+ */
+function processTemplateCardsIfNeeded(params) {
+    var _a, _b, _c, _d, _e;
+    return __awaiter(this, void 0, void 0, function () {
+        var state, runtime, visibleText, logFn, _f, cards, remainingText;
+        return __generator(this, function (_g) {
+            switch (_g.label) {
+                case 0:
+                    state = params.state, runtime = params.runtime;
+                    visibleText = (_a = state.accumulatedText) === null || _a === void 0 ? void 0 : _a.trim();
+                    if (!visibleText) {
+                        (_b = runtime.log) === null || _b === void 0 ? void 0 : _b.call(runtime, "[wecom][template-card] processTemplateCardsIfNeeded: no visibleText, skipping");
+                        return [2 /*return*/, null];
+                    }
+                    (_c = runtime.log) === null || _c === void 0 ? void 0 : _c.call(runtime, "[wecom][template-card] processTemplateCardsIfNeeded: visibleText exists, length=" + visibleText.length + ", running extractTemplateCards...");
+                    logFn = function () {
+                        var _a;
+                        var args = [];
+                        for (var _i = 0; _i < arguments.length; _i++) {
+                            args[_i] = arguments[_i];
+                        }
+                        (_a = runtime.log) === null || _a === void 0 ? void 0 : _a.call.apply(_a, __spreadArrays([runtime], args));
+                    };
+                    _f = template_card_parser_js_1.extractTemplateCards(state.accumulatedText, logFn), cards = _f.cards, remainingText = _f.remainingText;
+                    (_d = runtime.log) === null || _d === void 0 ? void 0 : _d.call(runtime, "[wecom][template-card] processTemplateCardsIfNeeded: extractTemplateCards result \u2014 cards=" + cards.length + ", remainingTextLength=" + remainingText.length);
+                    if (cards.length === 0) {
+                        return [2 /*return*/, null];
+                    }
+                    (_e = runtime.log) === null || _e === void 0 ? void 0 : _e.call(runtime, "[wecom][template-card] processTemplateCardsIfNeeded: " + cards.length + " card(s) detected, card_types=[" + cards.map(function (c) { return c.cardType; }).join(", ") + "]");
+                    return [4 /*yield*/, sendTemplateCards(__assign(__assign({}, params), { cards: cards }))];
+                case 1:
+                    _g.sent();
+                    return [2 /*return*/, { remainingText: remainingText, cardsDetected: true }];
+            }
+        });
+    });
+}
+exports.processTemplateCardsIfNeeded = processTemplateCardsIfNeeded;

package/dist/src/template-card-parser.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 模板卡片解析器
+ *
+ * 从 LLM 回复文本中提取 markdown JSON 代码块，验证其是否为合法的企业微信模板卡片，
+ * 返回提取到的卡片列表和剩余文本。
+ *
+ * 同时提供 maskTemplateCardBlocks 函数，用于在流式中间帧中隐藏正在构建的卡片代码块，
+ * 避免 JSON 源码暴露给终端用户。
+ */
+import type { TemplateCardExtractionResult } from "./interface.js";
+/**
+ * 从文本中提取模板卡片 JSON 代码块
+ *
+ * 匹配规则：
+ * 1. 匹配所有 ```json ... ``` 或 ``` ... ``` 格式的代码块
+ * 2. 尝试 JSON.parse 解析代码块内容
+ * 3. 检查解析结果中是否包含合法的 card_type 字段
+ * 4. 合法的卡片从原文中移除，不合法的保留
+ *
+ * @param text - LLM 回复的完整文本
+ * @returns 提取结果，包含卡片列表和剩余文本
+ */
+export declare function extractTemplateCards(text: string, log?: (...args: any[]) => void): TemplateCardExtractionResult;
+/**
+ * 遮罩文本中的模板卡片代码块（用于流式中间帧展示）
+ *
+ * 在 LLM 流式输出过程中，累积文本可能包含：
+ * 1. 已闭合的模板卡片 JSON 代码块 → 替换为友好提示文本
+ * 2. 正在构建中的未闭合代码块 → 截断隐藏，避免 JSON 源码暴露
+ *
+ * 此函数仅做文本替换，不做 JSON 解析验证（中间帧性能优先）。
+ * 只要代码块内容中出现 "card_type" 关键词就认为是模板卡片并遮罩。
+ *
+ * @param text - 当前累积文本
+ * @returns 遮罩后的展示文本
+ */
+export declare function maskTemplateCardBlocks(text: string, log?: (...args: any[]) => void): string;