@zhin.js/adapter-milky 3.0.2 → 5.0.0

package/lib/src/utils.js

@@ -1,169 +0,0 @@
-/**
- * Milky 事件/消息段与 zhin Message 的转换
- */
-import { applyQqSenderRoleToMessageSender } from 'zhin.js';
-import { toCanonicalSegments } from './segment-mapper.js';
-/** 将 Milky 接收消息段转为 zhin 的 $content（MessageSegment[]） */
-export function formatMilkySegments(segments) {
-    return segments.map((seg) => {
-        const type = seg.type;
-        const data = seg.data ?? {};
-        switch (type) {
-            case 'text':
-                return { type: 'text', data: { text: data.text ?? '' } };
-            case 'mention':
-                return { type: 'at', data: { id: String(data.user_id ?? '') } };
-            case 'mention_all':
-                return { type: 'at', data: { type: 'all' } };
-            case 'face':
-                return { type: 'face', data: { id: data.face_id ?? '' } };
-            case 'reply':
-                return {
-                    type: 'reply',
-                    data: { message_seq: data.message_seq },
-                };
-            case 'image':
-                return {
-                    type: 'image',
-                    data: {
-                        url: data.temp_url ?? data.resource_id ?? '',
-                    },
-                };
-            case 'record':
-                return {
-                    type: 'record',
-                    data: {
-                        url: data.temp_url ?? data.resource_id ?? '',
-                    },
-                };
-            case 'video':
-                return {
-                    type: 'video',
-                    data: {
-                        url: data.temp_url ?? data.resource_id ?? '',
-                    },
-                };
-            case 'file':
-                return {
-                    type: 'file',
-                    data: {
-                        file_id: data.file_id,
-                        name: data.file_name,
-                    },
-                };
-            default:
-                return { type, data: data };
-        }
-    });
-}
-/** message_receive 事件的 data 转为 zhin Message 的构造参数（含 $adapter、$endpoint） */
-export function formatMilkyMessagePayload(event, data, recallFn, replyFn, adapterName, endpointName) {
-    const scene = data.message_scene;
-    const isGroup = scene === 'group';
-    const channelId = data.peer_id.toString();
-    const msgId = `${data.message_scene}:${data.peer_id}:${data.message_seq}`;
-    const channel = { id: channelId, type: (isGroup ? 'group' : 'private') };
-    const senderId = data.sender_id.toString();
-    const senderName = (isGroup ? data.group_member?.card ?? data.group_member?.nickname : data.friend?.nickname) ?? senderId;
-    const content = toCanonicalSegments(formatMilkySegments(data.segments));
-    const raw = content.map((c) => (c.type === 'text' ? c.data.text : '')).join('');
-    return {
-        $id: msgId,
-        $adapter: 'milky',
-        $endpoint: endpointName,
-        $channel: channel,
-        $sender: (() => {
-            const sender = {
-                id: senderId,
-                name: senderName,
-            };
-            applyQqSenderRoleToMessageSender(sender, data.group_member?.role);
-            return sender;
-        })(),
-        $content: content,
-        $raw: raw,
-        $timestamp: data.time,
-        $recall: () => recallFn(msgId),
-        $reply: (cnt, quote) => replyFn(channel, (Array.isArray(cnt) ? cnt : [cnt]), quote),
-    };
-}
-/** 根据 event_type 判断是否为 message_receive，并解析 data 为 MilkyIncomingMessage */
-export function parseMessageReceiveData(event) {
-    if (event.event_type !== 'message_receive' || !event.data)
-        return null;
-    const data = event.data;
-    if (!data.message_scene || !Number.isInteger(data.peer_id) || !Array.isArray(data.segments))
-        return null;
-    return data;
-}
-/** zhin SendContent（string | MessageElement 或数组）转为 Milky OutgoingSegment[]（发送用） */
-export function toMilkyOutgoingSegments(content) {
-    const out = [];
-    for (const seg of content) {
-        const type = typeof seg === 'string' ? 'text' : seg.type;
-        const data = typeof seg === 'string' ? { text: seg } : (seg.data ?? {});
-        switch (type) {
-            case 'text':
-                out.push({ type: 'text', data: { text: String(data.text ?? '') } });
-                break;
-            case 'at':
-                if (data.type === 'all') {
-                    out.push({ type: 'mention_all', data: {} });
-                }
-                else {
-                    const id = data.id;
-                    if (id)
-                        out.push({ type: 'mention', data: { user_id: Number(id) || 0 } });
-                }
-                break;
-            case 'face':
-                out.push({ type: 'face', data: { face_id: String(data.id ?? ''), is_large: false } });
-                break;
-            case 'reply':
-                // message_id 可能为 scene:peer:seq 或仅 message_seq
-                const mid = data.message_id ?? data.message_seq;
-                const seq = typeof mid === 'number' ? mid : parseInt(String(mid).split(':').pop() ?? '0', 10);
-                out.push({ type: 'reply', data: { message_seq: seq } });
-                break;
-            case 'image':
-                out.push({
-                    type: 'image',
-                    data: { uri: String(data.url ?? data.uri ?? '') },
-                });
-                break;
-            case 'record':
-                out.push({
-                    type: 'record',
-                    data: { uri: String(data.url ?? data.uri ?? '') },
-                });
-                break;
-            case 'video':
-                out.push({
-                    type: 'video',
-                    data: {
-                        uri: String(data.url ?? data.uri ?? ''),
-                        thumb_uri: data.thumb_uri,
-                    },
-                });
-                break;
-            default:
-                out.push({ type, data: data });
-        }
-    }
-    return out;
-}
-/** 解析 $id 为 message_scene、peer_id、message_seq（用于撤回） */
-export function parseMilkyMessageId(msgId) {
-    const parts = msgId.split(':');
-    if (parts.length < 3)
-        return null;
-    const [scene, peer, seq] = parts;
-    if (scene !== 'friend' && scene !== 'group' && scene !== 'temp')
-        return null;
-    const peerId = parseInt(peer, 10);
-    const messageSeq = parseInt(seq, 10);
-    if (Number.isNaN(peerId) || Number.isNaN(messageSeq))
-        return null;
-    return { message_scene: scene, peer_id: peerId, message_seq: messageSeq };
-}
-//# sourceMappingURL=utils.js.map

