mirror of
https://github.com/NapNeko/NapCatQQ.git
synced 2026-03-01 08:10:25 +00:00
b71a4913eb
Introduce multi-step QQ password login support (captcha and new-device verification) and related OIDB QR handling. - Change login signature fields in NodeIKernelLoginService to binary (Uint8Array) and add unusualDeviceCheckSig. - Update shell base to handle additional result codes (captcha required, new-device, abnormal-device), set login status on success, and register three callbacks: captcha, new-device, and password flows. Use TextEncoder for encoding ticket/randstr/sid and newDevicePullQrCodeSig. - Extend backend WebUiDataRuntime (types and runtime) with set/request methods for captcha and new-device login calls and adjust LoginRuntime types to return richer metadata (needCaptcha, proofWaterUrl, needNewDevice, jumpUrl, newDevicePullQrCodeSig). - Add backend API handlers: CaptchaLogin, NewDeviceLogin, GetNewDeviceQRCode and PollNewDeviceQR; add oidbRequest helper using https to query oidb.tim.qq.com for QR generation and polling. - Wire new handlers into QQLogin router and return structured success responses when further steps are required. - Add frontend components and pages for captcha and new-device verification (new files: 1.html, new_device_verify.tsx, tencent_captcha.tsx) and update existing frontend controllers/pages to integrate the new flows. - Improve error logging and user-facing messages for the new flows. This change enables handling of password-login scenarios requiring captcha or device attestation and provides endpoints to obtain and poll OIDB QR codes for new-device verification.
NapCat
Modern protocol-side framework implemented based on NTQQ.
云起兮风生，心向远方兮路未曾至.
New Feature
在 v4.8.115+ 版本开始
- NapCatQQ 支持 Stream Api
- 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 页面下载最新版本
首次使用请务必查看如下文档看使用教程
项目非盈利，涉及 对接问题/基础问题/下层框架问题 请自行搜索解决，本项目社区不提供此类解答。
Link
| Docs |  |
 |
 |
|---|
| Docs |  |
 |
 |
|---|
| QQ Group |  |
 |
 |
 |
|---|
| Telegram |  |
|---|
| DeepWiki |  |
|---|
请不要在其余社区提及本项目(包括其余协议端/相关应用端项目)引发争论，如有建议到达官方交流群讨论或PR。
Thanks
-
Lagrange 对本项目的大力支持 参考部分代码 已获授权
-
AstrBot 是完美适配本项目的LLM Bot框架 在此推荐一下
-
MaiBot 一只赛博群友 麦麦 Bot框架 在此推荐一下
-
qq-chat-exporter 基于NapCat的消息导出工具 在此推荐一下
-
不过最最重要的 还是需要感谢屏幕前的你哦~
License
本项目采用 混合协议 开源，因此使用本项目时，你需要注意以下几点：
- 第三方库代码或修改部分遵循其原始开源许可.
- 本项目获取部分项目授权而不受部分约束
- 项目其余逻辑代码采用本仓库开源许可.
本仓库仅用于提高易用性，实现消息推送类功能，此外，禁止任何项目未经仓库主作者授权基于 NapCat 代码开发。使用请遵守当地法律法规，由此造成的问题由使用者和提供违规使用教程者负责。