@karinjs/adapter-qqbot 1.2.8 → 1.2.10

package/lib/core/adapter/markdown.js

@@ -0,0 +1,220 @@
+import FormData from 'form-data';
+import { handleUrl, qrs, textToButton } from '@/utils/common';
+import { common, fileToUrl, buttonHandle } from 'node-karin';
+import { AdapterQQBot } from '@/core/adapter/adapter';
+/** markdown */
+export class AdapterQQBotMarkdown extends AdapterQQBot {
+    _config;
+    markdown;
+    constructor(QQBot, markdown, config) {
+        super(QQBot);
+        this.markdown = markdown;
+        this._config = config;
+    }
+    async srcReply(e, elements) {
+        const list = await buttonHandle(e.msg, { e });
+        return this.sendMsg(e.contact, [...elements, ...list]);
+    }
+    async sendMsg(contact, elements, retryCount) {
+        if (contact.scene === 'direct' || contact.scene === 'guild') {
+            return this.sendGuildMsg(contact, elements, retryCount);
+        }
+        else if (contact.scene === 'group' || contact.scene === 'friend') {
+            return this.sendQQMsg(contact, elements, retryCount);
+        }
+        throw new Error('不支持的消息类型');
+    }
+    /**
+     * 处理文本 将文本中的链接转为二维码
+     * @param text 文本
+     * @returns 处理后的文本和二维码 二维码为不带`base64://`的字符串
+     */
+    async hendleText(text) {
+        const urls = handleUrl(text);
+        if (!urls.length)
+            return { text, qr: null };
+        urls.forEach((url) => {
+            text = text.replace(new RegExp(url, 'g'), '[请扫码查看]');
+        });
+        const list = await qrs(urls);
+        if (list.length === 1)
+            return { text, qr: list[0] };
+        const result = await common.mergeImage(list, 3);
+        return { text, qr: result.base64 };
+    }
+    /**
+     * 发送QQ私聊、群聊消息
+     * @param contact 联系人
+     * @param elements 消息元素
+     * @param retryCount 重试次数
+     */
+    async sendQQMsg(contact, elements, retryCount) {
+        const list = this.initList('qq');
+        /** 上传富媒体的目标 */
+        const target = contact.scene === 'friend' ? 'user' : 'group';
+        for (const v of elements) {
+            if (v.type === 'text') {
+                const { text, buttons } = textToButton(v.text, contact.scene === 'friend');
+                list.content.push(text);
+                if (buttons)
+                    list.button.push(...buttons);
+                continue;
+            }
+            if (v.type === 'at') {
+                if (contact.scene === 'friend')
+                    continue;
+                list.content.push(v.targetId === 'all' ? '<qqbot-at-everyone />' : `<qqbot-at-user id="${v.targetId}" />`);
+            }
+            if (v.type === 'image') {
+                list.image.push(v.file);
+                continue;
+            }
+            if (v.type === 'pasmsg') {
+                if (v.source === 'event')
+                    list.pasmsg.type = 'event';
+                list.pasmsg.msg_id = v.id;
+                continue;
+            }
+            if (v.type === 'keyboard') {
+                list.keyboard.push(v);
+                continue;
+            }
+            if (v.type === 'button') {
+                list.button.push(v);
+                continue;
+            }
+            if (v.type === 'markdown') {
+                list.markdown.push(v);
+                continue;
+            }
+            if (v.type === 'markdownTpl') {
+                list.markdownTpl.push(v);
+                continue;
+            }
+            if (v.type === 'video' || v.type === 'record') {
+                let url;
+                if (v.file.startsWith('http')) {
+                    url = v.file;
+                }
+                else {
+                    const data = await fileToUrl(v.type, v.file, `${v.type}.${v.type === 'record' ? 'mp3' : 'mp4'}`);
+                    url = data.url;
+                }
+                const res = await this.super.uploadMedia(target, contact.peer, v.type, url, false);
+                list.list.push(this.super.QQdMsgOptions('media', res.file_info));
+                continue;
+            }
+            this.logger('debug', `[QQBot][${v.type}] 不支持发送的消息类型`);
+        }
+        /** 处理被动消息 */
+        const pasmsg = (() => {
+            if (!list.pasmsg.msg_id)
+                return () => '';
+            list.pasmsg.msg_seq++;
+            if (list.pasmsg.type === 'msg') {
+                return (item) => {
+                    item.msg_seq = list.pasmsg.msg_seq;
+                    item.msg_id = list.pasmsg.msg_id;
+                };
+            }
+            return (item) => {
+                item.msg_seq = list.pasmsg.msg_seq;
+                item.event_id = list.pasmsg.msg_id;
+            };
+        })();
+        /** 发送消息 */
+        const send = (() => {
+            if (contact.scene === 'friend') {
+                return (peer, item) => this.super.sendFriendMsg(peer, item);
+            }
+            return (peer, item) => this.super.sendGroupMsg(peer, item);
+        })();
+        return this.markdown('qq', this, list, contact, pasmsg, send);
+    }
+    /**
+     * 发送频道消息
+     * @param contact 联系人
+     * @param elements 消息元素
+     * @param retryCount 重试次数
+     */
+    async sendGuildMsg(contact, elements, retryCount) {
+        const list = this.initList('guild');
+        for (const v of elements) {
+            if (v.type === 'text') {
+                const { text, buttons } = textToButton(v.text, contact.scene === 'direct');
+                list.content.push(text);
+                if (buttons)
+                    list.button.push(...buttons);
+                continue;
+            }
+            if (v.type === 'image') {
+                list.image.push(v.file);
+                continue;
+            }
+            if (v.type === 'at') {
+                if (contact.scene === 'guild') {
+                    list.content.push(v.targetId === 'all' ? '<qqbot-at-everyone />' : `<qqbot-at-user id="${v.targetId}" />`);
+                }
+                continue;
+            }
+            if (v.type === 'pasmsg') {
+                if (v.source === 'event')
+                    list.pasmsg.type = 'event';
+                list.pasmsg.msg_id = v.id;
+                continue;
+            }
+            if (v.type === 'reply') {
+                list.reply.message_id = v.messageId;
+                continue;
+            }
+            if (v.type === 'face') {
+                list.content.push(`<emoji:${v.id}>`);
+                continue;
+            }
+            if (v.type === 'keyboard') {
+                list.keyboard.push(v);
+                continue;
+            }
+            if (v.type === 'button') {
+                list.button.push(v);
+                continue;
+            }
+            if (v.type === 'markdown') {
+                list.markdown.push(v);
+                continue;
+            }
+            if (v.type === 'markdownTpl') {
+                list.markdownTpl.push(v);
+                continue;
+            }
+            this.logger('debug', `[QQBot][${v.type}] 不支持发送的消息类型`);
+        }
+        /** 发送消息 */
+        const send = (() => {
+            if (contact.scene === 'guild') {
+                return (peer, subPeer, item) => this.super.sendChannelMsg(subPeer, item);
+            }
+            return (peer, subPeer, item) => this.super.sendDmsMsg(peer, item);
+        })();
+        /** 处理被动消息 */
+        const pasmsg = (() => {
+            if (!list.pasmsg.msg_id)
+                return () => '';
+            if (list.pasmsg.type === 'msg') {
+                return (item) => {
+                    if (item instanceof FormData) {
+                        return item.append('msg_id', list.pasmsg.msg_id);
+                    }
+                    item.msg_id = list.pasmsg.msg_id;
+                };
+            }
+            return (item) => {
+                if (item instanceof FormData) {
+                    return item.append('event_id', list.pasmsg.msg_id);
+                }
+                item.event_id = list.pasmsg.msg_id;
+            };
+        })();
+        return this.markdown('guild', this, list, contact, pasmsg, send);
+    }
+}

