@zhin.js/adapter-onebot12 0.0.0

package/lib/bot-wss.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot-wss.d.ts","sourceRoot":"","sources":["../src/bot-wss.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAGtC,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,EAAW,MAAM,SAAS,CAAC;AAC7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAiD,MAAM,YAAY,CAAC;AAClH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAGpD,qBAAa,iBAAkB,SAAQ,YAAa,YAAW,GAAG,CAAC,iBAAiB,EAAE,aAAa,CAAC;;IAazF,OAAO,EAAE,eAAe;IACxB,MAAM,EAAE,MAAM;IACd,OAAO,EAAE,iBAAiB;IAdnC,UAAU,EAAE,OAAO,CAAS;IAG5B,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,eAAe,CAAmH;IAE1I,IAAI,MAAM,6BAET;gBAGQ,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,iBAAiB;IAKnC,IAAI,GAAG,WAEN;IAED,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,UAAU;IAmBZ,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAwDzB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBlC,cAAc,CAAC,EAAE,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IA8BnD,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAmBnD,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGhD"}

package/lib/bot-wss.js

@@ -0,0 +1,173 @@
+/**
+ * OneBot 12 反向 WebSocket Bot：应用开 WS 服务端，OneBot 实现连上来
+ */
+import WebSocket from 'ws';
+import { EventEmitter } from 'events';
+import { clearInterval, clearTimeout } from 'node:timers';
+import { Message, segment } from 'zhin.js';
+import { formatOneBot12MessagePayload, isMessageEvent, contentToOb12Segments } from './utils.js';
+export class OneBot12WssServer extends EventEmitter {
+    adapter;
+    router;
+    $config;
+    $connected = false;
+    #wss;
+    #client;
+    heartbeatTimer;
+    requestId = 0;
+    pendingRequests = new Map();
+    get logger() {
+        return this.adapter.plugin.logger;
+    }
+    constructor(adapter, router, $config) {
+        super();
+        this.adapter = adapter;
+        this.router = router;
+        this.$config = $config;
+    }
+    get $id() {
+        return this.$config.name;
+    }
+    getClient() {
+        return this.#client && this.#client.readyState === WebSocket.OPEN ? this.#client : undefined;
+    }
+    callAction(action, params) {
+        const client = this.getClient();
+        if (!client)
+            return Promise.reject(new Error('反向 WebSocket 未连接'));
+        const echo = `ob12wss_${++this.requestId}`;
+        const req = { action, params, echo };
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                this.pendingRequests.delete(echo);
+                reject(new Error(`OneBot12 动作超时: ${action}`));
+            }, 30000);
+            this.pendingRequests.set(echo, {
+                resolve: (data) => resolve(data),
+                reject,
+                timeout,
+            });
+            client.send(JSON.stringify(req));
+        });
+    }
+    async $connect() {
+        const path = this.$config.path.startsWith('/') ? this.$config.path : `/${this.$config.path}`;
+        this.#wss = this.router.ws(path, {
+            verifyClient: (info) => {
+                const auth = info.req.headers['authorization'];
+                if (this.$config.access_token && auth !== `Bearer ${this.$config.access_token}`) {
+                    this.logger.error('OneBot12 反向 WS 鉴权失败');
+                    return false;
+                }
+                return true;
+            },
+        });
+        this.#wss.on('connection', (ws) => {
+            if (this.#client && this.#client.readyState === WebSocket.OPEN) {
+                this.#client.close();
+            }
+            this.#client = ws;
+            this.$connected = true;
+            this.logger.info(`OneBot12 反向 WS 已连接: ${this.$config.name}`);
+            ws.on('message', (data) => {
+                try {
+                    const msg = JSON.parse(data.toString());
+                    if ('echo' in msg && typeof msg.echo === 'string') {
+                        const resp = msg;
+                        const pending = this.pendingRequests.get(resp.echo);
+                        if (pending) {
+                            this.pendingRequests.delete(resp.echo);
+                            clearTimeout(pending.timeout);
+                            if (resp.status === 'ok')
+                                pending.resolve(resp.data);
+                            else
+                                pending.reject(new Error(`OneBot12 retcode=${resp.retcode}: ${resp.message}`));
+                        }
+                        return;
+                    }
+                    const ev = msg;
+                    if (ev.type === 'message' && isMessageEvent(ev)) {
+                        const message = this.$formatMessage(ev);
+                        this.adapter.emit('message.receive', message);
+                        this.logger.debug(`${this.$config.name} recv ${message.$channel.type}(${message.$channel.id}):${segment.raw(message.$content)}`);
+                    }
+                }
+                catch (error) {
+                    this.emit('error', error);
+                }
+            });
+            ws.on('close', () => {
+                this.$connected = false;
+                this.#client = undefined;
+                this.logger.warn('OneBot12 反向 WS 断开');
+            });
+            ws.on('error', (err) => this.logger.error('OneBot12 反向 WS 错误', err));
+        });
+    }
+    async $disconnect() {
+        if (this.heartbeatTimer) {
+            clearInterval(this.heartbeatTimer);
+            this.heartbeatTimer = undefined;
+        }
+        for (const [, p] of this.pendingRequests) {
+            clearTimeout(p.timeout);
+            p.reject(new Error('连接已关闭'));
+        }
+        this.pendingRequests.clear();
+        if (this.#client) {
+            this.#client.close();
+            this.#client = undefined;
+        }
+        this.#wss?.close();
+        this.#wss = undefined;
+        this.$connected = false;
+    }
+    $formatMessage(ev) {
+        if (!isMessageEvent(ev)) {
+            return Message.from(ev, {
+                $id: '',
+                $adapter: 'onebot12',
+                $bot: this.$config.name,
+                $channel: { id: '', type: 'private' },
+                $sender: { id: '', name: '' },
+                $content: [],
+                $raw: '',
+                $timestamp: ev.time ?? 0,
+                $recall: async () => { },
+                $reply: async () => '',
+            });
+        }
+        const payload = formatOneBot12MessagePayload(ev, this.$config.name, (id) => this.$recallMessage(id), (channel, content, _quote) => this.adapter.sendMessage({
+            ...channel,
+            context: 'onebot12',
+            bot: this.$config.name,
+            content: content,
+        }));
+        return Message.from(ev, payload);
+    }
+    async $sendMessage(options) {
+        const message = contentToOb12Segments(options.content);
+        const params = { message };
+        if (options.type === 'private') {
+            params.detail_type = 'private';
+            params.user_id = options.id;
+        }
+        else if (options.type === 'group') {
+            params.detail_type = 'group';
+            params.group_id = options.id;
+        }
+        else {
+            const [guildId, channelId] = options.id.includes(':') ? options.id.split(':') : [undefined, options.id];
+            params.detail_type = 'channel';
+            params.channel_id = channelId ?? options.id;
+            if (guildId)
+                params.guild_id = guildId;
+        }
+        const data = await this.callAction('send_message', params);
+        return data?.message_id ?? '';
+    }
+    async $recallMessage(id) {
+        await this.callAction('delete_message', { message_id: id });
+    }
+}
+//# sourceMappingURL=bot-wss.js.map

