hotcat-bot-qq 0.1.4 → 0.1.6

package/dist/botConsole.d.ts

@@ -13,7 +13,7 @@ export type NoticeEvent = Record<string, any> & {
     sub_type?: string;
 };
 /** BotConsole 日志分类 */
-export type BotConsoleType = 'system' | 'groupMessage' | 'privateMessage' | 'error' | 'sendGroupMessage' | 'sendPrivateMessage' | 'groupMessageSelf' | 'privateMessageSelf' | 'requestFriend' | 'requestGroupAdd' | 'requestGroupInvite' | 'notice';
+export type BotConsoleType = 'system' | 'groupMessage' | 'privateMessage' | 'error' | 'sendGroupMessage' | 'sendPrivateMessage' | 'groupMessageSelf' | 'privateMessageSelf' | 'requestFriend' | 'requestGroupAdd' | 'requestGroupInvite' | 'notice' | 'plugin';
 /** ANSI 颜色/样式码 */
 export declare const colors: {
     reset: string;
@@ -66,7 +66,13 @@ export declare const formatMessage: (m: Message) => string;
  */
 export declare class BotConsole {
     type: BotConsoleType;
-    content: string | GroupMessage | GroupMessageSelf | PrivateMessage | PrivateMessageSelf | Message[] | RequestFriend | RequestGroupAdd | RequestGroupInvite | NoticeEvent;
-    constructor(type: BotConsoleType, content: string | GroupMessage | GroupMessageSelf | PrivateMessage | PrivateMessageSelf | Message[] | RequestFriend | RequestGroupAdd | RequestGroupInvite | NoticeEvent);
+    content: string | GroupMessage | GroupMessageSelf | PrivateMessage | PrivateMessageSelf | Message[] | RequestFriend | RequestGroupAdd | RequestGroupInvite | NoticeEvent | {
+        name: string;
+        msg: string;
+    };
+    constructor(type: BotConsoleType, content: string | GroupMessage | GroupMessageSelf | PrivateMessage | PrivateMessageSelf | Message[] | RequestFriend | RequestGroupAdd | RequestGroupInvite | NoticeEvent | {
+        name: string;
+        msg: string;
+    });
     log(): void;
 }

package/dist/botConsole.js

@@ -293,5 +293,9 @@ export class BotConsole {
                 ('name_new' in event ? `${colors.green}${sanitize(event.name_new)}${colors.reset}` : '') +
                 ('file' in event ? `文件:${event.file.name}` : ''));
         }
+        else if (this.type === 'plugin') {
+            const { name, msg } = this.content;
+            console.log(`${colors.magenta}[plugin:${name}]:${colors.reset} ${msg}`);
+        }
     }
 }

package/dist/botEvent.d.ts

