@yanhaidao/wecom 2.4.120 → 2.5.110

package/changelog/v2.3.19.md

@@ -1,73 +0,0 @@
-# OpenClaw WeCom 插件 v2.3.19 变更简报
-
-> [!TIP]
-> `v2.3.19` 主要修了四件和真实使用强相关的问题：第一，本机图片/文件终于能更自然地发出去，不再默认只认 OpenClaw 自己目录里的文件；第二，走 Bot WebSocket 时，`dynamicAgents` 也会真正生效，不会再出现“同样开了动态路由，但 WS 会话还是串到主 Agent”这种割裂行为；第三，媒体大小上限开始统一跟随 OpenClaw 标准配置 `mediaMaxMb`，不再是 WeCom 插件自己一套、OpenClaw 主配置又是一套；第四，Bot WS 对话里的图片/文件现在会尽量留在当前 Bot WS 对话里发送，不再静默切到 Agent 私聊链路。
-
-## 2026-03-19（v2.3.19）
-- 【修复 WS 不走 dynamicAgents】**[重要修复]** 之前 `dynamicAgents` 只在旧消息链路上生效，新的 Bot WebSocket 统一运行时没有把这层路由覆盖带进去。结果就是，同样一份配置，在 Webhook 或 Agent 路径上能按“每个用户 / 每个群”隔离会话，但走 WS 时却可能重新落回主 Agent。现在 WS 运行时也会执行同样的动态路由逻辑，单聊、群聊的隔离行为终于统一了。
-- 【修正 Bot WS 对话里的媒体回落策略】**[重要修复]** 如果当前消息本来就在 Bot WS 对话流里，图片/文件发送现在会优先并固定留在同一个 Bot WS 会话内处理。一旦已经尝试过 WS 发送，就不再静默回落到 Agent 私聊链路，避免用户明明在一个 Bot 对话里操作，结果媒体却从另一个 Agent 会话发出来。这个调整只针对 Bot WS，对 Bot Webhook 模式没有影响。
-- 【统一媒体大小配置到 OpenClaw 标准】之前 WeCom 插件内部主要认自己的 `channels.wecom.media.maxBytes`，而不是 OpenClaw 通用的 `mediaMaxMb`。这会带来一个很直接的问题：你明明已经在 OpenClaw 里把媒体大小放宽了，WeCom 这边却还像没看见一样。现在插件会优先读取 `channels.wecom.mediaMaxMb`，并支持 `channels.wecom.accounts.<accountId>.mediaMaxMb` 做账号级覆盖；旧的 `channels.wecom.media.maxBytes` 仍然保留兼容，但只作为历史配置兜底。
-- 【补齐 Bot WS 媒体发送链路的大小透传】Bot WS 在读取本地文件、下载远程媒体并上传到企业微信前，现在会真正带上解析后的 `mediaMaxMb` 上限，而不是继续走内部固定值。换句话说，媒体大小限制终于从“写在配置里”和“运行时真的执行”两边对齐了。
-- 【放宽本地文件默认可发送目录】之前本地媒体白名单更偏向 OpenClaw 自己的状态目录，所以像 `~/Downloads/01.png` 这种很自然的用户文件路径，虽然文件确实存在，也会被当成“不允许发送”。现在插件默认额外放行常见用户目录：`~/Desktop`、`~/Documents`、`~/Downloads`、`~/Movies`、`~/Pictures`。对普通用户来说，这意味着“桌面、下载、图片目录里的文件”现在默认就更符合直觉地可发送了。
-- 【支持继续追加自定义本地媒体目录】除了默认目录外，现在仍然可以通过 `channels.wecom.media.localRoots` 继续追加共享盘、挂载盘、业务导出目录等自定义路径。这里的设计原则很简单：默认给出大多数人会用到的目录，但不假设所有企业的数据都在同一个地方。
-- 【文案与排障提示同步更新】当媒体太大或解密失败时，提示语现在会直接指向 `channels.wecom.mediaMaxMb` 这套推荐配置，避免用户继续被旧的 `media.maxBytes` 误导。
-
-## 这次改动背后的最小理解模型
-
-把这次版本理解成四句话就够了：
-
-1. **会话该隔离的，要真的隔离。**  
-   你开了 `dynamicAgents`，系统就应该不管走 Webhook、Agent Callback 还是 Bot WS，都稳定地把“不同用户 / 不同群”落到不同会话上，而不是不同链路表现不一致。
-
-2. **从哪个对话开始，就该尽量在哪个对话里发回去。**  
-   如果用户是在 Bot WS 对话里让系统发图，那么结果也应该优先回到这个 Bot WS 对话，而不是悄悄切到 Agent 私聊。否则用户看到的“会话边界”和系统内部实际走的链路会分裂。
-
-3. **配置写在哪里，运行时就该认哪里。**  
-   OpenClaw 既然已经把媒体大小的标准字段定成 `mediaMaxMb`，WeCom 插件就不该再偷偷主要走自己那套 `media.maxBytes`。统一之后，用户只需要记住一套规则。
-
-4. **用户的文件，默认应该在用户常用目录里。**  
-   大多数人发文件，不会先把图拷进 `.openclaw/media`，而是直接从下载目录、桌面、图片目录发。默认路径如果违背这个常识，系统虽然“安全”，但体验是不成立的。
-
-## 推荐配置
-
-```json
-{
-  "channels": {
-    "wecom": {
-      "mediaMaxMb": 50,
-      "media": {
-        "tempDir": "/tmp/openclaw-wecom-media",
-        "localRoots": [
-          "/srv/company-share",
-          "/data/reports"
-        ]
-      },
-      "dynamicAgents": {
-        "enabled": true,
-        "dmCreateAgent": true,
-        "groupEnabled": true,
-        "adminUsers": ["your-admin-userid"]
-      }
-    }
-  }
-}
-```
-
-## 升级后你应该感受到的变化
-
-- 从 `Downloads`、`Desktop` 这类常见目录直接发图、发文件，更容易一次成功。
-- 同样开启 `dynamicAgents` 的前提下，Bot WS 会话也会像其他链路一样稳定隔离，不再更容易串上下文。
-- 如果当前就是 Bot WS 对话流，发图、发文件会优先留在这个对话里处理，不会再更容易“跳”到 Agent 私聊。
-- 调整 `mediaMaxMb` 后，WeCom 插件的上传 / 解密 / 读取链路会真正跟着变化，而不是“配置改了，行为没改”。
-
-## 仍然需要知道的边界
-
-- `mediaMaxMb` 控制的是 OpenClaw 这边愿意读取和处理多大的媒体，不代表企业微信协议本身没有限制。
-- 企业微信自身的媒体限制仍然存在，例如图片 / 视频超过 10MB、语音超过 2MB、文件超过 20MB 时，最终行为仍受企业微信接口约束。
-- 旧配置 `channels.wecom.media.maxBytes` 目前还兼容，但新配置建议统一迁移到 `channels.wecom.mediaMaxMb`。
-
-## 升级提示
-
-- 执行 `openclaw plugins update wecom` 即可升级到 `v2.3.19`。
-- 如果你之前遇到“WS 开了 dynamicAgents 但还是串到主 Agent”“明明在 Bot WS 对话里发图，结果却从 Agent 私聊发出来”，或“明明改了媒体大小配置却没有生效”，这一版就是针对这些问题的直接修复。
-- 如果你的文件仍然不在默认目录内，例如 NAS、共享盘或业务导出盘，请继续在 `channels.wecom.media.localRoots` 中追加对应路径。