package/lib/bot-wss.js.map

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

package/lib/index.d.ts

@@ -0,0 +1,19 @@
+import { OneBot12Adapter } from './adapter.js';
+export * from './types.js';
+export { callOneBot12Action } from './api.js';
+export * from './utils.js';
+export { OneBot12WsClient } from './bot-ws.js';
+export { OneBot12WebhookBot } from './bot-webhook.js';
+export { OneBot12WssServer } from './bot-wss.js';
+export { OneBot12Adapter, type OneBot12Bot } from './adapter.js';
+declare module 'zhin.js' {
+    namespace Plugin {
+        interface Contexts {
+            router: import('@zhin.js/http').Router;
+        }
+    }
+    interface Adapters {
+        onebot12: OneBot12Adapter;
+    }
+}
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAEjE,OAAO,QAAQ,SAAS,CAAC;IACvB,UAAU,MAAM,CAAC;QACf,UAAU,QAAQ;YAChB,MAAM,EAAE,OAAO,eAAe,EAAE,MAAM,CAAC;SACxC;KACF;IACD,UAAU,QAAQ;QAChB,QAAQ,EAAE,eAAe,CAAC;KAC3B;CACF"}

package/lib/index.js

@@ -0,0 +1,27 @@
+/**
+ * OneBot 12 适配器入口：单一适配器，支持正向 WS / Webhook / 反向 WS
+ * 协议文档 https://12.onebot.dev/
+ */
+import { usePlugin } from 'zhin.js';
+import { OneBot12Adapter } from './adapter.js';
+export * from './types.js';
+export { callOneBot12Action } from './api.js';
+export * from './utils.js';
+export { OneBot12WsClient } from './bot-ws.js';
+export { OneBot12WebhookBot } from './bot-webhook.js';
+export { OneBot12WssServer } from './bot-wss.js';
+export { OneBot12Adapter } from './adapter.js';
+const { provide } = usePlugin();
+provide({
+    name: 'onebot12',
+    description: 'OneBot 12 协议适配器（正向 WS / Webhook / 反向 WS）',
+    mounted: async (p) => {
+        const adapter = new OneBot12Adapter(p);
+        await adapter.start();
+        return adapter;
+    },
+    dispose: async (adapter) => {
+        await adapter.stop();
+    },
+});
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,SAAS,EAA6B,MAAM,SAAS,CAAC;AAE/D,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,eAAe,EAAoB,MAAM,cAAc,CAAC;AAajE,MAAM,EAAE,OAAO,EAAE,GAAG,SAAS,EAAE,CAAC;AAChC,OAAO,CAAC;IACN,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,0CAA0C;IACvD,OAAO,EAAE,KAAK,EAAE,CAAS,EAAE,EAAE;QAC3B,MAAM,OAAO,GAAG,IAAI,eAAe,CAAC,CAAC,CAAC,CAAC;QACvC,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QACtB,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,OAAwB,EAAE,EAAE;QAC1C,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;CACgC,CAAC,CAAC"}

