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/MaaAssistantArknightsMAAMaaAssistantArknights是一款基于图像识别的《明日方舟》自动化助手能一键完成自动基建换班、自动公招、理智作战等日常任务。本文覆盖 MAA 桌面版图形界面在 Windows 与 macOS 上的获取与部署流程、无图形界面系统下的 maa-cli 命令行方案、VC 运行库等依赖的处理方法以及首次启动验证和常见安装故障的排查。读完并完成操作后你将能独立选对适合自己系统的安装包、装好运行库并成功启动 MAA把它接入模拟器跑起第一个任务。环境自检安装 MAA 之前先确认什么MAA 桌面版暂未支持 Linux图形界面只覆盖 Windows 和 macOS 两个平台。动手下载前先对照下表确认你走的路线你的系统可选路线关键限制Windows 10 / 11x64 或 ARM64MAA 桌面版GUI不支持 32 位系统不支持 Win 7 / 8 / 8.1Win N/KN欧洲/韩国版需另装媒体功能包macOSApple Silicon 或 IntelMAA 桌面版universal 通用版macOS 端由少数开发者维护个别功能可能滞后于 Windows 端Linux任意发行版maa-cli 命令行版没有图形界面需额外安装 MaaCore 及资源无显示器的服务器 / 自动化脚本maa-cli 命令行版同上适合纯命令行场景判断自己的架构很简单Windows 下右键「此电脑」→ 属性看「系统类型」是 64 位还是 ARM64 处理器Mac 上点左上角 → 关于本机看芯片是 Apple M 系列arm64还是 Intelx86_64。依据docs/zh-cn/manual/install.md 明确 GUI 暂不支持 Linux 及其他操作系统docs/zh-cn/manual/newbie.md 指出 Windows 端仅支持 10 和 11docs/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 Siliconarm64还是 Intelx86_64再下对应架构的包。QQ 群文件加入 MAA 官方 QQ 群后在群文件里找最新软件包入口见 README.md 底部的用户群信息。下载时还有一个高频坑不要用迅雷文档明确提示它会中途弹出登录/鉴权打断下载请改用浏览器或 IDM / FDM 等下载器。Windows 部署解压、运行库、首次启动三步走解压到对的位置用解压缩软件把.zip完整解压得到一个包含 MAA 全部文件的文件夹。::: warning 两条红线务必遵守不要解压到需要 UAC 权限的路径如C:\、C:\Program Files\。MAA 运行时要对所在目录写入配置、缓存和日志放进受保护目录会引发各种难以排查的异常。从 src/MaaWpfGui/app.manifest 可以看到MAA 的 UAC 请求级别是asInvoker随调用者权限运行不申请管理员正常放在用户可写的目录即可发挥全部功能。先装运行库再启动程序顺序不能反。 :::为什么必须先装 VC 运行库MAA 采用 .NET 自包含部署csproj 中SelfContained为 true.NET 运行时已内置不需要你单独装 .NET但仍依赖系统的Visual C Redistributable x64简称 VCRedist x64是 MAA 依赖的 C 基础运行库很多软件都靠它跑。正确做法在解压后的 MAA 目录中以管理员身份运行DependencySetup_依赖库安装.bat脚本成功会提示运行库修复完成请重启电脑后再次尝试运行 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.exewinget 用户输入maa。首次启动时 MAA 会自动检查并更新游戏资源随后跟随设置指引配置即可。验证成功的标志能打开左侧任务列表、界面右上角出现版本信息、连接模拟器后日志正常滚动。macOS 部署拖入应用程序文件夹即完成下载MAA-版本号-macos-universal.dmg双击打开镜像把MAA.app拖入/Applications文件夹从启动台或应用程序文件夹双击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-cliNix 用户nix run nixpkgs#maa-clicargo 自行编译面向 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 installNixmaa-cli 已强制依赖 MaaCore无需也不应该手动安装Arch除maa install外也可经 AUR 安装maa-assistant-arknights包。一个容易忽略的点maa install下载的是官方预编译版 MaaCore而包管理器分发的 MaaCore 可能采用不同的编译选项和依赖版本性能与功能上可能有细微差异追求一致体验就用maa install。高频安装问题速查按现象对照处理现象原因处理更新后无法运行 / 闪退 / 报错窗口运行库未更新出现最多的问题见 FAQ 置顶重跑DependencySetup_依赖库安装.bat或对应 winget 命令装完只剩部分功能下载了零部件而非完整包按命名规则重新下载MAA-版本-win-x64.zip等完整包自动更新后功能缺失更新中断处于半更新状态下次启动按提示自动修复或重下完整包把旧目录的config、data、debug文件夹复制过去cache、achievement可选保留杀毒软件报毒 / PUA自动化工具触发启发式检测先确认来源可信官网 / Releases / Winget / 官方群将安装目录加白名单并向厂商提交误报样本不建议关闭实时防护启动提示安装文件缺失部分文件被安全软件拦截或删除MAA 启动时对照filelist.txt检查完整性从隔离区恢复文件或在弹窗中选择自动修复启动弹窗悲报 / 界面渲染异常Nahimic 等第三方软件向 MAA 注入 DLL在 Windows 安全中心「应用和浏览器控制 → 攻击防护」中对MAA.exe勾选禁用扩展点或按 FAQ 方法重命名注入的 DLL下载中途提示登录/鉴权使用了迅雷换浏览器 / IDM / FDM 重新下载运行库始终装不上组件存储服务CBS / WinSxS被破坏除重装系统外无更可靠方案避免使用来源不明的精简版系统另有两个前置硬性条件常被误判为安装问题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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考