NapCatQQ Desktop：QQ Bot 桌面控制台

项目简介

NapCatQQ Desktop 是 NapCatQQ 与 SnowLuma 的 Windows / Linux 桌面控制台。从部署 Bot、对接应用端，到聊天、截图和调试，都在一个窗口里完成。客户端支持 Windows / Linux x64，技术栈为 Rust + Tauri 2 + React + TypeScript。

主要功能

部署与管理 Bot

• 同时管理 NapCatQQ 和 SnowLuma，查看运行状态、登录状态与日志，编辑 OneBot 连接。
• 本机 Windows / Linux 原生运行；通过 SSH 管理远端 Linux，支持原生运行和 Docker 部署。
• 在界面里安装、更新运行时与框架，查看依赖和任务进度；QQ 可单独安装一份。
• 查看主机 CPU、内存、磁盘及 Bot 指标，配置自动重启、掉线通知；远端可安装 ncd-watch，在 Desktop 退出后继续值守。

应用端管理与对接

「组件」页负责安装，「应用端」页负责管理实例，可新建或导入已有项目、启停、查看日志、切换版本，并一键对接 Bot。支持的框架包括 NeoBot、Karin、AstrBot、MaiBot（麦麦）、Koishi、NoneBot2、TRSS-Yunzai（云崽），详情页默认打开配置文件编辑器，本机和远端均可读写；部分框架启动后可直接「打开 WebUI」。

聊天、媒体与截图

• 私聊与群聊：每个 Bot 的联系人和消息独立管理，支持好友分组、群消息盒子、置顶、未读筛选和聊天记录搜索。
• 消息操作：回复、@、撤回、逐条或合并转发，失败可重试，图片和文件可拖入或粘贴。
• 媒体与群文件：查看图片、语音、视频、Markdown 和转发记录；群文件支持浏览、上传下载及有权限时的目录管理。
• 原生截图：默认 Ctrl+Alt+S，支持框选、标注、撤销重做、复制、保存和双向滚动长截图。
• 账号托盘：按账号开启后台接收、头像托盘和消息提醒。

调试与运维工具

• OneBot 调试台：搜索接口、表单 / JSON 参数编辑、回包查看、实时事件与请求历史，支持独立窗口。
• MCP 接入：供本机 AI 客户端查询 Bot、应用端和远端状态，读取日志并按授权调用 OneBot，默认关闭、默认只读。
• 服务器间迁移：预检并迁移协议端与关联应用，保留源目录，支持登录检查和回退。
• 内嵌终端：本机、远端主机、Bot 和应用端实例都有入口，支持多标签、分屏和文件栏，默认 Ctrl+反引号 打开。
• 配置备份：导出 / 导入配置 ZIP，导入前校验并备份现有配置。

安装与使用

1. 打开 最新发布页，Windows 下载 NapCatQQ-Desktop-<版本>-x64.msi，Linux x64 下载 .deb 或 .AppImage。
2. Windows 双击安装；Debian / Ubuntu 使用 sudo apt install ./NapCatQQ-Desktop-<版本>-amd64.deb，AppImage 添加执行权限后运行。
3. 在「组件」页选择主机，安装运行时、QQ 与协议端。
4. 在「机器人」页新建 Bot，选择 NapCat 或 SnowLuma，填写 QQ 号、运行位置和连接配置。
5. 启动 Bot，按协议端提供的 WebUI 或 QQ 登录入口完成登录，之后可进入「聊天」或创建「应用端」实例。

运行环境要求：Windows 10 / 11 x64、Windows Server 2016+，界面需 Microsoft Edge WebView2；Linux x64 需图形桌面与 GTK 3 / WebKitGTK 4.1。内嵌终端在 Windows 上需 10 1809 / Server 2019+。

注意事项

• Linux 托盘需桌面环境提供 AppIndicator 支持；原生截图和 Windows 专属窗口效果暂不支持 Linux，Linux 升级请下载新版安装包。
• Docker 部署要求 Docker daemon、Compose 和对应架构镜像就绪；本机 Windows 使用原生部署。
• 配置包不包含组件程序、插件程序、数据库和聊天消息记录，也不包含系统密钥库中的凭据；迁移到另一台机器仍需安装运行环境并核对路径。
• 程序与数据分开存放，Windows 默认数据根为 %ProgramData%\NapCatQQ Desktop，Linux 默认为 ~/.local/share/NapCatQQ Desktop（遵循 XDG_DATA_HOME），可从设置中迁移。
• 更新 Desktop 不会自动替换远端 ncd-watch。
• 项目采用 GPL-3.0 许可证。

本作品整理自 GitHub 开源项目 NapNeko/NapCatQQ-Desktop，原作者 @NapNeko，许可证 GPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。