package/lib/core/adapter/normal.d.ts

@@ -0,0 +1,30 @@
+import { AdapterQQBot } from '@/core/adapter/adapter';
+import type { Contact, ElementTypes, Message, SendMsgResults } from 'node-karin';
+/** 正常发送消息 */
+export declare class AdapterQQBotNormal extends AdapterQQBot {
+    srcReply(e: Message, elements: ElementTypes[]): Promise<SendMsgResults>;
+    sendMsg(contact: Contact, elements: Array<ElementTypes>, retryCount?: number): Promise<SendMsgResults>;
+    /**
+     * 处理文本 将文本中的链接转为二维码
+     * @param text 文本
+     * @returns 处理后的文本和二维码 二维码为不带`base64://`的字符串
+     */
+    hendleText(text: string): Promise<{
+        text: string;
+        qr: string | null;
+    }>;
+    /**
+     * 发送QQ私聊、群聊消息
+     * @param contact 联系人
+     * @param elements 消息元素
+     * @param retryCount 重试次数
+     */
+    sendQQMsg(contact: Contact<'friend'> | Contact<'group'>, elements: Array<ElementTypes>, retryCount?: number): Promise<SendMsgResults>;
+    /**
+     * 发送频道消息
+     * @param contact 联系人
+     * @param elements 消息元素
+     * @param retryCount 重试次数
+     */
+    sendGuildMsg(contact: Contact<'guild' | 'direct'>, elements: Array<ElementTypes>, retryCount?: number): Promise<SendMsgResults>;
+}

