ok-oldking/ok-script

해결하는 문제

Windows 애플리케이션, Windows 게임, Android 에뮬레이터, ADB 연결 장치와의 상호작용을 자동화하기 위한 통합된 Python 프레임워크를 제공합니다. 다양한 플랫폼용 별도의 자동화 스크립트를 작성할 필요 없이, 하나의 작업 코드 세트로 이러한 환경을 모두 지원할 수 있습니다.

작동 방식

프레임워크는 컴퓨터 비전을 활용하여 UI 요소를 식별하고 액션을 트리거합니다. OCR(광학 문자 인식), OpenCV 템플릿 매칭, YOLO 기반 탐지와 같은 여러 비전 기술을 통합합니다. 시각 자산을 관리하기 위해 템플릿 자료에 COCO 형식을 사용하며, 타겟 장치의 화면 해상도에 따라 템플릿을 자동으로 스케일링할 수 있습니다.

대상 사용자

데스크톱 소프트웨어 및 Windows 또는 Android에서 실행되는 모바일 게임을 대상으로 하는 자동화 봇을 개발하는 개발자들을 위한 것입니다.

주요 특징

• 다중 플랫폼 지원: 하나의 코드베이스로 Windows 클라이언트, Android 에뮬레이터, ADB 장치에서 모두 작동합니다.
• 유연한 인터페이스 옵션: 헤드리스 모드, Qt 기반 데스크톱 GUI, FastAPI 기반 웹 인터페이스로 실행 가능합니다.
• 비전 통합: OCR, 템플릿 매칭, YOLO 내장 지원.
• 해상도 적응: 다양한 화면 해상도에 자동으로 템플릿을 스케일링합니다.
• 개발자 도구: 스크린샷, 입력 시뮬레이션, 장치 제어, 시각적 디버깅 오버레이 등의 도구를 포함합니다.