DandanLLab/SnowCatQQ

项目介绍

SnowCat 是社区维护的第三方 QQ 客户端，底座来自 NapCat（OneBot 实现），并融合了 SnowLuma 的扩展动作。它通过 winmm.dll 代理挂接 v8::ScriptCompiler，把单文件 bundle 注入官方 QQ 9.9.37-54395 x64 主进程，官方安装包本身不做修改，对外提供 OneBot v11（正/反向 WebSocket、HTTP、HTTP SSE）、Streamable HTTP 的 /mcp 接入，以及 QZone、群相册、打卡、闪照等 56 项额外动作 SnowCat 仓库。WebUI 基于 React，默认监听 6099 端口。

适用对象是运行自建 QQ 机器人或陪伴型智能体的个人开发者。README 明确把它定位为个人开发者路线，与腾讯审核制的官方机器人平台是两条路 官方机器人平台。仓库包含 26 个 TypeScript 包和 PowerShell 发布工具，V8 通道的源码与已编译 DLL 都在仓库里，另附便携环境制作器 仓库结构。

快速使用

前提：Windows x64 和官方 QQ 9.9.37-54395 安装包。在仓库根目录用 PowerShell 执行：

1. 将官方安装包解包为便携结构：

   ./release-tools/snowcat-qq-unpack.ps1 -Installer QQ_9.9.37_261103_x64_01.exe
   

2. 部署 V8 通道、启动 QQ 并做 45 秒健康检查：

   ./release-tools/build/snowcat-run.ps1
   

3. 打开 WebUI：http://127.0.0.1:6099/webui/ 快速开始。

启动后，把 OneBot v11 客户端指向暴露的端点，或让 MCP 客户端连接 /mcp，即可把所有动作当作工具调用。预编译版本见 Releases。README 还列出配套的 dsh 插件（通道、团队群、生活引擎），用于把客户端接入智能体沙盒 dsh-channel-qq。

使用约束

• 仅支持 Windows x64，且绑定 QQ 9.9.37-54395 这一具体版本；QQ 更新后通常需要重新维护 offset 表和注入通道。
• 用自己的 QQ 账号运行第三方客户端存在账号风险，README 也明确不保证账号安全 账号安全说明。
• 机制依赖向官方进程注入代理 DLL，可能触发杀毒软件或平台风控。
• License 徽章写的是 MIT，但 GitHub 识别为 NOASSERTION，再分发前应核对实际的许可证文件。
• README 大量篇幅是立场宣言，具体实现说明在独立文档中：V8 通道原理与架构审计 V8 通道文档 架构审计。

HotRepo 点评

2026-11-12，该项目进入 HotRepo 新项目 JavaScript 榜，在约八小时的统计窗口内新增 103 Star、54 Fork；对一个前一天才创建的仓库来说，初始响应很快。这一波关注与 NapCat 宣布停止维护、SnowLuma 仓库消失的时间点重合，更像是上游断档带来的接续需求，而非独立采用。目前没有 GitHub 日榜名次，也只有一条快照，样本不足以判断热度能否持续。更值得关注的技术问题是：26 个 TypeScript 包的源码与仓库内的 V8 通道 DLL，能否在后续 QQ 版本更新中保持同步。