MaaDebugger：可视化调试 MaaFramework Pipeline、识别与任务执行

MaaDebugger 是 MaaXYZ 开源的 MaaFramework 调试工具，使用 NiceGUI 提供本地 Web 界面。它面向 MaaFramework 自动化项目开发者，重点不是直接执行某个游戏脚本，而是帮助检查资源、控制器、识别结果和 Pipeline 运行过程。

主要功能

• 连接 ADB 模拟器、Windows 窗口、Gamepad 或自定义控制器。

• 加载 MaaFramework Resource Bundle，选择并运行 Pipeline 任务。

• 展示 Pipeline 节点、识别节点、动作节点及 NextList 执行链。

• 查看识别截图、算法、最佳结果、原始识别数据和节点配置。

• 收集运行异常并在 Traceback 页面查看错误详情。

• 默认在本机8011端口启动 NiceGUI 调试界面，也可用--port修改端口。

环境要求

• Python>=3.9,<3.14

• MaaFW>=5.7.0b3

• NiceGUI>=2.21,<3.0

• 其他依赖：asyncify、Pillow、packaging

安装与运行

使用 pip

python -m pip install MaaDebugger python -m MaaDebugger

指定端口并禁止自动打开浏览器：

python -m MaaDebugger --port 8080 --hide

使用 uv

uv tool install MaaDebugger MaaDebugger

临时运行：

uvx MaaDebugger

源码包检查结果

• 源码版本：1.20.1

• Python 文件：20 个，py_compile语法检查通过

• ZIP：53 个条目，CRC 检查通过

• 许可证：MIT

• 上游说明：项目正在重构，使用前建议查看 GitHub README 与 issue #163

资源获取

• UC 网盘永久分享

• MaaDebugger GitHub 源项目

> 内容来源网络，进行整合/再创作。源码版权归 MaaXYZ 与贡献者；使用和再分发遵循 MIT 许可证，请保留许可证与 GitHub 来源。