ok-oldking/ok-script

해결하는 문제

Windows 애플리케이션, Windows 게임, Android 에뮬레이터, ADB 장치 간의 작업을 자동화하기 위한 통합된 Python 프레임워크를 제공합니다. 다양한 플랫폼용 별도의 자동화 로직을 작성할 필요 없이, 화면 상호작용 및 장치 제어를 위한 일관된 도구 세트를 제공합니다.

작동 방식

프레임워크는 컴퓨터 비전을 사용하여 UI 요소를 식별하고 액션을 트리거합니다. OCR, OpenCV 템플릿 매칭, YOLO 기반 비전 솔루션 등 여러 인식 방법을 지원합니다. 시각적 자산을 관리하기 위해 COCO 형식을 사용하며, 타겟 장치의 화면 해상도에 따라 템플릿을 자동으로 스케일링할 수 있습니다.

대상 사용자

공식 API가 없는 소프트웨어 및 게임용 봇 또는 자동 테스트를 개발해야 하는 개발자 및 자동화 엔지니어. 특히 Windows 및 Android 환경을 대상으로 하는 사용자.

주요 특징

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