Files
myrzx_bot/analysis/V1_2_PLAN.md
T

183 lines
23 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# v1.2 方案与实施状态:主线任务、普通挑战与战斗委托
## 2026-11-08 增量收尾与下次待办
按用户剩余额度限制,本轮只完成短路径修改:桌面程序统一使用内置实验模拟并等待计算出的战斗时长,移除运行时选择;修复任务1002002(再次出发,0201难度1)纯显示 `buffMovie` 控制器造成的阻塞;委托按奖励氪金20→15→10排序,委托执行优先于普通策略,材料不足时接通现有扫荡/挑战来源。保留原属性、资源保护和未知结果核对机制,未执行真实游戏请求。
本轮定向验证:任务/编排/委托优先级141项、最终界面及配置/原自动化回归51项、战斗模型40项通过。未运行长时间原AIR试验,也未重新执行全量回归。
**下次继续:按委托缺口购买魔物蛋、孵化并交付的完整联动。** 先按种类统计未保护的可交付成熟魔物、正在孵化的魔物和可用蛋,库存已够时不买;仅为剩余缺口抽蛋,按服务器实际返回重新核对,够数即停。金币市场不能保证每次抽中指定蛋,需要遵守金币保留、每日额度、VIP坑位、牧场容量及保护规则,并覆盖重启恢复与普通孵蛋之间的优先级测试。此功能尚未实现,不应将本轮委托排序误解为已能自动买蛋补齐所有魔物委托。
状态更新:2026-11-08。研究起点:辅助 v1.1.1、原始 Android APK 1.9.68;当前实现为 `develop/v1.2.0` 的 **1.2.0.dev1**。
状态:完整任务资料、有状态任务/对话/补链/收集规划、普通地图与任务/委托战斗编排、界面及策略保存已经实现。原 AIR 已通过原始战斗面板自然完成合成 1-1 离线实验,取得实际统计与检查,样例 `cheatNum=0`;任意实际阵容桥接仍在完善。独立实验模型已接入编排,完整集成 QA 正在运行,服务器接受结果仍未验证。验证完成前保持开发版;尚未创建稳定标签或合入main。
实验安排:继续推进离线解析、运行壳和战斗实验。本轮真实账号接任务、开战、结算与领奖验证由用户手动操作;软件在用户开启策略后,可按配置和能力检查自动执行已支持操作。
当前交接与准确验证记录见[V1_2_IMPLEMENTATION.md](V1_2_IMPLEMENTATION.md)。下文保留研究证据与验收标准;[早期普攻估算](V1_2_OFFLINE_EXPERIMENT.md)、[原 AIR 运行实验](V1_2_RUNTIME_IMPLEMENTATION.md)、[独立实验模型](V1_2_SIMULATION_IMPLEMENTATION.md)是不同路径,不能互相替代覆盖或对拍证据。
## 当前阶段状态
| 范围 | 当前实现与验证状态 |
| --- | --- |
| 数据和规划 | 独立索引资料包包含1165任务、1178关卡、337 NPC、4269脚本;4239份线性脚本支持,主线引用718/720。145项定向测试通过;禁用socket检查6份本地日志中的514个快照,规划器异常0次。30份特殊选择等脚本(含2份主线)、4类接取入口和任务1001006抽蛋钩子仍不支持。 |
| 调度和界面 | 已实现服务器步骤确认后再执行本地剧情收尾、补链、缺口收集、QuestPolicy拥有的委托调度、普通地图奖励事件/战斗分流、三难度全通后扫荡及任务专属战斗路线;编排66项、选定回归212项、界面目标30项为阶段记录,集合有重叠,不相加为全量总数。 |
| 原 AIR | 合成1-1已自然完成,使用实际原始BattlePanel统计与检查;当前只是局部离线能力证明,任意实际阵容桥接和广泛支持仍待验证,默认原版模式不放行未验证开战。 |
| 实验模型 | 独立进程模型已有38项测试;结构准入941/2512地图战斗配置、106/199任务内嵌配置,12场合成地图执行自然胜利。AP、出场、移动、攻击及技能3/5/7/9/38部分实现,仍有近似与遗漏;已接入应用,须显式选择实验模式。 |
| 集成与发布 | 独立完整QA和原版/模型最终集成结论待回填;本轮开发验证未执行真实游戏请求,实际账号验收由用户手动进行。维持开发版,不承诺全部主线或服务器接受结算。 |
## 可行性结论
**原始战斗内核已有单场合成离线成功证据,任务与战斗调度已实现;实际阵容桥接、机制覆盖与完整集成仍需验证。**
手机可以不启动游戏;电脑辅助仍需登录并与服务器通信。电脑侧可以负责选择任务、准备阵容、运行战斗、提交实际结果、核对任务进度,再继续下一步。
战斗必须能够自然得到胜利、失败或超时;强度不够时应停下或等待培养。按原始规则运行不代表任何阵容都能推过主线。
本次确认了客户端会在本地创建战场、执行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解析,非空字典不等同于已验证可挑战关卡 |
| 预研起点的辅助资料不完整 | 既有精简catalog只保留83条每日委托任务,关卡战斗字典被剔除;现已保留原catalog并新增完整任务索引、延迟读取的战斗资料和实验战斗表 | [提取脚本](../tools/extract_ranch_catalog.py#L70)、[原清单](V1_2_BATTLE_INVENTORY.json)、[当前实施](V1_2_IMPLEMENTATION.md) |
| 战场在客户端生成 | 关卡配置构造成 `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内配置是本次离线基线,不等同于该账号当前热更新资源。
现有资料包已携带原APK版本、来源及文件摘要;线上热更新匹配仍待验证,不能把静态摘要通过解释为实际服务资源一致。
## 推荐的引擎路线
| 路线 | 用途与可行性 | 本次结论 |
| --- | --- | --- |
| Python按公式简单估算 | 可用于阵容强度预览;无法覆盖帧序、弹道、复杂技能和场景触发 | 不作为实际挑战的结算引擎 |
| 原始AS3/AIR战斗内核加独立运行壳 | 更适合保持原有逻辑和数值语义,也可作为其他实现的对照基准;需补依赖并切开登录、平台SDK、资源和展示入口 | 原始BattlePanel已自然完成合成1-1;实际阵容桥接及广泛能力仍待验证,尚不能据此认定支持全部原版战斗 |
| 将战斗逻辑逐步移植到独立工作进程 | 能满足长期无需手机、无需完整游戏客户端的目标;需要覆盖度管理和严格对拍 | 独立Python实验模型已实现并接入编排,38项模型测试;近似与遗漏明确披露,完整集成和原引擎对拍待完成 |
| 直接把完整游戏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;后续已准备本地AIR运行资源并执行合成离线战斗,最新依赖与运行证据见[原引擎技术记录](V1_2_RUNTIME_IMPLEMENTATION.md)。早期Python普攻估算仍是独立研究工具,不是当前应用的实验战斗模型。
## v1.2 分阶段实施方案
| 阶段 | 交付物 | 验收标准 |
| --- | --- | --- |
| P0 完整资料和任务识别 | 保留全部任务、战斗、技能、场地及属性资料的独立资料包;只读主线任务列表、前置条件、当前阻塞原因 | 任务类型和地图定位与源码一致;不改现有精简catalog;本次已完成资料可恢复性的证明 |
| P1 离线引擎验证 | 一场简单关卡的独立运行壳、完整输入输出、时钟/随机/事件记录 | 无服务器连接;自然运行到胜利、失败、超时;能从正常引擎执行取得结算统计,而非手工填结果 |
| P2 有限机制覆盖 | 普攻、移动、出场/AP、少量已验证技能、地图波次与终局判断;明确支持的队伍和关卡清单 | 同输入/随机流/操作序列与原引擎对拍;比较中间状态和最终统计;未知机制明确拒绝 |
| P3 普通挑战闭环 | 单个指定普通关卡的开始、实际战斗、对应结算、状态核对及本地记录 | 真实账号联网操作由用户手动进行,首轮采用真实时钟;胜利/失败路线分别正确,奖励、体力、魔物经验和通关状态与服务器结果一致;超时不重复提交 |
| P4 主线和委托调度 | 主线接取、步骤推进、地图挑战、任务专属战斗、提交与领奖;恢复未完成步骤 | 覆盖一个包含非战斗和战斗步骤的任务链;战斗完成后再核对任务状态,不凭本地胜利预先推进 |
| P5 扩大覆盖与多账号 | 扩充技能、场景和事件覆盖;独立工作进程、配置导出、诊断与任务界面 | 大列表和战斗不阻塞Qt;角色互不串数据;遇不支持内容、实际战败或资源不足时按策略停止 |
当前进度:P0资料和任务可视化已实现;P1取得原AIR合成单场自然完成证据,实际阵容输入仍待完成;P2已有有限机制实验模型,原引擎严格对拍待完成;P3/P4的普通地图、任务和委托编排及模拟测试已实现,真实账号闭环未验收;P5的进程、配置和界面已接入,完整QA及覆盖扩展继续进行。各阶段具体交接见[实施记录](V1_2_IMPLEMENTATION.md#阶段交接与后续验收)。
当前局部运行与测试不构成完整自动推主线的验收。
大量特殊机制的覆盖成本只有验证具体阵容、敌人、技能与关卡后才能估算,现在给出全部完成日期没有依据。
## 程序结构与调度
```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.py`、`progression.py`、`engine.py`、`battles.py` 和两个独立运行时,具体状态见[实施范围](V1_2_IMPLEMENTATION.md#当前实施范围):
- `game_data`:完整资料包、配置摘要、版本匹配与能力查询;不持有账号Token。
- `progression`:任务图、主线/委托步骤分类、地图定位、剧情触发和下一步解释。
- `battle_input`:按客户端构造完整阵容与场景,验证角色实例仍存在且可出战。
- `battle_worker`:独立进程执行AS3内核或已验证的移植内核;只接收本场输入,输出实际事件和战果,不直接调用服务器。
- `battle_orchestrator`:使用当前账号的单一API队列串行发请求,记录开始/执行/结算/核对状态。
- `battle_journal`:本地保存资料版本、输入摘要、随机/操作记录、真实结果、响应摘要与中断位置;不把Token写进可导出记录。
同账号一次只运行一场战斗。计算在独立进程中,不占用Qt线程;API请求仍由现有账号队列统一管理请求编号。
战斗期间要暂停会改变阵容/属性/材料的派遣、喂养、赠礼、装备等冲突操作;其他账号独立运行。
关卡开始、任务步骤或结算请求结果不明确时,先记录待核对并查询现状,不自动重发,也不随意重新开始同一场。
本地尝试ID用于防止本程序重复执行,不代表服务器提供幂等接口。
界面已增加“自动主线”页,展示任务状态、位置、需求、对话、下一步与支持原因;“战斗记录”展示上下文、队伍、结果、模式和原因,耗时等执行证据保存在本地日志中。
仍复用顶部绿色“开启”与红色“停止”,不再增加“仅监控/执行”两套开关。
配置只包含任务范围、可用战队、保留体力、失败停止次数与是否包含委托等偏好,并纳入现有统一导入/导出;服务器通关进度不能靠配置文件设置。
## 本次预研的边界与待验证项
- 已证实:完整静态资料已经进入独立资料包;任务、剧情检查点、补链、收集、委托、编排与界面已实现。原始战斗内核自然完成合成1-1并取得实际统计与检查;实验模型有局部结构准入和合成执行证据。
- 工程边界:原AIR单场成功、实验模型执行与早期普攻估算分别评价;原版能力检查和显式实验模式分开,有限技能及场地支持不能解释为全关卡完成。
- 未验证:完整集成QA、任意实际阵容的原引擎桥接、线上热更新匹配、完整动画/时钟/随机流对拍、实际角色全部加成与服务器接受结算条件。
- 范围:当前方案先覆盖已验证普通关卡和任务战斗。PVP、排行榜/BOSS及特殊活动不纳入首批交付。
- 本轮开发验证未执行真实游戏请求;真实账号接取、开战、结算和领奖验证由用户手动进行。开发分支已加入v1.2自动策略执行编排;未知写请求保持待核对,不自动重放。
下一步:完成实际阵容桥接与原版/模型集成,回填独立QA准确结果,再由用户手动核对本轮实际游戏闭环。验证完成前保持开发版;尚未创建稳定标签或合入main。