SnowCat 雪猫

雪取自 SnowLuma · 猫取自 NapCat

两个先行者铺下的路，自此由后来者接续。

上游在，我们跟；上游没了，我们扛。

社区开发者维护的第三方 QQ 客户端 —— 让开发者自己的智能体，接入开发者自己的生态

NapCat 4.18.28 底座 × SnowLuma 独门能力融合，全功能运行于 QQ 9.9.37-54395（官方最新版）主进程内，QQ 本体一字节未动。

✨ 核心特性

	特性	说明
🔌	QQ 9.9.37 全功能在役	V8 编译器通道注入，官方最新版原生运行，QQ 本体零改动
🤖	OneBot v11 全动作	正向 / 反向 WS、HTTP、HTTP SSE 全接入方式
🧩	MCP 接入	Streamable HTTP `/mcp`，全部动作自动暴露为 MCP 工具
🎁	56 项独门动作	采自 SnowLuma：QZone 全家桶、群相册、精华、打卡、装扮、闪照、收藏……
📦	Packet 发包	offset 表驱动，逐版本维护
🖥️	雪猫 WebUI	React + Tailwind + HeroUI 全面重制
🛠️	便携环境制作器	官方最新包一键解包、一键便携化
🛡️	稳定线	连接退避 + 真人节奏抖动 + 预算 + 熔断

🚀 快速开始

# 1️⃣ 解包官方 QQ 安装包为便携结构（也可手动从官网下载安装包）
./release-tools/snowcat-qq-unpack.ps1 -Installer QQ_9.9.37_261103_x64_01.exe

# 2️⃣ 一键启动（部署 V8 通道 + 启动 + 45s 健康检查）
./release-tools/build/snowcat-run.ps1

# 3️⃣ WebUI 就绪
#    → http://127.0.0.1:6099/webui/

📚 文档

文档	内容
📜 开源公告	立场声明 · 生态主张 · 给官方的四个问题
🔬 从 P1 到 V8	9.9.37 防护体系 · 全部死路档案 · V8 通道原理 · 内核适配
🏗️ 架构审计	启动链 · 解包机制 · 逐字节审计结论

🗂️ 仓库结构

SnowCatQQ
├── 📦 packages/              ⭐ 26 包底层全源码（TS）
│   ├── snowcat-core/           NT 内核 API + listener + Packet 发包
│   ├── snowcat-onebot/         OneBot v11 全动作 + MCP 适配器 + 稳定线
│   ├── snowcat-webui-frontend/ 雪猫控制台（React + HeroUI）
│   ├── snowcat-webui-backend/  WebUI 服务端
│   ├── snowcat-shell/          单文件 bundle 出口（napcat.mjs）
│   └── snowcat-native/         napi2native / MoeHoo / ffmpeg / pty
├── 🛠️ release-tools/         成品工具
│   ├── snowcat-qq-unpack.ps1   官方安装包解包器
│   ├── snowcat-launch.ps1      零硬改启动器
│   ├── snowcat-portable-maker  便携制作器
│   └── build/
│       ├── winmm-v8.c/.dll     V8 通道本体（源码 + 成品）
│       ├── snowcat-boot.js     引导脚本
│       └── snowcat-run.ps1     一键启动器
└── 📖 docs-open/              文档（公告 + 制作 + 审计）

⚙️ 运行时栈

QQ 9.9.37-54395 x64（官方原版，一字节未动）
 └─ winmm.dll（V8 通道代理：MinHook 挂 v8::ScriptCompiler）
     └─ QQ 主进程内：napcat.mjs（3.25MB 单文件 bundle）
         ├─ OneBot v11 ── 反向 WS / HTTP / MCP (/mcp)
         ├─ WebUI ──────── React + HeroUI（:6099）
         └─ Packet ─────── napi2native + MoeHoo（offset 表驱动）

🔐 关于账号安全，说实话

第三方客户端无法在绝对意义上保证账号安全——这是事实，我们不回避。

但不滥用，即是安全；有滥用，责任在使用者，不在工具，更不在社区。

运行时全部在本地，无任何第三方外发
代码全量开源，每一行可查
来源全部署名，致敬两个上游

黑箱要求人「相信」，白盒只要求人「查看」。 我们不索取信任，只提供证据。

🤝 致谢

感谢 NapCat（126,400+ ⭐）· 感谢 SnowLuma（283 ⭐）

猫谢猫，雪接雪。你们留下的星，我们记下了，也不会让它们落空。

Ending 不是终点，是 SnowCat 的起点。

—— SnowCat 开发组 ——

5.2 KiB Raw Blame History Unescape Escape