Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/MaaXYZ/MaaFramework
基于图像识别的自动化黑盒测试框架 | An automation black-box testing framework based on image recognition
https://github.com/MaaXYZ/MaaFramework
black-box-testing computer-vision
Last synced: 3 days ago
JSON representation
基于图像识别的自动化黑盒测试框架 | An automation black-box testing framework based on image recognition
- Host: GitHub
- URL: https://github.com/MaaXYZ/MaaFramework
- Owner: MaaXYZ
- License: lgpl-3.0
- Created: 2023-04-24T14:50:25.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-12-20T09:05:53.000Z (2 months ago)
- Last Synced: 2024-12-20T09:09:17.543Z (2 months ago)
- Topics: black-box-testing, computer-vision
- Language: C++
- Homepage:
- Size: 8.44 MB
- Stars: 1,549
- Watchers: 14
- Forks: 182
- Open Issues: 44
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# MaaFramework
_✨ 基于图像识别的自动化黑盒测试框架 ✨_
[English](./README_en.md) | [简体中文](./README.md)
## 简介
**MaaFramework** 是基于图像识别技术、运用 [MAA](https://github.com/MaaAssistantArknights/MaaAssistantArknights) 开发经验去芜存菁、完全重写的新一代自动化黑盒测试框架。
低代码的同时仍拥有高扩展性，旨在打造一款丰富、领先、且实用的开源库，助力开发者轻松编写出更好的黑盒测试程序，并推广普及。
## 即刻开始
- [快速开始](docs/zh_cn/1.1-快速开始.md)
- [集成文档](docs/zh_cn/2.1-集成文档.md)
- [Pipeline 协议](docs/zh_cn/3.1-任务流水线协议.md)
## 最佳实践
- [M9A](https://github.com/MaaXYZ/M9A) 1999 小助手 
基于全新架构的 亿韭韭韭 小助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！
- [MAABH3](https://github.com/MaaXYZ/MAABH3) 《崩坏3》小助手 | A one-click tool for the daily tasks of Honkai Impact. 
基于全新架构的 蹦蹦蹦 小助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！
- [MAALimbusCompany](https://github.com/hxdnshx/MAALimbusCompany) 边狱公司 小助手 
基于全新架构的 边狱公司 小助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！
- [MAS](https://github.com/MaaXYZ/MaaAssistantSkland) 森空岛 小助手 
基于全新架构的 森空岛 小助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！
- [MaaHatsuboshiTA](https://github.com/Carpenter-MK1/MaaHatsuboshiTA) 学院偶像大师 初星助教 
基于全新架构的制作人代肝工具，养肝护眼 + 节省时间，~~出轨美铃！~~ 由 MaaFramework 强力驱动！
- [MCCA](https://github.com/MaaXYZ/MCCA) 交错战线 小助手 
基于全新架构的 交错战线 小助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！
- [MSBA](https://github.com/overflow65537/MAA_SnowBreak) 尘白禁区 小助手 
基于全新架构的 尘白禁区 小助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！
- [MaaAeonFantasy](https://github.com/Andl-Liu/MaaAeonFantasy) 星神少女 预言之子 小助手 
基于全新架构的 星神少女 小助手。图像技术 + 模拟控制，让手去做它该做的事！由 MaaFramework 强力驱动！
- [maa-whmx](https://github.com/MAWHA/maa-whmx) 物华弥新 小助手  
基于全新架构的 物华弥新 小助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！
- [MAA-for-Millennium-Tour](https://github.com/Ostwind23/MAA-for-Millennium-Tour) 千年之旅 小助手  
基于全新架构的 千年之旅 小助手。图像技术 + 模拟控制，解放侍主的大手！由 MaaFramework 强力驱动！
- [MFAWPF](https://github.com/SweetSmellFox/MFAWPF) MFA 任务管理器 
基于 MAA 全新架构的 通用 GUI。由 MaaFramework 强力驱动！
- [MET](https://github.com/shanchuan001/MET) 悠久之树 小助手 
基于全新架构的 悠久之树 小助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！
- [MaaYYs](https://github.com/TanyaShue/MaaYYs) 阴阳师小助手  
基于全新架构的 阴阳师小助手。图像技术 + 模拟控制，当赛博屯屯鼠，自动日常，解放你的双手！由 MaaFramework 强力驱动！
- [MaaJR](https://github.com/Saratoga-Official/MaaJR) 战舰少女R 小助手 
基于全新架构的 战舰少女R 小助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！
- [MPA](https://github.com/overflow65537/MAA_Punish) 战双 小助手 
基于全新架构的 战双帕弥什 小助手。图像技术 + 模拟控制，解放双手！由 玛丽的黑咖啡 2.0 强力驱动！
- [MaaYuan](https://github.com/syoius/MaaYuan) 代号鸢/如鸢 一键长草小助手 
基于全新架构的 代号鸢/如鸢 小助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！
- [MFW-ELE-GUI](https://github.com/Night-stars-1/maa-gui) MFW-ELE-GUI  
基于全新架构的 MFW-ELE-GUI。由 MaaFramework 强力驱动！
- [Maa-HBR](https://github.com/KarylDAZE/Maa-HBR) 炽焰天穹/HBR 小助手 
基于全新架构的 炽焰天穹/HBR 小助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！
- [MFW-PyQt6](https://github.com/overflow65537/MFW-PyQt6) MFW-PyQt6 
基于PyQt6的通用GUI。由 MaaFramework 强力驱动！
- [MaaGF2Exilium](https://github.com/DarkLingYun/MaaGF2Exilium) 少女前线2: 追放自动化助手 
基于全新架构的 少女前线2: 追放自动化助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！
- [MaaAshEchoes](https://github.com/moulai/MaaAshEchoes) 白荆回廊 小助手 
基于全新架构的 白荆回廊 小助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！
## 生态共建
MAA 正计划建设为一类项目，而非舟的单一软件。
若您的项目依赖于 MaaFramework ，我们欢迎您将它命名为 MaaXXX, MXA, MAX 等等。当然，这是许可而不是限制，您也可以自由选择其他与 MAA 无关的名字，完全取决于您自己的想法！
同时，我们也非常欢迎您提出 PR ，在上方的最佳实践列表中添加上您的项目！
## 许可证
### MaaFramework
本项目采用 [`LGPL-3.0`](./LICENSE.md) 许可证进行开源。
### DirectML
本项目支持 GPU 加速功能，其在 Windows 平台上依赖于 Microsoft 提供的独立组件 [DirectML](https://learn.microsoft.com/en-us/windows/ai/directml/)。DirectML 并非本项目的开源部分，也不受 LGPL-3.0 的约束。为方便用户，我们随安装包附带了一个未经修改的 DirectML.dll 文件。如果您无需 GPU 加速功能，可安全删除该 DLL 文件，软件的核心功能仍可正常运行。
## 开发
_请留意，仅当您准备开发 MaaFramework 本身时，才需要阅读本章节内容。若您仅希望基于 MaaFramework 开发自己的应用，则请参考 [即刻开始](#即刻开始)。_
- [构建指南](docs/zh_cn/4.1-构建指南.md)
- [接口设计](docs/zh_cn/4.2-标准化接口设计.md)
## 鸣谢
### 开源库
- [opencv](https://github.com/opencv/opencv)
Open Source Computer Vision Library
- [fastdeploy](https://github.com/PaddlePaddle/FastDeploy)
⚡️An Easy-to-use and Fast Deep Learning Model Deployment Toolkit for ☁️Cloud 📱Mobile and 📹Edge. Including Image, Video, Text and Audio 20+ main stream scenarios and 150+ SOTA models with end-to-end optimization, multi-platform and multi-framework support.
- [onnxruntime](https://github.com/microsoft/onnxruntime)
ONNX Runtime: cross-platform, high performance ML inferencing and training accelerator
- [boost](https://www.boost.org/)
Boost provides free peer-reviewed portable C++ source libraries.
- [meojson](https://github.com/MistEO/meojson)
✨ Next-gen C++ JSON/JSON5 Serialization Engine | Zero Dependency | Header-Only | Unleash JSON Potential
- [minitouch](https://github.com/DeviceFarmer/minitouch)
Minimal multitouch event producer for Android.
- [maatouch](https://github.com/MaaAssistantArknights/MaaTouch)
Android native implementation of minitouch input protocol
- [minicap](https://github.com/DeviceFarmer/minicap)
Stream real-time screen capture data out of Android devices.
- [zlib](https://github.com/madler/zlib)
A massively spiffy yet delicately unobtrusive compression library.
- [gzip-hpp](https://github.com/mapbox/gzip-hpp)
Gzip header-only C++ library
- ~~[protobuf](https://github.com/protocolbuffers/protobuf)~~
~~Protocol Buffers - Google's data interchange format~~
- ~~[grpc](https://github.com/grpc/grpc)~~
~~The C based gRPC (C++, Python, Ruby, Objective-C, PHP, C#)~~
- ~~[thrift](https://github.com/apache/thrift)~~
~~Apache Thrift~~
### 开发者
感谢以下开发者对 MaaFramework 作出的贡献：
[](https://github.com/MaaXYZ/MaaFramework/graphs/contributors)
## 讨论
- 集成/开发交流 QQ 群: 595990173
## 赞助
