# qq-farm-bot-ui
**Repository Path**: XD_CHAI/qq-farm-bot-ui
## Basic Information
- **Project Name**: qq-farm-bot-ui
- **Description**: 基于 Node.js 的 QQ经典农场自动化项目。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-14
- **Last Updated**: 2026-08-14
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# QQ 农场多账号挂机 + Web 面板
基于 Node.js 的 QQ 农场自动化工具，支持多账号管理、Web 控制面板、实时日志与数据分析。
[Discord](https://discord.gg/zTEhed5qpc)
## 技术栈
**后端**
[
](https://nodejs.org/)
[
](https://expressjs.com/)
[
](https://socket.io/)
**前端**
[
](https://vuejs.org/)
[
](https://vitejs.dev/)
[
](https://www.typescriptlang.org/)
[
](https://pinia.vuejs.org/)
[
](https://unocss.dev/)
**部署**
[
](https://docs.docker.com/compose/)
[
](https://pnpm.io/)
[
](https://github.com/features/actions)
---
## 功能特性
### 多账号管理
- 账号新增、编辑、删除、启动、停止
- 手动输入 Code
- 账号被踢下线自动删除
- 账号连续离线超时自动删除
- 账号离线推送通知（支持 Bark、自定义 Webhook 等）
### 自动化能力
- 农场：收获、种植、浇水、除草、除虫、铲除、土地升级
- 仓库：收获后自动出售果实
- 好友：自动偷菜 / 帮忙 / 捣乱
- 任务：自动检查并领取
- 好友黑名单：跳过指定好友
- 静默时段：指定时间段内不执行好友操作
### Web 面板
- 概览 / 农场 / 背包 / 好友 / 分析 / 账号 / 设置页面
- 实时日志，支持按账号、模块、事件、级别、关键词、时间范围筛选
- 深色 / 浅色主题切换
### 分析页
支持按以下维度排序作物：
- 经验效率 / 普通肥经验效率
- 净利润效率 / 普通肥净利润效率
- 等级要求
---
## 环境要求
- 源码运行：Node.js 20+，pnpm（推荐通过 `corepack enable` 启用）
- 二进制发布版：无需安装 Node.js
## 安装与启动（源码方式）
### Windows
```powershell
# 1. 安装 Node.js 20+（https://nodejs.org/）并启用 pnpm
node -v
corepack enable
pnpm -v
# 2. 安装依赖并构建前端
cd D:\Projects\qq-farm-bot-ui
pnpm install
pnpm build:web
# 3. 启动
pnpm dev:core
# （可选）设置管理密码后启动
$env:ADMIN_PASSWORD="你的强密码"
pnpm dev:core
```
### Linux（Ubuntu/Debian）
```bash
# 1. 安装 Node.js 20+
sudo apt update && sudo apt install -y curl
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs
corepack enable
# 2. 安装依赖并构建前端
cd /path/to/qq-farm-bot-ui
pnpm install
pnpm build:web
# 3. 启动
pnpm dev:core
# （可选）设置管理密码后启动
ADMIN_PASSWORD='你的强密码' pnpm dev:core
```
启动后访问面板：
- 本机：`http://localhost:3000`
- 局域网：`http://<你的IP>:3000`
---
## Docker 部署
```bash
# 构建并后台启动
docker compose up -d --build
# 查看日志
docker compose logs -f
# 停止并移除容器
docker compose down
```
### 数据持久化
`docker-compose.yml` 已将数据目录挂载：
| 宿主机路径 | 容器内路径 |
|-----------|-----------|
| `./data` | `/app/core/data` |
账号与配置数据保存在 `./data/accounts.json` 和 `./data/store.json`。
### 设置管理密码
在 `docker-compose.yml` 的 `environment` 中配置：
```yaml
environment:
ADMIN_PASSWORD: 你的强密码
```
修改后执行 `docker compose up -d` 重启生效。
---
## 二进制发布版（无需 Node.js）
### 构建
```bash
pnpm install
pnpm package:release
```
产物输出在 `dist/` 目录：
| 平台 | 文件名 |
|------|--------|
| Windows x64 | `qq-farm-bot-win-x64.exe` |
| Linux x64 | `qq-farm-bot-linux-x64` |
| macOS Intel | `qq-farm-bot-macos-x64` |
| macOS Apple Silicon | `qq-farm-bot-macos-arm64` |
### 运行
```bash
# Windows：双击 exe 或在终端执行
.\qq-farm-bot-win-x64.exe
# Linux / macOS
chmod +x ./qq-farm-bot-linux-x64 && ./qq-farm-bot-linux-x64
```
程序会在可执行文件同级目录自动创建 `data/` 并写入 `store.json`、`accounts.json`。
---
## 登录与安全
- 面板首次访问需要登录
- 默认管理密码：`admin`
- **建议部署后立即修改为强密码**
---
## 项目结构
```
qq-farm-bot-ui/
├── core/ # 后端（Node.js 机器人引擎）
│ ├── src/
│ │ ├── config/ # 配置管理
│ │ ├── controllers/ # HTTP API
│ │ ├── gameConfig/ # 游戏静态数据
│ │ ├── models/ # 数据模型与持久化
│ │ ├── proto/ # Protobuf 协议定义
│ │ ├── runtime/ # 运行时引擎与 Worker 管理
│ │ └── services/ # 业务逻辑（农场、好友、任务等）
│ ├── data/ # 运行时数据（accounts.json、store.json）
│ └── client.js # 主进程入口
├── web/ # 前端（Vue 3 + Vite）
│ ├── src/
│ │ ├── api/ # API 客户端
│ │ ├── components/ # Vue 组件
│ │ ├── stores/ # Pinia 状态管理
│ │ └── views/ # 页面视图
│ └── dist/ # 构建产物
├── docker-compose.yml
├── pnpm-workspace.yaml
└── package.json
```
---
## 特别感谢
- 核心功能：[linguo2625469/qq-farm-bot](https://github.com/linguo2625469/qq-farm-bot)
- 部分功能：[QianChenJun/qq-farm-bot](https://github.com/QianChenJun/qq-farm-bot)
## 免责声明
本项目仅供学习与研究用途。使用本工具可能违反游戏服务条款，由此产生的一切后果由使用者自行承担。