@xuanyue202/wechat-mp 2026.3.21

package/README.md

@@ -0,0 +1,74 @@
+# @xuanyue202/wechat-mp
+
+`wechat-mp` 是一个独立的微信公众号（订阅号 / 服务号）渠道插件，用于把公众号消息接入 OpenClaw。
+
+## P0 已实现范围
+
+- 单账号配置
+- `GET` / `POST` 回调接入
+- `plain / safe / compat` 基础处理边界
+- `access_token` 获取、缓存、刷新
+- 文本消息入站
+- 基础事件（`subscribe / unsubscribe / scan / click / view`）标准化
+- 统一 routing / session / buffered reply dispatch 接入
+- 5 秒内 passive reply 主路径
+- active outbound skeleton
+- 超长消息自动分割（2048 字节限制，智能边界分割）
+- Markdown 渲染与格式转换
+- setup / aggregate / install hint 接线
+
+## P1 / P2 暂未完成
+
+- 完整媒体消息收发
+- OAuth / JS-SDK / 菜单 / 二维码全量业务能力
+- 多账号运行时完善
+- 更完整的主动发送能力与运营接口
+
+## 配置示例
+
+```json
+{
+  "channels": {
+    "wechat-mp": {
+      "enabled": true,
+      "webhookPath": "/wechat-mp",
+      "appId": "wx1234567890abcdef",
+      "appSecret": "your-app-secret",
+      "token": "your-callback-token",
+      "encodingAESKey": "your-43-char-encoding-aes-key",
+      "messageMode": "safe",
+      "replyMode": "active",
+      "activeDeliveryMode": "split",
+      "renderMarkdown": true,
+      "welcomeText": "你好，欢迎关注。"
+    }
+  }
+}
+```
+
+## 联调要点
+
+1. 公众号后台把服务器地址指向你的网关回调地址。
+2. `plain` 模式可先做最小链路验证；`safe/compat` 需要 `encodingAESKey`。
+3. 如果需要 active outbound，必须额外配置 `appSecret`。
+4. `replyMode=active` 时可用 `activeDeliveryMode` 控制主动发送行为：
+   - `split`：每个日志 / chunk 单独发一条消息
+   - `merged`：等待 reply pipeline 结束后合并成一条消息发送
+5. `replyMode=passive` 时始终单次 HTTP 回包，`activeDeliveryMode` 不生效。
+6. `renderMarkdown` 控制 Markdown 格式渲染：
+   - `true`（默认）：自动将 Markdown 转换为公众号友好的纯文本格式
+   - `false`：保留原始 Markdown 格式，不做转换
+7. **消息长度限制**：公众号客服消息 API 有 2048 字节限制，超长消息会自动分割：
+   - 优先在自然边界处分割：段落 `\n\n` → 分割线 `---` → 换行 `\n` → 句末标点 → 空格
+   - 分割后的消息逐条发送，确保不截断中文字符
+8. 推荐先用：
+
+```bash
+pnpm -F @xuanyue202/wechat-mp build
+pnpm -F @xuanyue202/wechat-mp test
+```
+
+## 文档入口
+
+- 开发计划：`doc/guides/wechat-mp/doc/开发计划.md`
+- 配置指南：`doc/guides/wechat-mp/configuration.md`

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+import type { WechatMpConfig, WechatMpAccountConfig, ResolvedWechatMpAccount, WechatMpDmPolicy, WechatMpMessageMode, WechatMpReplyMode, WechatMpActiveDeliveryMode, PluginConfig, MoltbotPluginApi } from "./src/types.js";
+export type { WechatMpConfig, WechatMpAccountConfig, ResolvedWechatMpAccount, WechatMpDmPolicy, WechatMpMessageMode, WechatMpReplyMode, WechatMpActiveDeliveryMode, PluginConfig, MoltbotPluginApi, };
+export { wechatMpPlugin, DEFAULT_ACCOUNT_ID } from "./src/channel.js";
+export { setWechatMpRuntime, getWechatMpRuntime } from "./src/runtime.js";
+export { sendWechatMpActiveText } from "./src/send.js";
+/**
+ * Collect webhook paths for all configured accounts.
+ * Used to register HTTP routes with the host.
+ */
+export declare function collectWechatMpRoutePaths(config: PluginConfig): string[];
+/**
+ * Plugin register function - entry point for host integration.
+ * Follows the thin entry pattern with setup CLI, install hint, runtime, and registerChannel.
+ */
+export declare function register(api: MoltbotPluginApi): void;
+declare const _default: {
+    register: typeof register;
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,cAAc,EACd,qBAAqB,EACrB,uBAAuB,EACvB,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,0BAA0B,EAC1B,YAAY,EACZ,gBAAgB,EACjB,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EACV,cAAc,EACd,qBAAqB,EACrB,uBAAuB,EACvB,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,0BAA0B,EAC1B,YAAY,EACZ,gBAAgB,GACjB,CAAC;AAEF,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAEvD;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,EAAE,CAmBxE;AAGD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI,CA6BpD;;;;AAED,wBAA4B"}

package/dist/index.js

@@ -0,0 +1,59 @@
+import { registerChinaSetupCli, showChinaInstallHint } from "@xuanyue202/shared";
+import { wechatMpPlugin } from "./src/channel.js";
+import { setWechatMpRuntime } from "./src/runtime.js";
+import { handleWechatMpWebhookRequest } from "./src/webhook.js";
+export { wechatMpPlugin, DEFAULT_ACCOUNT_ID } from "./src/channel.js";
+export { setWechatMpRuntime, getWechatMpRuntime } from "./src/runtime.js";
+export { sendWechatMpActiveText } from "./src/send.js";
+/**
+ * Collect webhook paths for all configured accounts.
+ * Used to register HTTP routes with the host.
+ */
+export function collectWechatMpRoutePaths(config) {
+    const paths = [];
+    const cfg = config?.channels?.["wechat-mp"];
+    if (!cfg)
+        return paths;
+    const defaultPath = cfg.webhookPath ?? "/wechat-mp";
+    paths.push(defaultPath);
+    if (cfg.accounts) {
+        for (const [accountId, account] of Object.entries(cfg.accounts)) {
+            const accountPath = account.webhookPath ?? defaultPath;
+            if (!paths.includes(accountPath)) {
+                paths.push(accountPath);
+            }
+        }
+    }
+    return paths;
+}
+/**
+ * Plugin register function - entry point for host integration.
+ * Follows the thin entry pattern with setup CLI, install hint, runtime, and registerChannel.
+ */
+export function register(api) {
+    const config = api.config;
+    if (api.registerCli) {
+        registerChinaSetupCli(api, { channels: ["wechat-mp"] });
+    }
+    showChinaInstallHint(api);
+    if (api.runtime) {
+        setWechatMpRuntime(api.runtime);
+    }
+    api.registerChannel({ plugin: wechatMpPlugin });
+    const routePaths = collectWechatMpRoutePaths(config ?? {});
+    for (const path of routePaths) {
+        if (api.registerHttpRoute) {
+            api.registerHttpRoute({
+                path,
+                auth: "plugin",
+                match: "exact",
+                handler: handleWechatMpWebhookRequest,
+            });
+        }
+        else if (api.registerHttpHandler) {
+            api.registerHttpHandler(handleWechatMpWebhookRequest);
+        }
+    }
+}
+export default { register };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAEjF,OAAO,EAAE,cAAc,EAAsB,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAsB,MAAM,kBAAkB,CAAC;AAE1E,OAAO,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAC;AA4BhE,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAEvD;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAAoB;IAC5D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,GAAG,GAAG,MAAM,EAAE,QAAQ,EAAE,CAAC,WAAW,CAA+B,CAAC;IAE1E,IAAI,CAAC,GAAG;QAAE,OAAO,KAAK,CAAC;IAEvB,MAAM,WAAW,GAAG,GAAG,CAAC,WAAW,IAAI,YAAY,CAAC;IACpD,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAExB,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;QACjB,KAAK,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAChE,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,WAAW,CAAC;YACvD,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;gBACjC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAGD;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAqB;IAC5C,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IAE1B,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;QACpB,qBAAqB,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,oBAAoB,CAAC,GAAG,CAAC,CAAC;IAE1B,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;QAChB,kBAAkB,CAAC,GAAG,CAAC,OAAkC,CAAC,CAAC;IAC7D,CAAC;IAED,GAAG,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;IAEhD,MAAM,UAAU,GAAG,yBAAyB,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;IAE3D,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,IAAI,GAAG,CAAC,iBAAiB,EAAE,CAAC;YAC1B,GAAG,CAAC,iBAAiB,CAAC;gBACpB,IAAI;gBACJ,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,OAAO;gBACd,OAAO,EAAE,4BAA4B;aACtC,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,GAAG,CAAC,mBAAmB,EAAE,CAAC;YACnC,GAAG,CAAC,mBAAmB,CAAC,4BAA4B,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;AACH,CAAC;AAED,eAAe,EAAE,QAAQ,EAAE,CAAC"}

package/dist/src/api.d.ts

@@ -0,0 +1,101 @@
+/**
+ * WeChat MP HTTP API adapter layer
+ *
+ * Provides unified HTTP client for WeChat MP API calls with:
+ * - Token injection and refresh on expiry
+ * - Error code handling and retry logic
+ * - Type-safe request/response handling
+ */
+import type { ResolvedWechatMpAccount } from "./types.js";
+export interface WechatMpApiResponse<T = unknown> {
+    errcode?: number;
+    errmsg?: string;
+    data?: T;
+}
+export interface WechatMpApiError extends Error {
+    errcode: number;
+    errmsg: string;
+    accountId: string;
+}
+export declare class WechatMpApiErrorImpl extends Error implements WechatMpApiError {
+    errcode: number;
+    errmsg: string;
+    accountId: string;
+    constructor(message: string, errcode: number, errmsg: string, accountId: string);
+}
+interface RequestConfig {
+    method: "GET" | "POST";
+    path: string;
+    params?: Record<string, string | number | boolean>;
+    body?: unknown;
+    requireToken?: boolean;
+}
+/**
+ * Make API call with error handling
+ * @throws WechatMpApiError if API returns an error
+ */
+export declare function callWechatMpApi<T = unknown>(account: ResolvedWechatMpAccount, config: RequestConfig): Promise<T>;
+export interface SendMessageParams {
+    touser: string;
+    msgtype: "text" | "image" | "voice" | "video" | "music" | "news" | "mpnews" | "msgmenu";
+    text?: {
+        content: string;
+    };
+    image?: {
+        media_id: string;
+    };
+    voice?: {
+        media_id: string;
+    };
+    video?: {
+        media_id: string;
+        thumb_media_id: string;
+        title?: string;
+        description?: string;
+    };
+}
+export interface SendMessageResult {
+    errcode: number;
+    errmsg: string;
+    msgid?: number;
+}
+/**
+ * Send customer service message (active send)
+ */
+export declare function sendWechatMpMessage(account: ResolvedWechatMpAccount, params: SendMessageParams): Promise<SendMessageResult>;
+export interface UploadMediaResult {
+    type: string;
+    media_id: string;
+    created_at: number;
+}
+/**
+ * Upload temporary media
+ */
+export declare function uploadWechatMpMedia(account: ResolvedWechatMpAccount, type: "image" | "voice" | "video" | "thumb", media: Buffer, filename?: string): Promise<UploadMediaResult>;
+export interface MenuButton {
+    type: "click" | "view" | "scancode_push" | "scancode_waitmsg" | "pic_sysphoto" | "pic_photo_or_album" | "pic_weixin" | "location_select" | "media_id" | "view_limited";
+    name: string;
+    key?: string;
+    url?: string;
+    media_id?: string;
+    sub_button?: MenuButton[];
+}
+export interface MenuConfig {
+    button: MenuButton[];
+}
+/**
+ * Create custom menu
+ */
+export declare function createWechatMpMenu(account: ResolvedWechatMpAccount, menu: MenuConfig): Promise<{
+    errcode: number;
+    errmsg: string;
+}>;
+/**
+ * Delete custom menu
+ */
+export declare function deleteWechatMpMenu(account: ResolvedWechatMpAccount): Promise<{
+    errcode: number;
+    errmsg: string;
+}>;
+export {};
+//# sourceMappingURL=api.d.ts.map

package/dist/src/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/api.ts"],"names":[],"mappings":"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"}

package/dist/src/api.js

@@ -0,0 +1,142 @@
+/**
+ * WeChat MP HTTP API adapter layer
+ *
+ * Provides unified HTTP client for WeChat MP API calls with:
+ * - Token injection and refresh on expiry
+ * - Error code handling and retry logic
+ * - Type-safe request/response handling
+ */
+import { getAccessToken, isInvalidTokenError, clearAccessTokenCache } from "./token.js";
+export class WechatMpApiErrorImpl extends Error {
+    errcode;
+    errmsg;
+    accountId;
+    constructor(message, errcode, errmsg, accountId) {
+        super(message);
+        this.errcode = errcode;
+        this.errmsg = errmsg;
+        this.accountId = accountId;
+        this.name = "WechatMpApiError";
+    }
+}
+// ============================================================================
+// API Client
+// ============================================================================
+const API_BASE = "https://api.weixin.qq.com";
+/**
+ * Make an API call to WeChat MP
+ */
+async function callApi(account, config) {
+    const url = new URL(`${API_BASE}${config.path}`);
+    // Add query params
+    if (config.params) {
+        for (const [key, value] of Object.entries(config.params)) {
+            url.searchParams.set(key, String(value));
+        }
+    }
+    // Add access_token if required
+    if (config.requireToken !== false) {
+        const token = await getAccessToken(account);
+        url.searchParams.set("access_token", token);
+    }
+    const fetchOptions = {
+        method: config.method,
+        headers: {
+            "Content-Type": "application/json",
+        },
+    };
+    if (config.body && config.method === "POST") {
+        fetchOptions.body = JSON.stringify(config.body);
+    }
+    const response = await fetch(url.toString(), fetchOptions);
+    const data = (await response.json());
+    // Handle token expiry
+    if (data.errcode && isInvalidTokenError(data.errcode)) {
+        clearAccessTokenCache(account);
+        // Retry once with fresh token
+        const newToken = await getAccessToken(account);
+        url.searchParams.set("access_token", newToken);
+        const retryResponse = await fetch(url.toString(), fetchOptions);
+        return (await retryResponse.json());
+    }
+    return data;
+}
+/**
+ * Make API call with error handling
+ * @throws WechatMpApiError if API returns an error
+ */
+export async function callWechatMpApi(account, config) {
+    const response = await callApi(account, config);
+    if (response.errcode !== undefined && response.errcode !== 0) {
+        throw new WechatMpApiErrorImpl(`WeChat MP API error: ${response.errmsg ?? "unknown error"}`, response.errcode, response.errmsg ?? "unknown error", account.accountId);
+    }
+    return response.data;
+}
+/**
+ * Send customer service message (active send)
+ */
+export async function sendWechatMpMessage(account, params) {
+    const response = await callApi(account, {
+        method: "POST",
+        path: "/cgi-bin/message/custom/send",
+        body: params,
+    });
+    return {
+        errcode: response.errcode ?? 0,
+        errmsg: response.errmsg ?? "ok",
+        msgid: response.data?.msgid,
+    };
+}
+/**
+ * Upload temporary media
+ */
+export async function uploadWechatMpMedia(account, type, media, filename) {
+    const token = await getAccessToken(account);
+    const url = new URL(`${API_BASE}/cgi-bin/media/upload`);
+    url.searchParams.set("access_token", token);
+    url.searchParams.set("type", type);
+    const formData = new FormData();
+    const blob = new Blob([media]);
+    formData.append("media", blob, filename ?? `media.${type === "image" ? "jpg" : "mp3"}`);
+    const response = await fetch(url.toString(), {
+        method: "POST",
+        body: formData,
+    });
+    const data = (await response.json());
+    if (data.errcode && isInvalidTokenError(data.errcode)) {
+        clearAccessTokenCache(account);
+        return uploadWechatMpMedia(account, type, media, filename);
+    }
+    if (data.errcode !== undefined && data.errcode !== 0) {
+        throw new WechatMpApiErrorImpl(`Upload media failed: ${data.errmsg ?? "unknown error"}`, data.errcode, data.errmsg ?? "unknown error", account.accountId);
+    }
+    return data.data;
+}
+/**
+ * Create custom menu
+ */
+export async function createWechatMpMenu(account, menu) {
+    const response = await callApi(account, {
+        method: "POST",
+        path: "/cgi-bin/menu/create",
+        body: menu,
+    });
+    return {
+        errcode: response.errcode ?? 0,
+        errmsg: response.errmsg ?? "ok",
+    };
+}
+/**
+ * Delete custom menu
+ */
+export async function deleteWechatMpMenu(account) {
+    const response = await callApi(account, {
+        method: "GET",
+        path: "/cgi-bin/menu/delete",
+    });
+    return {
+        errcode: response.errcode ?? 0,
+        errmsg: response.errmsg ?? "ok",
+    };
+}
+//# sourceMappingURL=api.js.map

package/dist/src/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/api.ts"],"names":[],"mappings":"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"}