package/lib/core/adapter/normal.js

@@ -0,0 +1,263 @@
+import FormData from 'form-data';
+import { handleUrl, qrs } from '@/utils/common';
+import { common, fileToUrl, } from 'node-karin';
+import { AdapterQQBot } from '@/core/adapter/adapter';
+/** 正常发送消息 */
+export class AdapterQQBotNormal extends AdapterQQBot {
+    async srcReply(e, elements) {
+        return this.sendMsg(e.contact, elements);
+    }
+    async sendMsg(contact, elements, retryCount) {
+        if (contact.scene === 'direct' || contact.scene === 'guild') {
+            return this.sendGuildMsg(contact, elements, retryCount);
+        }
+        else if (contact.scene === 'group' || contact.scene === 'friend') {
+            return this.sendQQMsg(contact, elements, retryCount);
+        }
+        throw new Error('不支持的消息类型');
+    }
+    /**
+     * 处理文本 将文本中的链接转为二维码
+     * @param text 文本
+     * @returns 处理后的文本和二维码 二维码为不带`base64://`的字符串
+     */
+    async hendleText(text) {
+        const urls = handleUrl(text);
+        if (!urls.length)
+            return { text, qr: null };
+        urls.forEach((url) => {
+            text = text.replace(new RegExp(url, 'g'), '[请扫码查看]');
+        });
+        const list = await qrs(urls);
+        if (list.length === 1)
+            return { text, qr: list[0] };
+        const result = await common.mergeImage(list, 3);
+        return { text, qr: result.base64 };
+    }
+    /**
+     * 发送QQ私聊、群聊消息
+     * @param contact 联系人
+     * @param elements 消息元素
+     * @param retryCount 重试次数
+     */
+    async sendQQMsg(contact, elements, retryCount) {
+        const list = this.initList('qq');
+        /** 上传富媒体的目标 */
+        const target = contact.scene === 'friend' ? 'user' : 'group';
+        for (const v of elements) {
+            if (v.type === 'text') {
+                const { text, qr } = await this.hendleText(v.text);
+                list.content.push(text);
+                if (qr)
+                    list.image.push(qr);
+                continue;
+            }
+            if (v.type === 'image') {
+                list.image.push(v.file);
+                continue;
+            }
+            if (v.type === 'pasmsg') {
+                if (v.source === 'event')
+                    list.pasmsg.type = 'event';
+                list.pasmsg.msg_id = v.id;
+                continue;
+            }
+            if (v.type === 'keyboard') {
+                list.keyboard.push(v);
+                continue;
+            }
+            if (v.type === 'button') {
+                list.button.push(v);
+                continue;
+            }
+            if (v.type === 'markdown') {
+                list.markdown.push(v);
+                continue;
+            }
+            if (v.type === 'markdownTpl') {
+                list.markdownTpl.push(v);
+                continue;
+            }
+            if (v.type === 'video' || v.type === 'record') {
+                let url;
+                if (v.file.startsWith('http')) {
+                    url = v.file;
+                }
+                else {
+                    const data = await fileToUrl(v.type, v.file, `${v.type}.${v.type === 'record' ? 'mp3' : 'mp4'}`);
+                    url = data.url;
+                }
+                const res = await this.super.uploadMedia(target, contact.peer, v.type, url, false);
+                list.list.push(this.super.QQdMsgOptions('media', res.file_info));
+                continue;
+            }
+            this.logger('debug', `[QQBot][${v.type}] 不支持发送的消息类型`);
+        }
+        if (list.content.length) {
+            list.list.unshift(this.super.QQdMsgOptions('text', list.content.join('')));
+        }
+        for (const url of list.image) {
+            const base64 = await common.base64(url);
+            const result = await this.super.uploadMedia(target, contact.peer, 'image', base64, false);
+            list.list.push(this.super.QQdMsgOptions('media', result.file_info));
+        }
+        /** 处理Markdown、按钮 */
+        list.markdownToButton('qq', list);
+        /** 返回值 */
+        const rawData = this.initSendMsgResults();
+        /** 处理被动消息 */
+        const pasmsg = (() => {
+            if (!list.pasmsg.msg_id)
+                return () => '';
+            list.pasmsg.msg_seq++;
+            if (list.pasmsg.type === 'msg') {
+                return (item) => {
+                    item.msg_seq = list.pasmsg.msg_seq;
+                    item.msg_id = list.pasmsg.msg_id;
+                };
+            }
+            return (item) => {
+                item.msg_seq = list.pasmsg.msg_seq;
+                item.event_id = list.pasmsg.msg_id;
+            };
+        })();
+        /** 发送消息 */
+        const send = (() => {
+            if (contact.scene === 'friend') {
+                return (peer, item) => this.super.sendFriendMsg(peer, item);
+            }
+            return (peer, item) => this.super.sendGroupMsg(peer, item);
+        })();
+        if (!list.list.length) {
+            list.list.push(this.super.QQdMsgOptions('text', '不支持发送的消息类型'));
+        }
+        for (const item of list.list) {
+            pasmsg(item);
+            const res = await send(contact.peer, item);
+            rawData.rawData.push(res);
+        }
+        return this.handleResponse(rawData);
+    }
+    /**
+     * 发送频道消息
+     * @param contact 联系人
+     * @param elements 消息元素
+     * @param retryCount 重试次数
+     */
+    async sendGuildMsg(contact, elements, retryCount) {
+        const list = this.initList('guild');
+        for (const v of elements) {
+            if (v.type === 'text') {
+                const { text, qr } = await this.hendleText(v.text);
+                list.content.push(text);
+                if (qr)
+                    list.image.push(qr);
+                continue;
+            }
+            if (v.type === 'image') {
+                v.file.startsWith('http') ? list.imageUrls.push(v.file) : list.imageFiles.push(v.file);
+                continue;
+            }
+            if (v.type === 'at') {
+                if (contact.scene === 'guild')
+                    list.content.push(v.targetId === 'all' ? '@everyone' : `<@${v.targetId}>`);
+                continue;
+            }
+            if (v.type === 'pasmsg') {
+                if (v.source === 'event')
+                    list.pasmsg.type = 'event';
+                list.pasmsg.msg_id = v.id;
+                continue;
+            }
+            if (v.type === 'reply') {
+                list.reply.message_id = v.messageId;
+                continue;
+            }
+            if (v.type === 'face') {
+                list.content.push(`<emoji:${v.id}>`);
+                continue;
+            }
+            if (v.type === 'keyboard') {
+                list.keyboard.push(v);
+                continue;
+            }
+            if (v.type === 'button') {
+                list.button.push(v);
+                continue;
+            }
+            if (v.type === 'markdown') {
+                list.markdown.push(v);
+                continue;
+            }
+            if (v.type === 'markdownTpl') {
+                list.markdownTpl.push(v);
+                continue;
+            }
+            this.logger('debug', `[QQBot][${v.type}] 不支持发送的消息类型`);
+        }
+        /** 情况较为复杂... */
+        if (list.content.length) {
+            if (list.imageUrls.length) {
+                const url = list.imageUrls.shift();
+                list.list.unshift(this.super.GuildMsgOptions('text', list.content.join(''), url));
+            }
+            if (list.imageFiles.length) {
+                const buffer = await common.buffer(list.imageFiles.shift());
+                const formData = new FormData();
+                formData.append('content', list.content.join(''));
+                formData.append('file_image', buffer);
+                list.list.unshift(formData);
+            }
+            else {
+                list.list.unshift(this.super.GuildMsgOptions('text', list.content.join('')));
+            }
+        }
+        for (const url of list.imageUrls) {
+            list.list.push(this.super.GuildMsgOptions('image', url));
+        }
+        for (const file of list.imageFiles) {
+            const buffer = await common.buffer(file);
+            const formData = new FormData();
+            formData.append('file_image', buffer);
+            list.list.push(formData);
+        }
+        /** 处理Markdown、按钮 */
+        list.markdownToButton('guild', list);
+        const rawData = this.initSendMsgResults();
+        /** 发送消息 */
+        const send = (() => {
+            if (contact.scene === 'guild') {
+                return (peer, subPeer, item) => this.super.sendChannelMsg(subPeer, item);
+            }
+            return (peer, subPeer, item) => this.super.sendDmsMsg(peer, item);
+        })();
+        /** 处理被动消息 */
+        const pasmsg = (() => {
+            if (!list.pasmsg.msg_id)
+                return () => '';
+            if (list.pasmsg.type === 'msg') {
+                return (item) => {
+                    if (item instanceof FormData) {
+                        return item.append('msg_id', list.pasmsg.msg_id);
+                    }
+                    item.msg_id = list.pasmsg.msg_id;
+                };
+            }
+            return (item) => {
+                if (item instanceof FormData) {
+                    return item.append('event_id', list.pasmsg.msg_id);
+                }
+                item.event_id = list.pasmsg.msg_id;
+            };
+        })();
+        if (!list.list.length) {
+            list.list.push(this.super.GuildMsgOptions('text', '不支持发送的消息类型'));
+        }
+        for (const item of list.list) {
+            pasmsg(item);
+            const res = await send(contact.peer, contact.subPeer, item);
+            rawData.rawData.push(res);
+        }
+        return this.handleResponse(rawData);
+    }
+}

