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