API 总览

HotCat Bot 所有公共 API 按类组织：

类	访问方式	说明
BotClient	new BotClient(config)	Bot 客户端，封装连接和启动
BotApi	bot.api.xxx()	所有 napcat API 的统一封装
BotEvent	bot.event.xxx()	事件监听，按类别分组
BotScheduler	bot.scheduler.xxx()	定时任务调度
BotPluginSystem	bot.plugin.xxx()	插件注册、加载、热重载、目录监听
Message	Message.xxx()	消息段构建器

架构

BotClient
 ├── api: BotApi          → bot.api.sendGroupMessage(...)
 │    └── napcat: NCWebsocket   (底层 napcat 实例)
 ├── event: BotEvent      → bot.event.message.onGroupMessage(...)
 │    ├── message: MessageEvent       (收到的消息)
 │    ├── messageSent: MessageSent    (发出的消息回执)
 │    ├── request: RequestEvent       (加好友/加群请求)
 │    └── notice: NoticeEvent         (通知事件)
 ├── scheduler: BotScheduler → bot.scheduler.cron(...)
 ├── plugin: BotPluginSystem → bot.plugin.register(...)
 ├── nickname: string     (bot 昵称)
 └── id: number           (bot QQ 号)

快速索引

BotApi 方法分类

分类	方法数	常用方法
消息发送	10	sendMessage, sendGroupMessage, sendPrivateMessage, sendForwardMsg
消息管理	12	deleteMessage, getMessage, markMsgAsRead, translateEn2zh
群管理	12	banMember, kickMember, setGroupAdmin, setGroupCard
群公告	3	sendGroupNotice, getGroupNotice, deleteGroupNotice
群信息	10	getGroupInfo, getGroupMemberList, getGroupHonorInfo
精华消息	3	getEssenceMsgList, setEssenceMsg, deleteEssenceMsg
用户/好友	8	getFriendList, getStrangerInfo, deleteFriend
群互动	5	groupPoke, friendPoke, sendLike, sendPoke
文件/资源	9	getImage, getRecord, uploadGroupFile, ocrImage
群文件	6	getGroupRootFiles, createGroupFileFolder
收藏	2	createCollection, getCollectionList
AI	3	getAiCharacters, sendGroupAiRecord
系统	13	getStatus, getCookies, setQQProfile
推荐	2	recommendContact, recommendGroup
小程序	1	getMiniAppArk

BotEvent 事件分类

分类	属性	事件数
接收消息	bot.event.message	6
发送回执	bot.event.messageSent	6
请求	bot.event.request	4
通知	bot.event.notice	16

BotScheduler 定时任务

方法	说明	示例
cron()	cron 表达式	cron('0 8 * * *', fn)
every()	固定间隔	every('5m', fn)
at()	指定时间	at('08:00', fn)
cancel()	取消任务	cancel(id)
cancelAll()	取消全部	cancelAll()