M9A 自动化任务完全指南:重返未来:1999 小助手功能总览与配置详解

原创2026-10-13 12:26:232,254 阅读
文章标签:RPAGUI 自动化工作流自动化计算机视觉桌面应用游戏开发

M9A 自动化任务完全指南:重返未来:1999 小助手功能总览与配置详解

M9A 是一个面向《重返未来:1999》的自动化小助手,围绕 MaaFramework(MaaFW)构建。本文以仓库文档 docs/en_us/manual/introduction.md 为主线,系统讲解 M9A 提供的每一项自动化任务分别"做什么"与"有哪些可配置选项",并结合 tasks/*.json 任务定义与 agent/custom/action/*.py 自定义动作源码,说明这些选项在底层是如何生效的。读完本文,你将掌握 M9A 全部任务的适用场景、配置要点与使用前提,能够为自己的日常刷取、肉鸽与独立玩法组合出正确、可复现的任务配置。

一、任务体系概览:任务从配置到执行

M9A 的任务并非硬编码在程序中,而是由三部分协同工作:

  • 任务清单文件(tasks/*.json):每个 JSON 文件声明一个任务的名称、入口节点、所属分组(daily 日常 / standalone 独立运行)以及暴露给用户的可配置选项;
  • 自定义动作(CustomAction)(agent/custom/action/):实现具体逻辑的 Python 类,通过 @AgentServer.custom_action("ActionName") 注册,供 JSON 中的 pipeline 调用;
  • 启动运行时(agent/agent_runtime.py):在任务执行前完成 MaaFW 版本检查与资源热更新,保证 data/ 目录下的活动、关卡、兑换码等数据是最新的。

以"收取荒原"任务为例,tasks/Wilderness.json 声明了 好梦井、魔精收菜、交付订单 三个开关选项;关闭某选项时通过 pipeline_override 把对应子任务的 next 置空来跳过该环节。所有任务的选项都采用这种"开关/下拉/输入框 + pipeline_override"的模式,因此 GUI 上每个选项都能精确映射到运行时的流程改动。

从源码结构看,agent/custom/action/init.py 中的 ACTION_MODULES 列表集中登记了全部动作模块(balanced_farming、combat、depot_maintain、outside_deduction、syndrome_of_silence、switch_account 等),启动时由 register_all() 统一导入注册——这保证了各任务引用的自定义动作在 AgentServer 启动前全部就绪。

二、基础任务:启动与关闭游戏

启动游戏

启动游戏并等待进入主界面,是 M9A 日常流程的起点。执行时自动拉起游戏客户端,并持续等待游戏加载完成进入主界面后才继续后续任务。

警告:该功能暂不支持国际服 PC 端勾选运行。如需在国际服 PC 端使用,请到"软件设置 → 启动设置"修改相关配置。

关闭游戏

关闭游戏进程,通常作为整轮自动化结束后的收尾任务,避免游戏常驻后台占用资源。

警告:与"启动游戏"相同,该功能暂不支持国际服 PC 端勾选运行,如需使用请到"软件设置 → 启动设置"修改相关配置。

三、日常资源:收取荒原

收取荒原产出,将荒原上累积的各类资源一键收齐,包括三个可独立开关的选项:

选项 作用 配置方式
好梦井 收取好梦井产出 开关,开启后执行好梦井打捞
魔精收菜 收取魔精生产物品 开关,开启后收取魔精生产物
交付订单 完成订单交付 开关,开启后自动交付订单

这三个选项在 tasks/Wilderness.json 中分别对应 WildernessGoodDreamWellTask、WildernessProductTask、WildernessTradeTask 三个子任务的启停。

从源码看,"好梦井打捞"并非简单的点击,而是带条件的智能行为:GoodDreamWellFishing(agent/custom/action/wilderness.py)会先 OCR 识别当前好梦井的剩余馈赠更新小时数与可用打捞次数,再按照"≥16 小时且有 4 次可打捞 → 打捞第 4 个位置"的阶梯规则选择打捞目标;条件不满足(如时间不足)时直接返回,不做无效操作。同时 SummonlngSwipe 负责在魔精名片之间滑动完成分派,实现"收菜"。

四、心相日常:每日心相(意志解析)

刷取意志解析的每日免费次数,把当天的心相关卡免费次数用满,包括两个选项:

  • 双重解析加成作战:开启后,如存在双重解析次数,则使用体力进行作战,最大化加成收益;
  • 吃糖:开启后,体力不足时自动使用心相糖果补充体力。

在 tasks/Psychube.json 中,"吃糖"开启后还会展开一组子选项:糖果有效期(24h / 7d / 14d / 无限期)、自定义吃糖次数、连续吃糖、允许体力溢出、关闭吃糖提示,用于精细控制补体策略。源码侧的 PsychubeDoubleTimes(agent/custom/action/combat.py)会实时识别当前 X/4 的加成次数,动态覆盖作战链路的复现次数与胜利跳转,实现"有加成才打、按加成次数打"。

五、刷取核心:智能均衡刷材料

智能均衡刷材料是 M9A 的招牌功能,负责自动判断并刷取紧缺材料。其核心策略是:

  • 开启「库存保持」:按每件材料的目标库存补齐缺口,精确到逐材料;
  • 未开启「库存保持」:退化为"均衡取最少"——自动刷取当前库存数量最少的一种材料(不含洞悉本材料)。

选项详解

  • 库存保持:总开关,默认关闭。开启后才显示下面两项设置:
    • 参与材料:勾选要补的材料,可逐件填写「目标数量」与「吃糖次数」;
  • 吃糖:自动使用糖果补充体力;
  • 自定义作战次数:指定作战次数,关闭时会清空体力(即刷到体力耗尽为止);
  • 掉落统计上报:上报关卡掉落数据,用于社区共享掉落信息。

库存保持的底层实现

从源码看,库存保持是一条完整的"规划-刷新-刷取-记账"闭环(agent/custom/action/depot_maintain.py):

  1. 规划(DepotMaintainPlan):读取 GUI 逐材料目标(target_*)与吃糖次数(candy_*),结合仓库快照(config/warehouse_inventory.json,按账号分桶)计算每种材料的缺口,挑缺口最大的材料交给作战流程;
  2. 刷新(DepotMaintainRefresh):快照缺失或超过 24 小时有效期时,触发一次仓库全量扫描(WarehouseInventory);微尘/利齿子儿等货币材料不在仓库页,则进角色升级页读右上角缩写数字(支持 K/M 后缀换算,如 5M = 5000000);
  3. 刷取与记账(DepotMaintainAccumulate):每局按实际掉落累计(优先读 drop_core 累计,否则自读结算页掉落行),并写回仓库快照,避免任务中断后重复刷取;缺口填满后当前批次收尾,继续补下一种材料,直到全部达标、体力不足或达到轮数上限(单次任务 50 轮)才结束;
  4. 逐材料吃糖:每种材料可单独设置吃糖次数(0 = 不吃糖、N = 最多 N 个、留空 = 跟随全局吃糖设置),每轮动态覆盖 EatCandy / EatCandyStart 节点参数。

仓库配套的测试(tests/test_balanced_farming.py)验证了关键策略:货币类材料与洞悉本(ME/SL/SS/BW 关卡族)默认不参与"均衡取最少",避免"谁最少刷谁"一直往高体力消耗的洞悉本上撞;同时回归验证了数量 OCR 的 ROI 裁剪、图标识别失败不按 0 计等健壮性细节。

六、刷取核心:常规作战

执行常规关卡作战,适用于主线、资源与洞悉关卡的自由刷取。选项包括:

  • 自定义作战关卡:
    • 关闭时,可选择关卡类型(主线 / 资源 / 洞悉),并从预设的常用关卡列表中挑选;
    • 开启时,可输入具体主线关卡编号(如 5-19);
  • 吃糖:自动使用糖果;
  • 自定义作战次数:指定作战次数,关闭时会清空体力;
  • 掉落统计上报:上报关卡掉落数据。

提示:文档特别注明"13 章已更新,欢迎刷取新关卡助力一图流更新"——即新章节关卡数据需要玩家刷取后上报,用于完善社区掉落图鉴。

在 tasks/Combat.json 中,"自定义作战关卡"关闭时按关卡类型(主线/资源/洞悉)展开大量预设关卡选项,每个选项通过 pipeline_override 向 SelectCombatStage 写入具体的 stage(关卡编号)与 level(难度:Story 故事 / Hard 厄险等)。

源码侧的 SelectCombatStage(agent/custom/action/combat.py)会解析如 5-19 这样的编号:拆分主章节与关卡序号、补零为两位、按章节号映射"大章节(卷)"(1-7 → 第 1 卷、8-10 → 第 2 卷、11-13 → 第 3 卷、14+ → 第 4 卷),随后动态覆写主线/资源关卡导航流水线。刷图计数由 TargetCountInit / TargetCountDetermine / TargetCountProgress / TargetCountFinish 组成的状态机控制:识别剩余体力与关卡体力,计算可复现次数,达标后结束,异常时走 TargetCountAbort 兜底回主界面;SwitchCombatTimes 通过模板匹配 SetReplaysTimesX{times}.png 选择复现次数;TeamSelect 支持新版自定义命名编队的 OCR 识别与选择;DropRecognition 在胜利后识别掉落物品并汇总上报。

七、活动刷取:活动代币刷取

刷取活动关卡获取活动代币,包括四个选项:

  • 复刻模式:选择是否为复刻活动;
  • 活动难度:选择活动关卡难度;
  • 吃糖:自动使用糖果;
  • 自定义作战次数:指定作战次数。

警告:主线版本更新期间,关闭复刻模式会直接跳过当前任务。如需刷取主线关卡,请使用"常规作战"功能。

八、高难内容:自动深眠与自动醒梦

自动深眠

自动完成深眠域战斗,适合追求每周深眠奖励的玩家,包括以下选项:

  • 上半编队:选择上半区域使用的编队;
  • 下半编队:选择下半区域使用的编队;
  • 仅领取每周浅眠域奖励:只领取奖励,不进行战斗。

注意:上下半编队不要重复;支持旧版和改版编队;支持编队自定义命名;未来可支持编队超出前四个。

自动醒梦

自动完成醒梦域战斗,包括以下选项:

  • 醒梦上半编队:选择上半区域使用的编队;
  • 醒梦下半编队:选择下半区域使用的编队。

注意:与自动深眠相同——上下半编队不要重复;支持旧版和改版编队;支持编队自定义命名;未来可支持编队超出前四个。

九、资源管理:银行购物

自动在银行购买指定物品,把每周/每月限购资源买齐,包括四个可独立开关的选项:

  • 柜台特奉:购买柜台特奉商品;
  • 低阶柜台:购买低阶柜台商品;
  • 心相观测:购买心相观测;
  • 梦境记述:购买梦境记述。

源码侧的 ModifyBankTaskList(agent/custom/action/bank.py)维护了一张购物清单(免费周礼、兔子、小/小地球仪、饕餮、启蒙一/二、谐振磁带、金瓜子、原味鸡、薯条等 12 项),并按资源区服(cn/tw → 上海时区、en → 纽约时区、jp → 东京时区)判断各项是否已完成(周购看周、月购看月),已完成的项通过 override_pipeline 关闭对应节点以跳过,避免重复购买。BankPurchaseRecord 则把每次检查时间写入 config/m9a_data.json 的账号分桶,作为"本周/本月已购"的判据。

十、奖励领取与兑换码

领取奖励

领取各类奖励,包括五个可独立开关的选项:

  • 领取邮件奖励:收取邮件中的奖励;
  • 领取任务奖励:领取日常、周常任务奖励;
  • 领取吼吼点唱机:领取吼吼点唱机奖励;
  • 活动盒子奖励:领取活动盒子奖励;
  • 迷思海周扫荡奖励:完成雨中悬想·迷思海「寻思」每周扫荡并领取奖励。

源码侧 RewardHandler(agent/custom/action/reward.py)在首次执行时会对固定区域做 OCR 并垂直拼接输出签到日历文本,随后再执行原有点击动作,实现"顺带记录奖励明细"。

使用兑换码

自动输入并使用兑换码,包括一个选项:

  • 自定义兑换码:填写一个或多个兑换码,可用空格、逗号或分号分隔。

注意:已使用过的兑换码会按当前账号自动跳过,不会重复提交。

源码侧的 RedeemCode(agent/custom/action/redeem_code.py)会把自定义码与 data/redeem_code/{resource}.txt 中的官方码合并去重;官方码按区服时区(cn/tw → 上海、en → 纽约、jp → 东京、kr → 首尔)解析截止时间,已过期的自动剔除。已用码记录在 config/m9a_data.json 的 redeem_code 账号分桶中,支持"当前账号维度"的跳过。

十一、账号与外观

切换账号

在账号列表中选择目标账号,支持两种模式:

  • 留空:自动下滑到账号列表底部,切换最后一个账号;
  • 填写目标账号:在账号列表中逐页下滑查找并切换,找不到目标账号则任务失败。

注意:切换后可以继续添加任务,以便多账号多配置运行任务;目前该功能仅支持官服。

源码侧的 SwitchAccountSelect(agent/custom/action/switch_account.py)实现细节颇具代表性:它不依赖图标模板,而是用全屏 OCR 识别掩码账号文本(如 189****6002),行位置一律由识别结果推导,因此不受模拟器 DPI / 分辨率造成的界面缩放影响;翻页滑动起止点也取自已识别到的行坐标,避免滑出面板。目标账号匹配支持精确、包含以及"完整手机号对掩码首尾比对"三种策略。任务定义见 tasks/SwitchAccount.json(仅 官服 资源可用,参数 账号 通过 SwitchAccountSelect 的 custom_action_param.account 传入)。

切换艺术框架

切换主界面艺术框架,可选择以下四种:

  • 手提箱制式(初始)
  • 伊卡洛斯所见
  • 渐弱之心弦
  • 裁纸饰朱梅

十二、局外演绎:黄昏的音序

肉鸽模式刷取信用(黄昏的音序)功能,包括三个选项:

  • 触媒选择:选择使用的触媒(仅在非速刷模式生效,可选术式神灯、石榴心血、精神视界、仪式匕首、曳变灵摆、"一"的诫令、"全"的振歌、点金之石等);
  • 速刷模式:开启后仅使用术式神灯刷取第一层;
  • 演绎难度:选择演绎难度(Current / 具体难度 / 最高难度等)。

速刷模式使用前提

警告:

  1. 使用速刷功能前请先将 刻画生长-指引之歌、刻画生长-建筑章程 点满;
  2. 请尽量调高难度等级(11 难度达到最高信用效率 200%),并点足科技树中的信用效率加成,防止分数不够 2500 导致刷取信物失败。

非速刷模式使用提示

提示:

  1. 使用前可在箱子里置顶(标记)四个角色,作为出战角色;
  2. 队伍配置推荐携带一个奶(治疗位);
  3. 使用前请保证最近一次战斗处于自动战斗状态——M9A 不能检查是否处于自动战斗。

警告:M9A 不对仅在初次玩肉鸽时出现的剧情、引导等做额外处理,使用前需先自行通关一遍。

注意:由于本功能实现较为复杂,容易出现奇怪的问题。如果有条件请开启模拟器的录屏,发现问题时尽量保留足够的信息(debug 以及 logs 目录下所有内容),以便开发者快速定位问题并解决。

源码侧的 SOD_DifficultySelect(agent/custom/action/outside_deduction.py)演示了难度选择的自动实现:参数格式为 {"level": "5,10,11,cur,max"},通过 OCR 识别当前难度,再按"点击左右箭头调整差值"的方式把难度切到目标值;max 模式还会先识别锁定标记,先向右翻到锁定的最高难度,再向左退一格到可选的最高难度。任务定义见 tasks/SeriesOfDusks.json(触媒选择通过模板替换 SODStart_MediaSelect 实现)。

十三、局外演绎:无声综合征

无声综合征肉鸽模式,包括四个选项:

  • 战斗编队:选择使用的战斗编队;
  • 携带好旅伴:选择是否携带好旅伴;
  • 难度选择:选择游戏难度;
  • 配器选择:选择使用的配器。

警告:

  1. M9A 不对仅在初次玩肉鸽时出现的玩法说明页面做处理,请在使用前至少手动打到进入第二层;
  2. M9A 不能检查是否处于自动战斗状态,使用前请保证最近一次战斗处于自动状态。

提示:经实验,最好选择难度 2 或难度 3进行任务,难度 4 容易战斗暴毙。

该功能的实现是仓库中复杂度最高的模块之一(agent/custom/action/syndrome_of_silence.py,约 1500 行)。其核心动作链包括:

  • SOSSelectNode:通过模板匹配 data/sos/nodes.json 中的节点类型(途中偶遇、购物契机、恶战、巧匠之手等),识别事件名,并支持"预览面板 OCR 修正节点类型""跨类型备用 ROI 重读事件名"等自愈逻辑;
  • SOSNodeProcess:按 nodes.json 中配置的动作序列执行节点处理,支持 @common_name 引用与 + 组合的中断(interrupts)解析,以及"事件搁浅"检测(选项界面始终未出现且横幅消失时跳过该事件,连续 3 次则交由恢复流程);
  • SOSShoppingList / SOSBuyItems:对购物列表做 OCR 配对物品名与价格(含"已售出"标记过滤、difflib 名称纠错、80% 相似度判底),再按当前"金雀子儿"余额尽可能多地购买物品。

data/sos/nodes.json 与 data/sos/items.json 是该模式的数据底座,由启动时的资源热更新机制(见 agent/agent_runtime.py 的 _MANIFEST_FEATURE_HINTS)保证随游戏版本同步。

十四、独立运行任务(standalone)

以下任务需要在指定界面单独运行,不可与其他任务组合。请在进入对应界面后再启动,且不要把它们加入日常任务链。

复刻活动推图

根据任务列表完成往期复刻活动推图,选项:

  • 吃糖:自动使用糖果。

注意:本任务根据任务列表完成任务,仅支持已打过的往期活动推图。

匣中交流赛(拓片杂技赛)

完成角斗场第一层扫荡。

警告:请手动打开角斗场页面后再运行此任务。

警铃鸣响时(需高练度)

完成警铃鸣响时扫荡,选项:

  • 扫荡难度:选择扫荡难度。

警告:本功能不换角色、debuff 吃满,故只适合高练队伍挂机。

提示:

  • 推荐配队:三巨头(薪电启)+ 图图石子、追击队;
  • 使用前请手动打开警铃鸣响时主页面(中间有"雨迹追查"和"雨痕处置"字样);
  • 速刷选项:直接打 boss 关,没有五号位 buff,适合大成三巨头 + 双奶妈挂机通关;
  • 非速刷则会拉满五号位 buff 后再打 boss,提高通关稳定性;
  • 测试用队伍:诺谛卡 + 圈 + 蘑菇 + 塞梅 + 图图(注意五号位放主 C)。

活动推图(含主线与活动)

自动推进主线/活动关卡地图,选项:

  • 选择活动:选择当前页面、当期活动或指定往期活动;
  • 推图模式:
    • 故事/主线:自动识别编号旁带灰色星标的未完成关卡并依次推进,推完后会自动尝试小径任务;
    • 探索模式:活动后期开放;若当前在故事页会先切换到探索模式,主线地图无探索模式时自动跳过;
  • 吃糖:体力耗尽时自动使用糖果。

警告:使用前请先手动进入活动/主线关卡地图页再运行本任务;遇到小游戏、特殊教程等无法自动处理的界面时任务会自动停止(出错截图见 debug/on_error),请手动完成后回到关卡地图页重新运行即可继续。

翻斗棋速刷

在翻斗棋界面快速刷取。

警告:在翻斗棋界面启动;已支持国服 3.5 版本;使用前请先自行打两把使警戒值升到 3 级。

雨前漫游指南

完成雨前漫游指南小游戏,选项:

  • 雨前漫游刷取模式:根据教程进度选择对应模式。

警告:该任务需单独运行,运行前请将游戏停在小游戏主页面。

注意:该任务分为两种情况:

  1. 未击败教程中第三天的 boss(即点击"开始模拟"后不是难度选择界面);
  2. 已击败教程中第三天的 boss(即点击"开始模拟"后进入难度选择界面)。 请根据个人情况选择对应选项。

UTTU 闪烁集会

自动推进 UTTU 闪烁集会关卡。

警告:请在 UTTU 每阶段第一层配置好队伍后启动;自动打四层,试用角色下一层会自动下阵,请使用自己的角色。

完全归纳法

完成完全归纳法小游戏。

警告:该任务需单独运行,运行前请将游戏停在小游戏主页面。

注意:请先手动打一轮过教程,然后在小游戏"开始研究"按钮所在界面开始任务。

8-bit 街机秀

完成 8-bit 街机秀小游戏,选项:

  • 关卡难度:选择关卡难度;
  • 刷取模式:根据需求选择刷取模式。

警告:该任务需单独运行,运行前请将游戏停在选择难度页面。

注意:该任务分为两种情况:

  1. 通关第一层后直接退出(稳定);
  2. 尽力打(即通关第一层后不退出一直打)。 请根据个人情况选择对应选项。

角色升级(beta)

进入角色详情页后自动升级(共鸣 + 角色等级),直至材料不足或升满(洞悉 3 / 共鸣 9),选项:

  • 吃糖:体力不足时自动使用糖果。

警告:使用前请手动进入角色详情页(显示"个人属性");仅支持刷取属性突破材料,非属性突破材料需手动刷取;该任务为 beta 功能,如遇问题请反馈。

信任奖励

在主界面启动后,自动进入角色列表,按信任降序排列并逐个领取已解锁信任奖励的角色的单品/文化奖励。

注意:请在主界面开始任务。会自动按信任降序排列并遍历所有角色,解锁信任奖励的角色会自动领取其单品/文化奖励。

十五、资源热更新与任务数据保障

M9A 的任务数据(活动关卡、战斗掉落索引、兑换码、无声综合征节点表等)并非写死,而是通过启动时的资源热更新机制保持与游戏版本同步。在 agent/agent_runtime.py 中,_hot_update() 依据 config/hot_update.json(默认开启)先做 manifest 时间戳检查,再按清单增量下载资源文件;_MANIFEST_FEATURE_HINTS 把每个数据清单映射到受影响的功能(如 data/activity/manifest.json → 活动代币刷取/复刻活动、data/combat/manifest.json → 常规作战、data/redeem_code/manifest.json → 使用兑换码、data/sos/manifest.json → 局外演绎:无声综合征),热更新失败时会在日志中明确告知"哪些功能仍在使用旧数据"及重试方式。这解释了为什么上述任务的关卡列表、兑换码与肉鸽数据能随版本自动更新,玩家通常无需手动维护。

十六、使用建议与排障要点

综合文档中的各类提示,可总结出几条通用实践:

  1. 尊重"独立运行"约束:所有 standalone 任务(第十四节列出的 11 项)都必须在指定界面单独启动,加入日常任务链会导致流程错乱;
  2. 先手动过一遍"首次内容":黄昏的音序、无声综合征、完全归纳法、雨前漫游指南等玩法都有"仅首次出现"的剧情/教程/说明页面,M9A 不做额外处理,使用前须手动完成一次;
  3. 自动战斗前提:肉鸽类任务(黄昏的音序、无声综合征)依赖"最近一次战斗处于自动战斗状态",M9A 无法自检,务必自行确认;
  4. 保留排障信息:遇到问题(尤其是黄昏的音序这类复杂功能)时,保留 debug 与 logs 目录下所有内容,并优先开启模拟器录屏,便于开发者定位;
  5. 出错截图的取证位置:活动推图遇到无法处理的小游戏/教程时任务会停止,出错截图保存在 debug/on_error,手动完成后回到关卡地图页重新运行即可续推。

结语

M9A 的自动化能力覆盖了《重返未来:1999》日常刷取、高难内容、肉鸽演绎与各类独立小游戏的绝大多数场景。通过"任务 JSON 声明选项 + 自定义动作实现逻辑 + 资源热更新保障数据"的分层架构,每个 GUI 选项都能精确映射到底层 pipeline 的覆写,也让社区得以通过数据文件持续适配新版本与新活动。本文以 docs/en_us/manual/introduction.md 为骨架,结合 tasks/ 任务定义与 agent/custom/action/ 源码对各项任务的配置语义与实现原理做了展开,希望能帮助你在配置 M9A 任务链时更准确地理解每个选项的用途与限制。

登录后查看全文
M9A