ok-oldking/ok-script

解決的問題

提供一個統一的 Python 框架，用於自動化 Windows 應用程式、Windows 遊戲、Android 模擬器和 ADB 裝置上的任務。它消除了為不同平台撰寫獨立自動化邏輯的需要，提供一組一致的工具，用於螢幕互動和裝置控制。

工作原理

該框架使用電腦視覺來識別 UI 元素並觸發動作。支援多種辨識方法，包括 OCR、OpenCV 模板比對和基於 YOLO 的視覺解決方案。為了管理視覺資產，它使用 COCO 格式，使系統能根據目標裝置的螢幕解析度自動縮放模板。

適用對象

需要為缺乏官方 API 的軟體和遊戲建立機器人或自動化測試的開發者與自動化工程師，特別是針對 Windows 和 Android 環境的使用者。

主要亮點

• 多平台支援：一套任務程式碼可在 Windows 客戶端、Android 模擬器和 ADB 裝置上運作。
• 彈性介面：支援無頭模式、基於 Qt 的桌面 GUI 或基於 FastAPI 的 Web 界面執行。
• 視覺驅動：整合 OCR、OpenCV 和 YOLO，實現強大的元件檢測能力。
• 解析度自適應：使用 COCO 格式的資產，自動將模板縮放以匹配不同螢幕解析度。
• 開發者工具：內建截圖、輸入模擬、裝置控制和視覺調試覆疊層等工具。