MaaAssistantArknights（MAA）下载与安装完整指南：三步装好明日方舟日常自动化工具

MaaAssistantArknights（MAA）下载与安装完整指南：三步装好明日方舟日常自动化工具

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

MaaAssistantArknights（MAA）是《明日方舟》的一键日常自动化助手，支持全端游服。本文带你走一遍 MAA 下载、安装到首次启动的完整实战流程：先自检系统与芯片架构，再按推荐优先级拿到软件包，最后按"解压 → 装依赖 → 启动"三步落地；装不上或跑不起来时，对照症状表逐条修。

安装前自检：系统版本与架构该核对什么

先确认你的机器满足运行条件，后面选包才不会走弯路。

受支持的系统版本范围

• Windows：仅支持10 与 11，Win7 / 8 / 8.1 与 32 位系统不在支持范围内；Windows N / KN 版需额外安装"媒体功能包"，否则媒体相关功能不可用。
• macOS：Intel 与 Apple Silicon 芯片均可，通用版通吃。
• Linux 及其他系统：GUI 版不支持，走命令行版 maa-cli（见后文）。

该下哪个架构的包

Windows 下在"设置 → 系统 → 关于"中确认是 64 位操作系统即可。macOS 的universal包是分别以arm64、x86_64两种架构做完整构建后再合并的（构建逻辑见 tools/build_macos_universal.zsh 与 tools/xcframework.makefile），两种芯片都是原生运行，不必关心芯片型号。

获取 MAA 软件包的几条路（按推荐优先级）

官方发布包统一命名为MAA-<版本号>-<平台>-<架构>，列表里其余条目（核心库、资源包之类）都是无法单独运行的"零部件"，别拿错。

一条命令装好：Winget 一键安装（Windows 首选）

winget install maa

• 免手动解压、免单独装运行库，还自带命令行启动能力；
• 默认安装路径为C:\Users\用户名\AppData\Local\Microsoft\WinGet\Packages，装完后在命令行输入maa即可启动；
• 若你的 PATH 里同时存在 maa-cli，maa命令可能被命令行版占用，注意区分。

适用人群：绝大多数 Windows 10/11 用户，这是最省事的路径。

官网或 Release 页面手动下载

• 官网会根据访问系统自动推荐正确的版本与架构；
• Release 页面下载时，Windows 用户选win-x64包（不要选win-arm64），macOS 用户选macos-universal.dmg；
• macOS 用户必须走这条路，Winget 只服务 Windows。

群文件与第三方加速（备用）

• QQ 群文件：加入 MAA 官方群后，在群文件里找最新软件包；
• Mirror酱：独立的第三方付费下载加速服务（MAA 本身免费，部分订阅收益回馈项目开发者）。注意它不提供 macOS 通用版，需先确认芯片架构（Apple Silicon 为 arm64 / Intel 为 x86_64）再选对应包。

适用人群：直连官方发布页网速受限，或需要下载加速的用户。

装起来并跑起来：三步走

GUI 版仅覆盖 Windows 与 macOS，主线都是"拿到包 → 装依赖 → 启动"；无图形界面的系统直接看最后一节。

🖥️ Windows：解压、装运行库、启动

1. 解压：把 zip完整解压到可写目录。不要放进C:\、C:\Program Files\等需要 UAC 权限的路径——MAA 需要把配置、缓存、日志写回自身目录，而程序 UAC 级别是asInvoker（不申请管理员权限，见 app.manifest），放进受保护目录只会换来各种莫名写入失败。
2. 装运行库：在解压后的 MAA 目录中以管理员身份运行DependencySetup_依赖库安装.bat。
   • 为什么：MAA 已内置 .NET 运行时（自包含部署），但 C++ 侧仍依赖系统的Visual C++ Redistributable x64（VCRedist x64）；
   • 脚本里实际执行的是winget install "Microsoft.VCRedist.2015+.x64" --override "/repair /passive /norestart" --uninstall-previous --accept-package-agreements --force，即以静默修复模式装库、不强制重启、先卸旧版；
   • 若脚本提示'winget' is not...，说明系统过旧未内置 winget，按脚本打印的备用地址用浏览器手动下载安装 VC++ x64 运行库即可。
3. 启动：按脚本完成提示重启电脑，然后双击MAA.exe，进入主界面。

走 Winget 安装的用户跳过以上三步，直接命令行输入maa。

🍎 macOS：挂载、拖入、启动

1. 双击MAA-<版本号>-macos-universal.dmg打开磁盘映像；
2. 将MAA.app拖入/Applications；
3. 从启动台或应用程序文件夹启动，首次打开可能需确认安全性。

通用版同时内置两种架构的原生二进制，无需按芯片挑选。需要说明：macOS 版由团队少数开发者维护，与 Windows 端 WPF UI 相比功能可能有差异或滞后。

⌨️ 无图形界面的命令行替代：maa-cli

maa-cli 支持 Linux、macOS、Windows，适合自动化脚本或无图形界面的服务器。它只是命令行外壳，运行任务还需要 MaaCore 及资源。

1. 安装（任选其一）：

2. 装 MaaCore 与资源：
   • 预编译或自行编译用户：执行maa install，自动下载官方预编译的 MaaCore；
   • Windows 用户：先以管理员身份装好 VC++ 运行库（同 Windows 一节），再执行maa install；
   • Nix 用户：maa-cli 已强制依赖 MaaCore，无需也不应手动安装。
3. 更新自身：maa self update。

装不上或跑不起来：按症状排查

接下来

• 新手上路：确认 模拟器支持情况，把模拟器分辨率设为横屏1280x720或1920x1080（美服玩家必须1920x1080），再跟随设置指引完成初始配置；
• 功能介绍：一键长草、自动基建换班、自动肉鸽、公招识别、自动战斗等能力一览；
• 遇到问题先查 常见问题（置顶的运行库问题覆盖了绝大多数启动失败场景），反馈问题时用"设置 → 问题反馈"生成日志压缩包一并附上。

装好只是起点：MAA 的核心逻辑由 src/MaaCore/ 承载，各任务经 Assistant.cpp 统一调度，配置好模拟器连接后才能真正跑起来。

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