This commit is contained in:
天天的鸟蛋蛋 committed
1 parent
b9655a5ab1
commit
e292824161
122 files changed
+90002
-69
No files matched your search
@@ -1,87 +1,70 @@
|
||||
<img src="https://napneko.github.io/assets/newnewlogo.png" width = "305" height = "411" alt="NapCat" align=right />
|
||||
<div align="center">
|
||||
# SnowCat 雪猫
|
||||
|
||||
# NapCat
|
||||
> 雪取自 [SnowLuma](https://github.com/SnowLuma/SnowLuma)，猫取自 [NapCat](https://github.com/NapNeko/NapCatQQ)。
|
||||
> 两个先行者铺下的路，自此由后来者接续。**上游在，我们跟；上游没了，我们扛。**
|
||||
|
||||
_Modern protocol-side framework implemented based on NTQQ._
|
||||
SnowCat 是一个由社区开发者维护的第三方 QQ 客户端：让开发者自己的智能体，接入开发者自己的生态。NapCat 4.18.28 底座 + SnowLuma 独门能力融合，全功能运行于 **QQ 9.9.37-54395（官方最新版）主进程内**。
|
||||
|
||||
> 云起兮风生，心向远方兮路未曾至.
|
||||
## 核心特性
|
||||
|
||||
</div>
|
||||
- **QQ 9.9.37-54395 全功能在役**：通过 V8 编译器通道注入（详见[制作文档](docs/dev/FROM-P1-TO-V8.md)），QQ 本体一字节未动
|
||||
- **OneBot v11 全动作**：正向/反向 WS、HTTP、HTTP SSE 全接入方式
|
||||
- **MCP 接入**：Streamable HTTP `/mcp`，全部 OneBot 动作自动暴露为 MCP 工具
|
||||
- **56 项独门动作移植**（采自 SnowLuma）：QZone 全家桶、群相册、精华、打卡、装扮、闪照管理、收藏、点赞……
|
||||
- **Packet 发包**：offset 表驱动，逐版本维护
|
||||
- **雪猫 WebUI**：React + Tailwind + HeroUI 全面重制（总览/登录/网络/关于全页面）
|
||||
- **便携环境制作器**：官方最新包一键解包、一键便携化
|
||||
- **稳定线**：连接退避 + 真人节奏抖动 + 预算 + 熔断
|
||||
|
||||
---
|
||||
## 快速开始
|
||||
|
||||
## New Framework ?
|
||||
```powershell
|
||||
# 1. 解包官方 QQ 安装包为便携结构（也可手动从官网下载安装包）
|
||||
./tools/snowcat-qq-unpack.ps1 -Installer QQ_9.9.37_261103_x64_01.exe
|
||||
|
||||
可以试试更新更好用的 [SnowLuma](https://github.com/SnowLuma/SnowLuma) 作为NapCat Gui替代品。
|
||||
# 2. 一键启动（部署 V8 通道 + 启动 + 健康检查）
|
||||
./tools/build/snowcat-run.ps1
|
||||
|
||||
## Welcome
|
||||
# 3. WebUI 就绪 → http://127.0.0.1:6099/webui/
|
||||
```
|
||||
|
||||
- NapCatQQ is a modern implementation of the Bot protocol based on NTQQ.
|
||||
- NapCatQQ 是现代化的基于 NTQQ 的 Bot 协议端实现
|
||||
## 文档
|
||||
|
||||
## Feature
|
||||
| 文档 | 内容 |
|
||||
|---|---|
|
||||
| [开源公告](docs/ANNOUNCEMENT.md) | 立场声明 · 生态主张 · 给官方的四个问题 |
|
||||
| [从 P1 到 V8：完整攻关实录](docs/dev/FROM-P1-TO-V8.md) | 9.9.37 防护体系、全部死路档案、V8 通道原理、内核适配 |
|
||||
| [架构审计](docs/dev/ARCHITECTURE-AUDIT.md) | 启动链、解包机制、逐字节审计结论 |
|
||||
|
||||
- **Easy to Use**
|
||||
- 作为初学者能够轻松使用.
|
||||
- **Quick and Efficient**
|
||||
- 在低内存操作系统长时运行.
|
||||
- **Rich API Interface**
|
||||
- 完整实现了大部分标准接口.
|
||||
- **Stable and Reliable**
|
||||
- 持续稳定的开发与维护.
|
||||
## 仓库结构
|
||||
|
||||
## Quick Start
|
||||
```
|
||||
tools/
|
||||
snowcat-qq-unpack.ps1 官方安装包解包器
|
||||
snowcat-launch.ps1 零硬改启动器
|
||||
snowcat-portable-maker.ps1 便携制作器
|
||||
build/
|
||||
winmm-v8.c/.dll V8 通道本体（源码+成品）
|
||||
snowcat-boot.js 引导脚本
|
||||
snowcat-run.ps1 9.9.37 一键启动器
|
||||
snowcat-hook.c 研究：观测 hook
|
||||
snowcat-inject.c 研究：注入器
|
||||
snowcat-reflect.c 研究：反射注入器
|
||||
webui-static/ WebUI 前端成品
|
||||
docs/
|
||||
ANNOUNCEMENT.md 开源公告（终稿）
|
||||
dev/FROM-P1-TO-V8.md 攻关制作文档
|
||||
dev/ARCHITECTURE-AUDIT.md 架构审计
|
||||
```
|
||||
|
||||
可前往 [Release](https://github.com/NapNeko/NapCatQQ/releases/) 页面下载最新版本
|
||||
## 关于账号安全，说实话
|
||||
|
||||
**首次使用**请务必查看如下文档看使用教程
|
||||
第三方客户端无法在绝对意义上保证账号安全——这是事实，我们不回避。但不滥用，即是安全；有滥用，责任在使用者，不在工具，更不在社区。运行时全部在本地，代码全量开源，来源全部署名。**黑箱要求人「相信」，白盒只要求人「查看」。我们不索取信任，只提供证据。**
|
||||
|
||||
> 项目非盈利，涉及 对接问题/基础问题/下层框架问题 请自行搜索解决，本项目社区不提供此类解答。
|
||||
## 致谢
|
||||
|
||||
## Link
|
||||
感谢 NapCat（126,400+ ⭐）与 SnowLuma（283 ⭐）。猫谢猫，雪接雪。你们留下的星，我们记下了，也不会让它们落空。
|
||||
|
||||
| Docs | [](https://napneko.github.io/) | [](https://doc.napneko.icu/) | [](https://napcat.napneko.icu/) |
|
||||
|:-:|:-:|:-:|:-:|
|
||||
Ending 不是终点，是 SnowCat 的起点。
|
||||
|
||||
| Docs | [](https://napneko.pages.dev/) | [](https://napcat.top/) | [](https://napcat.top/) |
|
||||
|:-:|:-:|:-:|:-:|
|
||||
|
||||
| QQ Group | [](https://qm.qq.com/q/E4nfkGD6oK) | [](https://qm.qq.com/q/XyiyGPqa42) | [](https://qm.qq.com/q/gq18RH7o7S) | [](https://qm.qq.com/q/VwpnklcXqo) |
|
||||
|:-:|:-:|:-:|:-:|:-:|
|
||||
|
||||
| Telegram | [](https://t.me/napcatqq) |
|
||||
|:-:|:-:|
|
||||
|
||||
| DeepWiki | [](https://deepwiki.com/NapNeko/NapCatQQ) |
|
||||
|:-:|:-:|
|
||||
|
||||
> QQ群因为特殊原因需要入群密钥，请在webui关于页面获取，仅最新的100个版本以内有效。
|
||||
|
||||
社区相关日后会进一步加强审核，并严格限制一定时间的入群人数，请具备一定编程基础和问题解决能力再申请入群。
|
||||
|
||||
[困困猫猫的高中](https://qm.qq.com/q/14aUVclRUA)
|
||||
|
||||
## Thanks
|
||||
|
||||
- [Lagrange](https://github.com/LagrangeDev/Lagrange.Core) 对本项目的大力支持 参考部分代码 已获授权
|
||||
|
||||
- [AstrBot](https://github.com/AstrBotDevs/AstrBot) 是完美适配本项目的LLM Bot框架 在此推荐一下
|
||||
|
||||
- [MaiBot](https://github.com/MaiM-with-u/MaiBot) 一只赛博群友 麦麦 Bot框架 在此推荐一下
|
||||
|
||||
- [qq-chat-exporter](https://github.com/shuakami/qq-chat-exporter/) 基于NapCat的消息导出工具 在此推荐一下
|
||||
|
||||
- 不过最最重要的 还是需要感谢屏幕前的你哦~
|
||||
|
||||
---
|
||||
|
||||
## License
|
||||
|
||||
本项目采用 混合协议 开源，因此使用本项目时，你需要注意以下几点：
|
||||
|
||||
1. 第三方库代码或修改部分遵循其原始开源许可.
|
||||
2. 本项目获取部分项目授权而不受部分约束
|
||||
2. 项目其余逻辑代码采用[本仓库开源许可](./LICENSE).
|
||||
|
||||
**本仓库仅用于提高易用性，实现消息推送类功能，此外，禁止任何项目未经仓库主作者授权基于 NapCat 代码开发。使用请遵守当地法律法规，由此造成的问题由使用者和提供违规使用教程者负责。**
|
||||
**SnowCat 开发组**
|
||||
Reference in new issue
Block a user