Shxiao 9a06abbbbd fix: 静默离线(无 KickedOffLine 通知)后自动恢复登录 (#2080)
服务端静默断开会话时不会下发 KickedOffLine,onSelfStatusChanged 仅把
selfInfo.online 置为 false 并打一行日志,没有任何消费者:进程与 WS 连接
继续存活,下游 OneBot 客户端长时间收不到任何事件。

- core 在 在线 -> 离线 的跳变上广播新的 SelfOffline 事件(重复的 status=20
  不重复触发,未登录时不触发)
- framework/shell 复用 #2030 已建立的下线恢复链路:同步 WebUI -> 重启 Worker
  -> 快速登录
- 静默离线可能是临时状态,重启前重新确认仍未恢复,避免误重启 Worker

Closes #2071
2026-10-05 12:06:22 +08:00
2026-06-20 12:46:49 +08:00
2025-03-16 09:33:06 +08:00
2024-11-23 18:52:53 +08:00
2025-11-13 15:39:42 +08:00
2026-02-05 12:56:53 +08:00
2026-06-09 23:45:19 +08:00
2025-03-16 09:36:27 +08:00

NapCat

NapCat

Modern protocol-side framework implemented based on NTQQ.

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


New Framework ?

可以试试更新更好用的 SnowLuma 作为NapCat Gui替代品。

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.Top
QQ Group NapCat Family Group 4 NapCat Family Group 3 NapCat Family Group 2 NapCat Family Group 1
Telegram Telegram
DeepWiki Ask DeepWiki

QQ群因为特殊原因需要入群密钥,请在webui关于页面获取,仅最新的100个版本以内有效。

社区相关日后会进一步加强审核,并严格限制一定时间的入群人数,请具备一定编程基础和问题解决能力再申请入群。

困困猫猫的高中

Thanks

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

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

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

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

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


License

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

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

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

S
Description
No description provided
Readme
385 MiB
Languages
TypeScript 97.7%
JavaScript 1.3%
HTML 0.4%
Python 0.2%
Batchfile 0.2%
Other 0.2%