MaaAssistantArknights 如何安装部署Windows、macOS、Linux 与 maa-cli 首次跑通实战指南【免费下载链接】MaaAssistantArknights《明日方舟》小助手全日常一键长草| A one-click tool for the daily tasks of Arknights, supporting all clients.项目地址: https://gitcode.com/GitHub_Trending/ma/MaaAssistantArknightsMaaAssistantArknightsMAA替你把《明日方舟》的登录、刷材料、公招、基建换班这些每天重复点几十次的活接管了省掉的是盯模拟器、排队点按钮、记哪关刷过哪关没刷的整套重复劳动。它覆盖 Windows 与 macOS 的图形界面GUI以及 Linux、macOS、Windows 三平台通用的 maa-cli 命令行形态本文按环境核对 → 落地路径 → 跑通动作 → 启动排错的顺序给到能独立装完、配好、跑通第一个日常、并排掉常见启动故障的完整路径。环境匹配矩阵该拿哪个文件平台芯片 / 架构最低系统版本对应发布包命名规则Windowsx64Windows 10x64MAA-版本-win-x64.zipWindowsARM64Windows 11 on ARMMAA-版本-win-arm64.zipmacOSApple Siliconarm64/ Intelx86_64见 GitHub Releases 对应包MAA-版本-macos-universal.dmg双架构通用Linuxx64 / arm64无头服务器或桌面均可GUI 不支持通过 maa-cli 使用无独立 GUI 包三点特殊情况先记住Windows N/KN 版欧洲/韩国需另装媒体功能包。三条落地路径按省事程度排路径 A零配置包管理器 / 一键脚本Windowswingetwinget install --id MaaAssistantArknights.MaaAssistantArknights --exact --source winget验证命令行输入maa --version有版本输出即装好--source winget指定只走 winget 源可避开代理环境下msstore源证书校验失败错误码0x8a15005e。macOS / Linuxbrew、paru、nixbrew install MaaAssistantArknights/tap/maa-cli paru -S maa-cli nix run nixpkgs#maa-cli验证maa --version。⚠️ 最高频坑winget / brew 装完 GUI 或 CLI 后启动前还要先修 VC 运行库见下一节跳过这一步大概率闪退。路径 B手动下载官网 / Releases进官网或 GitHub Releases 下载页对照上表选包——官网会自动推荐正确架构手动下载则必须自己核对文件名里的平台-架构与本机一致。Windows完整解压 zip得到含MAA.exe的文件夹macOS双击.dmg把MAA.app拖进/Applications。Windows 唯一硬性约束别把 MAA 放进需要 UAC 提权的目录C:\根、C:\Program Files\等——MAA 的 UAC 级别是asInvoker本就不需要管理员身份放进受保护目录反而会因无法写入config/cache/debug而表现异常。⚠️ 最高频坑在 ARM 芯片机器上错拿了 x64 包或反之启动即闪退且无任何提示。路径 C源码编译面向有构建环境的用户入口仓库根 CMakeLists.txtC 主程序CMake ≥ 3.24maa-cliRust 部分MSRV 为 1.88建议始终用最新工具链macOS 通用包由 tools/build_macos_universal.zsh 对arm64与x86_64各做一轮完整 CMake 构建后合并两种芯片上都是原生运行。Nix 用户的依赖已内置无需手动处理。⚠️ 最高频坑工具链低于 MSRV 直接编译失败先升级 Rust / CMake 再谈其他。装完到跑通之间还差什么Windows以管理员身份双击DependencySetup_依赖库安装.bat位于tools/目录修复 VC 运行库→ MAA 采用自包含部署已内置 .NET 运行时但系统层的 VCRedist x64 仍依赖脚本本质是静默修复Microsoft.VCRedist.2015.x64包 → 完成后重启再启动MAA.exe不再闪退即通过。maa-cli运行maa install拉取 MaaCore 与游戏资源→ maa-cli 只是命令行界面跑任务必须有 MaaCore → 终端执行maa --version与maa主菜单均正常返回即通过Nix 用户依赖已内置跳过此步。把模拟器分辨率设为横屏1280x720或1920x1080美服YostarEN玩家必须1920x1080→ MAA 的模板匹配基于固定分辨率训练错分辨率会导致识别全乱 → 模拟器内确认分辨率后MAA 首次启动能自动检测到模拟器即通过。首次启动 MAA 后按引导完成「连接设置」→ MAA 通过 ADB 与模拟器通信首次启动会引导自动检测 → 在「MAA 设置 → 连接设置」看到已连接的模拟器条目且「近 30 次截图耗时」有数值即通过。勾选一个任务如「开始唤醒」点「开始」看日志区滚动→ 这是最小闭环验证 → 日志区出现任务条目并最终显示「完成」即跑通。启动排错以「你看到的现象」为锚点现象双击MAA.exe闪退或弹出报错窗口根因VC 运行库未更新FAQ 置顶就是它出现率最高。 动作以管理员身份重跑tools/DependencySetup_依赖库安装.bat或在终端执行下面这行后重启winget install Microsoft.VCRedist.2015.x64 --override /repair /passive /norestart --uninstall-previous --accept-package-agreements --force现象解压后的文件夹看着不全找不到MAA.exe或目录结构不对根因下成了拆分后的零部件包不是完整安装包。 动作重新从官网或 Releases 拿完整MAA-版本-win-x64.zip勿选win-arm64版。现象杀软报警MAA.exe被隔离根因自动化工具触发杀毒软件启发式检测误报并不一定代表恶意行为。 动作确认下载来源官网 / GitHub Releases / Winget / 官方 QQ 群文件可信后去隔离区恢复文件并把安装目录加白名单同时向安全厂商提交误报样本不建议直接关实时防护。现象启动时弹「安装文件缺失」根因启动时 MAA 对照filelist.txt做文件清单完整性校验部分文件此前被安全软件拦过。 动作到安全软件隔离区恢复被删文件或在弹窗里选「自动修复」会重新下载完整包并在重启后恢复。现象Windows N/KN 版启动失败或媒体相关功能异常根因N/KN 版系统默认不带媒体组件。 动作安装微软官方的媒体功能包后重启。以上都没命中查 docs/zh-cn/manual/faq.md置顶的运行库部分覆盖了绝大多数启动失败场景或在 MAA 内「设置 → 问题反馈 → 生成日志压缩包」带上日志去 GitHub Issues 反馈若完全无法启动手动把debug/config/cache三个文件夹打包后一并提供。下一步去哪首次配置模拟器连接与初始任务docs/zh-cn/manual/newbie.md想看 MAA 能干什么自动基建换班、自动肉鸽、公招识别、自动战斗等docs/zh-cn/manual/introduction/README.mdmaa-cli 的安装、编译与 MaaCore 更新细节docs/zh-cn/manual/cli/install.md【免费下载链接】MaaAssistantArknights《明日方舟》小助手全日常一键长草| A one-click tool for the daily tasks of Arknights, supporting all clients.项目地址: https://gitcode.com/GitHub_Trending/ma/MaaAssistantArknights创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
