MAA 明日方舟助手

定义

MAA 明日方舟助手是一款面向手机游戏《明日方舟》的第三方辅助软件,其名称缩写来自英文全称 MAA Assistant Arknights^[1]。按照项目用户协议中的界定,它由 MAA Team 开发,以 AGPL-3.0 许可证在 GitHub 平台开源,并通过自动打包流程提供二进制文件下载。

软件的功能指向游戏内的重复性日常:消耗理智刷取关卡并识别掉落、安排基建换班、自动处理公开招募、访问好友与领取日常奖励等^[2]。这些操作原本需要玩家长时间在界面上反复点击,MAA 将其整合为可一键执行的任务序列。

从运行形态看,MAA 需要与游戏画面建立连接,可由电脑上的安卓模拟器或真机提供画面,并以桌面客户端或命令行方式驱动^[1]。软件本体免费,项目方在说明中将其定位为学习交流用途^[3]。

原理

MAA 的技术路线是“看屏幕、发指令”,并不读写游戏进程内存,也不修改客户端文件^[4]。它先截取游戏画面,依据模板匹配定位当前所处的界面与按钮位置,再借助安卓触控协议向模拟器或设备发送点击、滑动等事件,从而推进游戏流程^[4]。

根据项目公开的致谢与依赖列表,其图像处理使用 OpenCV,文字识别使用 PaddleOCR,深度学习部署依赖 FastDeploy 与 onnxruntime,地图格子识别使用 Arknights-Tile-Pos,安卓触控事件由 Minitouch 生成^[3]。核心引擎以 C++ 编写,界面层在 Windows 上采用 WPF 与 Stylet 框架,日志与 JSON 处理分别使用 Serilog 和 Newtonsoft.Json 等库^[3]。

任务逻辑与识别逻辑彼此分离。每个功能在程序内部被拆成由识别节点和动作节点连接而成的流程,这些流程以明文 JSON 资源文件的形式随安装目录发布,失败时按设定重试,超出次数则记录错误并保存截图^[4]。这种数据驱动的结构使适配新活动或新服务器大多只需补充截图并修改配置,而不必改动程序主体^[1]。

关卡掉落、公开招募等统计数据可上传至企鹅物流、一图流等第三方统计站点,用于社区层面的掉落概率与招募结果汇总^[2]。软件还支持导入 JSON 格式的作业文件,按预设的干员部署与技能释放顺序完成关卡^[1]。

发展历程

项目的核心框架名为 MaaCore,面向 Windows、macOS、Linux 桌面平台,并按国服、国际服、日服、韩服、繁中服分别维护资源^[5]。早期版本的说明文档中,外服仅适配战斗、信用购物、访问好友、自动肉鸽等基础功能,项目方解释原因在于外服用户数量与人力有限^[6]。

此后外服支持范围逐步扩大,国际服(美服)、日服、韩服、繁中服的绝大部分功能被列为已支持,但项目方同时注明这些功能测试不如国服充分^[1]。国际服因界面布局差异,仅支持 1920×1080 一种分辨率^[3]。

围绕主程序,社区形成了若干关联项目,包括新一代自动化框架 MaaFramework、深度学习项目 MaaAI、用于分享作战方案的作业站,以及官网与文档站的前后端^[7]。其中 MaaFramework 将图像识别与模拟控制的思路抽象为通用能力,被用于其他游戏的自动化助手^[8]。

版本迭代以修复识别准确率与适配版本更新为主。公开的更新记录显示,某次版本更新提升了技能就绪识别准确率,并增加了关卡未解锁、剿灭未启用全权代理等场景的提前停止检查,同时适配了当时的周年活动界面^[9]。用户协议页面显示的最后更新日期为 2025 年 5 月 10 日,协议版本为 1.0。

应用

MAA 的典型用法是让它在模拟器或已连接的设备上连续执行一条任务链,完成当日需要重复操作的环节,包括理智作战、基建换班、公开招募、信用收取与购物、日常奖励领取^[1]。集成战略模式亦支持自动刷取源石锭与等级,并识别干员及其练度^[1]。

辅助功能还包括干员与材料信息的整理:识别干员列表后统计已拥有与未拥有的干员及潜能,识别养成材料后可导出至刷图规划与培养表类工具^[2]。这部分能力使软件不仅承担重复点击,也承担游戏内数据的读取与导出。

对开发者而言,MAA 对外提供 C、Python、Java、Rust、Golang、Dart、TypeScript 等语言接口以及 HTTP 接口,并附带集成文档、回调消息协议、任务流程协议与自动抄作业协议,可在自有程序中调用其执行游戏任务^[7]。命令行版本可在 Linux、macOS、Windows 上运行,适用于无图形界面的服务器环境或自动化脚本^[1]。

在合规安排上,项目用户协议对使用场景作出限定,例如要求不得在游戏官方账号的评论区、弹幕等交互区域讨论或传播与该软件相关的内容,并规定反馈仅通过 GitHub 按模板提交。软件 Logo 不适用 AGPL-3.0 协议,其权利由画师与开发团队保留。

局限

作为第三方工具,MAA 的使用与游戏运营方的条款之间的关系由玩家自行承担,项目方在协议中并未取得游戏厂商的授权或合作关系,并明确禁止对外宣称与 MAA Team 存在合作关系。

识别方式本身带来稳定性上限。软件依赖画面模板与文字识别判断界面状态,当游戏版本更新界面样式、调整文案或新增活动页面时,原有模板可能失效,需要重新采集素材并更新资源^[1]。分辨率与画面比例同样构成约束,国际服仅支持 1920×1080 即是一例^[3]。

外服功能覆盖虽然较广,但项目方说明由于外服用户较少、人手不足,许多功能缺乏全面测试^[1]。此外,软件面向的是流程固定的日常任务,判断与决策仍以资源文件中预设的规则为准,不涉及对局策略层面的自主规划^[4]。

分发渠道同样存在限制。项目方声明软件开源免费,若出现第三方以该软件提供收费代练服务的情形,相关问题与后果不由软件方承担^[3]。

参见

• 明日方舟 —— 该软件所辅助的手机游戏,由鹰角网络开发。

• MaaFramework —— 由 MAA Team 开发的通用自动化框架,把图像识别与模拟控制能力抽象为可复用组件。

• OpenCV —— 该软件用于图像模板匹配的开源计算机视觉库。

• PaddleOCR —— 该软件用于识别界面文字的开源文字识别工具。

• 光学字符识别 —— 从图像中提取文字的技术,是该软件判断界面状态的依据之一。

• AGPL-3.0 —— 该软件发布所采用的开源许可证。