@@ -3,176 +3,101 @@ import { PrivateMessage, PrivateMessageSelf, RequestGroup } from './botConsole';
 import type { BotClient } from './botClient';
 import type { BotApi } from './botApi';
 /**
- * 当接收到消息时触发的事件。
- *
- * @example
- * ```ts
- * bot.event.message.onGroupMessage(async (bot, event) => {
- *     await bot.api.sendGroupMessage(event.group_id, Message.text('收到'));
- * });
- * ```
+ * 接收到的事件处理（别人发的消息）。
  */
 export declare class MessageEvent {
     private napcat;
     private client;
+    private wrappers;
     constructor(napcat: NCWebsocket, client: BotClient);
-    /**
-     * 注册群消息事件回调
-     * @param fn - 回调 `(bot, event) => any`
-     */
     onGroupMessage(fn: (bot: BotClient, event: GroupMessage) => any): void;
-    /**
-     * 注册群消息普通事件回调
-     * @param fn - 回调 `(bot, event) => any`
-     */
+    offGroupMessage(fn: Function): void;
     onGroupNormal(fn: (bot: BotClient, event: GroupMessage) => any): void;
-    /**
-     * 注册私聊消息事件回调
-     * @param fn - 回调 `(bot, event) => any`
-     */
+    offGroupNormal(fn: Function): void;
     onPrivateMessage(fn: (bot: BotClient, event: PrivateMessage) => any): void;
-    /**
-     * 注册私聊消息好友事件回调
-     * @param fn - 回调 `(bot, event) => any`
-     */
+    offPrivateMessage(fn: Function): void;
     onPrivateFriend(fn: (bot: BotClient, event: PrivateMessage) => any): void;
-    /**
-     * 注册私聊消息群临时事件回调
-     * @param fn - 回调 `(bot, event) => any`
-     */
+    offPrivateFriend(fn: Function): void;
     onPrivateGroup(fn: (bot: BotClient, event: PrivateMessage) => any): void;
+    offPrivateGroup(fn: Function): void;
 }
 /**
- * 当 bot 自身发出消息后的事件。
- *
- * @example
- * ```ts
- * bot.event.messageSent.onGroupSent(async (bot, event) => {
- *     console.log('群消息已发送:', event.message_id);
- * });
- * ```
+ * bot 自身发出的消息事件（发送成功后的回执）。
  */
 export declare class MessageSent {
     private napcat;
     private client;
+    private wrappers;
     constructor(napcat: NCWebsocket, client: BotClient);
-    /**
-     * 注册群消息发送回执
-     * @param fn - 回调 `(bot, event) => any`
-     */
     onGroupSent(fn: (bot: BotClient, event: GroupMessageSelf) => any): void;
-    /**
-     * 注册群消息发送回执（仅普通消息）
-     * @param fn - 回调 `(bot, event) => any`
-     */
+    offGroupSent(fn: Function): void;
     onGroupNormal(fn: (bot: BotClient, event: GroupMessageSelf) => any): void;
-    /**
-     * 注册私聊消息发送回执
-     * @param fn - 回调 `(bot, event) => any`
-     */
+    offGroupNormal(fn: Function): void;
     onPrivateSent(fn: (bot: BotClient, event: PrivateMessageSelf) => any): void;
-    /**
-     * 注册私聊好友消息发送回执
-     * @param fn - 回调 `(bot, event) => any`
-     */
+    offPrivateSent(fn: Function): void;
     onPrivateFriend(fn: (bot: BotClient, event: PrivateFriendMessageSelf) => any): void;
-    /**
-     * 注册私聊群临时消息发送回执
-     * @param fn - 回调 `(bot, event) => any`
-     */
+    offPrivateFriend(fn: Function): void;
     onPrivateGroup(fn: (bot: BotClient, event: PrivateGroupMessageSelf) => any): void;
+    offPrivateGroup(fn: Function): void;
 }
 /**
  * 请求事件监听（加好友、加群、邀请入群）。
- *
- * @example
- * ```ts
- * bot.event.request.onFriend(async (bot, event) => {
- *     await bot.api.handleFriendAddRequest(event.flag, true);
- * });
- * ```
  */
 export declare class RequestEvent {
     private napcat;
     private client;
+    private wrappers;
     constructor(napcat: NCWebsocket, client: BotClient);
-    /**
-     * 注册加好友请求回调
-     * @param fn - 回调 `(bot, event) => any`，event.flag 可传给 handleFriendAddRequest
-     */
     onFriend(fn: (bot: BotClient, event: RequestFriend) => any): void;
-    /**
-     * 注册加群请求回调
-     * @param fn - 回调 `(bot, event) => any`，event.flag 可传给 handleGroupAddRequest
-     */
+    offFriend(fn: Function): void;
     onGroupAdd(fn: (bot: BotClient, event: RequestGroupAdd) => any): void;
-    /**
-     * 注册邀请入群回调
-     * @param fn - 回调 `(bot, event) => any`
-     */
+    offGroupAdd(fn: Function): void;
     onGroupInvite(fn: (bot: BotClient, event: RequestGroupInvite) => any): void;
-    /**
-     * 注册所有群请求回调（加群 + 邀请）
-     * @param fn - 回调 `(bot, event) => any`
-     */
+    offGroupInvite(fn: Function): void;
     onGroupRequest(fn: (bot: BotClient, event: RequestGroup) => any): void;
+    offGroupRequest(fn: Function): void;
 }
 /**
  * 通知事件监听（好友添加、群成员变动、禁言、撤回等）。
- *
- * @example
- * ```ts
- * bot.event.notice.onFriendAdd(async (bot, event) => { ... });
- * bot.event.notice.onGroupIncrease(async (bot, event) => { ... });
- * ```
  */
 export declare class NoticeEvent {
     private napcat;
     private client;
+    private wrappers;
     constructor(napcat: NCWebsocket, client: BotClient);
-    /** 好友添加 */
     onFriendAdd(fn: (bot: BotClient, event: FriendAdd) => any): void;
-    /** 私聊消息撤回 */
+    offFriendAdd(fn: Function): void;
     onFriendRecall(fn: (bot: BotClient, event: FriendRecall) => any): void;
-    /** 群管理员变动（设置/取消） */
+    offFriendRecall(fn: Function): void;
     onGroupAdmin(fn: (bot: BotClient, event: GroupAdminSet | GroupAdminUnset) => any): void;
-    /** 群禁言变动（禁言/解除） */
+    offGroupAdmin(fn: Function): void;
     onGroupBan(fn: (bot: BotClient, event: GroupBanBan | GroupBanLiftBan) => any): void;
-    /** 群名片变更 */
+    offGroupBan(fn: Function): void;
     onGroupCard(fn: (bot: BotClient, event: GroupCard) => any): void;
-    /** 群成员减少（退群/被踢/bot被踢） */
+    offGroupCard(fn: Function): void;
     onGroupDecrease(fn: (bot: BotClient, event: GroupDecreaseLeave | GroupDecreaseKick | GroupDecreaseKickMe) => any): void;
-    /** 群成员增加（审批/邀请） */
+    offGroupDecrease(fn: Function): void;
     onGroupIncrease(fn: (bot: BotClient, event: GroupIncreaseApprove | GroupIncreaseInvite) => any): void;
-    /** 群消息撤回 */
+    offGroupIncrease(fn: Function): void;
     onGroupRecall(fn: (bot: BotClient, event: GroupRecall) => any): void;
-    /** 群文件上传 */
+    offGroupRecall(fn: Function): void;
     onGroupUpload(fn: (bot: BotClient, event: GroupUpload) => any): void;
-    /** 群表情回应 */
+    offGroupUpload(fn: Function): void;
     onGroupEmojiLike(fn: (bot: BotClient, event: GroupMsgEmojiLike) => any): void;
-    /** 群设精（添加/删除） */
+    offGroupEmojiLike(fn: Function): void;
     onGroupEssence(fn: (bot: BotClient, event: GroupEssenceAdd | GroupEssenceDelete) => any): void;
-    /** 戳一戳（好友/群） */
+    offGroupEssence(fn: Function): void;
     onPoke(fn: (bot: BotClient, event: NotifyPokeFriend | NotifyPokeGroup) => any): void;
-    /** 群名称变更 */
+    offPoke(fn: Function): void;
     onGroupNameChange(fn: (bot: BotClient, event: NotifyGroupName) => any): void;
-    /** 群头衔变更 */
+    offGroupNameChange(fn: Function): void;
     onTitleChange(fn: (bot: BotClient, event: NotifyTitle) => any): void;
-    /** 个人资料点赞 */
+    offTitleChange(fn: Function): void;
     onProfileLike(fn: (bot: BotClient, event: NotifyProfileLike) => any): void;
-    /** bot 离线 */
+    offProfileLike(fn: Function): void;
     onBotOffline(fn: (bot: BotClient, event: BotOffline) => any): void;
+    offBotOffline(fn: Function): void;
 }
