{"id":25489245,"url":"https://github.com/MaaXYZ/MaaFramework","last_synced_at":"2025-11-08T06:30:40.328Z","repository":{"id":162653617,"uuid":"632024122","full_name":"MaaXYZ/MaaFramework","owner":"MaaXYZ","description":"基于图像识别的自动化黑盒测试框架 | An automation black-box testing framework based on image recognition","archived":false,"fork":false,"pushed_at":"2024-12-20T09:05:53.000Z","size":8850,"stargazers_count":1549,"open_issues_count":44,"forks_count":182,"subscribers_count":14,"default_branch":"main","last_synced_at":"2024-12-20T09:09:17.543Z","etag":null,"topics":["black-box-testing","computer-vision"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MaaXYZ.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-04-24T14:50:25.000Z","updated_at":"2024-12-20T08:43:54.000Z","dependencies_parsed_at":null,"dependency_job_id":"4982e3a4-c31c-4063-8b6b-887ebb7fe6ed","html_url":"https://github.com/MaaXYZ/MaaFramework","commit_stats":null,"previous_names":["maaxyz/maaframework","maaassistantarknights/maaframework"],"tags_count":118,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MaaXYZ%2FMaaFramework","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MaaXYZ%2FMaaFramework/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MaaXYZ%2FMaaFramework/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MaaXYZ%2FMaaFramework/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MaaXYZ","download_url":"https://codeload.github.com/MaaXYZ/MaaFramework/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239550272,"owners_count":19657541,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["black-box-testing","computer-vision"],"created_at":"2025-02-18T21:01:39.754Z","updated_at":"2025-11-08T06:30:40.272Z","avatar_url":"https://github.com/MaaXYZ.png","language":"C++","funding_links":[],"categories":["C++"],"sub_categories":[],"readme":"\u003c!-- markdownlint-disable MD033 MD041 --\u003e\n\u003cp align=\"center\"\u003e\n  \u003cimg alt=\"LOGO\" src=\"https://cdn.jsdelivr.net/gh/MaaAssistantArknights/design@main/logo/maa-logo_512x512.png\" width=\"256\" height=\"256\" /\u003e\n\u003c/p\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n# MaaFramework\n\n\u003c!-- prettier-ignore-start --\u003e\n\u003c!-- markdownlint-disable-next-line MD036 --\u003e\n_✨ 基于图像识别的自动化黑盒测试框架 ✨_\n\u003c!-- prettier-ignore-end --\u003e\n\n\u003c/div\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg alt=\"license\" src=\"https://img.shields.io/github/license/MaaXYZ/MaaFramework\"\u003e\n  \u003cimg alt=\"C++\" src=\"https://img.shields.io/badge/C++-20-%2300599C?logo=cplusplus\"\u003e\n  \u003cimg alt=\"platform\" src=\"https://img.shields.io/badge/platform-Windows%20%7C%20Linux%20%7C%20macOS%20%7C%20Android-blueviolet\"\u003e\n  \u003cimg alt=\"commit\" src=\"https://img.shields.io/github/commit-activity/m/MaaXYZ/MaaFramework?color=%23ff69b4\"\u003e\n  \u003cimg alt=\"stars\" src=\"https://img.shields.io/github/stars/MaaXYZ/MaaFramework?style=social\"\u003e\n\u003c/p\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n[English](./README_en.md) | [简体中文](./README.md)\n\n\u003c/div\u003e\n\n## 简介\n\n**MaaFramework** 是基于图像识别技术、运用 [MAA](https://github.com/MaaAssistantArknights/MaaAssistantArknights) 开发经验去芜存菁、完全重写的新一代自动化黑盒测试框架。\n\n低代码的同时仍拥有高扩展性，旨在打造一款丰富、领先、且实用的开源库，助力开发者轻松编写出更好的黑盒测试程序，并推广普及。\n\n## 即刻开始\n\n- [快速开始](docs/zh_cn/1.1-快速开始.md)\n- [集成文档](docs/zh_cn/2.1-集成文档.md)\n- [Pipeline 协议](docs/zh_cn/3.1-任务流水线协议.md)\n\n## 最佳实践\n\n- [M9A](https://github.com/MaaXYZ/M9A) 1999 小助手 ![Pipeline](https://img.shields.io/badge/Pipeline-%23454545?logo=paddypower\u0026logoColor=%23FFFFFF)  \n  基于全新架构的 亿韭韭韭 小助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！\n\n- [MAABH3](https://github.com/MaaXYZ/MAABH3) 《崩坏3》小助手 | A one-click tool for the daily tasks of Honkai Impact. ![cpp](https://img.shields.io/badge/C%2B%2B-00599C?logo=c%2B%2B\u0026logoColor=white)  \n  基于全新架构的 蹦蹦蹦 小助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！\n\n- [MAALimbusCompany](https://github.com/hxdnshx/MAALimbusCompany) 边狱公司 小助手 ![Pipeline](https://img.shields.io/badge/Pipeline-%23454545?logo=paddypower\u0026logoColor=%23FFFFFF)  \n  基于全新架构的 边狱公司 小助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！\n\n- [MAS](https://github.com/MaaXYZ/MaaAssistantSkland) 森空岛 小助手 ![Pipeline](https://img.shields.io/badge/Pipeline-%23454545?logo=paddypower\u0026logoColor=%23FFFFFF)  \n  基于全新架构的 森空岛 小助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！\n\n- [MaaHatsuboshiTA](https://github.com/Carpenter-MK1/MaaHatsuboshiTA) 学院偶像大师 初星助教  ![Pipeline](https://img.shields.io/badge/Pipeline-%23454545?logo=paddypower\u0026logoColor=%23FFFFFF)  \n  基于全新架构的制作人代肝工具，养肝护眼 + 节省时间，~~出轨美铃！~~ 由 MaaFramework 强力驱动！\n\n- [MCCA](https://github.com/MaaXYZ/MCCA) 交错战线 小助手 ![Pipeline](https://img.shields.io/badge/Pipeline-%23454545?logo=paddypower\u0026logoColor=%23FFFFFF)  \n  基于全新架构的 交错战线 小助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！\n  \n- [MSBA](https://github.com/overflow65537/MAA_SnowBreak) 尘白禁区 小助手  ![Pipeline](https://img.shields.io/badge/Pipeline-%23454545?logo=paddypower\u0026logoColor=%23FFFFFF)  \n  基于全新架构的 尘白禁区 小助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！\n\n- [MaaAeonFantasy](https://github.com/Andl-Liu/MaaAeonFantasy)  星神少女 预言之子 小助手  ![Pipeline](https://img.shields.io/badge/Pipeline-%23454545?logo=paddypower\u0026logoColor=%23FFFFFF)  \n  基于全新架构的 星神少女 小助手。图像技术 + 模拟控制，让手去做它该做的事！由 MaaFramework 强力驱动！\n\n- [maa-whmx](https://github.com/MAWHA/maa-whmx) 物华弥新 小助手 ![cpp](https://img.shields.io/badge/C%2B%2B-00599C?logo=c%2B%2B\u0026logoColor=white) ![qt](https://img.shields.io/badge/Qt6-41CD52?logo=Qt\u0026logoColor=white)  \n  基于全新架构的 物华弥新 小助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！\n\n- [MAA-for-Millennium-Tour](https://github.com/Ostwind23/MAA-for-Millennium-Tour) 千年之旅 小助手 ![Pipeline](https://img.shields.io/badge/Pipeline-%23454545?logo=paddypower\u0026logoColor=%23FFFFFF) ![python](https://img.shields.io/badge/Python-3776AB?logo=python\u0026logoColor=white)  \n  基于全新架构的 千年之旅 小助手。图像技术 + 模拟控制，解放侍主的大手！由 MaaFramework 强力驱动！\n\n- [MFAWPF](https://github.com/SweetSmellFox/MFAWPF) MFA 任务管理器 ![csharp](https://img.shields.io/badge/C%23-239120?logo=csharp\u0026logoColor=white)  \n  基于 MAA 全新架构的 通用 GUI。由 MaaFramework 强力驱动！\n\n- [MET](https://github.com/shanchuan001/MET) 悠久之树 小助手 ![Pipeline](https://img.shields.io/badge/Pipeline-%23454545?logo=paddypower\u0026logoColor=%23FFFFFF)  \n  基于全新架构的 悠久之树 小助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！\n\n- [MaaYYs](https://github.com/TanyaShue/MaaYYs) 阴阳师小助手 ![python](https://img.shields.io/badge/Python-3776AB?logo=python\u0026logoColor=white) ![qt](https://img.shields.io/badge/Qt6-41CD52?logo=Qt\u0026logoColor=white)  \n  基于全新架构的 阴阳师小助手。图像技术 + 模拟控制，当赛博屯屯鼠，自动日常，解放你的双手！由 MaaFramework 强力驱动！\n\n- [MaaJR](https://github.com/Saratoga-Official/MaaJR) 战舰少女R 小助手 ![Pipeline](https://img.shields.io/badge/Pipeline-%23454545?logo=paddypower\u0026logoColor=%23FFFFFF)  \n  基于全新架构的 战舰少女R 小助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！\n\n- [MPA](https://github.com/overflow65537/MAA_Punish) 战双 小助手  ![Pipeline](https://img.shields.io/badge/Pipeline-%23454545?logo=paddypower\u0026logoColor=%23FFFFFF)  \n  基于全新架构的 战双帕弥什 小助手。图像技术 + 模拟控制，解放双手！由 玛丽的黑咖啡 2.0 强力驱动！\n\n- [MaaYuan](https://github.com/syoius/MaaYuan) 代号鸢/如鸢 一键长草小助手  ![Pipeline](https://img.shields.io/badge/Pipeline-%23454545?logo=paddypower\u0026logoColor=%23FFFFFF)  \n  基于全新架构的 代号鸢/如鸢 小助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！\n\n- [MFW-ELE-GUI](https://github.com/Night-stars-1/maa-gui) MFW-ELE-GUI ![Typescript](https://img.shields.io/badge/Typescript-8A2BE2?logo=typescript)  ![Electron](https://img.shields.io/badge/Electron-3776AB?logo=electron\u0026logoColor=black)  \n  基于全新架构的 MFW-ELE-GUI。由 MaaFramework 强力驱动！\n\n- [Maa-HBR](https://github.com/KarylDAZE/Maa-HBR) 炽焰天穹/HBR 小助手  ![Pipeline](https://img.shields.io/badge/Pipeline-%23454545?logo=paddypower\u0026logoColor=%23FFFFFF)  \n  基于全新架构的 炽焰天穹/HBR 小助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！\n\n- [MFW-PyQt6](https://github.com/overflow65537/MFW-PyQt6) MFW-PyQt6 ![python](https://img.shields.io/badge/Python-3776AB?logo=python\u0026logoColor=white)  \n  基于PyQt6的通用GUI。由 MaaFramework 强力驱动！\n\n- [MaaGF2Exilium](https://github.com/DarkLingYun/MaaGF2Exilium) 少女前线2: 追放自动化助手 ![Pipeline](https://img.shields.io/badge/Pipeline-%23454545?logo=paddypower\u0026logoColor=%23FFFFFF)  \n  基于全新架构的 少女前线2: 追放自动化助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！\n\n- [MaaAshEchoes](https://github.com/moulai/MaaAshEchoes) 白荆回廊 小助手 ![Pipeline](https://img.shields.io/badge/Pipeline-%23454545?logo=paddypower\u0026logoColor=%23FFFFFF)  \n  基于全新架构的 白荆回廊 小助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！\n  \n## 生态共建\n\nMAA 正计划建设为一类项目，而非舟的单一软件。  \n\n若您的项目依赖于 MaaFramework ，我们欢迎您将它命名为 MaaXXX, MXA, MAX 等等。当然，这是许可而不是限制，您也可以自由选择其他与 MAA 无关的名字，完全取决于您自己的想法！  \n\n同时，我们也非常欢迎您提出 PR ，在上方的最佳实践列表中添加上您的项目！\n\n## 许可证\n\n### MaaFramework\n\n本项目采用 [`LGPL-3.0`](./LICENSE.md) 许可证进行开源。\n\n### DirectML\n\n本项目支持 GPU 加速功能，其在 Windows 平台上依赖于 Microsoft 提供的独立组件 [DirectML](https://learn.microsoft.com/en-us/windows/ai/directml/)。DirectML 并非本项目的开源部分，也不受 LGPL-3.0 的约束。为方便用户，我们随安装包附带了一个未经修改的 DirectML.dll 文件。如果您无需 GPU 加速功能，可安全删除该 DLL 文件，软件的核心功能仍可正常运行。\n\n## 开发\n\n_请留意，仅当您准备开发 MaaFramework 本身时，才需要阅读本章节内容。若您仅希望基于 MaaFramework 开发自己的应用，则请参考 [即刻开始](#即刻开始)。_\n\n- [构建指南](docs/zh_cn/4.1-构建指南.md)\n- [接口设计](docs/zh_cn/4.2-标准化接口设计.md)\n\n## 鸣谢\n\n### 开源库\n\n- [opencv](https://github.com/opencv/opencv)  \n  Open Source Computer Vision Library\n- [fastdeploy](https://github.com/PaddlePaddle/FastDeploy)  \n  ⚡️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.\n- [onnxruntime](https://github.com/microsoft/onnxruntime)  \n  ONNX Runtime: cross-platform, high performance ML inferencing and training accelerator\n- [boost](https://www.boost.org/)  \n  Boost provides free peer-reviewed portable C++ source libraries.\n- [meojson](https://github.com/MistEO/meojson)  \n  ✨ Next-gen C++ JSON/JSON5 Serialization Engine | Zero Dependency | Header-Only | Unleash JSON Potential\n- [minitouch](https://github.com/DeviceFarmer/minitouch)  \n  Minimal multitouch event producer for Android.\n- [maatouch](https://github.com/MaaAssistantArknights/MaaTouch)  \n  Android native implementation of minitouch input protocol\n- [minicap](https://github.com/DeviceFarmer/minicap)  \n  Stream real-time screen capture data out of Android devices.\n- [zlib](https://github.com/madler/zlib)  \n  A massively spiffy yet delicately unobtrusive compression library.\n- [gzip-hpp](https://github.com/mapbox/gzip-hpp)  \n  Gzip header-only C++ library\n- ~~[protobuf](https://github.com/protocolbuffers/protobuf)~~  \n  ~~Protocol Buffers - Google's data interchange format~~\n- ~~[grpc](https://github.com/grpc/grpc)~~  \n  ~~The C based gRPC (C++, Python, Ruby, Objective-C, PHP, C#)~~\n- ~~[thrift](https://github.com/apache/thrift)~~  \n  ~~Apache Thrift~~\n\n### 开发者\n\n感谢以下开发者对 MaaFramework 作出的贡献：\n\n[![Contributors](https://contrib.rocks/image?repo=MaaXYZ/MaaFramework\u0026max=1000)](https://github.com/MaaXYZ/MaaFramework/graphs/contributors)\n\n## 讨论\n\n- 集成/开发交流 QQ 群: 595990173\n\n## 赞助\n\n\u003c!-- markdownlint-disable MD045 --\u003e\n\u003ca href=\"https://afdian.com/a/misteo\"\u003e\n  \u003cimg width=\"200\" src=\"https://pic1.afdiancdn.com/static/img/welcome/button-sponsorme.png\"\u003e\n\u003c/a\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMaaXYZ%2FMaaFramework","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FMaaXYZ%2FMaaFramework","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMaaXYZ%2FMaaFramework/lists"}