@zhin.js/adapter-wechat-mp 1.1.17 → 1.1.19

package/lib/endpoint.js

@@ -1,267 +1,33 @@
-import { Endpoint } from 'zhin.js/adapter';
-/**
- * WeChatMpEndpoint — lifecycle, outbound, admit, access token refresh.
- */
-import axios from 'axios';
-import { formatCompact, getAdapterLogger } from '@zhin.js/logger';
-import { extractOutboundText, formatCustomerServiceBody, formatInboundContent, formatInboundId, wechatMpInboundConversation, } from './protocol.js';
-import { buildMediaUploadForm, readOutboundMedia, resolveMediaBinary, } from './media-upload.js';
-import { getPassiveReplyCapture, recordPassiveReplyText, } from './passive-reply.js';
-import { registerWeChatMpWebhookRoutes } from './webhook.js';
-import { receiveWeChatMpSideEvent } from './side-event-dispatch.js';
+import { createEndpointSpecification, endpointSpec } from 'zhin.js/adapter';
 import { WeChatMpClient } from './client.js';
-/**
- * canonical 媒体段类型 → 微信 /cgi-bin/media/upload 的 type。
- * 客服消息无 file 投递面，file 段不可投递。
- */
-const WECHAT_UPLOAD_TYPE = {
-    image: 'image',
-    audio: 'voice',
-    voice: 'voice',
-    video: 'video',
-};
-function defaultFetch(url, init) {
-    return axios({
-        url,
-        method: (init?.method ?? 'GET'),
-        data: init?.body,
-        headers: init?.headers,
-    }).then((response) => ({ data: response.data }));
-}
-export class WeChatMpEndpoint extends Endpoint {
-    client;
-    #logger;
-    #options;
-    #fetch;
-    #routeReleases = [];
-    #tokenRefreshTimer;
-    /** MsgId → 首次回复 XML（微信 5s 重推去重，有界 LRU）。 */
-    #replyCache = new Map();
-    static #REPLY_CACHE_LIMIT = 1000;
-    #open = false;
-    #started = false;
-    management = createWeChatMpEndpointManagement(() => this.client);
-    constructor(options) {
-        super();
-        this.#logger = getAdapterLogger('wechat-mp', options.config.id);
-        this.#options = options;
-        this.#fetch = options.fetch ?? defaultFetch;
-        this.client = new WeChatMpClient(options.config, this.#fetch);
-    }
-    /** Used by webhook handler. */
-    get isOpen() {
-        return this.#open;
-    }
-    get config() {
-        return this.#options.config;
-    }
-    get id() {
-        return this.#options.id;
-    }
-    /** 微信 5s 重推去重：见过该 MsgId 时返回首次回复 XML（含空串=success）。 */
-    getCachedReply(msgId) {
-        return this.#replyCache.get(msgId);
-    }
-    cacheReply(msgId, replyXML) {
-        if (this.#replyCache.has(msgId))
-            this.#replyCache.delete(msgId);
-        this.#replyCache.set(msgId, replyXML);
-        while (this.#replyCache.size > WeChatMpEndpoint.#REPLY_CACHE_LIMIT) {
-            const oldest = this.#replyCache.keys().next().value;
-            if (oldest === undefined)
-                break;
-            this.#replyCache.delete(oldest);
-        }
-    }
-    async start() {
-        if (this.#started)
-            return;
-        this.#started = true;
-        try {
-            await this.client.refreshAccessToken();
-            this.#routeReleases.push(...registerWeChatMpWebhookRoutes(this.#options.http, this));
-            this.#startTokenRefreshTimer();
-            this.#logger.debug(formatCompact({
-                endpoint: this.#options.config.id,
-                op: 'webhook',
-                path: this.#options.config.path,
-            }));
-        }
-        catch (error) {
-            await this.stop();
-            this.#logger.error('Failed to connect WeChat MP bot:', error);
-            throw error;
-        }
-    }
-    open() {
-        this.#open = true;
-    }
-    close() {
-        this.#open = false;
+/** Actual protocol Client; framework lifecycle and admission stay in their symbol namespace. */
+export class WeChatMpEndpoint extends WeChatMpClient {
+    [endpointSpec] = this.#createSpecification();
+    constructor(options) { super(options); }
+    #createSpecification() {
+        const hooks = {
+            start: (signal) => this.#startFramework(signal),
+            open: () => this.openInput(), close: () => this.closeInput(), stop: () => this.disconnectTransport(),
+            send: (request) => this.sendPayload(request),
+            name: this.configName(),
+            management: this.endpointManagement,
+        };
+        Object.defineProperty(hooks, 'transportState', { get: () => this.transportState });
+        return createEndpointSpecification(this, hooks);
+    }
+    resolvePresentationLocale(senderId) { return this[endpointSpec].resolveLocale(senderId); }
+    #startFramework(signal) { return this.connectTransport(signal); }
+    receiveInboundCallback(receive) {
+        return this[endpointSpec].events.run(receive);
+    }
+    publishEvent(name, payload) {
+        return this[endpointSpec].events.emit(name, payload);
+    }
+    publishAccepted(name, payload) {
+        return this[endpointSpec].events.emitAccepted(name, payload).then(() => undefined);
+    }
+    async publishPlatform(name, event) {
+        await super.publishPlatform(name, event);
+        return this[endpointSpec].events.platform(name, event);
     }
-    async stop() {
-        this.#open = false;
-        if (this.#tokenRefreshTimer) {
-            clearInterval(this.#tokenRefreshTimer);
-            this.#tokenRefreshTimer = undefined;
-        }
-        for (const release of this.#routeReleases.splice(0))
-            release();
-        this.#started = false;
-        this.#logger.debug(formatCompact({ op: 'disconnect' }));
-    }
-    async send({ conversation, payload }) {
-        if (getPassiveReplyCapture()) {
-            const text = extractOutboundText(payload);
-            recordPassiveReplyText(text);
-            return `passive_${Date.now()}`;
-        }
-        if (this.#options.config.replyMode === 'customer_service') {
-            return this.#sendCustomerService(conversation.id, payload);
-        }
-        this.#logger.warn(formatCompact({
-            op: 'send',
-            skip: 'passive_outside_webhook',
-            endpoint: this.#options.config.id,
-            target: `${conversation.kind}:${conversation.id}`,
-        }));
-        return `passive_skipped_${Date.now()}`;
-    }
-    /** Test / internal: admit a parsed message when open (non-webhook path). */
-    admit(msg) {
-        if (!this.#open)
-            return;
-        void this.emitPlatform(msg.Event ? `${msg.MsgType}.${msg.Event}` : msg.MsgType, msg).catch((error) => {
-            this.#logger.warn(formatCompact({
-                op: 'wechat_mp_platform_event_failed',
-                error: error instanceof Error ? error.message : String(error),
-            }));
-        });
-        if (receiveWeChatMpSideEvent((name, payload) => this.emit(name, payload), this.#options.config.id, msg, this.#logger)) {
-            return undefined;
-        }
-        const conversation = wechatMpInboundConversation(String(this.#options.id), msg);
-        return this.emit('message.receive', {
-            conversation,
-            message: { conversation, id: formatInboundId(msg) },
-            content: formatInboundContent(msg),
-            sender: { id: msg.FromUserName },
-            endpointId: this.#options.config.id,
-            metadata: Object.freeze({
-                msgType: msg.MsgType,
-                event: msg.Event,
-                toUserName: msg.ToUserName,
-            }),
-        }).catch((err) => {
-            this.#logger.warn(formatCompact({
-                op: 'wechat_mp_gateway_receive_failed',
-                target: `${conversation.kind}:${conversation.id}`,
-                error: err instanceof Error ? err.message : String(err),
-            }));
-        });
-    }
-    async #sendCustomerService(target, payload) {
-        // 发送前检查过期（不只判 null）：过期 token 直接刷新，不白跑一次 40001。
-        const materialized = await this.#materializeOutboundMedia(payload);
-        const messageData = formatCustomerServiceBody(target, materialized);
-        const result = await this.client.sendCustomerService(messageData);
-        if (result.errcode && result.errcode !== 0) {
-            throw new Error(`WeChat API error: ${result.errcode} - ${result.errmsg}`);
-        }
-        this.#logger.debug(formatCompact({ op: 'wechat_mp_send', target, messageId: result.msgid }));
-        return result.msgid?.toString() || `cs_${Date.now()}`;
-    }
-    /**
-     * 客服消息媒体段只接受 media_id：canonical MediaRef 是唯一来源。
-     * - kind=file（平台不透明引用，即既有 media_id）→ 直接透传；
-     * - kind=base64 / path / url → 经 /cgi-bin/media/upload 物化；
-     * - 无 MediaRef / 类型不可投递（file 段）→ warn + 丢弃；
-     * - 上传失败降级为文本（alt 优先），不阻断发送。
-     */
-    async #materializeOutboundMedia(payload) {
-        if (!Array.isArray(payload))
-            return payload;
-        const materialized = await Promise.all(payload.map(async (item) => {
-            if (typeof item === 'string' || !item || typeof item !== 'object')
-                return item;
-            const seg = item;
-            if (typeof seg.type !== 'string')
-                return item;
-            const data = seg.data ?? {};
-            const uploadType = WECHAT_UPLOAD_TYPE[seg.type];
-            const isMediaSegment = uploadType != null || seg.type === 'file';
-            if (!isMediaSegment)
-                return item;
-            const media = readOutboundMedia(data);
-            if (!media) {
-                // 已物化（mediaId/media_id）的段透传；其余无 canonical 媒体引用，丢弃留痕
-                if (typeof data.mediaId === 'string' && data.mediaId)
-                    return item;
-                if (typeof data.media_id === 'string' && data.media_id)
-                    return item;
-                this.#logger.warn(formatCompact({
-                    op: 'wechat_mp_outbound_media_dropped',
-                    endpoint: this.#options.config.id,
-                    type: seg.type,
-                    reason: 'missing_media_ref',
-                }));
-                return null;
-            }
-            if (media.kind === 'file') {
-                // 平台不透明引用：value 即 media_id，直接透传不上传
-                return { type: seg.type, data: { mediaId: media.value } };
-            }
-            if (!uploadType) {
-                this.#logger.warn(formatCompact({
-                    op: 'wechat_mp_outbound_media_dropped',
-                    endpoint: this.#options.config.id,
-                    type: seg.type,
-                    reason: 'unsupported_segment_type',
-                }));
-                return null;
-            }
-            try {
-                const mediaId = await this.#uploadMedia(uploadType, media);
-                return { type: seg.type, data: { mediaId } };
-            }
-            catch (error) {
-                this.#logger.warn(formatCompact({
-                    op: 'wechat_mp_media_upload_failed',
-                    endpoint: this.#options.config.id,
-                    error: error instanceof Error ? error.message : String(error),
-                }));
-                const alt = typeof data.alt === 'string' && data.alt ? data.alt : `[${seg.type}]`;
-                return { type: 'text', data: { text: alt } };
-            }
-        }));
-        return materialized.filter((item) => item != null);
-    }
-    /** POST /cgi-bin/media/upload（临时素材，3 天有效），返回 media_id。 */
-    async #uploadMedia(type, media) {
-        const binary = await resolveMediaBinary(media);
-        const form = buildMediaUploadForm(binary);
-        return this.client.uploadMedia(type, form);
-    }
-    #startTokenRefreshTimer() {
-        if (this.#tokenRefreshTimer)
-            clearInterval(this.#tokenRefreshTimer);
-        this.#tokenRefreshTimer = setInterval(() => {
-            if (this.client.tokenExpired) {
-                void this.client.refreshAccessToken().catch((error) => {
-                    this.#logger.error('Failed to refresh access token in timer:', error);
-                });
-            }
-        }, 3_600_000);
-        this.#tokenRefreshTimer.unref?.();
-    }
-}
-function createWeChatMpEndpointManagement(requireClient) {
-    return Object.freeze({
-        // 公众号无群/频道概念；关注者即"好友"（nickname 为 openid 占位，见 getFollowers）。
-        listFriends: async () => (await requireClient().getFollowerIds()).map((openid) => ({
-            user_id: openid,
-            nickname: openid,
-            remark: '',
-        })),
-    });
 }