-/**
- * 事件监听入口，按类别分组暴露监听器。
- *
- * @example
- * ```ts
- * bot.event.message.onGroupMessage(...);
- * bot.event.messageSent.onGroupSent(...);
- * bot.event.request.onFriend(...);
- * ```
- */
 export declare class BotEvent {
     message: MessageEvent;
     messageSent: MessageSent;

package/dist/botEvent.js

@@ -1,13 +1,6 @@
 import { BotConsole } from './botConsole';
 /**
- * 当接收到消息时触发的事件。
- *
- * @example
- * ```ts
- * bot.event.message.onGroupMessage(async (bot, event) => {
- *     await bot.api.sendGroupMessage(event.group_id, Message.text('收到'));
- * });
- * ```
+ * 接收到的事件处理（别人发的消息）。
  */
 export class MessageEvent {
     constructor(napcat, client) {
@@ -23,15 +16,17 @@ export class MessageEvent {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "wrappers", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
         this.napcat = napcat;
         this.client = client;
     }
-    /**
-     * 注册群消息事件回调
-     * @param fn - 回调 `(bot, event) => any`
-     */
     onGroupMessage(fn) {
-        this.napcat.on('message.group', async (event) => {
+        const w = async (event) => {
             try {
                 new BotConsole('groupMessage', event).log();
                 await fn(this.client, event);
@@ -39,14 +34,19 @@ export class MessageEvent {
             catch (e) {
                 new BotConsole('error', e instanceof Error ? e.message : JSON.stringify(e)).log();
             }
-        });
+        };
+        this.wrappers.set(fn, w);
+        this.napcat.on('message.group', w);
+    }
+    offGroupMessage(fn) {
+        const w = this.wrappers.get(fn);
+        if (w) {
+            this.napcat.off('message.group', w);
+            this.wrappers.delete(fn);
+        }
     }
-    /**
-     * 注册群消息普通事件回调
-     * @param fn - 回调 `(bot, event) => any`
-     */
     onGroupNormal(fn) {
-        this.napcat.on('message.group.normal', async (event) => {
+        const w = async (event) => {
             try {
                 new BotConsole('groupMessage', event).log();
                 await fn(this.client, event);
@@ -54,14 +54,19 @@ export class MessageEvent {
             catch (e) {
                 new BotConsole('error', e instanceof Error ? e.message : JSON.stringify(e)).log();
             }
-        });
+        };
+        this.wrappers.set(fn, w);
+        this.napcat.on('message.group.normal', w);
+    }
+    offGroupNormal(fn) {
+        const w = this.wrappers.get(fn);
+        if (w) {
+            this.napcat.off('message.group.normal', w);
+            this.wrappers.delete(fn);
+        }
     }
-    /**
-     * 注册私聊消息事件回调
-     * @param fn - 回调 `(bot, event) => any`
-     */
     onPrivateMessage(fn) {
-        this.napcat.on('message.private', async (event) => {
+        const w = async (event) => {
             try {
                 new BotConsole('privateMessage', event).log();
                 await fn(this.client, event);
@@ -69,14 +74,19 @@ export class MessageEvent {
             catch (e) {
                 new BotConsole('error', e instanceof Error ? e.message : JSON.stringify(e)).log();
             }
-        });
+        };
+        this.wrappers.set(fn, w);
+        this.napcat.on('message.private', w);
+    }
+    offPrivateMessage(fn) {
+        const w = this.wrappers.get(fn);
+        if (w) {
+            this.napcat.off('message.private', w);
+            this.wrappers.delete(fn);
+        }
     }
-    /**
-     * 注册私聊消息好友事件回调
-     * @param fn - 回调 `(bot, event) => any`
-     */
     onPrivateFriend(fn) {
-        this.napcat.on('message.private.friend', async (event) => {
+        const w = async (event) => {
             try {
                 new BotConsole('privateMessage', event).log();
                 await fn(this.client, event);
@@ -84,14 +94,19 @@ export class MessageEvent {
             catch (e) {
                 new BotConsole('error', e instanceof Error ? e.message : JSON.stringify(e)).log();
             }
-        });
+        };
+        this.wrappers.set(fn, w);
+        this.napcat.on('message.private.friend', w);
+    }
+    offPrivateFriend(fn) {
+        const w = this.wrappers.get(fn);
+        if (w) {
+            this.napcat.off('message.private.friend', w);
+            this.wrappers.delete(fn);
+        }
     }
-    /**
-     * 注册私聊消息群临时事件回调
-     * @param fn - 回调 `(bot, event) => any`
-     */
     onPrivateGroup(fn) {
-        this.napcat.on('message.private.group', async (event) => {
+        const w = async (event) => {
             try {
                 new BotConsole('privateMessage', event).log();
                 await fn(this.client, event);
@@ -99,18 +114,20 @@ export class MessageEvent {
             catch (e) {
                 new BotConsole('error', e instanceof Error ? e.message : JSON.stringify(e)).log();
             }
-        });
+        };
+        this.wrappers.set(fn, w);
+        this.napcat.on('message.private.group', w);
+    }
+    offPrivateGroup(fn) {
+        const w = this.wrappers.get(fn);
+        if (w) {
+            this.napcat.off('message.private.group', w);
+            this.wrappers.delete(fn);
+        }
     }
 }
 /**
- * 当 bot 自身发出消息后的事件。
- *
- * @example
- * ```ts
- * bot.event.messageSent.onGroupSent(async (bot, event) => {
- *     console.log('群消息已发送:', event.message_id);
- * });
- * ```
+ * bot 自身发出的消息事件（发送成功后的回执）。
  */
 export class MessageSent {
     constructor(napcat, client) {
@@ -126,15 +143,17 @@ export class MessageSent {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "wrappers", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
         this.napcat = napcat;
         this.client = client;
     }
-    /**
-     * 注册群消息发送回执
-     * @param fn - 回调 `(bot, event) => any`
-     */
     onGroupSent(fn) {
-        this.napcat.on('message_sent.group', async (event) => {
+        const w = async (event) => {
             try {
                 new BotConsole('groupMessageSelf', event).log();
                 await fn(this.client, event);
@@ -142,14 +161,19 @@ export class MessageSent {
             catch (e) {
                 new BotConsole('error', e instanceof Error ? e.message : JSON.stringify(e)).log();
             }
-        });
+        };
+        this.wrappers.set(fn, w);
+        this.napcat.on('message_sent.group', w);
+    }
+    offGroupSent(fn) {
+        const w = this.wrappers.get(fn);
+        if (w) {
+            this.napcat.off('message_sent.group', w);
+            this.wrappers.delete(fn);
+        }
     }
-    /**
-     * 注册群消息发送回执（仅普通消息）
-     * @param fn - 回调 `(bot, event) => any`
-     */
     onGroupNormal(fn) {
-        this.napcat.on('message_sent.group.normal', async (event) => {
+        const w = async (event) => {
             try {
                 new BotConsole('groupMessageSelf', event).log();
                 await fn(this.client, event);
@@ -157,14 +181,19 @@ export class MessageSent {
             catch (e) {
                 new BotConsole('error', e instanceof Error ? e.message : JSON.stringify(e)).log();
             }
-        });
+        };
+        this.wrappers.set(fn, w);
+        this.napcat.on('message_sent.group.normal', w);
+    }
+    offGroupNormal(fn) {
+        const w = this.wrappers.get(fn);
+        if (w) {
+            this.napcat.off('message_sent.group.normal', w);
+            this.wrappers.delete(fn);
+        }
     }
-    /**
-     * 注册私聊消息发送回执
-     * @param fn - 回调 `(bot, event) => any`
-     */
     onPrivateSent(fn) {
-        this.napcat.on('message_sent.private', async (event) => {
+        const w = async (event) => {
             try {
                 new BotConsole('privateMessageSelf', event).log();
                 await fn(this.client, event);
@@ -172,14 +201,19 @@ export class MessageSent {
             catch (e) {
                 new BotConsole('error', e instanceof Error ? e.message : JSON.stringify(e)).log();
             }
-        });
+        };
+        this.wrappers.set(fn, w);
+        this.napcat.on('message_sent.private', w);
+    }
+    offPrivateSent(fn) {
+        const w = this.wrappers.get(fn);
+        if (w) {
+            this.napcat.off('message_sent.private', w);
+            this.wrappers.delete(fn);
+        }
     }
-    /**
-     * 注册私聊好友消息发送回执
-     * @param fn - 回调 `(bot, event) => any`
-     */
     onPrivateFriend(fn) {
-        this.napcat.on('message_sent.private.friend', async (event) => {
+        const w = async (event) => {
             try {
                 new BotConsole('privateMessageSelf', event).log();
                 await fn(this.client, event);
@@ -187,14 +221,19 @@ export class MessageSent {
             catch (e) {
                 new BotConsole('error', e instanceof Error ? e.message : JSON.stringify(e)).log();
             }
-        });
+        };
+        this.wrappers.set(fn, w);
+        this.napcat.on('message_sent.private.friend', w);
+    }
+    offPrivateFriend(fn) {
+        const w = this.wrappers.get(fn);
+        if (w) {
+            this.napcat.off('message_sent.private.friend', w);
+            this.wrappers.delete(fn);
+        }
     }
-    /**
-     * 注册私聊群临时消息发送回执
-     * @param fn - 回调 `(bot, event) => any`
-     */
     onPrivateGroup(fn) {
-        this.napcat.on('message_sent.private.group', async (event) => {
+        const w = async (event) => {
             try {
                 new BotConsole('privateMessageSelf', event).log();
                 await fn(this.client, event);
@@ -202,18 +241,20 @@ export class MessageSent {
             catch (e) {
                 new BotConsole('error', e instanceof Error ? e.message : JSON.stringify(e)).log();
             }
-        });
+        };
+        this.wrappers.set(fn, w);
+        this.napcat.on('message_sent.private.group', w);
+    }
+    offPrivateGroup(fn) {
+        const w = this.wrappers.get(fn);
+        if (w) {
+            this.napcat.off('message_sent.private.group', w);
+            this.wrappers.delete(fn);
+        }
     }
 }
 /**
  * 请求事件监听（加好友、加群、邀请入群）。
- *
- * @example
- * ```ts
- * bot.event.request.onFriend(async (bot, event) => {
- *     await bot.api.handleFriendAddRequest(event.flag, true);
- * });
- * ```
  */
 export class RequestEvent {
     constructor(napcat, client) {
@@ -229,15 +270,17 @@ export class RequestEvent {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "wrappers", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
         this.napcat = napcat;
         this.client = client;
     }
-    /**
-     * 注册加好友请求回调
-     * @param fn - 回调 `(bot, event) => any`，event.flag 可传给 handleFriendAddRequest
-     */
     onFriend(fn) {
-        this.napcat.on('request.friend', async (event) => {
+        const w = async (event) => {
             try {
                 new BotConsole('requestFriend', event).log();
                 await fn(this.client, event);
@@ -245,14 +288,19 @@ export class RequestEvent {
             catch (e) {
                 new BotConsole('error', e instanceof Error ? e.message : JSON.stringify(e)).log();
             }
-        });
+        };
+        this.wrappers.set(fn, w);
+        this.napcat.on('request.friend', w);
+    }
+    offFriend(fn) {
+        const w = this.wrappers.get(fn);
+        if (w) {
+            this.napcat.off('request.friend', w);
+            this.wrappers.delete(fn);
+        }
     }
-    /**
-     * 注册加群请求回调
-     * @param fn - 回调 `(bot, event) => any`，event.flag 可传给 handleGroupAddRequest
-     */
     onGroupAdd(fn) {
-        this.napcat.on('request.group.add', async (event) => {
+        const w = async (event) => {
             try {
                 new BotConsole('requestGroupAdd', event).log();
                 await fn(this.client, event);
@@ -260,14 +308,19 @@ export class RequestEvent {
             catch (e) {
                 new BotConsole('error', e instanceof Error ? e.message : JSON.stringify(e)).log();
             }
-        });
+        };
+        this.wrappers.set(fn, w);
+        this.napcat.on('request.group.add', w);
+    }
+    offGroupAdd(fn) {
+        const w = this.wrappers.get(fn);
+        if (w) {
+            this.napcat.off('request.group.add', w);
+            this.wrappers.delete(fn);
+        }
     }
-    /**
-     * 注册邀请入群回调
-     * @param fn - 回调 `(bot, event) => any`
-     */
     onGroupInvite(fn) {
-        this.napcat.on('request.group.invite', async (event) => {
+        const w = async (event) => {
             try {
                 new BotConsole('requestGroupInvite', event).log();
                 await fn(this.client, event);
@@ -275,14 +328,19 @@ export class RequestEvent {
             catch (e) {
                 new BotConsole('error', e instanceof Error ? e.message : JSON.stringify(e)).log();
             }
-        });
+        };
+        this.wrappers.set(fn, w);
+        this.napcat.on('request.group.invite', w);
+    }
+    offGroupInvite(fn) {
+        const w = this.wrappers.get(fn);
+        if (w) {
+            this.napcat.off('request.group.invite', w);
+            this.wrappers.delete(fn);
+        }
     }
-    /**
-     * 注册所有群请求回调（加群 + 邀请）
-     * @param fn - 回调 `(bot, event) => any`
-     */
     onGroupRequest(fn) {
-        this.napcat.on('request.group', async (event) => {
+        const w = async (event) => {
             try {
                 const type = event.sub_type === 'add' ? 'requestGroupAdd' : 'requestGroupInvite';
                 new BotConsole(type, event).log();
@@ -291,17 +349,20 @@ export class RequestEvent {
             catch (e) {
                 new BotConsole('error', e instanceof Error ? e.message : JSON.stringify(e)).log();
             }
-        });
+        };
+        this.wrappers.set(fn, w);
+        this.napcat.on('request.group', w);
+    }
+    offGroupRequest(fn) {
+        const w = this.wrappers.get(fn);
+        if (w) {
+            this.napcat.off('request.group', w);
+            this.wrappers.delete(fn);
+        }
     }
 }
 /**
  * 通知事件监听（好友添加、群成员变动、禁言、撤回等）。
- *
- * @example
- * ```ts
- * bot.event.notice.onFriendAdd(async (bot, event) => { ... });
- * bot.event.notice.onGroupIncrease(async (bot, event) => { ... });
- * ```
  */
 export class NoticeEvent {
     constructor(napcat, client) {
@@ -317,12 +378,17 @@ export class NoticeEvent {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "wrappers", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
         this.napcat = napcat;
         this.client = client;
     }
-    /** 好友添加 */
     onFriendAdd(fn) {
-        this.napcat.on('notice.friend_add', async (event) => {
+        const w = async (event) => {
             try {
                 new BotConsole('notice', event).log();
                 await fn(this.client, event);
@@ -330,11 +396,19 @@ export class NoticeEvent {
             catch (e) {
                 new BotConsole('error', e instanceof Error ? e.message : JSON.stringify(e)).log();
             }
-        });
+        };
+        this.wrappers.set(fn, w);
+        this.napcat.on('notice.friend_add', w);
+    }
+    offFriendAdd(fn) {
+        const w = this.wrappers.get(fn);
+        if (w) {
+            this.napcat.off('notice.friend_add', w);
+            this.wrappers.delete(fn);
+        }
     }
-    /** 私聊消息撤回 */
     onFriendRecall(fn) {
-        this.napcat.on('notice.friend_recall', async (event) => {
+        const w = async (event) => {
             try {
                 new BotConsole('notice', event).log();
                 await fn(this.client, event);
@@ -342,11 +416,19 @@ export class NoticeEvent {
             catch (e) {
                 new BotConsole('error', e instanceof Error ? e.message : JSON.stringify(e)).log();
             }
-        });
+        };
+        this.wrappers.set(fn, w);
+        this.napcat.on('notice.friend_recall', w);
+    }
+    offFriendRecall(fn) {
+        const w = this.wrappers.get(fn);
+        if (w) {
+            this.napcat.off('notice.friend_recall', w);
+            this.wrappers.delete(fn);
+        }
     }
-    /** 群管理员变动（设置/取消） */
     onGroupAdmin(fn) {
-        this.napcat.on('notice.group_admin', async (event) => {
+        const w = async (event) => {
             try {
                 new BotConsole('notice', event).log();
                 await fn(this.client, event);
@@ -354,11 +436,19 @@ export class NoticeEvent {
             catch (e) {
                 new BotConsole('error', e instanceof Error ? e.message : JSON.stringify(e)).log();
             }
-        });
+        };
+        this.wrappers.set(fn, w);
+        this.napcat.on('notice.group_admin', w);
+    }
+    offGroupAdmin(fn) {
+        const w = this.wrappers.get(fn);
+        if (w) {
+            this.napcat.off('notice.group_admin', w);
+            this.wrappers.delete(fn);
+        }
     }
-    /** 群禁言变动（禁言/解除） */
     onGroupBan(fn) {
-        this.napcat.on('notice.group_ban', async (event) => {
+        const w = async (event) => {
             try {
                 new BotConsole('notice', event).log();
                 await fn(this.client, event);
@@ -366,11 +456,19 @@ export class NoticeEvent {
             catch (e) {
                 new BotConsole('error', e instanceof Error ? e.message : JSON.stringify(e)).log();
             }
-        });
+        };
+        this.wrappers.set(fn, w);
+        this.napcat.on('notice.group_ban', w);
+    }
+    offGroupBan(fn) {
+        const w = this.wrappers.get(fn);
+        if (w) {
+            this.napcat.off('notice.group_ban', w);
+            this.wrappers.delete(fn);
+        }
     }
-    /** 群名片变更 */
     onGroupCard(fn) {
-        this.napcat.on('notice.group_card', async (event) => {
+        const w = async (event) => {
             try {
                 new BotConsole('notice', event).log();
                 await fn(this.client, event);
@@ -378,11 +476,19 @@ export class NoticeEvent {
             catch (e) {
                 new BotConsole('error', e instanceof Error ? e.message : JSON.stringify(e)).log();
             }
-        });
+        };
+        this.wrappers.set(fn, w);
+        this.napcat.on('notice.group_card', w);
+    }
+    offGroupCard(fn) {
+        const w = this.wrappers.get(fn);
+        if (w) {
+            this.napcat.off('notice.group_card', w);
+            this.wrappers.delete(fn);
+        }
     }
-    /** 群成员减少（退群/被踢/bot被踢） */
     onGroupDecrease(fn) {
-        this.napcat.on('notice.group_decrease', async (event) => {
+        const w = async (event) => {
             try {
                 new BotConsole('notice', event).log();
                 await fn(this.client, event);
@@ -390,11 +496,19 @@ export class NoticeEvent {
             catch (e) {
                 new BotConsole('error', e instanceof Error ? e.message : JSON.stringify(e)).log();
             }
-        });
+        };
+        this.wrappers.set(fn, w);
+        this.napcat.on('notice.group_decrease', w);
+    }
+    offGroupDecrease(fn) {
+        const w = this.wrappers.get(fn);
+        if (w) {
+            this.napcat.off('notice.group_decrease', w);
+            this.wrappers.delete(fn);
+        }
     }
-    /** 群成员增加（审批/邀请） */
     onGroupIncrease(fn) {
-        this.napcat.on('notice.group_increase', async (event) => {
+        const w = async (event) => {
             try {
                 new BotConsole('notice', event).log();
                 await fn(this.client, event);
@@ -402,11 +516,19 @@ export class NoticeEvent {
             catch (e) {
                 new BotConsole('error', e instanceof Error ? e.message : JSON.stringify(e)).log();
             }
-        });
+        };
+        this.wrappers.set(fn, w);
+        this.napcat.on('notice.group_increase', w);
+    }
+    offGroupIncrease(fn) {
+        const w = this.wrappers.get(fn);
+        if (w) {
+            this.napcat.off('notice.group_increase', w);
+            this.wrappers.delete(fn);
+        }
     }
-    /** 群消息撤回 */
     onGroupRecall(fn) {
-        this.napcat.on('notice.group_recall', async (event) => {
+        const w = async (event) => {
             try {
                 new BotConsole('notice', event).log();
                 await fn(this.client, event);
@@ -414,11 +536,19 @@ export class NoticeEvent {
             catch (e) {
                 new BotConsole('error', e instanceof Error ? e.message : JSON.stringify(e)).log();
             }
-        });
+        };
+        this.wrappers.set(fn, w);
+        this.napcat.on('notice.group_recall', w);
+    }
+    offGroupRecall(fn) {
+        const w = this.wrappers.get(fn);
+        if (w) {
+            this.napcat.off('notice.group_recall', w);
+            this.wrappers.delete(fn);
+        }
     }
-    /** 群文件上传 */
     onGroupUpload(fn) {
-        this.napcat.on('notice.group_upload', async (event) => {
+        const w = async (event) => {
             try {
                 new BotConsole('notice', event).log();
                 await fn(this.client, event);
@@ -426,11 +556,19 @@ export class NoticeEvent {
             catch (e) {
                 new BotConsole('error', e instanceof Error ? e.message : JSON.stringify(e)).log();
             }
-        });
+        };
+        this.wrappers.set(fn, w);
+        this.napcat.on('notice.group_upload', w);
+    }
+    offGroupUpload(fn) {
+        const w = this.wrappers.get(fn);
+        if (w) {
+            this.napcat.off('notice.group_upload', w);
+            this.wrappers.delete(fn);
+        }
     }
-    /** 群表情回应 */
     onGroupEmojiLike(fn) {
-        this.napcat.on('notice.group_msg_emoji_like', async (event) => {
+        const w = async (event) => {
             try {
                 new BotConsole('notice', event).log();
                 await fn(this.client, event);
@@ -438,11 +576,19 @@ export class NoticeEvent {
             catch (e) {
                 new BotConsole('error', e instanceof Error ? e.message : JSON.stringify(e)).log();
             }
-        });
+        };
+        this.wrappers.set(fn, w);
+        this.napcat.on('notice.group_msg_emoji_like', w);
+    }
+    offGroupEmojiLike(fn) {
+        const w = this.wrappers.get(fn);
+        if (w) {
+            this.napcat.off('notice.group_msg_emoji_like', w);
+            this.wrappers.delete(fn);
+        }
     }
-    /** 群设精（添加/删除） */
     onGroupEssence(fn) {
-        this.napcat.on('notice.essence', async (event) => {
+        const w = async (event) => {
             try {
                 new BotConsole('notice', event).log();
                 await fn(this.client, event);
@@ -450,11 +596,19 @@ export class NoticeEvent {
             catch (e) {
                 new BotConsole('error', e instanceof Error ? e.message : JSON.stringify(e)).log();
             }
-        });
+        };
+        this.wrappers.set(fn, w);
+        this.napcat.on('notice.essence', w);
+    }
+    offGroupEssence(fn) {
+        const w = this.wrappers.get(fn);
+        if (w) {
+            this.napcat.off('notice.essence', w);
+            this.wrappers.delete(fn);
+        }
     }
-    /** 戳一戳（好友/群） */
     onPoke(fn) {
-        this.napcat.on('notice.notify.poke', async (event) => {
+        const w = async (event) => {
             try {
                 new BotConsole('notice', event).log();
                 await fn(this.client, event);
@@ -462,11 +616,19 @@ export class NoticeEvent {
             catch (e) {
                 new BotConsole('error', e instanceof Error ? e.message : JSON.stringify(e)).log();
             }
-        });
+        };
+        this.wrappers.set(fn, w);
+        this.napcat.on('notice.notify.poke', w);
+    }
+    offPoke(fn) {
+        const w = this.wrappers.get(fn);
+        if (w) {
+            this.napcat.off('notice.notify.poke', w);
+            this.wrappers.delete(fn);
+        }
     }
-    /** 群名称变更 */
     onGroupNameChange(fn) {
-        this.napcat.on('notice.notify.group_name', async (event) => {
+        const w = async (event) => {
             try {
                 new BotConsole('notice', event).log();
                 await fn(this.client, event);
@@ -474,11 +636,19 @@ export class NoticeEvent {
             catch (e) {
                 new BotConsole('error', e instanceof Error ? e.message : JSON.stringify(e)).log();
             }
-        });
+        };
+        this.wrappers.set(fn, w);
+        this.napcat.on('notice.notify.group_name', w);
+    }
+    offGroupNameChange(fn) {
+        const w = this.wrappers.get(fn);
+        if (w) {
+            this.napcat.off('notice.notify.group_name', w);
+            this.wrappers.delete(fn);
+        }
     }
-    /** 群头衔变更 */
     onTitleChange(fn) {
-        this.napcat.on('notice.notify.title', async (event) => {
+        const w = async (event) => {
             try {
                 new BotConsole('notice', event).log();
                 await fn(this.client, event);
@@ -486,11 +656,19 @@ export class NoticeEvent {
             catch (e) {
                 new BotConsole('error', e instanceof Error ? e.message : JSON.stringify(e)).log();
             }
-        });
+        };
+        this.wrappers.set(fn, w);
+        this.napcat.on('notice.notify.title', w);
+    }
+    offTitleChange(fn) {
+        const w = this.wrappers.get(fn);
+        if (w) {
+            this.napcat.off('notice.notify.title', w);
+            this.wrappers.delete(fn);
+        }
     }
-    /** 个人资料点赞 */
     onProfileLike(fn) {
-        this.napcat.on('notice.notify.profile_like', async (event) => {
+        const w = async (event) => {
             try {
                 new BotConsole('notice', event).log();
                 await fn(this.client, event);
@@ -498,11 +676,19 @@ export class NoticeEvent {
             catch (e) {
                 new BotConsole('error', e instanceof Error ? e.message : JSON.stringify(e)).log();
             }
-        });
+        };
+        this.wrappers.set(fn, w);
+        this.napcat.on('notice.notify.profile_like', w);
+    }
+    offProfileLike(fn) {
+        const w = this.wrappers.get(fn);
+        if (w) {
+            this.napcat.off('notice.notify.profile_like', w);
+            this.wrappers.delete(fn);
+        }
     }
-    /** bot 离线 */
     onBotOffline(fn) {
-        this.napcat.on('notice.bot_offline', async (event) => {
+        const w = async (event) => {
             try {
                 new BotConsole('notice', event).log();
                 await fn(this.client, event);
@@ -510,19 +696,18 @@ export class NoticeEvent {
             catch (e) {
                 new BotConsole('error', e instanceof Error ? e.message : JSON.stringify(e)).log();
             }
-        });
+        };
+        this.wrappers.set(fn, w);
+        this.napcat.on('notice.bot_offline', w);
+    }
+    offBotOffline(fn) {
+        const w = this.wrappers.get(fn);
+        if (w) {
+            this.napcat.off('notice.bot_offline', w);
+            this.wrappers.delete(fn);
+        }
     }
 }
-/**
- * 事件监听入口，按类别分组暴露监听器。
- *
- * @example
- * ```ts
- * bot.event.message.onGroupMessage(...);
- * bot.event.messageSent.onGroupSent(...);
- * bot.event.request.onFriend(...);
- * ```
- */
 export class BotEvent {
     constructor(api, client) {
         Object.defineProperty(this, "message", {

package/dist/botPlugin.d.ts

@@ -49,6 +49,7 @@ export declare class BotPluginSystem {
     list(): string[];
     /** 返回所有已加载的插件名列表 */
     loaded(): string[];
+    private findIndex;
     /**
      * 扫描目录，自动注册并加载所有插件
      * @param dir - 插件目录路径

package/dist/botPlugin.js

@@ -70,7 +70,7 @@ export class BotPluginSystem {
             throw new Error(`插件 "${name}" 已注册`);
         }
         this.registry.set(name, { ctor, meta });
-        new BotConsole('system', `插件 "${meta.name}" 已注册`).log();
+        new BotConsole('plugin', { name: meta.name, msg: '已注册' }).log();
     }
     /**
      * 加载插件
@@ -87,7 +87,7 @@ export class BotPluginSystem {
         const instance = record.ctor.create(this.api, this.client, record.meta);
         await instance.load();
         this.instances.set(name, instance);
-        new BotConsole('system', `插件 "${record.meta.name}" 已加载`).log();
+        new BotConsole('plugin', { name: record.meta.name, msg: '已加载' }).log();
     }
     /**
      * 卸载插件
@@ -100,7 +100,7 @@ export class BotPluginSystem {
         }
         await instance.unload();
         this.instances.delete(name);
-        new BotConsole('system', `插件 "${name}" 已卸载`).log();
+        new BotConsole('plugin', { name: this.registry.get(name)?.meta.name || name, msg: '已卸载' }).log();
     }
     /**
      * 热重载：先卸载再加载
@@ -122,6 +122,15 @@ export class BotPluginSystem {
     loaded() {
         return Array.from(this.instances.keys());
     }
+    findIndex(dir, name) {
+        const js = path.join(dir, name, 'index.js');
+        if (fs.existsSync(js))
+            return js;
+        const ts = path.join(dir, name, 'index.ts');
+        if (fs.existsSync(ts))
+            return ts;
+        return null;
+    }
     /**
      * 扫描目录，自动注册并加载所有插件
      * @param dir - 插件目录路径
@@ -137,8 +146,8 @@ export class BotPluginSystem {
             if (!entry.isDirectory())
                 continue;
             const name = entry.name;
-            const indexPath = path.join(dir, name, 'index.ts');
-            if (!fs.existsSync(indexPath))
+            const indexPath = this.findIndex(dir, name);
+            if (!indexPath)
                 continue;
             try {
                 const mod = await import(path.resolve(indexPath));
@@ -179,7 +188,7 @@ export class BotPluginSystem {
             return;
         }
         this.watched = new Set(this.list());
-        new BotConsole('system', `开始监听插件目录: ${this.watchDir}`).log();
+        new BotConsole('plugin', { name: 'watch', msg: `开始监听 ${this.watchDir}` }).log();
         this.watcher = setInterval(async () => {
             if (!fs.existsSync(this.watchDir))
                 return;
@@ -189,8 +198,8 @@ export class BotPluginSystem {
                 if (!entry.isDirectory())
                     continue;
                 const name = entry.name;
-                const indexPath = path.join(this.watchDir, name, 'index.ts');
-                if (!fs.existsSync(indexPath))
+                const indexPath = this.findIndex(this.watchDir, name);
+                if (!indexPath)
                     continue;
                 current.add(name);
                 if (!this.watched.has(name)) {
@@ -199,12 +208,13 @@ export class BotPluginSystem {
             }
             for (const name of Array.from(this.watched)) {
                 if (!current.has(name) && this.registry.has(name)) {
+                    const displayName = this.registry.get(name)?.meta.name || name;
                     try {
                         if (this.instances.has(name)) {
                             await this.unload(name);
                         }
                         this.registry.delete(name);
-                        new BotConsole('system', `插件 "${name}" 目录已删除，已移除`).log();
+                        new BotConsole('plugin', { name: displayName, msg: '目录已删除，已移除' }).log();
                     }
                     catch { }
                 }
@@ -218,11 +228,13 @@ export class BotPluginSystem {
             clearInterval(this.watcher);
             this.watcher = null;
             this.watchDir = null;
-            new BotConsole('system', '已停止插件目录监听').log();
+            new BotConsole('plugin', { name: 'watch', msg: '已停止' }).log();
         }
     }
     async scanOne(dir, name) {
-        const indexPath = path.join(dir, name, 'index.ts');
+        const indexPath = this.findIndex(dir, name);
+        if (!indexPath)
+            return;
         try {
             const mod = await import(indexPath);
             const ctor = mod[name.charAt(0).toUpperCase() + name.slice(1) + 'Plugin'] || mod.default || Object.values(mod).find((v) => typeof v === 'function' && v.create);
@@ -234,7 +246,7 @@ export class BotPluginSystem {
             };
             this.register(name, ctor, meta);
             await this.load(name);
-            new BotConsole('system', `检测到新插件 "${name}"，已自动加载`).log();
+            new BotConsole('plugin', { name: meta.name, msg: '已自动加载' }).log();
         }
         catch (e) {
             new BotConsole('error', `自动加载插件 "${name}" 失败: ${e.message || e}`).log();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hotcat-bot-qq",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "基于 node-napcat-ts 的 TypeScript QQ 机器人框架",
   "type": "module",
   "main": "dist/index.js",

package/plugins/hotCatPlugin/index.ts

@@ -7,7 +7,7 @@ import * as os from 'os'
 export class HotCatPlugin extends PluginBase {
     static meta = {
         name: 'hotCatPlugin',
-        version: '0.1.4',
+        version: '0.1.6',
         description: 'HotCat 默认插件（#hotCat 指令查询 bot 状态）',
         author: 'CHCAT1320',
     }
@@ -20,14 +20,14 @@ export class HotCatPlugin extends PluginBase {
 
     async load() {
         this.startTime = Date.now()
-        this.api.napcat.on('message.group', this.onGroupMsg)
+        this.bot.event.message.onGroupMessage(this.onGroupMsg)
     }
 
     async unload() {
-        this.api.napcat.off('message.group', this.onGroupMsg)
+        this.bot.event.message.offGroupMessage(this.onGroupMsg)
     }
 
-    private onGroupMsg = async (event: any) => {
+    private onGroupMsg = async (_bot: BotClient, event: any) => {
         const msg = event.raw_message.trim()
 
         if (msg === '#hotCat' || msg === '#hotcat') {