node-karin 1.0.0 → 1.0.2

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # 更新日志
 
+## [1.0.2](https://github.com/KarinJS/Karin/compare/node-karin-v1.0.1...node-karin-v1.0.2) (2025-01-15)
+
+
+### Bug Fixes
+
+* build types error ([f732ca3](https://github.com/KarinJS/Karin/commit/f732ca38155f08adefed7a9f8d42d373a9fc9cc7))
+* ci ([56b3823](https://github.com/KarinJS/Karin/commit/56b382335d63577078e5aa8572d6238c63caf3e9))
+* tips ([9f67525](https://github.com/KarinJS/Karin/commit/9f67525d592094532a3a29fe1f3de41bc1ec1936))
+* version ([1b15d0b](https://github.com/KarinJS/Karin/commit/1b15d0b6c1583a8abc674b97cd746aac97b918c1))
+* 导出 ([33b0683](https://github.com/KarinJS/Karin/commit/33b06831c3c4e6679edb3353962d88d7e2cb4d9b))
+
+## [1.0.1](https://github.com/KarinJS/Karin/compare/node-karin-v1.0.0...node-karin-v1.0.1) (2025-01-15)
+
+
+### Bug Fixes
+
+* ci ([56b3823](https://github.com/KarinJS/Karin/commit/56b382335d63577078e5aa8572d6238c63caf3e9))
+* version ([1b15d0b](https://github.com/KarinJS/Karin/commit/1b15d0b6c1583a8abc674b97cd746aac97b918c1))
+* 导出 ([33b0683](https://github.com/KarinJS/Karin/commit/33b06831c3c4e6679edb3353962d88d7e2cb4d9b))
+
+## [1.0.1](https://github.com/KarinJS/Karin/compare/node-karin-v1.0.0...node-karin-v1.0.1) (2025-01-15)
+
+
+### Bug Fixes
+
+* version ([1b15d0b](https://github.com/KarinJS/Karin/commit/1b15d0b6c1583a8abc674b97cd746aac97b918c1))
+* 导出 ([33b0683](https://github.com/KarinJS/Karin/commit/33b06831c3c4e6679edb3353962d88d7e2cb4d9b))
+
 ## [0.12.17](https://github.com/KarinJS/Karin/compare/v0.12.16...v0.12.17) (2024-10-07)
 
 

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import { EventEmitter } from 'node:events';
 import chalk from 'chalk';
 import { Configuration, Logger as Logger$1 } from 'log4js';
 import { Level } from 'level';
@@ -2476,14 +2477,14 @@ interface OB11GroupMessage extends MessageBase$1 {
 /** 消息事件 */
 type OB11Message = OB11PrivateMessage | OB11GroupMessage | OB11GroupTempMessage;
 /** 通知事件基类 */
-interface NoticeBase$1 extends OB11EventBase {
+interface OB11NoticeBaseType extends OB11EventBase {
     /** 事件类型 */
     post_type: OB11Event.Notice;
     /** 通知类型 */
     notice_type: OB11NoticeType;
 }
 /** 群文件上传事件 */
-interface OneBot11GroupUpload extends NoticeBase$1 {
+interface OneBot11GroupUpload extends OB11NoticeBaseType {
     /** 通知类型 */
     notice_type: OB11NoticeType.GroupUpload;
     /** 群号 */
@@ -2503,7 +2504,7 @@ interface OneBot11GroupUpload extends NoticeBase$1 {
     };
 }
 /** 群管理员变动事件 */
-interface OneBot11GroupAdmin extends NoticeBase$1 {
+interface OneBot11GroupAdmin extends OB11NoticeBaseType {
     /** 通知类型 */
     notice_type: OB11NoticeType.GroupAdmin;
     /** 事件子类型，分别表示设置和取消管理员 */
@@ -2514,7 +2515,7 @@ interface OneBot11GroupAdmin extends NoticeBase$1 {
     user_id: number;
 }
 /** 群减少事件 */
-interface OneBot11GroupDecrease extends NoticeBase$1 {
+interface OneBot11GroupDecrease extends OB11NoticeBaseType {
     /** 通知类型 */
     notice_type: OB11NoticeType.GroupDecrease;
     /** 事件子类型，分别表示主动退群、成员被踢、登录号被踢 */
@@ -2527,7 +2528,7 @@ interface OneBot11GroupDecrease extends NoticeBase$1 {
     user_id: number;
 }
 /** 群增加事件 */
-interface OneBot11GroupIncrease extends NoticeBase$1 {
+interface OneBot11GroupIncrease extends OB11NoticeBaseType {
     /** 通知类型 */
     notice_type: OB11NoticeType.GroupIncrease;
     /** 事件子类型，分别表示管理员已同意入群、管理员邀请入群 */
@@ -2540,7 +2541,7 @@ interface OneBot11GroupIncrease extends NoticeBase$1 {
     user_id: number;
 }
 /** 群禁言事件 */
-interface OneBot11GroupBan extends NoticeBase$1 {
+interface OneBot11GroupBan extends OB11NoticeBaseType {
     /** 通知类型 */
     notice_type: OB11NoticeType.GroupBan;
     /** 事件子类型，分别表示禁言、解除禁言 */
@@ -2555,14 +2556,14 @@ interface OneBot11GroupBan extends NoticeBase$1 {
     duration: number;
 }
 /** 新添加好友事件 */
-interface OneBot11FriendAdd extends NoticeBase$1 {
+interface OneBot11FriendAdd extends OB11NoticeBaseType {
     /** 通知类型 */
     notice_type: OB11NoticeType.FriendAdd;
     /** 新添加好友 QQ 号 */
     user_id: number;
 }
 /** 群撤回事件 */
-interface OneBot11GroupRecall extends NoticeBase$1 {
+interface OneBot11GroupRecall extends OB11NoticeBaseType {
     /** 通知类型 */
     notice_type: OB11NoticeType.GroupRecall;
     /** 群号 */
@@ -2575,7 +2576,7 @@ interface OneBot11GroupRecall extends NoticeBase$1 {
     message_id: number;
 }
 /** 好友消息撤回事件 */
-interface OneBot11FriendRecall extends NoticeBase$1 {
+interface OneBot11FriendRecall extends OB11NoticeBaseType {
     /** 通知类型 */
     notice_type: OB11NoticeType.FriendRecall;
     /** 好友 QQ 号 */
@@ -2584,7 +2585,7 @@ interface OneBot11FriendRecall extends NoticeBase$1 {
     message_id: number;
 }
 /** 戳一戳事件 */
-interface OneBot11Poke extends NoticeBase$1 {
+interface OneBot11Poke extends OB11NoticeBaseType {
     /** 消息类型 */
     notice_type: OB11NoticeType.Notify;
     /** 提示类型 */
@@ -2597,7 +2598,7 @@ interface OneBot11Poke extends NoticeBase$1 {
     target_id: number;
 }
 /** 运气王事件 */
-interface OneBot11LuckyKing extends NoticeBase$1 {
+interface OneBot11LuckyKing extends OB11NoticeBaseType {
     /** 消息类型 */
     notice_type: OB11NoticeType.Notify;
     /** 提示类型 */
@@ -2610,7 +2611,7 @@ interface OneBot11LuckyKing extends NoticeBase$1 {
     target_id: number;
 }
 /** 荣誉变更事件 */
-interface OneBot11Honor extends NoticeBase$1 {
+interface OneBot11Honor extends OB11NoticeBaseType {
     /** 消息类型 */
     notice_type: OB11NoticeType.Notify;
     /** 提示类型 */
@@ -2623,7 +2624,7 @@ interface OneBot11Honor extends NoticeBase$1 {
     user_id: number;
 }
 /** 群表情回应事件 napcat、llonebot */
-interface OneBot11GroupMessageReaction extends NoticeBase$1 {
+interface OneBot11GroupMessageReaction extends OB11NoticeBaseType {
     /** 消息类型 */
     notice_type: OB11NoticeType.GroupMsgEmojiLike;
     /** 群号 */
@@ -2640,7 +2641,7 @@ interface OneBot11GroupMessageReaction extends NoticeBase$1 {
     }>;
 }
 /** 群表情回应事件 Lagrange */
-interface OneBot11GroupMessageReactionLagrange extends NoticeBase$1 {
+interface OneBot11GroupMessageReactionLagrange extends OB11NoticeBaseType {
     /** 消息类型 */
     notice_type: OB11NoticeType.GroupMsgEmojiLikeLagrange;
     /** 提示类型 */
@@ -2657,7 +2658,7 @@ interface OneBot11GroupMessageReactionLagrange extends NoticeBase$1 {
     count: number;
 }
 /** 群精华 */
-interface OneBot11GroupEssence extends NoticeBase$1 {
+interface OneBot11GroupEssence extends OB11NoticeBaseType {
     /** 通知类型 */
     notice_type: OB11NoticeType.GroupEssence;
     /** 操作类型 */
@@ -2672,7 +2673,7 @@ interface OneBot11GroupEssence extends NoticeBase$1 {
     operator_id: number;
 }
 /** 群成员名片更新 */
-interface OneBot11GroupCard extends NoticeBase$1 {
+interface OneBot11GroupCard extends OB11NoticeBaseType {
     /** 通知类型 */
     time: number;
     /** 事件类型 */
@@ -2693,7 +2694,7 @@ interface OneBot11GroupCard extends NoticeBase$1 {
 /** 通知事件 */
 type OB11Notice = OneBot11GroupUpload | OneBot11GroupAdmin | OneBot11GroupDecrease | OneBot11GroupIncrease | OneBot11GroupBan | OneBot11FriendAdd | OneBot11GroupRecall | OneBot11FriendRecall | OneBot11Poke | OneBot11LuckyKing | OneBot11Honor | OneBot11GroupMessageReaction | OneBot11GroupMessageReactionLagrange | OneBot11GroupEssence | OneBot11GroupCard;
 /** 请求事件基类 */
-interface RequestBase$1 extends OB11EventBase {
+interface OB11RequestBaseType extends OB11EventBase {
     /** 事件发生的时间戳 */
     time: number;
     /** 事件类型 */
@@ -2710,12 +2711,12 @@ interface RequestBase$1 extends OB11EventBase {
     comment: string;
 }
 /** 好友请求事件 */
-interface OneBot11FriendRequest extends RequestBase$1 {
+interface OneBot11FriendRequest extends OB11RequestBaseType {
     /** 请求类型 */
     request_type: OB11RequestType.Friend;
 }
 /** 群请求事件 */
-interface OneBot11GroupRequest extends RequestBase$1 {
+interface OneBot11GroupRequest extends OB11RequestBaseType {
     /** 请求类型 */
     request_type: OB11RequestType.Group;
     /** 请求子类型，分别表示加群请求、邀请登录号入群 */
@@ -8645,7 +8646,7 @@ declare const marketFace: (id: string) => MarketFaceElement;
  * @param scene 分享类型
  * @param peer 被推荐人的QQ号或者被推荐群的群号
  */
-declare const contact: (scene: "group" | "friend", peer: string) => ContactElement;
+declare const contact$1: (scene: "group" | "friend", peer: string) => ContactElement;
 /**
  * 构建常规音乐元素
  * @param id 歌曲ID或自定义音乐选项
@@ -8679,7 +8680,6 @@ declare const segment_at: typeof at;
 declare const segment_basketball: typeof basketball;
 declare const segment_bubbleFace: typeof bubbleFace;
 declare const segment_button: typeof button;
-declare const segment_contact: typeof contact;
 declare const segment_customMusic: typeof customMusic;
 declare const segment_dice: typeof dice;
 declare const segment_face: typeof face;
@@ -8706,7 +8706,7 @@ declare const segment_video: typeof video;
 declare const segment_weather: typeof weather;
 declare const segment_xml: typeof xml;
 declare namespace segment {
-  export { segment_at as at, segment_basketball as basketball, segment_bubbleFace as bubbleFace, segment_button as button, segment_contact as contact, segment_customMusic as customMusic, segment_dice as dice, segment_face as face, segment_gift as gift, segment_image as image, segment_json as json, segment_keyboard as keyboard, segment_location as location, segment_longMsg as longMsg, segment_markdown as markdown, segment_markdownTpl as markdownTpl, segment_marketFace as marketFace, segment_music as music, segment_node as node, segment_nodeDirect as nodeDirect, segment_pasmsg as pasmsg, segment_raw as raw, segment_record as record, segment_reply as reply, segment_rps as rps, segment_share as share, segment_text as text, segment_video as video, segment_weather as weather, segment_xml as xml };
+  export { segment_at as at, segment_basketball as basketball, segment_bubbleFace as bubbleFace, segment_button as button, contact$1 as contact, segment_customMusic as customMusic, segment_dice as dice, segment_face as face, segment_gift as gift, segment_image as image, segment_json as json, segment_keyboard as keyboard, segment_location as location, segment_longMsg as longMsg, segment_markdown as markdown, segment_markdownTpl as markdownTpl, segment_marketFace as marketFace, segment_music as music, segment_node as node, segment_nodeDirect as nodeDirect, segment_pasmsg as pasmsg, segment_raw as raw, segment_record as record, segment_reply as reply, segment_rps as rps, segment_share as share, segment_text as text, segment_video as video, segment_weather as weather, segment_xml as xml };
 }
 
 /**
@@ -9574,150 +9574,105 @@ declare const server: http.Server<typeof http.IncomingMessage, typeof http.Serve
 declare const listen: (port: number, host: string) => void;
 
 /**
- * @description 创建好友消息事件
- * @param options 好友消息事件所需参数
- */
-declare const createFriendMessage: (options: FriendMessageOptions) => FriendMessage;
-/**
- * @description 创建群消息事件实例
- * @param options 群消息事件所需参数
- */
-declare const createGroupMessage: (options: GroupMessageOptions) => GroupMessage;
-/**
- * @description 创建频道消息事件实例
- * @param options 频道消息事件所需参数
- */
-declare const createGuildMessage: (options: GuildMessageOptions) => GuildMessage;
-/**
- * @description 创建频道私信消息事件实例
- * @param options 频道私信消息事件所需参数
- */
-declare const createDirectMessage: (options: DirectMessageOptions) => DirectMessage;
-/**
- * @description 创建群临时消息事件实例
- * @param options 群临时消息事件所需参数
- */
-declare const createGroupTempMessage: (options: GroupTempMessageOptions) => GroupTempMessage;
-/**
- * @description 创建点赞通知事件
- * @param options 点赞通知事件所需参数
- */
-declare const createReceiveLikeNotice: (options: ReceiveLikeOptions) => ReceiveLikeNotice;
-/**
- * @description 创建好友增加通知事件
- * @param options 好友增加通知事件所需参数
- */
-declare const createFriendIncreaseNotice: (options: FriendIncreaseOptions) => FriendIncreaseNotice;
-/**
- * @description 创建好友减少通知事件
- * @param options 好友减少通知事件所需参数
- */
-declare const createFriendDecreaseNotice: (options: FriendDecreaseOptions) => FriendDecreaseNotice;
-/**
- * @description 创建私聊戳一戳通知事件
- * @param options 私聊戳一戳通知事件所需参数
- */
-declare const createPrivatePokeNotice: (options: PrivatePokeOptions) => PrivatePokeNotice;
-/**
- * @description 创建私聊撤回通知事件
- * @param options 私聊撤回通知事件所需参数
- */
-declare const createPrivateRecallNotice: (options: PrivateRecallOptions) => PrivateRecallNotice;
-/**
- * @description 创建私聊文件上传通知事件
- * @param options 私聊文件上传通知事件所需参数
- */
-declare const createPrivateFileUploadedNotice: (options: PrivateFileUploadedOptions) => PrivateFileUploadedNotice;
-/**
- * @description 创建群戳一戳通知事件
- * @param options 群戳一戳通知事件所需参数
- */
-declare const createGroupPokeNotice: (options: GroupPokeOptions) => GroupPokeNotice;
-/**
- * @description 创建群撤回通知事件
- * @param options 群撤回通知事件所需参数
- */
-declare const createGroupRecallNotice: (options: GroupRecallOptions) => GroupRecallNotice;
-/**
- * @description 创建群文件上传通知事件
- * @param options 群文件上传通知事件所需参数
- */
-declare const createGroupFileUploadedNotice: (options: GroupFileUploadedOptions) => GroupFileUploadedNotice;
-/**
- * @description 创建群成员名片更新通知事件
- * @param options 群成员名片更新通知事件所需参数
- */
-declare const createGroupCardChangedNotice: (options: GroupCardChangedOptions) => GroupCardChangedNotice;
-/**
- * @description 创建群成员专属头衔更新通知事件
- * @param options 群成员专属头衔更新通知事件所需参数
- */
-declare const createGroupMemberTitleUpdatedNotice: (options: GroupMemberUniqueTitleChangedOptions) => GroupMemberTitleUpdatedNotice;
-/**
- * @description 创建群精华消息变更通知事件
- * @param options 群精华消息变更通知事件所需参数
- */
-declare const createGroupHlightsChangedNotice: (options: GroupHlightsChangedOptions) => GroupHlightsChangedNotice;
-/**
- * @description 创建群成员增加通知事件
- * @param options 群成员增加通知事件所需参数
+ * 构建好友场景的`sender`
+ * @param userId 用户ID
+ * @param name 用户名
+ * @param sex 性别
+ * @param age 年龄
+ * @param uid QQ场景专属
+ * @param uin QQ场景专属
  */
-declare const createGroupMemberAddNotice: (options: GroupMemberIncreaseOptions) => GroupMemberIncreaseNotice;
+declare const senderFriend: (userId: Sender<"friend">["userId"], name?: Sender<"friend">["name"], sex?: Sender<"friend">["sex"], age?: Sender<"friend">["age"], uid?: Sender<"friend">["uid"], uin?: Sender<"friend">["uin"]) => Sender<"friend">;
 /**
- * @description 创建群成员减少通知事件
- * @param options 群成员减少通知事件所需参数
+ * 构建群聊场景的`sender`
  */
-declare const createGroupMemberDelNotice: (options: GroupMemberDecreaseOptions) => GroupMemberDecreaseNotice;
+declare const senderGroup: SenderGroup;
 /**
- * @description 创建群管理员变更通知事件
- * @param options 群管理员变更通知事件所需参数
+ * 构建频道场景的`sender`
+ * @param userId 用户ID
+ * @param role 群成员身份
+ * @param name 用户名
+ * @param sex 性别
+ * @param age 年龄
  */
-declare const createGroupAdminChangedNotice: (options: GroupAdminChangedOptions) => GroupAdminChangedNotice;
+declare const senderGuild: (userId: Sender<"guild">["userId"], role: Sender<"guild">["role"], name: Sender<"guild">["name"] | undefined, sex: Sender<"guild">["sex"], age: Sender<"guild">["age"]) => Sender<"guild">;
 /**
- * @description 创建群签到通知事件
- * @param options 群签到通知事件所需参数
+ * 构建频道私信场景的`sender`
  */
-declare const createGroupSignInNotice: (options: GroupSignInOptions) => GroupSignInNotice;
+declare const senderDirect: (userId: Sender<"friend">["userId"], name?: Sender<"friend">["name"], sex?: Sender<"friend">["sex"], age?: Sender<"friend">["age"], uid?: Sender<"friend">["uid"], uin?: Sender<"friend">["uin"]) => Sender<"friend">;
 /**
- * @description 创建群禁言通知事件
- * @param options 群禁言通知事件所需参数
+ * 构建群聊临时会话场景的`sender`
  */
-declare const createGroupMemberBanNotice: (options: GroupMemberBanOptions) => GroupMemberBanNotice;
+declare const senderGroupTemp: (userId: Sender<"friend">["userId"], name?: Sender<"friend">["name"], sex?: Sender<"friend">["sex"], age?: Sender<"friend">["age"], uid?: Sender<"friend">["uid"], uin?: Sender<"friend">["uin"]) => Sender<"friend">;
 /**
- * @description 创建群全员禁言通知事件
- * @param options 群全员禁言通知事件所需参数
+ * 事件发送者构建器
+ * @description 用于构建不同场景的事件发送者信息
  */
-declare const createGroupWholeBanNotice: (options: GroupWholeBanOptions) => GroupWholeBanNotice;
+declare const sender: {
+    /** 好友场景 */
+    friend: (userId: Sender<"friend">["userId"], name?: Sender<"friend">["name"], sex?: Sender<"friend">["sex"], age?: Sender<"friend">["age"], uid?: Sender<"friend">["uid"], uin?: Sender<"friend">["uin"]) => Sender<"friend">;
+    /** 群聊场景 */
+    group: SenderGroup;
+    /** 频道场景 */
+    guild: (userId: Sender<"guild">["userId"], role: Sender<"guild">["role"], name: Sender<"guild">["name"] | undefined, sex: Sender<"guild">["sex"], age: Sender<"guild">["age"]) => Sender<"guild">;
+    /** 频道私信场景 */
+    direct: (userId: Sender<"friend">["userId"], name?: Sender<"friend">["name"], sex?: Sender<"friend">["sex"], age?: Sender<"friend">["age"], uid?: Sender<"friend">["uid"], uin?: Sender<"friend">["uin"]) => Sender<"friend">;
+    /** 群聊临时会话场景 */
+    groupTemp: (userId: Sender<"friend">["userId"], name?: Sender<"friend">["name"], sex?: Sender<"friend">["sex"], age?: Sender<"friend">["age"], uid?: Sender<"friend">["uid"], uin?: Sender<"friend">["uin"]) => Sender<"friend">;
+};
+
 /**
- * @description 创建群消息表态通知事件
- * @param options 群消息表态通知事件所需参数
+ * 构建好友事件来源
+ * @param peer 好友ID
+ * @param name 好友昵称 默认为空字符串
  */
-declare const createGroupMessageReactionNotice: (options: GroupMessageReactionOptions) => GroupMessageReactionNotice;
+declare const contactFriend: (peer: FriendContact["peer"], name?: FriendContact["name"]) => FriendContact;
 /**
- * @description 创建群红包运气王通知事件
- * @param options 群红包运气王通知事件所需参数
+ * 构建群聊事件来源
+ * @param peer 群ID
+ * @param name 群名
  */
-declare const createGroupLuckKingNotice: (options: GroupLuckKingOptions) => GroupLuckKingNotice;
+declare const contactGroup: (peer: GroupContact["peer"], name?: GroupContact["name"]) => GroupContact;
 /**
- * @description 创建群成员荣誉变更通知事件
- * @param options 群成员荣誉变更通知事件所需参数
+ * 构建频道私信事件来源
+ * @param peer 频道ID
+ * @param subId 子频道ID
+ * @param srcGuildId 来源频道ID
+ * @param name 频道名称 默认为空字符串
+ * @param subName 子频道名称 默认为空字符串
  */
-declare const createGroupHonorChangedNotice: (options: GroupHonorChangedOptions) => GroupHonorChangedNotice;
+declare const contactDirect: (peer: DirectContact["peer"], subId: DirectContact["subPeer"], name?: DirectContact["name"], subName?: DirectContact["subName"]) => DirectContact;
 /**
- * @description 创建群成员申请入群请求事件
- * @param options 群成员申请入群请求事件所需参数
+ * 构建频道事件来源
+ * @param peer 频道ID
+ * @param subPeer 子频道ID
+ * @param name 频道名称 默认为空字符串
+ * @param subName 子频道名称 默认为空字符串
  */
-declare const createGroupApplyRequest: (options: GroupApplyRequestOptions) => GroupApplyRequest;
+declare const contactGuild: (peer: GuildContact["peer"], subPeer: GuildContact["subPeer"], name?: GuildContact["name"], subName?: GuildContact["subName"]) => GuildContact;
 /**
- * @description 创建邀请Bot加群请求事件
- * @param options 邀请Bot加群请求事件所需参数
+ * 构建群聊临时会话事件来源
+ * @param peer 群ID
+ * @param subPeer 发起临时会话的用户ID
+ * @param name 群名
  */
-declare const createGroupInviteRequest: (options: GroupInviteRequestOptions) => GroupInviteRequest;
+declare const contactGroupTemp: (peer: GroupTempContact["peer"], subPeer: GroupTempContact["subPeer"], name?: GroupTempContact["name"]) => GroupTempContact;
 /**
- * @description 创建Bot收到添加为好友请求事件
- * @param options Bot收到添加为好友请求事件所需参数
+ * 事件来源构建器
+ * @description 用于构建不同场景的事件来源信息
  */
-declare const createPrivateApplyRequest: (options: PrivateApplyRequestOptions) => PrivateApplyRequest;
+declare const contact: {
+    /** 好友场景 */
+    friend: (peer: FriendContact["peer"], name?: FriendContact["name"]) => FriendContact;
+    /** 群聊场景 */
+    group: (peer: GroupContact["peer"], name?: GroupContact["name"]) => GroupContact;
+    /** 频道场景 */
+    guild: (peer: GuildContact["peer"], subPeer: GuildContact["subPeer"], name?: GuildContact["name"], subName?: GuildContact["subName"]) => GuildContact;
+    /** 频道私信场景 */
+    direct: (peer: DirectContact["peer"], subId: DirectContact["subPeer"], name?: DirectContact["name"], subName?: DirectContact["subName"]) => DirectContact;
+    /** 群聊临时会话场景 */
+    groupTemp: (peer: GroupTempContact["peer"], subPeer: GroupTempContact["subPeer"], name?: GroupTempContact["name"]) => GroupTempContact;
+};
 
 /**
  * 控制台交互适配器
@@ -9866,4 +9821,4 @@ declare const renderTpl: (options: Omit<Options, "name"> & {
     name?: string;
 };
 
-export { type Accept, type AccountInfo, type Adapter, AdapterBase, type AdapterCommunication, AdapterConsole, type AdapterInfo, AdapterOneBot, type AdapterOptions, type AdapterPlatform, type AdapterProtocol, type AdapterStandard, type AdapterType, type Adapters, type AllPluginMethods, type AnonymousSegment, type Apps, type AtElement, type AtSegment, type BaseContact, type BaseEventOptions, type BaseEventType, type BasketballElement, Bot, type BoundingBox, type BubbleFaceElement, type Button, type ButtonElement, type Cache, type CacheEntry, type CmdFnc, type Command, type CommandClass, type Config, type Contact, type ContactElement, type ContactSegment, type Count, type CreateGroupFolderResponse, type CustomMusicElement, type CustomMusicSegment, type CustomNodeElement, type CustomNodeSegments, type DiceElement, type DiceSegment, type DirectContact, type DirectMessageOptions, type DirectNodeElement, type DirectNodeSegment, type DirectSender, type DownloadFileOptions, type DownloadFileResponse, type ElementTypes, type Elements, type Event, type EventParent, type EventToSubEvent, type ExecOptions, type ExecReturn, type ExecType, type FaceElement, type FaceSegment, type FileList, type FileListMap, type FileSegment, type FileToUrlHandler, type FileToUrlResult, type ForwardOptions, type ForwardSegment, type FriendContact, type FriendDecreaseOptions, type FriendIncreaseOptions, type FriendMessageOptions, type FriendNoticeEventMap, type FriendRequestEventMap, type FriendSender, type GetAtAllCountResponse, type GetBot, type GetGroupFileListResponse, type GetGroupFileSystemInfoResponse, type GetGroupHighlightsResponse, type GetGroupInfo, type GetGroupMemberInfo, type GetGroupMuteListResponse, type GetMsg, type GetPluginReturn, type GetPluginType, type GiftElement, type GoToOptions, type GroupAdminChangedOptions, type GroupApplyRequestOptions, type GroupCardChangedOptions, type GroupContact, type GroupFileUploadedOptions, type GroupHlightsChangedOptions, type GroupHonorChangedOptions, type GroupInfo, type GroupInviteRequestOptions, type GroupLuckKingOptions, type GroupMemberBanOptions, type GroupMemberDecreaseOptions, type GroupMemberIncreaseOptions, type GroupMemberInfo, type GroupMemberUniqueTitleChangedOptions, type GroupMessageOptions, type GroupMessageReactionOptions, type GroupNoticeEventMap, type GroupPokeOptions, type GroupRecallOptions, type GroupRequestEventMap, type GroupSender, type GroupSignInOptions, type GroupTempContact, type GroupTempMessageOptions, type GroupTempSender, type GroupWholeBanOptions, type Groups, type GuildContact, type GuildMessageOptions, type GuildSender, type Handler, type HandlerType, type HonorInfoList, type ImageElement, type ImageSegment, type JsonElement, type JsonSegment, type KarinButton, type KeyboardElement, type LocationElement, type LocationSegment, type Log, type Logger, type LoggerExpand, type LoggerLevel, type LoggerOptions, type LongMsgElement, type MarkdownElement, type MarkdownTplElement, type MarketFaceElement, type Message$2 as Message, type MessageEventMap, type MessageEventSub, type MessageOptions, type MessageResponse, type MetaEventBase, type MusicElement, type MusicPlatform, type MusicSegment, type NodeElement, type Notice, type NoticeAndRequest, type NoticeBase$1 as NoticeBase, type NoticeEventMap, type NoticeEventSub, type NoticeOptions, type OB11AllEvent, OB11ApiAction, type OB11ApiParams, type OB11ApiRequest, OB11Event, type OB11EventBase, type OB11FriendSender, type OB11GroupMessage, type OB11GroupSender, type OB11GroupTempMessage, type OB11Message, OB11MessageSubType, OB11MessageType, type OB11Meta, type OB11NodeSegment, type OB11Notice, OB11NoticeType, type OB11PrivateMessage, type OB11Request, OB11RequestType, type OB11Segment, type OB11SegmentBase, type OB11SegmentType, OB11Sex, type OB11serInfo, type OneBot11FriendAdd, type OneBot11FriendRecall, type OneBot11FriendRequest, type OneBot11GroupAdmin, type OneBot11GroupBan, type OneBot11GroupCard, type OneBot11GroupDecrease, type OneBot11GroupEssence, type OneBot11GroupIncrease, type OneBot11GroupMessageReaction, type OneBot11GroupMessageReactionLagrange, type OneBot11GroupRecall, type OneBot11GroupRequest, type OneBot11GroupUpload, type OneBot11Heartbeat, type OneBot11Honor, type OneBot11Lifecycle, type OneBot11LuckyKing, type OneBot11Poke, type Options, type PM2, type Package, type Parser, type PasmsgElement, type Permission, type PkgData, type PkgInfo, Plugin, type PluginFile, type PluginFncTypes, type PluginOptions, type PluginRule, type Point, type PokeSegment, type PrivateApplyRequestOptions, type PrivateFileUploadedOptions, type PrivatePokeOptions, type PrivateRecallOptions, type Privates, type PuppeteerLifeCycleEvent, type QQBotButton, type QQButtonTextType, type QQGroupFileInfo, type QQGroupFolderInfo, type QQGroupHonorInfo, type RawElement, type ReadyMusicElement, type ReceiveLikeOptions, type RecordElement, type RecordSegment, type Redis, type Render, type RenderResult, Renderer, type Renders, type Reply, type ReplyElement, type ReplySegment, type Request, type RequestBase$1 as RequestBase, type RequestEventMap, type RequestEventSub, type RequestOptions, type RequireFunction, type RequireFunctionSync, type RequireOptions, type Role, type RpsElement, type RpsSegment, type Scene, type ScreenshotClip, type ScreenshotOptions, type Segment, type SendElement, type SendForwardMessageResponse, type SendMessage, type SendMsgResults, type Sender, type SenderBase, type SenderGroup, type Sex, type ShakeSegment, type ShareElement, type ShareSegment, type SrcReply, type Task, type TextElement, type TextSegment, type UnregisterBot, type UserInfo, type VideoElement, type VideoSegment, type WaitForOptions, Watch, Watcher, type WeatherElement, type XmlElement, type XmlSegment, type YamlComment, YamlEditor, type YamlValue, absPath, adapter, app, applyComments, base64, buffer, buttonHandle, callRender, changelog, checkGitPluginUpdate, checkPkgUpdate, clearRequire, clearRequireFile, comment, index$1 as common, index as config, copyConfig, copyConfigSync, copyFiles, copyFilesSync, createDirectMessage, createFriendDecreaseNotice, createFriendIncreaseNotice, createFriendMessage, createGroupAdminChangedNotice, createGroupApplyRequest, createGroupCardChangedNotice, createGroupFileUploadedNotice, createGroupHlightsChangedNotice, createGroupHonorChangedNotice, createGroupInviteRequest, createGroupLuckKingNotice, createGroupMemberAddNotice, createGroupMemberBanNotice, createGroupMemberDelNotice, createGroupMemberTitleUpdatedNotice, createGroupMessage, createGroupMessageReactionNotice, createGroupPokeNotice, createGroupRecallNotice, createGroupSignInNotice, createGroupTempMessage, createGroupWholeBanNotice, createGuildMessage, createLogger, createPluginDir, createPrivateApplyRequest, createPrivateFileUploadedNotice, createPrivatePokeNotice, createPrivateRecallNotice, createRawMessage, createReceiveLikeNotice, karin as default, downFile, errorToString, exec, existToMkdir, existToMkdirSync, exists, existsSync, ffmpeg, ffplay, ffprobe, fs as file, fileToUrl, fileToUrlHandlerKey, filesByExt, formatTime$1 as formatTime, index$3 as fs, getAllBot, getAllBotID, getAllBotList, getBot, getBotCount, getCommit, getFiles, getHash, getPid, getPkgVersion, getPluginInfo, getRelPath, getRemotePkgVersion, getRender, getRenderCount, getRenderList, getRequestIp, getTime, handler$1 as handler, importModule, isClass, isDir, isDirSync, isDocker, isFile, isFileSync, isIPv4Loop, isIPv6Loop, isLinux, isLocalRequest, isLoopback, isMac, isPlugin, isRoot, isStatic, isSubPath, isWin, json$1 as json, karin, karinToQQBot, key, level, listen, lock, lockMethod, lockProp, log, logger, logs, makeForward, makeMessage, type messageType, mkdir, mkdirSync, parseChangelog, pkgRoot, qqbotToKarin, randomStr, range, read, readFile, readJson, readJsonSync, redis$1 as redis, registerBot, registerRender, render, renderHtml, renderMultiHtml, renderTpl, requireFile, requireFileSync, restart, restartDirect, rmSync, save, type screenshot, segment, sendMsg, sep, server, splitPath, stream, stringifyError, index$2 as system, unregisterBot, unregisterRender, updateAllGitPlugin, updateAllPkg, updateGitPlugin, updatePkg, uptime$1 as uptime, urlToPath, watch, watchAndMerge, write, writeJson, writeJsonSync, wss, yaml };
+export { type Accept, type AccountInfo, type Adapter, AdapterBase, type AdapterCommunication, AdapterConsole, type AdapterInfo, AdapterOneBot, type AdapterOptions, type AdapterPlatform, type AdapterProtocol, type AdapterStandard, type AdapterType, type Adapters, type AllPluginMethods, type AnonymousSegment, type Apps, type AtElement, type AtSegment, type BaseContact, BaseEvent, type BaseEventOptions, type BaseEventType, type BasketballElement, Bot, type BoundingBox, type BubbleFaceElement, type Button, type ButtonElement, type Cache, type CacheEntry, type CmdFnc, type Command, type CommandClass, type Config, type Contact, type ContactElement, type ContactSegment, type Count, type CreateGroupFolderResponse, type CustomMusicElement, type CustomMusicSegment, type CustomNodeElement, type CustomNodeSegments, type DiceElement, type DiceSegment, type DirectContact, DirectMessage, type DirectMessageOptions, type DirectNodeElement, type DirectNodeSegment, type DirectSender, type DownloadFileOptions, type DownloadFileResponse, type ElementTypes, type Elements, type Event, type EventParent, type EventToSubEvent, type ExecOptions, type ExecReturn, type ExecType, type FaceElement, type FaceSegment, type FileList, type FileListMap, type FileSegment, type FileToUrlHandler, type FileToUrlResult, type ForwardOptions, type ForwardSegment, type FriendContact, FriendDecreaseNotice, type FriendDecreaseOptions, FriendIncreaseNotice, type FriendIncreaseOptions, FriendMessage, type FriendMessageOptions, type FriendNoticeEventMap, type FriendRequestEventMap, type FriendSender, type GetAtAllCountResponse, type GetBot, type GetGroupFileListResponse, type GetGroupFileSystemInfoResponse, type GetGroupHighlightsResponse, type GetGroupInfo, type GetGroupMemberInfo, type GetGroupMuteListResponse, type GetMsg, type GetPluginReturn, type GetPluginType, type GiftElement, type GoToOptions, GroupAdminChangedNotice, type GroupAdminChangedOptions, GroupApplyRequest, type GroupApplyRequestOptions, GroupCardChangedNotice, type GroupCardChangedOptions, type GroupContact, GroupFileUploadedNotice, type GroupFileUploadedOptions, GroupHlightsChangedNotice, type GroupHlightsChangedOptions, GroupHonorChangedNotice, type GroupHonorChangedOptions, type GroupInfo, GroupInviteRequest, type GroupInviteRequestOptions, GroupLuckKingNotice, type GroupLuckKingOptions, GroupMemberBanNotice, type GroupMemberBanOptions, GroupMemberDecreaseNotice, type GroupMemberDecreaseOptions, GroupMemberIncreaseNotice, type GroupMemberIncreaseOptions, type GroupMemberInfo, GroupMemberTitleUpdatedNotice, type GroupMemberUniqueTitleChangedOptions, GroupMessage, type GroupMessageOptions, GroupMessageReactionNotice, type GroupMessageReactionOptions, GroupNotice, type GroupNoticeEventMap, GroupPokeNotice, type GroupPokeOptions, GroupRecallNotice, type GroupRecallOptions, type GroupRequestEventMap, type GroupSender, GroupSignInNotice, type GroupSignInOptions, type GroupTempContact, GroupTempMessage, type GroupTempMessageOptions, type GroupTempSender, GroupWholeBanNotice, type GroupWholeBanOptions, type Groups, type GuildContact, GuildMessage, type GuildMessageOptions, type GuildSender, type Handler, type HandlerType, type HonorInfoList, type ImageElement, type ImageSegment, type JsonElement, type JsonSegment, type KarinButton, type KeyboardElement, type LocationElement, type LocationSegment, type Log, type Logger, type LoggerExpand, type LoggerLevel, type LoggerOptions, type LongMsgElement, type MarkdownElement, type MarkdownTplElement, type MarketFaceElement, type Message$2 as Message, MessageBase, type MessageEventMap, type MessageEventSub, type MessageOptions, type MessageResponse, type MetaEventBase, type MusicElement, type MusicPlatform, type MusicSegment, type NodeElement, type Notice, type NoticeAndRequest, NoticeBase, type NoticeEventMap, type NoticeEventSub, type NoticeOptions, type OB11AllEvent, OB11ApiAction, type OB11ApiParams, type OB11ApiRequest, OB11Event, type OB11EventBase, type OB11FriendSender, type OB11GroupMessage, type OB11GroupSender, type OB11GroupTempMessage, type OB11Message, OB11MessageSubType, OB11MessageType, type OB11Meta, type OB11NodeSegment, type OB11Notice, type OB11NoticeBaseType, OB11NoticeType, type OB11PrivateMessage, type OB11Request, type OB11RequestBaseType, OB11RequestType, type OB11Segment, type OB11SegmentBase, type OB11SegmentType, OB11Sex, type OB11serInfo, type OneBot11FriendAdd, type OneBot11FriendRecall, type OneBot11FriendRequest, type OneBot11GroupAdmin, type OneBot11GroupBan, type OneBot11GroupCard, type OneBot11GroupDecrease, type OneBot11GroupEssence, type OneBot11GroupIncrease, type OneBot11GroupMessageReaction, type OneBot11GroupMessageReactionLagrange, type OneBot11GroupRecall, type OneBot11GroupRequest, type OneBot11GroupUpload, type OneBot11Heartbeat, type OneBot11Honor, type OneBot11Lifecycle, type OneBot11LuckyKing, type OneBot11Poke, type Options, type PM2, type Package, type Parser, type PasmsgElement, type Permission, type PkgData, type PkgInfo, Plugin, type PluginFile, type PluginFncTypes, type PluginOptions, type PluginRule, type Point, type PokeSegment, PrivateApplyRequest, type PrivateApplyRequestOptions, PrivateFileUploadedNotice, type PrivateFileUploadedOptions, PrivatePokeNotice, type PrivatePokeOptions, PrivateRecallNotice, type PrivateRecallOptions, type Privates, type PuppeteerLifeCycleEvent, type QQBotButton, type QQButtonTextType, type QQGroupFileInfo, type QQGroupFolderInfo, type QQGroupHonorInfo, type RawElement, type ReadyMusicElement, ReceiveLikeNotice, type ReceiveLikeOptions, type RecordElement, type RecordSegment, type Redis, type Render, type RenderResult, Renderer, type Renders, type Reply, type ReplyElement, type ReplySegment, type Request, RequestBase, type RequestEventMap, type RequestEventSub, type RequestOptions, type RequireFunction, type RequireFunctionSync, type RequireOptions, type Role, type RpsElement, type RpsSegment, type Scene, type ScreenshotClip, type ScreenshotOptions, type Segment, type SendElement, type SendForwardMessageResponse, type SendMessage, type SendMsgResults, type Sender, type SenderBase, type SenderGroup, type Sex, type ShakeSegment, type ShareElement, type ShareSegment, type SrcReply, type Task, type TextElement, type TextSegment, type UnregisterBot, type UserInfo, type VideoElement, type VideoSegment, type WaitForOptions, Watch, Watcher, type WeatherElement, type XmlElement, type XmlSegment, type YamlComment, YamlEditor, type YamlValue, absPath, adapter, app, applyComments, base64, buffer, buttonHandle, callRender, changelog, checkGitPluginUpdate, checkPkgUpdate, clearRequire, clearRequireFile, comment, index$1 as common, index as config, contact, contactDirect, contactFriend, contactGroup, contactGroupTemp, contactGuild, copyConfig, copyConfigSync, copyFiles, copyFilesSync, createLogger, createPluginDir, createRawMessage, karin as default, downFile, errorToString, exec, existToMkdir, existToMkdirSync, exists, existsSync, ffmpeg, ffplay, ffprobe, fs as file, fileToUrl, fileToUrlHandlerKey, filesByExt, formatTime$1 as formatTime, index$3 as fs, getAllBot, getAllBotID, getAllBotList, getBot, getBotCount, getCommit, getFiles, getHash, getPid, getPkgVersion, getPluginInfo, getRelPath, getRemotePkgVersion, getRender, getRenderCount, getRenderList, getRequestIp, getTime, handler$1 as handler, importModule, isClass, isDir, isDirSync, isDocker, isFile, isFileSync, isIPv4Loop, isIPv6Loop, isLinux, isLocalRequest, isLoopback, isMac, isPlugin, isRoot, isStatic, isSubPath, isWin, json$1 as json, karin, karinToQQBot, key, level, listen, lock, lockMethod, lockProp, log, logger, logs, makeForward, makeMessage, type messageType, mkdir, mkdirSync, parseChangelog, pkgRoot, qqbotToKarin, randomStr, range, read, readFile, readJson, readJsonSync, redis$1 as redis, registerBot, registerRender, render, renderHtml, renderMultiHtml, renderTpl, requireFile, requireFileSync, restart, restartDirect, rmSync, save, type screenshot, segment, sendMsg, sender, senderDirect, senderFriend, senderGroup, senderGroupTemp, senderGuild, sep, server, splitPath, stream, stringifyError, index$2 as system, unregisterBot, unregisterRender, updateAllGitPlugin, updateAllPkg, updateGitPlugin, updatePkg, uptime$1 as uptime, urlToPath, watch, watchAndMerge, write, writeJson, writeJsonSync, wss, yaml };