ylib-wecom-openclaw-plugin 2026.4.29

package/dist/src/shared/xml-parser.js

@@ -0,0 +1,228 @@
+"use strict";
+/**
+ * WeCom XML 解析器
+ * 用于 Agent 模式解析 XML 格式消息
+ */
+exports.__esModule = true;
+exports.extractMsgId = exports.extractMediaId = exports.extractContent = exports.extractAgentId = exports.extractChatId = exports.extractToUser = exports.extractFileName = exports.extractFromUser = exports.extractMsgType = exports.parseXml = void 0;
+var fast_xml_parser_1 = require("fast-xml-parser");
+var xmlParser = new fast_xml_parser_1.XMLParser({
+    ignoreAttributes: false,
+    trimValues: true,
+    processEntities: false,
+    parseTagValue: false,
+    parseAttributeValue: false
+});
+/**
+ * 解析 XML 字符串为消息对象
+ */
+function parseXml(xml) {
+    var _a;
+    var obj = xmlParser.parse(xml);
+    var root = (_a = obj === null || obj === void 0 ? void 0 : obj.xml) !== null && _a !== void 0 ? _a : obj;
+    return root !== null && root !== void 0 ? root : {};
+}
+exports.parseXml = parseXml;
+/**
+ * 从 XML 中提取消息类型
+ */
+function extractMsgType(msg) {
+    var _a;
+    return String((_a = msg.MsgType) !== null && _a !== void 0 ? _a : "").toLowerCase();
+}
+exports.extractMsgType = extractMsgType;
+/**
+ * 从 XML 中提取发送者 ID
+ */
+function extractFromUser(msg) {
+    var _a;
+    return String((_a = msg.FromUserName) !== null && _a !== void 0 ? _a : "");
+}
+exports.extractFromUser = extractFromUser;
+/**
+ * 从 XML 中提取文件名（主要用于 file 消息）
+ */
+function extractFileName(msg) {
+    var _a, _b, _c;
+    var raw = (_c = (_b = (_a = msg.FileName) !== null && _a !== void 0 ? _a : msg.Filename) !== null && _b !== void 0 ? _b : msg.fileName) !== null && _c !== void 0 ? _c : msg.filename;
+    if (raw == null)
+        return undefined;
+    if (typeof raw === "string")
+        return raw.trim() || undefined;
+    if (typeof raw === "number" || typeof raw === "boolean" || typeof raw === "bigint")
+        return String(raw);
+    if (Array.isArray(raw)) {
+        var merged = raw.map(function (v) { return (v == null ? "" : String(v)); }).join("\n").trim();
+        return merged || undefined;
+    }
+    if (typeof raw === "object") {
+        var obj = raw;
+        var text = (typeof obj["#text"] === "string" ? obj["#text"] :
+            typeof obj["_text"] === "string" ? obj["_text"] :
+                typeof obj["text"] === "string" ? obj["text"] : undefined);
+        if (text && text.trim())
+            return text.trim();
+    }
+    var s = String(raw);
+    return s.trim() || undefined;
+}
+exports.extractFileName = extractFileName;
+/**
+ * 从 XML 中提取接收者 ID (CorpID)
+ */
+function extractToUser(msg) {
+    var _a;
+    return String((_a = msg.ToUserName) !== null && _a !== void 0 ? _a : "");
+}
+exports.extractToUser = extractToUser;
+/**
+ * 从 XML 中提取群聊 ID
+ */
+function extractChatId(msg) {
+    return msg.ChatId ? String(msg.ChatId) : undefined;
+}
+exports.extractChatId = extractChatId;
+/**
+ * 从 XML 中提取 AgentID（兼容 AgentID/agentid 等大小写）
+ */
+function extractAgentId(msg) {
+    var _a, _b, _c;
+    var raw = (_c = (_b = (_a = msg.AgentID) !== null && _a !== void 0 ? _a : msg.AgentId) !== null && _b !== void 0 ? _b : msg.agentid) !== null && _c !== void 0 ? _c : msg.agentId;
+    if (raw == null)
+        return undefined;
+    if (typeof raw === "string")
+        return raw.trim() || undefined;
+    if (typeof raw === "number")
+        return raw;
+    var asString = String(raw).trim();
+    return asString || undefined;
+}
+exports.extractAgentId = extractAgentId;
+/**
+ * 从 XML 中提取消息内容
+ */
+function extractContent(msg) {
+    var msgType = extractMsgType(msg);
+    var asText = function (value) {
+        if (value == null)
+            return "";
+        if (typeof value === "string")
+            return value;
+        if (typeof value === "number" || typeof value === "boolean" || typeof value === "bigint")
+            return String(value);
+        if (Array.isArray(value))
+            return value.map(asText).filter(Boolean).join("\n");
+        if (typeof value === "object") {
+            var obj = value;
+            // fast-xml-parser 在某些情况下（例如带属性）会把文本放在 "#text"
+            if (typeof obj["#text"] === "string")
+                return obj["#text"];
+            if (typeof obj["_text"] === "string")
+                return obj["_text"];
+            if (typeof obj["text"] === "string")
+                return obj["text"];
+            try {
+                return JSON.stringify(obj);
+            }
+            catch (_a) {
+                return String(value);
+            }
+        }
+        return String(value);
+    };
+    switch (msgType) {
+        case "text":
+            return asText(msg.Content);
+        case "voice":
+            // 语音识别结果
+            return asText(msg.Recognition) || "[语音消息]";
+        case "image":
+            return "[\u56FE\u7247] " + asText(msg.PicUrl);
+        case "file":
+            return "[文件消息]";
+        case "video":
+            return "[视频消息]";
+        case "location":
+            return "[\u4F4D\u7F6E] " + asText(msg.Label) + " (" + asText(msg.Location_X) + ", " + asText(msg.Location_Y) + ")";
+        case "link":
+            return "[\u94FE\u63A5] " + asText(msg.Title) + "\n" + asText(msg.Description) + "\n" + asText(msg.Url);
+        case "event":
+            return "[\u4E8B\u4EF6] " + asText(msg.Event) + " - " + asText(msg.EventKey);
+        default:
+            return "[" + (msgType || "未知消息类型") + "]";
+    }
+}
+exports.extractContent = extractContent;
+/**
+ * 从 XML 中提取媒体 ID (Image, Voice, Video)
+ * 根据官方文档，MediaId 在 Agent 回调中直接位于根节点
+ */
+function extractMediaId(msg) {
+    var _a, _b, _c;
+    var raw = (_c = (_b = (_a = msg.MediaId) !== null && _a !== void 0 ? _a : msg.MediaID) !== null && _b !== void 0 ? _b : msg.mediaid) !== null && _c !== void 0 ? _c : msg.mediaId;
+    if (raw == null)
+        return undefined;
+    if (typeof raw === "string")
+        return raw.trim() || undefined;
+    if (typeof raw === "number" || typeof raw === "boolean" || typeof raw === "bigint")
+        return String(raw);
+    if (Array.isArray(raw)) {
+        var merged = raw.map(function (v) { return (v == null ? "" : String(v)); }).join("\n").trim();
+        return merged || undefined;
+    }
+    if (typeof raw === "object") {
+        var obj = raw;
+        var text = (typeof obj["#text"] === "string" ? obj["#text"] :
+            typeof obj["_text"] === "string" ? obj["_text"] :
+                typeof obj["text"] === "string" ? obj["text"] : undefined);
+        if (text && text.trim())
+            return text.trim();
+        try {
+            var s_1 = JSON.stringify(obj);
+            return s_1.trim() || undefined;
+        }
+        catch (_d) {
+            var s_2 = String(raw);
+            return s_2.trim() || undefined;
+        }
+    }
+    var s = String(raw);
+    return s.trim() || undefined;
+}
+exports.extractMediaId = extractMediaId;
+/**
+ * 从 XML 中提取 MsgId（用于去重）
+ */
+function extractMsgId(msg) {
+    var _a, _b, _c;
+    var raw = (_c = (_b = (_a = msg.MsgId) !== null && _a !== void 0 ? _a : msg.MsgID) !== null && _b !== void 0 ? _b : msg.msgid) !== null && _c !== void 0 ? _c : msg.msgId;
+    if (raw == null)
+        return undefined;
+    if (typeof raw === "string")
+        return raw.trim() || undefined;
+    if (typeof raw === "number" || typeof raw === "boolean" || typeof raw === "bigint")
+        return String(raw);
+    if (Array.isArray(raw)) {
+        var merged = raw.map(function (v) { return (v == null ? "" : String(v)); }).join("\n").trim();
+        return merged || undefined;
+    }
+    if (typeof raw === "object") {
+        var obj = raw;
+        var text = (typeof obj["#text"] === "string" ? obj["#text"] :
+            typeof obj["_text"] === "string" ? obj["_text"] :
+                typeof obj["text"] === "string" ? obj["text"] : undefined);
+        if (text && text.trim())
+            return text.trim();
+        try {
+            var s_3 = JSON.stringify(obj);
+            return s_3.trim() || undefined;
+        }
+        catch (_d) {
+            var s_4 = String(raw);
+            return s_4.trim() || undefined;
+        }
+    }
+    var s = String(raw);
+    return s.trim() || undefined;
+}
+exports.extractMsgId = extractMsgId;

