ylib-wecom-openclaw-plugin 2026.4.29

package/dist/src/config-schema.js

@@ -0,0 +1,146 @@
+"use strict";
+exports.__esModule = true;
+exports.WeComConfigSchema = void 0;
+var zod_1 = require("zod");
+var wecomAgentSchema = zod_1.z
+    .object({
+    corpId: zod_1.z.string().optional(),
+    corpSecret: zod_1.z.string().optional(),
+    agentId: zod_1.z.union([zod_1.z.string(), zod_1.z.number()]).optional(),
+    token: zod_1.z.string().optional(),
+    encodingAESKey: zod_1.z.string().optional()
+})
+    .passthrough();
+var wecomNetworkSchema = zod_1.z
+    .object({
+    egressProxyUrl: zod_1.z.string().optional()
+})
+    .passthrough();
+var wecomMediaSchema = zod_1.z
+    .object({
+    maxFileSizeMB: zod_1.z.number().optional(),
+    allowedMimeTypes: zod_1.z.array(zod_1.z.string()).optional()
+})
+    .passthrough();
+var wecomDynamicAgentsSchema = zod_1.z
+    .object({
+    enabled: zod_1.z.boolean().optional(),
+    mappings: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).optional()
+})
+    .passthrough();
+var wecomAccountSchema = zod_1.z.object({
+    // -------------------------------------------------------------------------
+    // 基础账号信息
+    // -------------------------------------------------------------------------
+    /** 账号显示名称（仅用于展示和日志）。 */
+    name: zod_1.z.string().optional(),
+    /** 是否启用该账号。 */
+    enabled: zod_1.z.boolean().optional(),
+    /** Bot WebSocket 地址。 */
+    websocketUrl: zod_1.z.string().optional(),
+    /** Bot 模式凭证：botId。 */
+    botId: zod_1.z.string().optional(),
+    /** Bot 模式凭证：secret。 */
+    secret: zod_1.z.string().optional(),
+    // -------------------------------------------------------------------------
+    // Bot 连接模式字段（固定 WebSocket）
+    // -------------------------------------------------------------------------
+    /** 连接模式：固定 `websocket`（只读，不可编辑）。 */
+    connectionMode: zod_1.z["enum"](["websocket"])
+        .optional()["default"]("websocket")
+        .meta({ readOnly: true, description: "企业微信仅支持 websocket（固定值，不可修改）" }),
+    /** Bot Webhook token。 */
+    token: zod_1.z.string().optional(),
+    /** Bot Webhook AES Key。 */
+    encodingAESKey: zod_1.z.string().optional(),
+    /** Bot Webhook receiveId。 */
+    receiveId: zod_1.z.string().optional(),
+    /** enter_chat 欢迎语。 */
+    welcomeText: zod_1.z.string().optional(),
+    /** 流式首帧占位文案。 */
+    streamPlaceholderContent: zod_1.z.string().optional(),
+    // -------------------------------------------------------------------------
+    // Python Endpoint / Gateway 字段
+    // -------------------------------------------------------------------------
+    /** Python/Gateway 基础地址。 */
+    gatewayBaseUrl: zod_1.z.string().optional(),
+    /** Gateway 鉴权令牌。 */
+    gatewayToken: zod_1.z.string().optional(),
+    /** 媒体上传基址。 */
+    uploadHost: zod_1.z.string().optional(),
+    /** endpoint 调用模型名（默认 `main`）。 */
+    modelName: zod_1.z.string().optional()["default"]("main"),
+    /** endpoint 调用 agentId（默认 `main`）。 */
+    agentId: zod_1.z.string().optional()["default"]("main"),
+    // -------------------------------------------------------------------------
+    // 运行时注入只读字段（前端不可编辑）
+    // -------------------------------------------------------------------------
+    /** 作用域类型（由后端运行时注入）。 */
+    scopeType: zod_1.z.string().optional()["default"]("workspace").meta({ readOnly: true }),
+    /** Workspace ID（由后端运行时注入）。 */
+    workspaceId: zod_1.z.string().optional()["default"]("").meta({ readOnly: true }),
+    /** 项目 ID（历史兼容字段，由后端运行时注入）。 */
+    projectId: zod_1.z.string().optional()["default"]("").meta({ readOnly: true }),
+    /** 作用域类型 snake/camel 兼容字段（只读）。 */
+    scope_kind: zod_1.z.string().optional().meta({ readOnly: true }),
+    /** 作用域类型 snake/camel 兼容字段（只读）。 */
+    scopeKind: zod_1.z.string().optional().meta({ readOnly: true }),
+    /** 作用域类型 snake/camel 兼容字段（只读）。 */
+    scope_type: zod_1.z.string().optional().meta({ readOnly: true }),
+    /** Workspace ID snake_case 兼容字段（只读）。 */
+    workspace_id: zod_1.z.string().optional().meta({ readOnly: true }),
+    /** 项目 ID snake_case 兼容字段（只读）。 */
+    project_id: zod_1.z.string().optional().meta({ readOnly: true }),
+    /** 历史 type 字段（只读）。 */
+    type: zod_1.z.string().optional().meta({ readOnly: true }),
+    /** 是否按会话类型拆分 session（固定 true，不可修改）。 */
+    separateSessionByConversation: zod_1.z
+        .boolean()
+        .optional()["default"](true)
+        .meta({ readOnly: true, description: "是否按单聊/群聊区分 session（固定值，不可修改）" }),
+    /** 群聊会话粒度（固定 `group_sender`，不可修改）。 */
+    groupSessionScope: zod_1.z["enum"](["group_sender"])
+        .optional()["default"]("group_sender")
+        .meta({ readOnly: true, description: "群组按人隔离会话模式（固定值，不可修改）" }),
+    // -------------------------------------------------------------------------
+    // 访问控制与消息策略
+    // -------------------------------------------------------------------------
+    /** 私聊白名单。 */
+    allowFrom: zod_1.z.array(zod_1.z.union([zod_1.z.string(), zod_1.z.number()])).optional(),
+    /** 私聊访问策略。 */
+    dmPolicy: zod_1.z["enum"](["open", "allowlist", "pairing", "disabled"]).optional(),
+    /** 群访问策略。 */
+    groupPolicy: zod_1.z["enum"](["open", "allowlist", "disabled"]).optional(),
+    /** 群白名单（仅 groupPolicy=allowlist 生效）。 */
+    groupAllowFrom: zod_1.z.array(zod_1.z.union([zod_1.z.string(), zod_1.z.number()])).optional(),
+    /** 分群配置（每个群可独立 sender 白名单等）。 */
+    groups: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).optional(),
+    /** 是否发送“思考中”占位。 */
+    sendThinkingMessage: zod_1.z.boolean().optional(),
+    /**
+     * 默认关闭以保持历史输出；开启后普通 content、sub-agent 过程文本和资源过程产物不展示，
+     * 但 error 与主流程确认兜底仍会展示，避免失败信息丢失或确认流程卡住。
+     */
+    showFinalAnswerOnly: zod_1.z.boolean().optional()["default"](false),
+    /** 本地媒体可访问根目录白名单。 */
+    mediaLocalRoots: zod_1.z.array(zod_1.z.string()).optional(),
+    // -------------------------------------------------------------------------
+    // 子模块配置
+    // -------------------------------------------------------------------------
+    /** Agent 模式子配置（自建应用）。 */
+    agent: wecomAgentSchema.optional(),
+    /** 网络子配置。 */
+    network: wecomNetworkSchema.optional(),
+    /** 媒体子配置。 */
+    media: wecomMediaSchema.optional(),
+    /** 动态 Agent 子配置。 */
+    dynamicAgents: wecomDynamicAgentsSchema.optional()
+});
+exports.WeComConfigSchema = wecomAccountSchema.extend({
+    /** 多账号默认账号 ID。 */
+    defaultAccount: zod_1.z.string().optional(),
+    /** 多账号配置映射（accountId -> accountConfig）。 */
+    accounts: zod_1.z.record(zod_1.z.string(), wecomAccountSchema).optional(),
+    /** 配置快照更新时间（管理端写入）。 */
+    channelConfigUpdatedAt: zod_1.z.string().optional()
+});