package/changelog/v2.3.2.md

@@ -1,28 +0,0 @@
-# OpenClaw WeCom 插件 v2.3.2 变更简报
-
-> [!WARNING]
-> **OpenClaw 3.1+ 升级必读**：升级到 OpenClaw `3.1` 及以上版本的用户务必同步升级本插件，并将企业微信回调 URL 更新为 OpenClaw 推荐路径：`/plugins/wecom/bot/{accountId}` 与 `/plugins/wecom/agent/{accountId}`（旧 `/wecom/*` 仍兼容但不再维护）。
-
-## 2026-03-03（今日）
-- 【路由兼容】🧩 修复 OpenClaw 3.1 下 Control UI fallback 可能抢占 `/wecom/*` webhook 的路由冲突问题。  
-- 【引导收敛】🧭 将 WeCom onboarding 统一为账号化配置写入 `channels.wecom.accounts.<accountId>`，不再引导单账号旧结构。  
-- 【回调路径】🔁 将 WeCom 回调路径的推荐方案统一为 `/plugins/wecom/bot/{accountId}` 与 `/plugins/wecom/agent/{accountId}`。  
-- 【兼容策略】🔁 保留 `/wecom/*` 历史回调路径兼容能力，但不再维护旧路径分支。  
-- 【分流稳定】🧭 将 monitor 分流升级为按插件命名空间账号路径识别，确保 Bot/Agent 稳定命中。  
-- 【链路一致】🔒 将 Bot 上下文 `Surface` 对齐为 `wecom`，避免核心误判后错误走到 Agent outbound。  
-- 【账号必填】🧱 在 matrix 模式下对无 accountId 的基础路径返回 `wecom_matrix_path_required`，强制使用账号化回调路径。  
-- 【文档同步】📘 将回调地址文档与 onboarding 提示统一为 `/plugins/wecom/*/{accountId}` 唯一推荐路径。  
-
-## 2026-03-02（v2.3.2 主体）
-- 【交付收口】🔄 修复 Bot 结果回写后“正在搜索相关内容”不收口的问题，并在可用时推送最终流帧结束思考态。  
-- 【媒体兜底】📎 统一非图片文件、媒体失败和超时场景为“Bot 提示 + Agent 私信兜底”闭环，保证结果可达。  
-- 【工具治理】🛡 修复 WeCom Bot 会话中 `message` 工具禁用位置，避免模型绕过 Bot 交付链路直接主动发送。  
-- 【类型兼容】🧠 扩展本地与远端文件 MIME 识别覆盖 `txt/docx/xlsx/pptx/csv/zip` 等常见类型，并保留 `octet-stream` 重试兜底。  
-- 【判定增强】🔍 将入站文件类型推断升级为“文件头特征 + 响应头 + 文件名后缀”多层判定，提升无后缀和异常 URL 的识别准确率。  
-
-## 验证结果
-- WeCom 插件测试通过 `10` 个测试文件共 `41` 条用例，覆盖 webhook 生命周期、路径分流、媒体兜底与回归场景。  
-
-## 升级提示
-- 推荐在企业微信后台使用 `https://<your-domain>/plugins/wecom/bot/{accountId}` 与 `https://<your-domain>/plugins/wecom/agent/{accountId}` 作为回调地址。  
-- 旧地址 `/wecom/bot/{accountId}` 与 `/wecom/agent/{accountId}` 仍兼容但不再维护，建议尽快迁移到 `/plugins/wecom/*/{accountId}`。  

