Files
myrzx_bot/analysis/V1_2_TASK_RESEARCH.md

28 KiB
Raw Permalink Blame History

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。线上热更新实际开关仍未知。用户补充要求预研中的线上账号操作由本人手动执行,离线实验可直接推进。