NapCatQQ V4.4.2:兼容最新 QQ 31245,新增 SSE 推送

发布时间:2026/11/4 1:15:37
NapCatQQ V4.4.2:兼容最新 QQ 31245,新增 SSE 推送

NapCatQQ V4.4.2:兼容最新 QQ 31245,新增 SSE 推送

【免费下载链接】NapCatQQModern protocol-side framework based on NTQQ项目地址: https://gitcode.com/gh_mirrors/na/NapCatQQ

NapCatQQ 发布 V4.4.2,主要服务 QQ 机器人开发者:一方面解决 QQ 新版本带来的兼容问题,另一方面给实时事件补上了 SSE 长连接推送。

一张表看懂 V4.4.2 改了什么

改动位置带来的影响
QQ 版本支持 Build 31245,覆盖 Windows、Linux、MacOS
合并转发消息image 元素新增summary、sub_type字段
文件消息重写大小上报机制,支持按文件名发送
rkey 缓存获取流程精简,省掉多余请求
SSE 推送完整实现 Server-Sent Events 长连接,并修复在线配置问题
边缘情况昵称为空不再崩溃,接龙表情返回resultId、chainCount

合并转发 image 元素:拿到 summary 与 sub_type

合并转发里的图片元素过去只有图片本身,机器人看到图却看不到它的上下文,还原消息时经常丢信息。

这次 image 元素补上了summary和sub_type两个字段,图片的摘要文本和子类型都能拿到,转发内容还原得更贴近原样。

如果你的机器人做消息存档或转发重发,直接读这两个字段即可,不用再靠猜测补全。

SSE 长连接推送:实时事件不用再轮询

想要实时拿到事件,此前基本靠 WebSocket 或 HTTP 回调,想自己"等推送"就只能写轮询脚本。

这次把 SSE(Server-Sent Events)完整做出来了:基于一条 HTTP 长连接,服务器把每个事件主动发到客户端,在线修改 SSE 设置的故障也一并修掉(据更新说明)。

消息通知、状态监控这类高频实时场景可以直接切到 SSE,连接维护比自写轮询省心。

其他小改动

  • 文件消息模块重写,修掉大小读不准的老毛病,还多出按文件名发送的能力
  • rkey 缓存流程精简,少跑几次多余请求,消息处理更快
  • 昵称为空的异常数据不再导致崩溃
  • 接龙表情完整支持,事件里带出resultId、chainCount
  • Windows 提供绿色包,有头、无头两种形态,按需选择

升级实用提醒

  • Windows 用户先装好最新 VC++ 运行库再启动,避免缺依赖跑不起来
  • 绿色包分有头和无头两种,下载前看清楚自己要哪种
  • 开启 SSE 后建议重启一次机器人,确认推送链路正常

后续版本会继续跟进 QQ 端的变动。升级后遇到问题,可以先翻仓库里的 README.md 看最新说明。

【免费下载链接】NapCatQQModern protocol-side framework based on NTQQ项目地址: https://gitcode.com/gh_mirrors/na/NapCatQQ

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考