package/lib/index.d.ts

@@ -1,6 +1,7 @@
 export { buildTextReply, computeSignatureHash, decryptEchostr, decryptMessage, encryptMessage, extractOutboundText, formatCustomerServiceBody, formatInboundContent, formatInboundId, isEncryptedEchostr, normalizeEchostrParam, parseXMLMessage, queryParam, readTextBody, resolveEventPassiveReply, resolveWeChatMpConfig, verifySignature, type ResolvedWeChatMpConfig, type TokenResponse, type WeChatAPIResponse, type WeChatMessage, type WeChatMpEndpointConfig, type WeChatWireSegment, } from './protocol.js';
 export { getPassiveReplyCapture, recordPassiveReplyText, runWithPassiveReplyCapture, type PassiveReplyCapture, } from './passive-reply.js';
-export { WeChatMpClient, wechatMpClient, type WeChatMpClientEventMap, type WeChatMpFetch, } from './client.js';
+export { WeChatMpClient, type WeChatMpClientEventMap, type WeChatMpFetch, } from './client.js';
 export { WeChatMpEndpoint, type WeChatMpEndpointOptions, } from './endpoint.js';
 export { buildMediaUploadForm, readOutboundMedia, resolveMediaBinary, type MediaBinary, type WeChatMediaUploadResult, } from './media-upload.js';
 export { registerWeChatMpWebhookRoutes, handleWeChatMpVerification, handleWeChatMpMessage, collectPassiveReply, type WeChatMpWebhookHandler, } from './webhook.js';