package/lib/types.d.ts

@@ -0,0 +1,77 @@
+/**
+ * OneBot 12 适配器类型（参考 https://12.onebot.dev/ ）
+ */
+/** 配置公共字段；单一适配器 context 均为 'onebot12'，连接方式由 connection 区分 */
+export interface OneBot12ConfigBase {
+    context: 'onebot12';
+    name: string;
+    /** 访问令牌，鉴权用 */
+    access_token?: string;
+}
+/** 正向 WebSocket：应用连 OneBot 实现的 WS 服务器 */
+export interface OneBot12WsConfig extends OneBot12ConfigBase {
+    connection: 'ws';
+    /** OneBot 实现提供的 WebSocket 地址，如 ws://127.0.0.1:6700 */
+    url: string;
+    reconnect_interval?: number;
+    heartbeat_interval?: number;
+}
+/** HTTP Webhook：OneBot 实现 POST 事件到应用提供的 path */
+export interface OneBot12WebhookConfig extends OneBot12ConfigBase {
+    connection: 'webhook';
+    /** 应用接收事件的 POST 路径 */
+    path: string;
+    /** 可选：OneBot 实现的 HTTP 端点，用于发消息等动作（实现 POST 事件到我们，我们 POST 动作到该 url） */
+    api_url?: string;
+}
+/** 反向 WebSocket：应用开 WS 服务端，OneBot 实现连上来 */
+export interface OneBot12WssConfig extends OneBot12ConfigBase {
+    connection: 'wss';
+    /** 应用侧 WS 路径 */
+    path: string;
+    heartbeat_interval?: number;
+}
+export type OneBot12BotConfig = OneBot12WsConfig | OneBot12WebhookConfig | OneBot12WssConfig;
+/** 机器人自身标识（事件与动作中的 self） */
+export interface OneBot12Self {
+    platform: string;
+    user_id: string;
+}
+/** 事件（实现推送给应用） */
+export interface OneBot12Event {
+    id: string;
+    time: number;
+    type: 'meta' | 'message' | 'notice' | 'request';
+    detail_type: string;
+    sub_type: string;
+    self?: OneBot12Self;
+    message_id?: string;
+    message?: OneBot12Segment[];
+    alt_message?: string;
+    user_id?: string;
+    group_id?: string;
+    channel_id?: string;
+    guild_id?: string;
+    [key: string]: unknown;
+}
+/** 消息段 */
+export interface OneBot12Segment {
+    type: string;
+    data?: Record<string, unknown>;
+}
+/** 动作请求（应用发给实现） */
+export interface OneBot12ActionRequest {
+    action: string;
+    params: Record<string, unknown>;
+    echo?: string;
+    self?: OneBot12Self;
+}
+/** 动作响应（实现返回给应用） */
+export interface OneBot12ActionResponse {
+    status: 'ok' | 'failed';
+    retcode: number;
+    data?: unknown;
+    message: string;
+    echo?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,6DAA6D;AAC7D,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,UAAU,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,eAAe;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,yCAAyC;AACzC,MAAM,WAAW,gBAAiB,SAAQ,kBAAkB;IAC1D,UAAU,EAAE,IAAI,CAAC;IACjB,sDAAsD;IACtD,GAAG,EAAE,MAAM,CAAC;IACZ,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,gDAAgD;AAChD,MAAM,WAAW,qBAAsB,SAAQ,kBAAkB;IAC/D,UAAU,EAAE,SAAS,CAAC;IACtB,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,2CAA2C;AAC3C,MAAM,WAAW,iBAAkB,SAAQ,kBAAkB;IAC3D,UAAU,EAAE,KAAK,CAAC;IAClB,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,MAAM,iBAAiB,GAAG,gBAAgB,GAAG,qBAAqB,GAAG,iBAAiB,CAAC;AAE7F,4BAA4B;AAC5B,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,kBAAkB;AAClB,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,UAAU;AACV,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,mBAAmB;AACnB,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB;AAED,oBAAoB;AACpB,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,IAAI,GAAG,QAAQ,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}

