Files
myrzx_bot/analysis/V1_2_TASK_RESEARCH.md
T

101 lines
28 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
**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`。线上热更新实际开关仍未知。用户补充要求预研中的线上账号操作由本人手动执行,离线实验可直接推进。