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 中提供了单 exec 文件（mxu.exe），您需要配置以下依赖：
- MaaFramework 运行库 ( >=
v5.5.0-beta.1) ，将压缩包中的bin文件夹内容解压到maafw文件夹中 - interface.json 及相关资源文件，请参考 PI 协议文档 编写
目录结构如下
your-project/
├── mxu.exe (或 mxu / mxu.app)
├── maafw/
│ ├── MaaFramework.dll (Windows)
│ ├── MaaToolkit.dll
│ └── ... 其他依赖库
├── interface.json
└── resource/
随后双击打开 mxu.exe 即可！~
用户配置保存在 config 文件夹中，调试日志保存在 debug 文件夹中。亦可在 设置 - 调试 中直接打开文件夹。
Node.js (>= 18)
# macOS (Homebrew)
brew install node
# Windows (winget)
winget install OpenJS.NodeJSpnpm (>= 8)
npm install -g pnpmRust (>= 1.70)
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source $HOME/.cargo/env项目依赖
pnpm installpnpm tauri dev启动前端开发服务器和 Tauri 桌面应用，支持热重载。
pnpm tauri build构建产物位于 src-tauri/target/release/ 目录。
| 类别 | 技术 |
|---|---|
| 桌面框架 | Tauri v2 |
| 后端语言 | Rust 1.70+ |
| 前端框架 | React 19 |
| 类型系统 | TypeScript 5.8 |
| 样式方案 | Tailwind CSS 4 |
| 状态管理 | Zustand |
| 国际化 | i18next + react-i18next |
| 拖拽排序 | @dnd-kit |
| 图标 | Lucide React |
| 构建工具 | Vite 7 |
- MaaFramework - 基于图像识别的自动化黑盒测试框架