Add v1.2 development quest progression and experimental battle runtime
This commit is contained in:
@@ -1,7 +1,7 @@
|
||||
# 牧羊人之心Bot
|
||||
|
||||
原生 PySide6 桌面辅助,当前版本 **1.1.1**,适配《牧羊人之心》Android **1.9.68**。
|
||||
支持多账号独立运行、牧场培养、每日事务、自动扫荡及本地掉落分析。
|
||||
原生 PySide6 桌面辅助,当前开发版本 **1.2.0.dev1**,适配资料基线为《牧羊人之心》Android **1.9.68**;最近正式版本为 **1.1.1**。
|
||||
支持多账号独立运行、牧场培养、每日事务、自动扫荡及本地掉落分析;v1.2 新增任务、对话与战斗调度,完整集成验证仍在进行。
|
||||
|
||||
## 运行指引
|
||||
|
||||
@@ -16,7 +16,7 @@
|
||||
|
||||
## 当前功能
|
||||
|
||||
| 模块 | 1.1.1 已具备的功能 |
|
||||
| 模块 | 1.2.0.dev1 当前实现(战斗能力范围见下文) |
|
||||
| --- | --- |
|
||||
| 登录与多账号 | 第一弹渠道账号密码登录,选择官方返回的区服及角色;账号密码与会话在本机加密保存,支持恢复会话、多账号独立运行、退出登录及清除登录记录。关闭账号页签后重启不会重新打开,也可彻底移除该账号的本地记录。 |
|
||||
| 状态刷新与策略开关 | 登录后自动刷新角色、培育室、背包及牧场状态;每个账号只有一个“开启 / 停止”开关,菜单支持批量控制。关闭策略后仍同步状态和到期成长;手动刷新不触发消耗类自动操作。 |
|
||||
@@ -28,14 +28,27 @@
|
||||
| 资质保留与经验喂养 | 支持星级、综合资质、四项全S(4S)保护,另可保留资质严格高于牧场同种培养代表的新魔物。经验喂养按目标优先级批量提交素材,遵守当前突破上限与停止等级,保护锁定、在队和委托所需魔物。 |
|
||||
| 自动赠礼与好感培养 | 在背包选择物品、牧场选择目标后自动赠礼;跳过冷却目标,连续处理其他可送目标,在本地倒计时并到期核对状态。支持喜欢物品筛选、库存保留及当前好感上限。可在本地自动为每种魔物选择唯一培养代表,依次按等级、好感、成长资质比较,完全相同时随机选定并记住。 |
|
||||
| 每日事务 | 查看并领取每日签到礼包、七日签到、累计奖励、已有VIP日奖和邮件附件;支持手动领取及按勾选项目自动领取。 |
|
||||
| 自动委托 | 根据每日剩余次数、城市与库存接取委托,推进已满足条件的步骤并领奖;显示金币和氪金奖励,金币、道具及魔物提交可分别限制。需要实战的步骤等待用户在游戏内完成。 |
|
||||
| 自动主线 | 展示主线、支线、委托的状态、位置、NPC、需求、对话和阻塞原因;推进已支持的接取、线性对话、交付、领奖与任务补链。材料、蛋或击杀不足时,按已知来源规划普通地图收集;开图受前置、资源和战斗能力限制。 |
|
||||
| 自动委托 | 根据每日剩余次数、城市与库存接取委托,推进已支持的步骤并领奖;显示金币和氪金奖励,金币、道具及魔物提交可分别限制。实战委托已接入任务战斗调度,须开启对应选项并通过所选模式的能力检查;设置仍在“自动委托”。 |
|
||||
| 战斗模式与记录 | “自动主线 → 推进策略”显式选择原版运行时(默认)或实验模拟(近似);按普通地图、任务专属战斗、任务通关战斗分别编排。记录胜负、模式、地图奖励事件和待核对原因,支持停止与中断恢复;局部能力不代表全部关卡可用。 |
|
||||
| 自动扫荡 | 按地区折叠显示关卡、难度、通关星级及可能掉落;账号地图首次读取后本地缓存,仅手动刷新关卡时重新获取。逐关勾选、选择已解锁难度和本日次数上限,配置保留体力与战队;处理普通扫荡及探索奖励事件,记录实际奖励。 |
|
||||
| 掉落数据分析 | 按账号、关卡与难度在本地保存扫荡记录,分别统计普通扫荡、奖励事件或合计;展示样本数、出现次数、总数量、实测掉落率、平均数量和95%区间。支持掉落率/每点体力获得数量的条形图,不额外请求游戏服务器。 |
|
||||
| 收益资料与执行计划 | 内置749种魔物的培育时间、派遣金币、强化经验及每小时收益,支持名称/星级筛选和CSV/XLSX覆盖;执行计划显示下一步操作与等待原因。 |
|
||||
| 统一策略配置 | 规则修改后自动保存并应用;通过原生菜单保存、导入或导出当前账号的孵蛋、牧场、喂养、赠礼、委托、每日事务、扫荡、刷新间隔及自定义收益资料。跨账号按魔物种类匹配培养目标,导出文件不包含账号凭据。 |
|
||||
| 统一策略配置 | 规则修改后自动保存并应用;通过原生菜单保存、导入或导出当前账号的孵蛋、牧场、喂养、赠礼、委托、每日事务、扫荡、主线推进、战斗模式、刷新间隔及自定义收益资料。跨账号按魔物种类匹配培养目标,导出文件不包含账号凭据或服务器进度。 |
|
||||
| 界面与调试 | 原生Qt菜单、可调整和隐藏的日志区、各页右键刷新;数字与勾选项可排序,数字框获得焦点后才响应滚轮,下拉框按内容扩宽。独立调试窗口查看请求、响应、耗时与错误,支持复制、导出和本地脱敏日志。 |
|
||||
| 后台处理与离线演示 | 各账号后台线程独立处理网络与资料,单账号请求串行;只渲染当前查看页面,大列表分批更新并复用控件。支持随机30秒、60秒、2分钟或5分钟上限的刷新间隔,以及无需连接服务器的离线演示。 |
|
||||
|
||||
## 1.2 开发版使用要点
|
||||
|
||||
在“自动主线 → 任务状态”点击“刷新任务 / 预览”,查看下一步和阻塞原因;到“推进策略”选择任务范围、推进战斗队伍、保留体力和交付限制,再勾选“启用自动主线策略”,用顶部绿色“开启”运行、红色“停止”暂停。规则自动保存,重启、恢复会话或导入配置后仍需手动开启。委托接取、交付和“也接取需要实战的委托”继续在“自动委托”配置。
|
||||
|
||||
- **原版运行时(默认)**:原 AIR 引擎已通过原始战斗面板自然完成合成阵容的 1-1 离线实验,读取实际战场统计与检查结果,样例 `cheatNum=0`。任意实际阵容的输入桥接仍在完善,当前能力检查会阻止尚未验证的开战;该样例不代表全部原版战斗可用。
|
||||
- **实验模拟(需显式选择)**:使用原始数值资料,在独立进程中计算 AP、出场、移动、攻击和部分技能,记录实际模型轨迹。它包含机制近似与遗漏,可能和原版胜负不同;完整集成 QA、原引擎对拍及真实账号验证尚未完成。
|
||||
- **地图与扫荡**:普通地图可能直接发放探索奖励,此时记录为奖励事件;进入战斗的分支才调用所选运行时。扫荡仍要求普通关卡三个难度全部通关。任务专属战斗和任务通关目标按任务路线处理,击杀缺口不靠扫荡计数。
|
||||
- **中断恢复**:请求结果不明、开战后停止或运行超时时,保留本账号的待核对记录,暂停冲突操作。恢复后先刷新角色与任务;仅在新状态足以确认结果时继续,不重放未知写请求。
|
||||
|
||||
详细设置、能力限制与恢复方法见[辅助使用说明](ranch_assistant/README.md#v12-自动主线与战斗设置);阶段证据及待验收事项见[v1.2 实施与交接](analysis/V1_2_IMPLEMENTATION.md)。当前仍为开发版,尚未发布 v1.2 正式标签。
|
||||
|
||||
## 1.1.1 更新内容
|
||||
|
||||
- 顶部策略按钮改为绿色“开启”和红色“停止”,运行状态更醒目。
|
||||
@@ -55,14 +68,14 @@
|
||||
## 功能范围与数据
|
||||
|
||||
当前登录适配第一弹渠道;需要短信验证的登录流程尚未提供验证码界面。
|
||||
自动扫荡仅用于已满足游戏原有条件的普通关卡,首次通关、特殊关卡及委托战斗仍需在游戏内手动完成;不再提供手机截图配置或ADB自动战斗。
|
||||
自动扫荡仅用于已满足游戏原有条件的普通关卡;v1.2 的首次挑战、任务及委托战斗受所选运行时能力检查限制,未支持内容显示原因并等待处理。当前不提供手机截图配置或ADB自动战斗。
|
||||
|
||||
地图与可能掉落来自客户端静态配置,实际奖励以服务器响应为准;统计概率为本账号已确认样本的实测值。
|
||||
“每点体力数量”按已知消耗样本的物品总量除以实际扣除体力计算,未知消耗不参与。
|
||||
资料包含1178个关卡和2079种道具名称;客户端或接口更新后可能需要重新适配。
|
||||
资料包含1178个关卡和2079种道具名称;v1.2 的独立任务资料另含1165个任务、337个NPC和4269份剧情脚本,其中4239份属于已支持的线性类别,主线引用的720份中有718份属于该类别。脚本分类数量不代表任务或战斗全部通过;30份特殊选择等脚本、4类特殊接取入口及任务1001006的抽蛋钩子仍不支持。客户端热更新与当前账号资源是否一致尚未验证。
|
||||
|
||||
账号凭据、策略、地图缓存、购蛋/扫荡记录及统计数据库均保存在本机 `local_state/ranch_helper/`,按账号和角色隔离。
|
||||
当前代码通过 **209项本地测试**,覆盖会话隔离、策略开关、培养流程、奖励处理、统计与界面响应;测试使用模拟数据和模拟服务,不代表所有功能均已通过真实账号验证。
|
||||
v1.2 常规回归检查497项,493项首轮通过,4项旧界面测试补齐异步等待后复测通过;14项原AIR长时间试跑不纳入常规回归。原版适配器最终集成仍待完成,自动原版开战准入保持关闭。各组准确数量及验证条件见[实施验证记录](analysis/V1_2_IMPLEMENTATION.md#验证记录)。本地模拟结果不代表真实账号通关、服务器接受结算或全部关卡支持。本轮开发验证未执行真实游戏请求,真实账号联网验收由用户手动进行;软件在用户开启策略后,可按配置和能力检查自动执行已支持操作。
|
||||
详细配置与实现范围见[辅助使用说明](ranch_assistant/README.md)。
|
||||
|
||||
## 项目目录与测试
|
||||
@@ -85,16 +98,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.1.0(`v1.1.0`) | 1.9.68 | 已发布版本 |
|
||||
| 1.0.0(`v1.0.0`) | 1.9.68 | 已发布版本 |
|
||||
|
||||
本表仅记录已经分析、测试的版本对应关系,不代表对其他客户端版本的兼容承诺。
|
||||
|
||||
## v1.2 预研
|
||||
## v1.2 开发进展
|
||||
|
||||
[主线任务、普通挑战与战斗委托方案](analysis/V1_2_PLAN.md)包含已核对的客户端调用链、完整资料恢复结果、战斗引擎路线和分阶段验收标准。
|
||||
已增加[离线普攻估算与实机样本对比工具](analysis/V1_2_OFFLINE_EXPERIMENT.md),可在本地计算有限机制下的胜负和耗时分布。忠实执行原始规则的独立战斗引擎尚未跑通;预研中的真实账号联网操作由用户手动执行。
|
||||
[实施与阶段交接](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)是三条不同路径,覆盖范围分别记录。本轮真实账号的任务、开战、结算及领奖验证由用户手动进行。
|
||||
|
||||
## 免责声明
|
||||
|
||||
|
||||
Reference in New Issue
Block a user