GUI 自动化AI 应用【免费下载链接】M9A重返未来1999 小助手 | Assistant For Reverse: 1999项目地址https://gitcode.com/gh_mirrors/m9/M9A点击查看免费下载导读本文是《重返未来1999》自动化助手 M9AAssistant For Reverse: 1999的入门实战指南围绕官方新手文档 docs/en_us/manual/newbie.md 展开覆盖从系统版本确认、运行环境安装、安装包下载、模拟器与分辨率设置到图形界面MFAAvalonia / MXU首次启动与各项配置的完整链路。读完本文你将能够独立完成 M9A 从零到可运行的全流程搭建并理解「资源类型 / 连接 / 更新设置 / 启动设置」等核心配置项的底层逻辑与避坑要点顺利开启自动化日常。说明本文引用的源码路径均指当前开源仓库gh_mirrors/m9/M9A内的相对路径可对照 docs/en_us/manual/newbie.md 原文继续查阅。一、前置准备确认系统与设备M9A 是一个跨平台助手官方文档在 newbie.md 中首先要求使用者确认自己的操作系统与设备形态因为不同平台的环境要求、启动方式与下载包完全不同。汇总如下表项目WindowsmacOSLinuxAndroid系统要求Windows 10 及以上自行尝试自行尝试Android 9 及以上需要配置环境是是是否需要模拟器是是模拟器或容器化安卓否使用方式图形界面或命令行图形界面或命令行图形界面或命令行图形界面平台备注要点Windows 用户绝大多数情况下请下载x86_64架构的安装包。Mac 用户M9A 同时支持 Apple SiliconM 系列与 Intel 芯片 Mac但官方更推荐 Intel 芯片 Mac 用户使用系统自带的多系统功能安装 Windows并配合 Windows 版 M9A 与模拟器使用。Android 用户官方在 Releases 发布 Android 客户端 APK。真机推荐M9A-版本-arm64-v8a.apk模拟器等 x86 环境使用M9A-版本-x86_64.apk要求 Android 9 及以上首次启动需授予通知权限与电池白名单并通过 Shizuku 或 root 完成授权。二、安装运行环境官方文档提示用户可以跳过本节直接进入「下载安装包 → 解压 → 运行依赖安装脚本」若脚本自动安装失败再回头参照本节。不同启动方式对运行环境的依赖如下表运行环境Windows 命令行MaaPiCliWindows 图形界面MFAAWindows 图形界面MXUmacOSLinuxVCRedist是是是否否.NET 10否是否图形界面需安装图形界面需安装Python压缩包自带压缩包自带压缩包自带压缩包自带压缩包自带1. VCRedist x64Windows 用户必须安装 VCRedist x64这是运行 M9A无论命令行版还是图形界面版的基础需求。两种安装方式直接下载 vc_redist.x64 安装。以管理员身份打开「命令提示符」或「PowerShell管理员」执行winget install Microsoft.VCRedist.2017.x642. .NET 10使用MFAAvaloniaMFA图形界面的用户需要自行下载安装适配系统的 .NET 10平台需要下载安装程序Windows.NET Desktop Runtimex64官方安装包或wingetmacOS / Linux.NET Runtimedotnet-install.shWindows 用户也可用 winget 安装winget install Microsoft.DotNet.DesktopRuntime.10值得注意的是MXUMaaX UI与命令行 MaaPiCli 均不需要 .NETLinux 图形界面需求同 macOS。3. Python各平台压缩包均自带 Python 运行时与全部依赖无需额外安装。压缩包内的python/目录即 M9A 使用的 Python 运行时Python 3.13依赖已随包预装启动时无需联网。因此你不需要安装系统 Python、创建虚拟环境或手动安装任何依赖。这一点在源码中也有印证仓库入口 agent/main.py 第一行就做了版本门禁——if sys.version_info (3, 13) or sys.version_info (3, 14): raise SystemExit(Python 3.13,3.14 is required, got sys.version.split()[0])即 M9A 的 Python 侧实现要求3.13,3.14这与发行包内置 Python 3.13 完全一致。此外agent/maafw_paths.py 展示了发行包中 MaaFramework 原生库的布局复用逻辑MFAA 布局放在runtimes/os-arch/nativeMXU 布局放在maafw/CLI 壳MaaPiCli的包则把库平铺在包根——这正是「压缩包自带一切、启动无需联网」的实现基础。三、下载正确的版本M9A 下载更新地址为 GitHub Releases 页在Assets处选择适配系统的最新版压缩包。国内用户可通过 Mirror 酱MirrorChyan高速下载。各平台需要下载的文件平台需要下载WindowsM9A-win-x86_64-vXXX.zipmacOSM9A-macos-x86_64-vXXX.tar.gz或M9A-macos-aarch64-vXXX.tar.gz取决于架构LinuxM9A-linux-x86_64-vXXX.tar.gz或M9A-linux-aarch64-vXXX.tar.gz取决于架构AndroidM9A-版本-universal.apk、M9A-版本-arm64-v8a.apk真机推荐、M9A-版本-x86_64.apkx86 模拟器Mac 用户如何查看处理器架构点击屏幕左上角的苹果标志。选择「关于本机」查看处理器信息。Intel X86 处理器 → 下载M9A-macos-x86_64-vXXX.tar.gzApple SiliconM1、M2 等 ARM 架构→ 下载M9A-macos-aarch64-vXXX.tar.gz。四、确认模拟器与设备支持项目WindowsmacOSLinuxAndroid模拟器支持支持主流模拟器支持主流模拟器自行尝试/需要 ADB 功能是是是是模拟器支持细节可参阅 MAA 官方文档Windows / macOS Apple Silicon / macOS Intel / Linux 模拟器与容器 / Android 实体设备各章节。仅供参考最终以 MaaFramework 实际支持情况为准。五、正确设置分辨率M9A 支持主流模拟器与 PC 客户端但必须将模拟器与 PC 客户端分辨率设置为屏幕方向横屏宽高比16:9推荐也是最低分辨率1280x720不符合该要求导致的运行报错不会被解决。此外修改分辨率后模拟器主页应为横屏平板版不要选择竖屏手机版。国际服 PC 端使用初始化脚本使用国际服 PC 客户端时若无法改成 16:9 比例可使用官方提供的PC 端初始化脚本。该脚本位于仓库的 tools/registry/游戏PC端注册表修改_ModifyPCRegistry.bat其核心逻辑是调用同目录下的 tools/registry/ModifyPCRegistry.ps1。脚本使用步骤在 M9A 根目录找到「游戏PC端注册表修改_ModifyPCRegistry.bat」双击启动脚本会自动请求管理员权限因为需要写注册表。步骤 0打开后选择选项 3 切换服务器EN国际服或 JP日服当前服务器显示在菜单顶部。步骤 1在命令行输入1进入「从预设分辨率中选择」。步骤 2根据想选择的分辨率输入a/b/c/d实际脚本内置 6 档预设见下文。从 ModifyPCRegistry.ps1 源码可以看到全部 6 档预设分辨率与对应字母选项分辨率选项分辨率a3840 * 2160d1600 * 900b2560 * 1440e1366 * 768c1920 * 1080f1280 * 720该脚本的安全设计值得关注自动备份修改前会用reg export导出整个注册表键到bluepoch_registry_backup.reg并提供-Restore参数一键还原ModifyPCRegistry.ps1。保留原值类型写入时通过GetValueKind读取现有值的类型REG_BINARY / REG_SZ / REG_DWORD 等按类型安全写入避免类型不匹配导致游戏读不到配置ModifyPCRegistry.ps1。同步设置游戏默认项设置分辨率的同时会把Screenmanager Fullscreen mode_h3630240806设为 3窗口模式并根据服务器把SdkLanguage_h2445173579设为enEN 服或jaJP 服、CurLanguageType_h2647185547设为 1ModifyPCRegistry.ps1。注册表键按服务器区分EN 服为HKCU:\Software\bluepoch\Reverse: 1999JP 服为HKCU:\Software\bluepoch\リバース1999ModifyPCRegistry.ps1。高级用户也可以绕过交互菜单直接以参数方式调用 PowerShell 脚本例如# 备份并设置为 1920 x 1080同时写入游戏默认项 pwsh .\ModifyPCRegistry.ps1 -KeyPath HKCU:\Software\bluepoch -ValueName ResolutionRatio_h997442698 -Width 1920 -Height 1080 -BackupFile .\bluepoch_backup.reg # 从备份恢复 pwsh .\ModifyPCRegistry.ps1 -KeyPath HKCU:\Software\bluepoch -BackupFile .\bluepoch_backup.reg -Restore六、开始使用各平台启动方式M9A 支持通过命令行MaaPiCli和图形界面MFAAvalonia / MXU使用但使用前需正确解压压缩包并将游戏内显示语言改为简体中文。重要提醒不要在压缩软件内直接打开程序对于一般用户官方推荐通过MFAAvaloniaMFA或MXU使用 M9A。Windows确认解压完整并确保将 M9A 解压到独立文件夹推荐路径如D:\M9A。除关闭内建的 Administrator 账号外请勿解压到C:\、C:\Program Files\等需要 UAC 权限的路径。解压后直接运行M9A.exe即可。macOS打开终端解压分发压缩包二选一# 选项1解压到系统目录需要管理员权限 sudo mkdir -p /usr/local/bin/M9A sudo tar -xzf 下载的M9A压缩包路径 -C /usr/local/bin/M9A # 选项2解压到用户目录推荐无需 sudo mkdir -p ~/M9A tar -xzf 下载的M9A压缩包路径 -C ~/M9A进入解压目录并运行程序想用图形界面同样执行M9Acd /usr/local/bin/M9A ./M9AGatekeeper 安全提示处理macOS 10.15Catalina及更高版本中Gatekeeper 可能阻止运行未签名应用。若遇到「无法打开因为无法验证开发者」等错误任选以下方案# 方案1移除隔离属性推荐以实际路径为准 sudo xattr -rd com.apple.quarantine /usr/local/bin/M9A/M9A # 或用户目录版本xattr -rd com.apple.quarantine ~/M9A/M9A # 方案2添加到 Gatekeeper 白名单 sudo spctl --add /usr/local/bin/M9A/M9A # 或用户目录版本spctl --add ~/M9A/M9A # 方案3一次性处理整个目录 sudo xattr -rd com.apple.quarantine /usr/local/bin/M9A/* # 或用户目录版本xattr -rd com.apple.quarantine ~/M9A/*Linux与 macOS 相同下载对应版本的压缩包解压后运行M9A即可。Android从 Releases 下载对应架构的 APK 安装真机选arm64-v8ax86 模拟器选x86_64不确定选universal。启动流程首次启动授予通知权限并加入电池白名单后台挂机、定时触发与运行进度通知都依赖这些权限。选择Shizuku 或 root完成授权并等待服务连接。Shizuku 需另行安装启动Android 11 及以上可在设备上通过无线调试直接启动更低版本无 root需一台电脑通过 ADB 启动一次详见 Shizuku 官方文档。首次启动会自动解包任务资源。在应用内选择服务器、勾选任务后开始运行无需配置 ADB 连接。Android 运行模式说明任务跑在应用创建的虚拟屏上后台模式挂机期间手机可正常使用、可熄屏分辨率在应用内选择720P / 1080P也可切换前台模式直接操作当前屏幕。七、配置 M9A图形界面全流程部分配置项在配置错误或未配置时会导致 M9A运行异常因此建议开始使用前完整阅读本节。本章主要介绍图形界面MFAAvalonia / MXU配置方式若使用命令行版本MaaPiCli请参考 MaaPiCli 操作说明。7.1 首次启动与主界面MFA 主界面包含七大板块资源类型、任务列表、任务设置、任务说明、连接、日志、实时视图。MXU 主界面包含五大板块任务列表、任务管理、连接设置、实时视图、运行日志。⚠️首次启动注意事项首次启动 MFA 时 M9A 将进行初始化。在日志板块显示「AgentServer 启动」后直到看见「任务已全部完成」之前请不要点击停止任务。M9A 运行任务时无法修改主界面的部分设置如连接板块此时可先进入全局设置界面配置。7.2 M9A 设置界面点击主界面左下角的齿轮按钮进入设置界面。使用 MFA 更新相关功能的用户应配置更新设置有多开和自启需求的用户应配置启动设置。更新设置资源下载源指定更新时使用的下载源。CDK指 Mirror 酱 CDKToken指 GitHub Personal Access Token。配置错误时 M9A 将无法正常使用更新相关功能。详细说明资源下载源默认使用 Mirror 酱未购买 Mirror 酱的用户请改为GitHub。CDK 或 Token通过 Mirror 酱更新的用户填写 CDK通过 GitHub 更新的用户可填写 Token 以提高 GitHub API 访问速率限制GitHub 无 Token 时匿名请求受速率限制容易导致更新失败典型表现见文档中的 rate limit 截图。启动设置软件路径指定模拟器的可执行文件路径。配置错误时 M9A 将无法正确启动模拟器。附加命令指定模拟器启动时的参数一般而言仅用于配置模拟器多开号。软件路径示例MuMu 12 模拟器版本路径格式MuMu 12 模拟器 5.0 以下{安装目录}\shell\MuMuPlayer.exeMuMu 12 模拟器 5.0 及以上{安装目录}\nx_device\12.0\shell\MuMuNxDevice.exe附加命令示例多开号 X模拟器参数格式示例MuMu 模拟器-v X-v 0雷电模拟器LDPlayerindexXindex0MuMu 模拟器自动获取路径确保桌面有安装 1999 应用的模拟器快捷方式点击软件路径输入框右侧的图标进入文件选择界面选择桌面上的 1999 快捷方式路径将自动填入。7.3 M9A 主界面核心配置至少需要配置资源类型和连接两项配置错误时无法正常使用 M9A。资源类型需选择模拟器中安装的 1999 区服。目前支持官服、B服、国际服EN、国际服JP、国际服KR、港澳台服、OPPO服、小米服、华为服。区服选择之所以重要是因为不同区服在功能实现上存在差异。仓库中 data/activity/cn.json、data/activity/en.json、data/activity/jp.json、data/activity/tw.json 等按区服组织的资源文件正是各服活动时间、活动内容差异的数据支撑。CLI 手册 docs/en_us/manual/cli.md 也明确说明选择资源主要关系到「启动游戏、银行购物、活动刷取」等区服间有差异的功能。连接M9A 需要正确的ADB 连接才能在目标模拟器执行任务。绝大多数情况下只需保持有且仅有目标模拟器启动点击「刷新」即可完成连接。连接区域关键元素当前控制器显示当前连接的 ADB 控制器模拟器和 ADB 地址。自定义修改 ADB 参数一般无需手动修改。重新连接重新连接已选定模拟器。刷新重新检测所有已启动模拟器。连接状态绿色为已连接。若需手动配置 ADB 参数参考 连接设置其中给出了常见模拟器的 ADB 连接地址MuMu 12 为127.0.0.1:16384系列端口、雷电 9 为emulator-5554系列、蓝叠 5 为127.0.0.1:5555系列等以及触摸模式Minitouch / MaaTouch / ADB Input的选择建议。PC 客户端连接使用国际服 PC 端时在连接区域的控制器类型中选择PC即可自动检测并连接已打开的 PC 端窗口。⚠️ 连接 PC 时请以管理员模式运行 M9A并不要将游戏窗口最小化PlayCover 连接macOSMac 用户使用 PlayCover 时在连接区域的控制器类型中选择PlayCover适用于 Apple Silicon 芯片场景。7.4 任务列表MFA 使用方式任务名前的复选框启用/禁用任务右键单击复选框将单次执行该任务点击右上角「添加任务」按钮可添加当前列表不可见任务或重复已有任务点击任务右侧按钮查看任务设置与任务说明拖动任务名可调整任务顺序。MXU 使用方式复选框启用/禁用任务点击左下角「添加任务」按钮添加任务右键单击任务打开管理菜单左键单击任务展开选项查看任务设置与任务说明长按拖动任务左侧按钮调整任务顺序。⚠️重要大部分任务需在使用前正确配置少部分任务还需根据任务说明在特定场景执行。启用任务前请务必阅读并理解该任务的任务说明并结合实际情况配置任务设置。更多任务说明请参阅 功能介绍。仓库中 tasks/ 目录集中存放了各任务的定义文件如 tasks/Combat.json、tasks/Wilderness.json、tasks/Bank.json 等结合 agent/custom/action/ 与 agent/custom/reco/ 中的 Python 动作与识别实现可深入理解每个任务的行为逻辑。八、配置文件资源热更设置M9A 支持通过config/hot_update.json文件配置部分资源如活动开放时间的热更相关设置。示例{ enable_hot_update: true, // 是否启用部分资源热更默认 true }从源码看热更机制的实现在 agent/agent_runtime.py启动时_read_hot_update_config()读取config/hot_update.json文件不存在或读取失败时回退到默认值{enable_hot_update: True}agent/agent_runtime.py。若配置为enable_hot_update: false启动流程将直接跳过部分资源热更agent/agent_runtime.py。热更基于 manifest 时间戳优化通过check_manifest_updates()只更新有变化的资源清单再交给check_and_update_resources()拉取文件agent/agent_runtime.py。热更失败时会生成用户可读的说明指出受影响的功能范围如「活动代币刷取 / 复刻活动」「常规作战」「使用兑换码」「局外演绎无声综合征」与重试方式agent/agent_runtime.py并在下次启动时自动重试。结语从安装到自动化的一站式路径至此你已经走完了 M9A 的完整上手链路确认平台环境 → 安装 VCRedist / .NET → 下载对应架构安装包 → 按 16:9 横屏设置模拟器/PC 分辨率必要时使用注册表初始化脚本→ 解压并启动 → 在图形界面中完成「资源类型 连接」两项必备配置 → 按需配置更新源、启动路径与任务列表。剩余的可玩空间在于 功能介绍 中列举的各类自动化任务常规作战、活动代币刷取、银行购物、领取奖励、切换账号、局外演绎等以及命令行用户可参考的 MaaPiCli 操作说明——从第一天的环境搭建到每天一次的挂机自动化M9A 的入门曲线就此打通。赞分享GUI 自动化AI 应用【免费下载链接】M9A重返未来1999 小助手 | Assistant For Reverse: 1999项目地址https://gitcode.com/gh_mirrors/m9/M9A点击查看免费下载相关推荐UVdesk Community Helpdesk 安装全指南Ubuntu 环境准备、Apache/PHP 配置与 Composer 部署实战UVdesk Community Helpdesk 安装全指南Ubuntu 环境准备、Apache/PHP 配置与 Composer 部署实战 导读 本篇指南后端企业应用amlogic-s9xxx-armbian图形界面安装LXDE与XFCE桌面环境部署教程amlogic s9xxx armbian图形界面安装LXDE与XFCE桌面环境部署教程 前言为什么选择轻量级桌面环境 你是否曾想将闲置的电视盒子改造成低嵌入式开发工具构建工具操作系统vLLM Intel XPU 部署实战环境准备、安装方式与分布式推理配置指南vLLM Intel XPU 部署实战环境准备、安装方式与分布式推理配置指南 导读 本文基于 vLLM 官方安装文档的 Intel XPU 章节系统讲解如何人工智能大模型模型推理服务推理引擎本地部署上一篇PHP-CS-Fixer integer_literal_case 规则详解统一整数字面量大小写规范下一篇EMQX Message Streams 消息流功能实战基于 Topic Filter 的持久化消息集合与 $s/ 消费协议创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考