简介
MaaFramework 是基于图像识别技术、运用 MAA 开发经验去芜存菁、完全重写的新一代自动化黑盒测试框架。
低代码的同时仍拥有高扩展性，旨在打造一款丰富、领先、且实用的开源库，助力开发者轻松编写出更好的黑盒测试程序，并推广普及。
即刻开始
社区项目
通用 UI
-
MFAAvalonia
基于 Avalonia 的 通用 GUI。由 MaaFramework 强力驱动！ -
MFW-CFA
基于 PySide6 的通用 GUI。由 MaaFramework 强力驱动！ -
MXU
基于 Tauri 2 + React 的轻量级跨平台通用 GUI。由 MaaFramework 强力驱动！ -
MWU
基于 Vue + FastAPI 的轻量级跨平台通用 WebUI。由 MaaFramework 强力驱动！ -
MaaFwApp
基于 Kotlin + Jetpack Compose 的 Android 通用 GUI。由 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 命令行界面。 -
maaframework-skills
Claude Code skill for MaaFramework — 面向 AI 辅助开发的结构化参考文档。 -
MaaOWM
MaaFramework 多资源包开发工具。挂载: base+mod 合并成全字段工作区; 卸载: diff 出最小化 mod 增量。 -
create-maa-project
MaaFW 项目脚手架 CLI & MCP Server，交互式创建与增量维护 Pipeline / Agent 项目 -
MaaEvidenceKit
为 AI Agent 提取 MaaFramework 日志与项目配置中的确定性证据，支持运行时与静态分析、源码定位及任务流程关联 -
Everything-Maa
面向 AI 辅助开发的 MaaFramework 工具集，提供可复用 Skills、版本化 MCP 配置与 CLI 安装器，覆盖项目创建、Pipeline 编写、测试和分析 -
MaaCtl
MaaFramework / ProjectInterface v2 命令行客户端，纯参数化运行 PI 项目与 Pipeline 节点，提供 Go 单文件可执行程序与 npm（npx/全局安装）分发
应用程序
-
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
-
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 强力驱动！ -
MaaFgo
FGO 小助手。使用图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！ -
MaaNTE
异环小助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！ -
MALW
东方归言录小助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！ -
AUTO-MAS
多脚本多配置统一管理与自动化工具，你的脚本管家。内置 MaaFramework 组件，拓展脚本能力边界！ -
MR3A
忍者必须死3 小助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！ -
Maa_Kes
卡厄思梦境小助手。基于 MaaFramework 开发。使用图像识别+模拟控制技术，PC 端与模拟器端同步支持，解放双手！由 MaaFramework 强力驱动！ -
MAK
《雪松》小助手！由 MaaFramework 强力驱动！ -
MAH
东京放课后召唤师小助手。由 MaaFramework 强力驱动！ -
MATR
刀剑乱舞小助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！ -
MaaADr
龍脈・另一種姿態R(AnaDos)小助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！ -
MFABD2
棕色尘埃2 (Brown Dust 2) 小助手。图像技术 + 模拟控制，解放双手！PC 端、模拟器与 PlayCover 同步支持，由 MaaFramework 强力驱动！ -
MaaWoA
机场世界 (World of Airports) 小助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！ -
MAES
偶像梦幻祭 2 打歌小助手。使用图像识别 + 模拟控制，解放双手！由 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 formatgrpc
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），交流集成与开发实践。群内仅讨论开发相关议题，不提供日常使用/客服支持；为保证讨论质量，长期离题或违规的成员可能会被移除。
赞助
Release files for MaaFw 5.14.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| maafw-5.14.0-py3-none-win_arm64.whl | Python 3 | none | Windows ARM64 | Details |
| maafw-5.14.0-py3-none-win_amd64.whl | Python 3 | none | Windows x86-64 | Details |
| maafw-5.14.0-py3-none-manylinux2014_x86_64.whl | Python 3 | none | Linux glibc 2.17+ x86-64 | Details |
| maafw-5.14.0-py3-none-manylinux2014_aarch64.whl | Python 3 | none | Linux glibc 2.17+ ARM64 | Details |
| maafw-5.14.0-py3-none-macosx_13_0_x86_64.whl | Python 3 | none | macOS 13.0+ x86-64 | Details |
| maafw-5.14.0-py3-none-macosx_13_0_arm64.whl | Python 3 | none | macOS 13.0+ ARM64 | Details |
Total release size: 119.2 MB
Release files / maafw-5.14.0-py3-none-win_arm64.whl
| Download URL | maafw-5.14.0-py3-none-win_arm64.whl |
|---|---|
| Size | 24.0 MB |
| Tags | Python 3 Windows ARM64 |
|
SHA-256 checksum How to use checksums |
c31d870861e58912120503c29dbbb2c058e13206077cc0a1a87e654612c1a219
|
|
BLAKE2b-256 checksum How to use checksums |
c10c3a3e213f21303b411aa21f5ec4406c749b25649e650777ee1727f56e955a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
Release files / maafw-5.14.0-py3-none-win_amd64.whl
| Download URL | maafw-5.14.0-py3-none-win_amd64.whl |
|---|---|
| Size | 24.9 MB |
| Tags | Python 3 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
9260a01d17b780e605b04782a00abfa1ebe9d565a4444932ee8c7c928bcc259c
|
|
BLAKE2b-256 checksum How to use checksums |
8b2053ce0222e1c7288eae25359d9274679aad10d41271053daadda60da56ccf
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
Release files / maafw-5.14.0-py3-none-manylinux2014_x86_64.whl
| Download URL | maafw-5.14.0-py3-none-manylinux2014_x86_64.whl |
|---|---|
| Size | 18.7 MB |
| Tags | Linux glibc 2.17+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
d15671bd8d6328f45de986726017270a381157ae85b5d772cdd23618f50906a5
|
|
BLAKE2b-256 checksum How to use checksums |
4d40622d6a3a4d7fcba0cbf08c3e34b0d48ee4ddb032135f02f96c6d41fe1603
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
Release files / maafw-5.14.0-py3-none-manylinux2014_aarch64.whl
| Download URL | maafw-5.14.0-py3-none-manylinux2014_aarch64.whl |
|---|---|
| Size | 16.7 MB |
| Tags | Linux glibc 2.17+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
65d64d84886b3dd57499d06dd073d90c2d2f4f75dd384ace3f8ccba36543070d
|
|
BLAKE2b-256 checksum How to use checksums |
baa1154859d55e43c45570590d8a8e6e86246a6c006aa2390e05b8f3b0550b8a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
Release files / maafw-5.14.0-py3-none-macosx_13_0_x86_64.whl
| Download URL | maafw-5.14.0-py3-none-macosx_13_0_x86_64.whl |
|---|---|
| Size | 18.2 MB |
| Tags | Python 3 macOS 13.0+ x86-64 |
|
SHA-256 checksum How to use checksums |
71e470c519e202e5bc9a48c8cd2c8564176528e63b6b5a1c71856155b195aafb
|
|
BLAKE2b-256 checksum How to use checksums |
6a8d488d15585895435e4afd735c59153671431fa577336056054b546443d79c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
Release files / maafw-5.14.0-py3-none-macosx_13_0_arm64.whl
| Download URL | maafw-5.14.0-py3-none-macosx_13_0_arm64.whl |
|---|---|
| Size | 16.6 MB |
| Tags | Python 3 macOS 13.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
9395c0af08bbe9e551433beaacc2254348f2b2dd21a0fc8e4efdf22dc68eade1
|
|
BLAKE2b-256 checksum How to use checksums |
2f88b5d75ce5172146f320730c61ca842aa706b7cb105f0394e28c0dc8742c6c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
