MaaFw 5.10.0b3

An automation black-box testing framework based on image recognition

MaaFramework

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

English | 简体中文

简介

MaaFramework 是基于图像识别技术、运用 MAA 开发经验去芜存菁、完全重写的新一代自动化黑盒测试框架。

低代码的同时仍拥有高扩展性，旨在打造一款丰富、领先、且实用的开源库，助力开发者轻松编写出更好的黑盒测试程序，并推广普及。

即刻开始

[!TIP] 访问我们的 官网 以获得更优秀的文档阅读体验。
找不到相关文档？试试问 AI ！

• 快速开始 & 术语解释
• 代码集成 & API
• Pipeline 低代码协议
• 项目接口 PI 协议

社区项目

通用 UI

• MFAAvalonia
  基于 Avalonia 的 通用 GUI。由 MaaFramework 强力驱动！

• MFW-CFA
  基于 PySide6 的通用 GUI。由 MaaFramework 强力驱动！

• MXU
  基于 Tauri 2 + React 的轻量级跨平台通用 GUI。由 MaaFramework 强力驱动！

• MWU
  基于 Vue + FastAPI 的轻量级跨平台通用 WebUI。由 MaaFramework 强力驱动！

开发工具

• MaaDebugger
  MaaFramework Pipeline 调试器

• maa-support-extension
  MaaFramework VSCode 插件

• MFAToolsPlus
  基于 Avalonia 框架开发的跨平台开发工具箱，提供便捷的数据获取和模拟测试方法

• MaaPipelineEditor
  可视化阅读与构建 Pipeline，功能完备，极致轻量跨平台，提供渐进式本地功能扩展，无缝兼容新旧项目

• MaaInspector
  基于 vue-flow 的可视化编辑器，集成节点预览,编辑,调试于一体的简单好用的 MaaFramework Pipeline 编辑器

• MaaLogAnalyzer
  MaaFramework 日志分析工具，提供用户友好的多视角可视化任务执行流程分析

• MaaLogs
  MaaFramework 日志分析工具，支持多项目日志解析、可视化任务流程和 AI 智能分析

• prettier-plugin-maafw-sort
  Prettier 插件，按照生命周期顺序自动排序 pipeline 字段

• Auto Green Background
  自动涂绿幕工具（Python/OpenCV，适用于TemplateMatch），支持多算法分割、固定画布输出、实时预览与便携版开箱即用打包。

• maafw-cli
  用于AI Agent的 MaaFramework 命令行界面。

应用程序

• M9A
  亿韭韭韭 小助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！

• MSBA
  尘白禁区 小助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！

• MaaYYs
  阴阳师小助手。图像技术 + 模拟控制，当赛博屯屯鼠，自动日常，解放你的双手！由 MaaFramework 强力驱动！

• MPA
  战双帕弥什 小助手。图像技术 + 模拟控制，解放双手！由 玛丽的黑咖啡 2.0 强力驱动！

• MRA
  战舰少女R 小助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！

• MaaYuan
  代号鸢/如鸢 小助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！

• Maa-HBR
  炽焰天穹/HBR 小助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！

• MaaGF2Exilium
  少女前线 2: 追放自动化助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！

• MaaXuexi
  学习强国 自动化助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！

• MAA_MHXY_MG 梦幻西游手游 小助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！

• MaaTOT
  未定事件簿 小助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！

• MaaGumballs
  不思议迷宫小助手是一款由图像识别与模拟控制技术驱动的辅助工具。它能够帮助大家解放双手，一键开启敲砖大冒险，由 MaaFramework 强力支持。

• MMleo
  偶像梦幻祭 2 小助手。使用图像识别+模拟控制技术，解放双手！助力屯屯鼠的制作人生涯！由 MaaFramework 强力驱动！

• SLIMEIM_Maa
  魔王与龙的建国谭小助手。使用图像识别+模拟控制技术，解放双手！由 MaaFramework 强力驱动！

• Maa_bbb
  崩坏三小助手。使用图像识别+模拟控制技术，解放双手！PC 端与模拟器端同步支持，由 MaaFramework 强力驱动！

• MAN
  火影忍者手游小助手。使用图像识别+模拟控制技术，解放双手！由 MaaFramework 强力驱动！

• MaaGakumasu
  学园偶像大师小助手。使用图像技术 + 模拟控制 + 深度学习，解放双手！由 MaaFramework 强力驱动！

• MaaStarResonance
  星痕共鸣小助手。使用图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！

• MAG
  深空之眼小助手。使用图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！

• MAAAE
  白荆回廊 小助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！

• MBCCtools
  无期迷途 小助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！

• MaaEOV
  异象回声 小助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！

• MAA Star Resonance
  星痕共鸣小助手。使用 Electron + 文本图像识别 + ADB 模拟控制 技术，解放双手！由 MaaFramework 和 Quasar 强力驱动！

