Modern protocol-side framework implemented based on NTQQ
Go to file
手瓜一十雪 31bb1e5dee Add emoji like event handling to core and onebot
Introduces a typed event emitter for app events in napcat-core, specifically for emoji like events in groups. OlPushService now emits 'event:emoji_like' when a group reaction is detected. napcat-onebot listens for this event and emits corresponding OneBot events. Refactors and adds missing type definitions and improves method formatting for consistency.
2025-11-15 10:45:02 +08:00
.github Improve error handling in release workflow 2025-11-14 23:00:20 +08:00
.vscode Enable source maps and improve debugging support 2025-11-14 21:21:49 +08:00
packages Add emoji like event handling to core and onebot 2025-11-15 10:45:02 +08:00
.editorconfig refactor: 优化eslint配置,提升代码质量 (#1341) 2025-11-03 16:30:45 +08:00
.gitignore Add napcat-develop package and update scripts 2025-11-13 19:30:33 +08:00
CODE_OF_CONDUCT.md doc: code of conduct 2025-03-16 09:33:06 +08:00
LICENSE update: Limited Redistribution License 2024-11-23 18:52:53 +08:00
logo.png refactor: 整体重构 (#1381) 2025-11-13 15:39:42 +08:00
package.json Add service handler registration and DI support 2025-11-14 22:20:33 +08:00
pnpm-workspace.yaml refactor: 整体重构 (#1381) 2025-11-13 15:39:42 +08: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

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 代码开发。使用请遵守当地法律法规,由此造成的问题由使用者和提供违规使用教程者负责。