package/lib/core/api/index.d.ts

@@ -0,0 +1,167 @@
+import FormData from 'form-data';
+import type { createAxiosInstance } from '@/core/internal/axios';
+import type { Ark, DmsResponse, Embeds, GetMeResponse, Keyboard, Markdown, MediaType, Scene, SendGuildArkMessageRequest, SendGuildEmbedMessageRequest, SendGuildMarkdownMessageRequest, SendGuildMsg, SendGuildResponse, SendGuildTextMessageRequest, SendQQArkMessageRequest, SendQQMarkdownMessageRequest, SendQQMediaMessageRequest, SendQQMsg, SendQQMsgResponse, SendQQTextMessageRequest, UploadMediaResponse } from './types';
+export declare class QQBotApi {
+    /** axios 实例 */
+    axios: ReturnType<typeof createAxiosInstance>;
+    constructor(axios: ReturnType<typeof createAxiosInstance>);
+    /**
+     * 发送get请求
+     * @param path 请求路径
+     * @returns 请求结果
+     */
+    get<T>(path: string): Promise<T>;
+    /**
+     * 发送post请求
+     * @param path 请求路径
+     * @param options 请求数据
+     * @param headers 请求头
+     */
+    post<T>(path: string, options?: {}, headers?: Record<string, string>): Promise<T>;
+    /**
+     * 处理请求错误
+     * @param error 错误信息
+     */
+    handleError(path: string, options: any, error: any): void;
+    /**
+     * 发送单聊消息
+     * @param targetId 目标QQ用户的 openid
+     * @param options 消息参数
+     */
+    sendFriendMsg(targetId: string, options: SendQQMsg): Promise<SendQQMsgResponse>;
+    /**
+     * 发送群聊消息
+     * @param targetId 目标QQ群的 openid
+     * @param options 消息参数
+     */
+    sendGroupMsg(targetId: string, options: SendQQMsg): Promise<SendQQMsgResponse>;
+    /**
+     * 构建QQBot文本消息参数
+     * @param content 消息文本内容
+     */
+    QQdMsgOptions(type: 'text', content: string): SendQQTextMessageRequest;
+    /**
+     * 构建Markdown消息参数
+     * @param markdown Markdown文本内容
+     * @param keyboard 按钮
+     */
+    QQdMsgOptions(type: 'markdown', markdown: Markdown, keyboard?: Keyboard): SendQQMarkdownMessageRequest;
+    /**
+     * 构建Ark消息参数
+     * @param ark Ark参数
+     */
+    QQdMsgOptions(type: 'ark', ark: SendQQArkMessageRequest['ark']): SendQQArkMessageRequest;
+    /**
+     * 构建Media消息参数
+     * @param file 文件信息
+     */
+    QQdMsgOptions(type: 'media', file: string): SendQQMediaMessageRequest;
+    /**
+     * 构建频道文本、文本图片消息参数
+     * @param type 消息类型
+     * @param content 消息内容
+     * @param image 图片url
+     */
+    GuildMsgOptions(type: 'text', content: string, image?: string): SendGuildTextMessageRequest;
+    /**
+     * 构建图片消息参数
+     * @param type 消息类型
+     * @param image 图片url
+     */
+    GuildMsgOptions(type: 'image', image: string): SendGuildTextMessageRequest;
+    /**
+     * 构建Embed消息参数
+     * @param type 消息类型
+     * @param embed Embed参数
+     */
+    GuildMsgOptions(type: 'embed', embed: Embeds): SendGuildEmbedMessageRequest;
+    /**
+     * 构建Ark消息参数
+     * @param type 消息类型
+     * @param ark Ark参数
+     */
+    GuildMsgOptions(type: 'ark', ark: Ark): SendGuildArkMessageRequest;
+    /**
+     * 构建Markdown消息参数
+     * @param type 消息类型
+     * @param markdown Markdown文本
+     */
+    GuildMsgOptions(type: 'markdown', markdown: Markdown): SendGuildMarkdownMessageRequest;
+    /**
+     * 上传富媒体文件
+     * @param scene 上传场景
+     * @param targetId 目标id
+     * @param type 文件类型
+     * @param url 需要上传的文件的url
+     * @param srvSendMsg 是否发送消息
+     */
+    uploadMedia(scene: Scene, targetId: string, type: MediaType, url: string, srvSendMsg?: boolean): Promise<UploadMediaResponse>;
+    /**
+     * 上传富媒体文件
+     * @param scene 上传场景
+     * @param targetId 目标id
+     * @param type 文件类型
+     * @param base64 需要上传的文件的base64编码
+     * @param srvSendMsg 是否发送消息
+     */
+    uploadMedia(scene: Scene, targetId: string, type: MediaType, base64: string, srvSendMsg?: boolean): Promise<UploadMediaResponse>;
+    /**
+     * 单聊撤回消息
+     * @param type 场景类型
+     * @param targetId 目标QQ用户的openid
+     * @param messageId 消息id
+     */
+    recallMsg(type: 'user', targetId: string, messageId: string): Promise<boolean>;
+    /**
+     * 群聊撤回消息
+     * @param type 场景类型
+     * @param targetId 目标QQ群的openid
+     * @param messageId 消息id
+     */
+    recallMsg(type: 'group', targetId: string, messageId: string): Promise<boolean>;
+    /**
+     * 文字子频道撤回消息
+     * @param type 场景类型
+     * @param channelId 子频道的id
+     * @param messageId 消息id
+     * @param hidetip 是否隐藏提示小灰条，true 为隐藏，false 为显示。默认为false
+     */
+    recallMsg(type: 'channels', channelId: string, messageId: string, hidetip?: boolean): Promise<boolean>;
+    /**
+     * 频道私信撤回消息
+     * @param type 场景类型
+     * @param guildId 频道的id
+     * @param messageId 消息id
+     * @param hidetip 是否隐藏提示小灰条，true 为隐藏，false 为显示。默认为false
+     */
+    recallMsg(type: 'dms', guildId: string, messageId: string, hidetip?: boolean): Promise<boolean>;
+    /**
+     * 发送文字子频道消息
+     * @param targetId 目标子频道的id
+     * @param options 消息参数
+     */
+    sendChannelMsg(targetId: string, options: SendGuildMsg | FormData): Promise<SendGuildResponse>;
+    /**
+     * 直接发送频道消息
+     * @param guildID 频道的id
+     * @param options 消息参数
+     */
+    sendDmsMsg(guildID: string, options: SendGuildMsg | FormData): Promise<SendGuildResponse>;
+    /**
+     * 发送频道私信消息
+     * @param targetId 目标的id
+     * @param srcGuildId 源频道的id
+     * @param options 消息参数
+     */
+    sendDmsMsg(targetId: string, srcGuildId: string, options: SendGuildMsg | FormData): Promise<SendGuildResponse>;
+    /**
+     * 获取当前机器人详情
+     */
+    getMe(): Promise<GetMeResponse>;
+    /**
+     * 创建私信会话
+     * @param recipientID 接受者id
+     * @param srcGuildID 源频道id
+     */
+    dms(recipientID: string, srcGuildID: string): Promise<DmsResponse>;
+}