# qq-farm-bot **Repository Path**: umena/qq-farm-bot ## Basic Information - **Project Name**: qq-farm-bot - **Description**: No description available - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-02-09 - **Last Updated**: 2026-02-12 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 紧急通知：已经有人反馈封号了 低调使用，被举报必封 ## 一些提醒：某些人嘴脸不要那么难看，直接拿我原版的程序去倒卖 # QQ经典农场 挂机脚本 基于 Node.js 的 QQ/微信 经典农场小程序自动化挂机脚本。通过分析小程序 WebSocket 通信协议（Protocol Buffers），实现全自动农场管理。 本脚本基于ai制作，必然有一定的bug，遇到了建议自己克服一下，后续不一定会更新了 ## 功能特性 ### 自己农场 - **自动收获** — 检测成熟作物并自动收获 - **自动铲除** — 自动铲除枯死/收获后的作物残留 - **自动种植** — 收获/铲除后自动购买种子并种植（默认按当前等级 + 已解锁土地数计算经验效率后选种；可配置强制最低等级作物） - **自动施肥** — 种植后自动施放普通肥料加速生长 - **自动除草** — 检测并清除杂草 - **自动除虫** — 检测并消灭害虫 - **自动浇水** — 检测缺水作物并浇水 - **自动出售** — 每分钟自动出售仓库中的果实 ### 好友农场 - **好友巡查** — 自动巡查好友农场 - **帮忙操作** — 帮好友浇水/除草/除虫 - **自动偷菜** — 偷取好友成熟作物 ### 系统功能 - **自动领取任务** — 自动领取完成的任务奖励，支持分享翻倍/三倍奖励 - **自动同意好友** — 微信同玩好友申请自动同意（支持推送实时响应） - **邀请码处理** — 启动时自动处理 share.txt 中的邀请链接（微信环境，share.txt有示例，是小程序的path） - **状态栏显示** — 终端顶部固定显示平台/昵称/等级/经验/金币 - **经验进度** — 显示当前等级经验进度 - **心跳保活** — 自动维持 WebSocket 连接 ### 开发工具 - **[PB 解码工具](#pb-解码工具)** — 内置 Protobuf 数据解码器，方便调试分析 - **[经验分析工具](#经验分析工具)** — 分析作物经验效率，计算最优种植策略 ## 安装 ```bash git clone https://github.com/linguo2625469/qq-farm-bot.git cd qq-farm-bot npm install ``` ## 使用 ### 获取登录 Code 你需要从小程序中抓取 code。可以通过抓包工具（如 Fiddler、Charles、mitmproxy 等）获取 WebSocket 连接 URL 中的 `code` 参数。 ### 启动挂机 ```bash # QQ小程序 (默认) node client.js --code <你的登录code> # 微信小程序 node client.js --code <你的登录code> --wx ``` ### 自定义巡查间隔 ```bash # 农场巡查间隔 5 秒，好友巡查间隔 2 秒 node client.js --code --interval 5 --friend-interval 2 ``` ### 参数说明 | 参数 | 说明 | 默认值 | |------|------|--------| | `--code` | 小程序登录凭证（**必需**） | — | | `--wx` | 使用微信登录 | QQ 小程序 | | `--interval` | 自己农场巡查间隔（秒） | 2 | | `--friend-interval` | 好友巡查间隔（秒） | 1 | | `--name` | 注销实名姓名（配合 `--delete-account`） | — | | `--cert-id` | 注销证件号（配合 `--delete-account`） | — | | `--cert-type` | 证件类型: `0/414/516/553/555` 或 `china/passport/hk/other` | `0` | | `--verify` | 验证 proto 定义是否正确 | — | | `--decode` | 进入 PB 数据解码模式 | — | ### 邀请码功能（微信环境） 在项目根目录创建 `share.txt` 文件，每行一个邀请链接： ``` https://xxx?uid=123&openid=xxx&share_source=4&doc_id=2 https://xxx?uid=456&openid=xxx&share_source=4&doc_id=2 ``` 启动时会自动处理这些邀请链接，申请添加好友。处理完成后文件会被清空。 ### PB 解码工具 内置 Protobuf 数据解码器，支持自动推断消息类型： ```bash # 解码 base64 格式的 gatepb.Message node client.js --decode CigKGWdhbWVwYi... --gate # 解码 hex 格式，指定消息类型 node client.js --decode 0a1c0a19... --hex --type gatepb.Message # 查看解码工具详细帮助 node client.js --decode ``` ### 经验分析工具 * 规则： * 1) 每次收获经验 = exp，铲地固定 +1 经验 => 单轮经验 = exp + 1 * 2) 种植速度： * - 不施肥：2 秒种 18 块地 => 9 块/秒 * - 普通肥：2 秒种 12 块地 => 6 块/秒 * 3) 普通肥：减少 20% 生长时间；若 20% < 30 秒，则固定减少 30 秒 */ ```bash node tools/calc-exp-yield.js node tools/calc-exp-yield.js --lands 18 --level 27 node tools/calc-exp-yield.js --input tools/seed-shop-merged-export.json ``` ### 当前种子选择逻辑 默认策略（`src/farm.js`）： 1. 拉取商店中当前可购买的种子（已解锁、满足等级、未超限购）。 2. 读取账号等级 + 已解锁土地块数，调用 `tools/calc-exp-yield.js` 的 `getPlantingRecommendation(level, lands)`。 3. 按普通肥经验效率排名，从高到低选择在商店可买到的第一个种子。 4. 若推荐失败，则走兜底排序逻辑。 强制最低等级作物（通常白萝卜）： - 在 `src/config.js` 设置 `forceLowestLevelCrop: true` 后，直接选择最低等级种子。 - 开启后不再执行经验效率分析推荐。 ## 项目结构
点击展开项目结构 ``` ├── client.js # 入口文件 - 参数解析与启动调度 ├── src/ │ ├── config.js # 配置常量与生长阶段枚举 │ ├── utils.js # 工具函数 (类型转换/日志/时间同步/sleep) │ ├── proto.js # Protobuf 加载与消息类型管理 │ ├── network.js # WebSocket 连接/消息编解码/登录/心跳 │ ├── farm.js # 自己农场: 收获/浇水/除草/除虫/铲除/种植/施肥 │ ├── friend.js # 好友农场: 进入/帮忙/偷菜/巡查循环 │ ├── task.js # 任务系统: 自动领取任务奖励 │ ├── status.js # 状态栏: 终端顶部固定显示用户状态 │ ├── warehouse.js # 仓库系统: 自动出售果实 │ ├── invite.js # 邀请码处理: 自动申请好友 │ ├── gameConfig.js # 游戏配置: 等级经验表/植物数据 │ └── decode.js # PB 解码/验证工具模式 ├── proto/ # Protobuf 消息定义 │ ├── game.proto # 网关消息定义 (gatepb) │ ├── userpb.proto # 用户/登录/心跳消息 │ ├── plantpb.proto # 农场/土地/植物消息 │ ├── corepb.proto # 通用 Item 消息 │ ├── shoppb.proto # 商店消息 │ ├── friendpb.proto # 好友列表/申请消息 │ ├── visitpb.proto # 好友农场拜访消息 │ ├── notifypb.proto # 服务器推送通知消息 │ ├── taskpb.proto # 任务系统消息 │ └── itempb.proto # 背包/仓库/物品消息 ├── gameConfig/ # 游戏配置数据 │ ├── RoleLevel.json # 等级经验表 │ └── Plant.json # 植物数据（名称/生长时间/经验等） ├── tools/ # 辅助工具 │ └── analyze-exp-*.js # 经验效率分析脚本 └── package.json ```
## 运行示例
点击展开运行示例 ``` QQ | 我的农场 | Lv24 125/500 | 金币:88888 ──────────────────────────────────────────── ========== 登录成功 ========== GID: 1234567890 昵称: 我的农场 等级: 24 金币: 88888 时间: 2026/2/7 16:00:00 =============================== [16:00:02] [农场] [收:15 长:0] → 收获15/种植15 [16:00:03] [施肥] 已为 15/15 块地施肥 [16:00:05] [农场] [草:2 虫:1 水:3 长:15] → 除草2/除虫1/浇水3 [16:00:08] [好友] 小明: 偷6(白萝卜) [16:00:10] [好友] 巡查 5 人 → 偷12/除草3/浇水2 [16:00:15] [仓库] 出售 2 种果实共 300 个，获得 600 金币 [16:00:20] [任务] 领取: 收获5次 → 金币500/经验100 # 微信同玩好友申请自动同意： [16:05:30] [申请] 收到 1 个好友申请: 小绿 [16:05:31] [申请] 已同意 1 人: 小绿 ```
## 配置说明 ### src/config.js ```javascript const CONFIG = { serverUrl: 'wss://gate-obt.nqf.qq.com/prod/ws', clientVersion: '1.6.0.14_20251224', platform: 'qq', // 平台: qq 或 wx os: 'iOS', heartbeatInterval: 25000, // 心跳间隔 25秒 farmCheckInterval: 1000, // 农场巡查完成后等待间隔 friendCheckInterval: 10000, // 好友巡查完成后等待间隔 forceLowestLevelCrop: false, // true: 固定最低等级作物（白萝卜优先），跳过经验效率分析 }; ``` ### src/friend.js ```javascript const HELP_ONLY_WITH_EXP = true; // 只在有经验时帮助好友 const ENABLE_PUT_BAD_THINGS = false; // 是否启用放虫放草功能 ``` ## 注意事项 1. **登录 Code 有效期有限**，过期后需要重新抓取 2. **请合理设置巡查间隔**，过于频繁可能触发服务器限流 3. **微信环境**才支持邀请码和好友申请功能 4. **QQ环境**下code支持多次使用 5. **WX环境**下code不支持多次使用，请抓包时将code拦截掉 ## 免责声明 本项目仅供学习和研究用途。使用本脚本可能违反游戏服务条款，由此产生的一切后果由使用者自行承担。 ![Star History Chart](https://api.star-history.com/svg?repos=linguo2625469/qq-farm-bot&type=Date&theme=light) ## License MIT