ok-script

ok-script

• ok-script 是基于图像识别技术, 纯Python实现的, 支持Windows窗口和模拟器的自动化测试框架。
• 框架包含UI, 截图, 输入, 设备控制, OCR, 模板匹配, 框框Debug浮层, 基于Github Action的测试, 打包, 升级/降级。
• 基于开发一个工业级的自动化软件仅需几百行代码。

优势

• 纯Python实现, 免费开源, 依赖库均为开源方案
• 支持pip install任何第三方库, 可以方便整合yolo等框架
• 一套代码即可支持Windows安卓模拟器/ADB连接的虚拟机, Windows客户端游戏
• 自适应分辨率
• 使用coco管理图片匹配素材, 仅需一个分辨率下的截图就, 支持不同分辨率自适应
• 可打包离线/在线安装setup.exe, 支持通过Pip/Git国内镜像在线增量更新. 在线安装包仅3M
• 支持Github Action一键构建
• 支持多语言国际化

使用 目前仅支持Python 3.12

• 在你的项目中通过pip依赖使用

pip install ok-script

• 本地编译源码使用

pip install -r requirements.txt # 安装编译ok-script所需的的依赖
mklink /d "C:\path\to\your-project\ok" "C:\path\to\ok-script\ok" #Windows CMD 创建软链接到你的项目中
in_place_build.bat #如修改__init__.pyx 需要编译Cython代码

• 编译国际化文件

cd ok\gui\i18n
.\release.cmd
cd ok\gui
.\qrc.cmd

文档和示例代码

• 游戏自动化入门
  • 1、基本原理：计算机如何“玩”游戏
    • 核心循环：三步走
    • 图像分析：从像素到决策
      • 传统图色算法 (OpenCV 库)
      • 神经网络推理 (Inference)
    • 2、编程语言选择
      • 常用库概览
    • 3、开发工具
• 快速开始
• 进阶使用
  • 1. 模板匹配 (Template Matching)
  • 2. 多语言国际化 (i18n)
  • 3. 自动化测试
  • 4. 使用 GitHub Action 自动化打包与发布
• API文档
• 开发者群: 938132715
• pip https://pypi.org/project/ok-script

使用ok-script的项目：

• 鸣潮 https://github.com/ok-oldking/ok-wuthering-wave
• 原神(不在维护, 但是后台过剧情可用) https://github.com/ok-oldking/ok-genshin-impact
• 少前2 https://github.com/ok-oldking/ok-gf2
• 星铁 https://github.com/Shasnow/ok-starrailassistant
• 星痕共鸣 https://github.com/Sanheiii/ok-star-resonance
• 二重螺旋 https://github.com/BnanZ0/ok-duet-night-abyss
• 白荆回廊(停止更新) https://github.com/ok-oldking/ok-baijing