@wwlocal/aibot-plugin-node 20260409.20.0

package/dist/cjs/src/reqid-store.js

@@ -0,0 +1,87 @@
+'use strict';
+
+// ============================================================================
+// 类型定义
+// ============================================================================
+// ============================================================================
+// 常量
+// ============================================================================
+const DEFAULT_TTL_MS = 7 * 24 * 60 * 60 * 1000; // 7 天
+const DEFAULT_MEMORY_MAX_SIZE = 200;
+// ============================================================================
+// 核心实现
+// ============================================================================
+function createPersistentReqIdStore(accountId, options) {
+    const ttlMs = DEFAULT_TTL_MS;
+    const memoryMaxSize = DEFAULT_MEMORY_MAX_SIZE;
+    // 内存层：chatId → ReqIdEntry
+    const memory = new Map();
+    // ========== 内部辅助函数 ==========
+    /** 检查条目是否过期 */
+    function isExpired(entry, now) {
+        return now - entry.ts >= ttlMs;
+    }
+    /**
+     * 内存容量控制：淘汰最旧的条目。
+     * 利用 Map 的插入顺序 + touch(先 delete 再 set) 实现类 LRU 效果。
+     */
+    function pruneMemory() {
+        if (memory.size <= memoryMaxSize)
+            return;
+        const sorted = [...memory.entries()].sort((a, b) => a[1].ts - b[1].ts);
+        const toRemove = sorted.slice(0, memory.size - memoryMaxSize);
+        for (const [key] of toRemove) {
+            memory.delete(key);
+        }
+    }
+    // ========== 公开 API ==========
+    function set(chatId, reqId) {
+        const entry = { reqId, ts: Date.now() };
+        // touch：先删再设，保持 Map 插入顺序（类 LRU）
+        memory.delete(chatId);
+        memory.set(chatId, entry);
+        pruneMemory();
+    }
+    async function get(chatId) {
+        const now = Date.now();
+        // 仅查内存
+        const memEntry = memory.get(chatId);
+        if (memEntry && !isExpired(memEntry, now)) {
+            return memEntry.reqId;
+        }
+        if (memEntry) {
+            memory.delete(chatId); // 过期则删除
+        }
+        return undefined;
+    }
+    function getSync(chatId) {
+        const now = Date.now();
+        const entry = memory.get(chatId);
+        if (entry && !isExpired(entry, now)) {
+            return entry.reqId;
+        }
+        if (entry) {
+            memory.delete(chatId);
+        }
+        return undefined;
+    }
+    function del(chatId) {
+        memory.delete(chatId);
+    }
+    function clearMemory() {
+        memory.clear();
+    }
+    function memorySize() {
+        return memory.size;
+    }
+    return {
+        set,
+        get,
+        getSync,
+        delete: del,
+        clearMemory,
+        memorySize,
+    };
+}
+
+exports.createPersistentReqIdStore = createPersistentReqIdStore;

package/dist/cjs/src/server.js

@@ -0,0 +1,72 @@
+'use strict';
+
+var express = require('express');
+var version = require('./version.js');
+
+/**
+ * Express HTTP 服务器模块
+ *
+ * 提供：
+ * - GET /health       — 健康检查
+ * - GET /api/status   — 服务状态查询（各账号连接状态/消息统计）
+ * - POST /callback    — 模板卡片事件回调 webhook（预留）
+ */
+/**
+ * 创建 Express 应用并注册路由
+ */
+function createServer(options) {
+    const { serviceManager, runtime } = options;
+    const app = express();
+    // 解析 JSON body
+    app.use(express.json());
+    // ──────────────────────────────────────────────────────────────────────
+    // 健康检查
+    // ──────────────────────────────────────────────────────────────────────
+    app.get("/health", (_req, res) => {
+        res.json({
+            status: "ok",
+            version: version.PLUGIN_VERSION,
+            uptime: process.uptime(),
+            timestamp: Date.now(),
+        });
+    });
+    // ──────────────────────────────────────────────────────────────────────
+    // 服务状态查询
+    // ──────────────────────────────────────────────────────────────────────
+    app.get("/api/status", (_req, res) => {
+        const statuses = serviceManager.getStatuses();
+        res.json({
+            version: version.PLUGIN_VERSION,
+            accounts: statuses,
+            timestamp: Date.now(),
+        });
+    });
+    // ──────────────────────────────────────────────────────────────────────
+    // 模板卡片事件回调 webhook（预留）
+    // ──────────────────────────────────────────────────────────────────────
+    app.post("/callback", (req, res) => {
+        runtime.log?.(`[server] Received callback: ${JSON.stringify(req.body).slice(0, 500)}`);
+        // 回调事件已通过 WebSocket 事件监听处理，HTTP 回调为预留扩展接口
+        res.json({ errcode: 0, errmsg: "ok" });
+    });
+    // ──────────────────────────────────────────────────────────────────────
+    // 404 处理
+    // ──────────────────────────────────────────────────────────────────────
+    app.use((_req, res) => {
+        res.status(404).json({ error: "Not Found" });
+    });
+    return app;
+}
+/**
+ * 启动 HTTP 服务器
+ */
+function startServer(app, port, runtime) {
+    app.listen(port, () => {
+        runtime.log?.(`[server] HTTP server listening on port ${port}`);
+        runtime.log?.(`[server] Health check: http://localhost:${port}/health`);
+        runtime.log?.(`[server] Status API:   http://localhost:${port}/api/status`);
+    });
+}
+
+exports.createServer = createServer;
+exports.startServer = startServer;

