[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"$f7sr4mt6livwi":3},{"code":4,"message":5,"data":6,"timestamp":31},10000,"success",{"full_name":7,"position":8,"description":9,"language":10,"stars":11,"forks":12,"stars_gained":13,"age_days":14,"hn_threads":15,"one_liner":16,"summary_md":17,"topic":18,"github_topics":21,"license":27,"homepage":28,"updated_at":29,"history":30},"NapNeko\u002FNapCatQQ",17,"Modern protocol-side framework based on NTQQ","TypeScript",11514,838,479,943,[],"把 NTQQ 的 QQ 消息转成 OneBot 11 协议，供开发者用 TypeScript 等语言写聊天机器人。","NapCatQQ 是一个协议端框架：它让开发者通过 OneBot 11 标准与 QQ 对话，而不是从零实现 QQ 协议。它不是机器人框架本身，而是 QQ 与你的机器人代码之间的适配层。\n\n## 解决什么问题\n\n你想让 QQ 群或私聊自动响应命令、推送通知，或者接入大模型机器人。过去要么逆向 QQ 内部协议，要么依赖非官方库，客户端一更新就可能失效。NapCatQQ 与 NTQQ 配合运行，把收到的消息和发起的调用转换成 OneBot 11 事件与 API 动作。配置完成后，机器人代码不用直接处理 QQ 原生协议，就能收发 QQ 消息。\n\n## 有什么不同\n\nNapCatQQ 的核心是在 NTQQ 协议侧工作，而不是靠界面自动化或另起一个客户端。README 表示它完整实现了大部分标准 OneBot 11 接口，因此已有 OneBot 11 机器人只需少量改动就能接入。跑在 NTQQ 上也意味着它跟随真实 QQ 客户端的行为，而不是自行实现一套协议。代价是 NapCat 只负责协议层：你仍然需要机器人框架或自己的事件循环来决定回什么。README 还推荐 SnowLuma 作为 NapCat 的 GUI 替代品，说明图形管理并不是这个仓库的重点。\n\n## 谁值得试\n\n适合已经有 QQ 机器人想法、并且能运行本地服务、编辑配置的开发者。如果你使用的机器人框架兼容 OneBot 11，或者你愿意写 HTTP\u002FWebSocket 客户端，NapCat 能省掉与 QQ 通信中最难的部分。如果你期待的是开箱即用、带插件和网页面板的成品机器人，它并不合适：这个项目提供协议适配器，不提供机器人逻辑。README 说明对接问题、基础问题和下层框架问题需要自行搜索解决，社区不提供此类解答，因此从一开始就要有独立排查的准备。\n\n## 使用条件与边界\n\nREADME 要求首次使用务必先看文档，项目非盈利，社区解答范围有限。这意味着安装和配置需要自己负责，社区渠道不是基础安装问题的帮助台。许可证是混合协议：第三方代码保留原始开源许可，部分代码经授权使用而不受某些约束，其余逻辑代码遵循本仓库的开源许可。README 明确禁止未经作者授权基于 NapCat 代码开发其他项目，这排除了某些衍生或商业复用。它还把项目定位为提升易用性、实现消息推送类功能，因此要确认你的用途符合这一范围以及当地法律法规。\n\n## HotRepo 点评\n\nHotRepo 对 NapCatQQ 只有一个带日期的信号：2026-10-25 的 TypeScript 周榜观察，当周新增 479 星，排名第 17。存储覆盖中没有日榜历史，因此仅凭这一个样本无法判断这种关注能否持续。仓库创建至今 943 天，只能说明项目年龄，不能说明当前维护质量。采用前请核对你的机器人框架对 OneBot 11 的兼容程度是否覆盖 NapCat 文档中列出的接口，这比星数更重要。\n\n[项目源码与说明](https:\u002F\u002Fgithub.com\u002FNapNeko\u002FNapCatQQ)",{"slug":19,"name":20},"developer-tools","开发工具",[22,23,24,25,26],"napcat","ncqq","ntqq","onebot","onebot11","NOASSERTION","https:\u002F\u002Fnapneko.github.io","2026-10-25T12:17:15Z",[],1792969078]