28 KiB
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。这些是任务层的现有能力,本笔记没有核对其导入的其他辅助模块内部实现。
以下是设计建议,全部属于推断/建议,不是本次已实现的能力。
- 分别记录解锁、已接取、当前步骤、等待交互/剧情、等待合法战斗、可领奖、已领取、过期。 保留
taskId/typeId/curStep/stepValue和配置完整度;未知字段不能填成空剧情。整任务领奖后消费返回的新任务及解锁,再重新规划,避免重复接取。依据 E01、E03—E07、E14、E17。 - 把战斗上下文交给主代理的战斗边界,任务层只提供意图。 意图至少区分普通关卡、任务
battle、任务passStage、为累计目标安排普通挑战。结果作为不透明对象传递;成功时按原始上下文选择唯一结算入口,任务战斗不能再额外普通battleEnd。失败/中断返回独立状态,不自动推进步骤。依据 E08—E11、E15。 - 每次计划只执行一个状态改变动作,收到可信结果或已有状态更新后再规划。 同一接口/任务保持串行;
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;失败和幂等规则仍未知。 - 先处理可达性和任务截获,再安排普通挑战。 校验城市、难度、步骤条件、引导和当前剧情;位置匹配后可能只完成任务交互,应返回规划器而非继续假定普通战斗已发生。自动任务补链依实际配置的
nextTasks/unlockTasks和响应,不靠编号。依据 E05—E07、E10、E12—E16。 - 委托按剩余接取次数和当日时限安排。 截止前给已接可完成任务留出战斗、后续剧情和领奖时间;跨日后废弃旧计划并依刷新状态重建。开关应分别表达“允许接取战斗任务”和“战斗执行能力可用”,接取前评估后续剧情及配置完整度。资源预约规则继续覆盖后续任务步骤。依据 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。线上热更新实际开关仍未知。用户补充要求预研中的线上账号操作由本人手动执行,离线实验可直接推进。