@zhin.js/adapter-onebot12 1.0.1 → 1.1.2

package/lib/utils.js

@@ -1,60 +0,0 @@
-/** 判断是否为消息事件（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, endpointName, 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',
-        $endpoint: endpointName,
-        $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

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

package/skills/onebot12/SKILL.md

@@ -1,36 +0,0 @@
----
-name: onebot12
-platforms:
-  - onebot12
-description: >-
-  OneBot 12 协议适配器：支持 WebSocket 正向连接、Webhook 回调和反向 WebSocket
-  三种连接模式，兼容 OneBot 12 标准协议。纯消息通道，无额外 AI 工具。
-  支持私聊、群聊、频道消息。
-keywords:
-  - onebot12
-  - onebot
-  - adapter:onebot12
-  - protocol
-  - websocket
-  - webhook
-  - 协议
-tags:
-  - onebot12
-  - protocol
-  - adapter
-tools: []
----
-
-# OneBot 12 协议适配器
-
-纯协议适配器，收发消息。无 AI 工具可调用。
-
-## 连接模式
-
-- **WS 正向**：Bot 主动连接 OneBot 12 服务端
-- **Webhook**：OneBot 12 向配置的 URL 推送事件
-- **WS 反向**：OneBot 12 主动连接 Endpoint 的 WS 服务端
-
-## 与 OneBot11 的区别
-
-OneBot 12 标准化了事件格式、消息段类型和 API 响应结构。如果需要群管理等 AI 工具，使用 OneBot11 适配器。

package/src/adapter.ts

@@ -1,54 +0,0 @@
-/**
- * OneBot 12 适配器：单一适配器支持正向 WS / Webhook / 反向 WS，由 config.connection 区分
- * 协议文档：https://12.onebot.dev/
- */
-import { formatCompact, Adapter, Plugin } from 'zhin.js';
-import type { Router } from '@zhin.js/host-router';
-import { OneBot12WsClient } from './endpoint-ws.js';
-import { OneBot12WebhookEndpoint } from './endpoint-webhook.js';
-import { OneBot12WssServer } from './endpoint-wss.js';
-import type {
-  OneBot12EndpointConfig,
-  OneBot12WsConfig,
-  OneBot12WebhookConfig,
-  OneBot12WssConfig,
-} from './types.js';
-
-export type OneBot12Bot = OneBot12WsClient | OneBot12WebhookEndpoint | OneBot12WssServer;
-
-export class OneBot12Adapter extends Adapter<OneBot12Bot> {
-  static override readonly capabilities = ['inbound', 'outbound'] as const;
-
-  #router?: Router;
-
-  constructor(plugin: Plugin) {
-    super(plugin, 'onebot12', []);
-  }
-
-  createEndpoint(config: OneBot12EndpointConfig): 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/host-router');
-        }
-        return new OneBot12WebhookEndpoint(this, this.#router, config as OneBot12WebhookConfig);
-      case 'wss':
-        if (!this.#router) {
-          throw new Error('OneBot12 connection: wss 需要 router，请安装并在配置中启用 @zhin.js/host-router');
-        }
-        return new OneBot12WssServer(this, this.#router, config as OneBot12WssConfig);
-      default:
-        throw new Error(`Unknown OneBot12 connection: ${(config as OneBot12EndpointConfig).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

@@ -1,48 +0,0 @@
-/**
- * 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;
-}

package/src/endpoint-webhook.ts

@@ -1,130 +0,0 @@
-/**
- * OneBot 12 HTTP Webhook Bot：OneBot 实现 POST 事件到应用 path，可选 api_url 用于发消息
- */
-import { EventEmitter } from 'events';
-import { formatCompact, Endpoint, Message, segment, SendOptions } from 'zhin.js';
-import { registerFetchRoute, type Router, type RouterContext } from '@zhin.js/host-router/router';
-import { callOneBot12Action } from './api.js';
-import type { OneBot12WebhookConfig, OneBot12Event } from './types.js';
-import type { OneBot12Adapter } from './adapter.js';
-import { formatOneBot12MessagePayload, isMessageEvent, contentToOb12Segments } from './utils.js';
-
-export class OneBot12WebhookEndpoint extends EventEmitter implements Endpoint<OneBot12WebhookConfig, OneBot12Event> {
-  $connected: boolean = true;
-
-  get logger() {
-    return this.adapter.plugin.logger;
-  }
-
-  constructor(
-    public adapter: OneBot12Adapter,
-    public router: Router,
-    public $config: OneBot12WebhookConfig,
-  ) {
-    super();
-  }
-
-  get $id() {
-    return this.$config.name;
-  }
-
-  private httpOptions() {
-    const url = this.$config.api_url?.replace(/\/$/, '') ?? '';
-    return { url: url || '', access_token: this.$config.access_token };
-  }
-
-  async $connect(): Promise<void> {
-    const path = this.$config.path.startsWith('/') ? this.$config.path : `/${this.$config.path}`;
-    registerFetchRoute(this.router, 'POST', path, async (ctx: RouterContext) => {
-      const body = ctx.request.body as OneBot12Event | undefined;
-      if (!body || typeof body !== 'object' || !body.id || body.time == null || !body.type) {
-        ctx.status = 400;
-        ctx.body = { message: 'Invalid OneBot12 event' };
-        return;
-      }
-      const token = this.$config.access_token;
-      const auth = ctx.get('authorization');
-      if (token && auth !== `Bearer ${token}`) {
-        ctx.status = 401;
-        ctx.body = { message: 'Unauthorized' };
-        return;
-      }
-      this.handleEvent(body);
-      ctx.status = 204;
-      ctx.body = undefined;
-    });
-    this.logger.info(formatCompact( { op: 'webhook', path }));
-  }
-
-  async $disconnect(): Promise<void> {
-    this.$connected = false;
-  }
-
-  private handleEvent(ev: OneBot12Event): void {
-    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)}`);
-    }
-  }
-
-  $formatMessage(ev: OneBot12Event): Message<OneBot12Event> {
-    if (!isMessageEvent(ev)) {
-      return Message.from(ev, {
-        $id: '',
-        $adapter: 'onebot12',
-        $endpoint: 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',
-          endpoint: this.$config.name,
-          content: content as import('zhin.js').SendContent,
-        }),
-    );
-    return Message.from(ev, payload);
-  }
-
-  async $sendMessage(options: SendOptions): Promise<string> {
-    const apiUrl = this.$config.api_url;
-    if (!apiUrl) {
-      throw new Error('OneBot12 Webhook 发消息需要配置 api_url（OneBot 实现的 HTTP 端点）');
-    }
-    const message = contentToOb12Segments(options.content);
-    const params: Record<string, unknown> = { 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 callOneBot12Action(this.httpOptions(), 'send_message', params);
-    const out = (data as { message_id?: string })?.message_id ?? '';
-    return out;
-  }
-
-  async $recallMessage(id: string): Promise<void> {
-    const apiUrl = this.$config.api_url;
-    if (!apiUrl) throw new Error('OneBot12 Webhook 撤回需要配置 api_url');
-    await callOneBot12Action(this.httpOptions(), 'delete_message', { message_id: id });
-  }
-}

