产品矩阵
概述
MaaPipelineEditor 采用渐进增强的产品设计理念，提供三种部署模式以满足不同使用场景：
- 纯 Web 端：无需安装，开箱即用
- Web + LocalBridge (LB)：本地能力扩展，增强功能
- 本地一体包 (Extremer)：开箱即用的桌面应用
| 特性 | 纯 Web 端 | Web + LB | Extremer |
|---|---|---|---|
| 上手难度 | ⭐ | ⭐⭐⭐ | ⭐⭐ |
| 功能完整度 | ⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
| 使用便捷性 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
| 配置灵活性 | ⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ |
| 适用场景 | 临时/查看 | 多实例开发 | 日常使用 |
部署模式对比
功能支持矩阵
✅ 完全支持 | ⚠️ 部分支持 | ❌ 不支持
| 功能类别 | 纯 Web 端 | Web + LB | Extremer |
|---|---|---|---|
| 基础编辑 | |||
| 可视化节点编辑与布局 | ✅ | ✅ | ✅ |
| 协议兼容 (v1/v2) 与语法糖 | ✅ | ✅ | ✅ |
| 自定义节点模板 | ✅ | ✅ | ✅ |
| 配置分离导出 | ✅ | ✅ | ✅ |
| 导入与分享 | |||
| 粘贴板导入/导出 | ✅ | ✅ | ✅ |
| 分享链接 | ✅ | ✅ | ✅ |
| 导出为图片 | ✅ | ✅ | ✅ |
| 文件管理 | |||
| 本地文件扫描与监听 | ❌ | ✅ | ✅ |
| 文件保存/创建 | ❌ | ✅ | ✅ |
| 文件自动重载 | ❌ | ✅ | ✅ |
| 跨文件导航与搜索 | ⚠️ (仅已打开) | ✅ | ✅ |
| MaaFramework 工具 | |||
| 设备连接 (ADB/Win32) | ❌ | ✅ | ✅ |
| 截图/OCR/取色/区域选择 | ❌ | ✅ | ✅ |
| 图片资源预览与选择 | ❌ | ✅ | ✅ |
| 实时屏幕预览 | ❌ | ✅ | ✅ |
| 调试 | |||
| 流程调试与单步测试 | ❌ | ✅ | ✅ |
| 识别结果可视化与历史 | ❌ | ✅ | ✅ |
| AI 增强 | |||
| AI 节点搜索 | ✅ | ✅ | ✅ |
| AI 节点补全 | ❌ | ✅ | ✅ |
| 运维体验 | |||
| 配置持久化 | ⚠️ (浏览器) | ⚠️ (浏览器) | ✅ (本地文件) |
| 自动更新 | ✅ | ⚠️ (仅提醒) | ❌ |
模式详解
纯 Web 端
适用场景
- 快速查看和审阅他人的 Pipeline 项目
- 临时编辑或创建简单的 Pipeline 配置
- 在任意设备上进行轻量级编辑
- 无需本地环境的协作场景
特点
限制
- 无法访问本地文件系统
- 无法使用 MaaFramework 原生功能（截图、OCR、调试等）
- 配置仅保存在浏览器本地存储中
- 手动截图后需自行上传图片进行识别
使用建议
- 适合查看和学习他人的 Pipeline 实现
- 使用粘贴板导入功能快速预览项目
- 利用自动布局理清复杂逻辑
- 通过分享链接与他人协作讨论
Web + LocalBridge
适用场景
- 日常 Pipeline 资源开发工作
- 需要频繁调试和测试流程
- 多项目/多文件同时维护
- 对原生工具链有依赖的开发场景
特点
- 渐进增强：在 Web 端基础上增量启用本地能力
- 完全解耦：前后端分离，服务按需启动
- 灵活配置：可自定义工作目录、MaaFramework 路径等
- 轻量启动：一行命令即可开启本地服务
核心能力
文件管理系统
- 递归扫描并管理项目中的所有
.json/.jsonc文件 - 实时监听文件变化，自动同步更新
- 支持文件创建、保存、删除等完整生命周期
- 递归扫描并管理项目中的所有
MaaFramework 集成
- 原生 OCR 识别（需配置资源路径）
- 自动截图功能（ADB/Win32 控制器）
- 完整的调试功能支持
- 设备连接与控制
资源管理
- 图片资源预览和快速选择
- 模板图片悬停显示
- 跨文件跳转和搜索
限制
- 需要手动启动 LocalBridge 服务
- 需要通过终端查看服务日志
- 更新 LocalBridge 需手动重新安装
- 需要额外配置 MaaFramework 路径
使用建议
- 开发环境推荐使用此模式
- 配合自动保存和热重载功能提升开发效率
- 使用调试功能验证流程正确性
- 通过日志系统排查问题
本地一体包 (Extremer)
适用场景
- 希望开箱即用的用户
- 不熟悉命令行操作的用户
- 需要频繁切换项目的场景
- 追求极致便捷的开发体验
特点
- 一键启动：无需任何配置，双击运行
- 自动管理：内置 LocalBridge 服务自动启动
- 可视化：前端日志窗口，无需终端
- 自动更新：内置更新检查功能
- 零门槛：适合所有用户，无需技术背景
核心优势
- 集成化管理
- 内嵌 LocalBridge 服务，无需单独启动
- 统一的配置管理界面
- 工作目录、日志目录自动管理
- 可视化体验
- 前端日志窗口，实时查看服务状态
- 快捷打开工作目录和日志目录
- 可视化配置 MaaFramework 路径
- 智能功能
- 自动检测并提示更新
- 服务异常自动重启
- 配置热重载，无需手动重启
技术架构
- 基于 Wails v2 框架构建
- 前端与 Web 版本完全一致
- LocalBridge 以子进程方式运行
- 进程生命周期自动管理
限制
- 需要下载和安装桌面应用
- 占用磁盘空间相对较大
- 仅支持主流桌面平台 (Windows/macOS/Linux)
使用建议
- 推荐给新手用户或不熟悉命令行的用户
- 适合长期使用 MPE 进行资源开发的场景
- 通过内置日志窗口快速定位问题
- 定期检查更新以获得最新特性
如何选择
初次使用 / 学习阶段
- 纯 Web 端：快速上手，了解编辑器功能
- 访问在线编辑器，粘贴示例 Pipeline 进行学习
日常资源开发
- Extremer：推荐给大多数用户，开箱即用
- Web + LB：适合有特殊配置需求的开发者
团队协作 / 代码审阅
- 纯 Web 端：通过分享链接快速展示
- 无需对方安装任何软件
多项目维护
- Web + LB：可灵活切换工作目录
- Extremer：可在设置中快速切换项目路径
模式迁移
从纯 Web 端迁移到 mpelb/Extremer
- 在 Web 端导出 Pipeline JSON 文件
- 在本地服务启动后，使用文件管理功能导入
从 mpelb 迁移到 Extremer
- 配置和文件完全兼容，只需在 Extremer 中设置相同的工作目录
从 Extremer 降级到 mpelb
- 可以继续使用 mpelb 命令行工具
- 配置路径可能不同，需重新配置