@wwlocal/aibot-plugin-node 20260409.20.0

package/dist/esm/types/src/monitor.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 企业微信私有部署 WebSocket 监控器主模块
+ *
+ * 负责：
+ * - 建立和管理 WebSocket 连接
+ * - 协调消息处理流程（解析→策略检查→下载图片→智能体转发→流式回复）
+ * - 资源生命周期管理
+ *
+ * 子模块：
+ * - message-parser.ts       : 消息内容解析
+ * - message-sender.ts       : 消息发送（带超时保护）
+ * - media-handler.ts        : 图片/文件下载和保存（带超时保护）
+ * - media-uploader.ts       : 出站媒体上传+发送
+ * - group-policy.ts         : 群组访问控制
+ * - dm-policy.ts            : 私聊访问控制
+ * - state-manager.ts        : 全局状态管理（带 TTL 清理）
+ * - agent-forwarder.ts      : OpenAI API 兼容智能体转发
+ * - template-card-parser.ts : 模板卡片提取/遮罩
+ * - timeout.ts              : 超时工具
+ */
+import type { MonitorOptions } from "./interface.js";
+export type { MonitorOptions } from "./interface.js";
+export { WeComCommand } from "./const.js";
+export { getWeComWebSocket, setReqIdForChat, getReqIdForChatAsync, getReqIdForChat, deleteReqIdForChat, warmupReqIdStore, flushReqIdStore, } from "./state-manager.js";
+export { sendWeComReply } from "./message-sender.js";
+/**
+ * 监听企业微信私有部署 WebSocket 连接
+ * 使用 aibot-node-sdk 简化连接管理
+ */
+export declare function monitorWeComProvider(options: MonitorOptions): Promise<void>;

package/dist/esm/types/src/reqid-store.d.ts

@@ -0,0 +1,23 @@
+/** Store 配置 */
+interface ReqIdStoreOptions {
+    /** TTL 毫秒数，超时的 reqId 视为过期（默认 7 天） */
+    ttlMs?: number;
+    /** 内存最大条目数（默认 200） */
+    memoryMaxSize?: number;
+}
+export interface PersistentReqIdStore {
+    /** 设置 chatId 对应的 reqId（仅写入内存） */
+    set(chatId: string, reqId: string): void;
+    /** 获取 chatId 对应的 reqId（仅内存） */
+    get(chatId: string): Promise<string | undefined>;
+    /** 同步获取 chatId 对应的 reqId（仅内存） */
+    getSync(chatId: string): string | undefined;
+    /** 删除 chatId 对应的 reqId */
+    delete(chatId: string): void;
+    /** 清空内存缓存 */
+    clearMemory(): void;
+    /** 返回内存中的条目数 */
+    memorySize(): number;
+}
+export declare function createPersistentReqIdStore(accountId: string, options?: ReqIdStoreOptions): PersistentReqIdStore;
+export {};

package/dist/esm/types/src/server.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Express HTTP 服务器模块
+ *
+ * 提供：
+ * - GET /health       — 健康检查
+ * - GET /api/status   — 服务状态查询（各账号连接状态/消息统计）
+ * - POST /callback    — 模板卡片事件回调 webhook（预留）
+ */
+import type { Express } from "express";
+import type { ServiceManager } from "./service-manager.js";
+import type { RuntimeLogger } from "./interface.js";
+export interface CreateServerOptions {
+    serviceManager: ServiceManager;
+    runtime: RuntimeLogger;
+}
+/**
+ * 创建 Express 应用并注册路由
+ */
+export declare function createServer(options: CreateServerOptions): Express;
+/**
+ * 启动 HTTP 服务器
+ */
+export declare function startServer(app: Express, port: number, runtime: RuntimeLogger): void;

package/dist/esm/types/src/service-manager.d.ts

@@ -0,0 +1,52 @@
+/**
+ * 服务生命周期管理器
+ *
+ * 管理多账号 WSClient 的启动/停止/重连、状态监控、统一 cleanup。
+ */
+import type { PluginConfig, RuntimeLogger } from "./interface.js";
+export interface AccountStatus {
+    accountId: string;
+    name: string;
+    running: boolean;
+    lastConnectedAt?: number;
+    lastStopAt?: number;
+    lastError?: string;
+    [key: string]: unknown;
+}
+export interface ServiceManagerOptions {
+    config: PluginConfig;
+    runtime: RuntimeLogger;
+}
+export declare class ServiceManager {
+    private config;
+    private runtime;
+    private accounts;
+    private accountStatuses;
+    private abortControllers;
+    private monitorPromises;
+    constructor(options: ServiceManagerOptions);
+    /**
+     * 启动所有已启用的账号
+     */
+    startAll(): Promise<void>;
+    /**
+     * 启动单个账号的 WebSocket 监控
+     */
+    private startAccount;
+    /**
+     * 重启指定账号
+     */
+    private restartAccount;
+    /**
+     * 停止所有账号
+     */
+    stopAll(): Promise<void>;
+    /**
+     * 获取所有账号状态
+     */
+    getStatuses(): AccountStatus[];
+    /**
+     * 获取指定账号状态
+     */
+    getStatus(accountId: string): AccountStatus | undefined;
+}

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