package/dist/src/state-dir-resolve.d.ts

@@ -0,0 +1,2 @@
+/** 解析 openclaw 状态目录 */
+export declare function resolveStateDir(): string;

package/dist/src/state-dir-resolve.js

@@ -0,0 +1,33 @@
+"use strict";
+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;
+};
+exports.__esModule = true;
+exports.resolveStateDir = void 0;
+var path = __importStar(require("node:path"));
+var os = __importStar(require("node:os"));
+/** 解析 openclaw 状态目录 */
+function resolveStateDir() {
+    var _a, _b;
+    var stateOverride = ((_a = process.env.OPENCLAW_STATE_DIR) === null || _a === void 0 ? void 0 : _a.trim()) || ((_b = process.env.CLAWDBOT_STATE_DIR) === null || _b === void 0 ? void 0 : _b.trim());
+    if (stateOverride)
+        return stateOverride;
+    return path.join(os.homedir(), ".openclaw");
+}
+exports.resolveStateDir = resolveStateDir;

package/dist/src/state-manager.d.ts

@@ -0,0 +1,115 @@
+/**
+ * 企业微信全局状态管理模块
+ *
+ * 负责管理 WSClient 实例、消息状态（带 TTL 清理）、ReqId 存储
+ * 解决全局 Map 的内存泄漏问题
+ */
+import type { WSClient } from "@wecom/aibot-node-sdk";
+import type { MessageState } from "./interface.js";
+export interface WeComConnectionSnapshot {
+    accountId: string;
+    connected: boolean;
+    authenticated: boolean;
+    running: boolean;
+    restartPending: boolean;
+    lastEvent: string | null;
+    lastEventAt: number | null;
+    lastStartAt: number | null;
+    lastStopAt: number | null;
+    lastError: string | null;
+    reconnectAttempts: number;
+}
+/**
+ * 获取指定账户的 WSClient 实例
+ */
+export declare function getWeComWebSocket(accountId: string): WSClient | null;
+/**
+ * 设置指定账户的 WSClient 实例
+ */
+export declare function setWeComWebSocket(accountId: string, client: WSClient): void;
+/**
+ * 删除指定账户的 WSClient 实例
+ */
+export declare function deleteWeComWebSocket(accountId: string): void;
+export declare function updateWeComConnectionSnapshot(accountId: string, patch: Partial<WeComConnectionSnapshot>): WeComConnectionSnapshot;
+export declare function getWeComConnectionSnapshot(accountId: string): WeComConnectionSnapshot | null;
+export declare function deleteWeComConnectionSnapshot(accountId: string): void;
+/**
+ * 启动消息状态定期清理（自动 TTL 清理 + 容量限制）
+ */
+export declare function startMessageStateCleanup(): void;
+/**
+ * 停止消息状态定期清理
+ */
+export declare function stopMessageStateCleanup(): void;
+/**
+ * 设置消息状态
+ */
+export declare function setMessageState(messageId: string, state: MessageState): void;
+/**
+ * 获取消息状态
+ */
+export declare function getMessageState(messageId: string): MessageState | undefined;
+/**
+ * 删除消息状态
+ */
+export declare function deleteMessageState(messageId: string): void;
+/**
+ * 清空所有消息状态
+ */
+export declare function clearAllMessageStates(): void;
+/**
+ * 设置 chatId 对应的 reqId（写入内存 + 防抖写磁盘）
+ */
+export declare function setReqIdForChat(chatId: string, reqId: string, accountId?: string): void;
+/**
+ * 获取 chatId 对应的 reqId（异步：优先内存，miss 时查磁盘并回填内存）
+ */
+export declare function getReqIdForChatAsync(chatId: string, accountId?: string): Promise<string | undefined>;
+/**
+ * 获取 chatId 对应的 reqId（同步：仅内存，保留向后兼容）
+ */
+export declare function getReqIdForChat(chatId: string, accountId?: string): string | undefined;
+/**
+ * 删除 chatId 对应的 reqId
+ */
+export declare function deleteReqIdForChat(chatId: string, accountId?: string): void;
+/**
+ * 启动时预热 reqId 缓存（从磁盘加载到内存）
+ *
+ * 注意：由于移除了磁盘存储，此函数现在只返回 0（无预热条目）
+ */
+export declare function warmupReqIdStore(accountId?: string, log?: (...args: unknown[]) => void): Promise<number>;
+/**
+ * 立即将 reqId 数据刷写到磁盘（用于优雅退出）
+ *
+ * 注意：由于移除了磁盘存储，此函数现在是无操作
+ */
+export declare function flushReqIdStore(accountId?: string): Promise<void>;
+/** 会话 chat 信息 */
+export interface SessionChatInfo {
+    /** 原始大小写的 chatId（群 ID 或用户 ID） */
+    chatId: string;
+    /** 聊天类型：single（单聊）或 group（群聊） */
+    chatType: "single" | "group";
+}
+/**
+ * 记录 sessionKey 对应的原始会话信息（由 monitor.ts 在消息入站时调用）
+ */
+export declare function setSessionChatInfo(sessionKey: string, info: SessionChatInfo): void;
+/**
+ * 获取 sessionKey 对应的原始会话信息（由 registerTool 闭包调用）
+ */
+export declare function getSessionChatInfo(sessionKey: string | undefined): SessionChatInfo | undefined;
+/**
+ * 删除 sessionKey 对应的会话信息（会话结束时可选调用）
+ */
+export declare function deleteSessionChatInfo(sessionKey: string): void;
+/**
+ * 清理指定账户的所有资源
+ */
+export declare function cleanupAccount(accountId: string): Promise<void>;
+/**
+ * 清理所有资源（用于进程退出）
+ */
+export declare function cleanupAll(): Promise<void>;