NapCatQQ从零搭建稳定的NTQQ机器人框架【免费下载链接】NapCatQQModern protocol-side framework based on NTQQ项目地址: https://gitcode.com/gh_mirrors/na/NapCatQQNapCatQQ是一个基于 NTQQ 协议端的 QQ 机器人开发框架帮你把 QQ 的消息、群管理、文件收发能力封装成标准接口。适合刚接触机器人开发的新手和普通开发者读完你能在 10 分钟内跑通开发环境看懂它的模块化架构并规划出自己的第一个机器人。接下来带着你一步步跑通。 它到底能帮你做什么完整的 OneBot 11 接口实现OneBot 是机器人世界通用的消息协议相当于标准插座让你的机器人可以对接任意支持 OneBot 的上层框架。这意味着你能直接调用发群消息、踢人、管理群公告等成熟 API不用自己啃 QQ 协议。基于 NTQQ 的协议端实现NTQQ 是 QQ 当前采用的新版客户端内核NapCatQQ 直接基于它取数而非模拟老协议。这意味着消息收发更贴近真实客户端行为长时运行稳定性更好。低内存长时运行核心走 TypeScript Node.js进程管理带崩溃保护10 秒内多次崩溃会自动抑制。这意味着你在一台低配 Linux 服务器或小主机上挂一整周也不必担心吃光内存。内置 WebUI 管理面板登录、配置 OneBot 网络接入、看日志、重启进程都能在浏览器里完成。这意味着部署后你基本不用再盯终端。NapCatQQ WebUI 的界面配色风格紫蓝渐变的科技感视觉到这里你已经知道它强在哪了下面直接进入安装。 从零跑起来前置条件✅ Node.js 18.0.0 以上版本✅ 已安装 pnpm 包管理器npm i -g pnpm即可✅ Windows 环境已安装 NT 版 QQ 客户端协议端依赖 QQ 客户端内核最简命令序列git clone https://gitcode.com/gh_mirrors/na/NapCatQQ cd NapCatQQ pnpm install pnpm run build:shell pnpm run dev:shell如果报找不到 wrapper.node或versions 文件夹下没有找到版本目录先检查 QQ 客户端是否已安装完整开发脚本会从系统注册表读取 QQ 安装路径并定位其内核文件路径不对就会在加载阶段失败。到这里环境已经跑起来了接下来看看它内部是怎么组织的。 拆开看看核心组件怎么协作整个仓库是一个 pnpm monorepomonorepo 即一个仓库装多个子包方便各模块共享依赖与类型核心子包如下packages/ ├── napcat-core/ # 协议层加载 QQ 内核封装消息/群/文件 API 与事件 ├── napcat-onebot/ # 协议适配把核心能力翻译成 OneBot 11 接口与事件 ├── napcat-shell/ # 独立运行形态不依赖 QQ 客户端进程直接拉起 ├── napcat-framework/ # 框架形态注入到 QQ 客户端内运行 ├── napcat-webui-backend/ # 管理面板后端配置、日志、进程控制 └── napcat-webui-frontend/ # 管理面板前端React 界面napcat-core负责对接 QQ 内核提供MsgApi、GroupApi、FileApi等 12 组原生 API 和事件监听。napcat-onebot负责把上述能力翻译成标准 OneBot 动作action和事件event并管理 HTTP/WebSocket 网络接入。napcat-shell与napcat-framework是两种运行形态前者独立进程跑后者注入 QQ 客户端内跑二者共用 core。模块之间靠workspace依赖互相引用改一个包后重新构建对应模块即可不用全量重装。架构清楚了下面拿它实际做点东西。 拿它实际做点什么群管理机器人监听入群、禁言、卡片变更等通知事件并自动处理。审核入群申请按关键词自动同意或拒绝定时发群公告、维护群名片敏感行为自动禁言并 管理员消息聚合机器人把多群、多人的消息按规则转发到指定频道。转发单条消息或整段聊天记录抓取群文件、私聊文件并转存拉取历史消息做关键词检索客服与答疑机器人配合 AstrBot 等框架接入大模型做自动应答。收到提问后调用模型生成回复并自动发送点赞、戳一戳、设置在线状态等互动动作定时任务整点签到提醒、活跃度统计这些场景的 API 都在packages/napcat-onebot/action/下按群、用户、消息分类找起来很直接。跑通场景后有些坑大概率会撞上。 新手最常卡住的几个地方现象启动时报加载 wrapper.node 失败或The specified module could not be found原因Windows Server 默认缺少媒体基础组件mfplat.dll或 QQ 客户端内核文件不完整解决在服务器管理器里勾选安装媒体基础同时确认 QQ 客户端能正常登录必要时重装现象pnpm run dev:shell提示找不到 QQ 路径原因开发脚本从注册表读取 QQ 的UninstallString来定位安装目录QQ 未注册或非标准安装时会失败解决确认 QQ 是通过官方安装包安装的手动核对注册表路径是否可访问现象端口被占用HTTP/WebSocket 服务起不来原因OneBot 或 WebUI 默认端口已被其他程序占用解决改packages/napcat-develop/config/onebot11.json里的端口用netstat -ano | findstr 端口号确认占用方排错顺利的话你已经具备独立折腾的能力了最后看看下一步往哪走。 下一步往哪走官方文档README.md中的 Docs 链接指向 napneko.github.io 系列文档站适合遇到具体功能登录方式、网络接入模式时按需查阅。核心源码packages/napcat-core/apis/是按功能分类的 12 组 API 实现想搞懂某个能力底层怎么跑时从这里入手。OneBot 动作清单packages/napcat-onebot/action/下有全部已支持 action 的示例与实现含example/目录里的调用示例规划机器人功能前值得先翻一遍确认你要的能力是否已实现。NapCatQQ 把 NTQQ 协议端最脏最累的活都替你干完了剩下的就是把创意写成几十行业务代码的事。打开终端克隆仓库跑第一条pnpm install你的第一个机器人已经在路上了 【免费下载链接】NapCatQQModern protocol-side framework based on NTQQ项目地址: https://gitcode.com/gh_mirrors/na/NapCatQQ创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
NapCatQQ从零搭建稳定的NTQQ机器人框架【免费下载链接】NapCatQQModern protocol-side framework based on NTQQ项目地址: https://gitcode.com/gh_mirrors/na/NapCatQQNapCatQQ是一个基于 NTQQ 协议端的 QQ 机器人开发框架帮你把 QQ 的消息、群管理、文件收发能力封装成标准接口。适合刚接触机器人开发的新手和普通开发者读完你能在 10 分钟内跑通开发环境看懂它的模块化架构并规划出自己的第一个机器人。接下来带着你一步步跑通。 它到底能帮你做什么完整的 OneBot 11 接口实现OneBot 是机器人世界通用的消息协议相当于标准插座让你的机器人可以对接任意支持 OneBot 的上层框架。这意味着你能直接调用发群消息、踢人、管理群公告等成熟 API不用自己啃 QQ 协议。基于 NTQQ 的协议端实现NTQQ 是 QQ 当前采用的新版客户端内核NapCatQQ 直接基于它取数而非模拟老协议。这意味着消息收发更贴近真实客户端行为长时运行稳定性更好。低内存长时运行核心走 TypeScript Node.js进程管理带崩溃保护10 秒内多次崩溃会自动抑制。这意味着你在一台低配 Linux 服务器或小主机上挂一整周也不必担心吃光内存。内置 WebUI 管理面板登录、配置 OneBot 网络接入、看日志、重启进程都能在浏览器里完成。这意味着部署后你基本不用再盯终端。NapCatQQ WebUI 的界面配色风格紫蓝渐变的科技感视觉到这里你已经知道它强在哪了下面直接进入安装。 从零跑起来前置条件✅ Node.js 18.0.0 以上版本✅ 已安装 pnpm 包管理器npm i -g pnpm即可✅ Windows 环境已安装 NT 版 QQ 客户端协议端依赖 QQ 客户端内核最简命令序列git clone https://gitcode.com/gh_mirrors/na/NapCatQQ cd NapCatQQ pnpm install pnpm run build:shell pnpm run dev:shell如果报找不到 wrapper.node或versions 文件夹下没有找到版本目录先检查 QQ 客户端是否已安装完整开发脚本会从系统注册表读取 QQ 安装路径并定位其内核文件路径不对就会在加载阶段失败。到这里环境已经跑起来了接下来看看它内部是怎么组织的。 拆开看看核心组件怎么协作整个仓库是一个 pnpm monorepomonorepo 即一个仓库装多个子包方便各模块共享依赖与类型核心子包如下packages/ ├── napcat-core/ # 协议层加载 QQ 内核封装消息/群/文件 API 与事件 ├── napcat-onebot/ # 协议适配把核心能力翻译成 OneBot 11 接口与事件 ├── napcat-shell/ # 独立运行形态不依赖 QQ 客户端进程直接拉起 ├── napcat-framework/ # 框架形态注入到 QQ 客户端内运行 ├── napcat-webui-backend/ # 管理面板后端配置、日志、进程控制 └── napcat-webui-frontend/ # 管理面板前端React 界面napcat-core负责对接 QQ 内核提供MsgApi、GroupApi、FileApi等 12 组原生 API 和事件监听。napcat-onebot负责把上述能力翻译成标准 OneBot 动作action和事件event并管理 HTTP/WebSocket 网络接入。napcat-shell与napcat-framework是两种运行形态前者独立进程跑后者注入 QQ 客户端内跑二者共用 core。模块之间靠workspace依赖互相引用改一个包后重新构建对应模块即可不用全量重装。架构清楚了下面拿它实际做点东西。 拿它实际做点什么群管理机器人监听入群、禁言、卡片变更等通知事件并自动处理。审核入群申请按关键词自动同意或拒绝定时发群公告、维护群名片敏感行为自动禁言并 管理员消息聚合机器人把多群、多人的消息按规则转发到指定频道。转发单条消息或整段聊天记录抓取群文件、私聊文件并转存拉取历史消息做关键词检索客服与答疑机器人配合 AstrBot 等框架接入大模型做自动应答。收到提问后调用模型生成回复并自动发送点赞、戳一戳、设置在线状态等互动动作定时任务整点签到提醒、活跃度统计这些场景的 API 都在packages/napcat-onebot/action/下按群、用户、消息分类找起来很直接。跑通场景后有些坑大概率会撞上。 新手最常卡住的几个地方现象启动时报加载 wrapper.node 失败或The specified module could not be found原因Windows Server 默认缺少媒体基础组件mfplat.dll或 QQ 客户端内核文件不完整解决在服务器管理器里勾选安装媒体基础同时确认 QQ 客户端能正常登录必要时重装现象pnpm run dev:shell提示找不到 QQ 路径原因开发脚本从注册表读取 QQ 的UninstallString来定位安装目录QQ 未注册或非标准安装时会失败解决确认 QQ 是通过官方安装包安装的手动核对注册表路径是否可访问现象端口被占用HTTP/WebSocket 服务起不来原因OneBot 或 WebUI 默认端口已被其他程序占用解决改packages/napcat-develop/config/onebot11.json里的端口用netstat -ano | findstr 端口号确认占用方排错顺利的话你已经具备独立折腾的能力了最后看看下一步往哪走。 下一步往哪走官方文档README.md中的 Docs 链接指向 napneko.github.io 系列文档站适合遇到具体功能登录方式、网络接入模式时按需查阅。核心源码packages/napcat-core/apis/是按功能分类的 12 组 API 实现想搞懂某个能力底层怎么跑时从这里入手。OneBot 动作清单packages/napcat-onebot/action/下有全部已支持 action 的示例与实现含example/目录里的调用示例规划机器人功能前值得先翻一遍确认你要的能力是否已实现。NapCatQQ 把 NTQQ 协议端最脏最累的活都替你干完了剩下的就是把创意写成几十行业务代码的事。打开终端克隆仓库跑第一条pnpm install你的第一个机器人已经在路上了 【免费下载链接】NapCatQQModern protocol-side framework based on NTQQ项目地址: https://gitcode.com/gh_mirrors/na/NapCatQQ创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
