约 1338 字 大约 4 分钟 SnowLuma (OneBot v11) 适配器指南 — 协议层复用 NapCat，实现独立的下载、启动与 WebUI 引导。 Quick Reference SnowLumaAdapter 与 NapCatAdapter 的 platform 都是 qq ，同一个 BotClient 里只能二选一。 SnowLuma 是自带 Node.js 运行时的独立 OneBot v11 协议端，不依赖系统 QQNT 客户端。NcatBot 在这一层只做两件事： 连接 SnowLuma 暴露的 OneBot v11 WebSocket 在 Setup 模式下按需下载、启动并引导用户进入 WebUI 完成首次配置 协议实现完全复用 NapCat 适配器中的以下组件： NapCatWebSocket NapCatEventParser 因此 SnowLuma 与 NapCat 在事件模型和 QQ Bot API 能力上保持一致，差异主要集中在 setup/ 流程。 通过 ncatbot init 或 ncatbot adapter 进入适配器管理并选择 SnowLuma 时，CLI 会调用 SnowLumaAdapter.cli_configure() ： 询问是否立即自动下载并安装 SnowLuma（当前仅 Windows x64 支持） 若选择自动安装：跳过 WS / WebUI 地址输入，直接返回默认连接参数 若选择手动管理：依次输入 ws_uri 、 ws_token 、 webui_uri 和 skip_setup 自动安装只负责准备 SnowLuma 运行时，不会自动写入 OneBot v11 配置。首次启动时 NcatBot 会进入交互式引导，等待用户在 WebUI 中完成配置后按回车继续，随后自动收集 ws_uri / ws_token 并写回 config.yaml 。 适合本机运行 SnowLuma，并希望由 NcatBot 负责下载和拉起协议端。

首次配置完成后， configured 字段会自动写入 config.yaml 。后续启动时如果 WebSocket 服务正常，将跳过交互直接连接。 适合 SnowLuma 由你手动或外部进程管理的场景，例如远端主机、现有运维脚本、或 Linux 手动部署。 自动安装 / 自动启动当前仅完整支持 Windows x64 Linux / macOS 请使用 skip_setup: true ，手动管理 SnowLuma 进程 首次启动时 NcatBot 会等待用户在 WebUI 中完成配置（无超时限制），完成后按回车继续 Windows 下 ncatbot snowluma stop 不会按进程名强杀 node.exe ，只会提示手动关闭对应窗口 SnowLuma 提供独立 CLI 命令组： ncatbot snowluma install [--yes] [--lite] [--install-dir PATH] ：下载并解压 SnowLuma ncatbot snowluma diagnose ：同时检测 WebSocket 与 WebUI ncatbot snowluma diagnose ws ：只检测 OneBot v11 WebSocket ncatbot snowluma diagnose webui ：只检测 WebUI 可达性 ncatbot snowluma version ：打印已安装版本与 GitHub 最新 release 适配器总览 → 适配器登录与使用指南 CLI 参考 → CLI 命令参考 协议层参考（SnowLuma 与 NapCat 共用）→ 协议 版权归属： GEYUANwuqi 许可证： 署名 4.0 国际 (CC-BY-4.0)