下载安装包 · 加入 QQ 群 · 用户文档

---

关于

NapCatQQ Desktop 是 NapCatQQ / SnowLuma 的 Windows 桌面控制台。

装完就能管 Bot：本机起停、远端部署、看日志、装组件，一个窗口搞定。

当前主线是 V3（Rust + Tauri + React）。旧 Python 实现归档在 v1。

特性

• 本机 + 远端 — 自己电脑能跑，Linux 也能管；SSH 连上就能部署
• 双框架 — NapCat、SnowLuma 都能创建 / 启动 / 停止 / 看日志
• 组件自助装 — Node、QQ、框架……页面里点安装，少抠命令行
• 配置与程序分离 — 数据在 %ProgramData%\NapCatQQ Desktop，重装不怕丢设置
• 旧版可覆盖升 — 同 UpgradeCode，直接装新 MSI

安装

1. 打开 Releases
2. 下载 NapCatQQ-Desktop-<版本>-x64.msi
3. 双击安装，打开就能用

系统要求：Windows 10 / Server 2016+ · x64
名字带 watch-v 的是远端监控小工具，不是桌面安装包。

从旧版升级

直接装新 MSI 覆盖 → 按提示迁配置 → 确认 Bot 列表还在 → 有空导出一份备份。

开发

pnpm install
pnpm run tauri:dev

# 打 MSI
pnpm run tauri:build -- --bundles msi

# 常用检查
pnpm run typecheck
pnpm run test:unit
pnpm run rust:test

目录	用途
crates/	后端业务
src-tauri/	Tauri 壳与 MSI
src-ui/	前端界面
docs/	文档

发版约定：v*.*.* → Desktop MSI · watch-v* → 远端监控二进制

社区

• QQ 群：点击加入
• 问题反馈：GitHub Issues

相关链接

• 用户说明
• 代码地图
• NapCat 文档
• NapCatQQ
• SnowLuma
• ncd-watch 发布

致谢

• NapCatQQ · SnowLuma
• Tauri · Rust · React
• 还有提 Issue、PR 和帮忙试的各位

许可

见 LICENSE。学习与合法用途使用，后果自负。