MAAMaaAssistantArknights完整安装指南从确认环境到首次跑通的全平台手把手教程【免费下载链接】MaaAssistantArknights《明日方舟》小助手全日常一键长草| A one-click tool for the daily tasks of Arknights, supporting all clients.项目地址: https://gitcode.com/GitHub_Trending/ma/MaaAssistantArknightsMaaAssistantArknightsMAA是《明日方舟》一键长草助手可自动完成公招、基建换班、理智作战等日常任务。本文带你走完「确认环境 → 选对渠道下载 → 安装 → 启动验证 → 排障」全流程装完即可直接跑任务。先确认系统再下载MAA 的四项前置条件下载前先把下面这张自查表过一遍80% 的装不上问题都出在这一步检查项要求不满足时的后果Windows 版本仅支持 Windows 10 / 11不支持 32 位系统不支持 Windows 7 / 8 / 8.1运行库无法安装MAA 无法启动CPU 架构绝大多数 Windows 电脑为 x64win-arm64 包仅限 ARM 设备使用不能混下解压后闪退或直接无法打开依赖运行库Windows 需要 VC Redistributable x64可一键修复见后文macOS 无额外依赖启动报错窗口操作系统覆盖GUI 版图形界面暂未支持 Linux 及其他系统Linux 用户请走 maa-cli 命令行方案见下文无 GUI 可用另外两点容易忽略**Windows N / KN欧洲 / 韩国版系统**需额外安装微软媒体功能包否则部分功能异常避免使用来源不明的精简版系统——MAA 的运行库安装依赖组件存储服务CBS / TrustedInstaller / WinSxS这些组件被精简后基本只能重装系统解决。下载渠道怎么选官网、Winget 与 maa-cli 一表对比MAA 官方发布包统一命名为MAA-版本号-平台-架构.zipmacOS 为.dmg各渠道对比如下渠道适用系统是否需手动装运行库推荐度官网自动识别架构/ Releases 页面Windows x64、macOSWindows 需跑一次一键脚本macOS 免⭐⭐⭐⭐⭐最通用winget install maa仅 Windows 10不需要⭐⭐⭐⭐⭐Windows 最省事QQ 官方群文件Windows、macOS同官网⭐⭐⭐国内网络友好maa-clibrew / paru / nix / 安装脚本Linux、macOS、Windowsmaa install自动下载 MaaCore 与资源⭐⭐⭐脚本 / 服务器场景首选 选包口诀Windows 用户认准MAA-*-win-x64.zip其余同版本文件都是无法单独使用的零部件macOS 用户认准MAA-*-macos-universal.dmg。官网 / Releases 渠道的下载细节官方文档站首页会提供语言选择与下载入口macOS 的universal通用版并非简单打包tools/build_macos_universal.zsh 会先以arm64与x86_64两个架构各跑一轮完整的 CMake 构建再合并输出——所以无论 Apple Silicon 还是 Intel 芯片都是原生运行无需转译。部分第三方镜像站不提供 macOS 通用版那种情况下请先在系统信息里确认自己的芯片架构Apple Silicon 为 arm64 / Intel 为 x86_64再选包。Winget 渠道Windows 一条命令装完在 PowerShell 或 CMD 中执行winget install maa默认安装到C:\Users\用户名\AppData\Local\Microsoft\WinGet\Packages装完在命令行输入maa即可启动无需解压、无需单独装运行库。注意若你的 PATH 里同时装了 maa-cli二者都会响应maa命令需要用完整路径区分。Linux 及其他系统改用 maa-cliMAA GUI 暂未支持 Linux 及其他操作系统命令行方案 maa-cli 支持 Linux / macOS / Windows适合自动化脚本和无图形界面的服务器。macOS 用户可brew install MaaAssistantArknights/tap/maa-cliArch 用户可paru -S maa-cliNix 用户可nix run nixpkgs#maa-cli更多方式预编译脚本、cargo 源码编译见 docs/zh-cn/manual/cli/install.md。⚠️ maa-cli 只是命令行外壳运行任务仍需 MaaCore 及资源预编译 / 自行编译用户执行maa install自动下载官方预编译 MaaCoreNix 用户已强制依赖 MaaCore无需也不应手动安装。Windows 下安装 MAA 并验证启动步骤一把安装包解压到能写的普通目录用解压缩软件完整解压zip 包。目标目录建议D:\Tools\MAA或用户目录下的任意普通文件夹严禁解压到C:\根目录、C:\Program Files\等需要管理员权限的路径——MAA 需要写配置、缓存和日志放进系统保护目录会引发各种难排查的异常。反直觉的一点MAA 自身不需要管理员权限运行src/MaaWpfGui/app.manifest 中 UAC 级别为asInvoker随调用者权限运行。所以问题从来不是没给管理员而是目录不可写。步骤二一键修复 VC 运行库MAA 已内置 .NET 运行时自包含部署但仍依赖系统的VC Redistributable x64。进入解压后的 MAA 目录以管理员身份运行DependencySetup_依赖库安装.bat。这段脚本本质上是把一条 winget 命令包了一层彩色输出和错误处理winget install Microsoft.VCRedist.2015.x64 --override /repair /passive /norestart --uninstall-previous --accept-package-agreements --force含义是静默修复而非重装VC 2015 x64 运行库先卸载旧版本、跳过协议弹窗、不强制重启。脚本失败时会提示你系统过旧没有 winget此时按微软官网手动下载 Visual C 2015 x64 运行库安装即可。验证双击 MAA.exe 看到任务列表即成功运行库修复后重启电脑再双击MAA.exe。当主界面左侧出现开始唤醒 / 自动公招 / 基建换班 / 理智作战等勾选任务、顶部为一键长草 / 自动战斗 / 小工具 / 设置标签页时说明安装并启动成功首次启动时 MAA 会自动检查并更新游戏资源更新内容在系统空闲时自动加载无需重启。macOS 下安装 MAA 并验证启动步骤打开 dmg把 MAA.app 拖进 Applications下载MAA-版本号-macos-universal.dmg双击打开该.dmg将MAA.app拖入/Applications文件夹完成安装。验证在启动台打开 MAA从启动台Launchpad或应用程序文件夹双击MAA.app能看到主界面并正常进入设置即安装成功。macOS 首次打开若被 Gatekeeper 拦截在系统设置 → 隐私与安全性中点仍要打开即可。⚠️ macOS 版由团队少数开发者维护与 Windows 端相比功能可能有差异或滞后见 docs/zh-cn/manual/newbie.md 开篇说明Intel 芯片 Mac 更新较慢官方更推荐通过多系统装 Windows 后使用 Windows 版。连接模拟器时注意Apple Silicon 优先 PlayCover / MuMu Pro / AVDIntel 芯片优先蓝叠、夜神详见 docs/zh-cn/manual/device/macos.md。MAA 安装避坑指南四个高频故障的三段式排查坑一更新后 MAA 无法运行 / 弹出报错窗口现象某次自动更新后点MAA.exe闪退或弹红色报错框根因VC 运行库未随新版更新。MAA 是自包含部署内置 .NET但 VCRedist x64 仍靠系统提供解决重跑 MAA 目录下的DependencySetup_依赖库安装.bat或手动执行上文那条 winget 命令重启后再试。这是出现频率最高的问题优先查它。坑二启动时提示安装文件缺失现象弹窗提示部分安装文件缺失对应功能如小游戏任务无法运行根因MAA 启动时会对照包内filelist.txt清单核对文件部分文件被杀毒软件拦截或删除解决先去安全软件隔离区恢复文件并把 MAA 目录加入白名单或在弹窗内选择自动修复重下完整包。坑三杀毒软件把 MAA 报毒 / 标 PUA现象下载或运行时被 Windows Defender 等拦截报 PUA 或病毒根因自动化 / 模拟点击类工具天然容易触发启发式检测误报不等于恶意解决先确认来源可信仅官网、Releases、Winget 或官方群文件再将 MAA 目录加入白名单并向安全厂商提交误报样本不建议直接关闭系统实时防护。坑四闪退或界面渲染异常但运行库明明装过现象MAA.exe弹出悲报、闪退或 WPF 界面渲染错乱根因Nahimic 等第三方声卡 / 增强软件向 MAA 注入了 DLL干扰 WPF 渲染解决Windows 安全中心 → 应用和浏览器控制 → 攻击防护 → 程序设置添加MAA.exe并勾选禁用扩展点重启 MAA或按弹窗给出的路径把问题 DLL 重命名为.dll1使注入失效。完整步骤见 docs/zh-cn/manual/faq.md。装完之后的下一步三件事跑通第一个自动化设好模拟器分辨率按 docs/zh-cn/manual/newbie.md 的前置准备把模拟器设为横屏1280x720或1920x1080美服YostarEN玩家必须为1920x1080连接模拟器只开一个模拟器、不接其他安卓设备跟随设置指引让 MAA 自动检测多开或检测失败时参考 docs/zh-cn/manual/connection.md勾选任务Link Start拖拽左侧任务列表排序、勾选要跑的任务点右侧齿轮进详细设置然后开始第一次一键长草想全面了解功能可浏览 docs/zh-cn/manual/introduction/。【免费下载链接】MaaAssistantArknights《明日方舟》小助手全日常一键长草| A one-click tool for the daily tasks of Arknights, supporting all clients.项目地址: https://gitcode.com/GitHub_Trending/ma/MaaAssistantArknights创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考