+export { WeChatMpAdapter } from './adapter.js';

package/lib/index.js

@@ -1,6 +1,7 @@
 export { buildTextReply, computeSignatureHash, decryptEchostr, decryptMessage, encryptMessage, extractOutboundText, formatCustomerServiceBody, formatInboundContent, formatInboundId, isEncryptedEchostr, normalizeEchostrParam, parseXMLMessage, queryParam, readTextBody, resolveEventPassiveReply, resolveWeChatMpConfig, verifySignature, } from './protocol.js';
 export { getPassiveReplyCapture, recordPassiveReplyText, runWithPassiveReplyCapture, } from './passive-reply.js';
-export { WeChatMpClient, wechatMpClient, } from './client.js';
+export { WeChatMpClient, } from './client.js';
 export { WeChatMpEndpoint, } from './endpoint.js';
 export { buildMediaUploadForm, readOutboundMedia, resolveMediaBinary, } from './media-upload.js';
 export { registerWeChatMpWebhookRoutes, handleWeChatMpVerification, handleWeChatMpMessage, collectPassiveReply, } from './webhook.js';
+export { WeChatMpAdapter } from './adapter.js';

package/lib/media-upload.d.ts

@@ -12,7 +12,11 @@ export interface WeChatMediaUploadResult {
     readonly errmsg?: string;
 }
 /** 从 canonical MediaRef 解析二进制：base64 解码 / 本地读盘 / URL 下载。 */