package/lib/types.js

@@ -0,0 +1,5 @@
+/**
+ * OneBot 12 适配器类型（参考 https://12.onebot.dev/ ）
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/lib/utils.d.ts

@@ -0,0 +1,45 @@
+/**
+ * OneBot 12 事件与 zhin Message 的转换、消息段转换
+ */
+import type { SendContent } from 'zhin.js';
+import type { OneBot12Event, OneBot12Segment } from './types.js';
+/** 判断是否为消息事件（type=message） */
+export declare function isMessageEvent(ev: OneBot12Event): ev is OneBot12Event & {
+    message_id: string;
+    message?: OneBot12Segment[];
+};
+/** 从事件得到 zhin 场景 id：私聊 user_id，群 group_id，频道 channel_id 或 guild_id:channel_id */
+export declare function getChannelId(ev: OneBot12Event): string;
+/** 从事件得到 channel 类型 */
+export declare function getChannelType(ev: OneBot12Event): 'private' | 'group';
+/** 将 OneBot 12 消息事件转为 zhin Message 的 MessageBase 所需字段 */
+export declare function formatOneBot12MessagePayload(ev: OneBot12Event, botName: string, recallFn: (msgId: string) => Promise<void>, replyFn: (channel: {
+    id: string;
+    type: 'group' | 'private';
+}, content: (string | {
+    type: string;
+    data?: Record<string, unknown>;
+})[], quote?: boolean | string) => Promise<string>): {
+    $id: string;
+    $adapter: 'onebot12';
+    $bot: string;
+    $channel: {
+        id: string;
+        type: 'group' | 'private';
+    };
+    $sender: {
+        id: string;
+        name: string;
+    };
+    $content: Array<{
+        type: string;
+        data: Record<string, unknown>;
+    }>;
+    $raw: string;
+    $timestamp: number;
+    $recall: () => Promise<void>;
+    $reply: (content: SendContent, quote?: boolean | string) => Promise<string>;
+};
+/** 将 zhin 的 content（segment 数组或字符串）转为 OneBot 12 message 段数组；简单实现仅 text */
+export declare function contentToOb12Segments(content: SendContent): OneBot12Segment[];
+//# sourceMappingURL=utils.d.ts.map

package/lib/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEjE,8BAA8B;AAC9B,wBAAgB,cAAc,CAAC,EAAE,EAAE,aAAa,GAAG,EAAE,IAAI,aAAa,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,eAAe,EAAE,CAAA;CAAE,CAE3H;AAED,iFAAiF;AACjF,wBAAgB,YAAY,CAAC,EAAE,EAAE,aAAa,GAAG,MAAM,CAOtD;AAED,uBAAuB;AACvB,wBAAgB,cAAc,CAAC,EAAE,EAAE,aAAa,GAAG,SAAS,GAAG,OAAO,CAGrE;AAED,yDAAyD;AACzD,wBAAgB,4BAA4B,CAC1C,EAAE,EAAE,aAAa,EACjB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,EAC1C,OAAO,EAAE,CAAC,OAAO,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,GAAG,SAAS,CAAA;CAAE,EAAE,OAAO,EAAE,CAAC,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GACjL;IACD,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,UAAU,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,GAAG,SAAS,CAAA;KAAE,CAAC;IACpD,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAC7E,CA2BA;AAED,0EAA0E;AAC1E,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,WAAW,GAAG,eAAe,EAAE,CAY7E"}

