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
+37
View File
@@ -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、账号数据或密钥文件。
+7 -6
View File
@@ -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`,实测时填写实际检出的提交号。
| 功能(编号与名称) | 结果(通过 / 失败 / 未测) | 前置条件与预期 | 复现步骤 | 实际结果(脱敏) |
| --- | --- | --- | --- | --- |