[!NOTE] 我们目前正在重构 MaaDebugger ，你可以前往 https://github.com/MaaXYZ/MaaDebugger/issues/163 来了解详情。
你可以使用 npx @weinibuliu/maa-debugger@latest 获取早期预览版。

需求版本

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

快速开始

使用 uv

提供更快的安装速度与环境隔离。

• 安装为全局工具:

  uv tool install MaaDebugger
  MaaDebugger
  

• 临时运行 (免安装):

  uvx MaaDebugger
  

• 更新:

  uv tool upgrade MaaDebugger
  

---

使用 Python (pip)

传统的 Python 安装方式。

• 安装:

  python -m pip install MaaDebugger
  

• 运行:

  python -m MaaDebugger
  

• 更新:

  python -m pip install MaaDebugger MaaFW --upgrade
  

---

指定端口

MaaDebugger 默认使用端口 8011。你可以通过使用 --port [port] 选项来指定 MaaDebugger 运行的端口。例如，要在端口 8080 上运行 MaaDebugger： 无论使用哪种方式，均支持 --port 参数。例如在端口 8080 上运行：

# uv
MaaDebugger --port 8080

# uvx (免安装)
uvx MaaDebugger --port 8080

# python
python -m MaaDebugger --port 8080

开发 MaaDebugger

cd src
python -m MaaDebugger

或者

使用 VSCode，在项目目录中按下 F5