package/lib/utils.js

@@ -0,0 +1,60 @@
+/** 判断是否为消息事件（type=message） */
+export function isMessageEvent(ev) {
+    return ev.type === 'message' && !!ev.message_id;
+}
+/** 从事件得到 zhin 场景 id：私聊 user_id，群 group_id，频道 channel_id 或 guild_id:channel_id */
+export function getChannelId(ev) {
+    if (ev.detail_type === 'private' && ev.user_id)
+        return ev.user_id;
+    if (ev.detail_type === 'group' && ev.group_id)
+        return ev.group_id;
+    if (ev.detail_type === 'channel' && ev.channel_id) {
+        return ev.guild_id ? `${ev.guild_id}:${ev.channel_id}` : ev.channel_id;
+    }
+    return '';
+}
+/** 从事件得到 channel 类型 */
+export function getChannelType(ev) {
+    if (ev.detail_type === 'private')
+        return 'private';
+    return 'group';
+}
+/** 将 OneBot 12 消息事件转为 zhin Message 的 MessageBase 所需字段 */
+export function formatOneBot12MessagePayload(ev, botName, recallFn, replyFn) {
+    const channelId = getChannelId(ev);
+    const channelType = getChannelType(ev);
+    const raw = ev.alt_message ?? (Array.isArray(ev.message) ? ev.message.map((s) => (s.type === 'text' ? s.data?.text ?? '' : '')).join('') : '');
+    const content = Array.isArray(ev.message)
+        ? ev.message.map((s) => ({ type: s.type, data: (s.data ?? {}) }))
+        : [{ type: 'text', data: { text: raw } }];
+    const senderId = ev.user_id ?? '';
+    const senderName = ev['user.name'] ?? ev['qq.nickname'] ?? senderId;
+    return {
+        $id: ev.message_id,
+        $adapter: 'onebot12',
+        $bot: botName,
+        $channel: { id: channelId, type: channelType },
+        $sender: { id: senderId, name: senderName },
+        $content: content,
+        $raw: raw,
+        $timestamp: ev.time ?? 0,
+        $recall: () => recallFn(ev.message_id),
+        $reply: (cnt, quote) => replyFn({ id: channelId, type: channelType }, (Array.isArray(cnt) ? cnt : [cnt]), quote),
+    };
+}
+/** 将 zhin 的 content（segment 数组或字符串）转为 OneBot 12 message 段数组；简单实现仅 text */
+export function contentToOb12Segments(content) {
+    const arr = Array.isArray(content) ? content : [content];
+    const segs = [];
+    for (const c of arr) {
+        if (typeof c === 'string') {
+            segs.push({ type: 'text', data: { text: c } });
+        }
+        else if (c && typeof c === 'object' && 'type' in c) {
+            const el = c;
+            segs.push({ type: el.type, data: el.data ?? {} });
+        }
+    }
+    return segs.length ? segs : [{ type: 'text', data: { text: '' } }];
+}
+//# sourceMappingURL=utils.js.map

package/lib/utils.js.map

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

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@zhin.js/adapter-onebot12",
+  "version": "0.0.0",
+  "description": "Zhin.js adapter for OneBot 12 protocol",
+  "type": "module",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "import": "./lib/index.js"
+    }
+  },
+  "files": [
+    "lib",
+    "src",
+    "README.md"
+  ],
+  "keywords": [
+    "zhin",
+    "bot",
+    "adapter",
+    "onebot",
+    "onebot12",
+    "chatbot"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "ws": "^8.18.3"
+  },
+  "devDependencies": {
+    "@types/node": "^24.3.0",
+    "@types/ws": "^8.18.1",
+    "typescript": "^5.3.0",
+    "zhin.js": "1.0.50"
+  },
+  "peerDependencies": {
+    "zhin.js": "1.0.50",
+    "@zhin.js/http": "1.0.44"
+  },
+  "peerDependenciesMeta": {
+    "@zhin.js/http": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "build": "tsc && (test -f ../../services/console/lib/bin.js && node ../../services/console/lib/bin.js build || echo 'Skipping client build: console not built yet')",
+    "clean": "rimraf lib"
+  }
+}

