Document complete 1.1.0 functionality and finalize release metadata

This commit is contained in:
AttilaNet
2026-11-08 12:26:42 +08:00
parent 3c1b3d6af2
commit 6e327ce856
4 changed files with 63 additions and 8 deletions
+56 -4
View File
@@ -1,13 +1,65 @@
# 牧羊人之心Bot # 牧羊人之心Bot
原生 PySide6 桌面辅助,当前版本 **1.1.0**,适配《牧羊人之心》Android **1.9.68**。
支持多账号独立运行、牧场培养、每日事务、自动扫荡及本地掉落分析。
## 运行指引 ## 运行指引
1. 在 Windows 中安装 Python 3,并确保 `python` 命令可用。 1. 在 Windows 中安装 Python 3,并确保 `python` 命令可用。
2. 按照[辅助使用说明](ranch_assistant/README.md)安装 PySide6 等依赖。 2. 在项目目录执行 `python -m pip install -r ranch_assistant/requirements.txt`,安装 PySide6 等依赖。
3. 双击项目根目录下的 `Start_Ranch_Helper.cmd` 启动辅助。 3. 双击项目根目录下的 `Start_Ranch_Helper.cmd` 启动辅助。
4. 在“登录”页面输入账号和密码,登录后选择区服;详细功能及配置方法见[辅助使用说明](ranch_assistant/README.md)。 4. 在“登录”页面输入账号和密码,登录后选择区服;详细功能及配置方法见[辅助使用说明](ranch_assistant/README.md)。
5. 登录后自动刷新状态;配置各页面的功能后,用顶部“开启策略 / 关闭策略”统一控制自动操作。关闭策略后仍继续刷新。 5. 登录后自动刷新状态;配置各页面的功能后,用顶部“开启策略 / 关闭策略”统一控制自动操作。关闭策略后仍继续刷新。
也可以在项目目录运行 `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/`,按账号和角色隔离。
本次发布通过 **201项本地测试**,覆盖会话隔离、策略开关、培养流程、奖励处理、统计与界面响应;测试使用模拟数据和模拟服务,不代表所有功能均已通过真实账号验证。
详细配置与实现范围见[辅助使用说明](ranch_assistant/README.md)。
## 项目目录与测试
- `ranch_assistant/`:原生 PySide6 界面、登录会话、手动孵蛋规则、牧场管理及测试。 - `ranch_assistant/`:原生 PySide6 界面、登录会话、手动孵蛋规则、牧场管理及测试。
- `analysis/`:接口清单、行为分析、原始反编译源码及部分审计证据。 - `analysis/`:接口清单、行为分析、原始反编译源码及部分审计证据。
- `tools/`:本地资料提取、接口清单生成和历史分析工具。 - `tools/`:本地资料提取、接口清单生成和历史分析工具。
@@ -16,17 +68,17 @@
运行测试: 运行测试:
```console ```console
python -m unittest discover -s ranch_assistant/tests -v python -B -m unittest discover -s ranch_assistant/tests -v
``` ```
这是本地 Git 仓库。原始 APK、构建包、第三方工具、签名材料、账号会话、 原始 APK、构建包、第三方工具、签名材料、账号会话、
密码、数据库、截图和运行日志均由 `.gitignore` 排除;账户数据仍保存在本机。 密码、数据库、截图和运行日志均由 `.gitignore` 排除;账户数据仍保存在本机。
## 适配版本 ## 适配版本
| 辅助版本 | 《牧羊人之心》Android 客户端版本 | 状态 | | 辅助版本 | 《牧羊人之心》Android 客户端版本 | 状态 |
| --- | --- | --- | | --- | --- | --- |
| 1.1.0(`develop/v1.1.0` 分支) | 1.9.68 | 开发中,合并后再发布标签 | | 1.1.0(`v1.1.0`) | 1.9.68 | 当前正式版本,已合并至 `main` |
| 1.0.0(`v1.0.0`) | 1.9.68 | 已发布版本 | | 1.0.0(`v1.0.0`) | 1.9.68 | 已发布版本 |
本表仅记录已经分析、测试的版本对应关系,不代表对其他客户端版本的兼容承诺。 本表仅记录已经分析、测试的版本对应关系,不代表对其他客户端版本的兼容承诺。
+5 -3
View File
@@ -1,8 +1,9 @@
# 牧羊人之心牧场辅助 # 牧羊人之心牧场辅助
原生 PySide6 窗口,使用 Qt 默认控件。双击项目根目录的 原生 PySide6 窗口,使用 Qt 默认控件。双击项目根目录的
`Start_Ranch_Helper.cmd` 启动。这台机器所需依赖已经存在。 `Start_Ranch_Helper.cmd` 启动。当前辅助版本为 **1.1.0**,适配游戏 **1.9.68**。
其他环境可先运行 `python -m pip install -r ranch_assistant/requirements.txt`。 首次运行请先执行 `python -m pip install -r ranch_assistant/requirements.txt`。
完整功能与版本摘要见[项目README](../README.md)。
底部日志区可拖动与页面之间的分隔条来调大或调小;顶部“隐藏日志 / 显示日志”切换显隐。 底部日志区可拖动与页面之间的分隔条来调大或调小;顶部“隐藏日志 / 显示日志”切换显隐。
隐藏期间仍继续记录日志,重新显示恢复上次高度;高度和显隐状态随账号/角色配置保存。 隐藏期间仍继续记录日志,重新显示恢复上次高度;高度和显隐状态随账号/角色配置保存。
@@ -242,7 +243,8 @@
- 自定义表:`typeId, sell_money, sell_exp, time_total`(秒),可只提供部分 - 自定义表:`typeId, sell_money, sell_exp, time_total`(秒),可只提供部分
覆盖列;中文列名“编号、派遣金币、强化经验、孵化秒数”也支持。 覆盖列;中文列名“编号、派遣金币、强化经验、孵化秒数”也支持。
- 测试:`python -m unittest discover -s ranch_assistant/tests -v`。 - 测试:`python -m unittest discover -s ranch_assistant/tests -v`。
- 199 项本地测试通过,覆盖登录、会话隔离、账号关闭与移除、菜单账号路由、数字框滚轮、地图缓存、请求计数、等级与体力结算、成长同步、孵蛋与补货、同种魔物培养与资质提升保护、批量喂养、派遣、赠礼、统一策略配置、委托、扫荡、奖励统计与体力效率和每日奖励。 - 201 项本地测试通过,覆盖登录、会话隔离、账号关闭与移除、菜单账号路由、数字框滚轮、地图缓存、请求计数、等级与体力结算、成长同步、孵蛋与补货、同种魔物培养与资质提升保护、批量喂养、派遣、赠礼、统一策略配置、委托、扫荡、奖励统计与体力效率和每日奖励。
登录后自动刷新、顶部统一策略开关、关闭策略后继续刷新及多账号批量开关均有回归覆盖。
新增牧场树形/平铺切换、分组数量与空位、刷新保留折叠和控件、4S保留条件、随机刷新间隔及到期独立同步的回归测试。 新增牧场树形/平铺切换、分组数量与空位、刷新保留折叠和控件、4S保留条件、随机刷新间隔及到期独立同步的回归测试。
双账号与大量库存的界面响应继续通过测试;测试使用本地模拟数据和模拟服务,不操作真实账号库存。 双账号与大量库存的界面响应继续通过测试;测试使用本地模拟数据和模拟服务,不操作真实账号库存。
- 网络写请求发生异常后不会直接重试,以免重复消耗魔物或物品。 - 网络写请求发生异常后不会直接重试,以免重复消耗魔物或物品。
+1 -1
View File
@@ -100,7 +100,7 @@ class AccountsWindow(W.QMainWindow):
def show_about(self): def show_about(self):
W.QMessageBox.about(self, "关于牧羊人之心牧场辅助", W.QMessageBox.about(self, "关于牧羊人之心牧场辅助",
f"牧羊人之心牧场辅助\n\n辅助版本:{gui.APP_VERSION}(开发中)\n适配游戏版本:{gui.GAME_VERSION}") f"牧羊人之心牧场辅助\n\n辅助版本:{gui.APP_VERSION}\n适配游戏版本:{gui.GAME_VERSION}")
def open_profile(self, profile): def open_profile(self, profile):
identifier = profile["id"] identifier = profile["id"]
+1
View File
@@ -170,6 +170,7 @@ class AccountGuiTests(unittest.TestCase):
hub.about_action.trigger() hub.about_action.trigger()
self.assertIn(gui.APP_VERSION, about.call_args.args[2]) self.assertIn(gui.APP_VERSION, about.call_args.args[2])
self.assertIn(gui.GAME_VERSION, about.call_args.args[2]) self.assertIn(gui.GAME_VERSION, about.call_args.args[2])
self.assertNotIn("开发中", about.call_args.args[2])
finally: finally:
hub.close() hub.close()