package/dist/src/const.d.ts

@@ -0,0 +1,128 @@
+/**
+ * 企业微信渠道常量定义
+ */
+/**
+ * 企业微信渠道 ID
+ */
+export declare const CHANNEL_ID: "wecom";
+/**
+ * 企业微信 WebSocket 命令枚举
+ */
+export declare enum WeComCommand {
+    /** 认证订阅 */
+    SUBSCRIBE = "aibot_subscribe",
+    /** 心跳 */
+    PING = "ping",
+    /** 企业微信推送消息 */
+    AIBOT_CALLBACK = "aibot_callback",
+    /** clawdbot 响应消息 */
+    AIBOT_RESPONSE = "aibot_response"
+}
+/** 图片下载超时时间（毫秒） */
+export declare const IMAGE_DOWNLOAD_TIMEOUT_MS = 30000;
+/** 文件下载超时时间（毫秒） */
+export declare const FILE_DOWNLOAD_TIMEOUT_MS = 60000;
+/** 消息发送超时时间（毫秒） */
+export declare const REPLY_SEND_TIMEOUT_MS = 15000;
+/** 企业微信流式消息服务端约 10 分钟过期；本地提前降级为主动发送，避免触发 846608。 */
+export declare const STREAM_REPLY_LOCAL_TTL_MS: number;
+/** 消息处理总超时时间（毫秒） */
+export declare const MESSAGE_PROCESS_TIMEOUT_MS: number;
+/** WebSocket 心跳间隔（毫秒） */
+export declare const WS_HEARTBEAT_INTERVAL_MS = 30000;
+/** WebSocket 连接断开时的最大重连次数 */
+export declare const WS_MAX_RECONNECT_ATTEMPTS = 10;
+/** WebSocket 认证失败时的最大重试次数 */
+export declare const WS_MAX_AUTH_FAILURE_ATTEMPTS = 5;
+/** messageStates Map 条目的最大 TTL（毫秒），防止内存泄漏 */
+export declare const MESSAGE_STATE_TTL_MS: number;
+/** messageStates Map 清理间隔（毫秒） */
+export declare const MESSAGE_STATE_CLEANUP_INTERVAL_MS = 60000;
+/** messageStates Map 最大条目数 */
+export declare const MESSAGE_STATE_MAX_SIZE = 500;
+/** WebSocket 全局实例键 */
+export declare const GLOBAL_WS_CLIENT_KEY: "__wecom_openclaw_ws_client_instances";
+/** "思考中"流式消息占位内容 */
+export declare const THINKING_MESSAGE = "<think></think>";
+/** 仅包含图片时的消息占位符 */
+export declare const MEDIA_IMAGE_PLACEHOLDER = "<media:image>";
+/** 仅包含文件时的消息占位符 */
+export declare const MEDIA_DOCUMENT_PLACEHOLDER = "<media:document>";
+/** 获取 MCP 配置的 WebSocket 命令 */
+export declare const MCP_GET_CONFIG_CMD = "aibot_get_mcp_config";
+/** 发送业务消息的 WebSocket 命令（如文档授权卡片） */
+export declare const AIBOT_SEND_BIZ_MSG_CMD = "aibot_send_biz_msg";
+/** 业务消息超时时间（毫秒） */
+export declare const BIZ_MSG_SEND_TIMEOUT_MS = 10000;
+/** MCP 配置拉取超时时间（毫秒） */
+export declare const MCP_CONFIG_FETCH_TIMEOUT_MS = 15000;
+/** 默认媒体大小上限（MB） */
+export declare const DEFAULT_MEDIA_MAX_MB = 5;
+/** 文本分块大小上限 */
+export declare const TEXT_CHUNK_LIMIT = 4000;
+/** 图片大小上限（字节）：10MB */
+export declare const IMAGE_MAX_BYTES: number;
+/** 视频大小上限（字节）：10MB */
+export declare const VIDEO_MAX_BYTES: number;
+/** 语音大小上限（字节）：2MB */
+export declare const VOICE_MAX_BYTES: number;
+/** 文件大小上限（字节）：20MB */
+export declare const FILE_MAX_BYTES: number;
+/** 文件绝对上限（字节）：超过此值无法发送，等于 FILE_MAX_BYTES */
+export declare const ABSOLUTE_MAX_BYTES: number;
+/** 上传分片大小（字节，Base64 编码前）：512KB */
+export declare const UPLOAD_CHUNK_SIZE: number;
+/** 版本检查事件名称（SDK 事件监听用） */
+export declare const EVENT_ENTER_CHECK_UPDATE = "event.enter_check_update";
+/** 版本检查事件回复命令名称 */
+export declare const CMD_ENTER_EVENT_REPLY = "ww_ai_robot_enter_event";
+/** WSClient scene 参数：企微 OpenClaw 场景 */
+export declare const SCENE_WECOM_OPENCLAW = 1;
+/**
+ * WeCom 双模式常量定义
+ */
+/** 固定 Webhook 路径 */
+export declare const WEBHOOK_PATHS: {
+    /** Bot 模式历史兼容路径（不再维护） */
+    readonly BOT: "/wecom";
+    /** Bot 模式历史备用兼容路径（不再维护） */
+    readonly BOT_ALT: "/wecom/bot";
+    /** Agent 模式历史兼容路径（不再维护） */
+    readonly AGENT: "/wecom/agent";
+    /** Bot 模式推荐路径前缀 */
+    readonly BOT_PLUGIN: "/plugins/wecom/bot";
+    /** Agent 模式推荐路径前缀 */
+    readonly AGENT_PLUGIN: "/plugins/wecom/agent";
+};
+/** 企业微信 API 端点 */
+export declare const API_ENDPOINTS: {
+    readonly GET_TOKEN: "https://qyapi.weixin.qq.com/cgi-bin/gettoken";
+    readonly SEND_MESSAGE: "https://qyapi.weixin.qq.com/cgi-bin/message/send";
+    readonly SEND_APPCHAT: "https://qyapi.weixin.qq.com/cgi-bin/appchat/send";
+    readonly UPLOAD_MEDIA: "https://qyapi.weixin.qq.com/cgi-bin/media/upload";
+    readonly DOWNLOAD_MEDIA: "https://qyapi.weixin.qq.com/cgi-bin/media/get";
+};
+/** 各类限制常量 */
+export declare const LIMITS: {
+    /** 文本消息最大字节数 */
+    readonly TEXT_MAX_BYTES: 2048;
+    /** Token 刷新缓冲时间 (提前刷新) */
+    readonly TOKEN_REFRESH_BUFFER_MS: 60000;
+    /** HTTP 请求超时 */
+    readonly REQUEST_TIMEOUT_MS: 15000;
+    /** 最大请求体大小 */
+    readonly MAX_REQUEST_BODY_SIZE: number;
+};
+/** AES 加密常量 */
+export declare const CRYPTO: {
+    /** PKCS#7 块大小 */
+    readonly PKCS7_BLOCK_SIZE: 32;
+    /** AES Key 长度 */
+    readonly AES_KEY_LENGTH: 32;
+};
+/** 合法的模板卡片 card_type 列表 */
+export declare const VALID_CARD_TYPES: string[];
+/** 模板卡片缓存条目 TTL（毫秒）：24小时 */
+export declare const TEMPLATE_CARD_CACHE_TTL_MS: number;
+/** 模板卡片缓存最大条目数 */
+export declare const TEMPLATE_CARD_CACHE_MAX_SIZE = 300;