• StellaSora-Auto-Helper
  星塔旅人 小助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！

• MaaDuDuL
  嘟嘟脸恶作剧 小助手。图像技术 + 模拟控制，自动捏脸，解放双手！由 MaaFramework 强力驱动！

• MaaLYSK
  恋与深空 小助手。使用图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！

• MaaEnd
  终末地小助手。由 MaaFramework 与 MXU 驱动，绝赞开发中！

• MaaGFNeuralCloud
  少女前线：云图计划自动化助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！

生态共建

MAA 正计划建设为一类项目，而非舟的单一软件。

若您的项目依赖于 MaaFramework ，我们欢迎您将它命名为 MaaXXX, MXA, MAX 等等。当然，这是许可而不是限制，您也可以自由选择其他与 MAA 无关的名字，完全取决于您自己的想法！

同时，我们也非常欢迎您提出 PR ，在上方的社区项目列表中添加上您的项目！

声明与许可

开源许可

本项目采用 LGPL-3.0 许可证进行开源。

分发说明

本项目支持 GPU 加速功能，其在 Windows 平台上依赖于 Microsoft 提供的独立组件 DirectML。DirectML 并非本项目的开源部分，也不受 LGPL-3.0 的约束。为方便用户，我们随安装包附带了一个未经修改的 DirectML.dll 文件。如果您无需 GPU 加速功能，可安全删除该 DLL 文件，软件的核心功能仍可正常运行。

免责声明

预期用途

本项目旨在为软件开发提供自动化黑盒测试工具，包括图像识别、界面操作模拟等合法技术场景。开发者应确保其使用方式符合所有适用法律法规及目标软件的服务条款。

禁止滥用

禁止将本项目用于以下用途（包括但不限于）：

• 破坏、绕过或干扰任何软件、游戏、服务的正常功能（如反作弊机制、授权验证系统）。
• 开发或分发违反第三方服务条款的工具（如游戏外挂、作弊器、自动化脚本）。
• 任何侵犯他人合法权益或违反法律的行为（如数据窃取、网络攻击）。

责任豁免

本项目按“原样”提供，作者不承担因以下行为导致的任何直接、间接或衍生责任：

• 使用者违反本声明或法律法规的行为。
• 第三方利用本项目开发的工具造成的损害（如账号封禁、法律纠纷）。
• 因使用本项目导致的任何技术或经济损失。

用户义务

使用本项目即表示您同意：

• 自行承担所有使用风险。
• 确保您的应用场景合法，并已获得相关授权（如目标软件厂商的许可）。
• 若您的行为导致法律纠纷，您应独立承担责任并免除本项目作者的一切责任。

开发

请留意，仅当您准备开发 MaaFramework 本身时，才需要阅读本章节内容。若您仅希望基于 MaaFramework 开发自己的应用，则请参考 即刻开始。

• 构建指南
• 接口设计

鸣谢

开源库

• opencv
  Open Source Computer Vision Library
• fastdeploy
  ⚡️An Easy-to-use and Fast Deep Learning Model Deployment Toolkit for ☁️Cloud 📱Mobile and 📹Edge.
• onnxruntime
  ONNX Runtime: cross-platform, high performance ML inferencing and training accelerator
• boost
  Boost provides free peer-reviewed portable C++ source libraries.
• libzmq
  ZeroMQ core engine in C++, implements ZMTP/3.1
• cppzmq
  Header-only C++ binding for libzmq
• meojson
  ✨ Next-gen C++ JSON/JSON5 Serialization Engine | Zero Dependency | Header-Only | Unleash JSON Potential
• minitouch
  Minimal multitouch event producer for Android.
• maatouch
  Android native implementation of minitouch input protocol
• minicap
  Stream real-time screen capture data out of Android devices.
• zlib
  A massively spiffy yet delicately unobtrusive compression library.
• gzip-hpp
  Gzip header-only C++ library
• ViGEmClient
  ViGEm Client SDK for feeder development.
• protobuf
  Protocol Buffers - Google's data interchange format
• grpc
  The C based gRPC (C++, Python, Ruby, Objective-C, PHP, C#)
• thrift
  Apache Thrift

思路灵感

• MaaAssistantArknights
  《明日方舟》小助手，全日常一键长草！| A one-click tool for the daily tasks of Arknights, supporting all clients.
  MaaFramework 参考了该项目中 ADB 控制器部分实现思路，但未使用其任何源代码。
• ok-script
  全新 Python 游戏自动化框架(支持 Windows 和模拟器)
  MaaFramework 参考该项目中 Win32 控制器部分实现思路，但未使用其任何源代码。

开发者

感谢以下开发者对 MaaFramework 作出的贡献：

沟通交流

欢迎开发者加入官方 QQ 群（595990173），交流集成与开发实践。群内仅讨论开发相关议题，不提供日常使用/客服支持；为保证讨论质量，长期离题或违规的成员可能会被移除。

赞助