MXU 是一个基于 MaaFramework PI V2 协议的通用 GUI 客户端,使用 Tauri + React + TypeScript 构建。

它可以解析任何符合 PI V2 标准的 interface.json 文件,为 MaaFramework 生态中的自动化项目提供开箱即用的图形界面。

• 📋 任务管理 - 可视化配置任务列表,支持拖拽排序
• 🔧 多实例支持 - 同时管理多个独立运行的实例(标签页多开)
• 🎮 多控制器类型 - 支持 Adb、Win32、PlayCover、Gamepad
• 🌍 国际化 - 界面内置多种语言,自动加载 interface.json 中的翻译
• 🎨 明暗主题 - 支持 Light/Dark 主题切换
• 📱 实时截图 - 显示设备实时画面,可自定义帧率
• 📝 运行日志 - 查看任务执行日志和 Agent 输出
• ⏰ 定时任务 - 支持配置定时执行策略
• 🔄 自动更新 - 支持 MirrorChyan 和 GitHub 自动下载更新
• 🤖 Agent 支持 - 支持 MaaAgentClient 实现自定义识别器和动作

MXU Releases 中提供了单可执行文件(Windows 为 mxu.exe,Linux/macOS 为 mxu),您需要配置以下依赖:

• MaaFramework 运行库 ( >= v5.5.0-beta.1 ) ,将压缩包中的 bin 文件夹内容解压到 maafw 文件夹中
• interface.json 及相关资源文件,请参考 PI 协议文档 编写

目录结构如下

your-project/
├── mxu.exe (或 mxu)
├── maafw/
│ ├── MaaFramework.dll (Windows)
│ ├── MaaToolkit.dll
│ └── ... 其他依赖库
├── interface.json
└── resource/

随后运行 mxu.exe(Windows)或 ./mxu(Linux/macOS)即可!~

用户配置保存在 config 文件夹中,调试日志保存在 debug 文件夹中。亦可在 设置 - 调试 中直接打开文件夹。

Node.js (>= 18)

# macOS (Homebrew)
brew install node
# Windows (winget)
winget install OpenJS.NodeJS

pnpm (>= 8)

npm install -g pnpm

Rust (>= 1.70)

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source $HOME/.cargo/env

项目依赖

pnpm install

pnpm tauri dev

启动前端开发服务器和 Tauri 桌面应用,支持热重载。

pnpm tauri build

构建产物位于 src-tauri/target/release/ 目录。

• MaaFramework - 基于图像识别的自动化黑盒测试框架

GNU Affero General Public License v3.0

感谢以下开发者对 MXU 作出的贡献:

贡献者