package/dist/src/const.js

@@ -0,0 +1,168 @@
+"use strict";
+/**
+ * 企业微信渠道常量定义
+ */
+exports.__esModule = true;
+exports.TEMPLATE_CARD_CACHE_MAX_SIZE = exports.TEMPLATE_CARD_CACHE_TTL_MS = exports.VALID_CARD_TYPES = exports.CRYPTO = exports.LIMITS = exports.API_ENDPOINTS = exports.WEBHOOK_PATHS = exports.SCENE_WECOM_OPENCLAW = exports.CMD_ENTER_EVENT_REPLY = exports.EVENT_ENTER_CHECK_UPDATE = exports.UPLOAD_CHUNK_SIZE = exports.ABSOLUTE_MAX_BYTES = exports.FILE_MAX_BYTES = exports.VOICE_MAX_BYTES = exports.VIDEO_MAX_BYTES = exports.IMAGE_MAX_BYTES = exports.TEXT_CHUNK_LIMIT = exports.DEFAULT_MEDIA_MAX_MB = exports.MCP_CONFIG_FETCH_TIMEOUT_MS = exports.BIZ_MSG_SEND_TIMEOUT_MS = exports.AIBOT_SEND_BIZ_MSG_CMD = exports.MCP_GET_CONFIG_CMD = exports.MEDIA_DOCUMENT_PLACEHOLDER = exports.MEDIA_IMAGE_PLACEHOLDER = exports.THINKING_MESSAGE = exports.GLOBAL_WS_CLIENT_KEY = exports.MESSAGE_STATE_MAX_SIZE = exports.MESSAGE_STATE_CLEANUP_INTERVAL_MS = exports.MESSAGE_STATE_TTL_MS = exports.WS_MAX_AUTH_FAILURE_ATTEMPTS = exports.WS_MAX_RECONNECT_ATTEMPTS = exports.WS_HEARTBEAT_INTERVAL_MS = exports.MESSAGE_PROCESS_TIMEOUT_MS = exports.STREAM_REPLY_LOCAL_TTL_MS = exports.REPLY_SEND_TIMEOUT_MS = exports.FILE_DOWNLOAD_TIMEOUT_MS = exports.IMAGE_DOWNLOAD_TIMEOUT_MS = exports.WeComCommand = exports.CHANNEL_ID = void 0;
+/**
+ * 企业微信渠道 ID
+ */
+exports.CHANNEL_ID = "wecom";
+/**
+ * 企业微信 WebSocket 命令枚举
+ */
+var WeComCommand;
+(function (WeComCommand) {
+    /** 认证订阅 */
+    WeComCommand["SUBSCRIBE"] = "aibot_subscribe";
+    /** 心跳 */
+    WeComCommand["PING"] = "ping";
+    /** 企业微信推送消息 */
+    WeComCommand["AIBOT_CALLBACK"] = "aibot_callback";
+    /** clawdbot 响应消息 */
+    WeComCommand["AIBOT_RESPONSE"] = "aibot_response";
+})(WeComCommand = exports.WeComCommand || (exports.WeComCommand = {}));
+// ============================================================================
+// 超时和重试配置
+// ============================================================================
+/** 图片下载超时时间（毫秒） */
+exports.IMAGE_DOWNLOAD_TIMEOUT_MS = 30000;
+/** 文件下载超时时间（毫秒） */
+exports.FILE_DOWNLOAD_TIMEOUT_MS = 60000;
+/** 消息发送超时时间（毫秒） */
+exports.REPLY_SEND_TIMEOUT_MS = 15000;
+/** 企业微信流式消息服务端约 10 分钟过期；本地提前降级为主动发送，避免触发 846608。 */
+exports.STREAM_REPLY_LOCAL_TTL_MS = Math.max(60000, Number(process.env.WECOM_STREAM_REPLY_LOCAL_TTL_MS || "570000") || 570000);
+/** 消息处理总超时时间（毫秒） */
+exports.MESSAGE_PROCESS_TIMEOUT_MS = 6 * 60 * 1000;
+/** WebSocket 心跳间隔（毫秒） */
+exports.WS_HEARTBEAT_INTERVAL_MS = 30000;
+/** WebSocket 连接断开时的最大重连次数 */
+exports.WS_MAX_RECONNECT_ATTEMPTS = 10;
+/** WebSocket 认证失败时的最大重试次数 */
+exports.WS_MAX_AUTH_FAILURE_ATTEMPTS = 5;
+// ============================================================================
+// 消息状态管理配置
+// ============================================================================
+/** messageStates Map 条目的最大 TTL（毫秒），防止内存泄漏 */
+exports.MESSAGE_STATE_TTL_MS = 10 * 60 * 1000;
+/** messageStates Map 清理间隔（毫秒） */
+exports.MESSAGE_STATE_CLEANUP_INTERVAL_MS = 60000;
+/** messageStates Map 最大条目数 */
+exports.MESSAGE_STATE_MAX_SIZE = 500;
+/** WebSocket 全局实例键 */
+exports.GLOBAL_WS_CLIENT_KEY = "__wecom_openclaw_ws_client_instances";
+// ============================================================================
+// 消息模板
+// ============================================================================
+/** "思考中"流式消息占位内容 */
+exports.THINKING_MESSAGE = "<think></think>";
+/** 仅包含图片时的消息占位符 */
+exports.MEDIA_IMAGE_PLACEHOLDER = "<media:image>";
+/** 仅包含文件时的消息占位符 */
+exports.MEDIA_DOCUMENT_PLACEHOLDER = "<media:document>";
+// ============================================================================
+// 默认值
+// ============================================================================
+// ============================================================================
+// MCP 配置
+// ============================================================================
+/** 获取 MCP 配置的 WebSocket 命令 */
+exports.MCP_GET_CONFIG_CMD = "aibot_get_mcp_config";
+/** 发送业务消息的 WebSocket 命令（如文档授权卡片） */
+exports.AIBOT_SEND_BIZ_MSG_CMD = "aibot_send_biz_msg";
+/** 业务消息超时时间（毫秒） */
+exports.BIZ_MSG_SEND_TIMEOUT_MS = 10000;
+/** MCP 配置拉取超时时间（毫秒） */
+exports.MCP_CONFIG_FETCH_TIMEOUT_MS = 15000;
+// ============================================================================
+// 默认值
+// ============================================================================
+/** 默认媒体大小上限（MB） */
+exports.DEFAULT_MEDIA_MAX_MB = 5;
+/** 文本分块大小上限 */
+exports.TEXT_CHUNK_LIMIT = 4000;
+// ============================================================================
+// 媒体上传相关常量
+// ============================================================================
+/** 图片大小上限（字节）：10MB */
+exports.IMAGE_MAX_BYTES = 10 * 1024 * 1024;
+/** 视频大小上限（字节）：10MB */
+exports.VIDEO_MAX_BYTES = 10 * 1024 * 1024;
+/** 语音大小上限（字节）：2MB */
+exports.VOICE_MAX_BYTES = 2 * 1024 * 1024;
+/** 文件大小上限（字节）：20MB */
+exports.FILE_MAX_BYTES = 20 * 1024 * 1024;
+/** 文件绝对上限（字节）：超过此值无法发送，等于 FILE_MAX_BYTES */
+exports.ABSOLUTE_MAX_BYTES = exports.FILE_MAX_BYTES;
+/** 上传分片大小（字节，Base64 编码前）：512KB */
+exports.UPLOAD_CHUNK_SIZE = 512 * 1024;
+// ============================================================================
+// 事件/命令名称常量
+// ============================================================================
+/** 版本检查事件名称（SDK 事件监听用） */
+exports.EVENT_ENTER_CHECK_UPDATE = "event.enter_check_update";
+/** 版本检查事件回复命令名称 */
+exports.CMD_ENTER_EVENT_REPLY = "ww_ai_robot_enter_event";
+// ============================================================================
+// SDK 连接配置
+// ============================================================================
+/** WSClient scene 参数：企微 OpenClaw 场景 */
+exports.SCENE_WECOM_OPENCLAW = 1;
+/**
+ * WeCom 双模式常量定义
+ */
+/** 固定 Webhook 路径 */
+exports.WEBHOOK_PATHS = {
+    /** Bot 模式历史兼容路径（不再维护） */
+    BOT: "/wecom",
+    /** Bot 模式历史备用兼容路径（不再维护） */
+    BOT_ALT: "/wecom/bot",
+    /** Agent 模式历史兼容路径（不再维护） */
+    AGENT: "/wecom/agent",
+    /** Bot 模式推荐路径前缀 */
+    BOT_PLUGIN: "/plugins/wecom/bot",
+    /** Agent 模式推荐路径前缀 */
+    AGENT_PLUGIN: "/plugins/wecom/agent"
+};
+/** 企业微信 API 端点 */
+exports.API_ENDPOINTS = {
+    GET_TOKEN: "https://qyapi.weixin.qq.com/cgi-bin/gettoken",
+    SEND_MESSAGE: "https://qyapi.weixin.qq.com/cgi-bin/message/send",
+    SEND_APPCHAT: "https://qyapi.weixin.qq.com/cgi-bin/appchat/send",
+    UPLOAD_MEDIA: "https://qyapi.weixin.qq.com/cgi-bin/media/upload",
+    DOWNLOAD_MEDIA: "https://qyapi.weixin.qq.com/cgi-bin/media/get"
+};
+/** 各类限制常量 */
+exports.LIMITS = {
+    /** 文本消息最大字节数 */
+    TEXT_MAX_BYTES: 2048,
+    /** Token 刷新缓冲时间 (提前刷新) */
+    TOKEN_REFRESH_BUFFER_MS: 60000,
+    /** HTTP 请求超时 */
+    REQUEST_TIMEOUT_MS: 15000,
+    /** 最大请求体大小 */
+    MAX_REQUEST_BODY_SIZE: 1024 * 1024
+};
+/** AES 加密常量 */
+exports.CRYPTO = {
+    /** PKCS#7 块大小 */
+    PKCS7_BLOCK_SIZE: 32,
+    /** AES Key 长度 */
+    AES_KEY_LENGTH: 32
+};
+// ============================================================================
+// 模板卡片配置
+// ============================================================================
+/** 合法的模板卡片 card_type 列表 */
+exports.VALID_CARD_TYPES = [
+    "text_notice",
+    "news_notice",
+    "button_interaction",
+    "vote_interaction",
+    "multiple_interaction",
+];
+/** 模板卡片缓存条目 TTL（毫秒）：24小时 */
+exports.TEMPLATE_CARD_CACHE_TTL_MS = 24 * 60 * 60 * 1000;
+/** 模板卡片缓存最大条目数 */
+exports.TEMPLATE_CARD_CACHE_MAX_SIZE = 300;

