MAA 明日方舟小助手安装指南:从下载到一键长草只需 10 分钟
【免费下载链接】MaaAssistantArknights《明日方舟》小助手,全日常一键长草!| A one-click tool for the daily tasks of Arknights, supporting all clients.项目地址: https://gitcode.com/GitHub_Trending/ma/MaaAssistantArknights
MAA(MaaAssistantArknights)是一款基于图像识别的《明日方舟》自动化助手,帮你一键完成日常任务。这篇指南带你把它装上并跑起来:选对下载渠道、搞定运行库依赖、处理闪退与误报——读完即可独立安装并启动 MAA。
装 MAA 前 30 秒自检:系统、架构、权限
动手下载之前,先花半分钟确认三件事,能避开后面 80% 的麻烦:
- 系统版本:Windows 桌面版只支持Windows 10 / 11,不支持 32 位系统和 Win 7/8/8.1;Windows N/KN(欧洲/韩国版)需额外安装媒体功能包。macOS 版本无特殊版本要求。
- CPU 架构:绝大多数 Windows 电脑是x64;只有少数新款笔记本是 arm64。macOS 不用操心——官方 universal 通用版同时包含 Intel(x86_64)和 Apple Silicon(arm64)两套原生二进制,见 tools/build_macos_universal.zsh,它会分别构建两种架构再合并打包。
- 磁盘与权限:给 MAA 留几 GB 可用空间,并记住一条铁律——MAA 所在目录必须可写(它要在旁边存配置、缓存和日志)。
先挑路:4 种 MAA 获取方式怎么选
| 方式 | 适用平台 | 适合谁 | 拿到包后要做什么 |
|---|---|---|---|
| Winget 包管理器 | Windows 10/11 | 想最省事的人 | 一条命令装完,直接启动 |
| 官网 / GitHub Releases | Windows、macOS | 想指定版本的人 | 手动解压或拖入 Applications |
| QQ 群文件 | Windows、macOS | 国内下载慢想加速 | 同上 |
| maa-cli | Linux、macOS、Windows | 无图形界面、跑脚本 | 命令行安装并运行任务 |
官方完整包命名格式是MAA-<版本号>-<平台>-<架构>.zip(macOS 为.dmg),名字里没带完整平台的包都是"零部件",不能单独运行,下载前先核对一眼。
Windows 安装 MAA 最快路径:解压 + 装运行库两步
走 Winget(推荐,一条命令):
winget install maa它会自动装到C:\Users\用户名\AppData\Local\Microsoft\WinGet\Packages,之后在终端输入maa即可启动。注意:如果你同时还装了 maa-cli,两个命令都会响应maa,需要自己区分。
走压缩包(官网 / Releases / 群文件通用):
- 下载
MAA-<版本>-win-x64.zip(arm64 机器选win-arm64),完整解压到一个不需要管理员权限的路径,比如D:\MAA或用户目录下的文件夹。千万别放C:\根目录或C:\Program Files\——从 src/MaaWpfGui/app.manifest 可以看到 MAA 的 UAC 级别是asInvoker(随调用者权限运行),它不申请管理员权限,放进系统保护目录反而会因写不进去而各种诡异异常。 - 先装运行库,再启动程序。MAA 已内置 .NET 运行时(自包含部署,无需单独装 .NET),但仍依赖系统的Visual C++ 2015+ x64 运行库(VCRedist,可以理解为 C++ 程序的"播放器")。在解压出的 MAA 目录里以管理员身份运行tools/DependencySetup_依赖库安装.bat,它会静默修复安装运行库;提示完成后重启电脑,双击
MAA.exe启动。
这个批处理脚本本质上就是一条 winget 命令:
winget install "Microsoft.VCRedist.2015+.x64" --override "/repair /passive /norestart" --uninstall-previous --accept-package-agreements --force如果你的 Windows 太老没有自带 winget,脚本会打印提示,此时去微软官网手动下载 Visual C++ 2015+ x64 运行库安装包即可,效果等价。
macOS 安装 MAA:拖进 Applications 就完事
- 下载
MAA-<版本>-macos-universal.dmg; - 双击打开
.dmg,把MAA.app拖进/Applications文件夹,完事。
再次强调 universal 版的含义:它是 arm64 和 x86_64 两轮独立构建再合并的产物(构建脚本见 tools/build_macos_universal.zsh),Intel Mac 和 Apple Silicon Mac 都是原生运行,不存在"转译变慢"。有一点要提前知道:macOS 版 GUI 由团队中少数开发者维护,个别功能可能与 Windows 版有差异或滞后,说明见 docs/zh-cn/manual/newbie.md 开篇。
Linux 没有图形界面?用 maa-cli 跑命令行版
MAA 图形界面暂未支持 Linux。但命令行版本maa-cli(一个 Rust 写的 CLI,通过它调用 MAA 的核心 MaaCore 执行任务)支持 Linux、macOS 和 Windows,非常适合服务器和无 GUI 场景。完整说明见 docs/zh-cn/manual/cli/install.md。
安装 maa-cli 本体,按你手上的包管理器选一条:
brew install MaaAssistantArknights/tap/maa-cli(macOS Homebrew 用户;Arch 用户可用paru -S maa-cli,Nix 用户用nix run nixpkgs#maa-cli。)其他平台可以跑官方文档给出的预编译安装脚本一行命令装好,装完后用maa self update就能自助升级。Rust 开发者也可以用 cargo 直接从 maa-cli 仓库源码编译安装,注意其最低 Rust 版本要求为 1.88,建议用最新工具链。
再装 MaaCore 并跑第一个任务:maa-cli 只是"遥控器",真正干活的核心 MaaCore 及识别资源要单独装:
maa install(Windows 上先按管理员身份装好 VC++ 运行库,命令同上文 Winget 那条,再执行maa install;Nix 用户无需此步,核心已内置。)装完可用maa init交互式初始化配置,然后输入maa查看可用任务,比如maa startup启动游戏、maa fight 1-7刷关卡,命令清单见 docs/zh-cn/manual/cli/usage.md。
装完 MAA 后 3 步验证是否成功
- 看界面:启动 MAA 后应该出现这样的主界面——左侧任务列表、中间设置区、右侧公招识别日志。能看到界面就说明程序本体没问题。
- 等资源更新:MAA 首次启动会自动检查并更新游戏资源,更新在系统空闲时自动加载,不用重启,稍等片刻即可。
- 连一次模拟器做最小运行:把模拟器分辨率设为横屏
1280x720或1920x1080(美服玩家必须是1920x1080),跟随设置指引完成初始配置后勾选一两个任务点运行——这一步是为了确认"连接设备 → 执行任务"整条链路通了。maa-cli 用户则在终端执行一次maa startup,游戏能进主界面即算通过。
MAA 安装翻车急救包:5 个高频问题速查
| 症状 | 九成原因 | 处理动作 |
|---|---|---|
| 更新后无法运行 / 弹出报错窗口 | VC++ 运行库缺失或未更新 | 重跑DependencySetup_依赖库安装.bat或手动重装 VCRedist x64,这是最高频问题,官方 FAQ 都把它置顶了 |
| 双击没反应或"不是有效的 Windows 程序" | 下错了架构包(x64/arm64 混用) | 重新下载win-x64完整包;Windows 端 GUI 实际构建同时支持win-x64与win-arm64两种标识,见 src/MaaWpfGui/MaaWpfGui.csproj,不能混用 |
| 各种诡异异常、写文件失败 | 装进了需要 UAC 权限的受保护目录 | 整体迁移到普通用户目录再运行 |
| 杀软报毒 / 启动提示"安装文件缺失" | 自动化行为触发启发式误报,或文件被拦截删除 | 先确认来源可信(仅官网、Releases、Winget、官方群文件),到隔离区恢复文件、把 MAA 目录加白名单,并向安全厂商提交误报样本;不建议直接关实时防护。MAA 启动时会对照filelist.txt清单自查,也可在弹窗里选自动修复 |
| 自动更新后功能缺失 | 更新中断,处于"半更新"状态 | 重新下载解压完整包,把旧目录里的config、data、debug文件夹拷到新目录,cache和achievement可选保留 |
另外两个"环境类"问题:系统被精简掉组件存储服务(CBS/WinSxS)会导致运行库根本装不上,这种情况官方建议除重装系统外无可靠修复方案,平时尽量避免来路不明的"精简版"系统;杀毒误报等待修正期间临时加白名单即可,别关防护。
装好之后往哪走:新手配置与功能入口
- 第一次使用:继续读 新手上路,按顺序完成设备连接与初始配置;
- 想看 MAA 都能干什么(基建换班、自动肉鸽、公招识别、自动战斗):功能介绍;
- 安装或使用中卡住:优先查 常见问题,再走"设置 → 问题反馈 → 生成日志压缩包"带着日志求助;
- 想折腾核心逻辑:核心调度实现都在 src/MaaCore/,任务统一由
Assistant.cpp分派。
装好只是起点,模拟器连上之后,MAA 的日常自动化能力才真正开始生效——祝你 Link Start 顺利 🎮
【免费下载链接】MaaAssistantArknights《明日方舟》小助手,全日常一键长草!| A one-click tool for the daily tasks of Arknights, supporting all clients.项目地址: https://gitcode.com/GitHub_Trending/ma/MaaAssistantArknights
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考