Release ranch assistant 1.2.0
This commit is contained in:
@@ -1,7 +1,7 @@
|
||||
# 牧羊人之心Bot
|
||||
|
||||
原生 PySide6 桌面辅助,当前开发版本 **1.2.0.dev1**,适配资料基线为《牧羊人之心》Android **1.9.68**;最近正式版本为 **1.1.1**。
|
||||
支持多账号独立运行、牧场培养、每日事务、自动扫荡及本地掉落分析;v1.2 新增任务、对话与战斗调度,完整集成验证仍在进行。
|
||||
原生 PySide6 桌面辅助,当前正式版本 **1.2.0**(`v1.2.0`),适配资料基线为《牧羊人之心》Android **1.9.68**。
|
||||
支持多账号独立运行、牧场培养、每日事务、自动扫荡及本地掉落分析;1.2.0 增加主线与委托推进、内置模拟挑战、潜能突破和自动探险等功能,能力与验证限制见下文。
|
||||
|
||||
## 运行指引
|
||||
|
||||
@@ -16,7 +16,7 @@
|
||||
|
||||
## 当前功能
|
||||
|
||||
| 模块 | 1.2.0.dev1 当前实现(战斗能力范围见下文) |
|
||||
| 模块 | 1.2.0 当前实现(战斗能力范围见下文) |
|
||||
| --- | --- |
|
||||
| 登录与多账号 | 第一弹渠道账号密码登录,选择官方返回的区服及角色;账号密码与会话在本机加密保存,支持恢复会话、多账号独立运行、退出登录及清除登录记录。关闭账号页签后重启不会重新打开,也可彻底移除该账号的本地记录。 |
|
||||
| 状态刷新与策略开关 | 登录后自动刷新角色、培育室、背包及牧场状态;每个账号只有一个“开启 / 停止”开关,菜单支持批量控制。关闭策略后仍同步状态和到期成长;手动刷新不触发消耗类自动操作。 |
|
||||
@@ -39,17 +39,25 @@
|
||||
| 界面与调试 | 原生Qt菜单、可调整和隐藏的日志区、各页右键刷新;数字与勾选项可排序,数字框获得焦点后才响应滚轮,下拉框按内容扩宽。独立调试窗口查看请求、响应、耗时与错误,支持复制、导出和本地脱敏日志。 |
|
||||
| 后台处理与离线演示 | 各账号后台线程独立处理网络与资料,单账号请求串行;只渲染当前查看页面,大列表分批更新并复用控件。支持随机30秒、60秒、2分钟或5分钟上限的刷新间隔,以及无需连接服务器的离线演示。 |
|
||||
|
||||
## 1.2 开发版使用要点
|
||||
## 1.2.0 更新内容
|
||||
|
||||
在“自动主线 → 任务状态”点击“刷新任务 / 预览”,查看下一步和阻塞原因;到“推进策略”选择任务范围、推进战斗队伍、保留体力和交付限制,再勾选“启用自动主线策略”,用顶部绿色“开启”运行、红色“停止”暂停。规则自动保存,重启、恢复会话或导入配置后仍需手动开启。委托接取、交付和“也接取需要实战的委托”继续在“自动委托”配置。
|
||||
相对 1.1.1,本版新增和完善以下功能:
|
||||
|
||||
- **内置战斗模拟**:无需选择运行时,程序使用原始属性资料,在独立进程中计算 AP、出场、移动、攻击和部分技能;桌面模拟按已用修改客户端的规则,将我方打敌方的最终伤害乘10,单次最高50000,等待计算出的战斗时长后提交结果。模型仍有机制近似与遗漏,可能和客户端胜负不同,未支持的战斗会显示原因。
|
||||
- **主线与状态筛选**:默认展示当前进行中、待接取及待领奖的主线;类别、状态和关键词可组合筛选,也可查看未解锁或已完成任务。支持已实现的接取、线性对话、交付、领奖与补链,按已知普通地图来源收集材料、蛋和击杀目标,阻塞时显示原因。
|
||||
- **内置战斗模拟**:无需选择运行时,程序使用原始属性资料,在独立进程中计算 AP、出场、移动、攻击和部分技能;桌面模型将我方对敌最终伤害乘10,单次最高50000,敌方伤害与角色属性不乘倍,等待计算出的战斗时长后提交结果。模型仍有机制近似与遗漏,可能和客户端胜负不同,未支持的战斗会显示原因。
|
||||
- **委托优先**:按奖励氪金数量20→15→10接取可处理的委托,优先执行委托步骤和材料补缺,再处理主线及普通牧场策略。缺少材料时使用现有扫荡/挑战来源;按委托缺口自动购买并孵化魔物蛋的联动留待后续实现。
|
||||
- **地图与扫荡**:在“自动扫荡”勾选“未满星时自动挑战”,已解锁普通关卡可使用内置模拟首次挑战,无需开启自动主线;满足三个难度全部通关的条件后自动使用扫荡。普通地图直接发放探索奖励时按事件处理;当前任务占用的关卡交由自动主线处理。
|
||||
- **矿洞与门票关卡**:在同一“自动扫荡”页筛选“矿洞与门票”,开启默认关闭的“允许矿洞 / 门票关卡”,再逐关勾选。仅显示原入口难度1,不采用残留的2/3级占位费用。此类关卡使用实际模型挑战结果,不伪装成扫荡;已提取战斗配置不等于模型支持或可通关,其他特殊关仍不可用。
|
||||
- **保留数量与同种资质**:“牧场保留”默认1、0关闭数量保护,跨牧场和孵化批次合计;同种资质严格更高才额外保留,同分不额外保留,锁定等保护独立生效。牧场统一设置喂养目标和优先级,数字越小越优先;同种喂养突破与潜能阶段分别计算。
|
||||
- **潜能突破定位**:牧场的“潜能突破设置”定位到自动突破目标和优先级列;勾选后先补满四项潜能,再提升潜能阶段,遵守材料保留量,不购买材料或消耗金币、氪金。定位按钮本身不修改勾选,也不代替同种喂养设置。
|
||||
- **探险领奖与再次出发**:顶部策略开启后自动领取已完成队伍奖励;再次出发默认关闭,独立配置总开关与逐队规则。关闭再次出发不影响完成领奖,不花钱开队或召回;探险中的战队成员会阻止对应战斗。
|
||||
- **事件与扫荡合计统计**:默认合计扫荡和奖励事件,并展示来源样本拆分及事件独有奖励;表格、图表可切换来源,查看实测掉落率、95%区间及每点体力获得数量,未知消耗不参与体力效率,不额外请求服务器。
|
||||
- **停止、隔离与缓存**:子功能开关独立生效,顶部停止禁止后续策略写操作并取消可取消的等待;账号/角色策略与记录隔离,普通监控复用地图缓存,刷新或挑战确认结束后更新进度。
|
||||
- **中断恢复**:后台最长每2分钟自动核对角色与任务。模型已完成、等待时长被中断且结算从未发出的记录,在策略开启后自动续交保存的胜利结果;不重新开战或模拟。已经发出但结果不明的写请求不重发,继续核对服务器状态。
|
||||
|
||||
详细设置、能力限制与恢复方法见[辅助使用说明](ranch_assistant/README.md#v12-自动主线与战斗设置);逐项实测入口及结果模板见[v1.2 当前开发版验收清单](analysis/V1_2_ACCEPTANCE_CHECKLIST.md),阶段证据见[v1.2 实施与交接](analysis/V1_2_IMPLEMENTATION.md)。当前仍为开发版,尚未发布 v1.2 正式标签。
|
||||
在“自动主线 → 任务状态”点击“刷新任务 / 预览”,查看下一步和阻塞原因;到“推进策略”选择任务范围、推进战斗队伍、保留体力和交付限制,再勾选“启用自动主线策略”,用顶部绿色“开启”运行、红色“停止”暂停。规则自动保存,重启、恢复会话或导入配置后仍需手动开启。委托接取、交付和“也接取需要实战的委托”继续在“自动委托”配置。
|
||||
|
||||
详细设置、能力限制与恢复方法见[辅助使用说明](ranch_assistant/README.md#v12-自动主线与战斗设置);逐项实测入口及结果模板见[v1.2.0 验收清单](analysis/V1_2_ACCEPTANCE_CHECKLIST.md),发布摘要见[v1.2.0 Release 说明](analysis/RELEASE_1_2_0.md)。
|
||||
|
||||
## 1.1.1 更新内容
|
||||
|
||||
@@ -74,10 +82,10 @@
|
||||
|
||||
地图与可能掉落来自客户端静态配置,实际奖励以服务器响应为准;统计概率为本账号已确认样本的实测值。
|
||||
“每点体力数量”按已知消耗样本的物品总量除以实际扣除体力计算,未知消耗不参与。
|
||||
资料包含1178个关卡和2079种道具名称;v1.2 的独立任务资料另含1165个任务、337个NPC和4269份剧情脚本,其中4239份属于已支持的线性类别,主线引用的720份中有718份属于该类别。脚本分类数量不代表任务或战斗全部通过;30份特殊选择等脚本、4类特殊接取入口及任务1001006的抽蛋钩子仍不支持。客户端热更新与当前账号资源是否一致尚未验证。
|
||||
资料包含1178个关卡和2079种道具名称;v1.2 的独立任务资料另含1165个任务、337个NPC和4269份剧情脚本,其中4239份属于已支持的线性类别,主线引用的720份中有718份属于该类别。脚本分类数量不代表任务或战斗全部通过;30份特殊选择等脚本、4类特殊接取入口及任务1001006的抽蛋钩子仍不支持。部分技能、触发器与场地机制尚未实现;战斗记录缺少名称时仍可能显示任务/关卡编号或内部结果 `local`。客户端热更新与当前账号资源是否一致尚未验证。
|
||||
|
||||
账号凭据、策略、地图缓存、购蛋/扫荡记录及统计数据库均保存在本机 `local_state/ranch_helper/`,按账号和角色隔离。
|
||||
v1.2 本轮完整模块隔离回归为56个模块共724项通过、0项跳过;单进程运行整套Qt测试曾出现崩溃,本轮采用逐模块独立进程验证。当前桌面自动战斗使用内置模拟的10倍伤害规则,原版适配器最终集成仍待完成。历史阶段记录见[实施验证记录](analysis/V1_2_IMPLEMENTATION.md#验证记录),当前验收范围见[验收清单](analysis/V1_2_ACCEPTANCE_CHECKLIST.md)。本地模拟结果不代表真实账号通关、服务器接受结算或全部关卡支持。本轮开发验证未执行真实游戏请求,真实账号联网验收由用户手动进行;软件在用户开启策略后,可按配置和能力检查自动执行已支持操作。
|
||||
v1.2.0 功能基线回归为 **56个模块逐模块独立进程测试,共724项通过、0项跳过**;单进程运行整套Qt测试曾出现崩溃,不能表述为同进程整套测试成功。**本次版本号发布14项定向测试及旧 dev1 配置兼容验证通过**:正式版版本常量与导出断言已更新为1.2.0,旧 `1.2.0.dev1` 的 schema 1/2 配置导入兼容已验证;**两组有重叠,不相加**。当前桌面自动战斗固定使用内置近似模型,原 AIR 仅作离线研究,不是桌面可选运行时。历史阶段记录见[实施验证记录](analysis/V1_2_IMPLEMENTATION.md#验证记录),当前验收范围见[验收清单](analysis/V1_2_ACCEPTANCE_CHECKLIST.md)。本地模拟结果不代表真实账号通关、服务器接受结算或全部关卡支持。**本轮未调用真实游戏 API,未完成真实账号任务、开战、结算、领奖与资源消耗验收**;软件在用户开启策略后,可按配置和能力检查自动执行已支持操作。
|
||||
详细配置与实现范围见[辅助使用说明](ranch_assistant/README.md)。
|
||||
|
||||
## 项目目录与测试
|
||||
@@ -87,12 +95,15 @@ v1.2 本轮完整模块隔离回归为56个模块共724项通过、0项跳过;
|
||||
- `tools/`:本地资料提取、接口清单生成和历史分析工具。
|
||||
- `backend/`:早期的独立本地接口原型,不是辅助连接的官方服务。
|
||||
|
||||
运行测试:
|
||||
按模块独立进程复查测试,例如:
|
||||
|
||||
```console
|
||||
python -B -m unittest discover -s ranch_assistant/tests -v
|
||||
python -B -m unittest ranch_assistant.tests.test_progression -v
|
||||
python -B -m unittest ranch_assistant.tests.test_battle_simulator -v
|
||||
```
|
||||
|
||||
上述命令仅复查指定模块;724项通过的统计来自56个模块隔离回归,不是这两个模块或同进程整套测试的结果。
|
||||
|
||||
原始 APK、构建包、第三方工具、签名材料、账号会话、
|
||||
密码、数据库、截图和运行日志均由 `.gitignore` 排除;账户数据仍保存在本机。
|
||||
|
||||
@@ -100,17 +111,17 @@ python -B -m unittest discover -s ranch_assistant/tests -v
|
||||
|
||||
| 辅助版本 | 《牧羊人之心》Android 客户端版本 | 状态 |
|
||||
| --- | --- | --- |
|
||||
| 1.2.0.dev1(开发分支 `develop/v1.2.0`) | 1.9.68 静态资料基线 | 开发中;任务与战斗调度已实现,运行时覆盖、实际阵容桥接及完整集成 QA 待完成;未发布正式标签 |
|
||||
| 1.1.1(`v1.1.1`) | 1.9.68 | 当前正式版本,1.1系列修复与界面更新 |
|
||||
| 1.2.0(`v1.2.0`) | 1.9.68 | 当前版本;功能、模型及验收限制见上文 |
|
||||
| 1.1.1(`v1.1.1`) | 1.9.68 | 历史正式版本,1.1系列修复与界面更新 |
|
||||
| 1.1.0(`v1.1.0`) | 1.9.68 | 已发布版本 |
|
||||
| 1.0.0(`v1.0.0`) | 1.9.68 | 已发布版本 |
|
||||
|
||||
本表仅记录已经分析、测试的版本对应关系,不代表对其他客户端版本的兼容承诺。
|
||||
|
||||
## v1.2 开发进展
|
||||
## v1.2 实现与研究记录
|
||||
|
||||
[实施与阶段交接](analysis/V1_2_IMPLEMENTATION.md)汇总当前能力、测试证据与后续验收;[方案与阶段状态](analysis/V1_2_PLAN.md)保留客户端调用链研究和实施标准。
|
||||
早期[离线普攻估算工具](analysis/V1_2_OFFLINE_EXPERIMENT.md)、[原 AIR 运行实验](analysis/V1_2_RUNTIME_IMPLEMENTATION.md)和[独立实验模型](analysis/V1_2_SIMULATION_IMPLEMENTATION.md)是三条不同路径,覆盖范围分别记录。本轮真实账号的任务、开战、结算及领奖验证由用户手动进行。
|
||||
[实施与阶段交接](analysis/V1_2_IMPLEMENTATION.md)与[方案与阶段状态](analysis/V1_2_PLAN.md)保留开发阶段的能力、测试证据和客户端调用链研究;其中版本状态与运行时方案是历史记录,正式版当前范围以本页、[使用说明](ranch_assistant/README.md)和[验收清单](analysis/V1_2_ACCEPTANCE_CHECKLIST.md)为准。
|
||||
早期[离线普攻估算工具](analysis/V1_2_OFFLINE_EXPERIMENT.md)、[原 AIR 运行实验](analysis/V1_2_RUNTIME_IMPLEMENTATION.md)和[独立实验模型](analysis/V1_2_SIMULATION_IMPLEMENTATION.md)覆盖范围分别记录;原 AIR 仅用于离线研究,不是桌面可选运行时。本轮未执行真实游戏 API 验收,联网结果仍需用户实测记录。
|
||||
|
||||
## 免责声明
|
||||
|
||||
|
||||
@@ -0,0 +1,37 @@
|
||||
# v1.2.0
|
||||
|
||||
牧羊人之心Bot 1.2.0 正式版,原生 PySide6 桌面辅助,适配资料基线为 Android **1.9.68**。
|
||||
|
||||
## 主要更新(相对 1.1.1)
|
||||
|
||||
- 主线默认展示当前任务,支持类别、状态和关键词组合筛选;推进已支持的任务链,并按已知地图来源收集材料、蛋及击杀目标。
|
||||
- 委托按氪金奖励 **20→15→10** 选择可处理任务,独立运行并优先处理委托步骤和材料收集。
|
||||
- 内置近似战斗模型:**我方对敌最终伤害10倍、单次最高50000**,敌方伤害与角色属性不乘倍;支持能力范围内的未满星普通关挑战及需另行启用的矿洞/门票关,检查体力、工具库存与保留量。
|
||||
- 完善跨牧场保留数量、同种更高资质保留、喂养优先级与潜能突破定位;顶部策略开启后自动领取已完成探险奖励,再次出发独立配置、默认关闭。
|
||||
- 默认合计扫荡与奖励事件,展示来源拆分、事件独有奖励、实测掉落率及体力效率;完善独立停止、中断恢复、账号/角色隔离和地图缓存复用。
|
||||
|
||||
## 已知限制
|
||||
|
||||
- 按委托缺口自动买蛋、孵化再交付的完整联动尚未完成。
|
||||
- 特殊脚本、技能、触发器与场地未全支持;模型存在近似,不能据此保证全部关卡通关或服务器接受结算。原 AIR 仅作离线研究,不是桌面可选运行时。
|
||||
- 战斗记录仍可能显示任务/关卡编号或内部结果 `local`。已发出但结果不明的写请求只核对状态,不自动重发。
|
||||
|
||||
## 验证范围
|
||||
|
||||
- **功能基线**:此前56个模块逐模块独立进程测试,共 **724项通过、0项跳过**。单进程整套 Qt 测试曾崩溃,此结果不代表同进程全部成功。
|
||||
- **发布验证**:本次版本号发布 **14项定向测试及旧 dev1 配置兼容验证通过**;版本常量及导出断言已更新为1.2.0,旧 `1.2.0.dev1` 的 schema 1/2 配置导入兼容已验证。**两组有重叠,不相加**。
|
||||
|
||||
**本轮未调用真实游戏 API**,任务、开战、结算、领奖及资源消耗的联网验收仍未完成,不代表服务器全通关或用户全部验收。
|
||||
|
||||
## 源码运行
|
||||
|
||||
下载并解压本 Release 的源码,在 Windows 安装 Python 3 后,于项目根目录执行:
|
||||
|
||||
```console
|
||||
python -m pip install -r ranch_assistant/requirements.txt
|
||||
python -m ranch_assistant
|
||||
```
|
||||
|
||||
也可安装依赖后双击 `Start_Ranch_Helper.cmd`。启动后先查看数据与配置,再用顶部“开启 / 停止”控制策略;重启、恢复会话或导入配置后需手动开启。
|
||||
|
||||
详细配置与实测项目见源码中的 `README.md`、`ranch_assistant/README.md` 和 `analysis/V1_2_ACCEPTANCE_CHECKLIST.md`。本次仅提供源码,不附 APK、账号数据或密钥文件。
|
||||
@@ -1,9 +1,9 @@
|
||||
# v1.2 当前开发版功能总结与实测验收清单
|
||||
# v1.2.0 功能总结与实测验收清单
|
||||
|
||||
## 范围与使用方式
|
||||
|
||||
- 验收对象:`develop/v1.2.0` 当前开发代码,包含 `5082c2d` 矿洞更新及后续任务筛选、界面与战斗规则调整,版本 **1.2.0.dev1**;游戏资料基线为 Android **1.9.68**。比较基线为 `v1.1.1`,本清单只列这一区间的变化,不把既有登录、背包等历史功能算作新增。
|
||||
- 当前是**开发版**,不是正式版 1.2;本次不合并 `main`,不新增功能。以下“已实现”仅表示 HEAD 已有对应代码或界面,所有真实游戏闭环仍以用户实测为准。
|
||||
- 验收对象:**1.2.0 正式版(`v1.2.0`)**,功能代码基线为 `develop/v1.2.0` 的 `6d74730`,包含矿洞、任务筛选、探险领奖、界面与战斗规则调整;正式版版本常量及导出断言已更新为1.2.0。游戏资料基线为 Android **1.9.68**。比较基线为 `v1.1.1`,本清单只列这一区间的变化,不把既有登录、背包等历史功能算作新增。
|
||||
- 本清单记录正式版的功能范围及待实测项目。以下“已实现”仅表示发布代码已有对应逻辑或界面,不代表服务器通关或用户全部验收;本轮未调用真实游戏 API,所有真实游戏闭环仍以用户实测为准。发布摘要见[Release 说明](RELEASE_1_2_0.md)。
|
||||
- 桌面 GUI 已隐藏运行时选择,读取及加载策略时均强制使用 `experimental` 内置实验模拟。原 AIR 研究工具不属于当前桌面自动战斗的可选模式。
|
||||
- 每条 `[ ]` 仅表示“待逐项核对”,不是预先判定通过。测试后在文末记录“通过 / 失败 / 未测”;受阻或不支持应按实际表现记录,不能为了让条目通过而绕过限制。
|
||||
- 建议先用离线演示熟悉入口,再用可接受资源消耗的测试角色少量验证。记录只使用“账号 A / B”等别名;不要粘贴账号、密码、会话、设备标识、本机路径或私有日志。
|
||||
@@ -84,12 +84,13 @@
|
||||
- **特殊剧情及战斗机制覆盖不全**:特殊选择等脚本、部分接取入口、特殊抽蛋钩子以及未实现技能、触发器和场地机制仍可能受阻;资料数量或结构准入不等于通关率。
|
||||
- **实验模型存在近似**:桌面模拟按我方对敌最终伤害10倍、单次最高50000计算,角色属性本身不乘倍;离线研究默认仍为原始1倍。移动、攻击、技能、装备、随机与时序等不能视为原版完整复现。模型胜负、计时和服务器是否接受结算均须真实游戏验收。
|
||||
- **战斗记录的人话转换未完全覆盖**:缺少名称时仍可能回退显示任务或关卡编号,内部结果 `local` 也可能直接出现;不能声称记录已全部中文化。
|
||||
- **线上验证尚未完成**:最新验证没有调用真实游戏 API,没有真实账号任务、开战、结算、领奖及资源消耗结果。本清单中的联网条目默认均为未测。
|
||||
- **本地验证的范围**:本轮 **56 个模块隔离测试,共 724 项通过、0 项跳过**。单进程运行整套 Qt 测试曾出现崩溃,因此本轮采用逐模块独立进程验证,不将隔离回归结果解释为线上验收通过。
|
||||
- **线上验证尚未完成**:本轮没有调用真实游戏 API,没有真实账号任务、开战、结算、领奖及资源消耗结果。本清单中的联网条目默认均为未测,正式版状态不改变这一事实。
|
||||
- **功能基线验证**:此前 **56 个模块隔离测试,共 724 项通过、0 项跳过**。单进程运行整套 Qt 测试曾出现崩溃,因此采用逐模块独立进程验证,不能表述为同进程全部成功,也不将隔离回归结果解释为线上验收通过。
|
||||
- **发布定向验证**:本次版本号发布 **14 项定向测试及旧 dev1 配置兼容验证通过**,版本常量及导出断言已更新为1.2.0;旧 `1.2.0.dev1` 的 schema 1/2 配置导入兼容已验证。这组发布验证与上述功能基线分别记录,**两组有重叠,不相加**,均不代表真实游戏 API 验收完成。
|
||||
|
||||
## 实测结果记录模板
|
||||
|
||||
测试对象:版本 `1.2.0.dev1` / 提交号:____;账号别名:____;测试日期:____。
|
||||
测试对象:版本 `1.2.0`(`v1.2.0`)/ 实测提交号:____;账号别名:____;测试日期:____。功能代码基线为 `6d74730`,实测时填写实际检出的提交号。
|
||||
|
||||
| 功能(编号与名称) | 结果(通过 / 失败 / 未测) | 前置条件与预期 | 复现步骤 | 实际结果(脱敏) |
|
||||
| --- | --- | --- | --- | --- |
|
||||
|
||||
+26
-12
@@ -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)。
|
||||
|
||||
## 刷新响应与批量喂养
|
||||
|
||||
@@ -38,7 +38,7 @@ from .drop_statistics import SweepStatistics
|
||||
from .statistics_gui import StatisticsPage
|
||||
from .exploration_gui import ExplorationPages, prepare_exploration_rows, prepare_exploration_members
|
||||
|
||||
APP_VERSION = "1.2.0.dev1"
|
||||
APP_VERSION = "1.2.0"
|
||||
GAME_VERSION = "1.9.68"
|
||||
|
||||
ROOT = Path(sys.executable).parent if getattr(sys, "frozen", False) else Path(__file__).resolve().parent.parent
|
||||
|
||||
@@ -66,7 +66,7 @@ def portable_policy(policy, snapshot=None):
|
||||
for key, priority in sorted(value.pop(field).items(), key=lambda pair: pair[1]):
|
||||
mon = snapshot.monsters.get(int(key)) if snapshot else None
|
||||
targets[kind].append({"typeId": str(mon.get("typeId")) if mon else "", "priority": priority})
|
||||
return {"format": FORMAT, "schema": VERSION, "assistantVersion": "1.2.0.dev1", "gameVersion": "1.9.68",
|
||||
return {"format": FORMAT, "schema": VERSION, "assistantVersion": "1.2.0", "gameVersion": "1.9.68",
|
||||
"policy": value, "targetSpecies": targets}
|
||||
|
||||
|
||||
|
||||
@@ -55,7 +55,7 @@ class ProgressionPolicyIOTests(unittest.TestCase):
|
||||
source = {"progression_policy": asdict(policy), "token": "test-secret", "account": "private-account",
|
||||
"progression_records": RECORDS, "progression_rows": TASKS, "runtime_path": "private-runtime"}
|
||||
exported = portable_config(source)
|
||||
self.assertEqual(exported["assistantVersion"], "1.2.0.dev1")
|
||||
self.assertEqual(exported["assistantVersion"], "1.2.0")
|
||||
self.assertEqual(import_config(exported)["progression_policy"], asdict(policy))
|
||||
text = json.dumps(exported)
|
||||
for secret in ("test-secret", "private-account", "private-runtime", "progression_records", "progression_rows"):
|
||||
|
||||
Reference in New Issue
Block a user