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/MaaAssistantArknightsMaaAssistantArknights简称 MAA是《明日方舟》的日常长草助手。这里带你一步步完成 Windows 与 macOS 桌面版的下载与安装、maa-cli 命令行版的接入外加运行库补救和首次启动验证。 30 秒选对 MAA 安装方式获取路径适用系统是否需额外依赖上手成本WingetWindows 10/11无运行库随包处理最低一条命令官网 / GitHub ReleaseszipWindowsVC 运行库见依赖一节下载 解压 装运行库官网 / GitHub ReleasesdmgmacOS无最低拖一下QQ 群文件Windows / macOS同对应 zip / dmg加群找群文件Homebrew / AUR / NixmacOS / Linuxmaa install补 MaaCore低一条命令maa-cli 安装脚本Linux / macOS / Windows同上低一条脚本按你的情况对号入座下面只需看你那条路径。拿不准的默认选Windows 走 WingetMac 走 dmg服务器和 Linux 走 maa-cli。⚡ 终端一行Winget 安装 Windows 版这是 MAA Windows 安装教程里最快的路径只会双击 exe 也行。拿到包不用自己找包winget 源直接拉最新版也不用区分 zip 和架构。安装与解压winget install maa直接装到C:\Users\用户名\AppData\Local\Microsoft\WinGet\Packages自动解压无需手动操作。补依赖这条通道会顺带处理运行库一般不用管。万一之后仍提示运行库缺失直接跳到「依赖与运行库」一节。首次启动终端里敲maa即弹出主界面。提醒一句如果你机器上还装了 maa-climaa命令可能被它占用用安装目录全路径启动即可。 拖进 ApplicationsmacOS 桌面版拿到包官网或 GitHub Releases 下载MAA-版本号-macos-universal.dmg。通用版同时内置 arm64 与 x86_64 两种原生二进制官方构建脚本先分别编译两种架构再合并见 tools/build_macos_universal.zshApple Silicon 和 Intel 的 Mac 都直接跑不用先查芯片。安装与解压双击打开 dmg把MAA.app拖进/Applications。完成。补依赖不需要 VC无操作。留个底macOS 版 GUI 由团队中少数开发者维护个别功能可能与 Windows WPF 端有差异或滞后先有心理预期。首次启动启动台打开MAA首启会自动下载游戏资源窗口别急着关。 无 GUI 场景maa-cli 安装MAA GUI 不支持 Linux 等其他系统这类机器用 maa-cli。它三个平台都能跑适合服务器和自动化脚本。拿到包包管理器用户一行一个# macOS brew install MaaAssistantArknights/tap/maa-cli # Arch Linux paru -S maa-cli # Nix nix run nixpkgs#maa-cli其他发行版可用官方文档给出的一键安装脚本具体命令见 docs/zh-cn/manual/cli/install.mdRust 用户也可用 cargo 自行编译。安装与解压脚本和包管理器都自动完成无需解压。补依赖maa-cli 只是命令行壳真正跑任务还要靠 MaaCore 与资源核心在 src/MaaCore/。装完后执行一行maa installWindows 用户先装好 VC 运行库见依赖一节再执行它Nix 用户无需也不该手动装已内置。首次启动maa install跑完后即可在命令行发起日常任务之后用maa self update升级自身。 依赖与运行库MAA 运行库缺失的修复别慌更新后打不开八成就是运行库没装。MAA 已内置 .NET 运行时自包含部署真正缺的是系统的Visual C Redistributable x64。系统要求仅支持 Windows 10/11不支持 32 位与 7/8/8.1N/KN 版另需安装媒体功能包。程序请求的是asInvoker权限见 src/MaaWpfGui/app.manifest不申请管理员也因此别把它放进系统保护目录。万能修复命令管理员终端执行winget install Microsoft.VCRedist.2015.x64 --override /repair /passive /norestart --uninstall-previous --accept-package-agreements --force它等价于 tools/DependencySetup_依赖库安装.bat 封装的那条命令右键该 bat 以管理员身份运行效果相同。winget 不可用时系统太老没带 winget浏览器直接打开脚本打印的地址aka.ms/vc14/vc_redist.x64.exe下载安装。两种方式装完都重启一次电脑。 首次运行验证三个装对了的信号窗口标题呈MAA - v版本 - 服务器 - 模拟器比如 MAA - v6.9.2#0505 - 承诺#0501 - BiliBili服能看到版本号就对了日志面板右下角开始刷出正在连接模拟器……正在运行……MAA 目录自动生成config、data、debug等文件夹你的配置就存在config里。三条都对不上就翻下面的踩坑速查。⚠️ 踩坑速查症状到原因到解法架构下错x64 机器拿了 win-arm64 包、Intel Mac 拿了 arm 的 dmg→ 包与系统架构不匹配 → 重下对应包Windows 一般是MAA-版本-win-x64.zipmacOS 认准universal版。解压后闪退 / 存不住配置→ 解进了C:\、C:\Program Files这类 UAC 保护目录MAA 没有写入权限 → 整个文件夹挪到D:\MAA或用户主目录等普通路径。杀软隔离文件 / 启动提示安装文件缺失→ 自动化软件触发启发式误报 → 从隔离区恢复或把安装目录加白名单MAA 启动时会按自带文件清单核对完整性。自动更新后配置丢失 / 打不开→ 新包不带走旧配置或运行库没跟上 → 把旧目录的config、data、debug复制进新目录弹报错窗的优先重装运行库。装完之后去哪docs/zh-cn/manual/newbie.md —— 初始配置模拟器分辨率设横屏 1280x720 或 1920x1080美服必须 1080pdocs/zh-cn/manual/connection.md —— 把 MAA 连上你的模拟器docs/zh-cn/manual/introduction/ —— 功能清单长草、肉鸽、公招识别docs/zh-cn/manual/faq.md —— 常见问题运行库问题置顶docs/zh-cn/manual/device/ —— 模拟器与设备支持情况【免费下载链接】MaaAssistantArknights《明日方舟》小助手全日常一键长草| A one-click tool for the daily tasks of Arknights, supporting all clients.项目地址: https://gitcode.com/GitHub_Trending/ma/MaaAssistantArknights创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 MAA 安装一步到位完全指南：Windows / macOS / maa-cli
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/MaaAssistantArknightsMaaAssistantArknights简称 MAA是《明日方舟》的日常长草助手。这里带你一步步完成 Windows 与 macOS 桌面版的下载与安装、maa-cli 命令行版的接入外加运行库补救和首次启动验证。 30 秒选对 MAA 安装方式获取路径适用系统是否需额外依赖上手成本WingetWindows 10/11无运行库随包处理最低一条命令官网 / GitHub ReleaseszipWindowsVC 运行库见依赖一节下载 解压 装运行库官网 / GitHub ReleasesdmgmacOS无最低拖一下QQ 群文件Windows / macOS同对应 zip / dmg加群找群文件Homebrew / AUR / NixmacOS / Linuxmaa install补 MaaCore低一条命令maa-cli 安装脚本Linux / macOS / Windows同上低一条脚本按你的情况对号入座下面只需看你那条路径。拿不准的默认选Windows 走 WingetMac 走 dmg服务器和 Linux 走 maa-cli。⚡ 终端一行Winget 安装 Windows 版这是 MAA Windows 安装教程里最快的路径只会双击 exe 也行。拿到包不用自己找包winget 源直接拉最新版也不用区分 zip 和架构。安装与解压winget install maa直接装到C:\Users\用户名\AppData\Local\Microsoft\WinGet\Packages自动解压无需手动操作。补依赖这条通道会顺带处理运行库一般不用管。万一之后仍提示运行库缺失直接跳到「依赖与运行库」一节。首次启动终端里敲maa即弹出主界面。提醒一句如果你机器上还装了 maa-climaa命令可能被它占用用安装目录全路径启动即可。 拖进 ApplicationsmacOS 桌面版拿到包官网或 GitHub Releases 下载MAA-版本号-macos-universal.dmg。通用版同时内置 arm64 与 x86_64 两种原生二进制官方构建脚本先分别编译两种架构再合并见 tools/build_macos_universal.zshApple Silicon 和 Intel 的 Mac 都直接跑不用先查芯片。安装与解压双击打开 dmg把MAA.app拖进/Applications。完成。补依赖不需要 VC无操作。留个底macOS 版 GUI 由团队中少数开发者维护个别功能可能与 Windows WPF 端有差异或滞后先有心理预期。首次启动启动台打开MAA首启会自动下载游戏资源窗口别急着关。 无 GUI 场景maa-cli 安装MAA GUI 不支持 Linux 等其他系统这类机器用 maa-cli。它三个平台都能跑适合服务器和自动化脚本。拿到包包管理器用户一行一个# macOS brew install MaaAssistantArknights/tap/maa-cli # Arch Linux paru -S maa-cli # Nix nix run nixpkgs#maa-cli其他发行版可用官方文档给出的一键安装脚本具体命令见 docs/zh-cn/manual/cli/install.mdRust 用户也可用 cargo 自行编译。安装与解压脚本和包管理器都自动完成无需解压。补依赖maa-cli 只是命令行壳真正跑任务还要靠 MaaCore 与资源核心在 src/MaaCore/。装完后执行一行maa installWindows 用户先装好 VC 运行库见依赖一节再执行它Nix 用户无需也不该手动装已内置。首次启动maa install跑完后即可在命令行发起日常任务之后用maa self update升级自身。 依赖与运行库MAA 运行库缺失的修复别慌更新后打不开八成就是运行库没装。MAA 已内置 .NET 运行时自包含部署真正缺的是系统的Visual C Redistributable x64。系统要求仅支持 Windows 10/11不支持 32 位与 7/8/8.1N/KN 版另需安装媒体功能包。程序请求的是asInvoker权限见 src/MaaWpfGui/app.manifest不申请管理员也因此别把它放进系统保护目录。万能修复命令管理员终端执行winget install Microsoft.VCRedist.2015.x64 --override /repair /passive /norestart --uninstall-previous --accept-package-agreements --force它等价于 tools/DependencySetup_依赖库安装.bat 封装的那条命令右键该 bat 以管理员身份运行效果相同。winget 不可用时系统太老没带 winget浏览器直接打开脚本打印的地址aka.ms/vc14/vc_redist.x64.exe下载安装。两种方式装完都重启一次电脑。 首次运行验证三个装对了的信号窗口标题呈MAA - v版本 - 服务器 - 模拟器比如 MAA - v6.9.2#0505 - 承诺#0501 - BiliBili服能看到版本号就对了日志面板右下角开始刷出正在连接模拟器……正在运行……MAA 目录自动生成config、data、debug等文件夹你的配置就存在config里。三条都对不上就翻下面的踩坑速查。⚠️ 踩坑速查症状到原因到解法架构下错x64 机器拿了 win-arm64 包、Intel Mac 拿了 arm 的 dmg→ 包与系统架构不匹配 → 重下对应包Windows 一般是MAA-版本-win-x64.zipmacOS 认准universal版。解压后闪退 / 存不住配置→ 解进了C:\、C:\Program Files这类 UAC 保护目录MAA 没有写入权限 → 整个文件夹挪到D:\MAA或用户主目录等普通路径。杀软隔离文件 / 启动提示安装文件缺失→ 自动化软件触发启发式误报 → 从隔离区恢复或把安装目录加白名单MAA 启动时会按自带文件清单核对完整性。自动更新后配置丢失 / 打不开→ 新包不带走旧配置或运行库没跟上 → 把旧目录的config、data、debug复制进新目录弹报错窗的优先重装运行库。装完之后去哪docs/zh-cn/manual/newbie.md —— 初始配置模拟器分辨率设横屏 1280x720 或 1920x1080美服必须 1080pdocs/zh-cn/manual/connection.md —— 把 MAA 连上你的模拟器docs/zh-cn/manual/introduction/ —— 功能清单长草、肉鸽、公招识别docs/zh-cn/manual/faq.md —— 常见问题运行库问题置顶docs/zh-cn/manual/device/ —— 模拟器与设备支持情况【免费下载链接】MaaAssistantArknights《明日方舟》小助手全日常一键长草| A one-click tool for the daily tasks of Arknights, supporting all clients.项目地址: https://gitcode.com/GitHub_Trending/ma/MaaAssistantArknights创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考