package/changelog/v2.3.26.md

@@ -1,21 +0,0 @@
-# OpenClaw WeCom 插件 v2.3.26 变更简报
-
-> [!TIP]
-> 这一版主要就是把最近最烦人的几类问题修顺了：升级后不再乱报错，Agent 和 Bot WS 不再乱串回复，Bot WS 发图片后不再多冒一条 `Done...`，占位符也不会一直卡着不收。
-
-## 2026-03-26（v2.3.26）
-- 修复了 OpenClaw 升级后 `wecom` 插件报 `is not a function` 的问题。之前是 SDK 导入路径没跟着新版调整，这一版已经统一修好。
-- 修复了 Agent 和 Bot WS 串回复的问题。现在是谁收到消息，就尽量由谁来回复，不再出现“在 Agent 里说话，结果 Bot WS 回你”这种情况。
-- 修复了 Bot WS 会话里发图片后的收尾问题。之前常见表现是：`正在思考` -> 图片 -> 又多一条 `Done!...`。现在最终文字会尽量接回原来的回复链路，不再额外多发一条完成提示。
-- 修复了 `message` 工具和 Bot WS 占位符不同步的问题。现在如果图片或文本已经发出去了，占位符不会还在那里一直刷“正在思考...”。
-- 顺手加强了“全局安装的 OpenClaw + 本地 wecom 插件源码”这种混合运行方式下的稳定性，开发时不容易再出现一边生效、一边不生效的割裂情况。
-
-## 升级后你会感受到
-- 升级 OpenClaw 后，`wecom` 插件不再因为导入问题直接报错。
-- Agent 和 Bot WS 同时开着时，回复会更稳地留在正确的对话里。
-- Bot WS 发图、发文件后，回复看起来更像一条完整对话，不会再碎成好几段。
-- 占位符会更自然地结束，不会一直停在“正在思考...”。
-
-## 升级提示
-- 执行 `openclaw plugins update wecom` 即可升级到 `v2.3.26`。
-- 如果你是“全局 `openclaw` + 本地 `extensions/wecom` 源码”在跑，升级后记得完整重启 gateway。

package/changelog/v2.3.27.md

@@ -1,33 +0,0 @@
-# OpenClaw WeCom 插件 v2.3.27 变更简报
-
-> [!TIP]
-> `v2.3.27` 是一个以“升级兼容”和“接入恢复”为主的修复版本。重点解决三类真实会挡住使用的问题：第一，`channel add` 里 `wecom` 又能正常被识别和添加了；第二，修复了部分用户在配置或选择渠道时遇到的 `ReferenceError: installedCatalogById is not defined`；第三，把这轮 OpenClaw 升级后 `wecom` 插件里几处已经失效的 SDK 旧入口统一迁到了当前可用的公共接口，避免出现“有的地方能跑、有的地方一升级就炸”的割裂状态。
-
-## 2026-03-27（v2.3.27）
-- 【恢复 `channel add` 接入】**[重要修复]** 之前在 OpenClaw 的渠道添加流程里，`wecom` 虽然已经安装，但仍可能被显示成 “does not support guided setup yet”，导致用户无法直接从 `channel add` 走完接入。现在插件已经切到 OpenClaw 当前识别的 `setupWizard` 接口，`wecom` 会重新出现在正常的 guided setup 流程中。
-- 【修复 `installedCatalogById is not defined`】**[重要修复]** 某些用户在渠道选择或安装判断阶段会直接撞到 `ReferenceError: installedCatalogById is not defined`，表现上像是“选了渠道就报错”或“添加流程突然失效”。这次已经把对应的渠道目录访问逻辑改稳，不再依赖容易失效的解构引用。
-- 【迁移失效的插件 SDK 入口】OpenClaw 升级后，`wecom` 插件里原来直接从 `openclaw/plugin-sdk` 根入口拿的一些类型和能力，已经不再按旧方式导出。`v2.3.27` 已经把这几处高风险点迁到当前公开可用的子路径，重点覆盖了工具上下文、outbound 适配器和媒体发送相关接口。
-- 【修复 `wecom_mcp` 工具返回协议】随着 OpenClaw 新版工具结果协议收紧，`wecom_mcp` 这类插件工具如果还按旧格式返回，就会在注册或执行阶段出现类型或运行时不匹配。现在该工具返回结果已经补齐新版要求的 `details` 字段，和当前工具调用协议保持一致。
-- 【修复 Bot WS 媒体发送对旧导出的依赖】之前 Bot WebSocket 媒体发送链路依赖了一个在当前发布版 OpenClaw 中已经不可直接使用的媒体加载导出，升级后容易出现“代码看起来没问题，但媒体链路单独报错”的情况。现在媒体读取改为基于当前仍然公开可用的远程抓取、本地路径校验和 MIME 识别能力自行组装，兼容当前版本的 OpenClaw 发布面。
-- 【补齐严格类型下的 WS 回复头处理】随着依赖和 SDK 类型变严格，Bot WS 主动回复和命令回复链路里对 `req_id` 头部的处理更容易暴露问题。这一版顺手把回复头的兜底生成与返回值收窄一起补齐，减少升级后只在某些路径上报类型错误或运行时异常的概率。
-
-## 升级后你会直接感受到
-
-- 在 OpenClaw 里重新执行 `channel add` 时，`wecom` 不会再被误判成“不支持 guided setup”。
-- 遇到 `ReferenceError: installedCatalogById is not defined` 的用户，渠道添加和选择流程会恢复正常。
-- OpenClaw 升级后，`wecom` 插件不再那么依赖旧版 SDK 的根入口导出，单独安装或混合运行时更稳。
-- Bot WS 的媒体发送链路不再因为旧导出失效而单独掉链子。
-
-## 这次版本背后的最小理解模型
-
-把这次更新理解成三句话就够了：
-
-1. OpenClaw 的渠道接入面已经变了，`wecom` 不能再继续挂在旧的 onboarding 接口上。
-2. 插件如果直接依赖 `openclaw/plugin-sdk` 根入口里那些历史上“顺手可用”的符号，升级后迟早会踩到导出面收缩的问题。
-3. 真正稳定的兼容修复，不只是把一个 import 改过去，而是把接入流程、工具返回协议、outbound 类型和媒体链路一起对齐到当前公开接口。
-
-## 升级提示
-
-- 执行 `openclaw plugins update wecom` 即可升级到 `v2.3.27`。
-- 如果你刚升级 OpenClaw 后发现 `wecom` 在 `channel add` 里突然不能配置，或者用户侧开始报 `installedCatalogById is not defined`，这一版就是对应修复。
-- 如果你是“全局安装的 OpenClaw + 本地 `wecom` 源码插件”混合运行，升级后建议完整重启一次 gateway，确保新的 setup 和 outbound 逻辑都已生效。

