# v1.2 预研:主线任务、普通挑战与战斗委托 日期:2026-11-08。基线:辅助 v1.1.1、原始 Android APK 1.9.68。 状态:已完成配置恢复和重点调用链研究,并运行了离线普攻估算原型;忠实执行原始规则的独立战斗引擎尚未跑通,未提交模拟挑战或验证服务器接受结果。 实验安排:按用户本轮授权,离线解析、运行壳和战斗实验直接推进,无需再次确认。预研中的真实账号接任务、开战、结算与领奖由用户手动操作;本轮不自动进行联网游戏实验。 新增的[离线实验与实机采样说明](V1_2_OFFLINE_EXPERIMENT.md)记录了可运行的函数、示例结果和本地对比流程。它是有限机制的估算实验,不能替代下面 P1/P2 要求的原引擎运行与对拍。 ## 可行性结论 **有技术可行性,但需要恢复一个能够执行原始规则的战斗引擎。任务接取接口不是主要难点。** 手机可以不启动游戏;电脑辅助仍需登录并与服务器通信。电脑侧可以负责选择任务、准备阵容、运行战斗、提交实际结果、核对任务进度,再继续下一步。 战斗必须能够自然得到胜利、失败或超时;强度不够时应停下或等待培养。按原始规则运行不代表任何阵容都能推过主线。 本次确认了客户端会在本地创建战场、执行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运行壳尚未执行。新增 Python 普攻估算实验只覆盖下文列明的有限机制;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及特殊活动不纳入首批交付。 - 本轮工具不自动登录真实账号或发送任务/战斗写请求;用户手动运行手机游戏,电脑被动记录指定接口。采样准备包括本机代理、USB转发和公开CA证书传输;没有改动1.1.1的辅助执行逻辑。 下一步建议:完成“一场离线普通战斗的忠实运行与对拍”,再开展联网挑战和任务闭环。