@yanhaidao/wecom 2.4.120 → 2.5.110

package/README.md

@@ -163,11 +163,10 @@
 > 项目保持高频迭代，全面对齐甚至超越企业真实业务诉求。
 > **为保持精简，以下仅展示近期 5 次重要更新，完整历史版本（含全部 `v2.2.x`）请前往 [changelog/ 目录](./changelog/) 查阅。**
 
-#### 📌 v2.4.12（2026-04-12）
-- **[新增优化] 自建应用菜单事件可路由到本地脚本** ⚙️ 企业微信自建应用收到 `click` 等 `event` 事件后，现在可以按 `eventType`、`eventKey`、`changeType` 等规则命中本地 `Node.js` / `Python` 脚本，不再只能一律进入默认 Agent 流程。
-- **[新增优化] 脚本既能直接回复，也能继续链到 Agent** 🔀 脚本返回结果里可以控制是否继续进入 AI 流程，适合把“菜单先走固定逻辑，复杂问题再交给 Agent”的模式真正落地。
-- **[新增能力] 上下游企业现在可通过 Agent 渠道互通** 🏢 如果你的自建应用已经共享给上下游企业，现在插件可以根据下游 `CorpID` 和 `agent.upstreamCorps` 把回复准确发回对应企业，图片和语音等常见媒体链路也一起补稳了。
-- **[重要修复] Webhook 入站文件不再被固定 5MB 限制误拦** 📎 之前有些企业微信附件虽然在实际配置允许范围内，但进入会话工作区前仍会被旧的固定阈值挡住。这一版已经改成按当前 WeCom 配置解析后的大小限制执行，入站文件接入更稳。
+#### 📌 v2.4.16（2026-04-16）
+- **[版本对齐] 今日 changelog 已补齐到当前包版本** 🧾 `README` 摘要和 `changelog/` 目录现在都直接对应 `package.json` 里的 `v2.4.16`，不会再停留在旧版本号。
+- **[展示修正] 最新版本入口已切换到 `v2.4.16`** 🔖 现在从项目首页查看最近更新时，看到的版本号就是当前实际包版本，减少发布说明和安装版本不一致的困惑。
+- **[维护优化] 变更追踪更直接** 📚 后续如果继续补充 `v2.4.16` 的详细更新内容，可以直接落在 `changelog/v2.4.16.md`，不需要复用旧版本文档。
 
 #### 📌 v2.3.27（2026-03-27）
 - **[重要修复] `channel add` 重新支持 WeCom guided setup** 🧭 之前有些环境下，`wecom` 虽然已经安装，却仍会在 OpenClaw 里显示成 “does not support guided setup yet”，导致无法直接通过交互式向导添加。现在插件已经对齐 OpenClaw 当前的 `setupWizard` 接口，`openclaw channels add` 会重新正常识别和进入配置流程。

package/dist/index.js

@@ -0,0 +1,68 @@
+import { emptyPluginConfigSchema } from "openclaw/plugin-sdk";
+import { registerWecomCalendarTools } from "./src/capability/calendar/tool.js";
+import { registerWecomDocTools } from "./src/capability/doc/tool.js";
+import { createWeComMcpToolFactory } from "./src/capability/mcp/index.js";
+import { wecomPlugin } from "./src/channel.js";
+import { handleWecomWebhookRequest } from "./src/monitor.js";
+import { setWecomRuntime } from "./src/runtime.js";
+import { isWecomBotWsSource } from "./src/runtime/source-registry.js";
+const WECOM_BOT_WS_MEDIA_GUIDANCE = [
+    "【WeCom Bot WS 媒体发送】",
+    "当前会话支持企业微信 Bot WS 媒体发送。",
+    "当你需要发送图片、文件、视频或语音时，必须在回复中单独一行使用 MEDIA: 指令，后面跟本地文件路径。",
+    "格式：MEDIA: /文件的绝对路径",
+    "示例：",
+    "  MEDIA: ~/.openclaw/output.png",
+    "  MEDIA: ~/.openclaw/report.pdf",
+    "注意事项：",
+    "- MEDIA: 必须单独成行并以 MEDIA: 开头",
+    "- 建议优先使用本地可访问路径，而不是远程 URL",
+    "- 图片和视频超过 10MB、语音超过 2MB、文件超过 20MB 时可能会降级或发送失败",
+    "- 语音消息仅原生支持 AMR；其他音频格式会按文件发送",
+].join("\n");
+const plugin = {
+    id: "wecom",
+    name: "WeCom (企业微信)",
+    description: "企业微信官方推荐三方插件，默认 Bot WS，支持主动发消息与统一运行时能力",
+    configSchema: emptyPluginConfigSchema(),
+    /**
+     * **register (注册插件)**
+     *
+     * OpenClaw 插件入口点。
+     * 1. 注入统一 runtime compatibility layer。
+     * 2. 注册 capability-first WeCom 渠道插件。
+     * 3. 注册统一 HTTP 入口（所有 webhook 请求都走共享路由器）。
+     */
+    register(api) {
+        setWecomRuntime(api.runtime);
+        api.registerChannel({ plugin: wecomPlugin });
+        const routes = ["/plugins/wecom", "/wecom"];
+        for (const path of routes) {
+            api.registerHttpRoute({
+                path,
+                handler: handleWecomWebhookRequest,
+                auth: "plugin",
+                match: "prefix",
+            });
+        }
+        // Register WeCom Doc Tools
+        registerWecomDocTools(api);
+        registerWecomCalendarTools(api);
+        api.registerTool(createWeComMcpToolFactory(), { name: "wecom_mcp" });
+        api.on("before_prompt_build", (_event, ctx) => {
+            if (ctx.channelId !== "wecom") {
+                return;
+            }
+            if (!isWecomBotWsSource({
+                sessionKey: ctx.sessionKey,
+                sessionId: ctx.sessionId,
+            })) {
+                return;
+            }
+            return {
+                appendSystemContext: WECOM_BOT_WS_MEDIA_GUIDANCE,
+            };
+        });
+    },
+};
+export default plugin;

package/dist/src/accounts.js

@@ -0,0 +1,20 @@
+import { listWecomAccountIds as listWecomAccountIdsFromConfig, resolveDefaultWecomAccountId as resolveDefaultWecomAccountIdFromConfig, resolveWecomAccount as resolveWecomAccountFromConfig, } from "./config/accounts.js";
+/**
+ * Backward-compatible re-export layer.
+ * Keep this file as a thin wrapper so older imports continue to work,
+ * while all account logic stays single-sourced in `src/config/accounts.ts`.
+ */
+export function listWecomAccountIds(cfg) {
+    return listWecomAccountIdsFromConfig(cfg);
+}
+export function resolveDefaultWecomAccountId(cfg) {
+    return resolveDefaultWecomAccountIdFromConfig(cfg);
+}
+export function resolveWecomAccount(params) {
+    return resolveWecomAccountFromConfig(params);
+}
+export function listEnabledWecomAccounts(cfg) {
+    return listWecomAccountIdsFromConfig(cfg)
+        .map((accountId) => resolveWecomAccountFromConfig({ cfg, accountId }))
+        .filter((account) => account.enabled);
+}