package/changelog/v2.3.4.md

@@ -1,20 +0,0 @@
-# OpenClaw WeCom 插件 v2.3.4 变更简报
-
-> [!WARNING]
-> **可用性热修复版本**：`v2.3.4` 重点修复 OpenClaw 3.1+ 下 WeCom webhook 路由兼容与可达性问题，保障历史配置可继续使用。
-
-## 2026-03-03（v2.3.4 热修复）
-- 【SDK适配】♻️ 插件入口从 `registerHttpHandler` 迁移为 `registerHttpRoute`（`/plugins/wecom` + `match=prefix` + `auth=plugin`），兼容 OpenClaw 新版插件 HTTP 注册模型。  
-- 【兼容修复】🔁 补回旧路径入口注册：新增 `/wecom` 前缀路由注册，确保历史 Bot/Agent webhook 继续可达。  
-- 【模式兼容】🧭 保持 legacy 单账号配置可运行，并明确 matrix 模式必须使用带 `accountId` 的回调路径。  
-
-## 影响说明
-- WeCom Bot/Agent 业务链路保持兼容；核心变化为插件 HTTP 注册 API 的升级适配与旧路径可达性恢复。  
-
-## 兼容矩阵（单账号/多账号）
-| 场景 | 配置形态 | 回调地址 | 兼容状态 | 说明 |
-|---|---|---|---|---|
-| 历史单账号（legacy） | `channels.wecom.bot/agent` | Bot: `/wecom`（默认）或 `/wecom/bot`；Agent: `/wecom/agent` | ✅ 兼容保留 | 适用于存量部署，不作为新引导方案。 |
-| 多账号（matrix）错误用法 | `channels.wecom.accounts.*` | `/wecom/bot`、`/wecom/agent`（无 accountId） | ❌ 不可用 | 会返回 `wecom_matrix_path_required`。 |
-| 多账号（matrix）兼容路径 | `channels.wecom.accounts.*` | `/wecom/bot/{accountId}`、`/wecom/agent/{accountId}` | ✅ 兼容保留 | 历史路径可用，但不再维护。 |
-| 多账号（matrix）推荐路径 | `channels.wecom.accounts.*` | `/plugins/wecom/bot/{accountId}`、`/plugins/wecom/agent/{accountId}` | ✅ 推荐 | 当前主维护路径。 |

package/changelog/v2.3.9.md

