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 验收,联网结果仍需用户实测记录。
|
||||
|
||||
## 免责声明
|
||||
|
||||
|
||||
Reference in New Issue
Block a user