package/src/adapter.ts

@@ -0,0 +1,52 @@
+/**
+ * OneBot 12 适配器：单一适配器支持正向 WS / Webhook / 反向 WS，由 config.connection 区分
+ * 协议文档：https://12.onebot.dev/
+ */
+import type { Router } from '@zhin.js/http';
+import { Adapter, Plugin } from 'zhin.js';
+import { OneBot12WsClient } from './bot-ws.js';
+import { OneBot12WebhookBot } from './bot-webhook.js';
+import { OneBot12WssServer } from './bot-wss.js';
+import type {
+  OneBot12BotConfig,
+  OneBot12WsConfig,
+  OneBot12WebhookConfig,
+  OneBot12WssConfig,
+} from './types.js';
+
+export type OneBot12Bot = OneBot12WsClient | OneBot12WebhookBot | OneBot12WssServer;
+
+export class OneBot12Adapter extends Adapter<OneBot12Bot> {
+  #router?: Router;
+
+  constructor(plugin: Plugin) {
+    super(plugin, 'onebot12', []);
+  }
+
+  createBot(config: OneBot12BotConfig): OneBot12Bot {
+    switch (config.connection) {
+      case 'ws':
+        return new OneBot12WsClient(this, config as OneBot12WsConfig);
+      case 'webhook':
+        if (!this.#router) {
+          throw new Error('OneBot12 connection: webhook 需要 router，请安装并在配置中启用 @zhin.js/http');
+        }
+        return new OneBot12WebhookBot(this, this.#router, config as OneBot12WebhookConfig);
+      case 'wss':
+        if (!this.#router) {
+          throw new Error('OneBot12 connection: wss 需要 router，请安装并在配置中启用 @zhin.js/http');
+        }
+        return new OneBot12WssServer(this, this.#router, config as OneBot12WssConfig);
+      default:
+        throw new Error(`Unknown OneBot12 connection: ${(config as OneBot12BotConfig).connection}`);
+    }
+  }
+
+  async start(): Promise<void> {
+    this.#router = (this.plugin.inject as (key: string) => Router | undefined)('router');
+    (this.plugin.useContext as (key: string, fn: (router: Router) => void) => void)('router', (router: Router) => {
+      this.#router = router;
+    });
+    await super.start();
+  }
+}

package/src/api.ts

@@ -0,0 +1,48 @@
+/**
+ * OneBot 12 HTTP 动作调用：POST 动作请求到实现的 HTTP 端点，返回动作响应
+ * 参考 https://12.onebot.dev/connect/communication/http/
+ */
+import type { OneBot12ActionRequest, OneBot12ActionResponse } from './types.js';
+
+export interface OneBot12HttpOptions {
+  url: string;
+  access_token?: string;
+}
+
+/**
+ * 向 OneBot 实现发送动作请求（HTTP POST），返回动作响应
+ */
+export async function callOneBot12Action(
+  options: OneBot12HttpOptions,
+  action: string,
+  params: Record<string, unknown> = {},
+  echo?: string,
+): Promise<OneBot12ActionResponse> {
+  const headers: Record<string, string> = { 'Content-Type': 'application/json' };
+  if (options.access_token) {
+    headers['Authorization'] = `Bearer ${options.access_token}`;
+  }
+  const body: OneBot12ActionRequest = { action, params };
+  if (echo) body.echo = echo;
+
+  const res = await fetch(options.url, {
+    method: 'POST',
+    headers,
+    body: JSON.stringify(body),
+  });
+
+  const text = await res.text();
+  if (res.status === 401) throw new Error(`OneBot12 鉴权失败: ${text}`);
+  if (res.status !== 200) throw new Error(`OneBot12 HTTP ${res.status}: ${text}`);
+
+  let data: OneBot12ActionResponse;
+  try {
+    data = JSON.parse(text) as OneBot12ActionResponse;
+  } catch {
+    throw new Error(`OneBot12 无效响应: ${text.slice(0, 200)}`);
+  }
+  if (data.status === 'failed' && data.retcode !== 0) {
+    throw new Error(`OneBot12 动作失败 retcode=${data.retcode}: ${data.message}`);
+  }
+  return data;
+}