@@ -0,0 +1,76 @@
+/**
+ * 全局状态管理模块
+ *
+ * 负责管理 WSClient 实例、消息状态（带 TTL 清理）、ReqId 存储
+ * 解决全局 Map 的内存泄漏问题
+ */
+import type { WSClient } from "@wecom/aibot-node-sdk";
+import type { MessageState } from "./interface.js";
+/**
+ * 获取指定账户的 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;
+/**
+ * 启动消息状态定期清理（自动 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（异步）
+ */
+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 缓存
+ */
+export declare function warmupReqIdStore(accountId?: string, log?: (...args: unknown[]) => void): Promise<number>;
+/**
+ * 刷写 reqId 数据（纯内存模式下为无操作）
+ */
+export declare function flushReqIdStore(accountId?: string): Promise<void>;
+/**
+ * 清理指定账户的所有资源
+ */
+export declare function cleanupAccount(accountId: string): Promise<void>;
+/**
+ * 清理所有资源（用于进程退出）
+ */
+export declare function cleanupAll(): Promise<void>;

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

@@ -0,0 +1,18 @@
+/**
+ * 模板卡片解析器
+ *
+ * 从 LLM 回复文本中提取 markdown JSON 代码块，验证其是否为合法的企业微信模板卡片，
+ * 返回提取到的卡片列表和剩余文本。
+ *
+ * 同时提供 maskTemplateCardBlocks 函数，用于在流式中间帧中隐藏正在构建的卡片代码块，
+ * 避免 JSON 源码暴露给终端用户。
+ */
+import type { TemplateCardExtractionResult } from "./interface.js";
+/**
+ * 从文本中提取模板卡片 JSON 代码块
+ */
+export declare function extractTemplateCards(text: string, log?: (...args: any[]) => void): TemplateCardExtractionResult;
+/**
+ * 遮罩文本中的模板卡片代码块（用于流式中间帧展示）
+ */
+export declare function maskTemplateCardBlocks(text: string, log?: (...args: any[]) => void): string;

package/dist/esm/types/src/timeout.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 超时控制工具模块
+ *
+ * 为异步操作提供统一的超时保护机制
+ */
+/**
+ * 为 Promise 添加超时保护
+ *
+ * @param promise - 原始 Promise
+ * @param timeoutMs - 超时时间（毫秒）
+ * @param message - 超时错误消息
+ * @returns 带超时保护的 Promise
+ */
+export declare function withTimeout<T>(promise: Promise<T>, timeoutMs: number, message?: string): Promise<T>;
+/**
+ * 超时错误类型
+ */
+export declare class TimeoutError extends Error {
+    constructor(message: string);
+}

package/dist/esm/types/src/version.d.ts

@@ -0,0 +1,2 @@
+/** 插件版本号，来源于 package.json */
+export declare const PLUGIN_VERSION: string;

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+
+export { };

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@wwlocal/aibot-plugin-node",
+  "version": "20260409.20.0",
+  "type": "module",
+  "main": "dist/cjs/index.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "aibot-plugin": "./dist/esm/index.js"
+  },
+  "files": [
+    "dist",
+    "config.example.json",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "rollup -c",
+    "dev": "rollup -c -w",
+    "clean": "rm -rf dist",
+    "version:stamp": "node scripts/version-stamp.cjs",
+    "prebuild": "npm run clean && npm run version:stamp",
+    "start": "node dist/esm/index.js"
+  },
+  "keywords": [
+    "wecom",
+    "aibot",
+    "plugin",
+    "openai",
+    "agent"
+  ],
+  "author": "",
+  "license": "MIT",
+  "description": "独立运行的企业微信私有部署 AI 机器人插件，支持对接第三方智能体（OpenAI API 兼容）",
+  "dependencies": {
+    "@wecom/aibot-node-sdk": "^1.0.4",
+    "express": "^4.21.0",
+    "file-type": "^21.3.0"
+  },
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^25.0.7",
+    "@rollup/plugin-json": "^6.1.0",
+    "@rollup/plugin-node-resolve": "^15.2.3",
+    "@rollup/plugin-typescript": "^11.1.6",
+    "@types/express": "^4.17.21",
+    "@types/node": "^20.11.0",
+    "rollup": "^4.9.6",
+    "rollup-plugin-dts": "^6.1.0",
+    "tslib": "^2.6.2",
+    "typescript": "^5.3.3"
+  }
+}