package/dist/src/dm-policy.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 企业微信 DM（私聊）访问控制模块
+ *
+ * 负责私聊策略检查、配对流程
+ */
+import type { RuntimeEnv } from "ylib-openclaw/plugin-sdk";
+import type { WSClient, WsFrame } from "@wecom/aibot-node-sdk";
+import type { ResolvedWeComAccount } from "./utils.js";
+/**
+ * DM Policy 检查结果
+ */
+export interface DmPolicyCheckResult {
+    /** 是否允许继续处理消息 */
+    allowed: boolean;
+    /** 是否已发送配对消息（仅在 pairing 模式下） */
+    pairingSent?: boolean;
+}
+/**
+ * 检查 DM Policy 访问控制
+ * @returns 检查结果，包含是否允许继续处理
+ */
+export declare function checkDmPolicy(params: {
+    senderId: string;
+    isGroup: boolean;
+    account: ResolvedWeComAccount;
+    wsClient: WSClient;
+    frame: WsFrame;
+    runtime: RuntimeEnv;
+}): Promise<DmPolicyCheckResult>;

package/dist/src/dm-policy.js

@@ -0,0 +1,146 @@
+"use strict";
+/**
+ * 企业微信 DM（私聊）访问控制模块
+ *
+ * 负责私聊策略检查、配对流程
+ */
+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.checkDmPolicy = void 0;
+var runtime_js_1 = require("./runtime.js");
+var const_js_1 = require("./const.js");
+var message_sender_js_1 = require("./message-sender.js");
+var group_policy_js_1 = require("./group-policy.js");
+// ============================================================================
+// 公开 API
+// ============================================================================
+/**
+ * 检查 DM Policy 访问控制
+ * @returns 检查结果，包含是否允许继续处理
+ */
+function checkDmPolicy(params) {
+    var _a, _b, _c, _d, _e, _f, _g;
+    return __awaiter(this, void 0, void 0, function () {
+        var senderId, isGroup, account, wsClient, frame, runtime, core, dmPolicy, configAllowFrom, oldStoreAllowFrom, newStoreAllowFrom, storeAllowFrom, effectiveAllowFrom, senderAllowedResult, _h, code, created, err_1;
+        return __generator(this, function (_j) {
+            switch (_j.label) {
+                case 0:
+                    senderId = params.senderId, isGroup = params.isGroup, account = params.account, wsClient = params.wsClient, frame = params.frame, runtime = params.runtime;
+                    core = runtime_js_1.getWeComRuntime();
+                    // 群聊消息不检查 DM Policy
+                    if (isGroup) {
+                        return [2 /*return*/, { allowed: true }];
+                    }
+                    dmPolicy = (_a = account.config.dmPolicy) !== null && _a !== void 0 ? _a : "open";
+                    configAllowFrom = ((_b = account.config.allowFrom) !== null && _b !== void 0 ? _b : []).map(function (v) { return String(v); });
+                    // 如果 dmPolicy 是 disabled，直接拒绝
+                    if (dmPolicy === "disabled") {
+                        (_c = runtime.log) === null || _c === void 0 ? void 0 : _c.call(runtime, "[WeCom] Blocked DM from " + senderId + " (dmPolicy=disabled)");
+                        return [2 /*return*/, { allowed: false }];
+                    }
+                    // 如果是 open 模式，允许所有人
+                    if (dmPolicy === "open") {
+                        return [2 /*return*/, { allowed: true }];
+                    }
+                    return [4 /*yield*/, core.channel.pairing.readAllowFromStore('wecom', undefined, account.accountId)["catch"](function () { return []; })];
+                case 1:
+                    oldStoreAllowFrom = _j.sent();
+                    return [4 /*yield*/, core.channel.pairing
+                            .readAllowFromStore({ channel: const_js_1.CHANNEL_ID, accountId: account.accountId })["catch"](function () { return []; })];
+                case 2:
+                    newStoreAllowFrom = _j.sent();
+                    storeAllowFrom = __spreadArrays(oldStoreAllowFrom, newStoreAllowFrom);
+                    effectiveAllowFrom = __spreadArrays(configAllowFrom, storeAllowFrom);
+                    senderAllowedResult = group_policy_js_1.isSenderAllowed(senderId, effectiveAllowFrom);
+                    if (senderAllowedResult) {
+                        return [2 /*return*/, { allowed: true }];
+                    }
+                    if (!(dmPolicy === "pairing")) return [3 /*break*/, 10];
+                    return [4 /*yield*/, core.channel.pairing.upsertPairingRequest({
+                            channel: const_js_1.CHANNEL_ID,
+                            id: senderId,
+                            accountId: account.accountId,
+                            meta: { name: senderId }
+                        })];
+                case 3:
+                    _h = _j.sent(), code = _h.code, created = _h.created;
+                    if (!created) return [3 /*break*/, 8];
+                    (_d = runtime.log) === null || _d === void 0 ? void 0 : _d.call(runtime, "[WeCom] Pairing request created for sender=" + senderId);
+                    _j.label = 4;
+                case 4:
+                    _j.trys.push([4, 6, , 7]);
+                    return [4 /*yield*/, message_sender_js_1.sendWeComReply({
+                            wsClient: wsClient,
+                            frame: frame,
+                            text: core.channel.pairing.buildPairingReply({
+                                channel: const_js_1.CHANNEL_ID,
+                                idLine: "\u60A8\u7684\u4F01\u4E1A\u5FAE\u4FE1\u7528\u6237ID: " + senderId,
+                                code: code
+                            }),
+                            runtime: runtime,
+                            finish: true,
+                            accountId: account.accountId
+                        })];
+                case 5:
+                    _j.sent();
+                    return [3 /*break*/, 7];
+                case 6:
+                    err_1 = _j.sent();
+                    (_e = runtime.error) === null || _e === void 0 ? void 0 : _e.call(runtime, "[WeCom] Failed to send pairing reply to " + senderId + ": " + String(err_1));
+                    return [3 /*break*/, 7];
+                case 7: return [3 /*break*/, 9];
+                case 8:
+                    (_f = runtime.log) === null || _f === void 0 ? void 0 : _f.call(runtime, "[WeCom] Pairing request already exists for sender=" + senderId);
+                    _j.label = 9;
+                case 9: return [2 /*return*/, { allowed: false, pairingSent: created }];
+                case 10:
+                    // allowlist 模式：直接拒绝未授权用户
+                    (_g = runtime.log) === null || _g === void 0 ? void 0 : _g.call(runtime, "[WeCom] Blocked unauthorized sender " + senderId + " (dmPolicy=" + dmPolicy + ")");
+                    return [2 /*return*/, { allowed: false }];
+            }
+        });
+    });
+}
+exports.checkDmPolicy = checkDmPolicy;

