@wecom/wecom-openclaw-plugin 2026.4.2-beta.0 → 2026.4.3-beta.0

package/dist/{esm/types/src → src}/const.d.ts

@@ -70,5 +70,51 @@ 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/{esm/src → src}/const.js

@@ -4,11 +4,11 @@
 /**
  * 企业微信渠道 ID
  */
-const CHANNEL_ID = "wecom";
+export const CHANNEL_ID = "wecom";
 /**
  * 企业微信 WebSocket 命令枚举
  */
-var WeComCommand;
+export var WeComCommand;
 (function (WeComCommand) {
     /** 认证订阅 */
     WeComCommand["SUBSCRIBE"] = "aibot_subscribe";
@@ -23,35 +23,37 @@ var WeComCommand;
 // 超时和重试配置
 // ============================================================================
 /** 图片下载超时时间（毫秒） */
-const IMAGE_DOWNLOAD_TIMEOUT_MS = 30000;
+export const IMAGE_DOWNLOAD_TIMEOUT_MS = 30_000;
 /** 文件下载超时时间（毫秒） */
-const FILE_DOWNLOAD_TIMEOUT_MS = 60000;
+export const FILE_DOWNLOAD_TIMEOUT_MS = 60_000;
 /** 消息发送超时时间（毫秒） */
-const REPLY_SEND_TIMEOUT_MS = 15000;
+export const REPLY_SEND_TIMEOUT_MS = 15_000;
+/** 消息处理总超时时间（毫秒） */
+export const MESSAGE_PROCESS_TIMEOUT_MS = 6 * 60 * 1000;
 /** WebSocket 心跳间隔（毫秒） */
-const WS_HEARTBEAT_INTERVAL_MS = 30000;
+export const WS_HEARTBEAT_INTERVAL_MS = 30_000;
 /** WebSocket 连接断开时的最大重连次数 */
-const WS_MAX_RECONNECT_ATTEMPTS = 10;
+export const WS_MAX_RECONNECT_ATTEMPTS = 10;
 /** WebSocket 认证失败时的最大重试次数 */
-const WS_MAX_AUTH_FAILURE_ATTEMPTS = 5;
+export const WS_MAX_AUTH_FAILURE_ATTEMPTS = 5;
 // ============================================================================
 // 消息状态管理配置
 // ============================================================================
 /** messageStates Map 条目的最大 TTL（毫秒），防止内存泄漏 */
-const MESSAGE_STATE_TTL_MS = 10 * 60 * 1000;
+export const MESSAGE_STATE_TTL_MS = 10 * 60 * 1000;
 /** messageStates Map 清理间隔（毫秒） */
-const MESSAGE_STATE_CLEANUP_INTERVAL_MS = 60000;
+export const MESSAGE_STATE_CLEANUP_INTERVAL_MS = 60_000;
 /** messageStates Map 最大条目数 */
-const MESSAGE_STATE_MAX_SIZE = 500;
+export const MESSAGE_STATE_MAX_SIZE = 500;
 // ============================================================================
 // 消息模板
 // ============================================================================
 /** "思考中"流式消息占位内容 */
-const THINKING_MESSAGE = "<think></think>";
+export const THINKING_MESSAGE = "<think></think>";
 /** 仅包含图片时的消息占位符 */
-const MEDIA_IMAGE_PLACEHOLDER = "<media:image>";
+export const MEDIA_IMAGE_PLACEHOLDER = "<media:image>";
 /** 仅包含文件时的消息占位符 */
-const MEDIA_DOCUMENT_PLACEHOLDER = "<media:document>";
+export const MEDIA_DOCUMENT_PLACEHOLDER = "<media:document>";
 // ============================================================================
 // 默认值
 // ============================================================================
@@ -59,52 +61,97 @@ const MEDIA_DOCUMENT_PLACEHOLDER = "<media:document>";
 // MCP 配置
 // ============================================================================
 /** 获取 MCP 配置的 WebSocket 命令 */
-const MCP_GET_CONFIG_CMD = "aibot_get_mcp_config";
+export const MCP_GET_CONFIG_CMD = "aibot_get_mcp_config";
 /** MCP 配置拉取超时时间（毫秒） */
-const MCP_CONFIG_FETCH_TIMEOUT_MS = 15000;
+export const MCP_CONFIG_FETCH_TIMEOUT_MS = 15_000;
 // ============================================================================
 // 默认值
 // ============================================================================
 /** 默认媒体大小上限（MB） */
-const DEFAULT_MEDIA_MAX_MB = 5;
+export const DEFAULT_MEDIA_MAX_MB = 5;
 /** 文本分块大小上限 */
-const TEXT_CHUNK_LIMIT = 4000;
+export const TEXT_CHUNK_LIMIT = 4000;
 // ============================================================================
 // 媒体上传相关常量
 // ============================================================================
 /** 图片大小上限（字节）：10MB */
-const IMAGE_MAX_BYTES = 10 * 1024 * 1024;
+export const IMAGE_MAX_BYTES = 10 * 1024 * 1024;
 /** 视频大小上限（字节）：10MB */
-const VIDEO_MAX_BYTES = 10 * 1024 * 1024;
+export const VIDEO_MAX_BYTES = 10 * 1024 * 1024;
 /** 语音大小上限（字节）：2MB */
-const VOICE_MAX_BYTES = 2 * 1024 * 1024;
+export const VOICE_MAX_BYTES = 2 * 1024 * 1024;
 /** 文件大小上限（字节）：20MB */
-const FILE_MAX_BYTES = 20 * 1024 * 1024;
+export const FILE_MAX_BYTES = 20 * 1024 * 1024;
 /** 文件绝对上限（字节）：超过此值无法发送，等于 FILE_MAX_BYTES */
-const ABSOLUTE_MAX_BYTES = FILE_MAX_BYTES;
+export const ABSOLUTE_MAX_BYTES = FILE_MAX_BYTES;
+/** 上传分片大小（字节，Base64 编码前）：512KB */
+export const UPLOAD_CHUNK_SIZE = 512 * 1024;
 // ============================================================================
 // 事件/命令名称常量
 // ============================================================================
 /** 版本检查事件名称（SDK 事件监听用） */
-const EVENT_ENTER_CHECK_UPDATE = "event.enter_check_update";
+export const EVENT_ENTER_CHECK_UPDATE = "event.enter_check_update";
 /** 版本检查事件回复命令名称 */
-const CMD_ENTER_EVENT_REPLY = "ww_ai_robot_enter_event";
+export const CMD_ENTER_EVENT_REPLY = "ww_ai_robot_enter_event";
 // ============================================================================
 // SDK 连接配置
 // ============================================================================
 /** WSClient scene 参数：企微 OpenClaw 场景 */
-const SCENE_WECOM_OPENCLAW = 1;
+export const SCENE_WECOM_OPENCLAW = 1;
+/**
+ * WeCom 双模式常量定义
+ */
+/** 固定 Webhook 路径 */
+export const 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 端点 */
+export const 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",
+};
+/** 各类限制常量 */
+export const LIMITS = {
+    /** 文本消息最大字节数 */
+    TEXT_MAX_BYTES: 2048,
+    /** Token 刷新缓冲时间 (提前刷新) */
+    TOKEN_REFRESH_BUFFER_MS: 60_000,
+    /** HTTP 请求超时 */
+    REQUEST_TIMEOUT_MS: 15_000,
+    /** 最大请求体大小 */
+    MAX_REQUEST_BODY_SIZE: 1024 * 1024,
+};
+/** AES 加密常量 */
+export const CRYPTO = {
+    /** PKCS#7 块大小 */
+    PKCS7_BLOCK_SIZE: 32,
+    /** AES Key 长度 */
+    AES_KEY_LENGTH: 32,
+};
 // ============================================================================
 // 模板卡片配置
 // ============================================================================
 /** 合法的模板卡片 card_type 列表 */
-const VALID_CARD_TYPES = [
+export const VALID_CARD_TYPES = [
     "text_notice",
     "news_notice",
     "button_interaction",
     "vote_interaction",
     "multiple_interaction",
 ];
-
-export { ABSOLUTE_MAX_BYTES, CHANNEL_ID, CMD_ENTER_EVENT_REPLY, DEFAULT_MEDIA_MAX_MB, EVENT_ENTER_CHECK_UPDATE, FILE_DOWNLOAD_TIMEOUT_MS, FILE_MAX_BYTES, IMAGE_DOWNLOAD_TIMEOUT_MS, IMAGE_MAX_BYTES, MCP_CONFIG_FETCH_TIMEOUT_MS, MCP_GET_CONFIG_CMD, MEDIA_DOCUMENT_PLACEHOLDER, MEDIA_IMAGE_PLACEHOLDER, MESSAGE_STATE_CLEANUP_INTERVAL_MS, MESSAGE_STATE_MAX_SIZE, MESSAGE_STATE_TTL_MS, REPLY_SEND_TIMEOUT_MS, SCENE_WECOM_OPENCLAW, TEXT_CHUNK_LIMIT, THINKING_MESSAGE, VALID_CARD_TYPES, VIDEO_MAX_BYTES, VOICE_MAX_BYTES, WS_HEARTBEAT_INTERVAL_MS, WS_MAX_AUTH_FAILURE_ATTEMPTS, WS_MAX_RECONNECT_ATTEMPTS, WeComCommand };
-//# sourceMappingURL=const.js.map
+/** 模板卡片缓存条目 TTL（毫秒）：24小时 */
+export const TEMPLATE_CARD_CACHE_TTL_MS = 24 * 60 * 60 * 1000;
+/** 模板卡片缓存最大条目数 */
+export const TEMPLATE_CARD_CACHE_MAX_SIZE = 300;

package/dist/{esm/src → src}/dm-policy.js

@@ -1,13 +1,12 @@
-import { getWeComRuntime } from './runtime.js';
-import { CHANNEL_ID } from './const.js';
-import { sendWeComReply } from './message-sender.js';
-import { isSenderAllowed } from './group-policy.js';
-
 /**
  * 企业微信 DM（私聊）访问控制模块
  *
  * 负责私聊策略检查、配对流程
  */
+import { getWeComRuntime } from "./runtime.js";
+import { CHANNEL_ID } from "./const.js";
+import { sendWeComReply } from "./message-sender.js";
+import { isSenderAllowed } from "./group-policy.js";
 // ============================================================================
 // 公开 API
 // ============================================================================
@@ -15,7 +14,7 @@ import { isSenderAllowed } from './group-policy.js';
  * 检查 DM Policy 访问控制
  * @returns 检查结果，包含是否允许继续处理
  */
-async function checkDmPolicy(params) {
+export async function checkDmPolicy(params) {
     const { senderId, isGroup, account, wsClient, frame, runtime } = params;
     const core = getWeComRuntime();
     // 群聊消息不检查 DM Policy
@@ -34,6 +33,7 @@ async function checkDmPolicy(params) {
         return { allowed: true };
     }
     // OpenClaw <= 2026.2.19 signature: readAllowFromStore(channel, env?, accountId?)
+    // @ts-expect-error — 兼容旧版 SDK 的三参数签名，新版已改为单参数对象
     const oldStoreAllowFrom = await core.channel.pairing.readAllowFromStore('wecom', undefined, account.accountId).catch(() => []);
     // Compatibility fallback for newer OpenClaw implementations.
     const newStoreAllowFrom = await core.channel.pairing
@@ -82,6 +82,3 @@ async function checkDmPolicy(params) {
     runtime.log?.(`[WeCom] Blocked unauthorized sender ${senderId} (dmPolicy=${dmPolicy})`);
     return { allowed: false };
 }
-
-export { checkDmPolicy };
-//# sourceMappingURL=dm-policy.js.map

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

@@ -0,0 +1,37 @@
+/**
+ * **动态 Agent 路由模块**
+ *
+ * 为每个用户/群组自动生成独立的 Agent ID，实现会话隔离。
+ * 参考: openclaw-plugin-wecom/dynamic-agent.js
+ */
+import type { OpenClawConfig } from "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;

package/dist/src/dynamic-agent.js

@@ -0,0 +1,60 @@
+/**
+ * **动态 Agent 路由模块**
+ *
+ * 为每个用户/群组自动生成独立的 Agent ID，实现会话隔离。
+ * 参考: openclaw-plugin-wecom/dynamic-agent.js
+ */
+/**
+ * **getDynamicAgentConfig (读取动态 Agent 配置)**
+ *
+ * 从全局配置中读取动态 Agent 配置，提供默认值。
+ */
+export function getDynamicAgentConfig(config) {
+    const dynamicAgents = config?.channels?.wecom?.dynamicAgents;
+    return {
+        enabled: dynamicAgents?.enabled ?? false,
+        dmCreateAgent: dynamicAgents?.dmCreateAgent ?? true,
+        groupEnabled: dynamicAgents?.groupEnabled ?? true,
+        adminUsers: dynamicAgents?.adminUsers ?? [],
+    };
+}
+function sanitizeDynamicIdPart(value) {
+    return String(value)
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9_-]/g, "_");
+}
+/**
+ * **generateAgentId (生成动态 Agent ID)**
+ *
+ * 根据账号 + 聊天类型 + 对端 ID 生成确定性的 Agent ID，避免多账号串会话。
+ * 格式: wecom-{accountId}-{type}-{sanitizedPeerId}
+ */
+export function generateAgentId(chatType, peerId, accountId) {
+    const sanitizedPeer = sanitizeDynamicIdPart(peerId) || "unknown";
+    const sanitizedAccountId = sanitizeDynamicIdPart(accountId ?? "default") || "default";
+    return `wecom-${sanitizedAccountId}-${chatType}-${sanitizedPeer}`;
+}
+/**
+ * **shouldUseDynamicAgent (检查是否使用动态 Agent)**
+ *
+ * 根据配置和发送者信息判断是否应使用动态 Agent。
+ * 管理员（adminUsers）始终绕过动态路由，使用主 Agent。
+ */
+export function shouldUseDynamicAgent(params) {
+    const { chatType, senderId, config } = params;
+    const dynamicConfig = getDynamicAgentConfig(config);
+    if (!dynamicConfig.enabled) {
+        return false;
+    }
+    // 管理员绕过动态路由
+    const sender = String(senderId).trim().toLowerCase();
+    const isAdmin = dynamicConfig.adminUsers.some((admin) => admin.trim().toLowerCase() === sender);
+    if (isAdmin) {
+        return false;
+    }
+    if (chatType === "group") {
+        return dynamicConfig.groupEnabled;
+    }
+    return dynamicConfig.dmCreateAgent;
+}

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

@@ -0,0 +1,65 @@
+/**
+ * 动态路由统一处理模块
+ * 提供统一的路由注入接口。
+ */
+import type { OpenClawConfig } from "openclaw/plugin-sdk/core";
+import type { PluginRuntime } from "openclaw/plugin-sdk";
+/**
+ * 路由对象（从 core.channel.routing.resolveAgentRoute 返回）
+ */
+export interface AgentRoute {
+    agentId: string;
+    sessionKey: string;
+    matchedBy: string;
+    accountId: string;
+    mainSessionKey?: string;
+}
+/**
+ * 动态路由处理参数
+ */
+export interface DynamicRoutingParams {
+    /** 原始路由对象 */
+    route: AgentRoute;
+    /** 全局配置 */
+    config: OpenClawConfig;
+    /** 插件运行时 */
+    core: PluginRuntime;
+    /** 账号 ID */
+    accountId: string;
+    /** 会话类型 */
+    chatType: "group" | "dm";
+    /** 对话 ID（群聊为 chatId，私聊为 userId） */
+    chatId: string;
+    /** 发送者用户 ID */
+    senderId: string;
+    /** 日志输出函数（可选） */
+    log?: (msg: string) => void;
+    /** 错误日志输出函数（可选） */
+    error?: (msg: string) => void;
+}
+/**
+ * 动态路由处理结果
+ */
+export interface DynamicRoutingResult {
+    /** 是否使用动态 Agent */
+    useDynamicAgent: boolean;
+    /** 最终的 agentId（可能被动态注入修改） */
+    finalAgentId: string;
+    /** 最终的 sessionKey（可能被动态注入修改） */
+    finalSessionKey: string;
+    /** 是否修改了路由（注入了动态 Agent） */
+    routeModified: boolean;
+}
+/**
+ * 统一处理动态路由注入逻辑
+ *
+ * 功能：
+ * 1. 判断是否需要使用动态 Agent
+ * 2. 根据 matchedBy 判断配置类型
+ * 3. 返回最终的路由信息（不修改传入的 route 对象）
+ * 4. 输出详细的调试日志
+ *
+ * @param params 动态路由处理参数
+ * @returns 处理结果
+ */
+export declare function processDynamicRouting(params: DynamicRoutingParams): DynamicRoutingResult;

package/dist/src/dynamic-routing.js

@@ -0,0 +1,58 @@
+/**
+ * 动态路由统一处理模块
+ * 提供统一的路由注入接口。
+ */
+import { shouldUseDynamicAgent, generateAgentId } from "./dynamic-agent.js";
+/**
+ * 统一处理动态路由注入逻辑
+ *
+ * 功能：
+ * 1. 判断是否需要使用动态 Agent
+ * 2. 根据 matchedBy 判断配置类型
+ * 3. 返回最终的路由信息（不修改传入的 route 对象）
+ * 4. 输出详细的调试日志
+ *
+ * @param params 动态路由处理参数
+ * @returns 处理结果
+ */
+export function processDynamicRouting(params) {
+    const { route, config, accountId, chatType, chatId, senderId, log } = params;
+    log?.(`[dynamic-routing] 🔍 调试 - matchedBy=${route.matchedBy}, agentId=${route.agentId}`);
+    if (route.matchedBy !== "default") {
+        log?.(`[dynamic-routing] ℹ️  检测到匹配的 bindings (matchedBy=${route.matchedBy})，跳过动态路由`);
+        return {
+            useDynamicAgent: false,
+            finalAgentId: route.agentId,
+            finalSessionKey: route.sessionKey,
+            routeModified: false,
+        };
+    }
+    // 判断是否使用动态 Agent
+    const useDynamicAgent = shouldUseDynamicAgent({
+        chatType,
+        senderId,
+        config,
+    });
+    log?.(`[dynamic-routing] 是否使用动态路由: useDynamicAgent=${useDynamicAgent}`);
+    // 使用动态 Agent
+    if (useDynamicAgent) {
+        log?.(`[dynamic-routing] 原始路由信息: agentId=${route.agentId}, matchedBy=${route.matchedBy}, sessionKey=${route.sessionKey}`);
+        const targetAgentId = generateAgentId(chatType, chatId, accountId);
+        const targetSessionKey = `agent:${targetAgentId}:wecom:${accountId}:${chatType}:${chatId}`;
+        log?.(`[dynamic-routing] 🔄 路由注入: agentId=${targetAgentId}, sessionKey=${targetSessionKey}`);
+        return {
+            useDynamicAgent: true,
+            finalAgentId: targetAgentId,
+            finalSessionKey: targetSessionKey,
+            routeModified: true,
+        };
+    }
+    log?.('[dynamic-routing] 🔄不使用动态路由');
+    // 不使用动态 Agent，返回原始路由
+    return {
+        useDynamicAgent: false,
+        finalAgentId: route.agentId,
+        finalSessionKey: route.sessionKey,
+        routeModified: false,
+    };
+}

package/dist/{esm/src → src}/group-policy.js

@@ -1,10 +1,9 @@
-import { CHANNEL_ID } from './const.js';
-
 /**
  * 企业微信群组访问控制模块
  *
  * 负责群组策略检查（groupPolicy、群组白名单、群内发送者白名单）
  */
+import { CHANNEL_ID } from "./const.js";
 // ============================================================================
 // 内部辅助函数
 // ============================================================================
@@ -76,22 +75,12 @@ function isGroupSenderAllowed(params) {
  * 检查群组策略访问控制
  * @returns 检查结果，包含是否允许继续处理
  */
-function checkGroupPolicy(params) {
-    const { chatId, senderId, account, config, runtime } = params;
-    const wecomConfig = (config.channels?.[CHANNEL_ID] ?? {});
-    const defaultGroupPolicy = config.channels?.[CHANNEL_ID]?.groupPolicy;
-    const groupPolicy = account.config.groupPolicy ?? defaultGroupPolicy ?? "open";
-    // const { groupPolicy, providerMissingFallbackApplied } = resolveOpenProviderRuntimeGroupPolicy({
-    //   providerConfigPresent: config.channels?.[CHANNEL_ID] !== undefined,
-    //   groupPolicy: wecomConfig.groupPolicy,
-    //   defaultGroupPolicy,
-    // });
-    // warnMissingProviderGroupPolicyFallbackOnce({
-    //   providerMissingFallbackApplied,
-    //   providerKey: CHANNEL_ID,
-    //   accountId: account.accountId,
-    //   log: (msg) => runtime.log?.(msg),
-    // });
+export function checkGroupPolicy(params) {
+    const { chatId, senderId, account, runtime } = params;
+    // 使用 account.config（已经过多账号合并），而非顶层 config.channels.wecom
+    // 避免多账户模式下 groupAllowFrom / groups 等字段取不到账号级配置
+    const wecomConfig = account.config;
+    const groupPolicy = wecomConfig.groupPolicy ?? "open";
     const groupAllowFrom = wecomConfig.groupAllowFrom ?? [];
     const groupAllowed = isWeComGroupAllowed({
         groupPolicy,
@@ -116,7 +105,7 @@ function checkGroupPolicy(params) {
 /**
  * 检查发送者是否在允许列表中（通用）
  */
-function isSenderAllowed(senderId, allowFrom) {
+export function isSenderAllowed(senderId, allowFrom) {
     if (allowFrom.includes("*")) {
         return true;
     }
@@ -125,6 +114,3 @@ function isSenderAllowed(senderId, allowFrom) {
         return normalized === senderId || normalized === `user:${senderId}`;
     });
 }
-
-export { checkGroupPolicy, isSenderAllowed };
-//# sourceMappingURL=group-policy.js.map

package/dist/src/http.d.ts

@@ -0,0 +1,26 @@
+/**
+ * **WecomHttpOptions (HTTP 选项)**
+ *
+ * @property proxyUrl 代理服务器地址
+ * @property timeoutMs 请求超时时间 (毫秒)
+ * @property signal AbortSignal 信号
+ */
+export type WecomHttpOptions = {
+    proxyUrl?: string;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+};
+/**
+ * **wecomFetch (统一 HTTP 请求)**
+ *
+ * 基于 `undici` 的 fetch 封装，自动处理 ProxyAgent 和 Timeout。
+ * 所有对企业微信 API 的调用都应经过此函数。
+ */
+export declare function wecomFetch(input: string | URL, init?: RequestInit, opts?: WecomHttpOptions): Promise<Response>;
+/**
+ * **readResponseBodyAsBuffer (读取响应 Body)**
+ *
+ * 将 Response Body 读取为 Buffer，支持最大字节限制以防止内存溢出。
+ * 适用于下载媒体文件等场景。
+ */
+export declare function readResponseBodyAsBuffer(res: Response, maxBytes?: number): Promise<Buffer>;

package/dist/src/http.js

@@ -0,0 +1,93 @@
+import { ProxyAgent, fetch as undiciFetch } from "undici";
+const proxyDispatchers = new Map();
+/**
+ * **getProxyDispatcher (获取代理 Dispatcher)**
+ *
+ * 缓存并复用 ProxyAgent，避免重复创建连接池。
+ */
+function getProxyDispatcher(proxyUrl) {
+    const existing = proxyDispatchers.get(proxyUrl);
+    if (existing)
+        return existing;
+    const created = new ProxyAgent(proxyUrl);
+    proxyDispatchers.set(proxyUrl, created);
+    return created;
+}
+function mergeAbortSignal(params) {
+    const signals = [];
+    if (params.signal)
+        signals.push(params.signal);
+    if (params.timeoutMs && Number.isFinite(params.timeoutMs) && params.timeoutMs > 0) {
+        signals.push(AbortSignal.timeout(params.timeoutMs));
+    }
+    if (!signals.length)
+        return undefined;
+    if (signals.length === 1)
+        return signals[0];
+    return AbortSignal.any(signals);
+}
+/**
+ * **wecomFetch (统一 HTTP 请求)**
+ *
+ * 基于 `undici` 的 fetch 封装，自动处理 ProxyAgent 和 Timeout。
+ * 所有对企业微信 API 的调用都应经过此函数。
+ */
+export async function wecomFetch(input, init, opts) {
+    const proxyUrl = opts?.proxyUrl?.trim() ?? "";
+    const dispatcher = proxyUrl ? getProxyDispatcher(proxyUrl) : undefined;
+    const initSignal = init?.signal ?? undefined;
+    const signal = mergeAbortSignal({ signal: opts?.signal ?? initSignal, timeoutMs: opts?.timeoutMs });
+    const headers = new Headers(init?.headers ?? {});
+    if (!headers.has("User-Agent")) {
+        headers.set("User-Agent", "OpenClaw/2.0 (WeCom-Agent)");
+    }
+    const nextInit = {
+        ...(init ?? {}),
+        ...(signal ? { signal } : {}),
+        ...(dispatcher ? { dispatcher } : {}),
+        headers,
+    };
+    try {
+        return await undiciFetch(input, nextInit);
+    }
+    catch (err) {
+        if (err instanceof Error && err.name === "TypeError" && err.message === "fetch failed") {
+            const cause = err.cause;
+            console.error(`[wecom-http] fetch failed: ${input} (proxy: ${proxyUrl || "none"})${cause ? ` - cause: ${String(cause)}` : ""}`);
+        }
+        throw err;
+    }
+}
+/**
+ * **readResponseBodyAsBuffer (读取响应 Body)**
+ *
+ * 将 Response Body 读取为 Buffer，支持最大字节限制以防止内存溢出。
+ * 适用于下载媒体文件等场景。
+ */
+export async function readResponseBodyAsBuffer(res, maxBytes) {
+    if (!res.body)
+        return Buffer.alloc(0);
+    const limit = maxBytes && Number.isFinite(maxBytes) && maxBytes > 0 ? maxBytes : undefined;
+    const chunks = [];
+    let total = 0;
+    const reader = res.body.getReader();
+    while (true) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        if (!value)
+            continue;
+        total += value.byteLength;
+        if (limit && total > limit) {
+            try {
+                await reader.cancel("body too large");
+            }
+            catch {
+                // ignore
+            }
+            throw new Error(`response body too large (>${limit} bytes)`);
+        }
+        chunks.push(value);
+    }
+    return Buffer.concat(chunks.map((c) => Buffer.from(c)));
+}