Release ranch assistant 1.2.0

This commit is contained in:
AttilaNet
2026-11-10 15:05:56 +08:00
parent 6d74730735
commit 7fe4c0ffdf
7 changed files with 100 additions and 37 deletions
+26 -12
View File
@@ -1,10 +1,24 @@
# 牧羊人之心牧场辅助
原生 PySide6 窗口,使用 Qt 默认控件。双击项目根目录的
`Start_Ranch_Helper.cmd` 启动。当前开发版本为 **1.2.0.dev1**,资料基线为游戏 **1.9.68**;最近正式版本为 **1.1.1**。56个模块隔离测试共724项通过、0项跳过;单进程整套Qt测试曾出现崩溃,本轮采用逐模块独立进程验证。原版运行时最终集成与真实账号验证仍待完成,当前桌面自动战斗使用我方对敌最终伤害10倍、单次最高50000的内置模拟。
`Start_Ranch_Helper.cmd` 启动,也可在项目根目录运行 `python -m ranch_assistant`。当前正式版本为 **1.2.0**(`v1.2.0`),资料基线为游戏 Android **1.9.68**。功能基线56个模块隔离测试共724项通过、0项跳过,本次版本号发布14项定向及旧 dev1 配置兼容验证通过,两组有重叠、不相加;单进程整套Qt测试曾出现崩溃,功能基线采用逐模块独立进程验证。本轮未调用真实游戏 API,真实账号验收尚未完成;桌面自动战斗固定使用我方对敌最终伤害10倍、单次最高50000的内置近似模型,原 AIR 仅用于离线研究,不是桌面可选运行时。
首次运行请先执行 `python -m pip install -r ranch_assistant/requirements.txt`。
完整功能与版本摘要见[项目README](../README.md)。
## 1.2.0 更新内容
相对 1.1.1,本版主要变化如下,具体操作与限制见各节:
- 主线默认展示当前进行中、待接取与待领奖任务,支持类别、状态、关键词组合筛选、已支持任务链推进和已知地图来源的材料/蛋/击杀收集。
- 委托按氪金奖励20→15→10选择可处理任务,独立启用并优先完成步骤与材料收集;按委托缺口自动买蛋、孵化再交付的联动尚未完成。
- 桌面固定使用内置近似战斗模型:我方对敌最终伤害10倍、单次最高50000,敌方伤害与角色属性不乘倍;未满星普通关可自动挑战,矿洞/门票关须另行启用并核对工具库存及保留量。
- 完善跨牧场及孵化批次的最低保留数量、同种更高资质额外保留和牧场统一喂养优先级;“潜能突破设置”定位自动突破目标与优先级,材料补潜能、潜能阶段与同种喂养分别处理。
- 顶部策略开启后自动领取已完成探险奖励;再次出发默认关闭,独立配置总开关与每队规则。
- 默认合计扫荡与奖励事件样本,展示来源拆分、事件独有物品、实测掉落率、95%区间和体力效率,支持按来源切换。
- 完善子功能独立停止、顶部停止及中断恢复,保持账号/角色隔离与地图缓存复用;已发出而结果不明的写请求只核对状态,不自动重发。
发布说明见[v1.2.0 Release 说明](../analysis/RELEASE_1_2_0.md)。特殊脚本、技能及场地尚未全支持,战斗记录仍可能显示编号或 `local`;本地测试结果不代表服务器通关或用户全部验收。
底部日志区可拖动与页面之间的分隔条来调大或调小;顶部“隐藏日志 / 显示日志”切换显隐。
隐藏期间仍继续记录日志,重新显示恢复上次高度;高度和显隐状态随账号/角色配置保存。
孵蛋优先级、补货下限/目标和魔物喂养优先级均可直接输入数字,没有上下箭头。
@@ -92,26 +106,26 @@
## v1.2 自动主线与战斗设置
本节对应 **1.2.0.dev1 开发版**。任务调度和界面已实现,桌面 GUI 隐藏运行时选择并强制使用实验模拟,存在局部能力限制;完整集成 QA、实际阵容的原 AIR 输入桥接和真实账号验收尚未完成。
本节对应 **1.2.0 正式版**。任务调度和界面已实现,桌面 GUI 隐藏运行时选择并固定使用内置实验模拟;原 AIR 只保留作离线研究。特殊脚本、技能及场地机制未全支持,模型与真实账号胜负、计时及服务器接受结算的结果尚未经本轮真实游戏 API 验收。
1. 登录或恢复当前角色后,进入“自动主线”,点击“刷新任务 / 预览”。“任务状态”默认只显示当前进行中、待接取及待领奖的主线任务;类别、状态和关键词可组合筛选,需要查看未解锁或已完成任务时再切换状态。当前受阻的任务仍会显示原因;选择一行可查看步骤、目标位置、NPC、需求和对话。筛选在本地完成,刷新用于同步与预览,不执行任务交付或开战。
2. 打开“推进策略”,选择主线或支线、自动接取、已支持对话和补链选项。需要补齐材料、蛋或击杀时,勾选“自动收集任务材料 / 击杀目标”;来源必须符合当前位置、地图解锁、资源保护及运行时能力。
3. 任务和委托统一使用内置模拟,无需选择运行时;角色属性保持原值,按已用修改客户端的规则将我方打敌方的最终伤害乘10、单次最高50000,计算战斗过程并等待相应时长后再提交。选择推进战斗队伍,设置保留体力、单次交付金币上限、物品保留量和连续失败停止次数。物品、魔物交付默认关闭,金币上限默认 0。
3. 任务和委托统一使用内置模拟,无需选择运行时;角色属性保持原值,将我方对敌最终伤害乘10、单次最高50000,敌方伤害不乘倍,计算战斗过程并等待相应时长后再提交。选择推进战斗队伍,设置保留体力、单次交付金币上限、物品保留量和连续失败停止次数。物品、魔物交付默认关闭,金币上限默认 0。
4. 委托仍在“自动委托”单独配置启用、接取、城市、交付限制及“也接取需要实战的委托”。按奖励氪金20→15→10优先接取可处理的委托,已有委托优先完成,委托步骤及材料补缺优先于普通孵蛋、赠礼、主线和刷图。缺少材料时自动选择已支持的扫荡/挑战来源,并遵守保留设置;已有足够库存则直接交付。按委托缺口买蛋、孵化、交付的完整联动尚待实现。
委托自动执行只需启用“自动委托”及顶部绿色“开启”,下一轮状态刷新会检查接取和完成条件,无需启用自动主线。接取前会逐份检查实际战斗能力;高奖励委托无法完成时继续检查其他同奖励或较低奖励的委托。表格“需求 / 进度”以中文显示暂不接取或等待条件的原因。勾选允许提交道具、魔物及实战表示允许这些操作,不能使尚未实现的战斗机制或买蛋孵化联动自动变为可用。
5. 勾选“启用自动主线策略”,再点击顶部绿色“开启”。修改规则会自动保存并应用;菜单“策略配置”可立即保存、导入或导出当前账号规则,包含任务策略,战斗固定为实验模拟。重启、恢复会话和导入后,顶部策略开关保持关闭,核对后再开启。
6. 在“战斗记录”查看上下文、队伍、胜负和原因;“刷新本地记录”只读取本机记录。点击顶部红色“停止”可取消后续推进和可取消的运行/时钟等待;已经发出的请求仍须等待确认,开战后的未知状态会保留待核对记录。
6. 在“战斗记录”查看上下文、队伍、胜负和原因;“刷新本地记录”只读取本机记录。缺少名称时仍可能显示任务/关卡编号,内部结果 `local` 也可能直接出现,当前并未完成全部中文化。点击顶部红色“停止”可取消后续推进和可取消的运行/时钟等待;已经发出的请求仍须等待确认,开战后的未知状态会保留待核对记录。
有待核对记录时,后台最长每2分钟刷新服务器状态,无需手动核对。若是模型已完成、仅等待战斗时长时被中断,开启对应策略后会自动续交原先保存的胜利结果,保持同一任务实例与步骤,不重新发起入场请求或模拟;旧版记录也可恢复。关闭策略时只查询状态,不续交。结算请求已发出但结果未知时只自动查询,不重复发送;没有足够服务器证据时仍会显示等待原因。
| 能力 | 当前开发版行为与边界 |
| 能力 | 1.2.0 行为与边界 |
| --- | --- |
| 任务与对话 | 已实现接取、已支持线性对话、满足条件后的交付、领奖、后继接取与任务补链。服务器确认步骤后,才完成后续剧情和本地步骤收尾;本地检查点按账号/角色保存。 |
| 开图与收集 | 随任务目标和地图前置推进,缺少材料、蛋或已识别的成年目标击杀时规划普通地图;可能掉落只用于选择来源,实际库存与击杀仍需结算后刷新。扫荡不计作击杀来源。 |
| 扫荡 | 普通、非特殊、无当前任务截获的关卡,三个难度全部通关后才可扫荡。“允许用扫荡完成已通关目标”受此条件限制;任务专属战斗和任务通关战斗仍走各自任务路线。逐关次数与难度在“自动扫荡”配置。 |
| 地图奖励事件 | 普通地图开始时若已经发放探索奖励,单独记录奖励并刷新;该分支不运行战斗,也不重复提交战斗奖励。隐藏战斗重新检查能力,未知事件保留待处理。 |
| 原版内核研究工具 | 保留原 AIR 离线验证工具,不再要求桌面用户选择;最终原版集成尚待完成。 |
| 原版内核研究工具 | 原 AIR 仅用于离线研究,不属于桌面可选运行时,也不是源码启动辅助的额外依赖。 |
| 内置模拟 | 独立进程使用原始属性资料计算 AP、出场、移动、攻击及技能 3、5、7、9、38 的部分机制;桌面模拟将我方打敌方的最终伤害乘10、单次最高50000。保留轨迹、胜负和异常,并等待计算出的战斗时长。物理、随机、时序、装备及其他技能存在近似或遗漏,结果可能与客户端不同。任务1002002所需的纯显示 `buffMovie` 控制器已支持。 |
任务资料包含 1165 个任务、1178 个关卡、337 个 NPC 和 4269 份脚本;4239 份属于已支持的线性脚本,主线引用中为 718/720。这些是资料与脚本分类数量,不是整条主线通关率。30 份特殊选择等脚本(含 2 份主线)、4 类特殊接取入口、任务1001006第4步的特殊抽蛋钩子尚不支持;活动、羁绊和未知任务类别也不承诺自动推进。
@@ -122,7 +136,7 @@
看到“待核对”“不支持”或资源不足时,先查看任务详情和战斗记录中的具体原因。请求结果不明时,本账号的牧场、赠礼及任务等冲突写操作会暂停;重启不会清除待核对状态。恢复角色后点击“刷新任务 / 预览”,程序只在新的角色/任务状态足以证明结果时解除阻塞,随后可继续已保存的普通剧情检查点;证据不足时仍等待用户在游戏内核实。不要通过删除记录或反复开启来重发未知请求,策略导入也不能覆盖服务器通关进度或解除未知结算。
任务与战斗记录保存在本账号、区服和角色的本地工作区;规则导出不含凭据、任务执行记录、待核对日志或服务器进度。逐项实测入口和结果模板见[v1.2 当前开发版验收清单](../analysis/V1_2_ACCEPTANCE_CHECKLIST.md),实现边界、验证记录和接口分流另见[v1.2 实施与阶段交接](../analysis/V1_2_IMPLEMENTATION.md)。
任务与战斗记录保存在本账号、区服和角色的本地工作区;规则导出不含凭据、任务执行记录、待核对日志或服务器进度。逐项实测入口和结果模板见[v1.2.0 验收清单](../analysis/V1_2_ACCEPTANCE_CHECKLIST.md);[v1.2 实施与阶段交接](../analysis/V1_2_IMPLEMENTATION.md)保留历史阶段验证与接口分流记录,其中开发版本和运行时方案不代表本版当前状态。
## 连接真实角色
@@ -194,7 +208,7 @@
删除保存会话需先退出登录,再点击“删除选中保存会话”;也可使用“退出登录并清除登录记录”一次清理当前账号页签。
“记住账号和密码”只控制密码,独立于会话保存。
正常会话心跳按客户端的 240 秒周期运行;成长状态按阶段到期触发同步。需要实际战斗的关卡在游戏内手动进行。
正常会话心跳按客户端的 240 秒周期运行;成长状态按阶段到期触发同步。受支持的关卡可按配置使用内置模拟挑战;不支持或待核对的战斗仍需在游戏内处理。
## 页面数据与刷新
@@ -288,8 +302,8 @@
未知魔物和不完整资质不会自动派遣或喂养。
- 自定义表:`typeId, sell_money, sell_exp, time_total`(秒),可只提供部分
覆盖列;中文列名“编号、派遣金币、强化经验、孵化秒数”也支持。
- 测试:`python -B -m unittest discover -s ranch_assistant/tests -v`。
- 1.1.1 阶段记录为 209 项本地测试;v1.2 的数据/规划、编排、模型和界面定向验证见[实施验证记录](../analysis/V1_2_IMPLEMENTATION.md#验证记录),完整集成 QA 仍在进行,各组数量不能直接相加作为全量结果。原有回归覆盖登录、会话隔离、账号关闭与移除、菜单账号路由、数字框滚轮、地图缓存、请求计数、等级与体力结算、成长同步、孵蛋与补货、同种魔物培养与资质提升保护、批量喂养、派遣、赠礼、统一策略配置、委托、扫荡、奖励统计与体力效率和每日奖励。
- 测试按模块独立进程运行,例如 `python -B -m unittest ranch_assistant.tests.test_progression -v`;此命令只复查指定模块。
- 功能基线 **56个模块逐模块独立进程测试,共724项通过、0项跳过**;单进程整套Qt测试曾崩溃,不能写成同进程全部成功。**本次版本号发布14项定向测试及旧 dev1 配置兼容验证通过**;版本常量与导出断言已更新为1.2.0,旧 `1.2.0.dev1` 的 schema 1/2 配置导入兼容已验证,**两组有重叠,不相加**。1.1.1 阶段记录为 209 项本地测试;历史定向验证见[实施验证记录](../analysis/V1_2_IMPLEMENTATION.md#验证记录),各组数量有重叠,不直接相加。当前联网条目仍为未测,不代表真实账号、服务器结算或全部功能验收通过。原有回归覆盖登录、会话隔离、账号关闭与移除、菜单账号路由、数字框滚轮、地图缓存、请求计数、等级与体力结算、成长同步、孵蛋与补货、同种魔物培养与资质提升保护、批量喂养、派遣、赠礼、统一策略配置、委托、扫荡、奖励统计与体力效率和每日奖励。
赠礼覆盖手动目标冷却跳过、连续赠礼、独立到期调度、成功响应回写、滞后查询及本地培养筛选不发请求的回归测试;本地策略与页面异常写入调试日志并标记为本地错误。
登录后自动刷新、顶部统一策略开关、关闭策略后继续刷新及多账号批量开关均有回归覆盖。
新增牧场树形/平铺切换、分组数量与空位、刷新保留折叠和控件、4S保留条件、随机刷新间隔及到期独立同步的回归测试。
@@ -301,7 +315,7 @@
“自动委托”需单独启用;可先关闭“自动孵蛋”的自动管理,只运行委托。
道具和魔物提交默认关闭,金币提交上限默认 0;锁定、队伍、高星和高资质保护继续生效。
已接委托需要的魔物种类和蛋会纳入牧场保留。
“也接取需要实战的委托”允许经检查后接取实战委托;已支持的剧情、交付和专用战斗通过任务调度继续推进。队伍在“自动主线 → 推进策略”选择,战斗固定为实验模拟,委托资源限制仍由本页配置。实际阵容桥接和真实账号验收尚待完成,不应把这个开关视为所有委托均已可用。
“也接取需要实战的委托”允许经检查后接取实战委托;已支持的剧情、交付和专用战斗通过任务调度继续推进。队伍在“自动主线 → 推进策略”选择,战斗固定为实验模拟,委托资源限制仍由本页配置。模型机制覆盖与真实账号验收尚未完成,不应把这个开关视为所有委托均已可用。按委托缺口自动买蛋、孵化并交付的完整联动仍未实现。
普通、非剧情定位关卡的三个难度全部通关后才开放扫荡,无需本地战斗演算或手机截图。首次挑战、任务专属战斗与扫荡分别处理,当前可执行范围见上方能力表。客户端调用链与字段证据见[地图及每日事务研究](../analysis/STAGES_DAILY.md)和[战斗路线说明](../analysis/V1_2_IMPLEMENTATION.md#调度与恢复约定)。
@@ -324,7 +338,7 @@ VIP奖励只对已有资格领取;不会购买VIP或升级礼包。邮件仅
资料包含此APK的1178个关卡、各难度奖励和2079种道具名称。
这些是安装包配置中的可能掉落,并非实时掉落概率保证;后续热更新新增数据需要重新提取。
这些流程有本地模拟验证;本轮开发验证未执行真实游戏请求,v1.2 的任务与战斗服务器验收仍待用户手动验证。软件在用户开启策略后,可按配置和能力检查自动执行已支持操作。
这些流程有本地模拟验证;本轮未调用真实游戏 API,v1.2.0 的任务与战斗服务器验收仍待用户手动验证。软件在用户开启策略后,可按配置和能力检查自动执行已支持操作。
静态证据与字段规则见[地图及每日事务研究](../analysis/STAGES_DAILY.md)。
## 刷新响应与批量喂养