Use bag instance IDs required by the client protocol. Apply confirmed feel and giftDate values across stale queries, skip cooling targets, and schedule ready gifts independently of random polling. Replan cultivation locally and retain local strategy errors in diagnostics.
牧羊人之心Bot
原生 PySide6 桌面辅助,当前版本 1.1.0,适配《牧羊人之心》Android 1.9.68。 支持多账号独立运行、牧场培养、每日事务、自动扫荡及本地掉落分析。
运行指引
- 在 Windows 中安装 Python 3,并确保
python命令可用。 - 在项目目录执行
python -m pip install -r ranch_assistant/requirements.txt,安装 PySide6 等依赖。 - 双击项目根目录下的
Start_Ranch_Helper.cmd启动辅助。 - 在“登录”页面输入账号和密码,登录后选择区服;详细功能及配置方法见辅助使用说明。
- 登录后自动刷新状态;配置各页面的功能后,用顶部“开启策略 / 关闭策略”统一控制自动操作。关闭策略后仍继续刷新。
也可以在项目目录运行 python -m ranch_assistant 启动。
首次使用可先查看各页面数据、配置规则,再开启策略;重启、恢复会话或导入配置后,策略开关默认关闭。
当前功能
| 模块 | 1.1.0 已具备的功能 |
|---|---|
| 登录与多账号 | 第一弹渠道账号密码登录,选择官方返回的区服及角色;账号密码与会话在本机加密保存,支持恢复会话、多账号独立运行、退出登录及清除登录记录。关闭账号页签后重启不会重新打开,也可彻底移除该账号的本地记录。 |
| 状态刷新与策略开关 | 登录后自动刷新角色、培育室、背包及牧场状态;每个账号只有一个“开启策略 / 关闭策略”开关,菜单支持批量控制。关闭策略后仍同步状态和到期成长;手动刷新不触发消耗类自动操作。 |
| 玩家信息 | 显示等级、经验与下一级门槛、金币、氪金、体力;经验达到门槛及体力恢复到期时,在后台请求服务器结算并更新显示。 |
| 培育室 | 显示已开启、未开启、VIP坑位及魔物阶段、剩余时间和成熟资质;孵化与成长到期自动同步。普通坑位可在确认费用后扩建。 |
| 分类背包 | 魔物蛋、可使用物品、消耗品、材料、其他、装备分别展示;支持搜索和排序。每种蛋可配置孵化开关、优先级、孵出后去向、补货下限/目标及市场;物品可配置赠礼开关和保留数量。 |
| 牧场与魔物管理 | 默认平铺全部魔物,可切换为按牧场折叠分组;显示容量、空位、等级与突破上限、资质、参考属性、好感上限及喜欢的物品。支持详情查看、多选锁定/解锁、派遣、指定喂养,以及确认费用后新建牧场。 |
| 自动孵蛋与补货 | 按手动规则完成金币市场买蛋/抽蛋、孵化、成长同步、成熟收取、派遣或喂养;支持优先十连、金币保留和每日购蛋额度。空坑按优先级独立随机1~2秒装填,不受整体刷新间隔影响。 |
| 资质保留与经验喂养 | 支持星级、综合资质、四项全S(4S)保护,另可保留资质严格高于牧场同种培养代表的新魔物。经验喂养按目标优先级批量提交素材,遵守当前突破上限与停止等级,保护锁定、在队和委托所需魔物。 |
| 自动赠礼与好感培养 | 在背包选择物品、牧场选择目标后自动赠礼;跳过冷却目标,连续处理其他可送目标,在本地倒计时并到期核对状态。支持喜欢物品筛选、库存保留及当前好感上限。可在本地自动为每种魔物选择唯一培养代表,依次按等级、好感、成长资质比较,完全相同时随机选定并记住。 |
| 每日事务 | 查看并领取每日签到礼包、七日签到、累计奖励、已有VIP日奖和邮件附件;支持手动领取及按勾选项目自动领取。 |
| 自动委托 | 根据每日剩余次数、城市与库存接取委托,推进已满足条件的步骤并领奖;显示金币和氪金奖励,金币、道具及魔物提交可分别限制。需要实战的步骤等待用户在游戏内完成。 |
| 自动扫荡 | 按地区折叠显示关卡、难度、通关星级及可能掉落;账号地图首次读取后本地缓存,仅手动刷新关卡时重新获取。逐关勾选、选择已解锁难度和本日次数上限,配置保留体力与战队;处理普通扫荡及探索奖励事件,记录实际奖励。 |
| 掉落数据分析 | 按账号、关卡与难度在本地保存扫荡记录,分别统计普通扫荡、奖励事件或合计;展示样本数、出现次数、总数量、实测掉落率、平均数量和95%区间。支持掉落率/每点体力获得数量的条形图,不额外请求游戏服务器。 |
| 收益资料与执行计划 | 内置749种魔物的培育时间、派遣金币、强化经验及每小时收益,支持名称/星级筛选和CSV/XLSX覆盖;执行计划显示下一步操作与等待原因。 |
| 统一策略配置 | 规则修改后自动保存并应用;通过原生菜单保存、导入或导出当前账号的孵蛋、牧场、喂养、赠礼、委托、每日事务、扫荡、刷新间隔及自定义收益资料。跨账号按魔物种类匹配培养目标,导出文件不包含账号凭据。 |
| 界面与调试 | 原生Qt菜单、可调整和隐藏的日志区、各页右键刷新;数字与勾选项可排序,数字框获得焦点后才响应滚轮,下拉框按内容扩宽。独立调试窗口查看请求、响应、耗时与错误,支持复制、导出和本地脱敏日志。 |
| 后台处理与离线演示 | 各账号后台线程独立处理网络与资料,单账号请求串行;只渲染当前查看页面,大列表分批更新并复用控件。支持随机30秒、60秒、2分钟或5分钟上限的刷新间隔,以及无需连接服务器的离线演示。 |
1.1.0 更新重点
- 重整登录、培育室、分类背包和牧场页面,合并魔物与牧场展示,保留平铺/分组切换。
- 打通按蛋规则补货、孵化、成长同步、收取、派遣及批量喂养的流程,增加4S和同种资质提升保护。
- 增加自动赠礼与同种唯一培养代表,避免重复培养多只同种魔物。
- 统一策略自动保存及跨账号导入/导出,将监控与执行控制简化为一个策略开关。
- 完善等级、体力、账号关闭/移除和本地地图缓存;扫荡奖励与事件分别处理,新增掉落概率及体力效率分析。
- 优化双账号、大量魔物及背包库存下的刷新响应,修复表格控件、下拉框裁字、滚轮误改数值和成长资质显示等问题。
功能范围与数据
当前登录适配第一弹渠道;需要短信验证的登录流程尚未提供验证码界面。 自动扫荡仅用于已满足游戏原有条件的普通关卡,首次通关、特殊关卡及委托战斗仍需在游戏内手动完成;不再提供手机截图配置或ADB自动战斗。
地图与可能掉落来自客户端静态配置,实际奖励以服务器响应为准;统计概率为本账号已确认样本的实测值。 “每点体力数量”按已知消耗样本的物品总量除以实际扣除体力计算,未知消耗不参与。 资料包含1178个关卡和2079种道具名称;客户端或接口更新后可能需要重新适配。
账号凭据、策略、地图缓存、购蛋/扫荡记录及统计数据库均保存在本机 local_state/ranch_helper/,按账号和角色隔离。
当前代码通过 209项本地测试,覆盖会话隔离、策略开关、培养流程、奖励处理、统计与界面响应;测试使用模拟数据和模拟服务,不代表所有功能均已通过真实账号验证。
详细配置与实现范围见辅助使用说明。
项目目录与测试
ranch_assistant/:原生 PySide6 界面、登录会话、手动孵蛋规则、牧场管理及测试。analysis/:接口清单、行为分析、原始反编译源码及部分审计证据。tools/:本地资料提取、接口清单生成和历史分析工具。backend/:早期的独立本地接口原型,不是辅助连接的官方服务。
运行测试:
python -B -m unittest discover -s ranch_assistant/tests -v
原始 APK、构建包、第三方工具、签名材料、账号会话、
密码、数据库、截图和运行日志均由 .gitignore 排除;账户数据仍保存在本机。
适配版本
| 辅助版本 | 《牧羊人之心》Android 客户端版本 | 状态 |
|---|---|---|
1.1.0(v1.1.0) |
1.9.68 | 当前正式版本,已合并至 main |
1.0.0(v1.0.0) |
1.9.68 | 已发布版本 |
本表仅记录已经分析、测试的版本对应关系,不代表对其他客户端版本的兼容承诺。
免责声明
本项目及其文档仅用于编程学习、技术研究与交流,不构成任何使用建议、服务承诺或法律依据。项目不提供、不指导也不协助制作、传播或使用游戏修改包、外挂、绕过安全检测、规避反作弊或其他破坏性工具;请勿将本项目用于上述用途。
游戏客户端、接口或规则更新后,相关内容可能失效或不再适用;本项目不承诺兼容其他版本,也不承诺提供后续适配、更新或技术支持。
本项目与相关游戏、厂商、平台及权利方无任何隶属、授权、合作或背书关系。涉及的游戏名称、程序、素材、接口、商标及其他第三方内容,其权利归相应权利人所有。请勿未经许可复制、分发或商用相关内容;如权利方认为本项目存在不妥内容,可联系项目维护者核实处理。
使用者应自行遵守适用的法律法规、平台规则、游戏用户协议及第三方权利要求,并在合法授权范围内使用本项目。因使用、修改、分发或无法使用本项目而产生的账号异常、数据丢失、设备故障、争议、处罚或其他直接或间接损失,由行为人自行承担;在法律允许的最大范围内,项目维护者及贡献者不承担相关责任。任何第三方的行为均不代表项目维护者的立场或授权。
请勿在公开页面、提交记录或 Issue 中上传账号、密码、Token、会话密钥、签名材料、个人身份信息或其他敏感数据。本项目按“现状”提供,不保证持续维护、功能完整、兼容性或适用于任何特定目的。继续使用即表示你已阅读并理解上述内容;如不同意,请停止使用并删除相关副本。