M9A 自动化任务完全指南:重返未来:1999 小助手功能总览与配置详解
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):
- 规划(DepotMaintainPlan):读取 GUI 逐材料目标(
target_*)与吃糖次数(candy_*),结合仓库快照(config/warehouse_inventory.json,按账号分桶)计算每种材料的缺口,挑缺口最大的材料交给作战流程; - 刷新(DepotMaintainRefresh):快照缺失或超过 24 小时有效期时,触发一次仓库全量扫描(
WarehouseInventory);微尘/利齿子儿等货币材料不在仓库页,则进角色升级页读右上角缩写数字(支持 K/M 后缀换算,如 5M = 5000000); - 刷取与记账(DepotMaintainAccumulate):每局按实际掉落累计(优先读 drop_core 累计,否则自读结算页掉落行),并写回仓库快照,避免任务中断后重复刷取;缺口填满后当前批次收尾,继续补下一种材料,直到全部达标、体力不足或达到轮数上限(单次任务 50 轮)才结束;
- 逐材料吃糖:每种材料可单独设置吃糖次数(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 / 具体难度 / 最高难度等)。
速刷模式使用前提
警告:
- 使用速刷功能前请先将
刻画生长-指引之歌、刻画生长-建筑章程点满;- 请尽量调高难度等级(11 难度达到最高信用效率 200%),并点足科技树中的信用效率加成,防止分数不够 2500 导致刷取信物失败。
非速刷模式使用提示
提示:
- 使用前可在箱子里置顶(标记)四个角色,作为出战角色;
- 队伍配置推荐携带一个奶(治疗位);
- 使用前请保证最近一次战斗处于自动战斗状态——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 实现)。
十三、局外演绎:无声综合征
无声综合征肉鸽模式,包括四个选项:
- 战斗编队:选择使用的战斗编队;
- 携带好旅伴:选择是否携带好旅伴;
- 难度选择:选择游戏难度;
- 配器选择:选择使用的配器。
警告:
- M9A 不对仅在初次玩肉鸽时出现的玩法说明页面做处理,请在使用前至少手动打到进入第二层;
- 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 级。
雨前漫游指南
完成雨前漫游指南小游戏,选项:
- 雨前漫游刷取模式:根据教程进度选择对应模式。
警告:该任务需单独运行,运行前请将游戏停在小游戏主页面。
注意:该任务分为两种情况:
- 未击败教程中第三天的 boss(即点击"开始模拟"后不是难度选择界面);
- 已击败教程中第三天的 boss(即点击"开始模拟"后进入难度选择界面)。 请根据个人情况选择对应选项。
UTTU 闪烁集会
自动推进 UTTU 闪烁集会关卡。
警告:请在 UTTU 每阶段第一层配置好队伍后启动;自动打四层,试用角色下一层会自动下阵,请使用自己的角色。
完全归纳法
完成完全归纳法小游戏。
警告:该任务需单独运行,运行前请将游戏停在小游戏主页面。
注意:请先手动打一轮过教程,然后在小游戏"开始研究"按钮所在界面开始任务。
8-bit 街机秀
完成 8-bit 街机秀小游戏,选项:
- 关卡难度:选择关卡难度;
- 刷取模式:根据需求选择刷取模式。
警告:该任务需单独运行,运行前请将游戏停在选择难度页面。
注意:该任务分为两种情况:
- 通关第一层后直接退出(稳定);
- 尽力打(即通关第一层后不退出一直打)。 请根据个人情况选择对应选项。
角色升级(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 → 局外演绎:无声综合征),热更新失败时会在日志中明确告知"哪些功能仍在使用旧数据"及重试方式。这解释了为什么上述任务的关卡列表、兑换码与肉鸽数据能随版本自动更新,玩家通常无需手动维护。
十六、使用建议与排障要点
综合文档中的各类提示,可总结出几条通用实践:
- 尊重"独立运行"约束:所有 standalone 任务(第十四节列出的 11 项)都必须在指定界面单独启动,加入日常任务链会导致流程错乱;
- 先手动过一遍"首次内容":黄昏的音序、无声综合征、完全归纳法、雨前漫游指南等玩法都有"仅首次出现"的剧情/教程/说明页面,M9A 不做额外处理,使用前须手动完成一次;
- 自动战斗前提:肉鸽类任务(黄昏的音序、无声综合征)依赖"最近一次战斗处于自动战斗状态",M9A 无法自检,务必自行确认;
- 保留排障信息:遇到问题(尤其是黄昏的音序这类复杂功能)时,保留
debug与logs目录下所有内容,并优先开启模拟器录屏,便于开发者定位; - 出错截图的取证位置:活动推图遇到无法处理的小游戏/教程时任务会停止,出错截图保存在
debug/on_error,手动完成后回到关卡地图页重新运行即可续推。
结语
M9A 的自动化能力覆盖了《重返未来:1999》日常刷取、高难内容、肉鸽演绎与各类独立小游戏的绝大多数场景。通过"任务 JSON 声明选项 + 自定义动作实现逻辑 + 资源热更新保障数据"的分层架构,每个 GUI 选项都能精确映射到底层 pipeline 的覆写,也让社区得以通过数据文件持续适配新版本与新活动。本文以 docs/en_us/manual/introduction.md 为骨架,结合 tasks/ 任务定义与 agent/custom/action/ 源码对各项任务的配置语义与实现原理做了展开,希望能帮助你在配置 M9A 任务链时更准确地理解每个选项的用途与限制。