napcat-sdk 0.9.2 → 0.10.0

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 //#region src/logger.d.ts
-type LogLevel = "error" | "warn" | "info" | "debug" | "trace";
+type LogLevel = 'error' | 'warn' | 'info' | 'debug' | 'trace';
 type Logger = Record<LogLevel, (...args: unknown[]) => void>;
 declare const noop: () => void;
 declare const ABSTRACT_LOGGER: Logger;
@@ -24,7 +24,7 @@ interface NapcatOptions {
   /** NapCat 访问令牌 */
   token?: string;
   /** NapCat 服务器协议，默认为 ws */
-  protocol?: "ws" | "wss";
+  protocol?: 'ws' | 'wss';
   /** NapCat 服务器主机，默认为 localhost */
   host?: string;
   /** NapCat 服务器端口，默认为 3001 */
@@ -39,15 +39,15 @@ type ExtractByType<T, K$1> = T extends {
 } ? T : never;
 interface EventMap extends OneBotEventMap {
   /** WebSocket 连接已打开 */
-  "ws.open": void;
+  'ws.open': void;
   /** WebSocket 连接已关闭 */
-  "ws.close": void;
+  'ws.close': void;
   /** WebSocket 连接发生错误 */
-  "ws.error": Event;
+  'ws.error': Event;
   /** 收到 WebSocket 消息 */
-  "ws.message": any;
+  'ws.message': any;
   /** NapCat 连接已建立 */
-  "napcat.connected": {
+  'napcat.connected': {
     user_id: number;
     nickname: string;
     app_name: string;
@@ -57,15 +57,15 @@ interface EventMap extends OneBotEventMap {
   };
 }
 /**
-* 媒体消息的通用属性
-*/
+ * 媒体消息的通用属性
+ */
 interface MediaProps {
   /** 媒体文件的 URL 地址 */
   url: string;
   /** 媒体文件的本地路径 */
   path: string;
   /** 媒体文件名或特殊标识 */
-  file: (string & {}) | "marketface";
+  file: (string & {}) | 'marketface';
   /** 媒体文件 ID */
   file_id: string;
   /** 媒体文件大小（字节） */
@@ -75,31 +75,31 @@ interface MediaProps {
 }
 /** 接收的纯文本消息段 */
 interface RecvTextElement {
-  type: "text";
+  type: 'text';
   /** 文本内容 */
   text: string;
 }
 /** 接收的 @ 消息段 */
 interface RecvAtElement {
-  type: "at";
+  type: 'at';
   /** 被 @ 的 QQ 号，'all' 表示 @全体成员 */
-  qq: "all" | (string & {});
+  qq: 'all' | (string & {});
 }
 /** 接收的回复消息段 */
 interface RecvReplyElement {
-  type: "reply";
+  type: 'reply';
   /** 被回复的消息 ID */
   id: string;
 }
 /** 接收的 QQ 表情消息段 */
 interface RecvFaceElement {
-  type: "face";
+  type: 'face';
   /** QQ 表情 ID */
   id: number;
 }
 /** 接收的图片消息段 */
 interface RecvImageElement extends MediaProps {
-  type: "image";
+  type: 'image';
   /** 图片摘要/描述 */
   summary?: string;
   /** 图片子类型 */
@@ -107,43 +107,43 @@ interface RecvImageElement extends MediaProps {
 }
 /** 接收的语音消息段 */
 interface RecvRecordElement extends MediaProps {
-  type: "record";
+  type: 'record';
 }
 /** 接收的视频消息段 */
 interface RecvVideoElement extends MediaProps {
-  type: "video";
+  type: 'video';
 }
 /** 接收的猜拳消息段 */
 interface RecvRpsElement {
-  type: "rps";
+  type: 'rps';
   /** 猜拳结果：1-石头, 2-剪刀, 3-布 */
   result: string;
 }
 /** 接收的掷骰子消息段 */
 interface RecvDiceElement {
-  type: "dice";
+  type: 'dice';
   /** 骰子点数：1-6 */
   result: string;
 }
 /** 接收的窗口抖动消息段（戳一戳） */
 interface RecvShakeElement {
-  type: "shake";
+  type: 'shake';
 }
 /** 接收的戳一戳消息段 */
 interface RecvPokeElement {
-  type: "poke";
+  type: 'poke';
 }
 /** 接收的分享链接消息段 */
 interface RecvShareElement {
-  type: "share";
+  type: 'share';
 }
 /** 接收的位置消息段 */
 interface RecvLocationElement {
-  type: "location";
+  type: 'location';
 }
 /** 接收的合并转发消息段 */
 interface RecvForwardElement {
-  type: "forward";
+  type: 'forward';
   /** 合并转发消息 ID */
   id: string;
   /** 合并转发消息内容 */
@@ -151,48 +151,48 @@ interface RecvForwardElement {
 }
 /** 接收的 JSON 消息段 */
 interface RecvJsonElement {
-  type: "json";
+  type: 'json';
   /** JSON 数据字符串 */
   data: string;
 }
 /** 接收的文件消息段 */
 interface RecvFileElement extends MediaProps {
-  type: "file";
+  type: 'file';
 }
 /** 接收的 Markdown 消息段 */
 interface RecvMarkdownElement {
-  type: "markdown";
+  type: 'markdown';
 }
 /** 接收的小程序消息段 */
 interface RecvLightAppElement {
-  type: "lightapp";
+  type: 'lightapp';
 }
 /**
-* 接收的消息段类型联合
-* @description 表示从 QQ 接收到的所有可能的消息段类型
-*/
+ * 接收的消息段类型联合
+ * @description 表示从 QQ 接收到的所有可能的消息段类型
+ */
 type RecvElement = RecvTextElement | RecvAtElement | RecvReplyElement | RecvFaceElement | RecvImageElement | RecvRecordElement | RecvVideoElement | RecvRpsElement | RecvDiceElement | RecvShakeElement | RecvPokeElement | RecvShareElement | RecvLocationElement | RecvForwardElement | RecvJsonElement | RecvFileElement | RecvMarkdownElement | RecvLightAppElement;
 /** 发送的纯文本消息段 */
 interface SendTextElement {
-  type: "text";
+  type: 'text';
   /** 文本内容 */
   text: string;
 }
 /** 发送的 @ 消息段 */
 interface SendAtElement {
-  type: "at";
+  type: 'at';
   /** 被 @ 的 QQ 号，'all' 表示 @全体成员 */
-  qq: "all" | (string & {}) | number;
+  qq: 'all' | (string & {}) | number;
 }
 /** 发送的回复消息段 */
 interface SendReplyElement {
-  type: "reply";
+  type: 'reply';
   /** 被回复的消息 ID */
   id: string;
 }
 /** 发送的商城表情消息段 */
 interface SendMfaceElement {
-  type: "mface";
+  type: 'mface';
   /** 表情 ID */
   id: number;
   /** 表情 key */
@@ -206,19 +206,19 @@ interface SendMfaceElement {
 }
 /** 发送的 QQ 表情消息段 */
 interface SendFaceElement {
-  type: "face";
+  type: 'face';
   /** QQ 表情 ID */
   id: number;
 }
 /** 发送的大表情消息段 */
 interface SendBfaceElement {
-  type: "bface";
+  type: 'bface';
   /** 大表情 ID */
   id: number;
 }
 /** 发送的图片消息段 */
 interface SendImageElement {
-  type: "image";
+  type: 'image';
   /** 图片文件，支持 file:// / http:// / base64:// 协议 */
   file: string;
   /** 图片文件名 */
@@ -230,7 +230,7 @@ interface SendImageElement {
 }
 /** 发送的视频消息段 */
 interface SendVideoElement {
-  type: "video";
+  type: 'video';
   /** 视频文件，支持 file:// / http:// / base64:// 协议 */
   file: string;
   /** 视频文件名 */
@@ -240,7 +240,7 @@ interface SendVideoElement {
 }
 /** 发送的语音消息段 */
 interface SendRecordElement {
-  type: "record";
+  type: 'record';
   /** 语音文件，支持 file:// / http:// / base64:// 协议 */
   file: string;
   /** 语音文件名 */
@@ -248,29 +248,29 @@ interface SendRecordElement {
 }
 /** 发送的推荐好友/群消息段 */
 interface SendContactElement {
-  type: "contact";
+  type: 'contact';
   /** 推荐类型：qq-好友, group-群 */
-  sub_type: "qq" | "group";
+  sub_type: 'qq' | 'group';
   /** 被推荐的 QQ 号或群号 */
   id: string;
 }
 /** 发送的戳一戳消息段 */
 interface SendPokeElement {
-  type: "poke";
+  type: 'poke';
 }
 /** 发送的音乐分享消息段 - 平台音乐 */
 interface SendPlatformMusicElement {
-  type: "music";
+  type: 'music';
   /** 音乐平台 */
-  platform: "qq" | "163" | "kugou" | "migu" | "kuwo";
+  platform: 'qq' | '163' | 'kugou' | 'migu' | 'kuwo';
   /** 音乐 ID */
   id: string;
 }
 /** 发送的音乐分享消息段 - 自定义音乐 */
 interface SendCustomMusicElement {
-  type: "music";
+  type: 'music';
   /** 自定义音乐标识 */
-  platform: "custom";
+  platform: 'custom';
   /** 跳转链接 URL */
   url: string;
   /** 音频链接 URL */
@@ -286,13 +286,13 @@ interface SendCustomMusicElement {
 type SendMusicElement = SendPlatformMusicElement | SendCustomMusicElement;
 /** 发送的合并转发消息段 */
 interface SendForwardElement {
-  type: "forward";
+  type: 'forward';
   /** 合并转发消息 ID */
   id: string;
 }
 /** 发送的合并转发节点 - 引用已有消息 */
 interface SendNodeRefElement {
-  type: "node";
+  type: 'node';
   /** 发送者 QQ 号（可选） */
   user_id?: string;
   /** 发送者昵称（可选） */
@@ -302,7 +302,7 @@ interface SendNodeRefElement {
 }
 /** 发送的合并转发节点 - 自定义内容 */
 interface SendNodeContentElement {
-  type: "node";
+  type: 'node';
   /** 发送者 QQ 号（可选） */
   user_id?: string;
   /** 发送者昵称（可选） */
@@ -314,13 +314,13 @@ interface SendNodeContentElement {
 type SendNodeElement = SendNodeRefElement | SendNodeContentElement;
 /** 发送的 JSON 消息段 */
 interface SendJsonElement {
-  type: "json";
+  type: 'json';
   /** JSON 数据字符串 */
   data: string;
 }
 /** 发送的文件消息段 */
 interface SendFileElement {
-  type: "file";
+  type: 'file';
   /** 文件，支持 file:// / http:// / base64:// 协议 */
   file: string;
   /** 文件名 */
@@ -328,56 +328,56 @@ interface SendFileElement {
 }
 /** 发送的 Markdown 消息段 */
 interface SendMarkdownElement {
-  type: "markdown";
+  type: 'markdown';
 }
 /** 发送的小程序消息段 */
 interface SendLightAppElement {
-  type: "lightapp";
+  type: 'lightapp';
 }
 /**
-* 发送的消息段类型联合
-* @description 表示可以发送给 QQ 的所有可能的消息段类型
-*/
+ * 发送的消息段类型联合
+ * @description 表示可以发送给 QQ 的所有可能的消息段类型
+ */
 type SendElement = SendTextElement | SendAtElement | SendReplyElement | SendMfaceElement | SendFaceElement | SendBfaceElement | SendImageElement | SendVideoElement | SendRecordElement | SendContactElement | SendPokeElement | SendMusicElement | SendForwardElement | SendNodeElement | SendJsonElement | SendFileElement | SendMarkdownElement | SendLightAppElement;
 /**
-* 将消息段类型包装为 OneBot 标准格式
-* @description 将 { type, ...data } 转换为 { type, data: { ...data } } 格式
-*/
+ * 将消息段类型包装为 OneBot 标准格式
+ * @description 将 { type, ...data } 转换为 { type, data: { ...data } } 格式
+ */
 type WrapData<T extends {
   type: string;
 }> = {
-  type: T["type"];
-  data: Omit<T, "type">;
+  type: T['type'];
+  data: Omit<T, 'type'>;
 };
 /**
-* 将 OneBot 标准格式展开为扁平格式
-* @description 将 { type, data: { ...data } } 转换为 { type, ...data } 格式
-*/
+ * 将 OneBot 标准格式展开为扁平格式
+ * @description 将 { type, data: { ...data } } 转换为 { type, ...data } 格式
+ */
 type FlattenData<T extends {
   type: string;
 }> = T extends {
   data: infer U;
 } ? U & {
-  type: T["type"];
+  type: T['type'];
 } : never;
 /** 标准化后的发送消息段（OneBot 标准格式） */
 type NormalizedElementToSend = WrapData<SendElement>;
 /** 可发送的消息类型，可以是字符串或消息段 */
 type Sendable = string | SendElement;
 /** 上报事件类型 */
-type PostType = "meta_event" | "message" | "message_sent" | "notice" | "request";
+type PostType = 'meta_event' | 'message' | 'message_sent' | 'notice' | 'request';
 /** 元事件类型 */
-type MetaEventType = "heartbeat" | "lifecycle";
+type MetaEventType = 'heartbeat' | 'lifecycle';
 /** 消息类型 */
-type MessageType = "private" | "group";
+type MessageType = 'private' | 'group';
 /** 通知类型 */
-type NoticeType = "friend" | "group" | "client";
+type NoticeType = 'friend' | 'group' | 'client';
 /** 通知子类型 */
-type NoticeSubType = "increase" | "decrease" | "recall" | "poke" | "like" | "input" | "admin" | "ban" | "title" | "card" | "upload" | "reaction" | "essence";
+type NoticeSubType = 'increase' | 'decrease' | 'recall' | 'poke' | 'like' | 'input' | 'admin' | 'ban' | 'title' | 'card' | 'upload' | 'reaction' | 'essence';
 /**
-* 事件基础类型
-* @description 所有事件的基础结构，包含时间戳、机器人 QQ 号和事件类型
-*/
+ * 事件基础类型
+ * @description 所有事件的基础结构，包含时间戳、机器人 QQ 号和事件类型
+ */
 type EventBase<T extends PostType, U$1 extends object> = U$1 & {
   /** 事件发生的 Unix 时间戳 */
   time: number;
@@ -387,17 +387,17 @@ type EventBase<T extends PostType, U$1 extends object> = U$1 & {
   post_type: T;
 };
 /**
-* 元事件基础类型
-* @description 元事件表示 OneBot 实现本身的状态变化
-*/
-type MetaEventBase<T extends MetaEventType, U$1 extends object> = EventBase<"meta_event", U$1 & {
+ * 元事件基础类型
+ * @description 元事件表示 OneBot 实现本身的状态变化
+ */
+type MetaEventBase<T extends MetaEventType, U$1 extends object> = EventBase<'meta_event', U$1 & {
   meta_event_type: T;
 }>;
 /**
-* 心跳元事件
-* @description 定期发送的心跳事件，用于确认连接状态
-*/
-type HeartbeatMetaEvent = MetaEventBase<"heartbeat", {
+ * 心跳元事件
+ * @description 定期发送的心跳事件，用于确认连接状态
+ */
+type HeartbeatMetaEvent = MetaEventBase<'heartbeat', {
   /** 状态信息 */
   status: {
     /** 是否在线 */
@@ -409,12 +409,12 @@ type HeartbeatMetaEvent = MetaEventBase<"heartbeat", {
   interval: number;
 }>;
 /**
-* 生命周期元事件
-* @description OneBot 实现的生命周期事件
-*/
-type LifecycleMetaEvent = MetaEventBase<"lifecycle", {
+ * 生命周期元事件
+ * @description OneBot 实现的生命周期事件
+ */
+type LifecycleMetaEvent = MetaEventBase<'lifecycle', {
   /** 生命周期子类型 */
-  sub_type: "connect";
+  sub_type: 'connect';
 }>;
 /** 元事件联合类型 */
 type MetaEvent = HeartbeatMetaEvent | LifecycleMetaEvent;
@@ -431,9 +431,9 @@ type ReactionAction = (id: string) => Promise<void>;
 /** 撤回消息的函数类型 */
 type Recall = () => Promise<void>;
 /**
-* 群信息接口
-* @description 包含群的基本信息和常用操作方法
-*/
+ * 群信息接口
+ * @description 包含群的基本信息和常用操作方法
+ */
 interface Group {
   /** 群号 */
   group_id: number;
@@ -471,11 +471,11 @@ interface Group {
   /** 发送群消息 */
   sendMsg: SendMsg;
 }
-type GroupWithInfo = Group & Awaited<ReturnType<Group["getInfo"]>>;
+type GroupWithInfo = Group & Awaited<ReturnType<Group['getInfo']>>;
 /**
-* 好友信息接口
-* @description 包含好友的基本信息和常用操作方法
-*/
+ * 好友信息接口
+ * @description 包含好友的基本信息和常用操作方法
+ */
 interface Friend {
   /** 好友 QQ 号 */
   user_id: number;
@@ -573,12 +573,12 @@ interface Friend {
     login_days: number;
   }>;
 }
-type FriendWithInfo = Friend & Awaited<ReturnType<Friend["getInfo"]>>;
+type FriendWithInfo = Friend & Awaited<ReturnType<Friend['getInfo']>>;
 /**
-* 消息事件基础类型
-* @description 所有消息事件的基础结构
-*/
-type MessageEventBase<T extends MessageType, U$1 extends object> = EventBase<"message", U$1 & {
+ * 消息事件基础类型
+ * @description 所有消息事件的基础结构
+ */
+type MessageEventBase<T extends MessageType, U$1 extends object> = EventBase<'message', U$1 & {
   /** 消息 ID */
   message_id: number;
   /** 引用的消息 ID */
@@ -599,14 +599,14 @@ type MessageEventBase<T extends MessageType, U$1 extends object> = EventBase<"me
   reply: Reply;
 }>;
 /**
-* 私聊消息事件
-* @description 包含好友私聊、群临时会话等私聊消息
-*/
-type PrivateMessageEvent = MessageEventBase<"private", {
+ * 私聊消息事件
+ * @description 包含好友私聊、群临时会话等私聊消息
+ */
+type PrivateMessageEvent = MessageEventBase<'private', {
   /** 发送者 QQ 号 */
   user_id: number;
   /** 私聊子类型：friend-好友, group-群临时会话, group_self-群中自己发送, other-其他 */
-  sub_type: "friend" | "group" | "group_self" | "other";
+  sub_type: 'friend' | 'group' | 'group_self' | 'other';
   /** 接收者 QQ 号 */
   target_id: number;
   /** 好友信息对象 */
@@ -622,10 +622,10 @@ type PrivateMessageEvent = MessageEventBase<"private", {
   };
 }>;
 /**
-* 群消息事件
-* @description 群聊中的消息事件
-*/
-type GroupMessageEvent = MessageEventBase<"group", {
+ * 群消息事件
+ * @description 群聊中的消息事件
+ */
+type GroupMessageEvent = MessageEventBase<'group', {
   /** 群号 */
   group_id: number;
   /** 群名称 */
@@ -633,7 +633,7 @@ type GroupMessageEvent = MessageEventBase<"group", {
   /** 发送者 QQ 号 */
   user_id: number;
   /** 群消息子类型：normal-普通消息, notice-通知消息 */
-  sub_type: "normal" | "notice";
+  sub_type: 'normal' | 'notice';
   /** 撤回该消息 */
   recall: Recall;
   /** 添加消息表态 */
@@ -659,33 +659,33 @@ type GroupMessageEvent = MessageEventBase<"group", {
     /** 发送者群名片 */
     card: string;
     /** 发送者群角色：owner-群主, admin-管理员, member-普通成员 */
-    role: "owner" | "admin" | "member";
+    role: 'owner' | 'admin' | 'member';
   };
 }>;
 /** 消息事件联合类型 */
 type MessageEvent = PrivateMessageEvent | GroupMessageEvent;
 /**
-* 将消息事件转换为发送消息事件类型
-* @description 用于表示机器人自己发送的消息事件
-*/
-type ToMessageSent<T extends MessageEvent> = Omit<T, "post_type" | "group" | "friend" | "reply"> & {
-  post_type: "message_sent";
+ * 将消息事件转换为发送消息事件类型
+ * @description 用于表示机器人自己发送的消息事件
+ */
+type ToMessageSent<T extends MessageEvent> = Omit<T, 'post_type' | 'group' | 'friend' | 'reply'> & {
+  post_type: 'message_sent';
 };
 /**
-* 通知事件基础类型
-* @description 所有通知事件的基础结构
-*/
-type NoticeEventBase<T extends NoticeType, U$1 extends object> = EventBase<"notice", U$1 & {
+ * 通知事件基础类型
+ * @description 所有通知事件的基础结构
+ */
+type NoticeEventBase<T extends NoticeType, U$1 extends object> = EventBase<'notice', U$1 & {
   /** 通知类型 */
   notice_type: T;
   /** 原始通知类型 */
   original_notice_type: string;
 }>;
 /**
-* 群通知事件基础类型
-* @description 所有群相关通知事件的基础结构
-*/
-type GroupNoticeEventBase<T extends NoticeSubType, U$1 extends object> = NoticeEventBase<"group", U$1 & {
+ * 群通知事件基础类型
+ * @description 所有群相关通知事件的基础结构
+ */
+type GroupNoticeEventBase<T extends NoticeSubType, U$1 extends object> = NoticeEventBase<'group', U$1 & {
   /** 通知子类型 */
   sub_type: T;
   /** 群号 */
@@ -696,10 +696,10 @@ type GroupNoticeEventBase<T extends NoticeSubType, U$1 extends object> = NoticeE
   group: Group;
 }>;
 /**
-* 好友通知事件基础类型
-* @description 所有好友相关通知事件的基础结构
-*/
-type FriendNoticeEventBase<T extends NoticeSubType, U$1 extends object> = NoticeEventBase<"friend", U$1 & {
+ * 好友通知事件基础类型
+ * @description 所有好友相关通知事件的基础结构
+ */
+type FriendNoticeEventBase<T extends NoticeSubType, U$1 extends object> = NoticeEventBase<'friend', U$1 & {
   /** 通知子类型 */
   sub_type: T;
   /** 相关用户 QQ 号 */
@@ -708,16 +708,16 @@ type FriendNoticeEventBase<T extends NoticeSubType, U$1 extends object> = Notice
   friend: Friend;
 }>;
 /** 好友增加通知事件 */
-type FriendIncreaseNoticeEvent = FriendNoticeEventBase<"increase", {}>;
+type FriendIncreaseNoticeEvent = FriendNoticeEventBase<'increase', {}>;
 /** 好友减少通知事件 */
-type FriendDecreaseNoticeEvent = FriendNoticeEventBase<"decrease", {}>;
+type FriendDecreaseNoticeEvent = FriendNoticeEventBase<'decrease', {}>;
 /** 好友消息撤回通知事件 */
-type FriendRecallNoticeEvent = FriendNoticeEventBase<"recall", {
+type FriendRecallNoticeEvent = FriendNoticeEventBase<'recall', {
   /** 被撤回的消息 ID */
   message_id: number;
 }>;
 /** 好友戳一戳通知事件 */
-type FriendPokeNoticeEvent = FriendNoticeEventBase<"poke", {
+type FriendPokeNoticeEvent = FriendNoticeEventBase<'poke', {
   /** 被戳者 QQ 号 */
   target_id: number;
   /** 发送者 QQ 号 */
@@ -726,7 +726,7 @@ type FriendPokeNoticeEvent = FriendNoticeEventBase<"poke", {
   raw_info: any[];
 }>;
 /** 好友点赞通知事件 */
-type FriendLikeNoticeEvent = FriendNoticeEventBase<"like", {
+type FriendLikeNoticeEvent = FriendNoticeEventBase<'like', {
   /** 操作者 QQ 号 */
   operator_id: number;
   /** 操作者昵称 */
@@ -735,7 +735,7 @@ type FriendLikeNoticeEvent = FriendNoticeEventBase<"like", {
   times: number;
 }>;
 /** 好友输入状态通知事件 */
-type FriendInputNoticeEvent = FriendNoticeEventBase<"input", {
+type FriendInputNoticeEvent = FriendNoticeEventBase<'input', {
   /** 状态文本 */
   status_text: string;
   /** 事件类型 */
@@ -744,54 +744,54 @@ type FriendInputNoticeEvent = FriendNoticeEventBase<"input", {
 /** 好友通知事件联合类型 */
 type FriendNoticeEvent = FriendIncreaseNoticeEvent | FriendDecreaseNoticeEvent | FriendRecallNoticeEvent | FriendPokeNoticeEvent | FriendLikeNoticeEvent | FriendInputNoticeEvent;
 /** 群成员增加通知事件 */
-type GroupIncreaseNoticeEvent = GroupNoticeEventBase<"increase", {
+type GroupIncreaseNoticeEvent = GroupNoticeEventBase<'increase', {
   /** 操作者 QQ 号（如邀请者） */
   operator_id: number;
   /** 加入类型：invite-邀请, add-主动加群, approve-管理员审批 */
-  actions_type: "invite" | "add" | "approve";
+  actions_type: 'invite' | 'add' | 'approve';
 }>;
 /** 群成员减少通知事件 */
-type GroupDecreaseNoticeEvent = GroupNoticeEventBase<"decrease", {
+type GroupDecreaseNoticeEvent = GroupNoticeEventBase<'decrease', {
   /** 操作者 QQ 号 */
   operator_id: number;
   /** 离开类型：kick-被踢, leave-主动退出 */
-  actions_type: "kick" | "leave";
+  actions_type: 'kick' | 'leave';
 }>;
 /** 群管理员变动通知事件 */
-type GroupAdminNoticeEvent = GroupNoticeEventBase<"admin", {
+type GroupAdminNoticeEvent = GroupNoticeEventBase<'admin', {
   /** 操作类型：set-设置管理员, unset-取消管理员 */
-  action_type: "set" | "unset";
+  action_type: 'set' | 'unset';
 }>;
 /** 群禁言通知事件 */
-type GroupBanNoticeEvent = GroupNoticeEventBase<"ban", {
+type GroupBanNoticeEvent = GroupNoticeEventBase<'ban', {
   /** 禁言时长（秒），0 表示解除禁言 */
   duration: number;
   /** 操作类型：ban-禁言, lift_ban-解除禁言 */
-  action_type: "ban" | "lift_ban";
+  action_type: 'ban' | 'lift_ban';
   /** 操作者 QQ 号 */
   operator_id: number;
 }>;
 /** 群名片变动通知事件 */
-type GroupCardNoticeEvent = GroupNoticeEventBase<"card", {
+type GroupCardNoticeEvent = GroupNoticeEventBase<'card', {
   /** 新名片 */
   card_new: string;
   /** 旧名片 */
   card_old: string;
 }>;
 /** 群戳一戳通知事件 */
-type GroupPokeNoticeEvent = GroupNoticeEventBase<"poke", {
+type GroupPokeNoticeEvent = GroupNoticeEventBase<'poke', {
   /** 被戳者 QQ 号 */
   target_id: number;
   /** 原始信息 */
   raw_info: any[];
 }>;
 /** 群头衔变动通知事件 */
-type GroupTitleNoticeEvent = GroupNoticeEventBase<"title", {
+type GroupTitleNoticeEvent = GroupNoticeEventBase<'title', {
   /** 新头衔 */
   title: string;
 }>;
 /** 群文件上传通知事件 */
-type GroupUploadNoticeEvent = GroupNoticeEventBase<"upload", {
+type GroupUploadNoticeEvent = GroupNoticeEventBase<'upload', {
   /** 上传的文件信息 */
   file: {
     /** 文件 ID */
@@ -805,7 +805,7 @@ type GroupUploadNoticeEvent = GroupNoticeEventBase<"upload", {
   };
 }>;
 /** 群消息表态变动通知事件 */
-type GroupReactionNoticeEvent = GroupNoticeEventBase<"reaction", {
+type GroupReactionNoticeEvent = GroupNoticeEventBase<'reaction', {
   /** 相关消息 ID */
   message_id: number;
   /** 表态列表 */
@@ -819,7 +819,7 @@ type GroupReactionNoticeEvent = GroupNoticeEventBase<"reaction", {
   is_add: boolean;
 }>;
 /** 群精华消息变动通知事件 */
-type GroupEssenceNoticeEvent = GroupNoticeEventBase<"essence", {
+type GroupEssenceNoticeEvent = GroupNoticeEventBase<'essence', {
   /** 原消息发送者 QQ 号 */
   sender_id: number;
   /** 相关消息 ID */
@@ -827,10 +827,10 @@ type GroupEssenceNoticeEvent = GroupNoticeEventBase<"essence", {
   /** 操作者 QQ 号 */
   operator_id: number;
   /** 操作类型：add-添加精华, remove-移除精华 */
-  action_type: "add" | "remove";
+  action_type: 'add' | 'remove';
 }>;
 /** 群消息撤回通知事件 */
-type GroupRecallNoticeEvent = GroupNoticeEventBase<"recall", {
+type GroupRecallNoticeEvent = GroupNoticeEventBase<'recall', {
   /** 被撤回的消息 ID */
   message_id: number;
   /** 操作者 QQ 号 */
@@ -841,10 +841,10 @@ type GroupNoticeEvent = GroupIncreaseNoticeEvent | GroupDecreaseNoticeEvent | Gr
 /** 通知事件联合类型 */
 type NoticeEvent = GroupNoticeEvent | FriendNoticeEvent;
 /**
-* 请求事件基础类型
-* @description 所有请求事件的基础结构
-*/
-type RequestEventBase<T extends string, U$1 extends object> = EventBase<"request", U$1 & {
+ * 请求事件基础类型
+ * @description 所有请求事件的基础结构
+ */
+type RequestEventBase<T extends string, U$1 extends object> = EventBase<'request', U$1 & {
   /** 请求类型 */
   request_type: T;
   /** 请求者 QQ 号 */
@@ -859,117 +859,117 @@ type RequestEventBase<T extends string, U$1 extends object> = EventBase<"request
   reject: (reason?: string) => Promise<void>;
 }>;
 /** 好友添加请求事件 */
-type FriendRequestEvent = RequestEventBase<"friend", {}>;
+type FriendRequestEvent = RequestEventBase<'friend', {}>;
 /** 加群请求事件（他人申请加入群） */
-type GroupAddRequestEvent = RequestEventBase<"group", {
+type GroupAddRequestEvent = RequestEventBase<'group', {
   /** 群号 */
   group_id: number;
   /** 请求子类型：add-主动加群 */
-  sub_type: "add";
+  sub_type: 'add';
 }>;
 /** 邀请入群请求事件（他人邀请机器人入群） */
-type GroupInviteRequestEvent = RequestEventBase<"group", {
+type GroupInviteRequestEvent = RequestEventBase<'group', {
   /** 群号 */
   group_id: number;
   /** 请求子类型：invite-被邀请 */
-  sub_type: "invite";
+  sub_type: 'invite';
 }>;
 /** 群请求事件联合类型 */
 type GroupRequestEvent = GroupAddRequestEvent | GroupInviteRequestEvent;
 /** 请求事件联合类型 */
 type RequestEvent = FriendRequestEvent | GroupRequestEvent;
 /**
-* OneBot 事件映射表
-* @description 定义了所有事件名称与对应事件类型的映射关系
-*/
+ * OneBot 事件映射表
+ * @description 定义了所有事件名称与对应事件类型的映射关系
+ */
 interface OneBotEventMap {
   /** 元事件，通常与 OneBot 服务端状态相关 */
   meta_event: MetaEvent;
   /** 元事件 - 心跳事件，确认服务端在线状态 */
-  "meta_event.heartbeat": HeartbeatMetaEvent;
+  'meta_event.heartbeat': HeartbeatMetaEvent;
   /** 元事件 - 生命周期，服务端状态变化 */
-  "meta_event.lifecycle": LifecycleMetaEvent;
+  'meta_event.lifecycle': LifecycleMetaEvent;
   /** 元事件 - 生命周期 - 连接成功 */
-  "meta_event.lifecycle.connect": LifecycleMetaEvent;
+  'meta_event.lifecycle.connect': LifecycleMetaEvent;
   /** 消息事件，包含私聊和群消息 */
   message: MessageEvent;
   /** 消息事件 - 私聊消息 */
-  "message.private": PrivateMessageEvent;
+  'message.private': PrivateMessageEvent;
   /** 消息事件 - 私聊消息 - 好友私聊 */
-  "message.private.friend": PrivateMessageEvent;
+  'message.private.friend': PrivateMessageEvent;
   /** 消息事件 - 私聊消息 - 群临时会话 */
-  "message.private.group": PrivateMessageEvent;
+  'message.private.group': PrivateMessageEvent;
   /** 消息事件 - 群消息 */
-  "message.group": GroupMessageEvent;
+  'message.group': GroupMessageEvent;
   /** 消息事件 - 群消息 - 普通消息 */
-  "message.group.normal": GroupMessageEvent;
+  'message.group.normal': GroupMessageEvent;
   message_sent: ToMessageSent<MessageEvent>;
-  "message_sent.private": ToMessageSent<PrivateMessageEvent>;
-  "message_sent.private.friend": ToMessageSent<PrivateMessageEvent>;
-  "message_sent.private.group": ToMessageSent<PrivateMessageEvent>;
-  "message_sent.group": ToMessageSent<GroupMessageEvent>;
-  "message_sent.group.normal": ToMessageSent<GroupMessageEvent>;
+  'message_sent.private': ToMessageSent<PrivateMessageEvent>;
+  'message_sent.private.friend': ToMessageSent<PrivateMessageEvent>;
+  'message_sent.private.group': ToMessageSent<PrivateMessageEvent>;
+  'message_sent.group': ToMessageSent<GroupMessageEvent>;
+  'message_sent.group.normal': ToMessageSent<GroupMessageEvent>;
   /** 请求事件 */
   request: RequestEvent;
   /** 请求事件 - 好友请求 */
-  "request.friend": FriendRequestEvent;
+  'request.friend': FriendRequestEvent;
   /** 请求事件 - 群请求 */
-  "request.group": GroupRequestEvent;
+  'request.group': GroupRequestEvent;
   /** 请求事件 - 他人加群请求，当机器人是群主或管理员时收到 */
-  "request.group.add": GroupAddRequestEvent;
+  'request.group.add': GroupAddRequestEvent;
   /** 请求事件 - 邀请加群请求，他人邀请机器人加入群时收到 */
-  "request.group.invite": GroupInviteRequestEvent;
+  'request.group.invite': GroupInviteRequestEvent;
   /** 通知事件 */
   notice: NoticeEvent;
   /** 通知事件 - 好友相关通知 */
-  "notice.friend": FriendNoticeEvent;
+  'notice.friend': FriendNoticeEvent;
   /** 通知事件 - 好友增加 */
-  "notice.friend.increase": FriendIncreaseNoticeEvent;
+  'notice.friend.increase': FriendIncreaseNoticeEvent;
   /** 通知事件 - 好友减少 */
-  "notice.friend.decrease": FriendDecreaseNoticeEvent;
+  'notice.friend.decrease': FriendDecreaseNoticeEvent;
   /** 通知事件 - 好友备注变更 */
-  "notice.friend.recall": FriendRecallNoticeEvent;
+  'notice.friend.recall': FriendRecallNoticeEvent;
   /** 通知事件 - 好友戳一戳 */
-  "notice.friend.poke": FriendPokeNoticeEvent;
+  'notice.friend.poke': FriendPokeNoticeEvent;
   /** 通知事件 - 好友点赞 */
-  "notice.friend.like": FriendLikeNoticeEvent;
+  'notice.friend.like': FriendLikeNoticeEvent;
   /** 通知事件 - 好友输入状态 */
-  "notice.friend.input": FriendInputNoticeEvent;
+  'notice.friend.input': FriendInputNoticeEvent;
   /** 通知事件 - 群相关通知 */
-  "notice.group": GroupNoticeEvent;
+  'notice.group': GroupNoticeEvent;
   /** 通知事件 - 群成员增加 */
-  "notice.group.increase": GroupIncreaseNoticeEvent;
+  'notice.group.increase': GroupIncreaseNoticeEvent;
   /** 通知事件 - 群成员减少 */
-  "notice.group.decrease": GroupDecreaseNoticeEvent;
+  'notice.group.decrease': GroupDecreaseNoticeEvent;
   /** 通知事件 - 群管理员变更 */
-  "notice.group.admin": GroupAdminNoticeEvent;
+  'notice.group.admin': GroupAdminNoticeEvent;
   /** 通知事件 - 群成员被禁言 */
-  "notice.group.ban": GroupBanNoticeEvent;
+  'notice.group.ban': GroupBanNoticeEvent;
   /** 通知事件 - 群戳一戳 */
-  "notice.group.poke": GroupPokeNoticeEvent;
+  'notice.group.poke': GroupPokeNoticeEvent;
   /** 通知事件 - 群头衔变更 */
-  "notice.group.title": GroupTitleNoticeEvent;
+  'notice.group.title': GroupTitleNoticeEvent;
   /** 通知事件 - 群名片变更 */
-  "notice.group.card": GroupCardNoticeEvent;
+  'notice.group.card': GroupCardNoticeEvent;
   /** 通知事件 - 群公告变更 */
-  "notice.group.recall": GroupRecallNoticeEvent;
+  'notice.group.recall': GroupRecallNoticeEvent;
   /** 通知事件 - 群上传文件 */
-  "notice.group.upload": GroupUploadNoticeEvent;
+  'notice.group.upload': GroupUploadNoticeEvent;
   /** 通知事件 - 给群消息添加反应 Reaction */
-  "notice.group.reaction": GroupReactionNoticeEvent;
+  'notice.group.reaction': GroupReactionNoticeEvent;
   /** 通知事件 - 群精华消息变更 */
-  "notice.group.essence": GroupEssenceNoticeEvent;
+  'notice.group.essence': GroupEssenceNoticeEvent;
 }
 /**
-* OneBot 11 标准 API
-* @description OneBot 11 规范定义的标准 API 接口
-*/
-type OneBotAPI = "delete_friend" | "delete_msg" | "get_forward_msg" | "get_friend_list" | "get_group_info" | "get_group_list" | "get_group_member_info" | "get_group_member_list" | "get_group_msg_history" | "get_login_info" | "get_msg" | "get_status" | "get_stranger_info" | "send_group_msg" | "send_private_msg" | "set_friend_add_request" | "set_group_add_request" | "set_group_admin" | "set_group_ban" | "set_group_card" | "set_group_kick" | "set_group_leave" | "set_group_name" | "set_group_portrait" | "set_group_special_title" | "set_qq_profile";
+ * OneBot 11 标准 API
+ * @description OneBot 11 规范定义的标准 API 接口
+ */
+type OneBotAPI = 'delete_friend' | 'delete_msg' | 'get_forward_msg' | 'get_friend_list' | 'get_group_info' | 'get_group_list' | 'get_group_member_info' | 'get_group_member_list' | 'get_group_msg_history' | 'get_login_info' | 'get_msg' | 'get_status' | 'get_stranger_info' | 'send_group_msg' | 'send_private_msg' | 'set_friend_add_request' | 'set_group_add_request' | 'set_group_admin' | 'set_group_ban' | 'set_group_card' | 'set_group_kick' | 'set_group_leave' | 'set_group_name' | 'set_group_portrait' | 'set_group_special_title' | 'set_qq_profile';
 /**
-* NapCat 扩展 API
-* @description NapCat 实现的额外扩展 API 接口
-*/
-type NapCatExtendAPI = "_del_group_notice" | "_get_group_notice" | "_get_model_show" | "_mark_all_as_read" | "_send_group_notice" | "_set_model_show" | ".handle_quick_operation" | ".ocr_image" | "ArkShareGroup" | "ArkSharePeer" | "bot_exit" | "can_send_image" | "can_send_record" | "clean_cache" | "click_inline_keyboard_button" | "create_collection" | "create_group_file_folder" | "delete_essence_msg" | "delete_group_file" | "delete_group_folder" | "download_file" | "fetch_custom_face" | "fetch_emoji_like" | "forward_friend_single_msg" | "forward_group_single_msg" | "friend_poke" | "get_ai_characters" | "get_ai_record" | "get_clientkey" | "get_collection_list" | "get_cookies" | "get_credentials" | "get_csrf_token" | "get_doubt_friends_add_request" | "get_essence_msg_list" | "get_file" | "get_friend_msg_history" | "get_friends_with_category" | "get_group_at_all_remain" | "get_group_detail_info" | "get_group_file_system_info" | "get_group_file_url" | "get_group_files_by_folder" | "get_group_honor_info" | "get_group_ignored_notifies" | "get_group_info_ex" | "get_group_root_files" | "get_group_shut_list" | "get_group_system_msg" | "get_image" | "get_mini_app_ark" | "get_online_clients" | "get_private_file_url" | "get_profile_like" | "get_recent_contact" | "get_record" | "get_rkey_server" | "get_rkey" | "get_robot_uin_range" | "get_unidirectional_friend_list" | "get_version_info" | "group_poke" | "mark_group_msg_as_read" | "mark_msg_as_read" | "mark_private_msg_as_read" | "move_group_file" | "nc_get_packet_status" | "nc_get_rkey" | "nc_get_user_status" | "ocr_image" | "rename_group_file" | "send_forward_msg" | "send_group_ai_record" | "send_group_sign" | "send_like" | "send_packet" | "send_poke" | "set_diy_online_status" | "set_essence_msg" | "set_friend_remark" | "set_group_add_option" | "set_group_kick_members" | "set_group_remark" | "set_group_robot_add_option" | "set_group_search" | "set_group_sign" | "set_group_whole_ban" | "set_input_status" | "set_msg_emoji_like" | "set_online_status" | "set_qq_avatar" | "set_self_longnick" | "trans_group_file" | "translate_en2zh" | "upload_group_file" | "upload_private_file";
+ * NapCat 扩展 API
+ * @description NapCat 实现的额外扩展 API 接口
+ */
+type NapCatExtendAPI = '_del_group_notice' | '_get_group_notice' | '_get_model_show' | '_mark_all_as_read' | '_send_group_notice' | '_set_model_show' | '.handle_quick_operation' | '.ocr_image' | 'ArkShareGroup' | 'ArkSharePeer' | 'bot_exit' | 'can_send_image' | 'can_send_record' | 'clean_cache' | 'click_inline_keyboard_button' | 'create_collection' | 'create_group_file_folder' | 'delete_essence_msg' | 'delete_group_file' | 'delete_group_folder' | 'download_file' | 'fetch_custom_face' | 'fetch_emoji_like' | 'forward_friend_single_msg' | 'forward_group_single_msg' | 'friend_poke' | 'get_ai_characters' | 'get_ai_record' | 'get_clientkey' | 'get_collection_list' | 'get_cookies' | 'get_credentials' | 'get_csrf_token' | 'get_doubt_friends_add_request' | 'get_essence_msg_list' | 'get_file' | 'get_friend_msg_history' | 'get_friends_with_category' | 'get_group_at_all_remain' | 'get_group_detail_info' | 'get_group_file_system_info' | 'get_group_file_url' | 'get_group_files_by_folder' | 'get_group_honor_info' | 'get_group_ignored_notifies' | 'get_group_info_ex' | 'get_group_root_files' | 'get_group_shut_list' | 'get_group_system_msg' | 'get_image' | 'get_mini_app_ark' | 'get_online_clients' | 'get_private_file_url' | 'get_profile_like' | 'get_recent_contact' | 'get_record' | 'get_rkey_server' | 'get_rkey' | 'get_robot_uin_range' | 'get_unidirectional_friend_list' | 'get_version_info' | 'group_poke' | 'mark_group_msg_as_read' | 'mark_msg_as_read' | 'mark_private_msg_as_read' | 'move_group_file' | 'nc_get_packet_status' | 'nc_get_rkey' | 'nc_get_user_status' | 'ocr_image' | 'rename_group_file' | 'send_forward_msg' | 'send_group_ai_record' | 'send_group_sign' | 'send_like' | 'send_packet' | 'send_poke' | 'set_diy_online_status' | 'set_essence_msg' | 'set_friend_remark' | 'set_group_add_option' | 'set_group_kick_members' | 'set_group_remark' | 'set_group_robot_add_option' | 'set_group_search' | 'set_group_sign' | 'set_group_whole_ban' | 'set_input_status' | 'set_msg_emoji_like' | 'set_online_status' | 'set_qq_avatar' | 'set_self_longnick' | 'trans_group_file' | 'translate_en2zh' | 'upload_group_file' | 'upload_private_file';
 /** 所有可用的 API 接口联合类型 */
 type API = OneBotAPI | NapCatExtendAPI;
 interface GroupMemberInfo {
@@ -989,14 +989,14 @@ interface GroupMemberInfo {
   card_changeable: boolean;
   is_robot: boolean;
   shut_up_timestamp: number;
-  role: "owner" | "admin" | "member" | (string & {});
+  role: 'owner' | 'admin' | 'member' | (string & {});
   title: string;
 }
 //#endregion
 //#region src/segment.d.ts
 /**
-* 消息片段构造器
-*/
+ * 消息片段构造器
+ */
 declare const segment: {
   /** 创建一个文本消息片段 */
   text: (text: string) => SendElement;
@@ -1058,18 +1058,18 @@ declare class NapCat {
   /** 消息段构建器 */
   get segment(): typeof segment;
   /**
-  * 机器人 QQ 号
-  *
-  * @deprecated 建议使用 `uin` 属性
-  */
+   * 机器人 QQ 号
+   *
+   * @deprecated 建议使用 `uin` 属性
+   */
   get user_id(): number;
   /**
-  * 机器人 QQ 号
-  */
+   * 机器人 QQ 号
+   */
   get uin(): number;
   /**
-  * 机器人昵称
-  */
+   * 机器人昵称
+   */
   get nickname(): string;
   /** 标准化可发送消息元素 */
   normalizeSendable(msg: Sendable | Sendable[]): NormalizedElementToSend[];
@@ -1079,147 +1079,147 @@ declare class NapCat {
   /** 获取一个好友的信息，可以用于发送私聊消息等操作 */
   pickFriend(user_id: number): Promise<FriendWithInfo | null>;
   /**
-  * 注册「一次性」事件监听器，支持主类型或者点分子类型
-  *
-  * 如:  `notice`、`message.private`、`request.group.invite` 等
-  *
-  * 如果需要移除监听器，请调用 `off` 方法或者使用返回的函数
-  *
-  */
+   * 注册「一次性」事件监听器，支持主类型或者点分子类型
+   *
+   * 如:  `notice`、`message.private`、`request.group.invite` 等
+   *
+   * 如果需要移除监听器，请调用 `off` 方法或者使用返回的函数
+   *
+   */
   once<T extends keyof EventMap>(type: T, handler: (event: EventMap[NoInfer<T>]) => void): () => void;
   /**
-  * 注册事件监听器，支持主类型或者点分子类型
-  *
-  * 如:  `notice`、`message.private`、`request.group.invite` 等
-  *
-  * 如果需要移除监听器，请调用 `off` 方法或者使用返回的函数
-  */
+   * 注册事件监听器，支持主类型或者点分子类型
+   *
+   * 如:  `notice`、`message.private`、`request.group.invite` 等
+   *
+   * 如果需要移除监听器，请调用 `off` 方法或者使用返回的函数
+   */
   on<T extends keyof EventMap>(type: T, handler: (event: EventMap[NoInfer<T>]) => void): () => void;
   /**
-  * 移除事件监听器
-  */
+   * 移除事件监听器
+   */
   off<T extends keyof EventMap>(type: T, handler: (event: EventMap[NoInfer<T>]) => void): void;
   /**
-  * 调用 NapCat API
-  */
+   * 调用 NapCat API
+   */
   api<T extends any>(action: API | (string & {}), params?: Record<string, any>): Promise<T>;
   /**
-  * 给好友名片点赞
-  */
+   * 给好友名片点赞
+   */
   sendLike(user_id: number, times?: number): Promise<any>;
   /**
-  * 获取好友列表
-  */
+   * 获取好友列表
+   */
   getFriendList(): Promise<(Friend & Record<string, any>)[]>;
   /**
-  * 获取群列表
-  */
+   * 获取群列表
+   */
   getGroupList(): Promise<(Group & Record<string, any>)[]>;
   /**
-  * 添加消息回应
-  */
+   * 添加消息回应
+   */
   addReaction(message_id: number, id: string): Promise<void>;
   /**
-  * 删除消息回应
-  */
+   * 删除消息回应
+   */
   delReaction(message_id: number, id: string): Promise<void>;
   /**
-  * 获取消息
-  */
+   * 获取消息
+   */
   getMsg(message_id?: number | string | null): Promise<GroupMessageEvent | PrivateMessageEvent | null>;
   /**
-  * 删除好友
-  */
+   * 删除好友
+   */
   deleteFriend(user_id: number, block?: boolean, both?: boolean): Promise<void>;
   /**
-  * 设置群成员禁言
-  */
+   * 设置群成员禁言
+   */
   setGroupBan(group_id: number, user_id: number, duration: number): Promise<void>;
   /**
-  * 撤回消息
-  */
+   * 撤回消息
+   */
   recallMsg(message_id: number): Promise<void>;
   /**
-  * 获取陌生人信息
-  */
+   * 获取陌生人信息
+   */
   getStrangerInfo(user_id: number): Promise<any>;
   /**
-  * 发送私聊消息
-  */
+   * 发送私聊消息
+   */
   sendPrivateMsg(user_id: number, sendable: Sendable | Sendable[]): Promise<{
     message_id: number;
   }>;
   /**
-  * 发送群消息
-  */
+   * 发送群消息
+   */
   sendGroupMsg(group_id: number, sendable: Sendable | Sendable[]): Promise<{
     message_id: number;
   }>;
   /**
-  * 获取群信息
-  */
+   * 获取群信息
+   */
   getGroupInfo(group_id: number): Promise<any>;
   /**
-  * 群签到
-  */
+   * 群签到
+   */
   setGroupSign(group_id: number): Promise<any>;
   /**
-  * 设置群精华消息
-  */
+   * 设置群精华消息
+   */
   setEssenceMsg(message_id: number): Promise<void>;
   /**
-  * 删除群精华消息
-  */
+   * 删除群精华消息
+   */
   deleteEssenceMsg(message_id: number): Promise<void>;
   /**
-  * 设置群成员名片
-  */
+   * 设置群成员名片
+   */
   setGroupCard(group_id: number, user_id: number, card: string): Promise<void>;
   /**
-  * 设置群成员专属头衔
-  */
+   * 设置群成员专属头衔
+   */
   setGroupSpecialTitle(group_id: number, user_id: number, title: string): Promise<void>;
   /**
-  * 获取群成员列表
-  */
+   * 获取群成员列表
+   */
   getGroupMemberList(group_id: number): Promise<GroupMemberInfo[]>;
   /**
-  * 获取群成员信息
-  */
+   * 获取群成员信息
+   */
   getGroupMemberInfo(group_id: number, user_id: number): Promise<GroupMemberInfo>;
   /**
-  * 机器人是否在线
-  */
+   * 机器人是否在线
+   */
   isOnline(): boolean;
   /**
-  * 计算 GTK 值
-  */
+   * 计算 GTK 值
+   */
   getGTk(pskey: string): number;
   /**
-  * 获取 NapCat 原始 Cookie 相关信息
-  */
+   * 获取 NapCat 原始 Cookie 相关信息
+   */
   getNapCatCookies(domain: string): Promise<{
     cookies: string;
     bkn: string;
   }>;
   /**
-  * 获取版本信息
-  */
+   * 获取版本信息
+   */
   getVersionInfo(): Promise<{
     app_name: string;
     protocol_version: string;
     app_version: string;
   }>;
   /**
-  * 获取登录信息
-  */
+   * 获取登录信息
+   */
   getLoginInfo(): Promise<{
     user_id: number;
     nickname: string;
   }>;
   /**
-  * 获取 Cookie 相关信息
-  */
+   * 获取 Cookie 相关信息
+   */
   getCookie(domain: string): Promise<{
     uin: number;
     pskey: string;
@@ -1230,12 +1230,12 @@ declare class NapCat {
     legacyCookie: string;
   }>;
   /**
-  * 通过域名获取 Pskey
-  */
+   * 通过域名获取 Pskey
+   */
   getPskey(domain: string): Promise<string>;
   /**
-  * 获取 Bkn 值
-  */
+   * 获取 Bkn 值
+   */
   getBkn(): Promise<string>;
   /** 启动 NapCat SDK 实例，建立 WebSocket 连接 */
   run(): Promise<void>;