基于 Bun.js 的 QQ 经典农场小程序自动化挂机脚本。通过分析小程序 WebSocket 通信协议（Protocol Buffers），实现全自动农场管理，支持多用户并行挂机与 Docker 容器化部署。
- 自动收获 — 检测成熟作物并自动收获
- 自动种植 — 收获/铲除后自动购买当前等级最高种子并种植
- 自动除草 — 检测并清除杂草
- 自动除虫 — 检测并消灭害虫
- 自动浇水 — 检测缺水作物并浇水
- 自动铲除 — 自动铲除枯死作物
- 好友巡查 — 自动巡查好友农场，帮忙浇水/除草/除虫 + 偷菜
- 多用户挂机 — 支持多个账号同时运行，各会话独立隔离
- 心跳保活 — 自动维持 WebSocket 连接
- PB 解码工具 — 内置 Protobuf 数据解码器，方便调试分析
git clone https://github.com/initH271/qq-farm-bot.git
cd qq-farm-bot
bun install- ws — WebSocket 客户端
- protobufjs — Protocol Buffers 编解码
- long — 64 位整数支持
你需要从小程序中抓取 code。可以通过抓包工具（如 Fiddler、Charles、mitmproxy 等）获取 WebSocket 连接 URL 中的 code 参数。
# 单用户模式
bun client.js --code <你的登录code>
# 多用户模式（逗号分隔）
bun client.js --codes <code1,code2,code3># 农场巡查间隔 60 秒，好友巡查间隔 180 秒
bun client.js --code <code> --interval 60 --friend-interval 180| 参数 | 说明 | 默认值 |
|---|---|---|
--code |
单用户模式：一个登录凭证（必需） | — |
--codes |
多用户模式：逗号分隔的多个登录凭证 | — |
--interval |
自己农场巡查间隔（秒） | 30（最低 10） |
--friend-interval |
好友农场巡查间隔（秒） | 60（最低 60） |
--verify |
验证 proto 定义是否正确 | — |
--decode |
进入 PB 数据解码模式 | — |
也可以通过环境变量（或 .env 文件）配置，命令行参数优先级更高：
| 变量 | 说明 |
|---|---|
FARM_CODE |
单用户登录凭证 |
FARM_CODES |
多用户登录凭证（逗号分隔） |
FARM_INTERVAL |
农场巡查间隔（秒） |
FRIEND_INTERVAL |
好友巡查间隔（秒） |
内置 Protobuf 数据解码器，支持自动推断消息类型：
# 解码 base64 格式的 gatepb.Message
bun client.js --decode CigKGWdhbWVwYi... --gate
# 解码 hex 格式，指定消息类型
bun client.js --decode 0a1c0a19... --hex --type gatepb.Message
# 解码 base64 格式，指定消息类型
bun client.js --decode <base64数据> --type gamepb.plantpb.AllLandsReply
# 查看解码工具详细帮助
bun client.js --decode创建 .env 文件：
FARM_CODES=code1,code2,code3
# 或单用户：
# FARM_CODE=your_code_here
# 可选
# FARM_INTERVAL=60
# FRIEND_INTERVAL=120# 构建并后台启动
docker compose up -d
# 查看日志
docker compose logs -f farm-bot
# 停止
docker compose down├── client.js # 入口文件 - 参数解析与多用户启动调度
├── package.json
├── Dockerfile # Docker 镜像定义 (bun:1-alpine)
├── docker-compose.yml # Docker Compose 编排
├── .env # 环境变量配置（需自行创建，已 gitignore）
├── src/
│ ├── config.js # 配置常量与生长阶段枚举
│ ├── utils.js # 工具函数工厂 (日志/时间同步/类型转换)
│ ├── proto.js # Protobuf 加载与消息类型管理
│ ├── network.js # WebSocket 连接/消息编解码/登录/心跳
│ ├── farm.js # 自己农场: 收获/浇水/除草/除虫/铲除/种植/商店/巡田
│ ├── friend.js # 好友农场: 进入/帮忙/偷菜/巡查循环
│ ├── session.js # 用户会话编排器: 组装各模块/管理生命周期
│ └── decode.js # PB 解码/验证工具模式
└── proto/
├── game.proto # 网关消息定义 (gatepb)
├── userpb.proto # 用户/登录/心跳消息
├── plantpb.proto # 农场/土地/植物消息
├── corepb.proto # 通用 Item 消息
├── shoppb.proto # 商店消息
├── friendpb.proto # 好友列表消息
└── visitpb.proto # 好友农场拜访消息
[启动] 共 1 个用户
[配置] 农场检查间隔: 30秒
[配置] 好友检查间隔: 60秒
[22:30:01] [WS] 连接成功
[22:30:01] [Proto] 所有协议定义加载成功
========== 登录成功 ==========
GID: 1234567890
昵称: 我的农场
等级: 15
金币: 8888
时间: 2026/2/7 22:30:01
===============================
[22:30:03] [巡田] 可收获:4(1,2,3,4) | 生长中:8 | 缺水:2(5,6)
[22:30:03] [浇水] 已浇水 2 块地 (5,6)
[22:30:04] [收获] 已收获 4 块地 (1,2,3,4)
[22:30:05] [商店] 最佳种子: goods_id=12 item_id=1001 价格=100金币
[22:30:05] [购买] 已购买种子x4, 花费 400 金币
[22:30:06] [种植] 已在 4 块地种植 (1,2,3,4)
[22:30:10] [好友] 共 15 位好友，开始巡查...
[22:30:11] [拜访] 小明 (可偷:2 有草:1)
[22:30:12] [帮忙] 帮 小明 除草 1 块
[22:30:12] [偷菜] 从 小明 偷了 2 块地
[22:30:15] [好友] 巡查完毕! 偷菜:2块 | 除草:1块
本项目仅供学习和研究用途。使用本脚本可能违反游戏服务条款，由此产生的一切后果由使用者自行承担。
MIT