QQ经典农场助手

基于 NodeJS + Vue 3 的 QQ/微信经典农场小程序自动化脚本

通过分析小程序 WebSocket 通信协议（Protocol Buffers），实现全自动农场管理

支持智能种植策略 · 好友互动 · 任务系统 · 实时日志

功能特性 · 快速开始 · 使用文档 · 技术栈

---

💡 项目说明 本项目基于 QianChenJun/qq-farm-bot 进行重构和功能增强，从 Electron 桌面应用 升级为 NodeJS 脚本，使其能在服务器和Docker环境下运行。

📸 应用截图

首页 - 功能开关与种植策略 实时显示农场状态、经验金币，支持独立功能开关和三种种植策略	设置页 - 参数配置 自定义巡查间隔、平台选择，查看所有可种植作物效率排行
日志页 - 实时操作记录 查看所有自动化操作日志，支持按类型筛选和实时滚动

✨ 功能特性

🌱 自己农场 ✅ 自动收获 — 检测成熟作物并自动收获 ✅ 自动铲除 — 自动铲除枯死/收获后的作物残留 ✅ 智能种植 — 三种策略可选 🚀 快速升级（经验效率最优） 🌟 高级作物（单次经验最高） 🎯 手动选择（自定义种植） ✅ 自动施肥 — 种植后自动施放普通肥料加速生长 ✅ 自动除草 — 检测并清除杂草 ✅ 自动除虫 — 检测并消灭害虫 ✅ 自动浇水 — 检测缺水作物并浇水

👥 好友农场 ✅ 好友巡查 — 自动巡查好友农场（主开关） ✅ 帮忙操作 — 帮好友浇水/除草/除虫（有经验上限） ✅ 自动偷菜 — 偷取好友成熟作物（有经验） ⚙️ 系统功能 ✅ 自动任务 — 自动领取完成的任务奖励 ✅ 自动同意好友 — 微信同玩好友申请自动同意 ✅ 邀请码处理 — 启动时自动处理邀请链接 ✅ 实时状态更新 — 经验/金币/等级实时显示 ✅ 心跳保活 — 自动维持 WebSocket 连接

🎨 桌面应用特性

• 🖥️ 现代化界面 — Vue 3 + Element Plus 暗色主题
• 🎛️ 功能开关 — 每个功能可独立开启/关闭，带详细说明
• 📊 实时日志 — 查看所有操作记录，支持筛选
• ⚡ 配置持久化 — 自动保存配置，下次启动自动应用
• 🔔 系统托盘 — 最小化到托盘，后台运行不打扰
• 🔄 双平台支持 — QQ 和微信小程序均可使用

📦 安装

环境要求

• Node.js >= 16.0.0
• npm 或 pnpm

克隆仓库

git clone https://github.com/MoeGrid/qq-farm-bot.git
cd qq-farm-bot
npm install

🔑 获取登录 Code

本工具需要小程序的登录凭证（code）才能连接服务器。code 具有时效性，过期后需重新获取。

📱 抓包方式（Fiddler）

1. 手机安装 Fiddler 证书，配置代理指向电脑
2. 电脑打开 Fiddler，开启 HTTPS 解密
3. 手机打开 QQ/微信 → 进入「经典农场」小程序
4. 在 Fiddler 中筛选请求，找到 WebSocket 连接或登录请求中的 code 参数
5. 复制 code 值，粘贴到本工具中使用

💡 提示：code 具有时效性，短时间内断开重连可复用同一 code，过期后需重新进入小程序获取。

🚀 使用方式

# 打包web页面
npm run build

# 启动后台服务
npm run serve

Web界面提供：

• 🎨 可视化操作界面（暗色主题）
• 🎛️ 功能开关实时切换（带详细说明）
• 🌱 种植策略配置（快速升级 / 高级作物 / 手动选择）
• ⏱️ 巡查间隔调整
• 📋 实时日志查看与筛选

📁 项目结构

点击展开查看详细结构

qq-farm-bot/
├── server/            # NodeJS 后端服务
├── web/               # Vue 3 前端界面
├── src/               # 核心业务模块（CLI & Electron 共用）
├── proto/             # Protobuf 协议定义
├── gameConfig/        # 游戏配置数据
└── docs/              # 项目文档

⚙️ 配置说明

Web应用

配置通过界面操作，自动保存到当前目录（config.json）：

• 平台选择：QQ / 微信
• 种植模式：
  • 🚀 快速升级（经验效率最优，适合快速升级）
  • 🌟 高级作物（单次经验最高，适合高等级玩家）
  • 🎯 手动选择（自定义种植作物）
• 巡查间隔：自己农场 / 好友农场分别设置
• 功能开关：每个自动化功能可独立开启/关闭，带详细说明

邀请码（仅微信）

在项目根目录的 share.txt 中每行放一个邀请链接，启动时自动处理：

?uid=xxx&openid=xxx&share_source=xxx&doc_id=xxx

⚠️ 注意事项

• ⏱️ code 具有时效性，短时间内可复用，过期后需重新从小程序获取
• 🔐 同一账号同时只能在一个地方登录，启动本工具后小程序端会被踢下线
• 🌐 建议在稳定的网络环境下运行，断线后需重新获取 code 连接
• 📚 本项目仅供学习交流使用

🛠️ 技术栈

Node.js

Vue 3

Element Plus

• 运行时：Node.js >= 16.0.0
• 前端框架：Vue 3 (Composition API)
• UI 组件库：Element Plus (暗色主题)
• 构建工具：Vite
• 通信协议：WebSocket + Protocol Buffers

🤝 贡献

欢迎提交 Issue 和 Pull Request！

📄 License

MIT

🙏 致谢

本项目基于 QianChenJun/qq-farm-bot 进行重构和功能增强，感谢原作者的开源贡献。

---

📊 Star History

如果觉得项目不错，请点个 ⭐️ Star 支持一下！