@@ -1,22 +0,0 @@
-# OpenClaw WeCom 插件 v2.3.9 变更简报
-
-> [!TIP]
-> **易用性与可观测性版本**：`v2.3.9` 重点优化默认 Bot WebSocket 接入体验、中文 onboarding、Bot/Agent 回调稳定性与排障日志。
-
-## 2026-03-09（v2.3.9）
-- 【默认接入】🚀 Bot onboarding 默认收敛为 `WebSocket` 模式，直接引导填写 `bot.ws.botId` 与 `bot.ws.secret`，新用户无需域名即可接入。
-- 【主动消息】📣 在引导文案中明确 Bot WS 支持主动发消息，适合定时任务、异常提醒、工作流通知等企业场景。
-- 【中文体验】🈶 企业微信插件自管账号创建与私聊策略配置流程，减少重复英文提示与术语负担。
-- 【流式修复】🌊 修复 Bot WS 仅输出最终结果的问题，恢复块级流式交付能力。
-- 【路由稳定】🧭 统一 HTTP 分发链路，并补齐默认账号的显式 Bot/Agent 回调路径别名，降低回调命中偏差。
-- 【排障增强】🔎 增加 Agent callback 原始请求、解密摘要、发送请求与响应日志，便于定位“能接收但不能回复”的问题。
-- 【配置清理】🧹 移除 `bot.enabled` / `agent.enabled` 冗余字段，README 与配置模型保持一致。
-
-## 验证结果
-- `bunx vitest run extensions/wecom/src/onboarding.test.ts extensions/wecom/src/channel.meta.test.ts`
-- `pnpm build`
-
-## 升级提示
-- 默认推荐继续使用 `Bot WebSocket` 模式；如需公网回调，可手动补充 `bot.webhook`。
-- 推荐回调路径使用 `/plugins/wecom/bot/{accountId}` 与 `/plugins/wecom/agent/{accountId}`。
-- `package.json` 与插件元数据已同步更新为 `WeCom (企业微信)`，便于在 OpenClaw 渠道列表中直接识别。

package/changelog/v2.4.12.md

@@ -1,37 +0,0 @@
-# OpenClaw WeCom 插件 v2.4.12 变更简报
-
-> [!TIP]
-> `v2.4.12` 是一个“新增能力 + 接入修稳”并行推进的版本。最直接的三个变化是：第一，企业微信自建应用现在可以把菜单点击这类 `event` 事件按规则路由到本地脚本处理；第二，Agent 通道现在补齐了上下游企业用户的识别与回传链路；第三，Webhook 入站附件在进入会话工作区时，不会再被固定 `5MB` 的旧限制误伤，媒体落盘和后续会话使用更符合当前配置。
-
-## 2026-04-12（v2.4.12）
-- 【新增优化】**自建应用菜单事件支持路由到本地脚本**。现在企业微信自建应用收到 `click` 等 `event` 事件后，可以根据 `eventType`、`eventKey`、`changeType` 等条件命中规则，再交给本地 `Node.js` 或 `Python` 脚本处理。也就是说，菜单项终于不只是“点了有事件”，而是可以直接接你自己的自动化逻辑。
-- 【新增优化】**脚本可直接回复，也可继续链到默认 Agent**。本地脚本既可以直接返回一段文本给用户，也可以通过 `chainToAgent` 控制是否继续进入默认 AI 流程。适合做“菜单先走本地轻逻辑，复杂问题再交给 Agent”的组合式处理。
-- 【接入增强】**事件路由规则已进入正式配置面**。这一版把事件路由、脚本运行时白名单、超时和输出大小等配置都纳入了插件配置结构里，便于在多账号场景下做显式治理，而不是靠零散脚本硬接。
-- 【新增能力】**支持上下游企业通过 Agent 渠道互通**。如果你的自建应用已经共享给上下游企业，现在插件可以根据回调里的下游 `CorpID` 识别上下游用户，并结合 `agent.upstreamCorps` 把回复准确发回对应企业，而不是错误地回到主企业通道。
-- 【体验补齐】**上下游企业链路下的图片和语音发送一起补稳了**。这意味着上下游企业用户不再只是“文本能通、媒体掉链”，图片和语音等常见媒体回复也能跟着同一条 Agent 链路走通。
-- 【体验修复】**Webhook 入站文件进入工作区时，不再被固定 5MB 限制误拦**。之前某些从企业微信发进来的附件，明明账号配置已经放宽了大小限制，但在进入会话工作区前还是会被旧的固定阈值挡住。现在这条链路已经改成按当前 WeCom 配置解析后的大小限制执行。
-- 【稳定性增强】**工作区媒体暂存更适合后续 Agent 使用**。入站媒体进入工作区后的路径、命名冲突处理和沙箱会话下的落点都补得更完整，后续让 Agent 读取附件、基于文件继续处理时更稳。
-
-## 升级后你会直接感受到
-
-- 企业微信自建应用菜单现在可以真正接本地自动化脚本，不需要所有按钮都先兜一圈 AI。
-- 你可以把“帮助”“状态查询”“同步”“触发内部流程”这类菜单动作做成确定性的本地处理，再按需决定是否继续交给 Agent。
-- 如果你的应用已经共享给上下游企业，下游企业用户现在可以沿着 Agent 通道正常收发消息，不再更容易出现“识别到了消息，但回复回不去”。
-- 上下游企业场景下的图片、语音等媒体回复会比之前稳得多，不再只剩文本链路勉强可用。
-- 从企业微信发进来的文件，尤其是大于 5MB 但仍在你实际配置范围内的附件，不会再在进入工作区前被莫名其妙拦下。
-- 后续基于这些入站文件继续做 Agent 分析、摘要或处理时，整体链路会更顺。
-
-## 这次版本背后的最小理解模型
-
-把这次更新理解成三句话就够了：
-
-1. `wecom` 现在不只是“收消息 -> 丢给 AI”，而是多了一层可编排的事件路由，你可以先让菜单事件命中本地脚本。
-2. 企业微信上下游企业用户，已经可以通过 `agent.upstreamCorps` 接到正确的 Agent 回传链路，不再默认只按主企业处理。
-3. 企业微信入站附件进入会话工作区的链路，已经从“固定阈值拦截”改成“跟随当前配置”，真实可用性明显更高。
-
-## 升级提示
-
-- 执行 `openclaw plugins update wecom` 即可升级到 `v2.4.12`。
-- 如果你准备启用菜单事件脚本，请同时检查 `scriptRuntime.allowPaths`，确保脚本目录已加入允许列表。
-- 如果你准备启用上下游企业回复，请补齐 `channels.wecom.accounts.<accountId>.agent.upstreamCorps`，并确认企业微信后台已完成应用共享。
-- 如果你之前遇到“Webhook 收到了文件，但进不了工作区”或“大文件总在落盘前被拦”的情况，这一版就是对应修复。

