MAA 明日方舟小助手安装指南:从下载到一键长草只需 10 分钟
2026/9/16 13:40:20 网站建设 项目流程

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 ReleasesWindows、macOS想指定版本的人手动解压或拖入 Applications
QQ 群文件Windows、macOS国内下载慢想加速同上
maa-cliLinux、macOS、Windows无图形界面、跑脚本命令行安装并运行任务

官方完整包命名格式是MAA-<版本号>-<平台>-<架构>.zip(macOS 为.dmg),名字里没带完整平台的包都是"零部件",不能单独运行,下载前先核对一眼。

Windows 安装 MAA 最快路径:解压 + 装运行库两步

走 Winget(推荐,一条命令):

winget install maa

它会自动装到C:\Users\用户名\AppData\Local\Microsoft\WinGet\Packages,之后在终端输入maa即可启动。注意:如果你同时还装了 maa-cli,两个命令都会响应maa,需要自己区分。

走压缩包(官网 / Releases / 群文件通用):

  1. 下载MAA-<版本>-win-x64.zip(arm64 机器选win-arm64),完整解压到一个不需要管理员权限的路径,比如D:\MAA或用户目录下的文件夹。千万别放C:\根目录或C:\Program Files\——从 src/MaaWpfGui/app.manifest 可以看到 MAA 的 UAC 级别是asInvoker(随调用者权限运行),它不申请管理员权限,放进系统保护目录反而会因写不进去而各种诡异异常。
  2. 先装运行库,再启动程序。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 就完事

  1. 下载MAA-<版本>-macos-universal.dmg
  2. 双击打开.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 步验证是否成功

  1. 看界面:启动 MAA 后应该出现这样的主界面——左侧任务列表、中间设置区、右侧公招识别日志。能看到界面就说明程序本体没问题。

  1. 等资源更新:MAA 首次启动会自动检查并更新游戏资源,更新在系统空闲时自动加载,不用重启,稍等片刻即可。
  2. 连一次模拟器做最小运行:把模拟器分辨率设为横屏1280x7201920x1080(美服玩家必须是1920x1080),跟随设置指引完成初始配置后勾选一两个任务点运行——这一步是为了确认"连接设备 → 执行任务"整条链路通了。maa-cli 用户则在终端执行一次maa startup,游戏能进主界面即算通过。

MAA 安装翻车急救包:5 个高频问题速查

症状九成原因处理动作
更新后无法运行 / 弹出报错窗口VC++ 运行库缺失或未更新重跑DependencySetup_依赖库安装.bat或手动重装 VCRedist x64,这是最高频问题,官方 FAQ 都把它置顶了
双击没反应或"不是有效的 Windows 程序"下错了架构包(x64/arm64 混用)重新下载win-x64完整包;Windows 端 GUI 实际构建同时支持win-x64win-arm64两种标识,见 src/MaaWpfGui/MaaWpfGui.csproj,不能混用
各种诡异异常、写文件失败装进了需要 UAC 权限的受保护目录整体迁移到普通用户目录再运行
杀软报毒 / 启动提示"安装文件缺失"自动化行为触发启发式误报,或文件被拦截删除先确认来源可信(仅官网、Releases、Winget、官方群文件),到隔离区恢复文件、把 MAA 目录加白名单,并向安全厂商提交误报样本;不建议直接关实时防护。MAA 启动时会对照filelist.txt清单自查,也可在弹窗里选自动修复
自动更新后功能缺失更新中断,处于"半更新"状态重新下载解压完整包,把旧目录里的configdatadebug文件夹拷到新目录,cacheachievement可选保留

另外两个"环境类"问题:系统被精简掉组件存储服务(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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询