@openclaw-china/wecom-app 0.1.5 → 0.1.7

package/dist/index.d.ts

@@ -5,8 +5,6 @@ import { IncomingMessage, ServerResponse } from 'http';
  */
 /** DM 消息策略 */
 type WecomAppDmPolicy = "open" | "pairing" | "allowlist" | "disabled";
-/** 群组消息策略 */
-type WecomAppGroupPolicy = "open" | "allowlist" | "disabled";
 /**
  * 企业微信自建应用账户配置
  * 相比普通 wecom 智能机器人，增加了 corpId, corpSecret, agentId 用于主动发送消息
@@ -28,6 +26,8 @@ type WecomAppAccountConfig = {
     corpSecret?: string;
     /** 应用 AgentId (用于主动发送) */
     agentId?: number;
+    /** 企业微信 API 基础地址（可选，默认 https://qyapi.weixin.qq.com） */
+    apiBaseUrl?: string;
     /** 入站媒体（图片/文件）落盘设置 */
     inboundMedia?: {
         /** 是否启用入站媒体落盘（默认 true） */
@@ -57,12 +57,6 @@ type WecomAppAccountConfig = {
     dmPolicy?: WecomAppDmPolicy;
     /** DM 允许列表 */
     allowFrom?: string[];
-    /** 群组策略 */
-    groupPolicy?: WecomAppGroupPolicy;
-    /** 群组允许列表 */
-    groupAllowFrom?: string[];
-    /** 是否需要 @ 提及 */
-    requireMention?: boolean;
 };
 /**
  * 企业微信自建应用配置 (顶层)
@@ -97,10 +91,8 @@ type ResolvedWecomAppAccount = {
 };
 /** 消息发送目标 */
 type WecomAppSendTarget = {
-    /** 用户 ID (与 chatid 二选一) */
-    userId?: string;
-    /** 群聊 ID (与 userId 二选一) */
-    chatid?: string;
+    /** 用户 ID */
+    userId: string;
 };
 /** Access Token 缓存条目 */
 type AccessTokenCacheEntry = {
@@ -111,8 +103,6 @@ type WecomAppInboundBase = {
     MsgId?: string;
     msgid?: string;
     aibotid?: string;
-    chattype?: "single" | "group";
-    chatid?: string;
     response_url?: string;
     from?: {
         userid?: string;
@@ -231,7 +221,7 @@ declare const wecomAppPlugin: {
         order: 84;
     };
     capabilities: {
-        chatTypes: readonly ["direct", "group"];
+        chatTypes: readonly ["direct"];
         media: boolean;
         reactions: boolean;
         threads: boolean;
@@ -273,6 +263,9 @@ declare const wecomAppPlugin: {
                 agentId: {
                     type: string;
                 };
+                apiBaseUrl: {
+                    type: string;
+                };
                 inboundMedia: {
                     type: string;
                     additionalProperties: boolean;
@@ -317,19 +310,6 @@ declare const wecomAppPlugin: {
                         type: string;
                     };
                 };
-                groupPolicy: {
-                    type: string;
-                    enum: string[];
-                };
-                groupAllowFrom: {
-                    type: string;
-                    items: {
-                        type: string;
-                    };
-                };
-                requireMention: {
-                    type: string;
-                };
                 maxFileSizeMB: {
                     type: string;
                 };
@@ -369,6 +349,9 @@ declare const wecomAppPlugin: {
                             agentId: {
                                 type: string;
                             };
+                            apiBaseUrl: {
+                                type: string;
+                            };
                             inboundMedia: {
                                 type: string;
                                 additionalProperties: boolean;
@@ -455,22 +438,13 @@ declare const wecomAppPlugin: {
             allowFrom: (string | number)[];
         }) => string[];
     };
-    groups: {
-        resolveRequireMention: (params: {
-            cfg: PluginConfig;
-            accountId?: string;
-            account?: ResolvedWecomAppAccount;
-        }) => boolean;
-    };
     /**
      * 目录解析 - 用于将 wecom-app:XXX 格式的 target 解析为可投递目标
      *
      * 支持的输入格式：
      * - "wecom-app:user:xxx" → { channel: "wecom-app", to: "user:xxx" }
-     * - "wecom-app:group:xxx" → { channel: "wecom-app", to: "group:xxx" }
      * - "wecom-app:xxx" → { channel: "wecom-app", to: "user:xxx" }
      * - "user:xxx" → { channel: "wecom-app", to: "user:xxx" }
-     * - "group:xxx" → { channel: "wecom-app", to: "group:xxx" }
      * - "xxx" (裸ID) → { channel: "wecom-app", to: "user:xxx" }
      * - 带 accountId: "user:xxx@account1" → { channel: "wecom-app", accountId: "account1", to: "user:xxx" }
      */
@@ -485,6 +459,13 @@ declare const wecomAppPlugin: {
         /**
          * 解析单个目标地址
          * 将各种格式的 target 解析为可用的投递对象
+         *
+         * IMPORTANT: 返回的 `to` 字段必须是纯 ID（不含 user:/group: 前缀），
+         * 因为 OpenClaw 框架会用这个值来匹配 inbound context 中的 From/To 字段。
+         *
+         * 例如：如果 inbound context 的 From 是 "wecom-app:user:CaiHongYu"，
+         * 那么 resolveTarget 必须返回 { channel: "wecom-app", to: "CaiHongYu" }，
+         * 而不是 { channel: "wecom-app", to: "user:CaiHongYu" }。
          */
         resolveTarget: (params: {
             cfg: PluginConfig;
@@ -509,6 +490,9 @@ declare const wecomAppPlugin: {
         /**
          * 获取此通道支持的目标格式说明
          * 用于帮助信息和错误提示
+         *
+         * 注意：虽然支持多种输入格式，但 resolveTarget 返回的 `to` 字段
+         * 始终是纯 ID（不含前缀），以便框架正确匹配 inbound context。
          */
         getTargetFormats: () => string[];
     };
@@ -582,6 +566,7 @@ interface PluginRuntime {
             resolveAgentRoute?: (params: {
                 cfg: unknown;
                 channel: string;
+                accountId?: string;
                 peer: {
                     kind: string;
                     id: string;
@@ -709,7 +694,7 @@ type SendMessageResult = {
  * 发送企业微信应用消息
  *
  * @param account - 已解析的账户配置
- * @param target - 发送目标 (userId 或 chatid)
+ * @param target - 发送目标 (userId)
  * @param message - 消息内容 (会自动移除 Markdown 格式)
  */
 declare function sendWecomAppMessage(account: ResolvedWecomAppAccount, target: WecomAppSendTarget, message: string): Promise<SendMessageResult>;
@@ -739,7 +724,6 @@ declare function downloadAndSendImage(account: ResolvedWecomAppAccount, target:
  *
  * 使用示例：
  * - 私聊：sendWecomDM("caihongyu", { text: "Hello" })
- * - 群聊：sendWecomGroup("wrkxxxxxxx", { text: "Hello" })
  */
 
 /**
@@ -764,14 +748,12 @@ type SendResult = {
  *
  * 输入格式（用户侧传入）：
  * - 私聊："caihongyu" 或 "user:caihongyu"
- * - 群聊："wrkxxxxxx" 或 "group:wrkxxxxxx"
- * - 带 channel 前缀："wecom-app:user:caihongyu" 或 "wecom-app:group:xxx"
+ * - 带 channel 前缀："wecom-app:user:caihongyu"
  *
  * 输出格式（OpenClaw 标准）：
  * - 私聊："user:caihongyu"
- * - 群聊："group:wrkxxxxxx"
  */
-declare function normalizeTarget(target: string, type: "user" | "group"): string;
+declare function normalizeTarget(target: string, type: "user"): string;
 /**
  * 将规范化的 target 字符串解析为 WecomAppSendTarget
  */
@@ -800,31 +782,15 @@ declare function parseTarget(target: string): WecomAppSendTarget;
  */
 declare function sendWecomDM(account: ResolvedWecomAppAccount, userId: string, options: SendMessageOptions): Promise<SendResult>;
 /**
- * 发送群聊消息
- *
- * @param account - 已解析的账户配置
- * @param chatId - 群聊 ID（如 "wrkxxxxxx"），支持带 "group:" 前缀
- * @param options - 消息选项
- *
- * @example
- * ```ts
- * // 发送文本
- * await sendWecomGroup(account, "wrkxxxxxx", { text: "Hello group!" });
- *
- * // 发送图片
- * await sendWecomGroup(account, "wrkxxxxxx", { mediaPath: "/path/to/image.jpg" });
- * ```
- */
-declare function sendWecomGroup(account: ResolvedWecomAppAccount, chatId: string, options: SendMessageOptions): Promise<SendResult>;
-/**
- * 发送消息（自动识别目标类型）
+ * 发送消息（自动识别目标格式）
  *
- * 根据 target 前缀自动判断是私聊还是群聊：
- * - "user:xxx" 或无前缀 → 私聊
- * - "group:xxx" → 群聊
+ * 支持多种 target 格式：
+ * - "user:xxx" → 私聊
+ * - "wecom-app:user:xxx" → 私聊（带 channel 前缀）
+ * - "xxx" → 私聊（裸 ID，默认当作用户）
  *
  * @param account - 已解析的账户配置
- * @param target - 目标（支持 "user:xxx"、"group:xxx"、"xxx" 格式）
+ * @param target - 目标（支持 "user:xxx"、"wecom-app:user:xxx"、"xxx" 格式）
  * @param options - 消息选项
  */
 declare function sendWecom(account: ResolvedWecomAppAccount, target: string, options: SendMessageOptions): Promise<SendResult>;
@@ -865,4 +831,4 @@ declare const plugin: {
     register(api: MoltbotPluginApi): void;
 };
 
-export { type AccessTokenCacheEntry, DEFAULT_ACCOUNT_ID, type MoltbotPluginApi, type ResolvedWecomAppAccount, type SendMessageOptions, type SendResult, type WecomAppConfig, type WecomAppDmPolicy, type WecomAppGroupPolicy, type WecomAppInboundMessage, type WecomAppSendTarget, clearAccessTokenCache, clearAllAccessTokenCache, plugin as default, downloadAndSendImage, getAccessToken, getWecomAppRuntime, normalizeTarget, parseTarget, sendWecom, sendWecomAppImageMessage, sendWecomAppMarkdownMessage, sendWecomAppMessage, sendWecomDM, sendWecomGroup, setWecomAppRuntime, stripMarkdown, wecomAppPlugin };
+export { type AccessTokenCacheEntry, DEFAULT_ACCOUNT_ID, type MoltbotPluginApi, type ResolvedWecomAppAccount, type SendMessageOptions, type SendResult, type WecomAppConfig, type WecomAppDmPolicy, type WecomAppInboundMessage, type WecomAppSendTarget, clearAccessTokenCache, clearAllAccessTokenCache, plugin as default, downloadAndSendImage, getAccessToken, getWecomAppRuntime, normalizeTarget, parseTarget, sendWecom, sendWecomAppImageMessage, sendWecomAppMarkdownMessage, sendWecomAppMessage, sendWecomDM, setWecomAppRuntime, stripMarkdown, wecomAppPlugin };