package/dist/src/dynamic-agent.d.ts

@@ -0,0 +1,37 @@
+/**
+ * **动态 Agent 路由模块**
+ *
+ * 为每个用户/群组自动生成独立的 Agent ID，实现会话隔离。
+ * 参考: openclaw-plugin-wecom/dynamic-agent.js
+ */
+import type { OpenClawConfig } from "ylib-openclaw/plugin-sdk";
+export interface DynamicAgentConfig {
+    enabled: boolean;
+    dmCreateAgent: boolean;
+    groupEnabled: boolean;
+    adminUsers: string[];
+}
+/**
+ * **getDynamicAgentConfig (读取动态 Agent 配置)**
+ *
+ * 从全局配置中读取动态 Agent 配置，提供默认值。
+ */
+export declare function getDynamicAgentConfig(config: OpenClawConfig): DynamicAgentConfig;
+/**
+ * **generateAgentId (生成动态 Agent ID)**
+ *
+ * 根据账号 + 聊天类型 + 对端 ID 生成确定性的 Agent ID，避免多账号串会话。
+ * 格式: wecom-{accountId}-{type}-{sanitizedPeerId}
+ */
+export declare function generateAgentId(chatType: "dm" | "group", peerId: string, accountId?: string): string;
+/**
+ * **shouldUseDynamicAgent (检查是否使用动态 Agent)**
+ *
+ * 根据配置和发送者信息判断是否应使用动态 Agent。
+ * 管理员（adminUsers）始终绕过动态路由，使用主 Agent。
+ */
+export declare function shouldUseDynamicAgent(params: {
+    chatType: "dm" | "group";
+    senderId: string;
+    config: OpenClawConfig;
+}): boolean;