@yanhaidao/wecom 2.3.3 → 2.3.4

package/.github/workflows/release.yml

@@ -4,6 +4,7 @@ on:
   push:
     tags:
       - 'v*'
+      - 'wecom-v*'
 
 jobs:
   publish:
@@ -34,6 +35,51 @@ jobs:
         run: |
           npm i -g npm@^11.5.1
           npm -v
+          npm config delete always-auth || true
+
+      - name: Resolve release metadata
+        id: meta
+        run: |
+          set -euo pipefail
+          TAG="${GITHUB_REF_NAME}"
+          if [[ "${TAG}" == wecom-v* ]]; then
+            VERSION="${TAG#wecom-v}"
+          elif [[ "${TAG}" == v* ]]; then
+            VERSION="${TAG#v}"
+          else
+            echo "::error::Unsupported tag format: ${TAG}. Use v<version> or wecom-v<version>."
+            exit 1
+          fi
+          PKG_NAME="$(node -p "require('./package.json').name")"
+          PKG_VERSION="$(node -p "require('./package.json').version")"
+
+          echo "tag=${TAG}" >> "$GITHUB_OUTPUT"
+          echo "version=${VERSION}" >> "$GITHUB_OUTPUT"
+          echo "pkg_name=${PKG_NAME}" >> "$GITHUB_OUTPUT"
+          echo "pkg_version=${PKG_VERSION}" >> "$GITHUB_OUTPUT"
+
+          echo "tag=${TAG}"
+          echo "version_from_tag=${VERSION}"
+          echo "package=${PKG_NAME}@${PKG_VERSION}"
+
+          if [ "${VERSION}" != "${PKG_VERSION}" ]; then
+            echo "::error::Tag version (${VERSION}) does not match package.json version (${PKG_VERSION})."
+            exit 1
+          fi
+
+      - name: Check npm version already published
+        id: npm_check
+        run: |
+          set -euo pipefail
+          PKG="${{ steps.meta.outputs.pkg_name }}"
+          VER="${{ steps.meta.outputs.pkg_version }}"
+          if npm view "${PKG}@${VER}" version >/dev/null 2>&1; then
+            echo "exists=true" >> "$GITHUB_OUTPUT"
+            echo "npm version already published: ${PKG}@${VER}"
+          else
+            echo "exists=false" >> "$GITHUB_OUTPUT"
+            echo "npm version not published yet: ${PKG}@${VER}"
+          fi
 
       - name: Install Dependencies
         run: npm install --legacy-peer-deps || npm install
@@ -43,13 +89,35 @@ jobs:
 
       # 🚀 自动发布到 npm (使用 OIDC 自动授权，无需 Token)
       - name: Publish to npm
+        if: steps.npm_check.outputs.exists != 'true'
         run: npm publish --access public
 
+      - name: Prepare release notes body
+        id: notes
+        run: |
+          set -euo pipefail
+          CHANGELOG_FILE="changelog/v${{ steps.meta.outputs.version }}.md"
+          if [ -f "${CHANGELOG_FILE}" ]; then
+            echo "Using changelog file: ${CHANGELOG_FILE}"
+            cp "${CHANGELOG_FILE}" /tmp/release-body.md
+          else
+            echo "Changelog file missing: ${CHANGELOG_FILE}; using fallback notes."
+            {
+              echo "# @yanhaidao/wecom v${{ steps.meta.outputs.version }}"
+              echo
+              if [ "${{ steps.npm_check.outputs.exists }}" = "true" ]; then
+                echo "- npm publish skipped: version already exists."
+              else
+                echo "- npm publish completed."
+              fi
+            } > /tmp/release-body.md
+          fi
+
       # 自动同步发布 GitHub Release
       - name: Create GitHub Release
         uses: softprops/action-gh-release@v2
         with:
-          body_path: changelog/${{ github.ref_name }}.md
+          body_path: /tmp/release-body.md
           draft: false
           prerelease: false
         env:

package/README.md

@@ -502,6 +502,8 @@ Agent 输出 `{"template_card": ...}` 时自动渲染为交互卡片：
 
 ### 2026.3.3（今日更新简报）
 
+- 【SDK适配】♻️ **插件 HTTP 注册升级**：入口改为 `registerHttpRoute`（`/plugins/wecom` + `match=prefix` + `auth=plugin`），适配 OpenClaw 新版插件接口。
+- 【兼容修复】🔁 **旧入口保持可达**：同步注册 `/wecom` 前缀路由，保障历史 Bot/Agent 回调地址继续可用。
 - 【兼容性修复】🧩 **OpenClaw 3.1 路由抢占问题修复**：推荐回调地址升级为 `/plugins/wecom/bot/{accountId}`、`/plugins/wecom/agent/{accountId}`，规避根路径 Control UI fallback 抢占 webhook。
 - 【引导收敛】🧭 **Onboarding 仅支持账号化配置**：配置向导统一写入 `channels.wecom.accounts.<accountId>`，不再引导单账号旧结构。
 - 【兼容策略】🔁 **旧路径兼容保留**：`/wecom/*` 历史回调路径保留兼容能力，但不再作为维护主路径。

package/changelog/v2.3.4.md

@@ -0,0 +1,20 @@
+# 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/compat-single-account.md

@@ -108,7 +108,7 @@ openclaw channels status
 
 ## A.4 Webhook 路径
 
-- Bot: `/wecom/bot`
+- Bot: `/wecom`（默认）或 `/wecom/bot`
 - Agent: `/wecom/agent`
 
 ## A.5 迁移建议

package/index.test.ts

@@ -0,0 +1,34 @@
+import { describe, expect, it, vi } from "vitest";
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+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 api = {
+      runtime: {},
+      registerChannel,
+      registerHttpRoute,
+    } 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/index.ts

@@ -15,16 +15,24 @@ const plugin = {
   configSchema: emptyPluginConfigSchema(),
   /**
    * **register (注册插件)**
-   * 
+   *
    * OpenClaw 插件入口点。
    * 1. 注入 Runtime 环境 (api.runtime)。
    * 2. 注册 WeCom 渠道插件 (ChannelPlugin)。
-   * 3. 注册 Webhook HTTP 处理器 (handleWecomWebhookRequest)。
+   * 3. 注册 Webhook HTTP 路由（推荐 /plugins/wecom/*，兼容 /wecom*）。
    */
   register(api: OpenClawPluginApi) {
     setWecomRuntime(api.runtime);
     api.registerChannel({ plugin: wecomPlugin });
-    api.registerHttpHandler(handleWecomWebhookRequest);
+    const routes = ["/plugins/wecom", "/wecom"];
+    for (const path of routes) {
+      api.registerHttpRoute({
+        path,
+        handler: handleWecomWebhookRequest,
+        auth: "plugin",
+        match: "prefix",
+      });
+    }
   },
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yanhaidao/wecom",
-  "version": "2.3.3",
+  "version": "2.3.4",
   "type": "module",
   "description": "OpenClaw WeCom (WeChat Work) intelligent bot channel plugin",
   "repository": {

package/src/types/constants.ts

@@ -10,9 +10,9 @@ export const WEBHOOK_PATHS = {
     BOT_ALT: "/wecom/bot",
     /** Agent 模式历史兼容路径（不再维护） */
     AGENT: "/wecom/agent",
-    /** Bot 模式（唯一支持路径前缀） */
+    /** Bot 模式推荐路径前缀 */
     BOT_PLUGIN: "/plugins/wecom/bot",
-    /** Agent 模式（唯一支持路径前缀） */
+    /** Agent 模式推荐路径前缀 */
     AGENT_PLUGIN: "/plugins/wecom/agent",
 } as const;