MAA：明日方舟一键长草与自动战斗的完整上手指南-酒店常州论坛

MAA：明日方舟一键长草与自动战斗的完整上手指南

【免费下载链接】MaaAssistantArknights《明日方舟》小助手，全日常一键长草！| A one-click tool for the daily tasks of Arknights, supporting all clients.项目地址: https://gitcode.com/GitHub_Trending/ma/MaaAssistantArknights

清晨打开模拟器，点一下"开始"，MAA 便自动完成公招、基建换班、材料作战、信用收支与日常奖励领取，全程无需盯着屏幕。MAA（MaaAssistantArknights）是一款免费开源的《明日方舟》自动化助手，它基于图像识别与 ADB 控制，把重复的日常流程收敛成一个"一键长草"按钮，并覆盖 Windows、macOS 与 Linux 平台及多个外服客户端。

项目速览：MAA 是什么、给谁用

它是什么：基于图像识别的游戏自动化小助手，核心（MaaCore）为 C++ 实现，GUI 提供 Windows（WPF）与 macOS 版本，无图形界面的环境可用 maa-cli 命令行版。
给谁用：想减少日常重复操作的《明日方舟》玩家；也适合希望把"自动打日常"集成进自己程序的开发者，项目提供 C、Python、Java、Rust、Golang 等多语言接口。
核心解决的三件事：
1. 全日常一键长草：访问好友、收信用、购物、领奖、公招、基建换班、理智作战串联执行。
2. 战斗自动化：按作业 JSON 自动编队、下干员、挂机，支持理智作战与集成战略（肉鸽）全自动。
3. 数据识别：干员列表、仓库材料、公招结果的识别与统计，并可导出到第三方规划工具。

能力全景：按使用目标看 MAA

日常长草：从唤醒到领奖一次跑完

"一键长草"页签把开始唤醒、自动公招、基建换班、理智作战、信用收支、领取奖励等任务排成一条流水线。用复选框勾选想执行的任务，拖拽调整顺序，每个任务右侧的齿轮图标可展开独立设置。完成后按配置回到模拟器或主菜单，适合每天只点开一次游戏的玩家。

战斗与作业：从理智刷图到肉鸽全自动

理智作战支持掉落识别，把打什么图、掉什么材料记录在案并上传到企鹅物流等数据平台。自动战斗可导入社区作业 JSON，MAA 自动编队、部署、切换干员并挂机，运行日志实时显示每一步动作。集成战略模式下，MAA 自动刷源石锭和等级，处理通宝交换等界面流程。

基建与公招：自动排班和刷招募

基建换班会计算干员效率并自动调整岗位，支持跨设施组合，也接受自定义排班配置。自动公招可连续刷新，识别招募标签后自动确认或等你手动选择（高星结果可人工判断），支持使用加急许可一次刷完。识别结果会显示在日志区，方便回溯每次公招出了谁。

数据与识别：干员、仓库和材料盘点

"小工具"页签提供公招识别、干员识别、仓库识别等独立功能。干员识别列出已拥有干员、等级与潜能；仓库识别盘点养成材料数量，并支持一键导出到刷图规划、方舟工具箱等外部工具，刷材料前先看看库存能少走不少弯路。

跑通它：从安装到第一次运行的最短路径

确认环境：Windows 需 10/11 系统；模拟器分辨率设为横屏1280x720或1920x1080（美服必须1920x1080）。在模拟器和设备支持文档中确认所用模拟器的支持情况。
获取软件：从官方下载页获取与平台匹配的完整压缩包（Windows 一般选win-x64），或在终端执行winget install maa；Linux/macOS 用户安装 maa-cli。也可以获取源码自行编译：git clone https://gitcode.com/GitHub_Trending/ma/MaaAssistantArknights。
安装：Windows 版将压缩包完整解压到无需管理员权限的普通目录（不要放C:\、Program Files），先以管理员身份运行DependencySetup_依赖库安装.bat安装 Visual C++ 运行库，再双击MAA.exe启动。
初始配置：运行一个模拟器并确认没有其他安卓设备连接，MAA 会跟随设置向导自动检测 ADB 路径与连接地址；资源包在启动时自动检查更新，无需手动下载。检测失败时参阅连接设置手动填写 ADB 路径与端口。
第一次长草：在任务列表中勾选需要的任务，点击开始，观察日志区逐步执行。

玩得更深：按需选用的进阶玩法

以下都不是必须项，按需取用即可。

