下载并运行 2.0
本篇文章用于介绍MaaGF1在v2.0.0之后的版本中的下载、使用方式。
一、下载
1.1 基础说明
在releases页面中包含了历史发行版本,其中:
latest标签表示该发行包为稳定版,功能相对稳定;Pre-release标签表示该发行包为预览版,包含测试功能。
1.2 Release页面介绍
以latest为例,页面主要包含如下内容:
- 标题
- 稳定版标题一般为
Operation Cube .I、Singularity .II等,其含义对应《少女前线》的各项战役,如“魔方行动”、“坍塌点”; - 预览版标题一般为
v2.0.0-alpha.2、v2.0.0-beta.1等,主要用作集成、测试使用,其中alpha稳定性相对beta更差。
- 稳定版标题一般为
- 正文
- 第一行包含了具体的
tag和日期,用于确定具体的版本,如:2.0.0-alpha.2 (2026-03-10); - 其他章节包含了如下的信息:
集成、新增、修复、优化等内容,用于提示版本更新内容; - 最后一行一般以
Changelog结尾,包含两次release之间的diff信息。
- 第一行包含了具体的
- Assets
- 在最下方的
Assets一栏中,包含了MaaGF1的GUI(MFA)运行版,其中: - 命名规则为:
MaaGF1-GUI-vA.B.C-ARCH(-Agent).zip;vA.B.C对应版本编号,例如v2.0.0;ARCH为运行平台架构,仅支持aarch64或x86-64;- 操作系统仅发布
Windows,暂未集成Linux和OS X; Agent后缀表示启用了MaaFramework Agent的版本,部分任务需要依赖此项功能。
- 最后的
MaaGF1-Resource-vA.B.C.zip为资源包,可以同于vA.B.*之间的轻量化更新,而无需删除、重新下载整包。
- 在最下方的
因此,下载MaaGF1-GUI只需要:
- 寻找对应版本的Release;
- 在Assets一栏中下载对应架构、功能的
zip文件即可。
1.3 Agent
当前,依赖于-Agent的任务有:
- Ad零元购。
二、运行
下载*.zip压缩包并解压后,运行其中的MFAAvalonia.exe,该程序有如下依赖:
.Net Runtime> 10.0VC++> 14.4
在
1.8之后,MFAAvalonia在根目录下添加了一键安装依赖的脚本,DependencySetup_依赖库安装_win.bat。
运行MFAAvalonia后,其界面如下:

在MFAAvalonia中存在多个子窗口:
- 资源类型:目前支持国服和美服;
- 控制器类型:目前仅支持桌面端(Win32);
- 当前控制器:用于选择游戏窗口;
- 任务列表:用于选择MaaGF1中的不同脚本;
- 任务设置:用于选择任务列表中的脚本子选项,例如选择不同打捞人形等;
- 任务说明:关于任务列表中所选脚本的简要说明;
- 实时视图:用于预览MaaFramework捕获到的图片,可以在设置中关闭;
- 日志:用于查看
MaaFw或Agent的日志信息。
三、设置
3.1 游戏中的设置
MaaGF1要求游戏配置如下:
- 窗口模式、
1280x720; - 记录上次完成关卡时镜头缩放;
- 不要最小化游戏窗口。
3.2 如何运行脚本
以DLZ版炸山为例:
- 勾选
3.资源 - DLZ版炸山; - 选择
重复次数,其中-1表示无限次重复; - 其他配置参考相关文档。
3.3 MaaGF1-GUI的设置
在v2.0.0,即MFAAvalonia 2.10.8之后添加了如此的设置:
- 运行设置
- 如不需要调试信息,可以关闭
截图保存功能; - 如需要节省CPU资源,可以关闭
实时视图功能。
- 如不需要调试信息,可以关闭
- 连接设置
- 默认采用
PrintWindow、SendInput(Seize); - 如果要使用后台点击,请选择
鼠标输入&键盘输入为PostMessageWithWindowPos,同时可以将窗口放到桌面 2或其他位置。
- 默认采用
- 资源更新
MaaGF1/MFAAvalonia默认屏蔽了全部的更新功能;资源更新和重新下载资源全量包被替换为了MaaGF1中的./tools/nadia/updater.ps1,通过Powershell的wget实现同版本轻量化更新。