MXU

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

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

✨ 特性

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

🚀 快速开始

安装依赖

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

MXU 需要 MaaFramework 运行时库才能正常工作。请从 MaaFramework Releases 下载对应平台的版本，将压缩包中的 bin 文件夹内容解压到 MXU 可执行文件同级目录的 maafw 文件夹中：

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

注意：不同平台的动态库文件后缀不同：

• Windows: .dll
• macOS: .dylib
• Linux: .so

作为独立 GUI 使用

1. 将编译好的 MXU 可执行文件放入你的项目目录
2. 下载并配置 MaaFramework 运行时库到 maafw 文件夹
3. 确保同级目录下存在 interface.json 文件
4. 运行 MXU

配置文件

用户配置保存在 mxu.json 中，包含：

• 当前选择的控制器和资源
• 各实例的任务列表和选项配置
• 界面偏好设置

🔧 技术栈

类别	技术
桌面框架	Tauri v2
后端语言	Rust 1.70+
前端框架	React 19
类型系统	TypeScript 5.8
样式方案	Tailwind CSS 4
状态管理	Zustand
国际化	i18next + react-i18next
拖拽排序	@dnd-kit
图标	Lucide React
构建工具	Vite 7

🤝 相关项目

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

📄 License

GNU Affero General Public License v3.0