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 来源。