自定义任务流程：MAA 的任务链由 JSON 描述，协议字段见任务流程协议，可用 VS Code 的 Maa Pipeline Support 扩展辅助编辑。想加一个自定义步骤（比如先关某个弹窗再跑日常），改 JSON 即可，不必写代码。
多开管理：把 MAA 文件夹复制多份，各实例共用同一个adb.exe、填写不同的连接地址，即可同时操作多个模拟器实例。多开端口的查看方法在连接设置中按模拟器逐一给出。
跨平台使用：桌面端覆盖 Windows 与 macOS（详见 macOS 文档）；Linux、无图形界面服务器及自动化脚本场景用 maa-cli，安装方式见 CLI 安装文档。
程序化集成：把 MAA 当成一个库来调用。C 接口、Python 接口、Golang 接口、Rust、Java、Dart、Woolang 均有现成封装，回调消息与任务协议在 docs/zh-cn/protocol/ 下有完整说明。
外服客户端：国际服、日服、韩服、繁中服大部分功能已支持，在"运行设置 - 客户端类型"中选择对应版本；外服适配方法见外服适配教程。

排坑清单：常见问题与处理

MAA 无法启动、报错或闪退定位：多数情况是 Visual C++ 运行库缺失或过期，这是出现频率最高的问题。处理：运行 MAA 目录下的DependencySetup_依赖库安装.bat，或手动安装 Visual C++ 可再发行程序包；确认下载的是完整压缩包而非拆分组件。若杀毒软件误报，先核实下载来源，必要时把安装目录加入白名单，不建议直接关闭实时防护。

提示"安装文件缺失"定位：安全软件拦截或手动删除了部分文件，对应任务（如小游戏）可能跑不起来。处理：从隔离区恢复被删文件并加白名单，或在弹窗中选择自动修复重新下载完整包。

连接失败定位：检查 ADB 路径与连接地址（本机模拟器一般为127.0.0.1:<端口>或emulator-<四位数字>）；再查任务管理器中是否有残留的adb进程。处理：关闭旧 adb 进程后重试；同时使用多个 ADB 的工具时确认版本一致；使用过加速器的重启 MAA、ADB 和模拟器再连接。

连接正常但没有操作定位：模拟器自带的 ADB 版本过旧，不支持 Minitouch/MaaTouch 触控。处理：以管理员权限启动 MAA，关闭模拟器后在"MAA 设置 - 连接设置"中点击"强制替换 ADB"；模拟器更新覆盖 ADB 文件后若问题复现，重复替换或改用谷歌官方 ADB。

操作卡顿、频繁暂停或识别异常定位：按顺序排查——是否启用了"异形屏UI适配"（调回 0）；外服客户端是否选对了类型；截图耗时是否偏高（连接设置中可看到近 30 次截图耗时统计，与电脑性能和模拟器相关）。处理：自动战斗频繁暂停且不下干员时关闭"划火柴模式"；MuMu 用户不要把显存使用策略设为"资源占用更小"；MuMu 显存策略之外，自动肉鸽还要求正确选择肉鸽主题，详见集成战略文档。

排错时务必带上日志：用设置-问题反馈-生成日志压缩包导出；MAA 完全无法启动时，打包安装目录下的debug、config、cache三个文件夹一并提供。更多情况见常见问题。

生态与参与：社区和关联项目

关联项目：底层的 MaaFramework 是通用的自动化框架，MAA 的许多能力建立在其上；另有基于深度学习的 MaaAI 项目、提供作业与数据的作业站（前端与后端分离）、以及官网前端等配套工程，源码在 src/MaaUnified/ 等目录中可找到入口。
贡献代码：开发环境搭建、提交 PR 的流程见开发指南与 PR 教程；通过 Issue 反馈 bug 前请先阅读 Issue Bot 使用方法。
多语言与翻译：MAA 以简体中文为第一语言，翻译词条均以此为准，同时维护繁中、英文、日文、韩文文档（见 docs/ 下的分语言目录）。想改进某个外服客户端的识别，通常只需截图加少量 JSON 修改，外服适配教程门槛很低，是新贡献者友好的切入点。

想今天就让日常自动化起来：按"跑通它"一节的五步完成安装与首次长草，剩下的进阶项等你有具体需求时再翻。

关键路径清单

新手入口：docs/zh-cn/manual/newbie.md
下载与安装：docs/zh-cn/manual/install.md
连接设置（含多开）：docs/zh-cn/manual/connection.md
CLI 指南：docs/zh-cn/manual/cli/
任务流程协议：docs/zh-cn/protocol/task-schema.md
核心源码：src/MaaCore/（任务与识别在 src/MaaCore/Task/、src/MaaCore/Vision/）
Windows 图形界面：src/MaaWpfGui/
辅助工具脚本：tools/

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析