开发工具介绍

Maa调试/开发工具总览：MaaFramework#社区项目

工具	简介	特色功能
MaaDebugger	独立调试工具	调试细节清晰
Maa Pipeline Support	VSCode 插件，提供调试、截图、获取 ROI 、取色等功能	调试、截图、取ROI一体化
MFA Tools Plus	独立截图、获取 ROI 、滑动、文字及取色工具	实时预览，专门的滑动、取色工具模块
MaaLogAnalyzer	可视化分析基于 MaaFramework 开发应用的日志	日志分析，快速定位问题
MaaPipelineExtremer - Editor	MPE网站，可视化编辑和分析MaaLYSK的流程代码	可视化流程，便于梳理思路
MAA-pipeline-generate	多节点生成工具	大批量制作仅有细微差异的 pipeline 场景

Maa Pipeline Support

官方使用教程：专用 VSCode 插件教程 | MAA 文档站

1. 安装

在VScode插件模块中搜索Maa Pipeline Support

2. 连接

打开插件页面，连接模拟器，以进行截图、调试等操作

编辑好pipeline对应的interface后，想看选项、完整的一个任务能不能正常实现，也在此页面进行任务选择与启动。

3. 截图、ROI

打开插件截图小工具：

Ctrl+Shift+P打开指令页面，输入maa（或者在maa插件页面点击按钮启动）

小工具页面：

4. 调试

• 执行某一个节点（Pipeline里）

也可以Ctrl+Shift+P打开指令页面，输入maa，在maa:launch task中选择对应的节点执行

• 执行整个任务（interface配置好任务以及对应选项后）

在VSCode插件工具页面，最下方任务-选择对应任务，点击启动执行任务。

MSE特色功能：

• 插件调试，在VSCode写好代码，直接对当前节点和当前任务进行调试，并查询匹配度和box。
• 截图小工具，使用对应指令，方便地截图、取ROI。
• 取色工具，可以点选、框选并列出所有色值。
• roi_offset计算，可直接粘贴两个roi范围并计算offset，也可反计算范围。
• 代码补全，提供pipeline和interface的字段提示。

MaaDebugger

MaaDebugger是MaaFW官方提供的调试工具，采用命令行下载。

官方网站：MaaXYZ/Maa调试器

环境需求：

• Python >= 3.9，<= 3.13
• nicegui >= 2.21，< 3.0

1. 下载

python -m pip install MaaDebugger

2. 使用

python -m MaaDebugger

输入指令后，会打开一个网页，在此页面配置，连接模拟器和本地开发文件夹后，即可开始调试

MaaDebugger页面：

3. 更新

python -m pip install MaaDebugger MaaFW --upgrade

MaaPipelineExtremer - Editor：可视化 MaaFW Pipeline 编辑器

1. 使用：在线网址

网址：MaaPipelineExtremer - Editor

官方使用教程：MaaPipelineEditor文档站

可以利用可视化网站，查看别人的/自己的代码，梳理自己的思路

2. 更多功能

利用MPE的本地服务功能，也可以实现调试功能，具体参照MPE官方使用教程。

MPE特色功能：

• 可视化，方便厘清节点之间的关系。
• 0代码编程，选择对应字段参数并连线，自动生成pipeline文件。
• 可接入本地服务配置，截图、取色小工具齐全，并可视化调试。

MFAToolsPlus

项目地址：MFAToolsPlus： 基于 Avalonia 的 MAAFramework 辅助工具

1. 下载

从项目地址下载后，解压运行可执行文件，即可使用小工具（和MaaLYSK一样，记得连模拟器）

2. 使用

利用此工具，可以很方便地进行取色、截图、取roi、取roi_offset、滑动起终点等操作。

MFAToolsPlus特色功能：

• 取色，可以一键命中，直观查看整个页面的识色情况。
• 实时预览，动态预览框选的ROI、识别情况及模拟效果。
• 自选复制格式，复制粘贴时可自选是否导出字段名。
• 滑动可以直接取到头尾，并直接模拟效果。

MaaLogAnalyzer

在线网址：MAA 日志分析器

项目地址：MaaLogAnalyzer项目库

1. 使用

打开在线网址，上传maa.log即可进行日志分析、文本搜索等操作。

2. BUG排查

有点想咕咕了，先直接看M9A的相关说明吧！Bug 排查 | M9A 文档站

MLA特色功能：

• MaaFW官方日志分析器，快速准确地定位、分析、解决 bug 。
• 可视化日志分析，直接定位节点问题。
• 提供api接口，可接入AI实现一键分析。
• 多端使用，网页、VSCode插件、安装包皆可使用，拖入文件即可实现日志分析。