企业官网建设流程全解析

MAA 明日方舟小助手下载与安装实战指南：Windows / macOS / maa-cli 从零到首次启动

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

MAA（MaaAssistantArknights）是一款基于图像识别的《明日方舟》自动化助手，能一键完成自动基建换班、自动公招、理智作战等日常任务。本文覆盖 MAA 桌面版（图形界面）在 Windows 与 macOS 上的获取与部署流程、无图形界面系统下的 maa-cli 命令行方案、VC++ 运行库等依赖的处理方法，以及首次启动验证和常见安装故障的排查。读完并完成操作后，你将能独立选对适合自己系统的安装包、装好运行库并成功启动 MAA，把它接入模拟器跑起第一个任务。

环境自检：安装 MAA 之前先确认什么

MAA 桌面版暂未支持 Linux，图形界面只覆盖 Windows 和 macOS 两个平台。动手下载前，先对照下表确认你走的路线：

判断自己的架构很简单：Windows 下右键「此电脑」→ 属性，看「系统类型」是 64 位还是 ARM64 处理器；Mac 上点左上角 → 关于本机，看芯片是 Apple M 系列（arm64）还是 Intel（x86_64）。

依据：docs/zh-cn/manual/install.md 明确 GUI 暂不支持 Linux 及其他操作系统；docs/zh-cn/manual/newbie.md 指出 Windows 端仅支持 10 和 11；docs/zh-cn/manual/faq.md 的系统问题部分列出了 32 位与旧系统的限制。

图形界面还是命令行：先看结论再选型

• 选 MAA 桌面版：你在 Windows 10/11 或 macOS 上、习惯用鼠标点选任务，那就用 GUI。它提供最完整的 UI 层功能（库存保持、定时执行、拖入压缩包更新等由 UI 实现，核心 MaaCore 不含此逻辑），且 Windows 端是团队主要维护的版本，功能最全。
• 选 maa-cli：你在 Linux 上，或想把 MAA 嵌进自动化脚本、在无图形界面的服务器上跑，用 maa-cli。它只负责命令行交互，跑任务仍需安装 MaaCore 及资源。

一句话取舍：能装 GUI 就装 GUI，装不了就 maa-cli，不要反过来。

选对架构：安装包命名规则与各获取渠道

官方发布包统一采用MAA-<版本号>-<平台>-<架构>.zip的命名格式，不符合此格式的其余下载项都是无法单独使用的"零部件"。据此，绝大多数 Windows 用户应选MAA-<版本号>-win-x64.zip，而不是win-arm64包（工程侧 src/MaaWpfGui/MaaWpfGui.csproj 中RuntimeIdentifiers为win-x64;win-arm64，两者不可混用）；macOS 用户应选MAA-<版本号>-macos-universal.dmg。

按「官方渠道 → 包管理器 → 社区渠道」排序：

官方渠道：官网与 GitHub Releases

• 官网：会自动识别访问者系统并推荐正确的版本与架构，新手最不容易出错，应优先选它。
• GitHub Releases：需自行核对架构，按上面的命名规则挑win-x64或macos-universal。

包管理器：Winget 一条命令装好（仅 Windows）

在 PowerShell 或 CMD 中执行：

winget install maa

这是 Windows 用户最省事的路径——无需手动解压、无需单独装运行库，装完直接在命令行输入maa即可启动。默认安装路径为C:\Users\用户名\AppData\Local\Microsoft\WinGet\Packages。注意：若你的 PATH 里同时存在maa-cli，两者都会响应maa命令，需要自行区分。

社区渠道：Mirror酱 与 QQ 群文件

• Mirror酱：独立的第三方下载加速服务，需付费订阅 CDK（这是加速服务的费用，不是 MAA 收费）。重点：它不提供 macOS 通用版，Mac 用户必须先确认自己是 Apple Silicon（arm64）还是 Intel（x86_64），再下对应架构的包。
• QQ 群文件：加入 MAA 官方 QQ 群后在群文件里找最新软件包，入口见 README.md 底部的用户群信息。

下载时还有一个高频坑：不要用迅雷，文档明确提示它会中途弹出"登录/鉴权"打断下载，请改用浏览器或 IDM / FDM 等下载器。

Windows 部署：解压、运行库、首次启动三步走

解压到对的位置

用解压缩软件把.zip完整解压，得到一个包含 MAA 全部文件的文件夹。

::: warning 两条红线，务必遵守：

1. 不要解压到需要 UAC 权限的路径（如C:\、C:\Program Files\）。MAA 运行时要对所在目录写入配置、缓存和日志，放进受保护目录会引发各种难以排查的异常。从 src/MaaWpfGui/app.manifest 可以看到，MAA 的 UAC 请求级别是asInvoker（随调用者权限运行，不申请管理员），正常放在用户可写的目录即可发挥全部功能。
2. 先装运行库，再启动程序，顺序不能反。 :::

为什么必须先装 VC++ 运行库