package/compat-single-account.md

@@ -1,148 +0,0 @@
-# 附录 A：WeCom 单账号兼容模式配置指南
-
-> 本文档用于历史部署或小规模场景。  
-> 新项目默认推荐多账号矩阵配置（`accounts + bindings.match.accountId`）。
-
-## A.1 适用场景
-
-- 已在线运行单账号配置，短期内不希望迁移。
-- 只有一个 Bot / Agent，不需要账号隔离。
-- 本地 PoC 或临时验证链路。
-
-## A.2 快速配置
-
-### A.2.1 仅 Bot（单智能体）
-
-```bash
-openclaw config set channels.wecom.enabled true
-openclaw config set channels.wecom.bot.token "YOUR_BOT_TOKEN"
-openclaw config set channels.wecom.bot.encodingAESKey "YOUR_BOT_AES_KEY"
-openclaw config set channels.wecom.bot.receiveId ""
-openclaw config set channels.wecom.bot.primaryTransport "webhook"
-openclaw config set channels.wecom.bot.streamPlaceholderContent "正在思考..."
-openclaw config set channels.wecom.bot.welcomeText "你好！我是 AI 助手"
-
-# DM 门禁（推荐显式设置 policy）
-openclaw config set channels.wecom.bot.dm.policy "open"
-openclaw config set channels.wecom.bot.dm.allowFrom '["*"]'
-```
-
-### A.2.2 增加 Agent 兜底（可选）
-
-```bash
-openclaw config set channels.wecom.agent.corpId "YOUR_CORP_ID"
-openclaw config set channels.wecom.agent.agentSecret "YOUR_AGENT_SECRET"
-openclaw config set channels.wecom.agent.agentId 1000001
-openclaw config set channels.wecom.agent.token "YOUR_CALLBACK_TOKEN"
-openclaw config set channels.wecom.agent.encodingAESKey "YOUR_CALLBACK_AES_KEY"
-openclaw config set channels.wecom.agent.welcomeText "欢迎使用智能助手"
-openclaw config set channels.wecom.agent.dm.policy "open"
-openclaw config set channels.wecom.agent.dm.allowFrom '["*"]'
-```
-
-### A.2.3 验证
-
-```bash
-openclaw gateway restart
-openclaw channels status
-```
-
-## A.3 完整单账号配置结构
-
-```jsonc
-{
-  "channels": {
-    "wecom": {
-      "enabled": true,
-
-      "bot": {
-        "aibotid": "BOT_ID_OPTIONAL",
-        "token": "YOUR_BOT_TOKEN",
-        "encodingAESKey": "YOUR_BOT_AES_KEY",
-        "botIds": ["BOT_ID_OPTIONAL"],
-        "receiveId": "",
-        "streamPlaceholderContent": "正在思考...",
-        "welcomeText": "你好！我是 AI 助手",
-        "dm": {
-          "policy": "open",
-          "allowFrom": ["*"]
-        }
-      },
-
-      "agent": {
-        "corpId": "YOUR_CORP_ID",
-        "agentSecret": "YOUR_AGENT_SECRET",
-        "agentId": 1000001,
-        "token": "YOUR_CALLBACK_TOKEN",
-        "encodingAESKey": "YOUR_CALLBACK_AES_KEY",
-        "welcomeText": "欢迎使用智能助手",
-        "dm": {
-          "policy": "open",
-          "allowFrom": ["*"]
-        }
-      },
-
-      "media": {
-        "tempDir": "/tmp/openclaw-wecom-media",
-        "retentionHours": 24,
-        "cleanupOnStart": true,
-        "maxBytes": 26214400
-      },
-
-      "network": {
-        "timeoutMs": 15000,
-        "retries": 2,
-        "retryDelayMs": 500,
-        "egressProxyUrl": "http://proxy.company.local:3128"
-      },
-
-      "dynamicAgents": {
-        "enabled": false,
-        "dmCreateAgent": false,
-        "groupEnabled": false,
-        "adminUsers": []
-      }
-    }
-  }
-}
-```
-
-## A.4 Webhook 路径
-
-- Bot Webhook: `/plugins/wecom/bot`（推荐），兼容 `/wecom/bot`、`/wecom`
-- Agent Callback: `/plugins/wecom/agent`（推荐），兼容 `/wecom/agent`
-
-说明：
-
-- 路径由系统派生，不建议额外维护自定义 path。
-- 如果 Bot 主 transport 改成 `ws`，则 Bot 不再依赖 HTTP callback，但 Agent Callback 仍可保留。
-
-## A.4.1 Bot WS 单账号示例
-
-```bash
-openclaw config set channels.wecom.bot.primaryTransport "ws"
-openclaw config set channels.wecom.bot.ws.botId "YOUR_BOT_ID"
-openclaw config set channels.wecom.bot.ws.secret "YOUR_BOT_SECRET"
-```
-
-运维检查：
-
-```bash
-openclaw channels status --deep
-```
-
-重点看：
-
-- `primaryTransport`
-- `transport`
-- `health`
-- `ownerId`
-- `lastError`
-- `lastInboundAt`
-- `lastOutboundAt`
-
-## A.5 迁移建议
-
-如果后续需要多 Bot / 多 Agent 隔离，建议迁移到多账号矩阵模式：
-- 在 `channels.wecom.accounts.<accountId>` 下拆分配置
-- 通过 `bindings[].match.accountId` 映射到对应 OpenClaw agent

