Repolode
MaaXYZ

MaaXYZ/MaaFramework

Фреймворк на C++ с лицензией LGPL-3.0 для автоматизации и тестирования методом чёрного ящика на Windows, Linux, macOS и Android с помощью распознавания изображений.

Звёзды
5,036
Форки
579
Открытые issues
124
Последний коммит
вчера

Что это?

MaaFramework — это фреймворк для автоматизированного тестирования методом чёрного ящика: он находит цели на экране с помощью распознавания изображений и управляет интерфейсом, имитируя ввод. Фреймворк написан на C++ и позволяет описывать задачи как последовательность шагов распознавания и действий, вместо того чтобы вручную кодировать каждое взаимодействие.

В проекте есть low-code протокол конвейеров для описания задач, а также API интеграции, позволяющий встраивать фреймворк в приложения. В README перечислены официальные биндинги и пакеты для Python, C#, Node.js, Go и Rust, а также описан протокол ProjectInterface для упаковки переиспользуемых проектов.

В README указано, что поддерживаются Windows, Linux, macOS и Android. На базе фреймворка создан ряд графических интерфейсов, отладчиков, анализаторов логов и помощников для конкретных игр, разработанных сообществом.

Ключевые возможности

  • 01Находит элементы интерфейса с помощью распознавания изображений и управляет ими, имитируя ввод.
  • 02Позволяет описывать задачи автоматизации с помощью low-code протокола конвейеров.
  • 03Предоставляет API интеграции и официальные биндинги для нескольких языков.
  • 04Работает на Windows, Linux, macOS и Android.
  • 05Поддерживает упаковку переиспользуемых проектов с помощью протокола ProjectInterface.

Сценарии использования

  • Автоматизация повторяющихся действий в игре или приложении без API.
  • Запуск тестов интерфейса методом чёрного ящика для ПО, в котором недоступны хуки на уровне исходного кода.
  • Создание переиспользуемого проекта автоматизации, который другие смогут запускать через GUI или CLI.

Быстрый старт

  1. 1

    Откройте руководство по быстрому старту в папке docs

  2. 2

    Выберите языковую привязку (Python, Node, Go, Rust, C#) и установите её из реестра пакетов, указанного в README

Что важно знать

  • Лицензия — LGPL-3.0, лицензия с авторским левом; её условия распространяются на изменения библиотеки.

Темы

Частые вопросы

Что такое MaaFramework?
Фреймворк на C++ с лицензией LGPL-3.0 для автоматизации и тестирования методом чёрного ящика на Windows, Linux, macOS и Android с помощью распознавания изображений. MaaFramework — это фреймворк для автоматизированного тестирования методом чёрного ящика: он находит цели на экране с помощью распознавания изображений и управляет интерфейсом, имитируя ввод. Фреймворк написан на C++ и позволяет описывать задачи как последовательность шагов распознавания и действий, вместо того чтобы вручную кодировать каждое взаимодействие.
MaaFramework можно использовать бесплатно? Какая у него лицензия?
MaaFramework распространяется с открытым исходным кодом под лицензией LGPL-3.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.
MaaFramework всё ещё поддерживается?
Активно поддерживается. Последний коммит в MaaFramework — 19 окт. 2026 г..
Для чего можно использовать MaaFramework?
Автоматизация повторяющихся действий в игре или приложении без API. Запуск тестов интерфейса методом чёрного ящика для ПО, в котором недоступны хуки на уровне исходного кода. Создание переиспользуемого проекта автоматизации, который другие смогут запускать через GUI или CLI.
Как установить MaaFramework?
Откройте руководство по быстрому старту в папке docs Выберите языковую привязку (Python, Node, Go, Rust, C#) и установите её из реестра пакетов, указанного в README
Где скачать MaaFramework?
Исходный код и инструкции по установке — на GitHub: https://github.com/MaaXYZ/MaaFramework

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты