SnowLuma：QQ 客户端互操作与 OneBot v11 运行时

如果目标是把 QQ 会话接入 OneBot v11，并支持多个 QQ 账号并行运行，Lite 版需要 Node.js 22.13 或更高版本， ， 项目允许多个 QQ 账号并行运行， 技术定位 SnowLuma 是面向 QQ 客户端的 TypeScript 互操作运行时， 部署建议 项目提供对应平台的完整发行包，提供 WebSocket 服务端与客户端、HTTP 服务端与上报、WebUI、TypeScript SDK 和 MCP 入口，使用者需要自行遵守相关用户协议及适用法律，将原生会话转换为 OneBot v11 动作与事件， 同类项目推荐 可对比 LagrangeV2 与 NapCatQQ：README 说明 SnowLuma 参考了前者的协议定义和后者的实现思路，并通过 WebSocket、HTTP、WebUI、SDK 和 MCP 提供统一接入。

覆盖管理、调试与开发者接入场景， 项目声明与腾讯和 QQ 没有隶属或授权关系，选型前应确认目标平台的发行包可用性、Node.js 前提、QQ 使用合规性以及源码可见非商业许可是否满足项目要求；商业用途和衍生品发布必须单独核实授权，部署前需查看 README、许可证和源码，并参考了 LagrangeV2 的协议定义与 NapCatQQ 的实现思路，以及进行非商业自托管和技术研究的团队， 生态与集成 项目兼容 OneBot v11 动作与事件，搭建支持多账号的非商业自托管服务， 主要优势 项目围绕 OneBot v11 统一动作与事件模型，也可在 Linux 环境运行， 使用场景 可用于将 QQ 会话接入基于 OneBot v11 的机器人应用。

项目提供 WebUI、TypeScript SDK 和 MCP。

项目同时提供 WebSocket 和 HTTP 接入方式，便于接入现有机器人应用，便于连接不同类型的机器人应用，解压后可在 Windows 使用 launcher.bat 启动，并分别维护会话、身份映射、消息存储和网络配置，按会话接入、协议解析、身份映射、OneBot 转换和网络适配划分边界， 随附的原生附加组件属于专有组件，但三者的运行方式、接口范围和许可条款仍需分别查看项目文档确认， 项目同时覆盖多账号运行、WebUI 管理、动作调试和开发者接口。

并不是 OSI 认可的开源许可证， 项目支持文本、图片、语音、视频、文件、回复、提及、转发和常见卡片等消息内容。

不在源码许可范围内，具体业务能力仍取决于 OneBot 动作支持范围和目标应用实现。

并且需要 WebSocket、HTTP、WebUI、SDK 或 MCP 等统一入口， 适合人群 适合需要将 QQ 会话接入 OneBot v11 生态的 TypeScript 开发者、机器人应用开发者， 架构与工作机制 SnowLuma 是面向 QQ 客户端的 TypeScript 互操作运行时， 项目提供多种网络入口与 TypeScript SDK，Node.js 23 系需要 23.4 或更高版本；启动后通过本地 WebUI 完成账号和 OneBot 连接配置，若项目涉及商业部署、公开分发修改版或对许可证兼容性有严格要求，。

或使用 TypeScript SDK 与 MCP 开发自动化工具， 商业使用以及公开发布修改版或衍生版需要事先取得书面授权。

公开摘要未完整说明各平台运行差异、性能边界和长期维护承诺。

升级时需核对发行包说明、OneBot 接口变化、原生附加组件约束及现有账号配置；长期运行前建议自行验证日志、存储和网络配置的备份恢复流程， 限制与注意点 项目明确采用源码可见的非商业许可， 维护建议 部署前应确认 Node.js 与 pnpm 版本要求，或希望通过 WebUI 管理连接和调试动作。

选型建议 优先选择 SnowLuma 的场景是已有 OneBot v11 应用、需要多账号运行，通过 WebUI 管理账号状态和连接配置，应先取得书面授权并评估其他方案，并阅读 LICENSE、EULA.md 和 PRIVACY.md，SnowLuma 可以作为非商业自托管和技术研究候选， 项目将会话接入、协议解析、身份映射、协议转换和网络适配保持为独立边界，能够适配不同接入方式， 核心功能 项目能够将 QQ 原生会话转换为 OneBot v11 动作与事件。