package/index.test.ts

@@ -1,38 +0,0 @@
-import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
-import { describe, expect, it, vi } from "vitest";
-import plugin from "./index.js";
-
-describe("wecom plugin register", () => {
-  it("registers both recommended and legacy webhook route prefixes", () => {
-    const registerChannel = vi.fn();
-    const registerHttpRoute = vi.fn();
-    const registerTool = vi.fn();
-    const on = vi.fn();
-    const api = {
-      runtime: {},
-      registerChannel,
-      registerHttpRoute,
-      registerTool,
-      on,
-    } as unknown as OpenClawPluginApi;
-
-    plugin.register(api);
-
-    expect(registerChannel).toHaveBeenCalledTimes(1);
-    expect(registerHttpRoute).toHaveBeenCalledTimes(2);
-    expect(registerHttpRoute).toHaveBeenCalledWith(
-      expect.objectContaining({
-        path: "/plugins/wecom",
-        auth: "plugin",
-        match: "prefix",
-      }),
-    );
-    expect(registerHttpRoute).toHaveBeenCalledWith(
-      expect.objectContaining({
-        path: "/wecom",
-        auth: "plugin",
-        match: "prefix",
-      }),
-    );
-  });
-});

package/scripts/test-proxy.ts

@@ -1,70 +0,0 @@
-import { wecomFetch } from "../src/http.js";
-
-const args = process.argv.slice(2);
-let proxyUrl = "";
-
-if (args.includes("--host")) {
-    const hostIndex = args.indexOf("--host");
-    const portIndex = args.indexOf("--port");
-    const userIndex = args.indexOf("--user");
-    const passIndex = args.indexOf("--pass");
-
-    if (hostIndex === -1 || portIndex === -1) {
-        console.error("Error: --host and --port are required when using specific params.");
-        process.exit(1);
-    }
-
-    const host = args[hostIndex + 1];
-    const port = args[portIndex + 1];
-    const user = userIndex !== -1 ? args[userIndex + 1] : "";
-    const pass = passIndex !== -1 ? args[passIndex + 1] : "";
-
-    if (user && pass) {
-        // Safe encoding
-        proxyUrl = `http://${encodeURIComponent(user)}:${encodeURIComponent(pass)}@${host}:${port}`;
-    } else {
-        proxyUrl = `http://${host}:${port}`;
-    }
-} else {
-    proxyUrl = args[0] || process.env.PROXY_URL || "";
-}
-
-if (!proxyUrl) {
-  console.error("Usage: npx tsx extensions/wecom/scripts/test-proxy.ts <proxy_url>");
-  console.error("   OR: npx tsx extensions/wecom/scripts/test-proxy.ts --host <ip> --port <port> --user <u?> --pass <p?>");
-  process.exit(1);
-}
-
-console.log(`Testing proxy: ${proxyUrl.replace(/:([^:@]+)@/, ":***@")}`); // Mask password in log
-
-async function run() {
-  try {
-    // 1. Test IP echo to verify traffic goes through proxy
-    console.log("1. Checking IP via httpbin.org...");
-    const ipRes = await wecomFetch("https://httpbin.org/ip", {}, { proxyUrl, timeoutMs: 10000 });
-    if (!ipRes.ok) {
-        throw new Error(`IP check failed: ${ipRes.status} ${ipRes.statusText}`);
-    }
-    const ipJson = await ipRes.json();
-    console.log("   Result:", ipJson);
-
-    // 2. Test WeCom API connectivity
-    console.log("2. Checking WeCom connectivity...");
-    const wecomRes = await wecomFetch("https://qyapi.weixin.qq.com/cgi-bin/gettoken", {}, { proxyUrl, timeoutMs: 10000 });
-    const wecomJson = await wecomRes.json();
-    console.log("   Result:", wecomJson);
-    console.log("✅ Proxy works!");
-
-  } catch (err) {
-    // Extract cause for better debugging
-    const cause = (err as any).cause;
-    if (cause) {
-        console.error("❌ Proxy test failed (Cause):", cause);
-    } else {
-        console.error("❌ Proxy test failed:", err);
-    }
-    process.exit(1);
-  }
-}
-
-run();

