开发工具介绍
Maa调试/开发工具总览：MaaFramework#社区项目
| 工具 | 简介 |
|---|---|
| MaaDebugger | 独立调试工具 |
| Maa Pipeline Support | VSCode 插件，提供调试、截图、获取 ROI 、取色等功能 |
| MFA Tools Plus | 独立截图、获取 ROI 、滑动、文字及取色工具 |
| MaaLogAnalyzer | 可视化分析基于 MaaFramework 开发应用的日志 |
| MaaPipelineExtremer - Editor | MPE网站，可视化编辑和分析MaaLYSK的流程代码 |
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插件工具页面，最下方任务-选择对应任务，点击 启动**执行任务。
MaaDebugger
MaaDebugger是MaaFW官方提供的调试工具，采用命令行下载。
官方网站：MaaXYZ/Maa调试器
环境需求：
- Python >= 3.9，<= 3.13
- nicegui >= 2.21，< 3.0
1. 下载
python -m pip install MaaDebugger2. 使用
python -m MaaDebugger输入指令后，会打开一个网页，在此页面配置，连接模拟器和本地开发文件夹，确保模拟器的后台保活关闭后，即可开始调试。
- ADB Path
搜索模拟器+连接。
先点find，右侧会显示你的模拟器。
然后再点connect，🟢亮绿灯表示连接成功，会有个小窗显示模拟器画面。
- Resource Directory
填克隆后MAAYuan库对应的位置（要写到图上这个层级，简中最后是base，繁中最后是**zh_tw）。
写好的.json文件应该放到\resource\简中base或者繁中zh_tw选一个填\pipeline里，点load。
🟢亮绿灯就是准备好了，如果🔴亮红灯说明json文件里有地方写错了。
- Task Entry
填.json文件里面任意一个"子任务名"，再点start，就可以看到实际运行效果。
- Pipeline Override
根据需求不同（比如选项内容）来改变（=替换）原任务.json中某些步骤的效果。
💡 如果调试中改了 .json 文件，点一下 resource 的 load 就能更新了。（要确保你的文件是保存过的）
3. 更新
python -m pip install MaaDebugger MaaFW --upgradeMaaPipelineExtremer - Editor：可视化 MaaFW Pipeline 编辑器
1. 使用：在线网址
网址：MaaPipelineExtremer - Editor
官方使用教程：MaaPipelineEditor文档站
可以利用可视化网站，查看别人的/自己的代码，梳理自己的思路
2. 更多功能
利用MPE的本地服务功能，也可以实现调试功能，具体参照MPE官方使用教程。
MFAToolsPlus
项目地址：MFAToolsPlus： 基于 Avalonia 的 MAAFramework 辅助工具
1. 下载
从项目地址下载后，解压运行可执行文件，即可使用小工具（和MaaLYSK一样，记得连模拟器）
2. 使用
利用此工具，可以很方便地进行取色、截图、取roi、取roi_offset、滑动起终点等操作。
特色功能：
- 实时预览
- 取色可以单显显示范围
- 可以设置
“字段名+值”的方式，方便粘贴到VSCode
MaaLogAnalyzer
在线网址：MAA 日志分析器
项目地址：MaaLogAnalyzer项目库
1. 使用
打开在线网址，上传maa.log即可进行日志分析、文本搜索等操作。
2. BUG排查
直接看M9A的相关说明吧！Bug 排查 | M9A 文档站