NapCat / SnowLuma 桌面控制台

你的 Bot，都在这里。

从第一次上线，到每天的聊天、部署与调试。
在一个桌面窗口里完成。

下载 Windows 版 跟着教程开始

Windows 10 / 11 x64 免费开源v3.5.2 更新日志

应用端 · 对接

0 / 6演示说明

应用已准备好，对接只写入演示数据

把一个应用实例接到协议 Bot

  1. 实例
  2. 详情
  3. 设置
  4. 对接
  5. 计划
  6. 确认
未开始
应用端 · 对接界面预览

真实界面，可以动手试试。

演示数据 · 不会连接 QQ
滚动，展开工作台

从启动，到开聊。

第 1 步

让第一只 Bot 上线。

准备组件、创建实例、扫码登录。本机和远端，都从这里开始。

创建第一个 Bot
Bot 实例与运行终端，使用演示数据
软件界面 · 演示数据
  • 准备组件
  • 扫码登录
  • 查看状态
第 2 步

给 Bot 添点本事。

装好应用端，再连上 Bot。Karin、NoneBot2、AstrBot 等七种框架，在同一处管理。

安装与配置应用端
七种框架的应用实例，使用演示数据
软件界面 · 演示数据
  • 安装框架
  • 配置插件
  • 对接 OneBot
第 3 步

发条消息，试试看。

直接收发私聊和群聊消息。图片、文件、截图，也在这个窗口里。

聊天与截图教程
多账号聊天界面，使用演示数据
软件界面 · 演示数据
  • 私聊与群聊
  • 媒体与文件
  • 原生截图
三步，开始使用。往下看看，还有什么
NapCat / SnowLuma

管理本机与远端 Bot

安装组件，管理 Bot 启停与登录，编辑连接并查看日志。

运行位置示意

本机 WindowsNapCat + SnowLuma

在本机创建 Bot

安装运行时、QQ 和协议端后创建 Bot。可单独安装 QQ 程序，也可使用系统 QQ。程序分开不代表登录数据完全隔离。

准备组件创建 Bot启动登录
本机使用指南
查看组件安装进度与 Bot 运行日志。启停 ／ 日志 ／ WebUI

安装与开始使用

首次运行需准备 QQ、运行时和协议端。

  1. 1
    安装 Desktop下载 Windows 安装包
  2. 2
    准备组件选择主机与协议端
  3. 3
    启动并登录创建 Bot，完成扫码

应用端管理

支持新建或导入实例，管理启停、日志、配置及 Bot 对接。

应用端使用指南

应用端 · 对接

0 / 6演示说明

应用已准备好，对接只写入演示数据

把一个应用实例接到协议 Bot

  1. 实例
  2. 详情
  3. 设置
  4. 对接
  5. 计划
  6. 确认
未开始
应用端 · 对接界面预览
打开实例设置，配置一条 OneBot 连接。
Karin

配置与插件管理

支持框架配置编辑、插件安装和 OneBot 对接。

  • 编辑框架配置
  • 安装与管理插件
  • 对接 OneBot 连接

部分操作需要实例运行并连接 WebUI。一键对接暂不支持 Docker Bot。

准备环境

在组件页安装运行时与框架。

管理实例

新建实例，或导入已有项目。

连接 Bot

配置对接，查看连接和日志。

聊天与截图

按 Bot 账号管理私聊和群聊，支持媒体消息、群文件与原生截图。

聊天与截图指南

支持好友分组、置顶、未读筛选和聊天记录搜索。消息可回复、@、撤回自己发送的内容，也可逐条或合并转发。

图片和文件可拖入或粘贴到输入框。
截图快捷键
Ctrl+Alt+S

聊天 · 消息操作

0 / 6演示说明

会话与消息为样例，不会发送到 QQ

回复一条演示消息，再搜索定位

  1. 账号
  2. 会话
  3. 引用
  4. 发送
  5. 搜索
  6. 定位
未开始
聊天 · 消息操作界面预览
引用一条消息，发送回复，再从搜索结果回到原文。

OneBot 调试与终端

发起请求，看回包。
需要继续排查，就打开终端。

调一个接口搜索 get_login_info，发送请求，把结果存为收藏。

敲几条命令查看目录和输出，打开文件栏，再试试左右分屏。

调试台 · OneBot

0 / 6演示说明

接口返回为样例，不访问 QQ

调用一次 get_login_info，查看返回值

  1. 账号
  2. 搜索
  3. 参数
  4. 调用
  5. 历史
  6. 收藏
未开始
调试台 · OneBot界面预览
演示数据 · 可以随时接手操作调试台指南 ↗终端指南 ↗

远端监控

关掉 Desktop，远端也有人值守。安装并配置 ncd-watch 后，它会继续检查 Bot，并按配置发送掉线通知。

看清运行状态
CPU、内存、磁盘和 Bot 指标，集中查看。
把值守留在远端
自动重启与通知策略保存在远端，管理窗口无需一直开着。
ncd-watch 使用指南 ↗
ncd-watch值守流程 · 模拟
01 / 04

在 Desktop 中管理先在远端安装 ncd-watch，配置检查和通知策略。

Desktop 设置

外观与数据设置

换个配色，整理侧栏。设置改好，点保存就生效。

外观设置

0 / 6演示说明

设置仅作用于这个演示窗口。

在真实设置页切换明暗主题，调整侧栏和圆角。

  1. 主题
  2. 暗色
  3. 应用
  4. 侧栏
  5. 浅色
  6. 保存
未开始
外观设置界面预览

按账号接收消息

后台接收、头像托盘和消息提醒，都可以按账号开启。

聊天设置 ↗

备份配置，迁移数据

导出配置或迁移数据目录。配置备份不包含程序与聊天记录。

查看备份范围 ↗
NAPCATQQ DESKTOP / DOWNLOADWINDOWS x64 / OPEN SOURCE

下载 NapCatQQ Desktop

适用于 Windows x64，安装前可先阅读使用指南。

下载 Windows 安装包使用指南 ↗
更新日志

客户端面向 Windows x64，支持 Windows 10 / 11 及 Windows Server 2016+。需要 WebView2；内嵌终端对系统版本另有要求，详见安装指南。

下载与安装 ↗