Research v1.2 task progression and faithful offline battle execution

This commit is contained in:
AttilaNet
2026-11-08 15:46:59 +08:00
parent 014b497508
commit 45a7f2dfa4
5 changed files with 591 additions and 0 deletions
+5
View File
@@ -91,6 +91,11 @@ python -B -m unittest discover -s ranch_assistant/tests -v
本表仅记录已经分析、测试的版本对应关系,不代表对其他客户端版本的兼容承诺。 本表仅记录已经分析、测试的版本对应关系,不代表对其他客户端版本的兼容承诺。
## v1.2 预研
[主线任务、普通挑战与战斗委托方案](analysis/V1_2_PLAN.md)包含已核对的客户端调用链、完整资料恢复结果、战斗引擎路线和分阶段验收标准。
当前为预研资料,独立战斗引擎尚未跑通;离线实验直接推进,预研中的真实账号联网操作由用户手动执行。
## 免责声明 ## 免责声明
本项目及其文档仅用于编程学习、技术研究与交流,不构成任何使用建议、服务承诺或法律依据。项目不提供、不指导也不协助制作、传播或使用游戏修改包、外挂、绕过安全检测、规避反作弊或其他破坏性工具;请勿将本项目用于上述用途。 本项目及其文档仅用于编程学习、技术研究与交流,不构成任何使用建议、服务承诺或法律依据。项目不提供、不指导也不协助制作、传播或使用游戏修改包、外挂、绕过安全检测、规避反作弊或其他破坏性工具;请勿将本项目用于上述用途。
+219
View File
@@ -0,0 +1,219 @@
{
"artifact": "牧羊人之心_1.9.68.apk",
"apk_bytes": 1700248417,
"binaries": {
"assets/MYRMain.app": {
"bytes": 4196806,
"swf_signature": "FWS",
"swf_version": 50,
"sha256": "c6838331a198a22ffa486cbf61cc74c97619e011bc3364c8bb8dc99e269036cf"
},
"assets/MYRDyd.swf": {
"bytes": 367556,
"swf_signature": "FWS",
"swf_version": 46,
"sha256": "4728d0e23bdf0d6b1468e8cd39f97535e65a09bfa40044e7c73af7e1655af741"
}
},
"tables": {
"stage_info": {
"logical_path": "data/table/stage_info.json",
"member": "assets/codes/9484cfff9fb912e4791832375e771475",
"compressed_bytes": 1061791,
"decoded_bytes": 19703775,
"sha256": "47ccef41d460f4ef23732624cf302e863a22ca33148dc02629841d764c38b487",
"record_count": 1178
},
"task_info": {
"logical_path": "data/table/task_info.json",
"member": "assets/codes/70d0e869536fc2b968582dd1f1ea86d6",
"compressed_bytes": 271024,
"decoded_bytes": 1622428,
"sha256": "b833985c54e11f3079a3ccc53709f87d25b1f8301699b3eb99613a826a469744",
"record_count": 1165
},
"monster_info": {
"logical_path": "data/table/monster_info.json",
"member": "assets/codes/08b83182d2a7882bfe2bb0ed710d343f",
"compressed_bytes": 219398,
"decoded_bytes": 933486,
"sha256": "081747ddc5b7afba03f69e65f5eba6af815b9fbd3ea7e0821c7f8807d9486921",
"record_count": 749
},
"monster_skill": {
"logical_path": "data/table/monster_skill.json",
"member": "assets/codes/8da7ff8cb5aeb85080ac37ca677f52ef",
"compressed_bytes": 50349,
"decoded_bytes": 236294,
"sha256": "0fea0eb8553a4868ff704210e9adfd09c6e2b2c3b2730e9ebe25642fa478bf9b",
"record_count": 266
},
"monster_setting": {
"logical_path": "data/table/monster_setting.json",
"member": "assets/codes/1d188dbf8ca7a253fb2e5bc2475b2669",
"compressed_bytes": 6687,
"decoded_bytes": 22488,
"sha256": "49388d221e3d4461fede3b176526d593ec0f1647a8b93a8d2b33a712761febab",
"record_count": 11
},
"setting": {
"logical_path": "data/table/setting.json",
"member": "assets/codes/82885f1c0190a591b6aaee2521bf3daa",
"compressed_bytes": 14422,
"decoded_bytes": 47740,
"sha256": "68bb8d2ee882a1c14b98315eb61dfb3545dc633173b53409b1dec3af68fb7af3",
"record_count": 64
},
"game_setting": {
"logical_path": "data/table/game_setting.json",
"member": "assets/codes/f1c2e2603d6c82bbb8b5f94585273208",
"compressed_bytes": 3559,
"decoded_bytes": 5820,
"sha256": "8810981688414e3cef520976911d16e2847df0a435dccd792e2dd527695283e3",
"record_count": 141
},
"item_info": {
"logical_path": "data/table/item_info.json",
"member": "assets/codes/1cabfff17cd6d6a38368b9068204329d",
"compressed_bytes": 132384,
"decoded_bytes": 494454,
"sha256": "9beeab37d107b09d02c4491a052594390c874c92328f524752080f5a7fab21e2",
"record_count": 2079
},
"entangle_info": {
"logical_path": "data/table/entangle_info.json",
"member": "assets/codes/e814d801e619000ae8af8f08fcbdc5b8",
"compressed_bytes": 1040,
"decoded_bytes": 1820,
"sha256": "9be02321151385379b0992053a41f2df6e911d6e3a9474701c118faad386e8b0",
"record_count": 8
},
"potential_info": {
"logical_path": "data/table/potential_info.json",
"member": "assets/codes/f4b5363a0460df23903e7f605c50f82e",
"compressed_bytes": 992,
"decoded_bytes": 1913,
"sha256": "cf43bde8204ed1e13c555cfc48df5a54ea7f2df7813e017a04ba02f0453d7895",
"record_count": 13
},
"team_info": {
"logical_path": "data/table/team_info.json",
"member": "assets/codes/26e7c61bf20be81add4b8335bf8623ed",
"compressed_bytes": 1961,
"decoded_bytes": 4416,
"sha256": "21254655b6966ab67d5b3f1105568ab6ed13e2eecc4f05d27ef016de0e34ced2",
"record_count": 10
}
},
"battle_coverage": {
"stage_level_count": 3534,
"stage_battle_object_count": 3534,
"stage_nonempty_battle_count": 2512,
"task_battle_object_count": 3462,
"task_nonempty_battle_count": 199,
"controller_types": {
"monMaker": 583,
"buff": 233,
"monBuff": 18
},
"trigger_types": {
"waveStart": 16,
"monDead": 2057,
"time": 430,
"useSkill": 6,
"none": 9
},
"win_types": {
"1": 2527,
"2": 94,
"4": 135,
"3": 34
},
"lose_types": {
"1": 2611,
"2": 2622,
"3": 44,
"4": 73
}
},
"task_types": {
"3": 431,
"2": 138,
"4": 83,
"1": 176,
"5": 336,
"6": 1
},
"task_update_mode": {
"legacy_flag_present": false,
"legacy_flag": null,
"selected_by_retained_client": "new"
},
"retained_sources": {
"all_as_files": 1284,
"battle_source_counts": {
"net/pixvi/myr/battle": 21,
"net/pixvi/myr/view/skill": 264,
"net/pixvi/myr/view/attack": 218,
"net/pixvi/myr/element/battle": 41
},
"battle_framework_imports_without_retained_source": [
"net.pixvi.common.center.PopCenter",
"net.pixvi.common.center.SoundCenter",
"net.pixvi.common.center.TipCenter",
"net.pixvi.common.control.Key",
"net.pixvi.common.driver.SecondDriver",
"net.pixvi.common.driver.StageDriver",
"net.pixvi.common.driver.TipDriver",
"net.pixvi.common.effect.effects.FlashEffect",
"net.pixvi.common.effect.effects.ShakeEffect",
"net.pixvi.common.pool.BasePool",
"net.pixvi.common.system.language.lang",
"net.pixvi.common.utils.Alert",
"net.pixvi.common.utils.Cooldowner",
"net.pixvi.common.utils.Engine2D",
"net.pixvi.common.utils.Gesturer",
"net.pixvi.common.utils.PiFixVo",
"net.pixvi.common.utils.StageLocator",
"net.pixvi.common.view.FF",
"net.pixvi.common.view.font.BitNumber",
"net.pixvi.pfw.display.BitFactory",
"net.pixvi.pfw.display.BitMovieClip",
"net.pixvi.pfw.display.BitSprite",
"net.pixvi.pfw.display.NetBitImg",
"net.pixvi.pfw.display.PiSprite",
"net.pixvi.pfw.driver.EnterFrameDriver",
"net.pixvi.pfw.event.MobiEvent",
"net.pixvi.pfw.event.PiEvent",
"net.pixvi.pfw.interfaces.IDispose",
"net.pixvi.pfw.ui.UIComponent",
"net.pixvi.pfw.ui.containers.PiImgContainer",
"net.pixvi.pfw.ui.controls.PiBar",
"net.pixvi.pfw.ui.controls.PiBitTextField",
"net.pixvi.pfw.ui.controls.PiDataList",
"net.pixvi.pfw.ui.controls.PiListItem",
"net.pixvi.pfw.utils.Angler",
"net.pixvi.pfw.utils.ArrayUtil",
"net.pixvi.pfw.utils.Caller",
"net.pixvi.pfw.utils.Colorator",
"net.pixvi.pfw.utils.Director",
"net.pixvi.pfw.utils.Jumper",
"net.pixvi.pfw.utils.Locator",
"net.pixvi.pfw.utils.Oncer",
"net.pixvi.pfw.utils.Paster",
"net.pixvi.pfw.utils.PointLocker",
"net.pixvi.pfw.utils.Pointer",
"net.pixvi.pfw.utils.Random",
"net.pixvi.pfw.utils.Saver",
"net.pixvi.pfw.utils.Sorter",
"net.pixvi.pfw.utils.broadcast.GlobalBroadcast"
]
},
"helper_catalog": {
"has_monster_skill": false,
"has_setting": false,
"task_count": 83,
"stage_levels_with_battle": 0
},
"scope": "Static table recovery and retained source inventory only; no battle executed or submitted."
}
+163
View File
@@ -0,0 +1,163 @@
# v1.2 预研:主线任务、普通挑战与战斗委托
日期:2026-11-08。基线:辅助 v1.1.1、原始 Android APK 1.9.68。
状态:已完成配置恢复和重点调用链研究,尚未运行独立战斗引擎、提交普通挑战或验证服务器接受结果。
实验安排:按用户本轮授权,离线解析、运行壳和战斗实验直接推进,无需再次确认。预研中的真实账号接任务、开战、结算与领奖由用户手动操作;本轮不自动进行联网游戏实验。
## 可行性结论
**有技术可行性,但需要恢复一个能够执行原始规则的战斗引擎。任务接取接口不是主要难点。**
手机可以不启动游戏;电脑辅助仍需登录并与服务器通信。电脑侧可以负责选择任务、准备阵容、运行战斗、提交实际结果、核对任务进度,再继续下一步。
战斗必须能够自然得到胜利、失败或超时;强度不够时应停下或等待培养。按原始规则运行不代表任何阵容都能推过主线。
本次确认了客户端会在本地创建战场、执行AI与技能,再从战场状态生成结算数据。
但源码只能说明客户端行为,不能证明服务器不做额外校验,也不能证明一个尚未实现的替代引擎会被服务器接受。
这是后续联调需要验证的条件,不能用扫荡的简化数据代替普通挑战数据。
## 本次已经确认的证据
| 证据 | 观察结果 | 来源 |
| --- | --- | --- |
| 原始APK身份 | SHA-256为 `01678ee3a8465d818d32cbbd94baa0d8253b04b4c57b70ebc5544ed341f1015d`,与原始分析对象一致;未使用伤害修改包 | REA `open_binary` 与本次静态归档检查 |
| 主程序 | `assets/MYRMain.app` 为4,196,806字节的FWS/SWF,版本字节为50,SHA-256为 `c6838331a198a22ffa486cbf61cc74c97619e011bc3364c8bb8dc99e269036cf` | [配置与文件清单](V1_2_BATTLE_INVENTORY.json) |
| 完整资料可恢复 | 1,178条关卡记录、3,534条难度记录,其中2,512个非空战斗字典;1,165条任务、199个非空任务步骤战斗字典、749种魔物、266组技能配置 | 从原APK中解压并用AMF解析,非空字典不等同于已验证可挑战关卡 |
| 当前辅助资料不完整 | 当前目录只保留83条每日委托任务,没有完整技能表/场地表,关卡难度里的战斗字典已被提取脚本剔除 | [提取脚本](../tools/extract_ranch_catalog.py#L70)、[本次清单](V1_2_BATTLE_INVENTORY.json) |
| 战场在客户端生成 | 关卡配置构造成 `BattleVo`,加入所选玩家队伍,再创建 `BattlePanel` | [BattleCenter.as:36](as3/scripts/net/pixvi/myr/center/BattleCenter.as#L36) |
| 战斗有实际循环 | 每帧处理控制器、场地区域、触发器、AI、碰撞、子弹;另有按秒触发的逻辑 | [BattleGround.as:1718](as3/scripts/net/pixvi/myr/battle/BattleGround.as#L1718)、[1844](as3/scripts/net/pixvi/myr/battle/BattleGround.as#L1844) |
| 胜负不只有消灭敌人 | 有时间条件、我方全灭、保护/破坏目标、波次和主动撤退等判断 | [BattleGround.as:1141](as3/scripts/net/pixvi/myr/battle/BattleGround.as#L1141) |
| 结算从实际战场读取 | 剩余时间、AP、存活数量、胜负、击杀等来自战场;`BattleData`还有其他统计字段和检查记录 | [BattlePanel.as:262](as3/scripts/net/pixvi/myr/panel/battle/BattlePanel.as#L262)、[BattleData.as:9](as3/scripts/net/pixvi/myr/element/battle/BattleData.as#L9) |
完整表的统计脚本为 [research_battle_v12.py](../tools/research_battle_v12.py)。它只读取原APK、解码表格、统计源码依赖,并写入一份小型JSON清单;不导出整包、不改现有辅助资料、不连接服务器。
本次复用了保留的反编译源码,重新核对了原APK及主SWF指纹,并直接恢复完整配置;没有重新批量导出同一份AS3目录。
反编译代码是重构源码,不是厂商原始工程。当前保留源码共有1,284个AS文件;仅扫描战斗目录的框架导入,就有49个依赖未在该源码树找到,不能把它当成可以直接编译运行的完整项目。
这些依赖可能仍存在于SWF或其他包中,“源码未保留”不代表原APK缺失。
REA归档检查的父证据为 `ev_3bb779224b3b2f1754b820542d4efc08d829f6da1e1068af51519671f1184e24`,摘要证据为 `ev_3a551c70cb7d7e1757d05aae386d70c673dfa7028af196138a57100e5dc55e46`。
本次检查未报告归档完整性矛盾;归档检查不验证厂商身份、签名授权、线上兼容性或运行行为。
## 请求流程必须按战斗类型区分
| 场景 | 已发现的实际客户端路线 | 实现要求 |
| --- | --- | --- |
| 普通地图挑战 | 地图入口检查该位置是否有任务;没有时走 `stageService/stageStart`,无事件时启动本地战场;胜利后调用 `battleService/battleEnd`,再按客户端回调记录战果 | 先判断任务定位、事件与正常挑战;结算数据由引擎生成 |
| 地图位置关联任务 | 地图入口优先转入 `TaskStartPanel` | 不能直接当普通地图挑战,更不能套用扫荡 |
| 任务专属战斗 | `battleService/battleStart` 的任务分支启动;任务步骤完成时有传递 `battleData` 的路径 | 按任务当前步骤和原回调提交;不要把所有战斗都发送到 `battleEnd` |
| `passStage`任务条件 | 通过任务战斗入口启动,从 `statusValue.stage/level` 取得关卡配置,胜利走 `taskCompleteStep` 并更新关卡进度 | 不因为它引用普通地图就额外发送 `battleEnd`;与使用步骤自带配置的 `battle` 分别建模 |
| 探索奖励事件/隐藏战斗 | `stageStart` 可能返回事件;奖励事件和隐藏关卡有不同分支 | 已发奖励不重复领取;未知事件保持待处理;隐藏战场另做能力检查 |
| 失败或撤退 | 普通关卡的所读失败路线会展示失败并记录败绩,没有使用普通胜利回调中的 `finishStageBattle` | 实现各分支的真实失败路径,不能统一套胜利结算;消耗以服务器确认后的状态为准 |
主证据:[StageStartPanel.as:85](as3/scripts/net/pixvi/myr/panel/stage/StageStartPanel.as#L85)、[158](as3/scripts/net/pixvi/myr/panel/stage/StageStartPanel.as#L158)、[250](as3/scripts/net/pixvi/myr/panel/stage/StageStartPanel.as#L250),[NetStage.as:65](as3/scripts/net/pixvi/myr/net/NetStage.as#L65),[NetBattle.as:35](as3/scripts/net/pixvi/myr/net/NetBattle.as#L35),[BattlePanel.as:440](as3/scripts/net/pixvi/myr/panel/battle/BattlePanel.as#L440)。
主线、支线和委托的任务级证据另见 [V1_2_TASK_RESEARCH.md](V1_2_TASK_RESEARCH.md)。
普通任务还要区分“已解锁但未接取”和“已接取实例”。整任务领奖响应中的 `nextTasks` 可以直接带来已接取后继,`unlockTasks` 则形成待接任务;不能按编号递增猜下一任务,也不能对已接取后继重复调用 `taskReceive`。
另有客户端 `taskUpdate` 补链流程。本次原APK的完整 `setting` 表不含 `useOldNewTaskFunction`,按已读代码的 `== true` 判断会选择新补链算法;该结论只对应APK内基线,线上热更新是否改变开关尚未验证。
证据:[TaskCenter.as:76](as3/scripts/net/pixvi/myr/center/TaskCenter.as#L76)、[272](as3/scripts/net/pixvi/myr/center/TaskCenter.as#L272)、[478](as3/scripts/net/pixvi/myr/center/TaskCenter.as#L478)、[本次配置检查](V1_2_BATTLE_INVENTORY.json)。
目前只读到 `stageStart` 回调使用 `triggerEvent/stageEvent`,以及任务开始回调的成功通知;没有据此证明服务器不存在其他战斗约束或状态。
`recordBattleResult` 是客户端调用链中的记录步骤,不能单独视为“完成所有通关和奖励结算”的接口。
## 忠实战斗模拟需要恢复哪些内容
1. **完整输入。** 使用真实角色快照中的阵容、站位、等级、突破、成长、潜能、升星、装备和附加能力、好感、羁绊、技能及等级。
目前界面上的“参考属性”明确不含全部加成,不适合作为战斗输入。
客户端先通过 `TeamCenter.getBattleTeamVo` 创建队伍,再经 `MonsterCenter.getBattleMonVoByMid`、`BattleMonVo.buildByMonster/buildSpecialByMonster` 转成战斗单位。
证据:[TeamCenter.as:201](as3/scripts/net/pixvi/myr/center/TeamCenter.as#L201)、[MonsterCenter.as:374](as3/scripts/net/pixvi/myr/center/MonsterCenter.as#L374)、[BattleMonVo.as:303](as3/scripts/net/pixvi/myr/element/battle/BattleMonVo.as#L303)。
2. **完整场景。** 地图位置、区域、障碍、保护/破坏目标、敌方波次、定时增援、场地控制器、触发器、出场与AP规则。
数据含有游戏自带的关卡缩放参数时也必须照原规则使用;保持原配置并不等于忽略它们。
证据:[BattleVo.as:125](as3/scripts/net/pixvi/myr/element/battle/BattleVo.as#L125)、[BattleTrigger.as:32](as3/scripts/net/pixvi/myr/element/battle/trigger/BattleTrigger.as#L32)。
3. **完整执行时序。** 普攻不只是伤害公式:攻击动作、延迟回调、子弹运动、碰撞和技能暂停会影响实际命中时点。
不能删除动画调用后假设所有依赖它的逻辑回调仍会发生。
证据:[BattleMon.as:510](as3/scripts/net/pixvi/myr/battle/view/BattleMon.as#L510)、[526](as3/scripts/net/pixvi/myr/battle/view/BattleMon.as#L526)、[BaseSkill.as:61](as3/scripts/net/pixvi/myr/view/skill/BaseSkill.as#L61)。
4. **原有数值语义。** AS3的Number/int转换、取整、运算顺序、随机判定、冷却和事件先后需要对照验证。
代码在暴击/闪避、出生位置等处直接使用 `Math.random()`;不能假定已有一个可直接搬用的统一随机种子接口。
离线对拍要固定或记录相同随机流、操作序列与时钟,才能区分实现差异与正常随机差异。
证据:[BattleMon.as:645](as3/scripts/net/pixvi/myr/battle/view/BattleMon.as#L645)、[BattleGround.as:1352](as3/scripts/net/pixvi/myr/battle/BattleGround.as#L1352)。
5. **技能覆盖。** 技能表和数百个技能/攻击实现需要建立覆盖清单。我方、敌方、召唤物、控制器所引用的任何机制未实现,都应把该场标为不支持,不能忽略后继续结算。
证据:[SkillType.as:14](as3/scripts/net/pixvi/myr/view/skill/SkillType.as#L14)。
6. **真实输出。** 从模拟过程收集结果和统计,保留原检查与异常记录。出现异常时记录原因并停下;不通过清空记录、调整属性或改伤害使结果看起来正常。
证据:[BattlePanel.as:262](as3/scripts/net/pixvi/myr/panel/battle/BattlePanel.as#L262)、[314](as3/scripts/net/pixvi/myr/panel/battle/BattlePanel.as#L314)。
资源还必须与实际服务版本匹配。APK内配置是本次离线基线,不等同于该账号当前热更新资源。
后续建立资料包时要带版本、文件摘要和必要的热更新来源记录,避免把旧敌人/技能参数混进新版本战斗。
## 推荐的引擎路线
| 路线 | 用途与可行性 | 本次结论 |
| --- | --- | --- |
| Python按公式简单估算 | 可用于阵容强度预览;无法覆盖帧序、弹道、复杂技能和场景触发 | 不作为实际挑战的结算引擎 |
| 原始AS3/AIR战斗内核加独立运行壳 | 更适合保持原有逻辑和数值语义,也可作为其他实现的对照基准;需补依赖并切开登录、平台SDK、资源和展示入口 | 优先验证;还没有成功运行的原型 |
| 将战斗逻辑逐步移植到独立工作进程 | 能满足长期无需手机、无需完整游戏客户端的目标;需要覆盖度管理和严格对拍 | 运行壳验证后再确定范围;不可承诺一次覆盖全部技能 |
| 直接把完整游戏SWF交给替代播放器 | 依赖AIR接口、显示列表、资源和原生扩展的兼容性 | 本次不能认定可用,也不作为交付前提 |
AIR官方ADL文档支持开发期运行SWF,并提供命令行模式;但命令行模式的 `stage` 为null、没有显示列表。
本游戏战斗会直接创建UI、显示对象和计时驱动,因此 `adl -cmd` 不能据此认为可以原样启动它的战斗类。
最先验证的是离线桌面运行壳能否正确跑一场,再隔离渲染适配层;不能用“没有显示窗口”代替“时序语义完整”。
来源:[AIR Debug Launcher](https://airsdk.dev/docs/building/air-debug-launcher)。
Ruffle官方兼容性页仍将AS3语言与API兼容性分别列为未全覆盖;这也不能直接推出本游戏可运行或一定不可运行,必须做本游戏的兼容性验证。
来源:[Ruffle兼容性说明](https://ruffle.rs/compatibility)。
当前PATH可发现Java,但未发现ADL、mxmlc或FFDec命令;这只是PATH范围内的观察,不等同于整机没有安装。
本次没有安装运行时、启动完整客户端或执行独立战斗。AS3运行壳是下一阶段的工程验证项。
## v1.2 分阶段实施方案
| 阶段 | 交付物 | 验收标准 |
| --- | --- | --- |
| P0 完整资料和任务识别 | 保留全部任务、战斗、技能、场地及属性资料的独立资料包;只读主线任务列表、前置条件、当前阻塞原因 | 任务类型和地图定位与源码一致;不改现有精简catalog;本次已完成资料可恢复性的证明 |
| P1 离线引擎验证 | 一场简单关卡的独立运行壳、完整输入输出、时钟/随机/事件记录 | 无服务器连接;自然运行到胜利、失败、超时;能从正常引擎执行取得结算统计,而非手工填结果 |
| P2 有限机制覆盖 | 普攻、移动、出场/AP、少量已验证技能、地图波次与终局判断;明确支持的队伍和关卡清单 | 同输入/随机流/操作序列与原引擎对拍;比较中间状态和最终统计;未知机制明确拒绝 |
| P3 普通挑战闭环 | 单个指定普通关卡的开始、实际战斗、对应结算、状态核对及本地记录 | 真实账号联网操作由用户手动进行,首轮采用真实时钟;胜利/失败路线分别正确,奖励、体力、魔物经验和通关状态与服务器结果一致;超时不重复提交 |
| P4 主线和委托调度 | 主线接取、步骤推进、地图挑战、任务专属战斗、提交与领奖;恢复未完成步骤 | 覆盖一个包含非战斗和战斗步骤的任务链;战斗完成后再核对任务状态,不凭本地胜利预先推进 |
| P5 扩大覆盖与多账号 | 扩充技能、场景和事件覆盖;独立工作进程、配置导出、诊断与任务界面 | 大列表和战斗不阻塞Qt;角色互不串数据;遇不支持内容、实际战败或资源不足时按策略停止 |
推荐先交付P0的任务可视化和P1的离线战斗验证,再评估P2/P3的工作量。
若独立运行壳与原引擎对拍尚未通过,v1.2就不应宣称已经支持完整自动推主线。
大量特殊机制的覆盖成本只有验证具体阵容、敌人、技能与关卡后才能估算,现在给出全部完成日期没有依据。
## 程序结构与调度
```mermaid
flowchart TD
Q[读取角色与任务进度] --> P[任务规划器:前置条件与当前步骤]
P --> N[非战斗步骤:检查资源、提交或领奖]
P --> B[战斗准备:版本、阵容、关卡能力检查]
B --> S[按普通关卡或任务路线开始]
S --> E[事件分流]
E --> W[独立战斗进程:原始规则与实际操作]
W --> R[收集真实结果与统计]
R --> C[按该分支结算并核对服务器状态]
N --> Q
C --> Q
```
建议的模块边界:
- `game_data`:完整资料包、配置摘要、版本匹配与能力查询;不持有账号Token。
- `progression`:任务图、主线/委托步骤分类、地图定位、剧情触发和下一步解释。
- `battle_input`:按客户端构造完整阵容与场景,验证角色实例仍存在且可出战。
- `battle_worker`:独立进程执行AS3内核或已验证的移植内核;只接收本场输入,输出实际事件和战果,不直接调用服务器。
- `battle_orchestrator`:使用当前账号的单一API队列串行发请求,记录开始/执行/结算/核对状态。
- `battle_journal`:本地保存资料版本、输入摘要、随机/操作记录、真实结果、响应摘要与中断位置;不把Token写进可导出记录。
同账号一次只运行一场战斗。计算在独立进程中,不占用Qt线程;API请求仍由现有账号队列统一管理请求编号。
战斗期间要暂停会改变阵容/属性/材料的派遣、喂养、赠礼、装备等冲突操作;其他账号独立运行。
关卡开始、任务步骤或结算请求结果不明确时,先记录待核对并查询现状,不自动重发,也不随意重新开始同一场。
本地尝试ID用于防止本程序重复执行,不代表服务器提供幂等接口。
界面增加“自动主线”页,展示已完成/进行中/可接取/条件不足/不支持的任务和下一步;“战斗记录”展示本场队伍、胜负、耗时和阻塞原因。
仍复用顶部绿色“开启”与红色“停止”,不再增加“仅监控/执行”两套开关。
配置只包含任务范围、可用战队、保留体力、失败停止次数与是否包含委托等偏好,并纳入现有统一导入/导出;服务器通关进度不能靠配置文件设置。
## 本次预研的边界与待验证项
- 已证实:原APK身份、配置可以恢复、本地战斗核心与统计采集入口、普通地图/任务分流,以及当前辅助资料被精简的事实。
- 工程推断:完整输入、时序、技能与依赖补齐后,独立执行原始规则有可行路径;目前没有可运行战斗原型来证明覆盖和速度。
- 未验证:当前线上热更新与APK的差异、独立运行壳的兼容性、动画与时钟完整迁移、随机流复现、具体账号的所有加成是否完整可得、服务器接受真实独立战斗结果的条件。
- 范围:当前方案先覆盖已验证普通关卡和任务战斗。PVP、排行榜/BOSS及特殊活动不纳入首批交付。
- 本次没有登录真实账号、发送任务/战斗写请求、操作手机或运行修改版APK,也没有改动1.1.1的辅助执行逻辑。
下一步建议:完成“一场离线普通战斗的忠实运行与对拍”,再开展联网挑战和任务闭环。
+100
View File
@@ -0,0 +1,100 @@
**v1.2 任务与普通战斗衔接证据笔记**
研究日期:2026-11-08。范围:主线、支线、每日委托与普通关卡的任务调度边界。仅静态阅读 `analysis/as3/scripts` 中已有客户端反编译源码、`ranch_assistant/quests.py`、`ranch_assistant/data/catalog.json`。没有真实账号或服务器请求、手机操作、辅助源码修改、战果构造、检查规避、commit 或 push;本次仅写此文档。战斗数学、结果生成和运行时实现交由主代理。
证据等级:**已证实**表示在本地文件中核对到的调用、字段或分支;只能证明这份客户端源码的行为,不能证明服务端完整校验。**推断/建议**表示由这些证据得出的设计判断。**未知**表示在限定材料中无法确认。下文路径均相对仓库根目录,行号为现有文件的实际行号;catalog 只有一行,因此同时给出 JSON Pointer。
最影响设计的结论是:任务解锁、接取、步骤提交和整任务领奖必须分开;普通挑战实际从 `stageStart` 进入,任务战斗从任务 `battleStart` 进入;任务 `passStage` 也通过 `taskCompleteStep` 提交战果。点击普通关卡可能先被任务截获,成功、失败与剧情结束也不能合并成同一个完成事件。证据见 E03—E11。
先明确材料覆盖范围。
- **E01|已证实:现有 catalog 是任务子集。** `/task_info` 共 83 条,全部 `type=4`,合计 113 个步骤:`none=30`、`passStage=14`、`getItem=38`、`getMonster=12`、`battle=9`、`killMonster=10`;其中 73 步有非空 `afterStory`。这些步骤均不含 `story`、`battle`、`reward` 字段,任务条目均不含 `nextTasks`、`unlockTasks`、`unlockStages`。因此字段缺失不能解释为原客户端没有剧情、战斗配置或依赖。`/stage_task_positions` 有 980 个任务的位置序列,但不能据位置还原其条件、状态类型和前后置图。证据:`ranch_assistant/data/catalog.json:1`,JSON Pointer `/task_info`、`/stage_task_positions`。
- **E02|已证实:客户端另行加载完整任务与设置资源。** `Table.task_info` 来自资源 `task_info.datas`,`Table.setting` 与 `Table.game_setting` 是不同资源;城市配置来自后者的 `cityInfo`。现有 catalog 没有 `setting`,不能用 `game_setting` 中缺少开关来判定任务算法版本。证据:`analysis/as3/scripts/net/pixvi/myr/center/Table.as:160-161`、`:175`、`:184`。
主代理补充的外部于本子任务的盘点信息:原 APK 解码有 `task_info=1165` 条;`stage_info=1178` 关/3534 难度,2512 个非空 `battle`;任务步骤的 `battle` 字典 3462 个,其中 199 个非空。主代理说明指纹及数量保存在 `analysis/V1_2_BATTLE_INVENTORY.json`,可由 `tools/research_battle_v12.py` 重跑。**这些数量来自本轮主代理补充,本子任务未读取该产物、未重跑脚本,不将其列为已独立核实的源码行号证据,也未修改现有 catalog。** 后续完整任务图可由主代理已解码资料补充。
下面是任务状态与四个目标接口的直接证据。
- **E03|已证实:任务实例与任务类型、步骤与领奖各有独立状态。** 类型 `1/2/4` 分别为主线/支线/循环任务;服务端 `curStep` 进入客户端时减一,`stepValue` 来自任务数据。`canFinish()` 要求未标记 `complete`、步骤非空且 `step >= steps.length`;满足步骤条件不等于已经可以领取整任务奖励。证据:`analysis/as3/scripts/net/pixvi/myr/element/task/TaskType.as:6-21`;`analysis/as3/scripts/net/pixvi/myr/center/TaskCenter.as:59-68`;`analysis/as3/scripts/net/pixvi/myr/element/task/TaskVo.as:207-217`。
| 接口 | 已证实的客户端触发条件及请求字段 | 成功回调与限制 |
| --- | --- | --- |
| `taskReceive` | 普通任务接取:`TaskCenter.receiveTask` 先找到本地任务对象,再发送 `taskTypeId`。起始剧情路径要求 `isStartStep` 且 `startStepAnswer=true`;默认答案为 false,剧情事件可改变答案。证据:`analysis/as3/scripts/net/pixvi/myr/center/TaskCenter.as:576-585`;`analysis/as3/scripts/net/pixvi/myr/panel/taskstartpanel/TaskStartPanel.as:67-74`、`:158-175`、`:190-203`;`analysis/as3/scripts/net/pixvi/myr/net/NetTask.as:42-55`。 | 更新实例 `id`、`stepValue`,本地 `step=0`、`recieved=true`。剧情脚本也能以 `receiveTask` 事件触发接取,不能只监听接取按钮。证据:`analysis/as3/scripts/net/pixvi/myr/center/TaskCenter.as:588-604`;`analysis/as3/scripts/net/pixvi/myr/panel/story/StoryPanel.as:171-187`。包装函数本身没有完整前置校验。 |
| `taskCompleteStep` | 非战斗从 `TaskCenter.finishStep` 进入,按物品/魔物类型取 `removeIds`,`battleData=null`。任务战斗胜利回调另直接调用 `NetTask.finishStep`,`removeIds=null`,附实际结果的 `getObj()`。请求总有 `taskId/taskTypeId/removeIds`;只有 `battleData != null` 才加入该字段。证据:`analysis/as3/scripts/net/pixvi/myr/center/TaskCenter.as:377-401`;`analysis/as3/scripts/net/pixvi/myr/panel/taskstartpanel/TaskStartPanel.as:266-268`;`analysis/as3/scripts/net/pixvi/myr/net/NetTask.as:58-70`。 | 若返回 `stageReward`,优先作为奖励,否则用 `reward`,并保留完整响应交给回调。普通步骤回调更新 `taskStepValue`,按条件消费资源和推进本地步骤;任务战斗回调走另一条处理路径。证据:`analysis/as3/scripts/net/pixvi/myr/net/NetTask.as:73-84`;`analysis/as3/scripts/net/pixvi/myr/center/TaskCenter.as:404-469`。本地条件详见 E12—E14,不能仅凭接口存在就提交。 |
| `taskComplete` | 任务详情入口只在 `canFinish()` 为真时发送 `taskId/taskTypeId`;不携带 `battleData` 或 `removeIds`。证据:`analysis/as3/scripts/net/pixvi/myr/panel/task/TaskViewPanel.as:151-157`;`analysis/as3/scripts/net/pixvi/myr/net/NetTask.as:87-102`。 | 响应含 `reward/nextTasks/unlockTasks/unlockStages`;移除旧实例、标记 `passTask`、加入返回的新任务、解锁任务/关卡;若命中城市 `openTask` 还会开启城市。证据:`analysis/as3/scripts/net/pixvi/myr/center/TaskCenter.as:272-325`。这是步骤完成之后的独立闭环。 |
| `taskLoopReceive` | 委托面板显示当前城市的 `history.loopTask[cityId]`;详情接取入口检查全局 `loopTaskNum > 0`,发送 `taskTypeId` 和当前 `city`。证据:`analysis/as3/scripts/net/pixvi/myr/panel/looptask/LoopTaskPanel.as:79-100`;`analysis/as3/scripts/net/pixvi/myr/panel/task/TaskViewPanel.as:127-137`;`analysis/as3/scripts/net/pixvi/myr/net/NetTask.as:122-138`。 | 用响应构造已接取实例;接取成功立即扣一次剩余次数,从对应城市候选列表移除该类型。次数消耗在接取时,不在领奖时。证据:`analysis/as3/scripts/net/pixvi/myr/center/TaskCenter.as:853-871`。城市候选资格与次数的服务端规则未知。 |
- **E04|已证实:解锁不等于接取。** `unlockLocalTask` 创建 `id=0` 的任务并放在 `startStep`,默认 `recieved=false`。初始化从 `history.unlockTask` 重建未关闭、未完成且本地不存在的待接任务;已接任务则从 `currentTasks` 重建。证据:`analysis/as3/scripts/net/pixvi/myr/center/TaskCenter.as:478-494`、`:775-799`;`analysis/as3/scripts/net/pixvi/myr/element/task/TaskVo.as:15-27`;`analysis/as3/scripts/net/pixvi/myr/center/MasterCenter.as:202-215`、`:262`。任务列表仅纳入 `recieved` 的任务,不能用“列表中没有任务”推断没有待接支线。证据:`analysis/as3/scripts/net/pixvi/myr/center/TaskCenter.as:620-650`。
主线自动衔接有两类来源,不能按任务编号递增或只看 `isMain`。
- **E05|已证实:领奖响应能够直接带来已接取后继。** `taskComplete` 返回的 `nextTasks` 是任务数据对象,直接经 `getTaskByTaskData` 加入任务列表,转换函数标记 `recieved=true`;`unlockTasks` 则调用本地解锁逻辑。此路径没有再为每个后继调用一次 `taskReceive`。证据:`analysis/as3/scripts/net/pixvi/myr/net/NetTask.as:97-102`;`analysis/as3/scripts/net/pixvi/myr/center/TaskCenter.as:59-68`、`:287-302`。
- **E06|已证实:另有 `taskUpdate` 补链。** 首次牧场流程调用 `autoCheckNewTask()`。该函数根据 `Table.setting.useOldNewTaskFunction` 选择算法,最终发送 `unlockTasks/receiveTasks/removeTasks`。新算法遍历 `history.passTask` 的键,从对应配置取 `nextTasks/unlockTasks`;后继要求目标未关闭、未通过且本地不存在,解锁分支检查未关闭及历史未解锁,并收集本地已关闭任务的实例 ID。请求中的后继带 `{prev, taskTypeId}`。证据:`analysis/as3/scripts/net/pixvi/myr/panel/storeground/StoreGroundPanel.as:103-106`;`analysis/as3/scripts/net/pixvi/myr/center/TaskCenter.as:76-95`、`:127-200`;`analysis/as3/scripts/net/pixvi/myr/net/NetTask.as:141-157`。
- **E07|已证实/未知:旧算法与新算法不能混用。** 旧分支从 `1001001` 开始,先要求该节点已经通过,再沿已通过的 `nextTasks` 递归补链;该方法没有新算法同样的 `closed/removeTaskIds` 处理。回包的 `receiveTasks` 构造已接取任务,`unlockTasks` 构造待接任务。这些算法都没有以 `isMain` 作为自动接取开关;`isMain` 在任务分类及列表排序处使用。证据:`analysis/as3/scripts/net/pixvi/myr/center/TaskCenter.as:203-261`、`:98-124`、`:632-650`;`analysis/as3/scripts/net/pixvi/myr/element/task/TaskVo.as:176-182`。**未知:当前资源实际启用哪一分支、完整主支线依赖、全新角色首任务如何初始化。** 旧算法的起点不能直接视为新账号接取方案。
`battle`、`passStage` 和普通挑战的区别如下。
| 比较项 | 任务步骤 `battle` | 任务步骤 `passStage` |
| --- | --- | --- |
| 配置来源【已证实】 | 战斗取当前任务步骤的 `battle`;奖励取步骤配置。 | 战斗与奖励按 `statusValue.stage/level` 取关卡配置。 |
| 共同入口【已证实】 | 两者 `hasBattle()` 都为 true,进入任务战斗路径。 | 同左;并非因为目标是关卡就自动走普通挑战的结算。 |
| 战斗上下文【已证实】 | `BattlePosition` 为 `battleType="task"`,含任务类型与零基步骤。 | 同左;位置辅助方法还能从任务目标解析关卡 ID/难度。 |
| 胜利后的关卡历史【已证实】 | `isStageBattle()` 返回 false,该任务回调没有调用 `passLocalStage`。 | `isStageBattle()` 返回目标关卡,任务成功回调调用 `passLocalStage`,应用服务端返回的体力及开关关卡信息。 |
| 本地“条件满足”【已证实】 | `isStatusComplete()` 对两类均直接返回 true,实际仍由战斗分支处理。 | 这里不查询历史 `passStage`,不能把“以前打通过”当作本步骤已结算。 |
上表逐项证据:配置来源与共同入口见 `analysis/as3/scripts/net/pixvi/myr/element/task/TaskStepVo.as:114-158`;任务上下文见 `analysis/as3/scripts/net/pixvi/myr/panel/taskstartpanel/TaskStartPanel.as:249-263`、`analysis/as3/scripts/net/pixvi/myr/element/battle/BattleType.as:6`、`analysis/as3/scripts/net/pixvi/myr/element/battle/BattlePosition.as:51-86`;关卡历史处理见 `analysis/as3/scripts/net/pixvi/myr/panel/taskstartpanel/TaskStartPanel.as:271-286`;本地条件判定见 `analysis/as3/scripts/net/pixvi/myr/element/task/TaskStepVo.as:188-223`。
- **E08|已证实:任务战斗的 `battleData` 路径。** `TaskStartPanel.step2` 检查可参战队伍 → `NetBattle.startBattle("task", taskTypeId, null, ...)` → `battleService/battleStart` 的请求只带 `battleType/taskTypeId` → 成功后开启任务战斗,并设置胜利回调 → 回调取得 `BattleData`,把 `getObj()` 交给 `taskService/taskCompleteStep`。这里没有先调用 `stageService/stageStart`,也没有在该胜利回调中调用普通 `battleEnd`。证据:`analysis/as3/scripts/net/pixvi/myr/panel/taskstartpanel/TaskStartPanel.as:215-268`;`analysis/as3/scripts/net/pixvi/myr/net/NetBattle.as:35-54`;`analysis/as3/scripts/net/pixvi/myr/net/NetTask.as:58-70`。**未知:战果对象内部生成和校验,归主代理。**
- **E09|已证实:普通挑战的 `battleData` 路径。** 普通关卡按钮先检查体力与队伍,再调用 `StageStartPanel.start`。未被任务截获时:`StageCenter.startStage` → `NetStage.startStage` → `stageService/stageStart`;无随机事件才继续普通战斗,位置为 `battleType="stage"`。普通胜利回调 → `StageCenter.finishStageBattle` → `battleData.getObj()` → `NetStage.finishStageBattle` → `battleService/battleEnd`,请求为 `{battleData: ...}`。证据:`analysis/as3/scripts/net/pixvi/myr/panel/stage/StagePanel.as:308-313`;`analysis/as3/scripts/net/pixvi/myr/panel/stage/StageStartPanel.as:62-73`、`:87-110`、`:156-180`、`:250-257`;`analysis/as3/scripts/net/pixvi/myr/center/StageCenter.as:97-100`、`:125-139`;`analysis/as3/scripts/net/pixvi/myr/net/NetStage.as:66-89`。`NetBattle.startBattle` 虽声明了 `stage` 参数形式,本次核对未见普通挑战直接调用该形式,不能把声明补进上述实际调用链。声明证据:`analysis/as3/scripts/net/pixvi/myr/net/NetBattle.as:35-54`。
- **E10|已证实:有入口却未必发生普通战斗。** `StageStartPanel.start` 先按 `city{city}_wild_stage{id}_level{level}` 找任务;匹配后转入 `TaskStartPanel` 并立即 return。任务面板结束只执行入口的结束回调,没有自动接着调用 `stageStart`。此外 `stageStart` 回包可能是随机事件,进入剧情/图片、直接奖励或隐藏关卡分支。证据:`analysis/as3/scripts/net/pixvi/myr/panel/stage/StageStartPanel.as:87-152`、`:270-282`;`analysis/as3/scripts/net/pixvi/myr/center/StageCenter.as:103-121`。**推断:调度动作应允许返回“被任务接管/事件处理”,随后重新规划,不能预先认定一轮普通挑战已完成。**
- **E11|已证实/未知:失败不能套用胜利闭环。** 两个入口都将 `onLoseCallBack` 置为 null;本次看到的任务 `taskCompleteStep(battleData)` 与普通 `finishStageBattle` 都位于胜利回调。任务结束回调中,`win=true` 才去后续剧情,false 只退面板。证据:`analysis/as3/scripts/net/pixvi/myr/panel/taskstartpanel/TaskStartPanel.as:260-268`、`:289-305`;`analysis/as3/scripts/net/pixvi/myr/panel/stage/StageStartPanel.as:171-180`、`:250-267`。**未知:运行时失败、退出、中断分别发送什么、是否扣资源、是否允许重试。null 不能证明整个客户端没有失败上报。** `recordBattleResult` 包装函数只发送 `stageId/cityId/result`,没有 `battleData` 或任务 ID,不能视为任务完成或普通战果结算的替代。证据:`analysis/as3/scripts/net/pixvi/myr/net/NetBattle.as:25-32`。
还需保留以下剧情、前置和导航阻塞。
- **E12|已证实:条件、引导和位置是不同关口。** `TaskStepVo.hasTalk` 先检查步骤 `condition`,再要求当前位置精确匹配,且有 `story` 或为 `battle`;`canShow` 另检查 `passGuide` 对应的引导记录。`PosCenter.update` 只对满足条件、未关闭且未到领奖状态的任务建入口;`auto=true` 时自动打开任务面板,否则放入 NPC 列表。这里的 auto 是到达位置后的交互,不是所有主线自动接取。证据:`analysis/as3/scripts/net/pixvi/myr/element/task/TaskStepVo.as:100-111`、`:170-180`、`:284-303`;`analysis/as3/scripts/net/pixvi/myr/center/PosCenter.as:42-63`、`:90-99`。进入关卡面板会激活不带难度的位置,而开始挑战匹配带难度的位置,两层均需识别。证据:`analysis/as3/scripts/net/pixvi/myr/panel/stage/StagePanel.as:182`;`analysis/as3/scripts/net/pixvi/myr/panel/stage/StageStartPanel.as:93-99`。
- **E13|已证实:前置不限于已完成任务。** `ConditionVo.check` 包含等级上下限、关闭标记、平台/渠道/语言、`finishTask`、`unfinishTask`、通关/解锁关卡、星期、日内时间和时间戳区间。`unfinishTask` 会同时拒绝已经完成及已经接取的指定任务。关卡检查默认难度为 1。证据:`analysis/as3/scripts/net/pixvi/myr/element/npc/ConditionVo.as:155-244`;`analysis/as3/scripts/net/pixvi/myr/center/StageCenter.as:310-325`。**源码异常已证实、实际语义未知:** `ConditionVo.ondata` 在 `data.passStage` 非空时反而设为空数组;`lang` 定义及检查存在,但该装载方法没有给 `data.lang` 赋值。不能未经核对就把这些异常当成正式规则或据此跳过检查。证据:`analysis/as3/scripts/net/pixvi/myr/element/npc/ConditionVo.as:38-42`、`:60-138`、`:176-178`;Python 条件实现见 `ranch_assistant/quests.py:30-60`。
- **E14|已证实:状态达成、步骤提交、后续剧情结束不是同一时刻。** 非战斗条件包括背包物品/魔物数量、等级、金币、图鉴、`guide_record` 等;`killMonster` 比较的是累计击杀与实例 `stepValue`,不是直接拿配置 `num` 作绝对累计目标。`canStepComplete` 还要求 `afterStory == ""`。任务面板的非空后续剧情播放完,才经 `stepPassEnd → completeLocalStep` 增加本地步骤;普通步骤回调是否直接本地推进也有单独的战斗/剧情判定。证据:`analysis/as3/scripts/net/pixvi/myr/element/task/TaskStepVo.as:188-223`、`:247-249`、`:275-281`;`analysis/as3/scripts/net/pixvi/myr/panel/taskstartpanel/TaskStartPanel.as:309-344`;`analysis/as3/scripts/net/pixvi/myr/center/TaskCenter.as:457-469`、`:350-374`。**推断:仅凭胜利或资源数量足够就连续提交后续步骤,可能越过剧情状态;应等待可信状态更新。**
- **E15|已证实:普通战斗可以服务累计目标,但不能混同任务战斗。** 状态类型说明将 `killMonster` 定义为任意胜利战斗中的累计狩猎;完成判定读取 `history.numKillMonsters` 和 `stepValue`,该类型本身不属于 `hasBattle()`。证据:`analysis/as3/scripts/net/pixvi/myr/element/task/TaskStatusType.as:75-80`;`analysis/as3/scripts/net/pixvi/myr/element/task/TaskStepVo.as:152-158`、`:205-210`。**未知:实际结果如何更新此累计数、形态筛选和服务端校验;未追踪战斗运行时。** 调度只能消费主代理提供的已确认状态,不能自行补击杀数。
- **E16|已证实:可导航性还依赖城市和难度解锁。** 城市检查含 `hide` 与 `unlockCity`;关卡显示依赖未关闭、特殊条件通过及普通难度已解锁;高难度按钮还依赖 `openHardMode`、对应难度解锁及城市难度开关。早期任务另有专门的引导/剧情处理。证据:`analysis/as3/scripts/net/pixvi/myr/element/city/CityVo.as:18-24`、`:46-60`;`analysis/as3/scripts/net/pixvi/myr/element/stage/StageVo.as:57-98`;`analysis/as3/scripts/net/pixvi/myr/panel/stage/StagePanel.as:255-280`、`:361-395`。任务列表点击只打开详情,本次核对的入口没有直接导航到任务目标。证据:`analysis/as3/scripts/net/pixvi/myr/panel/task/TaskPanel.as:122-126`。
每日委托的时间边界也应进入调度模型。
- **E17|已证实:刷新会使旧委托失效。** 客户端以 `loopTaskTime` 与当前时间减 10 秒的日期编号比较,跨日才 `taskLoopFlush`,并设刷新中标志。成功后重置次数和候选列表、更新刷新时间,并移除所有本地 type4 实例,提示超时。主菜单周期检查和委托面板都能触发刷新。证据:`analysis/as3/scripts/net/pixvi/myr/center/TaskCenter.as:802-850`;`analysis/as3/scripts/net/pixvi/myr/panel/mainmenu/MainMenu.as:222-229`;`analysis/as3/scripts/net/pixvi/myr/panel/looptask/LoopTaskPanel.as:61-65`。因此不能跨日继续沿用旧实例 ID,也不能假定未领奖委托永久保留。
- **E18|已证实:当前配置每日接取上限是 6,日期按地区设置。** 上限由 `GameMath.loopTaskMaxNum` 读取 `game_setting.loopTaskMaxNum`,catalog 值为 6。`MYRStarter` 对 JP 设置日本偏移,其余设置中国偏移;中国日编号按 UTC+8 计算。证据:`analysis/as3/scripts/net/pixvi/myr/GameMath.as:113-115`;`ranch_assistant/data/catalog.json:1`,JSON Pointer `/game_setting/loopTaskMaxNum`;`analysis/as3/scripts/MYRStarter.as:110-116`;`analysis/as3/scripts/net/pixvi/myr/util/MyrCalendar.as:11-17`、`:52-68`。**未知:服务端是否有其他限额、刷新与在途战斗的竞态处理。**
可供主计划直接引用的配置例子均来自现有 catalog,未补造缺失字段。
| 已证实的例子 | 可以说明什么 | 精确证据 |
| --- | --- | --- |
| `4008001` 第二步:`passStage`,关卡 `08c2`/难度 1,非空 `afterStory`。 | 任务关卡战斗后仍有剧情边界。 | `ranch_assistant/data/catalog.json:1`,JSON Pointer `/task_info/4008001/steps/1`。 |
| `4004002` 第二步:`battle`,位置 `city4_wild_stage0402`,非空 `afterStory`。 | 在普通关卡位置发生的交互仍可能是独立任务战斗;现有步骤条目缺少实际 `battle` 配置。 | `ranch_assistant/data/catalog.json:1`,JSON Pointer `/task_info/4004002/steps/1`。 |
| `4004006` 第二步:`passStage`,关卡 `0421`/难度 1,`afterStory` 为空。 | 可以作为后续接入时较小的任务战斗候选,但仍需验证完整配置及合法结果路径。 | `ranch_assistant/data/catalog.json:1`,JSON Pointer `/task_info/4004006/steps/1`。 |
| `4002003` 第二步:`killMonster`,目标类型 `1025010`、数量 40,非空 `afterStory`。 | 可由累计战斗目标衔接到任务提交及剧情;数量 40 不是实例累计阈值本身。 | `ranch_assistant/data/catalog.json:1`,JSON Pointer `/task_info/4002003/steps/1`;阈值依据 E14。 |
| `1001011` 的位置序列含 `city1_wild_stage0115_level2`。 | 有主线位置线索,但不能由此还原完整主线步骤。 | `ranch_assistant/data/catalog.json:1`,JSON Pointer `/stage_task_positions/1001011`;特殊交互见 `analysis/as3/scripts/net/pixvi/myr/panel/stage/StagePanel.as:255-265`。 |
现有 `quests.py` 的能力边界如下,均为静态核对,未修改代码。
- **E19|已证实:战斗开关只放宽接取筛选。** `QuestPolicy.battle_tasks` 默认 false;开启后 `plan` 在“整条任务是否支持”的筛选中可接受 `battle/passStage`,但 `requirement` 遇到它们仍始终返回“需实际战斗”,没有战斗执行或 `battleData` 提交分支。接取筛选的短路还会越过该战斗步骤的 `condition/afterStory` 检查。证据:`ranch_assistant/quests.py:64-72`、`:83-90`、`:184-188`。**推断:不能把开启该选项对外解释成已支持自动战斗委托。**
- **E20|已证实:当前自动推进不覆盖完整主支线。** `current()` 只保留 catalog 中已知的任务类型 ID;现有数据仅有 type4。`plan` 优先跨日刷新,然后整任务领奖或非战斗步骤提交,最后从城市候选接取委托;没有普通 `taskReceive` 或 `taskUpdate` 分支。非空 `afterStory` 会阻塞,`none` 则直接判可推进,且没有位置、`passGuide` 或前置 `story` 判断。证据:`ranch_assistant/quests.py:80-94`、`:153-188`;数据边界见 E01。**推断:缺失字段不能默认表示安全可跳过剧情;现有 planner 不能直接推广到主线。**
- **E21|已证实:已经存在可保留的资源保护与累计阈值处理。** 提交物品考虑保留量和锁;金币、物品、魔物提交分别有策略约束;`killMonster` 使用实例 `stepValue`。预约统计扫描当前及后续步骤。证据:`ranch_assistant/quests.py:95-126`、`:191-202`。这些是任务层的现有能力,本笔记没有核对其导入的其他辅助模块内部实现。
以下是设计建议,全部属于**推断/建议**,不是本次已实现的能力。
1. **分别记录解锁、已接取、当前步骤、等待交互/剧情、等待合法战斗、可领奖、已领取、过期。** 保留 `taskId/typeId/curStep/stepValue` 和配置完整度;未知字段不能填成空剧情。整任务领奖后消费返回的新任务及解锁,再重新规划,避免重复接取。依据 E01、E03—E07、E14、E17。
2. **把战斗上下文交给主代理的战斗边界,任务层只提供意图。** 意图至少区分普通关卡、任务 `battle`、任务 `passStage`、为累计目标安排普通挑战。结果作为不透明对象传递;成功时按原始上下文选择唯一结算入口,任务战斗不能再额外普通 `battleEnd`。失败/中断返回独立状态,不自动推进步骤。依据 E08—E11、E15。
3. **每次计划只执行一个状态改变动作,收到可信结果或已有状态更新后再规划。** 同一接口/任务保持串行;`NetTask` 每类调用只有一个回调槽,`TaskCenter` 也保存单份提交上下文,不支持据此假定并发安全。网络结果不确定时先停止依赖该结果的步骤,不能盲目重放完成请求。依据 `analysis/as3/scripts/net/pixvi/myr/net/NetTask.as:20-30`、`:58-83`;`analysis/as3/scripts/net/pixvi/myr/center/TaskCenter.as:36-44`、`:396-418`;失败和幂等规则仍未知。
4. **先处理可达性和任务截获,再安排普通挑战。** 校验城市、难度、步骤条件、引导和当前剧情;位置匹配后可能只完成任务交互,应返回规划器而非继续假定普通战斗已发生。自动任务补链依实际配置的 `nextTasks/unlockTasks` 和响应,不靠编号。依据 E05—E07、E10、E12—E16。
5. **委托按剩余接取次数和当日时限安排。** 截止前给已接可完成任务留出战斗、后续剧情和领奖时间;跨日后废弃旧计划并依刷新状态重建。开关应分别表达“允许接取战斗任务”和“战斗执行能力可用”,接取前评估后续剧情及配置完整度。资源预约规则继续覆盖后续任务步骤。依据 E17—E21。
可分阶段范围如下;每阶段完成标准应以本地静态资料和离线用例为基础,本次不进行线上验证。
| 阶段 | 可交付范围 | 明确的停止边界 |
| --- | --- | --- |
| A:只读任务诊断 | 展示当前任务状态、准确步骤索引、委托次数/跨日状态、配置缺失和阻塞原因;将主代理已解码完整任务数据用于独立研究索引,保留现有 catalog。 | 现有 83 条不支持完整主支线依赖图;缺前置配置时标未知,不猜接取。依据 E01—E07、E17—E20。 |
| B:普通挑战与现有委托协同 | 在主代理已完成合法普通挑战成功/失败接口之后,对齐普通挑战结果与任务累计目标;保留已有非战斗提交保护,遇到任务截获或剧情则等待。 | 不因累计目标达成而绕过非空 `afterStory`;不自行补 `stepValue` 或击杀数。依据 E09—E15、E21。 |
| C:受限任务战斗 | 先验证完整配置中无后续剧情的少量 `passStage`,保留任务 `battleStart → taskCompleteStep` 路径和整任务领奖;再评估独立 `battle`。 | 仅在主代理提供真实结果处理、失败边界和完整配置后接入;现有 catalog 的独立 `battle` 缺配置,不满足此条件。依据 E01、E08、E11、配置例子。 |
| D:主支线补链与剧情调度 | 依据完整图接入 `taskUpdate`、普通接取和领奖后继;覆盖位置、引导、剧情选择及特殊新手任务。 | 每类脚本交互分别确认;本阶段不承诺完美覆盖全部主线。依据 E04—E07、E12—E16。 |
尚未解决且不影响本笔记交付的问题:完整任务图及算法开关的实际配置;服务端对四个任务接口的全部前置、错误码与幂等规则;任务提交后中断后续剧情的重入语义;每日刷新与在途战斗/领奖的竞态;失败、撤退、中断的实际结算;`ConditionVo` 装载异常是原程序问题还是反编译问题。战斗结果内部字段、数学、运行时和检查机制不在本子任务范围。以上不能由成功回调或客户端包装函数推定,需由主代理在获准范围内继续核对。
主代理后续离线核验:直接恢复原APK的完整 `setting` 表,未发现 `useOldNewTaskFunction` 字段。按 `TaskCenter.as:81` 的 `== true` 分支判断,APK基线进入新算法;该结果已写入 `V1_2_BATTLE_INVENTORY.json` 的 `task_update_mode`。线上热更新实际开关仍未知。用户补充要求预研中的线上账号操作由本人手动执行,离线实验可直接推进。
+104
View File
@@ -0,0 +1,104 @@
"""Read original APK battle tables for v1.2 research; never contacts a server."""
from collections import Counter
import hashlib
import json
from pathlib import Path
import re
import sys
import zipfile
import zlib
ROOT = Path(__file__).resolve().parent.parent
sys.path.insert(0, str(ROOT))
from ranch_assistant.amf import Reader
def recover_table(archive, name):
logical = f"data/table/{name}.json"
member = "assets/codes/" + hashlib.md5(logical.encode()).hexdigest()
compressed = archive.read(member)
decoded = zlib.decompress(compressed)
reader = Reader(decoded)
value = reader.read()
if reader.pos != len(decoded):
raise ValueError(f"Unconsumed table bytes: {name}")
return value, {"logical_path": logical, "member": member,
"compressed_bytes": len(compressed), "decoded_bytes": len(decoded),
"sha256": hashlib.sha256(compressed).hexdigest()}
def main():
candidates = list(ROOT.glob("*_1.9.68.apk"))
if len(candidates) != 1:
raise ValueError("Expected exactly one original 1.9.68 APK")
apk = candidates[0]
tables, metadata, binaries = {}, {}, {}
names = ("stage_info", "task_info", "monster_info", "monster_skill", "monster_setting",
"setting", "game_setting", "item_info", "entangle_info", "potential_info", "team_info")
with zipfile.ZipFile(apk) as archive:
for member in ("assets/MYRMain.app", "assets/MYRDyd.swf"):
data = archive.read(member)
binaries[member] = {"bytes": len(data), "swf_signature": data[:3].decode("ascii"),
"swf_version": data[3], "sha256": hashlib.sha256(data).hexdigest()}
for name in names:
value, metadata[name] = recover_table(archive, name)
tables[name] = value.get("datas", value) if isinstance(value, dict) else value
metadata[name]["record_count"] = len(tables[name])
stages = tables["stage_info"]
stages = stages.values() if isinstance(stages, dict) else stages
stage_levels, battles = [], []
for stage in stages:
for level in (stage.get("level") or {}).values():
stage_levels.append(level)
if isinstance(level.get("battle"), dict):
battles.append(level["battle"])
tasks = list(tables["task_info"].values())
task_battles = [step["battle"] for task in tasks for step in task.get("steps", [])
if isinstance(step.get("battle"), dict)]
controllers, triggers, win_types, lose_types = Counter(), Counter(), Counter(), Counter()
for battle in battles + task_battles:
controllers.update(str(x.get("type")) for x in battle.get("controller", []))
triggers.update(str(x.get("type")) for x in battle.get("triggers", []))
win_types.update(str(x) for x in battle.get("winType", []))
lose_types.update(str(x) for x in battle.get("loseType", []))
scripts = ROOT / "analysis/as3/scripts"
files = list(scripts.rglob("*.as"))
counts = {}
for folder in ("net/pixvi/myr/battle", "net/pixvi/myr/view/skill",
"net/pixvi/myr/view/attack", "net/pixvi/myr/element/battle"):
counts[folder] = len(list((scripts / folder).rglob("*.as")))
missing = set()
for file in (scripts / "net/pixvi/myr/battle").rglob("*.as"):
for imported in re.findall(r"import ([\w.]+);", file.read_text(encoding="utf-8")):
if imported.startswith(("net.pixvi.pfw.", "net.pixvi.common.", "starling.")):
if not (scripts / (imported.replace(".", "/") + ".as")).exists():
missing.add(imported)
catalog = json.loads((ROOT / "ranch_assistant/data/catalog.json").read_text(encoding="utf-8"))
summary = {"artifact": apk.name, "apk_bytes": apk.stat().st_size,
"binaries": binaries, "tables": metadata,
"battle_coverage": {"stage_level_count": len(stage_levels), "stage_battle_object_count": len(battles),
"stage_nonempty_battle_count": sum(bool(b) for b in battles),
"task_battle_object_count": len(task_battles), "task_nonempty_battle_count": sum(bool(b) for b in task_battles),
"controller_types": dict(controllers),
"trigger_types": dict(triggers), "win_types": dict(win_types), "lose_types": dict(lose_types)},
"task_types": dict(Counter(str(t.get("type")) for t in tasks)),
"task_update_mode": {"legacy_flag_present": "useOldNewTaskFunction" in tables["setting"],
"legacy_flag": tables["setting"].get("useOldNewTaskFunction"),
"selected_by_retained_client": "legacy" if tables["setting"].get("useOldNewTaskFunction") is True else "new"},
"retained_sources": {"all_as_files": len(files), "battle_source_counts": counts,
"battle_framework_imports_without_retained_source": sorted(missing)},
"helper_catalog": {"has_monster_skill": "monster_skill" in catalog,
"has_setting": "setting" in catalog, "task_count": len(catalog["task_info"]),
"stage_levels_with_battle": sum(isinstance(l.get("battle"), dict)
for s in catalog["stage_info"].values() for l in s.get("level", {}).values())},
"scope": "Static table recovery and retained source inventory only; no battle executed or submitted."}
output = ROOT / "analysis/V1_2_BATTLE_INVENTORY.json"
output.write_text(json.dumps(summary, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
print(json.dumps({"output": str(output.relative_to(ROOT)),
"table_counts": {k: v["record_count"] for k, v in metadata.items()},
"battle_coverage": summary["battle_coverage"], "helper_catalog": summary["helper_catalog"],
"missing_framework_sources": len(missing)}, ensure_ascii=True))
if __name__ == "__main__":
main()