-export declare function resolveMediaBinary(media: MediaRef, download?: (url: string) => Promise<Buffer>): Promise<MediaBinary>;
+export interface MediaResolveOptions {
+    readonly download?: (url: string, signal?: AbortSignal) => Promise<Buffer>;
+    readonly signal?: AbortSignal;
+}
+export declare function resolveMediaBinary(media: MediaRef, { download, signal }?: MediaResolveOptions): Promise<MediaBinary>;
 /** 临时素材上传的 multipart body（字段名固定为 `media`）。 */
 export declare function buildMediaUploadForm(binary: MediaBinary): FormData;
 /**

package/lib/media-upload.js

@@ -14,8 +14,8 @@ const MIME_EXT = {
     'image/webp': 'webp',
     'image/bmp': 'bmp',
 };
-/** 从 canonical MediaRef 解析二进制：base64 解码 / 本地读盘 / URL 下载。 */
-export async function resolveMediaBinary(media, download = defaultDownload) {
+export async function resolveMediaBinary(media, { download = defaultDownload, signal } = {}) {
+    signal?.throwIfAborted();
     const mimeType = media.mime_type ?? 'image/png';
     const ext = MIME_EXT[mimeType] ?? 'png';
     if (media.kind === 'base64') {
@@ -26,16 +26,16 @@ export async function resolveMediaBinary(media, download = defaultDownload) {
     }
     if (media.kind === 'path') {
         const path = media.value.startsWith('file://') ? media.value.slice('file://'.length) : media.value;
-        return { data: await readFile(path), mimeType, fileName: basename(path) };
+        return { data: await readFile(path, { signal }), mimeType, fileName: basename(path) };
     }
     if (media.kind === 'file') {
         // 平台不透明引用（media_id）：由调用方直接透传，不走上传。
         throw new Error('MediaRef kind=file is a platform opaque reference; binary resolution not applicable');
     }
-    return { data: await download(media.value), mimeType, fileName: `image.${ext}` };
+    return { data: await download(media.value, signal), mimeType, fileName: `image.${ext}` };
 }
-async function defaultDownload(url) {
-    const response = await fetch(url, { signal: AbortSignal.timeout(30_000) });
+async function defaultDownload(url, signal) {
+    const response = await fetch(url, { signal: signal ? AbortSignal.any([signal, AbortSignal.timeout(30_000)]) : AbortSignal.timeout(30_000) });
     if (!response.ok)
         throw new Error(`download failed: HTTP ${response.status}`);
     return Buffer.from(await response.arrayBuffer());

package/lib/side-event-dispatch.d.ts

@@ -1,4 +1,4 @@
 import type { EndpointEventEmitter } from 'zhin.js/adapter';
 import { type getAdapterLogger } from '@zhin.js/logger';
 import { type WeChatMessage } from './protocol.js';
-export declare function receiveWeChatMpSideEvent(emit: EndpointEventEmitter, configId: string, msg: WeChatMessage, logger: ReturnType<typeof getAdapterLogger>): boolean;
+export declare function receiveWeChatMpSideEvent(emit: EndpointEventEmitter, configId: string, msg: WeChatMessage, logger: ReturnType<typeof getAdapterLogger>, nativeEvent?: unknown): boolean;

package/lib/side-event-dispatch.js

@@ -11,12 +11,12 @@ function mapWeChatMpEventParts(eventName) {
             return { scene_type: 'wechat-mp', sub_type: eventName || 'unknown' };
     }
 }
-export function receiveWeChatMpSideEvent(emit, configId, msg, logger) {
+export function receiveWeChatMpSideEvent(emit, configId, msg, logger, nativeEvent = msg) {
     if (msg.MsgType !== 'event')
         return false;
     const eventName = msg.Event ?? 'unknown';
     const parts = mapWeChatMpEventParts(eventName);
-    void emit('notice.receive', buildNotice(msg, {
+    void emit('notice.receive', buildNotice(typeof nativeEvent === 'string' ? { ...msg, rawXml: nativeEvent } : msg, {
         id: `wechat-mp:${formatInboundId(msg)}`,
         clientAdapter: 'wechat-mp',
         endpointId: configId,

package/lib/webhook.d.ts

@@ -10,7 +10,7 @@ export interface WeChatMpWebhookHandler {
     readonly config: ResolvedWeChatMpConfig;
     readonly isOpen: boolean;
     readonly id: CapabilityId;
-    admit(msg: WeChatMessage): void | Promise<unknown>;
+    admit(msg: WeChatMessage, nativeEvent?: unknown): void | Promise<unknown>;
     resolveLocale?(senderId: string): Promise<Locale | undefined>;
     /** MsgId 去重缓存（可选；实现见 WeChatMpEndpoint）。 */
     getCachedReply?(msgId: string): string | undefined;
@@ -19,4 +19,4 @@ export interface WeChatMpWebhookHandler {
 export declare function registerWeChatMpWebhookRoutes(http: HttpHost, handler: WeChatMpWebhookHandler): HttpRouteRegistration[];
 export declare function handleWeChatMpVerification(_request: IncomingMessage, response: ServerResponse, url: URL, config: ResolvedWeChatMpConfig): void;
 export declare function handleWeChatMpMessage(request: IncomingMessage, response: ServerResponse, url: URL, handler: WeChatMpWebhookHandler): Promise<void>;
-export declare function collectPassiveReply(handler: WeChatMpWebhookHandler, wechatMsg: WeChatMessage): Promise<string>;
+export declare function collectPassiveReply(handler: WeChatMpWebhookHandler, wechatMsg: WeChatMessage, nativeEvent?: unknown): Promise<string>;

package/lib/webhook.js

@@ -107,10 +107,10 @@ export async function handleWeChatMpMessage(request, response, url, handler) {
         let replyXML = resolveEventPassiveReply(wechatMessage, locale);
         if (!replyXML && handler.isOpen) {
             if (config.replyMode === 'passive') {
-                replyXML = await collectPassiveReply(handler, wechatMessage);
+                replyXML = await collectPassiveReply(handler, wechatMessage, xmlString);
             }
             else {
-                handler.admit(wechatMessage);
+                handler.admit(wechatMessage, xmlString);
             }
         }
         const encryptReply = !!(replyXML
@@ -132,12 +132,12 @@ export async function handleWeChatMpMessage(request, response, url, handler) {
         response.end('success');
     }
 }
-export async function collectPassiveReply(handler, wechatMsg) {
+export async function collectPassiveReply(handler, wechatMsg, nativeEvent) {
     const timeoutMs = handler.config.passiveReplyTimeoutMs;
     const text = await runWithPassiveReplyCapture(async () => {
         const conversation = wechatMpInboundConversation(String(handler.id), wechatMsg);
         await Promise.race([
-            Promise.resolve(handler.admit(wechatMsg)),
+            Promise.resolve(nativeEvent === undefined ? handler.admit(wechatMsg) : handler.admit(wechatMsg, nativeEvent)),
             new Promise((resolve) => setTimeout(resolve, timeoutMs)),
         ]);
         return getPassiveReplyCapture()?.text ?? null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-wechat-mp",
-  "version": "1.1.17",
+  "version": "1.1.19",
   "type": "module",
   "description": "Zhin.js WeChat Official Account adapter for Plugin Runtime (HTTP webhook)",
   "main": "./lib/index.js",
@@ -8,20 +8,23 @@
   "dependencies": {
     "axios": "^1.20.0",
     "xml2js": "^0.6.2",
-    "@zhin.js/adapter": "1.1.24",
-    "@zhin.js/core": "1.1.52",
-    "@zhin.js/feature-kit": "1.1.9",
-    "@zhin.js/host-http": "1.1.11",
-    "@zhin.js/im-contract": "1.1.8",
+    "@zhin.js/adapter": "1.1.26",
+    "@zhin.js/client": "1.1.22",
+    "@zhin.js/console-contract": "1.1.3",
+    "@zhin.js/core": "1.1.54",
+    "@zhin.js/feature-kit": "1.1.10",
+    "@zhin.js/host-http": "1.1.12",
+    "@zhin.js/im-contract": "1.1.9",
     "@zhin.js/logger": "1.1.2",
-    "@zhin.js/skill": "1.1.10"
+    "@zhin.js/page": "1.1.11",
+    "@zhin.js/skill": "1.1.11"
   },
   "peerDependencies": {
-    "@zhin.js/adapter": "^1.1.24",
-    "@zhin.js/command": "^1.1.11",
-    "@zhin.js/core": "^1.1.52",
-    "@zhin.js/host-http": "^1.1.11",
-    "zhin.js": "^1.1.17"
+    "@zhin.js/adapter": "^1.1.26",
+    "@zhin.js/command": "^1.1.12",
+    "@zhin.js/core": "^1.1.54",
+    "@zhin.js/host-http": "^1.1.12",
+    "zhin.js": "^1.1.19"
   },
   "peerDependenciesMeta": {
     "@zhin.js/command": {
@@ -36,7 +39,7 @@
     "@types/xml2js": "^0.4.14",
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
-    "zhin.js": "1.1.17"
+    "zhin.js": "1.1.19"
   },
   "keywords": [
     "zhin",
@@ -64,6 +67,7 @@
   "files": [
     "adapters",
     "commands",
+    "pages",
     "plugin.js",
     "schema.json",
     "src",
@@ -94,7 +98,7 @@
     "features": [
       {
         "package": "@zhin.js/adapter",
-        "api": "^1.0.0"
+        "api": "^2.0.0"
       },
       {
         "package": "@zhin.js/command",
@@ -103,6 +107,10 @@
       {
         "package": "@zhin.js/skill",
         "api": "^1.0.0"
+      },
+      {
+        "package": "@zhin.js/page",
+        "api": "^1.0.0"
       }
     ],
     "plugins": []

package/pages/index/index.js

@@ -0,0 +1,15 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { definePage } from '@zhin.js/console-contract';
+import { createAdapterConsolePage } from '@zhin.js/client';
+export const meta = definePage({
+    title: '微信公众号',
+    titleI18n: { en: 'WeChat MP' },
+    icon: 'MessageSquare',
+    order: 75,
+    requiredPermissions: ['wechat-mp:read'],
+});
+/**
+ * Convention page: `pages/index/index.ts` → `/wechat-mp`（插件路径）。
+ * 连接状态、连接测试、endpoint 增删；登录待办来自 LoginAssist（ICQQ 等）。
+ */
+export default createAdapterConsolePage('wechat-mp');

package/pages/index/index.ts

@@ -0,0 +1,16 @@
+import { definePage } from '@zhin.js/console-contract';
+import { createAdapterConsolePage } from '@zhin.js/client';
+
+export const meta = definePage({
+  title: '微信公众号',
+  titleI18n: { en: 'WeChat MP' },
+  icon: 'MessageSquare',
+  order: 75,
+  requiredPermissions: ['wechat-mp:read'],
+});
+
+/**
+ * Convention page: `pages/index/index.ts` → `/wechat-mp`（插件路径）。
+ * 连接状态、连接测试、endpoint 增删；登录待办来自 LoginAssist（ICQQ 等）。
+ */
+export default createAdapterConsolePage('wechat-mp');

package/plugin.js

@@ -1,7 +1,6 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
-import { createEndpointRuntimeState } from 'zhin.js/adapter';
-import { definePlugin } from 'zhin.js';
-import { wechatMpRuntimeStateToken } from "./lib/wechat-mp-runtime-state.js";
+import { definePlugin, pluginConsoleRpcToken } from 'zhin.js';
+import { createWechatMpConsoleRpc } from "./lib/console.js";
 export default definePlugin({
     name: 'wechat-mp',
     metadata: {
@@ -9,6 +8,6 @@ export default definePlugin({
     },
     setup(context) {
         // 运行中 endpoint 注册表（wechat-mp endpoint list 的"运行中"数据源）
-        context.resources.provide(wechatMpRuntimeStateToken, createEndpointRuntimeState());
+        context.resources.provide(pluginConsoleRpcToken, createWechatMpConsoleRpc(context.resources, () => context.config.get()));
     },
 });

package/src/adapter.ts

@@ -0,0 +1,22 @@
+import { Adapter, type AdapterContext, type EndpointCreationContext } from 'zhin.js/adapter';
+import { WeChatMpEndpoint } from './endpoint.js';
+import { resolveWeChatMpConfig, type WeChatMpEndpointConfig } from './protocol.js';
+import type { WeChatMpClientEventMap } from './client.js';
+import { httpHostToken } from '@zhin.js/host-http';
+
+export class WeChatMpAdapter extends Adapter<WeChatMpEndpoint, WeChatMpEndpointConfig, WeChatMpClientEventMap> {
+  readonly #context: AdapterContext<WeChatMpEndpointConfig>;
+  constructor(context: AdapterContext<WeChatMpEndpointConfig>) { super(); this.#context = context; }
+  override get configurationIdentityFields(): readonly string[] { return ['id', 'appId']; }
+  override get configurationUpdateFields(): readonly string[] { return ['appSecret', 'token', 'encodingAESKey', 'path', 'encrypt', 'encryptMode', 'replyMode', 'passiveReplyTimeoutMs']; }
+  override get configurationIdentityProbeFields(): readonly string[] { return ['appSecret']; }
+  protected override validateConfiguration(config: WeChatMpEndpointConfig): void { resolveWeChatMpConfig(config); }
+  protected createEndpoint(input: WeChatMpEndpointConfig, execution: EndpointCreationContext): WeChatMpEndpoint {
+    const config = resolveWeChatMpConfig(input);
+    return new WeChatMpEndpoint({ id: execution.canonicalId, config, http: this.#context.use(httpHostToken) });
+  }
+}
+
+declare module '@zhin.js/feature-kit' {
+  interface AdapterRegistry { readonly 'wechat-mp': WeChatMpAdapter; }
+}