NapNeko/NapCatQQ

NapCatQQ 是一个协议端框架：它让开发者通过 OneBot 11 标准与 QQ 对话，而不是从零实现 QQ 协议。它不是机器人框架本身，而是 QQ 与你的机器人代码之间的适配层。

解决什么问题

你想让 QQ 群或私聊自动响应命令、推送通知，或者接入大模型机器人。过去要么逆向 QQ 内部协议，要么依赖非官方库，客户端一更新就可能失效。NapCatQQ 与 NTQQ 配合运行，把收到的消息和发起的调用转换成 OneBot 11 事件与 API 动作。配置完成后，机器人代码不用直接处理 QQ 原生协议，就能收发 QQ 消息。

有什么不同

NapCatQQ 的核心是在 NTQQ 协议侧工作，而不是靠界面自动化或另起一个客户端。README 表示它完整实现了大部分标准 OneBot 11 接口，因此已有 OneBot 11 机器人只需少量改动就能接入。跑在 NTQQ 上也意味着它跟随真实 QQ 客户端的行为，而不是自行实现一套协议。代价是 NapCat 只负责协议层：你仍然需要机器人框架或自己的事件循环来决定回什么。README 还推荐 SnowLuma 作为 NapCat 的 GUI 替代品，说明图形管理并不是这个仓库的重点。

谁值得试

适合已经有 QQ 机器人想法、并且能运行本地服务、编辑配置的开发者。如果你使用的机器人框架兼容 OneBot 11，或者你愿意写 HTTP/WebSocket 客户端，NapCat 能省掉与 QQ 通信中最难的部分。如果你期待的是开箱即用、带插件和网页面板的成品机器人，它并不合适：这个项目提供协议适配器，不提供机器人逻辑。README 说明对接问题、基础问题和下层框架问题需要自行搜索解决，社区不提供此类解答，因此从一开始就要有独立排查的准备。

使用条件与边界

README 要求首次使用务必先看文档，项目非盈利，社区解答范围有限。这意味着安装和配置需要自己负责，社区渠道不是基础安装问题的帮助台。许可证是混合协议：第三方代码保留原始开源许可，部分代码经授权使用而不受某些约束，其余逻辑代码遵循本仓库的开源许可。README 明确禁止未经作者授权基于 NapCat 代码开发其他项目，这排除了某些衍生或商业复用。它还把项目定位为提升易用性、实现消息推送类功能，因此要确认你的用途符合这一范围以及当地法律法规。

HotRepo 点评

HotRepo 对 NapCatQQ 只有一个带日期的信号：2026-10-25 的 TypeScript 周榜观察，当周新增 479 星，排名第 17。存储覆盖中没有日榜历史，因此仅凭这一个样本无法判断这种关注能否持续。仓库创建至今 943 天，只能说明项目年龄，不能说明当前维护质量。采用前请核对你的机器人框架对 OneBot 11 的兼容程度是否覆盖 NapCat 文档中列出的接口，这比星数更重要。

项目源码与说明