package/dist/cjs/src/service-manager.js

@@ -0,0 +1,135 @@
+'use strict';
+
+var config = require('./config.js');
+var monitor = require('./monitor.js');
+
+/**
+ * 服务生命周期管理器
+ *
+ * 管理多账号 WSClient 的启动/停止/重连、状态监控、统一 cleanup。
+ */
+// ============================================================================
+// ServiceManager
+// ============================================================================
+class ServiceManager {
+    constructor(options) {
+        this.accounts = [];
+        this.accountStatuses = new Map();
+        this.abortControllers = new Map();
+        this.monitorPromises = new Map();
+        this.config = options.config;
+        this.runtime = options.runtime;
+    }
+    /**
+     * 启动所有已启用的账号
+     */
+    async startAll() {
+        this.accounts = config.resolveAllAccounts(this.config);
+        if (this.accounts.length === 0) {
+            this.runtime.error?.("[service-manager] No enabled accounts found in configuration");
+            return;
+        }
+        this.runtime.log?.(`[service-manager] Starting ${this.accounts.length} account(s)...`);
+        for (const account of this.accounts) {
+            this.startAccount(account);
+        }
+    }
+    /**
+     * 启动单个账号的 WebSocket 监控
+     */
+    startAccount(account) {
+        const { accountId, name } = account;
+        // 初始化状态
+        this.accountStatuses.set(accountId, {
+            accountId,
+            name,
+            running: false,
+        });
+        // 创建中止控制器
+        const abortController = new AbortController();
+        this.abortControllers.set(accountId, abortController);
+        // 构建 MonitorOptions
+        const monitorOptions = {
+            account,
+            config: this.config,
+            runtime: this.runtime,
+            abortSignal: abortController.signal,
+            setStatus: (next) => {
+                const current = this.accountStatuses.get(accountId);
+                if (current) {
+                    Object.assign(current, next);
+                }
+            },
+        };
+        this.runtime.log?.(`[service-manager] Starting account: ${accountId} (${name})`);
+        // 启动监控
+        const promise = monitor.monitorWeComProvider(monitorOptions)
+            .then(() => {
+            this.runtime.log?.(`[service-manager] Account ${accountId} monitor resolved`);
+        })
+            .catch((err) => {
+            this.runtime.error?.(`[service-manager] Account ${accountId} monitor failed: ${String(err)}`);
+            const status = this.accountStatuses.get(accountId);
+            if (status) {
+                status.running = false;
+                status.lastError = String(err);
+                status.lastStopAt = Date.now();
+            }
+            // 网络断线重连耗尽后自动重试
+            this.runtime.log?.(`[service-manager] Will restart account ${accountId} in 30s...`);
+            setTimeout(() => {
+                if (!abortController.signal.aborted) {
+                    this.restartAccount(accountId);
+                }
+            }, 30000);
+        });
+        this.monitorPromises.set(accountId, promise);
+    }
+    /**
+     * 重启指定账号
+     */
+    restartAccount(accountId) {
+        const account = this.accounts.find((a) => a.accountId === accountId);
+        if (!account) {
+            this.runtime.error?.(`[service-manager] Cannot restart: account ${accountId} not found`);
+            return;
+        }
+        // 清理旧的中止控制器
+        const oldController = this.abortControllers.get(accountId);
+        if (oldController && !oldController.signal.aborted) {
+            oldController.abort();
+        }
+        this.runtime.log?.(`[service-manager] Restarting account: ${accountId}`);
+        this.startAccount(account);
+    }
+    /**
+     * 停止所有账号
+     */
+    async stopAll() {
+        this.runtime.log?.("[service-manager] Stopping all accounts...");
+        for (const [accountId, controller] of this.abortControllers) {
+            this.runtime.log?.(`[service-manager] Aborting account: ${accountId}`);
+            controller.abort();
+        }
+        // 等待所有 monitor promises 结束（有超时保护）
+        const promises = [...this.monitorPromises.values()];
+        await Promise.allSettled(promises);
+        this.abortControllers.clear();
+        this.monitorPromises.clear();
+        this.runtime.log?.("[service-manager] All accounts stopped");
+    }
+    /**
+     * 获取所有账号状态
+     */
+    getStatuses() {
+        return [...this.accountStatuses.values()];
+    }
+    /**
+     * 获取指定账号状态
+     */
+    getStatus(accountId) {
+        return this.accountStatuses.get(accountId);
+    }
+}
+
+exports.ServiceManager = ServiceManager;

