Files
myrzx_bot/analysis/V1_2_PLAN.md
T

164 lines
18 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。基线:辅助 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的辅助执行逻辑。
下一步建议:完成“一场离线普通战斗的忠实运行与对拍”,再开展联网挑战和任务闭环。