Repolode
提交项目
MaaXYZ

MaaXYZ/MaaFramework

基于图像识别的 C++ 自动化黑盒测试框架，支持 Windows、Linux、macOS 和 Android。

在 GitHub 查看官网
Star
5,036
Fork
579
未关闭 Issue
124
最近提交
昨天

这是什么？

MaaFramework 是一个基于图像识别的黑盒自动化测试框架，通过识别屏幕上的目标画面，再用模拟输入操作界面。它用 C++ 编写，开发者可以把任务描述为一条由识别与操作步骤组成的流水线，而不必逐个手写交互逻辑。

框架提供低代码的 Pipeline 协议用于定义任务，同时提供集成接口，便于嵌入到应用程序中。项目列出了 Python、C#、Node.js、Go 和 Rust 的官方绑定与发布包，并提供 ProjectInterface 协议用于打包可复用的项目。

项目支持 Windows、Linux、macOS 和 Android 平台。社区基于它开发了多款图形界面工具、调试器、日志分析工具以及各类游戏自动化助手。

核心功能

  • 01通过图像识别定位界面元素，并用模拟输入进行操作。
  • 02使用低代码 Pipeline 协议定义自动化任务。
  • 03提供集成接口，并有多种语言的官方绑定。
  • 04支持 Windows、Linux、macOS 和 Android 平台。
  • 05通过 ProjectInterface 协议打包可复用的项目。

适用场景

  • 为没有开放 API 的游戏或应用自动执行重复性操作。
  • 在无法接入源码钩子的软件上进行黑盒界面测试。
  • 构建可复用的自动化项目，供他人通过图形界面或命令行运行。

快速上手

  1. 1

    打开 docs 目录中的快速开始文档

  2. 2

    选择语言绑定（Python、Node、Go、Rust、C#），并按 README 中列出的包管理器安装

使用前须知

  • 采用 LGPL-3.0 许可证，这是一种 Copyleft 许可证，对库本身的修改部分有相应的开源要求。

标签

#automation#computer-vision#image-recognition#black-box-testing#cpp#gui-automation

常见问题

MaaFramework 是什么？
基于图像识别的 C++ 自动化黑盒测试框架，支持 Windows、Linux、macOS 和 Android。 MaaFramework 是一个基于图像识别的黑盒自动化测试框架，通过识别屏幕上的目标画面，再用模拟输入操作界面。它用 C++ 编写，开发者可以把任务描述为一条由识别与操作步骤组成的流水线，而不必逐个手写交互逻辑。
MaaFramework 可以免费使用吗？用的什么许可证？
MaaFramework 以 LGPL-3.0 许可证开源。用于商业产品前，请先确认许可证条款。
MaaFramework 还在维护吗？
活跃维护中。MaaFramework 最近一次提交是在 2026年10月19日。
MaaFramework 适合用来做什么？
为没有开放 API 的游戏或应用自动执行重复性操作。 在无法接入源码钩子的软件上进行黑盒界面测试。 构建可复用的自动化项目，供他人通过图形界面或命令行运行。
MaaFramework 怎么安装和运行？
打开 docs 目录中的快速开始文档 选择语言绑定（Python、Node、Go、Rust、C#），并按 README 中列出的包管理器安装
在哪里获取 MaaFramework？
源代码和安装说明在 GitHub 上：https://github.com/MaaXYZ/MaaFramework

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目