package/dist/cjs/src/state-manager.js

@@ -0,0 +1,143 @@
+'use strict';
+
+var reqidStore = require('./reqid-store.js');
+var _const = require('./const.js');
+
+/**
+ * 全局状态管理模块
+ *
+ * 负责管理 WSClient 实例、消息状态（带 TTL 清理）、ReqId 存储
+ * 解决全局 Map 的内存泄漏问题
+ */
+// ============================================================================
+// WSClient 实例管理
+// ============================================================================
+/** WSClient 实例管理 */
+const wsClientInstances = new Map();
+/**
+ * 设置指定账户的 WSClient 实例
+ */
+function setWeComWebSocket(accountId, client) {
+    wsClientInstances.set(accountId, client);
+}
+/** 消息状态管理 */
+const messageStates = new Map();
+/** 定期清理定时器 */
+let cleanupTimer = null;
+/**
+ * 启动消息状态定期清理（自动 TTL 清理 + 容量限制）
+ */
+function startMessageStateCleanup() {
+    if (cleanupTimer)
+        return;
+    cleanupTimer = setInterval(() => {
+        pruneMessageStates();
+    }, _const.MESSAGE_STATE_CLEANUP_INTERVAL_MS);
+    // 允许进程退出时不阻塞
+    if (cleanupTimer && typeof cleanupTimer === "object" && "unref" in cleanupTimer) {
+        cleanupTimer.unref();
+    }
+}
+/**
+ * 停止消息状态定期清理
+ */
+function stopMessageStateCleanup() {
+    if (cleanupTimer) {
+        clearInterval(cleanupTimer);
+        cleanupTimer = null;
+    }
+}
+/**
+ * 清理过期和超量的消息状态条目
+ */
+function pruneMessageStates() {
+    const now = Date.now();
+    // 1. 清理过期条目
+    for (const [key, entry] of messageStates) {
+        if (now - entry.createdAt >= _const.MESSAGE_STATE_TTL_MS) {
+            messageStates.delete(key);
+        }
+    }
+    // 2. 容量限制：如果仍超过最大条目数，按时间淘汰最旧的
+    if (messageStates.size > _const.MESSAGE_STATE_MAX_SIZE) {
+        const sorted = [...messageStates.entries()].sort((a, b) => a[1].createdAt - b[1].createdAt);
+        const toRemove = sorted.slice(0, messageStates.size - _const.MESSAGE_STATE_MAX_SIZE);
+        for (const [key] of toRemove) {
+            messageStates.delete(key);
+        }
+    }
+}
+/**
+ * 设置消息状态
+ */
+function setMessageState(messageId, state) {
+    messageStates.set(messageId, {
+        state,
+        createdAt: Date.now(),
+    });
+}
+/**
+ * 删除消息状态
+ */
+function deleteMessageState(messageId) {
+    messageStates.delete(messageId);
+}
+// ============================================================================
+// ReqId 持久化存储管理（按 accountId 隔离）
+// ============================================================================
+/**
+ * ReqId 存储管理（纯内存模式，LRU + TTL）
+ */
+const reqIdStores = new Map();
+function getOrCreateReqIdStore(accountId) {
+    let store = reqIdStores.get(accountId);
+    if (!store) {
+        store = reqidStore.createPersistentReqIdStore();
+        reqIdStores.set(accountId, store);
+    }
+    return store;
+}
+// ============================================================================
+// ReqId 操作函数
+// ============================================================================
+/**
+ * 设置 chatId 对应的 reqId
+ */
+function setReqIdForChat(chatId, reqId, accountId = "default") {
+    getOrCreateReqIdStore(accountId).set(chatId, reqId);
+}
+/**
+ * 启动时预热 reqId 缓存
+ */
+async function warmupReqIdStore(accountId = "default", log) {
+    log?.("[wecom] reqid-store warmup: no-op (memory-only mode)");
+    return 0;
+}
+// ============================================================================
+// 全局 cleanup（断开连接时释放所有资源）
+// ============================================================================
+/**
+ * 清理指定账户的所有资源
+ */
+async function cleanupAccount(accountId) {
+    // 1. 断开 WSClient
+    const wsClient = wsClientInstances.get(accountId);
+    if (wsClient) {
+        try {
+            wsClient.disconnect();
+        }
+        catch {
+            // 忽略断开连接时的错误
+        }
+        wsClientInstances.delete(accountId);
+    }
+}
+
+exports.cleanupAccount = cleanupAccount;
+exports.deleteMessageState = deleteMessageState;
+exports.setMessageState = setMessageState;
+exports.setReqIdForChat = setReqIdForChat;
+exports.setWeComWebSocket = setWeComWebSocket;
+exports.startMessageStateCleanup = startMessageStateCleanup;
+exports.stopMessageStateCleanup = stopMessageStateCleanup;
+exports.warmupReqIdStore = warmupReqIdStore;