package/src/endpoint-ws.ts

@@ -1,222 +0,0 @@
-/**
- * OneBot 12 正向 WebSocket Bot：应用连 OneBot 实现的 WS，收事件、发动作
- */
-import WebSocket from 'ws';
-import { EventEmitter } from 'events';
-import { clearInterval, clearTimeout } from 'node:timers';
-import { formatCompact, Endpoint, Message, segment, SendOptions } from 'zhin.js';
-import type { OneBot12WsConfig, OneBot12Event, OneBot12ActionRequest, OneBot12ActionResponse } from './types.js';
-import type { OneBot12Adapter } from './adapter.js';
-import { formatOneBot12MessagePayload, isMessageEvent, contentToOb12Segments } from './utils.js';
-
-export class OneBot12WsClient extends EventEmitter implements Endpoint<OneBot12WsConfig, OneBot12Event> {
-  $connected: boolean;
-  private ws?: WebSocket;
-  private reconnectTimer?: NodeJS.Timeout;
-  private heartbeatTimer?: NodeJS.Timeout;
-  private requestId = 0;
-  private pendingRequests = new Map<string, { resolve: (value: unknown) => void; reject: (err: Error) => void; timeout: NodeJS.Timeout }>();
-
-  get logger() {
-    return this.adapter.plugin.logger;
-  }
-
-  constructor(public adapter: OneBot12Adapter, public $config: OneBot12WsConfig) {
-    super();
-    this.$connected = false;
-  }
-
-  get $id() {
-    return this.$config.name;
-  }
-
-  private startHeartbeat(): void {
-    const interval = this.$config.heartbeat_interval ?? 30000;
-    this.heartbeatTimer = setInterval(() => {
-      this.callAction('get_status', {}).catch(() => {});
-    }, interval);
-  }
-
-  private scheduleReconnect(): void {
-    if (this.reconnectTimer) return;
-    const delay = this.$config.reconnect_interval ?? 5000;
-    this.reconnectTimer = setTimeout(() => {
-      this.reconnectTimer = undefined;
-      this.$connect().catch((err) => this.logger.warn(formatCompact( {
-        op: 'reconnect',
-        endpoint: this.$id,
-        ok: false,
-        error: err instanceof Error ? err.message : String(err),
-      })));
-    }, delay);
-  }
-
-  private callAction(action: string, params: Record<string, unknown>): Promise<OneBot12ActionResponse['data']> {
-    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
-      return Promise.reject(new Error('WebSocket 未连接'));
-    }
-    const echo = `ob12_${++this.requestId}`;
-    const req: OneBot12ActionRequest = { 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: unknown) => resolve(data as OneBot12ActionResponse['data']),
-        reject,
-        timeout,
-      });
-      this.ws!.send(JSON.stringify(req));
-    });
-  }
-
-  async $connect(): Promise<void> {
-    return new Promise((resolve, reject) => {
-      const headers: Record<string, string> = {};
-      let connectUrl = this.$config.url;
-      if (this.$config.access_token) {
-        headers['Authorization'] = `Bearer ${this.$config.access_token}`;
-        const url = new URL(this.$config.url);
-        url.searchParams.set('access_token', this.$config.access_token);
-        connectUrl = url.toString();
-      }
-      this.ws = new WebSocket(connectUrl, { headers });
-
-      this.ws.on('open', () => {
-        this.$connected = true;
-        const safeUrl = new URL(connectUrl);
-        safeUrl.searchParams.delete('access_token');
-        this.logger.info(formatCompact({ endpoint: this.$id, mode: 'ws' }));
-        this.startHeartbeat();
-        resolve();
-      });
-
-      this.ws.on('message', (data) => {
-        try {
-          const msg = JSON.parse(data.toString()) as OneBot12Event | OneBot12ActionResponse;
-          if ('echo' in msg && typeof (msg as OneBot12ActionResponse).echo === 'string') {
-            const resp = msg as OneBot12ActionResponse;
-            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 as OneBot12Event;
-          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);
-        }
-      });
-
-      this.ws.on('close', (code, reason) => {
-        this.$connected = false;
-        const reasonStr = reason?.toString?.() || String(reason);
-        const codeHint = code === 1005 ? ' [无状态，多为服务端/代理未发 close 帧即断开]' : code === 1006 ? ' [异常关闭]' : '';
-        this.logger.warn(formatCompact( {
-          op: 'disconnect',
-          endpoint: this.$config.name,
-          code,
-          error: `${reasonStr || 'closed'}${codeHint}`,
-          reconnect_ms: this.$config.reconnect_interval ?? 5000,
-        }));
-        reject(new Error(`OneBot12 WS 关闭: ${code} ${reasonStr}`));
-        this.scheduleReconnect();
-      });
-
-      this.ws.on('error', (err) => {
-        this.logger.warn(formatCompact( {
-          op: 'ws_error',
-          endpoint: this.$config.name,
-          ok: false,
-          error: err instanceof Error ? err.message : String(err),
-        }));
-        reject(err);
-      });
-    });
-  }
-
-  async $disconnect(): Promise<void> {
-    if (this.reconnectTimer) {
-      clearTimeout(this.reconnectTimer);
-      this.reconnectTimer = undefined;
-    }
-    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.ws) {
-      this.ws.close();
-      this.ws = undefined;
-    }
-    this.$connected = false;
-  }
-
-  $formatMessage(ev: OneBot12Event): Message<OneBot12Event> {
-    if (!isMessageEvent(ev)) {
-      return Message.from(ev, {
-        $id: '',
-        $adapter: 'onebot12',
-        $endpoint: 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',
-          endpoint: this.$config.name,
-          content: content as import('zhin.js').SendContent,
-        }),
-    );
-    return Message.from(ev, payload);
-  }
-
-  async $sendMessage(options: SendOptions): Promise<string> {
-    const message = contentToOb12Segments(options.content);
-    const params: Record<string, unknown> = { 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) as { message_id?: string } | undefined;
-    const msgId = data?.message_id ?? '';
-    this.logger.debug(`${this.$config.name} send ${options.type}(${options.id}):${segment.raw(options.content)}`);
-    return msgId;
-  }
-
-  async $recallMessage(id: string): Promise<void> {
-    await this.callAction('delete_message', { message_id: id });
-  }
-}