Dream Bot - QQ桌面陪伴机器人
基于 NoneBot2 的 QQ 桌面陪伴机器人，帮你查看系统信息、管理环境变量、记录待办事项。
技术栈
- Python 3.11+
- NoneBot2 + FastAPI
- OneBot V11 协议 (NapCat/Lagrange)
- psutil 系统监控
Win11 快速部署
1. 安装 Python 3.11
# 推荐用 winget 安装
winget install Python.Python.3.11
# 验证
python --version # Python 3.11.x
2. 安装 NapCat (QQ协议端)
# 方式一：下载 NapCat 安装包
# https://github.com/NapNeko/NapCatQQ/releases
# 方式二：使用 installer
# https://napneko.github.io/guide/getting-started
NapCat 配置 (连接 NoneBot2):
{
"ws": {
"enable": true,
"url": "ws://127.0.0.1:6199"
},
"reverseWs": {
"enable": false
}
}
3. 安装项目依赖
cd dream-bot
# 创建虚拟环境
python -m venv .venv
.venv\Scripts\activate
# 安装依赖
pip install -r requirements.txt
4. 配置
编辑 .env 文件:
# 超级管理员QQ号（改成你的QQ号）
SUPERUSERS=["你的QQ号"]
5. 启动
# 先启动 NapCat (QQ登录)
# 再启动机器人
python bot.py
功能列表
🔍 环境变量助手
| 命令 |
说明 |
env列表 |
查看所有环境变量 |
env搜索 <关键词> |
搜索环境变量 |
env <变量名> |
查看指定变量详情 |
env分组 [组名] |
按分组查看 |
env诊断 |
开发环境智能诊断 |
🖥️ 系统信息
| 命令 |
说明 |
系统信息 |
CPU/内存概览 |
磁盘信息 |
磁盘使用情况 |
网络信息 |
网络状态与流量 |
进程 [关键词] |
进程查询 |
执行 <命令> |
执行系统命令 (管理员) |
💬 桌面陪伴
| 命令 |
说明 |
早安/晚安/你好 |
时间问候 |
@机器人 + 任意消息 |
智能回复 |
帮助 |
功能列表 |
时间 |
当前时间 |
📝 工作辅助
| 命令 |
说明 |
记住 <内容> |
添加待办 |
待办 |
查看待办列表 |
完成 <序号> |
标记完成 |
提醒 <分钟> <内容> |
定时提醒 |
计算 <表达式> |
快捷计算 |
项目结构
dream-bot/
├── bot.py # 入口文件
├── .env # 配置文件
├── pyproject.toml # 项目依赖
├── requirements.txt # pip依赖
├── README.md
├── data/ # 运行时数据
│ └── task_helper/
│ └── todos.json
└── src/
└── plugins/
├── env_helper/ # 环境变量助手
├── sys_info/ # 系统信息查询
├── companion/ # 桌面陪伴聊天
└── task_helper/ # 待办/提醒/工具
注意事项
env列表、env搜索、执行 等敏感命令仅超级管理员可用- NapCat 需要 Win11 上先登录 QQ，保持 QQ 在线
- 定时提醒功能需要安装
nonebot-plugin-apscheduler
- 系统信息功能依赖
psutil 库
