Add v1.2 development quest progression and experimental battle runtime

This commit is contained in:
AttilaNet
2026-11-08 19:29:28 +08:00
parent 79b7672471
commit 0d3e231cde
71 changed files with 14349 additions and 172 deletions
+31 -22
View File
@@ -1,21 +1,31 @@
# v1.2 预研:主线任务、普通挑战与战斗委托
# v1.2 方案与实施状态:主线任务、普通挑战与战斗委托
日期:2026-11-08。基线:辅助 v1.1.1、原始 Android APK 1.9.68。
状态:已完成配置恢复和重点调用链研究,并运行了离线普攻估算原型;忠实执行原始规则的独立战斗引擎尚未跑通,未提交模拟挑战或验证服务器接受结果。
状态更新: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_OFFLINE_EXPERIMENT.md)记录了可运行的函数、示例结果和本地对比流程。它是有限机制的估算实验,不能替代下面 P1/P2 要求的原引擎运行与对拍。
当前交接与准确验证记录见[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与技能,再从战场状态生成结算数据。
但源码只能说明客户端行为,不能证明服务器不做额外校验,也不能证明一个尚未实现的替代引擎会被服务器接受。
但源码和局部离线执行只能说明对应客户端行为,不能证明服务器不做额外校验,也不能证明现有实验模型的结果会被服务器接受。
这是后续联调需要验证的条件,不能用扫荡的简化数据代替普通挑战数据。
## 本次已经确认的证据
@@ -25,7 +35,7 @@
| 原始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) |
| 预研起点的辅助资料不完整 | 既有精简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) |
@@ -83,15 +93,15 @@ REA归档检查的父证据为 `ev_3bb779224b3b2f1754b820542d4efc08d829f6da1e106
证据:[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、资源和展示入口 | 优先验证;还没有成功运行的原型 |
| 将战斗逻辑逐步移植到独立工作进程 | 能满足长期无需手机、无需完整游戏客户端的目标;需要覆盖度管理和严格对拍 | 运行壳验证后再确定范围;不可承诺一次覆盖全部技能 |
| 原始AS3/AIR战斗内核加独立运行壳 | 更适合保持原有逻辑和数值语义,也可作为其他实现的对照基准;需补依赖并切开登录、平台SDK、资源和展示入口 | 原始BattlePanel已自然完成合成1-1;实际阵容桥接及广泛能力仍待验证,尚不能据此认定支持全部原版战斗 |
| 将战斗逻辑逐步移植到独立工作进程 | 能满足长期无需手机、无需完整游戏客户端的目标;需要覆盖度管理和严格对拍 | 独立Python实验模型已实现并接入编排,38项模型测试;近似与遗漏明确披露,完整集成和原引擎对拍待完成 |
| 直接把完整游戏SWF交给替代播放器 | 依赖AIR接口、显示列表、资源和原生扩展的兼容性 | 本次不能认定可用,也不作为交付前提 |
AIR官方ADL文档支持开发期运行SWF,并提供命令行模式;但命令行模式的 `stage` 为null、没有显示列表。
@@ -102,8 +112,7 @@ AIR官方ADL文档支持开发期运行SWF,并提供命令行模式;但命
Ruffle官方兼容性页仍将AS3语言与API兼容性分别列为未全覆盖;这也不能直接推出本游戏可运行或一定不可运行,必须做本游戏的兼容性验证。
来源:[Ruffle兼容性说明](https://ruffle.rs/compatibility)。
当前PATH可发现Java,但未发现ADL、mxmlc或FFDec命令;这只是PATH范围内的观察,不等同于整机没有安装。
AS3运行壳尚未执行。新增 Python 普攻估算实验只覆盖下文列明的有限机制;AS3运行壳仍是下一阶段的工程验证项。
预研初期的PATH检查只发现Java;后续已准备本地AIR运行资源并执行合成离线战斗,最新依赖与运行证据见[原引擎技术记录](V1_2_RUNTIME_IMPLEMENTATION.md)。早期Python普攻估算仍是独立研究工具,不是当前应用的实验战斗模型。
## v1.2 分阶段实施方案
@@ -116,8 +125,8 @@ AS3运行壳尚未执行。新增 Python 普攻估算实验只覆盖下文列明
| P4 主线和委托调度 | 主线接取、步骤推进、地图挑战、任务专属战斗、提交与领奖;恢复未完成步骤 | 覆盖一个包含非战斗和战斗步骤的任务链;战斗完成后再核对任务状态,不凭本地胜利预先推进 |
| P5 扩大覆盖与多账号 | 扩充技能、场景和事件覆盖;独立工作进程、配置导出、诊断与任务界面 | 大列表和战斗不阻塞Qt;角色互不串数据;遇不支持内容、实际战败或资源不足时按策略停止 |
推荐先交付P0的任务可视化和P1的离线战斗验证,再评估P2/P3的工作量。
若独立运行壳与原引擎对拍尚未通过,v1.2就不应宣称已经支持完整自动推主线。
当前进度:P0资料和任务可视化已实现;P1取得原AIR合成单场自然完成证据,实际阵容输入仍待完成;P2已有有限机制实验模型,原引擎严格对拍待完成;P3/P4的普通地图、任务和委托编排及模拟测试已实现,真实账号闭环未验收;P5的进程、配置和界面已接入,完整QA及覆盖扩展继续进行。各阶段具体交接见[实施记录](V1_2_IMPLEMENTATION.md#阶段交接与后续验收)。
当前局部运行与测试不构成完整自动推主线的验收。
大量特殊机制的覆盖成本只有验证具体阵容、敌人、技能与关卡后才能估算,现在给出全部完成日期没有依据。
## 程序结构与调度
@@ -136,7 +145,7 @@ flowchart TD
C --> Q
```
建议的模块边界:
原方案的模块边界如下;当前实现映射为 `game_data.py`、`progression.py`、`engine.py`、`battles.py` 和两个独立运行时,具体状态见[实施范围](V1_2_IMPLEMENTATION.md#当前实施范围):
- `game_data`:完整资料包、配置摘要、版本匹配与能力查询;不持有账号Token。
- `progression`:任务图、主线/委托步骤分类、地图定位、剧情触发和下一步解释。
@@ -150,16 +159,16 @@ flowchart TD
关卡开始、任务步骤或结算请求结果不明确时,先记录待核对并查询现状,不自动重发,也不随意重新开始同一场。
本地尝试ID用于防止本程序重复执行,不代表服务器提供幂等接口。
界面增加“自动主线”页,展示已完成/进行中/可接取/条件不足/不支持的任务和下一步;“战斗记录”展示本场队伍、胜负、耗时和阻塞原因。
界面已增加“自动主线”页,展示任务状态、位置、需求、对话、下一步与支持原因;“战斗记录”展示上下文、队伍、结果、模式和原因,耗时等执行证据保存在本地日志中。
仍复用顶部绿色“开启”与红色“停止”,不再增加“仅监控/执行”两套开关。
配置只包含任务范围、可用战队、保留体力、失败停止次数与是否包含委托等偏好,并纳入现有统一导入/导出;服务器通关进度不能靠配置文件设置。
## 本次预研的边界与待验证项
- 已证实:原APK身份、配置可以恢复、本地战斗核心与统计采集入口、普通地图/任务分流,以及当前辅助资料被精简的事实。
- 工程推断:完整输入、时序、技能与依赖补齐后,独立执行原始规则有可行路径;普攻估算原型已经运行,尚不能证明原始战斗机制的覆盖、准确性和速度。
- 未验证:当前线上热更新与APK的差异、独立运行壳的兼容性、动画与时钟完整迁移、随机流复现、具体账号的所有加成是否完整可得、服务器接受真实独立战斗结果的条件。
- 已证实:完整静态资料已经进入独立资料包;任务、剧情检查点、补链、收集、委托、编排与界面已实现。原始战斗内核自然完成合成1-1并取得实际统计与检查;实验模型有局部结构准入和合成执行证据。
- 工程边界:原AIR单场成功、实验模型执行与早期普攻估算分别评价;原版能力检查和显式实验模式分开,有限技能及场地支持不能解释为全关卡完成。
- 未验证:完整集成QA、任意实际阵容的原引擎桥接、线上热更新匹配、完整动画/时钟/随机流对拍、实际角色全部加成与服务器接受结算条件。
- 范围:当前方案先覆盖已验证普通关卡和任务战斗。PVP、排行榜/BOSS及特殊活动不纳入首批交付。
- 本轮工具不自动登录真实账号或发送任务/战斗写请求;用户手动运行手机游戏,电脑被动记录指定接口。采样准备包括本机代理、USB转发和公开CA证书传输;没有改动1.1.1的辅助执行逻辑。
- 本轮开发验证未执行真实游戏请求;真实账号接取、开战、结算和领奖验证由用户手动进行。开发分支已加入v1.2自动策略执行编排;未知写请求保持待核对,不自动重放。
下一步建议:完成“一场离线普通战斗的忠实运行与对拍”,再开展联网挑战和任务闭环。
下一步:完成实际阵容桥接与原版/模型集成,回填独立QA准确结果,再由用户手动核对本轮实际游戏闭环。验证完成前保持开发版;尚未创建稳定标签或合入main。