12,684
stars
1,704
forks
37
watchers
761
prs
1,282
issues
492
releases
85
discussions
README
NapCat _Modern protocol-side framework implemented based on NTQQ._ 云起兮风生,心向远方兮路未曾至. --- Welcome - NapCatQQ is a modern implementation of the Bot protocol based on NTQQ. - NapCatQQ 是现代化的基于 NTQQ 的 Bot 协议端实现 Feature - Easy to Use - 作为初学者能够轻松使用. - Quick and Efficient - 在低内存操作系统长时运行. - Rich API Interface - 完整实现了大部分标准接口. - Stable and Reliable - 持续稳定的开发与维护. Quick Start 可前往 Release 页面下载最新版本 首次使用请务必查看如下文档看使用教程 项目非盈利,涉及 对接问题/基础问题/下层框架问题 请自行搜索解决,本项目社区不提供此类解答。 Link | Docs | | | | |:-:|:-:|:-:|:-:| | Docs | | | | |:-:|:-:|:-:|:-:| | QQ Group | | | | | |:-:|:-:|:-:|:-:|:-:| | Telegram | | |:-:|:-:| | DeepWiki | | |:-:|:-:| QQ群因为特殊原因需要入群密钥,请在webui关于页面获取,仅最新的100个版本以内有效。 社区相关日后会进一步加强审核,并严格限制一定时间的入群人数,请具备一定编程基础和问题解决能力再申请入群。 困困猫猫的高中 Thanks - Lagrange 对本项目的大力支持 参考部分代码 已获授权 - AstrBot 是完美适配本项目的LLM Bot框架 在此推荐一下 - MaiBot 一只赛博群友 麦麦 Bot框架 在此推荐一下 - qq-chat-exporter 基于NapCat的消息导出工具 在此推荐一下 - 不过最最重要的 还是需要感谢屏幕前的你哦~ --- Ending 如果感兴趣可以自行Fork,不再提供除版本更新以外内容,直到失效,如果追求稳定性更推荐官方Bot,非常感谢一路陪伴。 License 本项目采用 混合协议 开源,因此使用本项目时,你需要注意以下几点: 1. 第三方库代码或修改部分遵循其原始开源许可. 2. 本项目获取部分项目授权而不受部分约束 2. 项目其余逻辑代码采用本仓库开源许可. 本仓库仅用于提高易用性,实现消息推送类功能,此外,禁止任何项目未经仓库主作者授权基于 NapCat 代码开发。使用请遵守当地法律法规,由此造成的问题由使用者和提供违规使用教程者负责。
Top issues
#2150[FEAT] 关于对NTQQ现已支持手机验证码的建议2 comments · 2026-10-31#2165[BUG] [WebUI] 浏览器里存有过期凭证时,URL 中的 ?token= 自动登录失效,只能手动输入 Token1 comments · 2026-11-06#2164[BUG] Linux Docker 4.18.42 + QQ 3.2.34-53644:表情操作成功但未收到 group_msg_emoji_like(有恢复对照)1 comments · 2026-11-05#2163[BUG] QQNT 9.9.37-54395:NapCat 4.18.42 注入后无二维码、无 30011 端口(Worker 退出)1 comments · 2026-11-04#2162[BUG] 极短语音(1~2 秒)调用 fetch_ptt_text 必然报「获取语音转文字结果失败」1 comments · 2026-11-03#2149[BUG]QQ 9.9.33-52230 + 最新 Shell:注入成功但核心不启动,6099/3001 都不开,fileLog 也无输出1 comments · 2026-10-31#2170【Bug】4.18.42 FFmpeg 适配器优先选择系统命令行 ffmpeg(不支持 ntsilk_s16le)导致语音发送失败,且媒体初始化失败时未回退 Native Addon0 comments · 2026-11-08#2159[BUG] Login succeeds but OneBot adapters never start: stuck after '已通知主进程登录成功' (3000/3001 never listen; reproduced on 4.18.37 and 4.18.42 standalone builds)0 comments · 2026-11-02
Discussions
#2176我超威企鹅大手0 comments · 2026-11-09#2169标题:关于 NapCat 个人非商业 Mac Docker 部署的授权确认0 comments · 2026-11-08#2160反馈0 comments · 2026-11-03#2117平台检测与功能限制0 comments · 2026-10-22#2115发行版提供VBS脚本,允许cmd.exe隐藏0 comments · 2026-10-21#2093Echo 项目修改并随包分发 NapCat 的授权咨询0 comments · 2026-10-07#2072Linux Docker 单独运行约 108 分钟后登录失效,如何进一步区分设备环境与启动方式?1 comments · 2026-09-24#2051Napcat突然活了?0 comments · 2026-09-14
Latest release
NapCat v4.18.42 v4.18.42 2026-10-30NapCat v4.18.42 使用文档 · Shell 安装与兼容说明 更新 - remove: test file (3420f0b7) - feat(qzone): 添加空友爱看推荐与互动接口 (2125) (ba0a53dd) - feat(qzone): 完善空间 API 并兼容 SnowLuma API 格式 (2124) (49ecfe0f) - fix: 2136 移除废弃接口 (c15f1498) - fix: 2133 2114 (f7ab795e) - fix: 2118 (b2b7ed87) - feat: 支持新版本 (162c6db1) - feat: 2135 (093b3bf4) - fix: 不要测试了,测试它干嘛 (4056f04b) - feat: new wrapper (e8fbda4b) - fix: 2106 (93358432) 完整变更