Modern protocol-side framework implemented based on NTQQ
Go to file
手瓜一十雪 9ce51fb082 fix: #1380
2025-11-13 10:47:40 +08:00
.github ci: dispatch docker build workflow after release (#1078) 2025-06-15 23:26:17 +08:00
.vscode refactor: 优化eslint配置,提升代码质量 (#1341) 2025-11-03 16:30:45 +08:00
external feat: Update QQ version data and add macOS ARM64 native module 2025-10-14 20:32:41 +08:00
launcher Update qqnt.json to version 9.9.22-40990 2025-10-31 00:11:28 +08:00
napcat.webui fix: #1367 2025-11-12 13:50:35 +08:00
napiloader Add napiloader scripts and binaries, update Vite config 2025-11-09 12:54:15 +08:00
script feat: 移除无用代码 2024-11-16 12:45:27 +08:00
src fix: #1380 2025-11-13 10:47:40 +08:00
tests feat: 修复一些问题 2025-11-07 19:35:35 +08:00
.editorconfig refactor: 优化eslint配置,提升代码质量 (#1341) 2025-11-03 16:30:45 +08:00
.env.framework fix: typo 2024-08-10 17:51:25 +08:00
.env.shell build: V2.0.0 fast 2024-08-12 02:37:20 +08:00
.env.shell-analysis Pr enhance (#1176) 2025-08-06 20:37:45 +08:00
.env.universal feat: Universal Package (#578) 2024-11-29 15:11:35 +08:00
.gitignore feat: 修复一些问题 2025-11-07 19:35:35 +08:00
CODE_OF_CONDUCT.md doc: code of conduct 2025-03-16 09:33:06 +08:00
eslint.config.mjs refactor: 优化eslint配置,提升代码质量 (#1341) 2025-11-03 16:30:45 +08:00
LICENSE update: Limited Redistribution License 2024-11-23 18:52:53 +08:00
logo.png feat: 调整logo 2024-12-25 12:24:03 +08:00
manifest.json release: v4.9.41 2025-11-13 01:28:44 +00:00
package-lock.json feat: add Node NapCat Test 2025-11-06 17:57:57 +08:00
package.json release: v4.9.41 2025-11-13 01:28:44 +00:00
README.md Remove development guide from README 2025-11-05 12:24:21 +08:00
SECURITY.md doc: security 2025-03-16 09:36:27 +08:00
tsconfig.json refactor: 优化eslint配置,提升代码质量 (#1341) 2025-11-03 16:30:45 +08:00
vite-plugin-performance-monitor.ts Add explicit type annotations to AST traversal paths 2025-08-15 19:02:53 +08:00
vite.config.ts Add napiloader scripts and binaries, update Vite config 2025-11-09 12:54:15 +08:00

NapCat

NapCat

Modern protocol-side framework implemented based on NTQQ.

云起兮风生,心向远方兮路未曾至.


New Feature

在 v4.8.115+ 版本开始

  1. NapCatQQ 支持 Stream Api
  2. NapCatQQ 推荐 message_id/user_id/group_id 均使用字符串类型
  • [1] 解决 Docker/跨设备/大文件 的多媒体上下传问题
  • [2] 采用字符串可以解决扩展到int64的问题同时也可以解决部分语言如JavaScript对大整数支持不佳的问题增加极少成本。

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 页面下载最新版本

首次使用请务必查看如下文档看使用教程

项目非盈利,对接问题/基础问题/下层框架问题 请自行搜索解决,本项目社区不提供此类解答。

Docs Github.IO Cloudflare.Worker Cloudflare.HKServer
Docs Cloudflare.Pages Server.Other NapCat.Wiki
QQ Group QQ Group#4 QQ Group#3 QQ Group#2 QQ Group#1
Telegram Telegram
DeepWiki Ask DeepWiki

请不要在其余社区提及本项目(包括其余协议端/相关应用端项目)引发争论如有建议到达官方交流群讨论或PR。

Thanks

  • Lagrange 对本项目的大力支持 参考部分代码 已获授权

  • AstrBot 是完美适配本项目的LLM Bot框架 在此推荐一下

  • MaiBot 一只赛博群友 麦麦 Bot框架 在此推荐一下

  • qq-chat-exporter 基于NapCat的消息导出工具 在此推荐一下

  • 不过最最重要的 还是需要感谢屏幕前的你哦~


License

本项目采用 混合协议 开源,因此使用本项目时,你需要注意以下几点:

  1. 第三方库代码或修改部分遵循其原始开源许可.
  2. 本项目获取部分项目授权而不受部分约束
  3. 项目其余逻辑代码采用本仓库开源许可.

本仓库仅用于提高易用性,实现消息推送类功能,此外,禁止任何项目未经仓库主作者授权基于 NapCat 代码开发。使用请遵守当地法律法规,由此造成的问题由使用者和提供违规使用教程者负责。