使用指南

查看更多
萌卡NT 部署、连接、登录与消息协议指南。

部署教程

萌卡NT 通过 WebSocket 与外部插件通信。插件可以接收事件，并通过同一条连接调用 API。

反向 WebSocket

反向模式下，插件监听 WebSocket 地址，萌卡NT作为客户端主动连接。

通信协议

官方 Node.js SDK 已封装本页协议。其他语言可以按照以下 JSON 帧实现 WebSocket 客户端或服务端。

消息段

参数 类型 说明

Bot 登录流程

登录 API 只能操作插件绑定节点下的账号。发起登录前，账号必须已经创建且处于离线状态。

API 文档

查看更多
萌卡NT 插件接口调用参考。

API 总览

正向与反向 WebSocket SDK 提供相同的 API。除特别注明外，所有 API 都返回 Promise，成功时解析为业务数据，失败时抛出错误。

get_pet_pk_strangers

get_pet_pk_strangers。适用萌卡 NT v2.2.1。API 开源贡献者：星空花海。

get_pet_medal_gallery

get_pet_medal_gallery。适用萌卡 NT v2.2.1。API 开源贡献者：星空花海。

get_pet_fatigue_status

get_pet_fatigue_status。适用萌卡 NT v2.2.1。API 开源贡献者：星空花海。

get_pet_attributes

get_pet_attributes。适用萌卡 NT v2.2.1。API 开源贡献者：星空花海。

事件参考

查看更多
萌卡NT WebSocket 事件结构参考。

萌卡原生事件

萌卡 NT 将 QQ 原生推送规范化为稳定的事件对象。插件既可以监听消息、通知、请求、系统四个大类，也可以直接监听具体事件；具体事件更适合业务代码，避免插件自行判断多个字段。

请求事件

请求事件的 category 固定为 request，可通过 request 大类监听。

系统事件

插件连接完成认证后，框架立即发送 systemlifecycle：

通知事件

通知事件。适用萌卡 NT v2.1.12。

消息事件

api.on('groupmessagereceived', event => {

插件开发

查看更多
开发者投稿、审核、发布更新与插件市场接入指引。

开发者如何提交插件

使用 Halo 文章和投稿审核发布萌卡 NT 插件的完整填写指引。

插件市场

查看更多
审核通过并由萌卡 NT 框架自动同步的插件文章。

若克斯群管

面向萌卡 NT 的多账号、分群隔离 QQ 群管理插件，提供菜单、风控、问答、签到与自动化管理。

萌卡NT用户系统

萌卡NT用户系统提供独立用户门户与管理后台，支持账号登录、节点套餐、订单支付、共享等级任务及用户权限管理。一体化安装后自动连接框架，管理员可直接打开插件后台。

QQ 宠物助手 · 萌卡 NT 插件

宠物状态查询（金币 / 心情 / 体力 / 清洁 / 综合值 / 等级 / 当前任务） 喂食（饼干 / 虾仁）、洗澡（香皂片 / 沐浴球）、库存补货 学习（读取目录按最短时长选课）、打工（职业岗位）、冒险（实时天气/事件项目） PK：发起 / 结算 / 今日批次每日上限 好友照顾：列表 / 照顾 / feed / bathe（按缺口批量使用道具） 自动托管：定时巡检、体力/清洁阈值补货与照顾、金牌合每日 PK WebUI 管理面板：概览 / 操作 / 配置 / 日志

B站综合插件

B站综合插件为群聊和私聊提供 Bilibili 查询、订阅、解析与通知，支持正向及反向 WebSocket、B站扫码登录，以及网页端账号、订阅和授权管理。