package/lib/src/utils.js.map

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

package/plugin.yml

@@ -1,3 +0,0 @@
-name: adapter-milky
-description: Milky 协议适配器：QQ 群管理
-version: 0.0.8

package/src/adapter.ts

@@ -1,111 +0,0 @@
-/**
- * Milky 适配器：单一适配器支持 WS 正向 / SSE / Webhook / 反向 WS，由 config.connection 区分
- */
-import { formatCompact, Adapter, Plugin, type ISceneManagement, OUTBOUND_RICH_SEGMENT_POLICY_IM_FULL, ONEBOT_KEYBOARD_AI_OUTBOUND_EXTENSION } from 'zhin.js';
-import type { Router } from '@zhin.js/host-router';
-import { MilkyWsClient } from './endpoint-ws.js';
-import { MilkySseClient } from './endpoint-sse.js';
-import { MilkyWebhookEndpoint } from './endpoint-webhook.js';
-import { MilkyWssServer } from './endpoint-wss.js';
-import type {
-  MilkyEndpointConfig,
-  MilkyWsConfig,
-  MilkySseConfig,
-  MilkyWebhookConfig,
-  MilkyWssConfig,
-} from './types.js';
-
-export type MilkyBot = MilkyWsClient | MilkySseClient | MilkyWebhookEndpoint | MilkyWssServer;
-
-export class MilkyAdapter extends Adapter<MilkyBot> {
-  static override readonly capabilities = ['inbound', 'outbound'] as const;
-  static override outboundRichSegmentPolicy = OUTBOUND_RICH_SEGMENT_POLICY_IM_FULL;
-  static override interactivePolicy = 'text' as const;
-  static override aiOutboundCapabilities = {
-    mentions: true,
-    richSegments: ['qrcode', 'html', 'markdown', 'tts'],
-    interactive: 'text' as const,
-  };
-  static override aiOutboundExtensions = [ONEBOT_KEYBOARD_AI_OUTBOUND_EXTENSION];
-
-  #router?: Router;
-
-  constructor(plugin: Plugin) {
-    super(plugin, 'milky', []);
-  }
-
-  createEndpoint(config: MilkyEndpointConfig): MilkyBot {
-    switch (config.connection) {
-      case 'ws':
-        return new MilkyWsClient(this, config as MilkyWsConfig);
-      case 'sse':
-        return new MilkySseClient(this, config as MilkySseConfig);
-      case 'webhook':
-        if (!this.#router) throw new Error('Milky connection: webhook 需要 router，请安装并在配置中启用 @zhin.js/host-router');
-        return new MilkyWebhookEndpoint(this, this.#router, config as MilkyWebhookConfig);
-      case 'wss':
-        if (!this.#router) throw new Error('Milky connection: wss 需要 router，请安装并在配置中启用 @zhin.js/host-router');
-        return new MilkyWssServer(this, this.#router, config as MilkyWssConfig);
-      default:
-        throw new Error(`Unknown Milky connection: ${(config as MilkyEndpointConfig).connection}`);
-    }
-  }
-
-  async removeMember(endpointId: string, sceneId: string, userId: string) {
-    const endpoint = this.endpoints.get(endpointId);
-    if (!endpoint) throw new Error(`Endpoint ${endpointId} 不存在`);
-    return endpoint.kickMember(Number(sceneId), Number(userId), false);
-  }
-
-  async muteMember(endpointId: string, sceneId: string, userId: string, duration = 600) {
-    const endpoint = this.endpoints.get(endpointId);
-    if (!endpoint) throw new Error(`Endpoint ${endpointId} 不存在`);
-    return endpoint.muteMember(Number(sceneId), Number(userId), duration);
-  }
-
-  async setSceneMuted(endpointId: string, sceneId: string, enable = true) {
-    const endpoint = this.endpoints.get(endpointId);
-    if (!endpoint) throw new Error(`Endpoint ${endpointId} 不存在`);
-    return endpoint.muteAll(Number(sceneId), enable);
-  }
-
-  async setModerator(endpointId: string, sceneId: string, userId: string, enable = true) {
-    const endpoint = this.endpoints.get(endpointId);
-    if (!endpoint) throw new Error(`Endpoint ${endpointId} 不存在`);
-    return endpoint.setAdmin(Number(sceneId), Number(userId), enable);
-  }
-
-  async setMemberNickname(endpointId: string, sceneId: string, userId: string, nickname: string) {
-    const endpoint = this.endpoints.get(endpointId);
-    if (!endpoint) throw new Error(`Endpoint ${endpointId} 不存在`);
-    return endpoint.setCard(Number(sceneId), Number(userId), nickname);
-  }
-
-  async renameScene(endpointId: string, sceneId: string, name: string) {
-    const endpoint = this.endpoints.get(endpointId);
-    if (!endpoint) throw new Error(`Endpoint ${endpointId} 不存在`);
-    return endpoint.setGroupName(Number(sceneId), name);
-  }
-
-  async listMembers(endpointId: string, sceneId: string) {
-    const endpoint = this.endpoints.get(endpointId);
-    if (!endpoint) throw new Error(`Endpoint ${endpointId} 不存在`);
-    const members = await endpoint.getMemberList(Number(sceneId));
-    return { members: Array.isArray(members) ? members : [], count: Array.isArray(members) ? members.length : 0 };
-  }
-
-  async getSceneInfo(endpointId: string, sceneId: string) {
-    const endpoint = this.endpoints.get(endpointId);
-    if (!endpoint) throw new Error(`Endpoint ${endpointId} 不存在`);
-    return endpoint.getGroupInfo(Number(sceneId));
-  }
-
-  async start(): Promise<void> {
-    // 同步获取已就绪的 router，或通过 useContext 在 router 挂载后赋值
-    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,63 +0,0 @@
-/**
- * Milky HTTP API 封装：鉴权 + POST /api/:api
- */
-import type { MilkyApiResponse } from './types.js';
-
-export interface MilkyApiClientOptions {
-  baseUrl: string;
-  access_token?: string;
-}
-
-/** 鉴权：Header Authorization: Bearer {token} 或 URL query access_token=xxx */
-function authHeaders(access_token?: string): Record<string, string> {
-  const headers: Record<string, string> = {};
-  if (access_token) {
-    headers['Authorization'] = `Bearer ${access_token}`;
-  }
-  return headers;
-}
-
-function authQuery(access_token?: string): string {
-  if (!access_token) return '';
-  return `access_token=${encodeURIComponent(access_token)}`;
-}
-
-/**
- * 调用协议端 API：POST {baseUrl}/api/{apiName}，Body JSON，鉴权。
- * 非 200 或 retcode !== 0 时抛错。
- */
-export async function callApi<T = unknown>(
-  options: MilkyApiClientOptions,
-  apiName: string,
-  params: Record<string, unknown> = {},
-): Promise<T> {
-  const { baseUrl, access_token } = options;
-  const url = new URL(`/api/${apiName}`, baseUrl.replace(/\/$/, ''));
-  const q = authQuery(access_token);
-  if (q) url.search = (url.search ? url.search + '&' : '') + q;
-
-  const res = await fetch(url.toString(), {
-    method: 'POST',
-    headers: {
-      'Content-Type': 'application/json',
-      ...authHeaders(access_token),
-    },
-    body: JSON.stringify(Object.keys(params).length ? params : {}),
-  });
-
-  const text = await res.text();
-  let body: MilkyApiResponse<T>;
-  try {
-    body = JSON.parse(text) as MilkyApiResponse<T>;
-  } catch {
-    throw new Error(`Milky API ${apiName}: invalid JSON response (${res.status}) ${text.slice(0, 200)}`);
-  }
-
-  if (res.status !== 200) {
-    throw new Error(`Milky API ${apiName}: HTTP ${res.status} ${body.message ?? text}`);
-  }
-  if (body.retcode !== 0) {
-    throw new Error(`Milky API ${apiName}: retcode=${body.retcode} ${body.message ?? ''}`);
-  }
-  return (body.data ?? {}) as T;
-}

package/src/endpoint-sse.ts

@@ -1,232 +0,0 @@
-/**
- * Milky SSE Bot：应用 GET 协议端 /event，Accept: text/event-stream，解析 SSE 的 milky_event
- */
-import EventSource from 'eventsource';
-import { EventEmitter } from 'events';
-import { formatCompact, Endpoint, Message, segment, SendOptions, expandInteractiveSegmentsInContent,} from 'zhin.js';
-import { callApi } from './api.js';
-import type { MilkySseConfig, MilkyEvent } from './types.js';
-import type { MilkyAdapter } from './adapter.js';
-import {
-  formatMilkyMessagePayload,
-  parseMessageReceiveData,
-  toMilkyOutgoingSegments,
-  parseMilkyMessageId,
-} from './utils.js';
-import { fromCanonicalSegments } from './segment-mapper.js';
-
-export class MilkySseClient extends EventEmitter implements Endpoint<MilkySseConfig, MilkyEvent> {
-  $connected: boolean;
-  private es?: EventSource;
-
-  get logger() {
-    return this.adapter.plugin.logger;
-  }
-
-  constructor(public adapter: MilkyAdapter, public $config: MilkySseConfig) {
-    super();
-    this.$connected = false;
-  }
-
-  get $id() {
-    return this.$config.name;
-  }
-
-  private get eventUrl(): string {
-    const base = this.$config.baseUrl.replace(/\/$/, '');
-    const url = `${base}/event`;
-    const token = this.$config.access_token;
-    if (token) return `${url}${url.includes('?') ? '&' : '?'}access_token=${encodeURIComponent(token)}`;
-    return url;
-  }
-
-  private apiOptions() {
-    return { baseUrl: this.$config.baseUrl, access_token: this.$config.access_token };
-  }
-
-  async $connect(): Promise<void> {
-    const headers: Record<string, string> = { Accept: 'text/event-stream' };
-    if (this.$config.access_token) {
-      headers['Authorization'] = `Bearer ${this.$config.access_token}`;
-    }
-    this.es = new EventSource(this.eventUrl, { headers });
-    this.$connected = true;
-    if (!this.$config.access_token) {
-      this.logger.warn(formatCompact({ endpoint: this.$id, ok: false, error: 'missing access_token' }));
-    }
-
-    this.es.addEventListener('milky_event', (e: MessageEvent) => {
-      try {
-        const event = JSON.parse(e.data) as MilkyEvent;
-        this.handleEvent(event);
-      } catch (err: unknown) {
-        this.emit('error', err instanceof Error ? err : new Error(String(err)));
-      }
-    });
-
-    this.es.onerror = (err: unknown) => {
-      this.emit('error', err instanceof Error ? err : new Error(String(err)));
-    };
-  }
-
-  async $disconnect(): Promise<void> {
-    if (this.es) {
-      this.es.close();
-      this.es = undefined;
-    }
-    this.$connected = false;
-  }
-
-  $formatMessage(event: MilkyEvent): Message<MilkyEvent> {
-    const data = parseMessageReceiveData(event);
-    if (!data) {
-      return Message.from(event, {
-        $id: '',
-        $adapter: 'milky',
-        $endpoint: this.$config.name,
-        $channel: { id: '', type: 'private' },
-        $sender: { id: '', name: '' },
-        $content: [],
-        $raw: '',
-        $timestamp: event.time ?? 0,
-        $recall: async () => {},
-        $reply: async () => '',
-      });
-    }
-    const payload = formatMilkyMessagePayload(
-      event,
-      data,
-      (id) => this.$recallMessage(id),
-      (channel, content) =>
-        this.adapter.sendMessage({
-          ...channel,
-          context: 'milky',
-          endpoint: this.$config.name,
-          content: content as import('zhin.js').SendContent,
-        }),
-      'milky',
-      this.$config.name,
-    );
-    return Message.from(event, payload);
-  }
-
-  private handleEvent(event: MilkyEvent): void {
-    const data = parseMessageReceiveData(event);
-    if (data) {
-      const message = this.$formatMessage(event);
-      this.adapter.emit('message.receive', message);
-      this.logger.debug(
-        `${this.$config.name} recv ${message.$channel.type}(${message.$channel.id}):${segment.raw(message.$content)}`,
-      );
-    }
-  }
-
-  async $sendMessage(options: SendOptions): Promise<string> {
-    const expanded = expandInteractiveSegmentsInContent(options.content);
-    const arr = Array.isArray(expanded) ? expanded : [expanded];
-    const wire = fromCanonicalSegments(
-      arr.map((c) => (typeof c === 'string' ? { type: 'text' as const, data: { text: c } } : c)),
-    );
-    const message = toMilkyOutgoingSegments(
-      wire as (string | { type: string; data?: Record<string, unknown> })[],
-    );
-    if (options.type === 'group') {
-      const result = await callApi(this.apiOptions(), 'send_group_message', {
-        group_id: parseInt(options.id, 10),
-        message,
-      });
-      const seq = (result as { message_seq?: number }).message_seq;
-      this.logger.debug(`${this.$config.name} send group(${options.id}):${segment.raw(options.content)}`);
-      return seq != null ? `group:${options.id}:${seq}` : '';
-    }
-    if (options.type === 'private') {
-      const result = await callApi(this.apiOptions(), 'send_private_message', {
-        user_id: parseInt(options.id, 10),
-        message,
-      });
-      const seq = (result as { message_seq?: number }).message_seq;
-      this.logger.debug(`${this.$config.name} send private(${options.id}):${segment.raw(options.content)}`);
-      return seq != null ? `friend:${options.id}:${seq}` : '';
-    }
-    throw new Error('Either group or private must be provided');
-  }
-
-  async $recallMessage(id: string): Promise<void> {
-    const parsed = parseMilkyMessageId(id);
-    if (!parsed) throw new Error(`Invalid message id: ${id}`);
-    if (parsed.message_scene === 'group') {
-      await callApi(this.apiOptions(), 'recall_group_message', {
-        group_id: parsed.peer_id,
-        message_seq: parsed.message_seq,
-      });
-    } else {
-      await callApi(this.apiOptions(), 'recall_private_message', {
-        user_id: parsed.peer_id,
-        message_seq: parsed.message_seq,
-      });
-    }
-  }
-
-  async kickMember(groupId: number, userId: number, rejectAddRequest = false): Promise<boolean> {
-    await callApi(this.apiOptions(), 'kick_group_member', {
-      group_id: groupId,
-      user_id: userId,
-      reject_add_request: rejectAddRequest,
-    });
-    return true;
-  }
-
-  async muteMember(groupId: number, userId: number, duration = 600): Promise<boolean> {
-    await callApi(this.apiOptions(), 'set_group_member_mute', {
-      group_id: groupId,
-      user_id: userId,
-      duration,
-    });
-    return true;
-  }
-
-  async muteAll(groupId: number, enable = true): Promise<boolean> {
-    await callApi(this.apiOptions(), 'set_group_whole_mute', { group_id: groupId, is_mute: enable });
-    return true;
-  }
-
-  async setAdmin(groupId: number, userId: number, enable = true): Promise<boolean> {
-    await callApi(this.apiOptions(), 'set_group_member_admin', {
-      group_id: groupId,
-      user_id: userId,
-      is_set: enable,
-    });
-    return true;
-  }
-
-  async setCard(groupId: number, userId: number, card: string): Promise<boolean> {
-    await callApi(this.apiOptions(), 'set_group_member_card', {
-      group_id: groupId,
-      user_id: userId,
-      card,
-    });
-    return true;
-  }
-
-  async setTitle(groupId: number, userId: number, title: string): Promise<boolean> {
-    await callApi(this.apiOptions(), 'set_group_member_special_title', {
-      group_id: groupId,
-      user_id: userId,
-      special_title: title,
-    });
-    return true;
-  }
-
-  async setGroupName(groupId: number, name: string): Promise<boolean> {
-    await callApi(this.apiOptions(), 'set_group_name', { group_id: groupId, new_group_name: name });
-    return true;
-  }
-
-  async getMemberList(groupId: number): Promise<unknown[]> {
-    return callApi(this.apiOptions(), 'get_group_member_list', { group_id: groupId }) as Promise<unknown[]>;
-  }
-
-  async getGroupInfo(groupId: number): Promise<unknown> {
-    return callApi(this.apiOptions(), 'get_group_info', { group_id: groupId });
-  }
-}