package/scripts/wecom/README.md

@@ -1,123 +0,0 @@
-# WeCom 事件脚本示例
-
-本目录提供可直接运行的 WeCom Agent 事件路由脚本示例。
-
-## 文件说明
-
-- `menu-click-help.js`：Node.js 菜单点击事件示例。
-- `menu-click-help.py`：Python 菜单点击事件示例。
-
-## 输入协议
-
-脚本从 `stdin` 接收一份 JSON envelope。当前结构如下：
-
-```json
-{
-  "version": "1.0",
-  "channel": "wecom",
-  "accountId": "default",
-  "receivedAt": 1760000000000,
-  "message": {
-    "msgType": "event",
-    "eventType": "click",
-    "eventKey": "MENU_HELP",
-    "changeType": null,
-    "fromUser": "zhangsan",
-    "toUser": "wwxxxx",
-    "chatId": null,
-    "agentId": 1000001,
-    "createTime": 1760000000,
-    "msgId": "1234567890",
-    "raw": {
-      "ToUserName": "wwxxxx",
-      "FromUserName": "zhangsan",
-      "MsgType": "event",
-      "Event": "click",
-      "EventKey": "MENU_HELP",
-      "AgentID": "1000001"
-    }
-  },
-  "route": {
-    "matchedRuleId": "menu_help_click",
-    "handlerType": "node_script"
-  }
-}
-```
-
-### 输入字段说明
-
-- `version`：协议版本，当前固定为 `1.0`。
-- `channel`：渠道标识，当前固定为 `wecom`。
-- `accountId`：命中的企微账号 ID。
-- `receivedAt`：路由层接收事件时的毫秒时间戳。
-- `message.msgType`：消息类型，事件场景一般是 `event`。
-- `message.eventType`：事件类型（例如 `click`、`change_contact`）。
-- `message.eventKey`：事件键，可能为空。
-- `message.changeType`：二级事件类型，仅部分事件存在（例如 `change_contact`）。
-- `message.fromUser`：发送者 UserId。
-- `message.toUser`：接收方 corpId。
-- `message.chatId`：群聊 ID，单聊可能为 `null`。
-- `message.agentId`：应用 AgentID。
-- `message.createTime`：企微事件时间戳（秒）。
-- `message.msgId`：消息 ID，某些事件可能为 `null`。
-- `message.raw`：完整原始对象（XML 解析结果），新增字段会优先在这里透传。
-- `route.matchedRuleId`：命中的路由规则 ID。
-- `route.handlerType`：当前执行器类型（`node_script` 或 `python_script`）。
-
-## 输出协议
-
-脚本需要向 `stdout` 输出一份 JSON。当前支持的关键字段：
-
-- `ok`：可选，布尔值，表示脚本是否成功处理。
-- `action`：可选，当前支持 `none` 或 `reply_text`。
-- `reply.text`：当 `action=reply_text` 时使用，作为回复内容。
-- `chainToAgent`：可选，脚本侧动态决定是否继续进入默认 Agent（AI）流程；最终结果还会与 handler 配置里的 `chainToAgent` 做合并，只要任一方为 `true` 就会继续。
-- `audit.tags`：可选，审计标签数组。
-- `error`：可选，错误信息。
-
-### 示例 1：直接回复并终止默认流程
-
-```json
-{
-  "ok": true,
-  "action": "reply_text",
-  "reply": { "text": "已收到 MENU_HELP" },
-  "chainToAgent": false
-}
-```
-
-### 示例 2：不回复，继续默认流程
-
-```json
-{
-  "ok": true,
-  "action": "none",
-  "chainToAgent": true
-}
-```
-
-### `chainToAgent` 补充说明
-
-- 这里的 `chainToAgent` 只代表脚本返回的动态结果，不是唯一决策来源。
-- 如果路由 handler 中也配置了 `"chainToAgent": true`，那么即使脚本返回 `false`，最终仍会继续进入默认 Agent 流程。
-- 如果要让脚本完全决定是否继续，handler 里不要写 `chainToAgent`。
-
-### 示例 3：失败回包（可选）
-
-```json
-{
-  "ok": false,
-  "action": "reply_text",
-  "reply": { "text": "处理失败，请稍后重试" },
-  "chainToAgent": false,
-  "error": "invalid params"
-}
-```
-
-## 注意事项
-
-- 输出必须是严格 JSON。
-- 不要在 `stdout` 混入调试日志；调试信息请写到 `stderr`。
-- 非 0 退出码或非法 JSON 会被视为 handler 执行失败。
-- 脚本路径必须落在 `scriptRuntime.allowPaths` 允许目录内。
-- 脚本应尽量快速返回，避免触发超时（由 `timeoutMs/defaultTimeoutMs` 控制）。