MAA 采用 .NET 自包含部署（csproj 中SelfContained为 true），.NET 运行时已内置，不需要你单独装 .NET；但仍依赖系统的Visual C++ Redistributable x64（简称 VCRedist x64，是 MAA 依赖的 C++ 基础运行库，很多软件都靠它跑）。正确做法：

1. 在解压后的 MAA 目录中，以管理员身份运行DependencySetup_依赖库安装.bat；
2. 脚本成功会提示"运行库修复完成，请重启电脑后再次尝试运行 MAA"——按提示重启即可。

这个 .bat 的底层原理：它本质封装了一条精确的 winget 命令：

winget install "Microsoft.VCRedist.2015+.x64" --override "/repair /passive /norestart" --uninstall-previous --accept-package-agreements --force

参数含义：/repair /passive以静默修复模式执行不弹交互，/norestart不强制重启；--uninstall-previous先卸载旧版本再装；--accept-package-agreements --force跳过协议勾选并强制安装。若系统过旧没有 winget，脚本会识别'winget' is not...报错并打印备用下载地址供手动安装（见 tools/DependencySetup_依赖库安装.bat）。手动执行这条命令与跑脚本效果等价。

首次启动验证

双击MAA.exe（winget 用户输入maa）。首次启动时 MAA 会自动检查并更新游戏资源，随后跟随设置指引配置即可。验证成功的标志：能打开左侧任务列表、界面右上角出现版本信息、连接模拟器后日志正常滚动。

macOS 部署：拖入应用程序文件夹即完成

1. 下载MAA-<版本号>-macos-universal.dmg；
2. 双击打开镜像，把MAA.app拖入/Applications文件夹；
3. 从启动台或应用程序文件夹双击MAA启动，首次打开时若被 Gatekeeper 拦截，按系统提示放行即可。

关于这个universal包的来龙去脉：tools/build_macos_universal.zsh 会分别以arm64和x86_64两个架构各跑一轮完整的 CMake 构建，再由 tools/xcframework.makefile 将两份产物合并输出，所以 Apple Silicon 和 Intel 的 Mac 都是原生运行而非转译，无需区分下载。

需要管理预期：macOS 端由团队中少数开发者维护，与 Windows 端 WPF 界面相比功能可能存在差异或滞后（见 docs/zh-cn/manual/newbie.md 开篇说明）。若你追求功能完整度且用的是 Intel Mac，官方文档建议多系统装 Windows 后使用 Windows 版。

maa-cli：无图形界面时的完整方案

maa-cli 是 MAA 的命令行入口，支持 Linux、macOS 和 Windows，适合自动化脚本或无显示器的服务器。它只是命令行外壳，跑任务必须再装 MaaCore 及资源，下面分两节讲清。

安装 maa-cli 本体

按优先级推荐三种方式：

• 预编译安装脚本（最省事，Linux/macOS 一条 curl 命令，Windows 用 PowerShell 脚本），装完可用maa self update一键升级自身；
• 包管理器：macOS 用户brew install MaaAssistantArknights/tap/maa-cli（另有maa-cli-beta预发行版）；Arch 用户paru -S maa-cli或yay -S maa-cli；Nix 用户nix run nixpkgs#maa-cli；
• cargo 自行编译（面向 Rust 开发者）：

cargo install --git https://github.com/MaaAssistantArknights/maa-cli.git --bin maa --tag stable --locked

注意最低支持 Rust 版本（MSRV）为 1.88，且随时可能提高，建议始终使用最新工具链。命令细节以 docs/zh-cn/manual/cli/install.md 为准。

安装 MaaCore 及资源

预编译或自行编译的用户，执行：

maa install

即可自动下载官方预编译的 MaaCore 并部署资源。分平台差异：

• Windows：执行前先以管理员身份跑一遍上文的 VC++ 运行库 winget 命令，再maa install；
• Nix：maa-cli 已强制依赖 MaaCore，无需也不应该手动安装；
• Arch：除maa install外，也可经 AUR 安装maa-assistant-arknights包。

一个容易忽略的点：maa install下载的是官方预编译版 MaaCore，而包管理器分发的 MaaCore 可能采用不同的编译选项和依赖版本，性能与功能上可能有细微差异，追求一致体验就用maa install。

高频安装问题速查：按现象对照处理

另有两个前置硬性条件常被误判为安装问题：32 位系统与 Win 7/8/8.1 直接不被支持，换系统或换设备；Win N/KN 需补装媒体功能包。

装完之后的下一步

• 新手配置：前往 新手上路，把模拟器分辨率设为横屏1280x720或1920x1080（美服玩家必须1920x1080），再跟随设置指引连接模拟器；
• 设备与模拟器支持：确认你的模拟器在 模拟器及设备支持 的支持清单内；
• 功能全貌：浏览 功能介绍，了解自动基建换班、自动肉鸽、公招识别等能做什么；
• 遇到问题：优先查 常见问题，求助前用设置 - 问题反馈 - 生成日志压缩包带上日志。

任务列表安静地自己跑起来的那一刻，你就明白了官方 README 里那句"全日常一键长草"到底是什么意思。

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