node-karin 1.10.12 → 1.10.13

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # 更新日志
 
+## [1.10.13](https://github.com/KarinJS/Karin/compare/core-v1.10.12...core-v1.10.13) (2025-06-30)
+
+
+### 🐛 Bug Fixes
+
+* close [#429](https://github.com/KarinJS/Karin/issues/429) ([bf28049](https://github.com/KarinJS/Karin/commit/bf280492827eb9c1f4208b9179f40998a9094012))
+
+
+### 📦️ Build System
+
+* fix types error ([05feb59](https://github.com/KarinJS/Karin/commit/05feb59aad90ebff0f31e4f0440f7a9dddf241fc))
+
 ## [1.10.12](https://github.com/KarinJS/Karin/compare/core-v1.10.11...core-v1.10.12) (2025-06-28)
 
 

package/dist/index.d.ts

@@ -1191,9 +1191,8 @@ interface AdapterType<T = any> {
      * 撤回消息
      * @param contact 目标信息
      * @param messageId 消息ID
-     * @returns 此接口的返回值不值得信任
      */
-    recallMsg(contact: Contact, messageId: string): Promise<boolean>;
+    recallMsg(contact: Contact, messageId: string): Promise<void>;
     /**
      * 获取头像url
      * @param userId 用户ID
@@ -1266,76 +1265,67 @@ interface AdapterType<T = any> {
      * @param messageId 群消息ID
      * @param create true为添加精华消息，false为删除精华消息 默认为true
      */
-    setGgroupHighlights(groupId: string, messageId: string, create: boolean): Promise<boolean>;
+    setGroupHighlights(groupId: string, messageId: string, create: boolean): Promise<void>;
     /**
      * 发送好友赞
      * @param targetId 目标ID
      * @param count 赞的次数，默认为10
-     * @returns 此接口的返回值不值得信任
      */
-    sendLike(targetId: string, count: number): Promise<boolean>;
+    sendLike(targetId: string, count: number): Promise<void>;
     /**
      * 群踢人
      * @param groupId 群ID
      * @param targetId 被踢出目标的ID 任选其一
      * @param rejectAddRequest 是否拒绝再次申请，默认为false
      * @param kickReason 踢出原因，可选
-     * @returns 此接口的返回值不值得信任
      */
-    groupKickMember(groupId: string, targetId: string, rejectAddRequest?: boolean, kickReason?: string): Promise<boolean>;
+    groupKickMember(groupId: string, targetId: string, rejectAddRequest?: boolean, kickReason?: string): Promise<void>;
     /**
      * 禁言群成员
      * @param groupId 群ID
      * @param targetId 被禁言目标的ID 任选其一
      * @param duration 禁言时长 单位:秒
-     * @returns 此接口的返回值不值得信任
      */
-    setGroupMute(groupId: string, targetId: string, duration: number): Promise<boolean>;
+    setGroupMute(groupId: string, targetId: string, duration: number): Promise<void>;
     /**
      * 群全员禁言
      * @param groupId 群ID
      * @param isBan 是否开启全员禁言
-     * @returns 此接口的返回值不值得信任
      */
-    setGroupAllMute(groupId: string, isBan: boolean): Promise<boolean>;
+    setGroupAllMute(groupId: string, isBan: boolean): Promise<void>;
     /**
      * 设置群管理员
      * @param groupId 群ID
      * @param targetId 目标用户的ID
      * @param isAdmin 是否设置为管理员
-     * @returns 此接口的返回值不值得信任
      */
-    setGroupAdmin(groupId: string, targetId: string, isAdmin: boolean): Promise<boolean>;
+    setGroupAdmin(groupId: string, targetId: string, isAdmin: boolean): Promise<void>;
     /**
      * 设置群名片
      * @param groupId 群ID
      * @param targetId 目标用户的ID
      * @param card 新的群名片
-     * @returns 此接口的返回值不值得信任
      */
-    setGroupMemberCard(groupId: string, targetId: string, card: string): Promise<boolean>;
+    setGroupMemberCard(groupId: string, targetId: string, card: string): Promise<void>;
     /**
      * 设置群名
      * @param groupId 群ID
      * @param groupName 新的群名
-     * @returns 此接口的返回值不值得信任
      */
-    setGroupName(groupId: string, groupName: string): Promise<boolean>;
+    setGroupName(groupId: string, groupName: string): Promise<void>;
     /**
      * 退出群组
      * @param groupId 群ID
      * @param isDismiss 如果Bot是群主，是否解散群
-     * @returns 此接口的返回值不值得信任
      */
-    setGroupQuit(groupId: string, isDismiss: boolean): Promise<boolean>;
+    setGroupQuit(groupId: string, isDismiss: boolean): Promise<void>;
     /**
      * 设置群专属头衔 仅群主可用
      * @param groupId 群ID
      * @param targetId 目标用户的ID
      * @param title 新的专属头衔
-     * @returns 此接口的返回值不值得信任
      */
-    setGroupMemberTitle(groupId: string, targetId: string, title: string): Promise<boolean>;
+    setGroupMemberTitle(groupId: string, targetId: string, title: string): Promise<void>;
     /**
      * 获取陌生人信息
      * @param targetId 用户ID 任选其一
@@ -1390,39 +1380,35 @@ interface AdapterType<T = any> {
      * @param remark 好友备注 同意时有效
      * @returns 设置结果
      */
-    setFriendApplyResult(requestId: string, isApprove: boolean, remark?: string): Promise<boolean>;
+    setFriendApplyResult(requestId: string, isApprove: boolean, remark?: string): Promise<void>;
     /**
      * 设置申请加入群请求结果
      * @param requestId 请求事件ID
      * @param isApprove 是否同意
      * @param denyReason 拒绝理由 拒绝时有效
-     * @returns 此接口的返回值不值得信任
      */
-    setGroupApplyResult(requestId: string, isApprove: boolean, denyReason?: string): Promise<boolean>;
+    setGroupApplyResult(requestId: string, isApprove: boolean, denyReason?: string): Promise<void>;
     /**
      * 设置邀请加入群请求结果
      * @param requestId 请求事件ID
      * @param isApprove 是否同意
-     * @returns 此接口的返回值不值得信任
      */
-    setInvitedJoinGroupResult(requestId: string, isApprove: boolean): Promise<boolean>;
+    setInvitedJoinGroupResult(requestId: string, isApprove: boolean): Promise<void>;
     /**
      * 设置消息表情回应
      * @param contact 目标信息
      * @param messageId 消息ID
      * @param faceId 表情ID
-     * @returns 此接口的返回值不值得信任
      */
-    setMsgReaction(contact: Contact, messageId: string, faceId: number, isSet: boolean): Promise<boolean>;
+    setMsgReaction(contact: Contact, messageId: string, faceId: number, isSet: boolean): Promise<void>;
     /**
      * 上传群文件、私聊文件
      * @param contact 目标信息
      * @param file 本地文件绝对路径
      * @param name 文件名称 必须提供
      * @param folder 父目录ID 不提供则上传到根目录 仅在群聊时有效
-     * @returns 此接口的返回值不值得信任
      */
-    uploadFile(contact: Contact, file: string, name: string, folder?: string): Promise<boolean>;
+    uploadFile(contact: Contact, file: string, name: string, folder?: string): Promise<void>;
     /**
      * 让协议端下载文件到协议端本地
      * @param options 下载文件的选项
@@ -1492,7 +1478,6 @@ interface AdapterType<T = any> {
      * 设置群备注
      * @param groupId 群号
      * @param remark 新的备注
-     * @returns 此接口的返回值不值得信任
      */
     setGroupRemark(groupId: string, remark: string): Promise<boolean>;
     /**
@@ -1516,7 +1501,6 @@ interface AdapterType<T = any> {
      * 戳一戳用户 支持群聊和私聊
      * @param contact 目标信息
      * @param count 戳一戳次数 默认为1
-     * @returns 此接口的返回值不值得信任
      */
     pokeUser(contact: Contact, count?: number): Promise<boolean>;
     /**
@@ -1545,7 +1529,7 @@ interface AdapterType<T = any> {
      * @param file base64:// file:// http(s)://
      * @returns 是否设置成功
      */
-    setAvatar(file: string): Promise<boolean>;
+    setAvatar(file: string): Promise<void>;
     /**
      * 获取群 Ai 语音可用声色列表
      * @returns 声色列表
@@ -3148,9 +3132,8 @@ declare abstract class AdapterBase<T = any> implements AdapterType<T> {
      * 撤回消息
      * @param _contact 目标信息
      * @param _messageId 消息ID
-     * @returns 此接口的返回值不值得信任
      */
-    recallMsg(_contact: Contact, _messageId: string): Promise<boolean>;
+    recallMsg(_contact: Contact, _messageId: string): Promise<void>;
     /**
      * 获取头像url
      * @param _userId 用户ID
@@ -3216,76 +3199,67 @@ declare abstract class AdapterBase<T = any> implements AdapterType<T> {
      * @param _messageId 群消息ID
      * @param _create true为添加精华消息，false为删除精华消息 默认为true
      */
-    setGgroupHighlights(_groupId: string, _messageId: string, _create: boolean): Promise<boolean>;
+    setGroupHighlights(_groupId: string, _messageId: string, _create: boolean): Promise<void>;
     /**
      * 发送好友赞
      * @param _targetId 目标ID
      * @param _count 赞的次数
-     * @returns 此接口的返回值不值得信任
      */
-    sendLike(_targetId: string, _count: number): Promise<boolean>;
+    sendLike(_targetId: string, _count: number): Promise<void>;
     /**
      * 群踢人
      * @param _groupId 群ID
      * @param _targetId 被踢出目标的ID 任选其一
      * @param _rejectAddRequest 是否拒绝再次申请，默认为false
      * @param _kickReason 踢出原因，可选
-     * @returns 此接口的返回值不值得信任
      */
-    groupKickMember(_groupId: string, _targetId: string, _rejectAddRequest?: boolean, _kickReason?: string): Promise<boolean>;
+    groupKickMember(_groupId: string, _targetId: string, _rejectAddRequest?: boolean, _kickReason?: string): Promise<void>;
     /**
      * 禁言群成员
      * @param _groupId 群ID
      * @param _targetId 被禁言目标的ID 任选其一
      * @param _duration 禁言时长 单位:秒
-     * @returns 此接口的返回值不值得信任
      */
-    setGroupMute(_groupId: string, _targetId: string, _duration: number): Promise<boolean>;
+    setGroupMute(_groupId: string, _targetId: string, _duration: number): Promise<void>;
     /**
      * 群全员禁言
      * @param _groupId 群ID
      * @param _isBan 是否开启全员禁言
-     * @returns 此接口的返回值不值得信任
      */
-    setGroupAllMute(_groupId: string, _isBan: boolean): Promise<boolean>;
+    setGroupAllMute(_groupId: string, _isBan: boolean): Promise<void>;
     /**
      * 设置群管理员
      * @param _groupId 群ID
      * @param _targetId 目标用户的ID
      * @param _isAdmin 是否设置为管理员
-     * @returns 此接口的返回值不值得信任
      */
-    setGroupAdmin(_groupId: string, _targetId: string, _isAdmin: boolean): Promise<boolean>;
+    setGroupAdmin(_groupId: string, _targetId: string, _isAdmin: boolean): Promise<void>;
     /**
      * 设置群名片
      * @param _groupId 群ID
      * @param _targetId 目标用户的ID
      * @param _card 新的群名片
-     * @returns 此接口的返回值不值得信任
      */
-    setGroupMemberCard(_groupId: string, _targetId: string, _card: string): Promise<boolean>;
+    setGroupMemberCard(_groupId: string, _targetId: string, _card: string): Promise<void>;
     /**
      * 设置群名
      * @param _groupId 群ID
      * @param _groupName 新的群名
-     * @returns 此接口的返回值不值得信任
      */
-    setGroupName(_groupId: string, _groupName: string): Promise<boolean>;
+    setGroupName(_groupId: string, _groupName: string): Promise<void>;
     /**
      * 退出群组
      * @param _groupId 群ID
      * @param _isDismiss 如果Bot是群主，是否解散群
-     * @returns 此接口的返回值不值得信任
      */
-    setGroupQuit(_groupId: string, _isDismiss: boolean): Promise<boolean>;
+    setGroupQuit(_groupId: string, _isDismiss: boolean): Promise<void>;
     /**
      * 设置群专属头衔 仅群主可用
      * @param _groupId 群ID
      * @param _targetId 目标用户的ID
      * @param _title 新的专属头衔
-     * @returns 此接口的返回值不值得信任
      */
-    setGroupMemberTitle(_groupId: string, _targetId: string, _title: string): Promise<boolean>;
+    setGroupMemberTitle(_groupId: string, _targetId: string, _title: string): Promise<void>;
     /**
      * 获取陌生人信息 此接口数据无法保证完全正确并且无法保证数据的完整性
      * @param _targetId 用户ID 任选其一
@@ -3339,41 +3313,36 @@ declare abstract class AdapterBase<T = any> implements AdapterType<T> {
      * @param _requestId 请求事件ID
      * @param _isApprove 是否同意
      * @param _remark 好友备注 同意时有效
-     * @returns 设置结果
      */
-    setFriendApplyResult(_requestId: string, _isApprove: boolean, _remark?: string): Promise<boolean>;
+    setFriendApplyResult(_requestId: string, _isApprove: boolean, _remark?: string): Promise<void>;
     /**
      * 设置申请加入群请求结果
      * @param _requestId 请求事件ID
      * @param _isApprove 是否同意
      * @param _denyReason 拒绝理由 拒绝时有效
-     * @returns 此接口的返回值不值得信任
      */
-    setGroupApplyResult(_requestId: string, _isApprove: boolean, _denyReason?: string): Promise<boolean>;
+    setGroupApplyResult(_requestId: string, _isApprove: boolean, _denyReason?: string): Promise<void>;
     /**
      * 设置邀请加入群请求结果
      * @param _requestId 请求事件ID
      * @param _isApprove 是否同意
-     * @returns 此接口的返回值不值得信任
      */
-    setInvitedJoinGroupResult(_requestId: string, _isApprove: boolean): Promise<boolean>;
+    setInvitedJoinGroupResult(_requestId: string, _isApprove: boolean): Promise<void>;
     /**
      * 设置消息表情回应
      * @param _contact 目标信息
      * @param _messageId 消息ID
      * @param _faceId 表情ID
-     * @returns 此接口的返回值不值得信任
      */
-    setMsgReaction(_contact: Contact, _messageId: string, _faceId: number, _isSet: boolean): Promise<boolean>;
+    setMsgReaction(_contact: Contact, _messageId: string, _faceId: number, _isSet: boolean): Promise<void>;
     /**
      * 上传群文件、私聊文件
      * @param _contact 目标信息
      * @param _file 本地文件绝对路径
      * @param _name 文件名称 必须提供
      * @param _folder 父目录ID 不提供则上传到根目录 仅在群聊时有效
-     * @returns 此接口的返回值不值得信任
      */
-    uploadFile(_contact: Contact, _file: string, _name: string, _folder?: string): Promise<boolean>;
+    uploadFile(_contact: Contact, _file: string, _name: string, _folder?: string): Promise<void>;
     /**
      * 让协议端下载文件到协议端本地
      * @param _options 下载文件的选项
@@ -3443,7 +3412,6 @@ declare abstract class AdapterBase<T = any> implements AdapterType<T> {
      * 设置群备注
      * @param _groupId 群号
      * @param _remark 新的备注
-     * @returns 此接口的返回值不值得信任
      */
     setGroupRemark(_groupId: string, _remark: string): Promise<boolean>;
     /**
@@ -3467,7 +3435,6 @@ declare abstract class AdapterBase<T = any> implements AdapterType<T> {
      * 戳一戳用户 支持群聊和私聊
      * @param _contact 目标信息
      * @param _count 戳一戳次数 默认为1
-     * @returns 此接口的返回值不值得信任
      */
     pokeUser(_contact: Contact, _count?: number): Promise<boolean>;
     /**
@@ -3494,9 +3461,8 @@ declare abstract class AdapterBase<T = any> implements AdapterType<T> {
     /**
      * 设置头像
      * @param file base64:// file:// http(s)://
-     * @returns 是否设置成功
      */
-    setAvatar(_file: string): Promise<boolean>;
+    setAvatar(_file: string): Promise<void>;
     /**
      * 获取 rkey
      * @returns rkey
@@ -11921,8 +11887,8 @@ interface OneBotMessageApi {
         params: {
             group_id: number;
             message_id: number;
-            emoji_id: string;
-            set: boolean;
+            code: string;
+            is_add: boolean;
         };
         response: null;
     };
@@ -14285,11 +14251,11 @@ declare abstract class OneBotCore extends EventEmitter$1 {
      * Lagrange扩展: 给消息添加表情回应
      * @param group_id - 群ID
      * @param message_id - 消息ID
-     * @param emoji_id - 表情ID
-     * @param set - 设置或取消
+     * @param code - 表情ID
+     * @param is_add - 是否为添加
      * @returns
      */
-    lgl_setGroupReaction(group_id: number, message_id: number, emoji_id: string, set: boolean): Promise<null>;
+    lgl_setGroupReaction(group_id: number, message_id: number, code: string, is_add: boolean): Promise<null>;
     /**
      * NapCat扩展: 给消息添加表情回应
      * @param message_id - 消息ID
@@ -15689,8 +15655,6 @@ type OneBotHttpClientOptions = {
     headers?: Record<string, string>;
     /** 最大重连次数 默认100次 */
     maxReconnectAttempts?: number;
-    /** 发送第一次心跳时间`(触发OPEN事件)` 默认200ms */
-    firstHeartbeatTimeout?: number;
 } & OneBotCore['_options'];
 /** http客户端内部配置 */
 type OneBotHttpClientInternalOptions = Required<Omit<OneBotHttpClientOptions, 'firstHeartbeatTimeout'>>;
@@ -16057,7 +16021,7 @@ declare class AdapterOneBot<T extends OneBotType> extends AdapterBase {
      * @param contact ob11无需提供contact参数
      * @param messageId 消息ID
      */
-    recallMsg(_: Contact, messageId: string): Promise<boolean>;
+    recallMsg(_: Contact, messageId: string): Promise<void>;
     /**
      * 获取消息
      * @param contact 联系人信息
@@ -16120,7 +16084,7 @@ declare class AdapterOneBot<T extends OneBotType> extends AdapterBase {
      * @param count 赞的次数
      * @returns 此接口的返回值不值得信任
      */
-    sendLike(targetId: string, count: number): Promise<boolean>;
+    sendLike(targetId: string, count: number): Promise<void>;
     /**
      * 群踢人
      * @param groupId 群ID
@@ -16129,7 +16093,7 @@ declare class AdapterOneBot<T extends OneBotType> extends AdapterBase {
      * @param kickReason 踢出原因，可选
      * @returns 此接口的返回值不值得信任
      */
-    groupKickMember(groupId: string, targetId: string, rejectAddRequest?: boolean, _?: string): Promise<boolean>;
+    groupKickMember(groupId: string, targetId: string, rejectAddRequest?: boolean, _?: string): Promise<void>;
     /**
      * 禁言群成员
      * @param groupId 群ID
@@ -16137,14 +16101,14 @@ declare class AdapterOneBot<T extends OneBotType> extends AdapterBase {
      * @param duration 禁言时长 单位:秒
      * @returns 此接口的返回值不值得信任
      */
-    setGroupMute(groupId: string, targetId: string, duration: number): Promise<boolean>;
+    setGroupMute(groupId: string, targetId: string, duration: number): Promise<void>;
     /**
      * 群全员禁言
      * @param groupId 群ID
      * @param isBan 是否开启全员禁言
      * @returns 此接口的返回值不值得信任
      */
-    setGroupAllMute(groupId: string, isBan: boolean): Promise<boolean>;
+    setGroupAllMute(groupId: string, isBan: boolean): Promise<void>;
     /**
      * 设置群管理员
      * @param groupId 群ID
@@ -16152,7 +16116,7 @@ declare class AdapterOneBot<T extends OneBotType> extends AdapterBase {
      * @param isAdmin 是否设置为管理员
      * @returns 此接口的返回值不值得信任
      */
-    setGroupAdmin(groupId: string, targetId: string, isAdmin: boolean): Promise<boolean>;
+    setGroupAdmin(groupId: string, targetId: string, isAdmin: boolean): Promise<void>;
     /**
      * 设置群名片
      * @param groupId 群ID
@@ -16160,21 +16124,21 @@ declare class AdapterOneBot<T extends OneBotType> extends AdapterBase {
      * @param card 新的群名片
      * @returns 此接口的返回值不值得信任
      */
-    setGroupMemberCard(groupId: string, targetId: string, card: string): Promise<boolean>;
+    setGroupMemberCard(groupId: string, targetId: string, card: string): Promise<void>;
     /**
      * 设置群名
      * @param groupId 群ID
      * @param groupName 新的群名
      * @returns 此接口的返回值不值得信任
      */
-    setGroupName(groupId: string, groupName: string): Promise<boolean>;
+    setGroupName(groupId: string, groupName: string): Promise<void>;
     /**
      * 退出群组
      * @param groupId 群ID
      * @param isDismiss 如果Bot是群主，是否解散群
      * @returns 此接口的返回值不值得信任
      */
-    setGroupQuit(groupId: string, isDismiss: boolean): Promise<boolean>;
+    setGroupQuit(groupId: string, isDismiss: boolean): Promise<void>;
     /**
      * 设置群专属头衔 仅群主可用
      * @param groupId 群ID
@@ -16182,7 +16146,7 @@ declare class AdapterOneBot<T extends OneBotType> extends AdapterBase {
      * @param title 新的专属头衔
      * @returns 此接口的返回值不值得信任
      */
-    setGroupMemberTitle(groupId: string, targetId: string, title: string): Promise<boolean>;
+    setGroupMemberTitle(groupId: string, targetId: string, title: string): Promise<void>;
     /**
      * 获取陌生人信息
      * @param targetId 用户ID 任选其一
@@ -16462,7 +16426,7 @@ declare class AdapterOneBot<T extends OneBotType> extends AdapterBase {
      * @param faceId 表情ID
      * @returns 此接口的返回值不值得信任
      */
-    setMsgReaction(contact: Contact, messageId: string, faceId: number, isSet: boolean): Promise<boolean>;
+    setMsgReaction(contact: Contact, messageId: string, faceId: number, isSet: boolean): Promise<void>;
     /**
      * 获取版本信息
      */
@@ -16502,14 +16466,14 @@ declare class AdapterOneBot<T extends OneBotType> extends AdapterBase {
      * @param folder 父目录ID 不提供则上传到根目录 仅在群聊时有效
      * @returns 此接口的返回值不值得信任
      */
-    uploadFile(contact: Contact, file: string, name: string, folder?: string): Promise<boolean>;
+    uploadFile(contact: Contact, file: string, name: string, folder?: string): Promise<void>;
     /**
      * 设置、取消群精华消息
      * @param groupId 群ID
      * @param messageId 群消息ID
      * @param create true为添加精华消息，false为删除精华消息 默认为true
      */
-    setGgroupHighlights(_: string, messageId: string, create: boolean): Promise<boolean>;
+    setGgroupHighlights(_: string, messageId: string, create: boolean): Promise<void>;
     PokeMember(_: string, __: string): Promise<void>;
     /**
      * 设置好友请求结果
@@ -16518,7 +16482,7 @@ declare class AdapterOneBot<T extends OneBotType> extends AdapterBase {
      * @param remark 好友备注 同意时有效
      * @returns 设置结果
      */
-    setFriendApplyResult(requestId: string, isApprove: boolean, remark?: string): Promise<boolean>;
+    setFriendApplyResult(requestId: string, isApprove: boolean, remark?: string): Promise<void>;
     /**
      * 设置申请加入群请求结果
      * @param requestId 请求事件ID
@@ -16526,14 +16490,14 @@ declare class AdapterOneBot<T extends OneBotType> extends AdapterBase {
      * @param denyReason 拒绝理由 拒绝时有效
      * @returns 此接口的返回值不值得信任
      */
-    setGroupApplyResult(requestId: string, isApprove: boolean, denyReason?: string): Promise<boolean>;
+    setGroupApplyResult(requestId: string, isApprove: boolean, denyReason?: string): Promise<void>;
     /**
      * 设置邀请加入群请求结果
      * @param requestId 请求事件ID
      * @param isApprove 是否同意
      * @returns 此接口的返回值不值得信任
      */
-    setInvitedJoinGroupResult(requestId: string, isApprove: boolean): Promise<boolean>;
+    setInvitedJoinGroupResult(requestId: string, isApprove: boolean): Promise<void>;
     /**
      * 合并转发 karin -> adapter
      * @param elements 消息元素
@@ -16634,7 +16598,7 @@ declare class AdapterOneBot<T extends OneBotType> extends AdapterBase {
      * @param file base64:// file:// http(s)://
      * @returns 是否设置成功
      */
-    setAvatar(file: string): Promise<boolean>;
+    setAvatar(file: string): Promise<void>;
     /**
      * 获取群 Ai 语音可用声色列表
      * @returns 声色列表

package/dist/index.mjs

@@ -2507,7 +2507,6 @@ var init_base = __esm({
        * 撤回消息
        * @param _contact 目标信息
        * @param _messageId 消息ID
-       * @returns 此接口的返回值不值得信任
        */
       recallMsg(_contact, _messageId) {
         throw new Error(this.#errMsg);
@@ -2583,14 +2582,13 @@ var init_base = __esm({
        * @param _messageId 群消息ID
        * @param _create true为添加精华消息，false为删除精华消息 默认为true
        */
-      setGgroupHighlights(_groupId, _messageId, _create) {
+      setGroupHighlights(_groupId, _messageId, _create) {
         throw new Error(this.#errMsg);
       }
       /**
        * 发送好友赞
        * @param _targetId 目标ID
        * @param _count 赞的次数
-       * @returns 此接口的返回值不值得信任
        */
       sendLike(_targetId, _count) {
         throw new Error(this.#errMsg);
@@ -2601,7 +2599,6 @@ var init_base = __esm({
        * @param _targetId 被踢出目标的ID 任选其一
        * @param _rejectAddRequest 是否拒绝再次申请，默认为false
        * @param _kickReason 踢出原因，可选
-       * @returns 此接口的返回值不值得信任
        */
       groupKickMember(_groupId, _targetId, _rejectAddRequest, _kickReason) {
         throw new Error(this.#errMsg);
@@ -2611,7 +2608,6 @@ var init_base = __esm({
        * @param _groupId 群ID
        * @param _targetId 被禁言目标的ID 任选其一
        * @param _duration 禁言时长 单位:秒
-       * @returns 此接口的返回值不值得信任
        */
       setGroupMute(_groupId, _targetId, _duration) {
         throw new Error(this.#errMsg);
@@ -2620,7 +2616,6 @@ var init_base = __esm({
        * 群全员禁言
        * @param _groupId 群ID
        * @param _isBan 是否开启全员禁言
-       * @returns 此接口的返回值不值得信任
        */
       setGroupAllMute(_groupId, _isBan) {
         throw new Error(this.#errMsg);
@@ -2630,7 +2625,6 @@ var init_base = __esm({
        * @param _groupId 群ID
        * @param _targetId 目标用户的ID
        * @param _isAdmin 是否设置为管理员
-       * @returns 此接口的返回值不值得信任
        */
       setGroupAdmin(_groupId, _targetId, _isAdmin) {
         throw new Error(this.#errMsg);
@@ -2640,7 +2634,6 @@ var init_base = __esm({
        * @param _groupId 群ID
        * @param _targetId 目标用户的ID
        * @param _card 新的群名片
-       * @returns 此接口的返回值不值得信任
        */
       setGroupMemberCard(_groupId, _targetId, _card) {
         throw new Error(this.#errMsg);
@@ -2649,7 +2642,6 @@ var init_base = __esm({
        * 设置群名
        * @param _groupId 群ID
        * @param _groupName 新的群名
-       * @returns 此接口的返回值不值得信任
        */
       setGroupName(_groupId, _groupName) {
         throw new Error(this.#errMsg);
@@ -2658,7 +2650,6 @@ var init_base = __esm({
        * 退出群组
        * @param _groupId 群ID
        * @param _isDismiss 如果Bot是群主，是否解散群
-       * @returns 此接口的返回值不值得信任
        */
       setGroupQuit(_groupId, _isDismiss) {
         throw new Error(this.#errMsg);
@@ -2668,7 +2659,6 @@ var init_base = __esm({
        * @param _groupId 群ID
        * @param _targetId 目标用户的ID
        * @param _title 新的专属头衔
-       * @returns 此接口的返回值不值得信任
        */
       setGroupMemberTitle(_groupId, _targetId, _title) {
         throw new Error(this.#errMsg);
@@ -2740,7 +2730,6 @@ var init_base = __esm({
        * @param _requestId 请求事件ID
        * @param _isApprove 是否同意
        * @param _remark 好友备注 同意时有效
-       * @returns 设置结果
        */
       setFriendApplyResult(_requestId, _isApprove, _remark) {
         throw new Error(this.#errMsg);
@@ -2750,7 +2739,6 @@ var init_base = __esm({
        * @param _requestId 请求事件ID
        * @param _isApprove 是否同意
        * @param _denyReason 拒绝理由 拒绝时有效
-       * @returns 此接口的返回值不值得信任
        */
       setGroupApplyResult(_requestId, _isApprove, _denyReason) {
         throw new Error(this.#errMsg);
@@ -2759,7 +2747,6 @@ var init_base = __esm({
        * 设置邀请加入群请求结果
        * @param _requestId 请求事件ID
        * @param _isApprove 是否同意
-       * @returns 此接口的返回值不值得信任
        */
       setInvitedJoinGroupResult(_requestId, _isApprove) {
         throw new Error(this.#errMsg);
@@ -2769,7 +2756,6 @@ var init_base = __esm({
        * @param _contact 目标信息
        * @param _messageId 消息ID
        * @param _faceId 表情ID
-       * @returns 此接口的返回值不值得信任
        */
       setMsgReaction(_contact, _messageId, _faceId, _isSet) {
         throw new Error(this.#errMsg);
@@ -2780,7 +2766,6 @@ var init_base = __esm({
        * @param _file 本地文件绝对路径
        * @param _name 文件名称 必须提供
        * @param _folder 父目录ID 不提供则上传到根目录 仅在群聊时有效
-       * @returns 此接口的返回值不值得信任
        */
       uploadFile(_contact, _file, _name, _folder) {
         throw new Error(this.#errMsg);
@@ -2872,7 +2857,6 @@ var init_base = __esm({
        * 设置群备注
        * @param _groupId 群号
        * @param _remark 新的备注
-       * @returns 此接口的返回值不值得信任
        */
       setGroupRemark(_groupId, _remark) {
         throw new Error(this.#errMsg);
@@ -2904,7 +2888,6 @@ var init_base = __esm({
        * 戳一戳用户 支持群聊和私聊
        * @param _contact 目标信息
        * @param _count 戳一戳次数 默认为1
-       * @returns 此接口的返回值不值得信任
        */
       pokeUser(_contact, _count) {
         throw new Error(this.#errMsg);
@@ -2932,7 +2915,6 @@ var init_base = __esm({
       /**
        * 设置头像
        * @param file base64:// file:// http(s)://
-       * @returns 是否设置成功
        */
       setAvatar(_file) {
         throw new Error(this.#errMsg);
@@ -3345,12 +3327,14 @@ var init_dist2 = __esm({
        * 格式化Api返回错误
        */
       _formatApiError(action, params, error) {
-        return new Error([
-          `[${this.self_id}][sendApi] \u8BF7\u6C42\u9519\u8BEF:`,
-          `  action: ${action}`,
-          `  params: ${this._formatBase64(params)}`,
-          `  error: ${error}`
-        ].join("\n"));
+        return new Error(
+          [
+            `[${this.self_id}][sendApi] \u8BF7\u6C42\u9519\u8BEF:`,
+            `  action: ${action}`,
+            `  params: ${this._formatBase64(params)}`
+          ].join("\n"),
+          { cause: error }
+        );
       }
       /**
        * 初始化Bot基本信息
@@ -3835,16 +3819,16 @@ var init_dist2 = __esm({
        * Lagrange扩展: 给消息添加表情回应
        * @param group_id - 群ID
        * @param message_id - 消息ID
-       * @param emoji_id - 表情ID
-       * @param set - 设置或取消
+       * @param code - 表情ID
+       * @param is_add - 是否为添加
        * @returns
        */
-      async lgl_setGroupReaction(group_id, message_id, emoji_id, set) {
+      async lgl_setGroupReaction(group_id, message_id, code, is_add) {
         return this.sendApi("set_group_reaction", {
           group_id,
           message_id,
-          emoji_id,
-          set
+          code,
+          is_add
         });
       }
       /**
@@ -5705,8 +5689,6 @@ var init_dist2 = __esm({
         super(options);
         this._options = this.getOptions(options);
         this.self.id = options.self_id;
-        const firstHeartbeatTimeout = options.firstHeartbeatTimeout || 200;
-        setTimeout(() => this._sendFirstHeartbeat(), firstHeartbeatTimeout);
       }
       /**
        * 发送第一次心跳
@@ -5719,11 +5701,6 @@ var init_dist2 = __esm({
             error: new Error(`\u53D1\u9001\u7B2C\u4E00\u6B21\u5FC3\u8DF3\u5931\u8D25: \u8BF7\u68C0\u67E5\u76EE\u6807\u5730\u5740\u662F\u5426\u53EF\u8BBF\u95EE: ${this._options.httpHost}`, { cause: error })
           });
         }
-        this._initialized = true;
-        this.emit(
-          "open"
-          /* OPEN */
-        );
       }
       /**
        * 获取格式化后的配置
@@ -5842,12 +5819,11 @@ var init_dist2 = __esm({
        * 初始化
        */
       async init() {
-        if (this._initialized) {
-          return;
-        }
-        this._startHeartbeat();
+        if (this._initialized) return;
+        await this._sendFirstHeartbeat();
         await this._initBotInfo();
         this._initialized = true;
+        this._startHeartbeat();
         this.emit(
           "open"
           /* OPEN */
@@ -5926,7 +5902,6 @@ var init_dist2 = __esm({
        */
       async reconnect() {
         this._initialized = false;
-        await this._sendFirstHeartbeat();
         await this.init();
       }
     };
@@ -17776,7 +17751,7 @@ var init_core = __esm({
        * 注册机器人
        */
       registerBot() {
-        logger.bot("info", this.selfId, `[onebot11][${this.adapter.communication}] \u8FDE\u63A5\u6210\u529F: ${this.adapter.address}`);
+        logger.bot("info", this.selfId, `[OneBot][${this.adapter.communication}] \u8FDE\u63A5\u6210\u529F: ${this.adapter.address}`);
         this.adapter.index = registerBot(this.adapter.communication, this);
       }
       /**
@@ -17945,12 +17920,7 @@ var init_core = __esm({
        * @param messageId 消息ID
        */
       async recallMsg(_, messageId) {
-        try {
-          await this._onebot.deleteMsg(Number(messageId));
-          return true;
-        } catch {
-          return false;
-        }
+        await this._onebot.deleteMsg(Number(messageId));
       }
       /**
        * 获取消息
@@ -18073,12 +18043,7 @@ var init_core = __esm({
        * @returns 此接口的返回值不值得信任
        */
       async sendLike(targetId, count3) {
-        try {
-          await this._onebot.sendLike(Number(targetId), count3);
-          return true;
-        } catch {
-          return false;
-        }
+        await this._onebot.sendLike(Number(targetId), count3);
       }
       /**
        * 群踢人
@@ -18089,12 +18054,7 @@ var init_core = __esm({
        * @returns 此接口的返回值不值得信任
        */
       async groupKickMember(groupId, targetId, rejectAddRequest, _) {
-        try {
-          await this._onebot.setGroupKick(Number(groupId), Number(targetId), rejectAddRequest);
-          return true;
-        } catch {
-          return false;
-        }
+        await this._onebot.setGroupKick(Number(groupId), Number(targetId), rejectAddRequest);
       }
       /**
        * 禁言群成员
@@ -18104,12 +18064,7 @@ var init_core = __esm({
        * @returns 此接口的返回值不值得信任
        */
       async setGroupMute(groupId, targetId, duration) {
-        try {
-          await this._onebot.setGroupBan(Number(groupId), Number(targetId), duration);
-          return true;
-        } catch {
-          return false;
-        }
+        await this._onebot.setGroupBan(Number(groupId), Number(targetId), duration);
       }
       /**
        * 群全员禁言
@@ -18118,12 +18073,7 @@ var init_core = __esm({
        * @returns 此接口的返回值不值得信任
        */
       async setGroupAllMute(groupId, isBan) {
-        try {
-          await this._onebot.setGroupWholeBan(Number(groupId), isBan);
-          return true;
-        } catch {
-          return false;
-        }
+        await this._onebot.setGroupWholeBan(Number(groupId), isBan);
       }
       /**
        * 设置群管理员
@@ -18133,12 +18083,7 @@ var init_core = __esm({
        * @returns 此接口的返回值不值得信任
        */
       async setGroupAdmin(groupId, targetId, isAdmin) {
-        try {
-          await this._onebot.setGroupAdmin(Number(groupId), Number(targetId), isAdmin);
-          return true;
-        } catch {
-          return false;
-        }
+        await this._onebot.setGroupAdmin(Number(groupId), Number(targetId), isAdmin);
       }
       /**
        * 设置群名片
@@ -18148,12 +18093,7 @@ var init_core = __esm({
        * @returns 此接口的返回值不值得信任
        */
       async setGroupMemberCard(groupId, targetId, card) {
-        try {
-          await this._onebot.setGroupCard(Number(groupId), Number(targetId), card);
-          return true;
-        } catch {
-          return false;
-        }
+        await this._onebot.setGroupCard(Number(groupId), Number(targetId), card);
       }
       /**
        * 设置群名
@@ -18162,12 +18102,7 @@ var init_core = __esm({
        * @returns 此接口的返回值不值得信任
        */
       async setGroupName(groupId, groupName) {
-        try {
-          await this._onebot.setGroupName(Number(groupId), groupName);
-          return true;
-        } catch {
-          return false;
-        }
+        await this._onebot.setGroupName(Number(groupId), groupName);
       }
       /**
        * 退出群组
@@ -18176,12 +18111,7 @@ var init_core = __esm({
        * @returns 此接口的返回值不值得信任
        */
       async setGroupQuit(groupId, isDismiss) {
-        try {
-          await this._onebot.setGroupLeave(Number(groupId), isDismiss);
-          return true;
-        } catch {
-          return false;
-        }
+        await this._onebot.setGroupLeave(Number(groupId), isDismiss);
       }
       /**
        * 设置群专属头衔 仅群主可用
@@ -18191,12 +18121,7 @@ var init_core = __esm({
        * @returns 此接口的返回值不值得信任
        */
       async setGroupMemberTitle(groupId, targetId, title) {
-        try {
-          await this._onebot.setGroupSpecialTitle(Number(groupId), Number(targetId), title);
-          return true;
-        } catch {
-          return false;
-        }
+        await this._onebot.setGroupSpecialTitle(Number(groupId), Number(targetId), title);
       }
       /**
        * 获取陌生人信息
@@ -18531,19 +18456,15 @@ var init_core = __esm({
        * @returns 此接口的返回值不值得信任
        */
       async setMsgReaction(contact3, messageId, faceId, isSet) {
-        try {
-          if (this.adapter.name === "Lagrange.OneBot") {
-            await this._onebot.lgl_setGroupReaction(+contact3.peer, +messageId, faceId + "", isSet);
-            return true;
-          }
-          if (this.adapter.name === "NapCat.OneBot") {
-            await this._onebot.nc_setMsgEmojiLike(+messageId, faceId + "", isSet);
-            return true;
-          }
-          throw new Error(`${this.adapter.name} \u4E0D\u652F\u6301\u8BBE\u7F6E\u6D88\u606F\u8868\u60C5\u56DE\u5E94`);
-        } catch {
-          return false;
+        if (this.adapter.name === "Lagrange.OneBot") {
+          await this._onebot.lgl_setGroupReaction(+contact3.peer, +messageId, faceId + "", isSet);
+          return;
         }
+        if (this.adapter.name === "NapCat.OneBot") {
+          await this._onebot.nc_setMsgEmojiLike(+messageId, faceId + "", isSet);
+          return;
+        }
+        throw new Error(`${this.adapter.name} \u4E0D\u652F\u6301\u8BBE\u7F6E\u6D88\u606F\u8868\u60C5\u56DE\u5E94`);
       }
       /**
        * 获取版本信息
@@ -18628,16 +18549,11 @@ var init_core = __esm({
        * @returns 此接口的返回值不值得信任
        */
       async uploadFile(contact3, file2, name, folder) {
-        try {
-          if (contact3.scene === "group") {
-            await this._onebot.uploadGroupFile(+contact3.peer, file2, name, folder);
-          } else {
-            await this._onebot.uploadPrivateFile(+contact3.peer, file2, name);
-          }
-          return true;
-        } catch {
-          return false;
+        if (contact3.scene === "group") {
+          await this._onebot.uploadGroupFile(+contact3.peer, file2, name, folder);
+          return;
         }
+        await this._onebot.uploadPrivateFile(+contact3.peer, file2, name);
       }
       /**
        * 设置、取消群精华消息
@@ -18646,15 +18562,10 @@ var init_core = __esm({
        * @param create true为添加精华消息，false为删除精华消息 默认为true
        */
       async setGgroupHighlights(_, messageId, create2) {
-        try {
-          if (create2) {
-            await this._onebot.setEssenceMsg(+messageId);
-          } else {
-            await this._onebot.deleteEssenceMsg(+messageId);
-          }
-          return true;
-        } catch {
-          return false;
+        if (create2) {
+          await this._onebot.setEssenceMsg(+messageId);
+        } else {
+          await this._onebot.deleteEssenceMsg(+messageId);
         }
       }
       async PokeMember(_, __) {
@@ -18668,12 +18579,7 @@ var init_core = __esm({
        * @returns 设置结果
        */
       async setFriendApplyResult(requestId, isApprove, remark) {
-        try {
-          await this._onebot.setFriendAddRequest(requestId, isApprove, remark);
-          return true;
-        } catch {
-          return false;
-        }
+        await this._onebot.setFriendAddRequest(requestId, isApprove, remark);
       }
       /**
        * 设置申请加入群请求结果
@@ -18683,12 +18589,7 @@ var init_core = __esm({
        * @returns 此接口的返回值不值得信任
        */
       async setGroupApplyResult(requestId, isApprove, denyReason) {
-        try {
-          await this._onebot.setGroupAddRequest(requestId, "add", isApprove, denyReason);
-          return true;
-        } catch {
-          return false;
-        }
+        await this._onebot.setGroupAddRequest(requestId, "add", isApprove, denyReason);
       }
       /**
        * 设置邀请加入群请求结果
@@ -18697,12 +18598,7 @@ var init_core = __esm({
        * @returns 此接口的返回值不值得信任
        */
       async setInvitedJoinGroupResult(requestId, isApprove) {
-        try {
-          await this._onebot.setGroupAddRequest(requestId, "invite", isApprove);
-          return true;
-        } catch {
-          return false;
-        }
+        await this._onebot.setGroupAddRequest(requestId, "invite", isApprove);
       }
       /**
        * 合并转发 karin -> adapter
@@ -18866,12 +18762,7 @@ var init_core = __esm({
        * @returns 是否设置成功
        */
       async setAvatar(file2) {
-        try {
-          await this._onebot.setQqAvatar(file2);
-          return true;
-        } catch {
-          return false;
-        }
+        await this._onebot.setQqAvatar(file2);
       }
       /**
        * 获取群 Ai 语音可用声色列表
@@ -18997,8 +18888,6 @@ var init_create2 = __esm({
       adapter3.account.selfId = options.self_id;
       adapter3.adapter.communication = "http";
       onebot.on(OneBotEventKey.OPEN, async () => {
-        logger.info(`[OneBot] \u5FC3\u8DF3\u6210\u529F: ${options.url}`);
-        await adapter3.init();
         adapter3.registerBot();
       });
       onebot.on(OneBotEventKey.CLOSE, async (type) => {
@@ -19024,6 +18913,7 @@ var init_create2 = __esm({
         return logger.error(new Error(`${loggerPrefix} \u53D1\u751F\u9519\u8BEF:`, { cause: args.error }));
       });
       cacheMap.http.set(options.self_id, adapter3);
+      await adapter3.init();
       return adapter3;
     };
     disconnectAllOneBotServer = () => {
@@ -26726,43 +26616,33 @@ var init_input = __esm({
       }
       async recallMsg(_, messageId) {
         logger.info(`[recallMsg] ${messageId}`);
-        return true;
       }
       async sendLike(targetId, count3) {
         logger.info(`[sendLike] ${targetId} ${count3}`);
-        return true;
       }
       async groupKickMember(groupId, targetId, rejectAddRequest, kickReason) {
         logger.info(`[groupKickMember] ${groupId} ${targetId} ${rejectAddRequest} ${kickReason}`);
-        return true;
       }
       async setGroupMute(groupId, targetId, duration) {
         logger.info(`[setGroupMute] ${groupId} ${targetId} ${duration}`);
-        return true;
       }
       async setGroupAllMute(groupId, isBan) {
         logger.info(`[setGroupAllMute] ${groupId} ${isBan}`);
-        return true;
       }
       async setGroupAdmin(groupId, targetId, isAdmin) {
         logger.info(`[setGroupAdmin] ${groupId} ${targetId} ${isAdmin}`);
-        return true;
       }
       async setGroupMemberCard(groupId, targetId, card) {
         logger.info(`[setGroupMemberCard] ${groupId} ${targetId} ${card}`);
-        return true;
       }
       async setGroupName(groupId, groupName) {
         logger.info(`[setGroupName] ${groupId} ${groupName}`);
-        return true;
       }
       async setGroupQuit(groupId, isDismiss) {
         logger.info(`[setGroupQuit] ${groupId} ${isDismiss}`);
-        return true;
       }
       async setGroupMemberTitle(groupId, targetId, title) {
         logger.info(`[setGroupMemberTitle] ${groupId} ${targetId} ${title}`);
-        return true;
       }
       async getFriendList(refresh) {
         logger.info(`[getFriendList] ${refresh}`);
@@ -26782,23 +26662,18 @@ var init_input = __esm({
       }
       async setFriendApplyResult(requestId, isApprove, remark) {
         logger.info(`[setFriendApplyResult] ${requestId} ${isApprove} ${remark}`);
-        return true;
       }
       async setGroupApplyResult(requestId, isApprove, denyReason) {
         logger.info(`[setGroupApplyResult] ${requestId} ${isApprove} ${denyReason}`);
-        return true;
       }
       async setInvitedJoinGroupResult(requestId, isApprove) {
         logger.info(`[setInvitedJoinGroupResult] ${requestId} ${isApprove}`);
-        return true;
       }
       async setMsgReaction(contact3, messageId, faceId, isSet) {
         logger.info(`[setMsgReaction] ${contact3} ${messageId} ${faceId} ${isSet}`);
-        return true;
       }
       async uploadFile(contact3, file2, name, folder) {
         logger.info(`[uploadFile] ${contact3} ${file2} ${name} ${folder}`);
-        return true;
       }
     };
     adapter2 = new AdapterConsole();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-karin",
-  "version": "1.10.12",
+  "version": "1.10.13",
   "description": "Lightweight, efficient, concise, and stable robot framework.",
   "keywords": [
     "node",