ok-script

简体中文 | English

Discord

基于计算机视觉的 Python 自动化框架，面向 Windows 应用、Windows 游戏、安卓模拟器和 ADB 设备。

ok-script 提供 UI、截图与输入、设备控制、OCR、模板匹配、调试浮层、自动化测试、打包和增量更新能力。它使用 COCO 格式管理模板素材，并支持分辨率自适应与多语言界面。

特性

  • 纯 Python 实现，免费开源，可直接使用 pip 生态中的第三方库
  • 同一套任务代码可支持 Windows 客户端、安卓模拟器和 ADB 设备
  • 支持 OCR、OpenCV 模板匹配以及 YOLO 等视觉方案
  • 基于 COCO 标注管理模板素材，并根据屏幕分辨率自动缩放
  • 内置截图、输入、设备控制和可视化调试工具
  • 支持自动化测试、GitHub Actions 构建和安装包发布
  • 支持多语言国际化和在线增量更新

快速安装

ok-script 支持 Python 3.11 及以上版本，推荐使用 Python 3.12。

python -m pip install ok-script

如果要创建完整的自动化项目，建议从 ok-script-app 模板开始，而不是直接在本仓库中编写业务脚本。

文档

从文档中心选择适合你的阅读路径：

  1. 游戏自动化入门：了解截图、识别、决策和输入的基本原理
  2. 快速开始：从模板仓库创建并运行第一个项目
  3. 进阶指南：模板匹配、国际化、测试和发布
  4. API 参考：Box、BaseTask 及常用任务 API

想先体验完整工具链，也可以使用基于 ok-script 的按键精灵项目 ok-py。

界面预览

任务配置 截图与交互
任务配置界面 截图与交互界面
脚本与 API 模板管理
脚本与 API 界面 模板管理界面

查看界面与开发工具完整说明，包括模板识别调试浮层。

使用 ok-script 的项目

社区与发布

许可证

本项目采用 AGPL-3.0 许可证。

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (2.0.6)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for CrashTechnologyOfficer from gravatar.com CrashTechnologyOfficer

Credits

Author: ok-oldking

License

MIT License

Requires

Python >=3.11

Classifiers

Report project as malware

Release files for ok-script 1.0.187

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ok-script 1.0.187
File Size Uploaded
ok_script-1.0.187.tar.gz 730.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for ok-script 1.0.187
File Interpreter ABI Platform
ok_script-1.0.187-py3-none-any.whl 777.3 kB Python 3 none any Details

Total release size: 1.5 MB

Release files / ok_script-1.0.187.tar.gz

Download URL ok_script-1.0.187.tar.gz
Size 730.4 kB
Tags Source
SHA-256 checksum
How to use checksums 		f0a95518f0cb550cf9b26fc76377ec9056688af4720cd65a8218bd4b6acb341d
BLAKE2b-256 checksum
How to use checksums 		de3db280544e9a651930a864b0abc631feef087a57a77d2b74fc08af9bfc29ed
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing? 		No
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / ok_script-1.0.187-py3-none-any.whl

Download URL ok_script-1.0.187-py3-none-any.whl
Size 777.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums 		27b4d7329b391a2e6432b0f0c7fa6f14ab28ba2660efa9f6a0627bb1f891359f
BLAKE2b-256 checksum
How to use checksums 		481bec24c10d0c7ef94c3f097c2e11b1cac350f87c97708562df01d14d6199ea
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing? 		No
Uploaded via twine/7.0.0 CPython/3.13.14

Release history Release notifications | RSS feed

Pre-release

2.0.7b1

2 release files

2.0.6

2 release files

2.0.5

2 release files

2.0.4

2 release files

2.0.3

2 release files

2.0.2

2 release files

2.0.1

2 release files

2.0.0

2 release files

Pre-release

2.0.0b7

2 release files

Pre-release

2.0.0b6

2 release files

Pre-release

2.0.0b5

2 release files

Pre-release

2.0.0b4

2 release files

Pre-release

2.0.0b3

2 release files

Pre-release

2.0.0b2

2 release files

Pre-release

2.0.0b1

2 release files

1.0.190

2 release files

1.0.189

2 release files

1.0.188

2 release files

This release

1.0.187 This release

2 release files

1.0.185

2 release files

1.0.184

2 release files

1.0.183

2 release files

1.0.182

2 release files

1.0.181

2 release files

1.0.180

2 release files

1.0.179

2 release files

1.0.178

1 release file

1.0.177

2 release files

1.0.176

2 release files

1.0.175

2 release files

1.0.174

2 release files

1.0.173

2 release files

1.0.172

2 release files

1.0.171

2 release files

1.0.170

2 release files

1.0.169

2 release files

1.0.168

2 release files

1.0.167

2 release files

1.0.166

2 release files

1.0.165

2 release files

1.0.163

2 release files

1.0.162

2 release files

1.0.161

2 release files

1.0.160

2 release files

1.0.159

2 release files

1.0.158

2 release files

1.0.157

2 release files

1.0.156

2 release files

1.0.155

2 release files

1.0.154

2 release files

1.0.153

2 release files

1.0.152

2 release files

1.0.151

2 release files

1.0.150

2 release files

1.0.149

2 release files

1.0.148

2 release files

1.0.147

2 release files

1.0.145

2 release files

1.0.144

2 release files

1.0.143

2 release files

1.0.142

2 release files

1.0.141

2 release files

1.0.140

2 release files

1.0.139

2 release files

1.0.138

2 release files

1.0.137

2 release files

1.0.136

2 release files

1.0.135

2 release files

1.0.134

2 release files

1.0.133

2 release files

1.0.132

2 release files

1.0.131

2 release files

1.0.130

2 release files

1.0.129

2 release files

1.0.128

2 release files

1.0.127

2 release files

1.0.126

2 release files

1.0.125

2 release files

1.0.124

2 release files

1.0.123

2 release files

1.0.122

2 release files

1.0.121

2 release files

1.0.120

2 release files

1.0.119

2 release files

1.0.118

2 release files

1.0.117

2 release files

1.0.116

2 release files

1.0.115

2 release files

1.0.114

2 release files

1.0.113

2 release files

1.0.112

2 release files

1.0.111

2 release files

1.0.110

2 release files

1.0.109

2 release files

1.0.108

2 release files

1.0.107

2 release files

1.0.106

2 release files

1.0.105

2 release files

1.0.104

2 release files

1.0.103

2 release files

1.0.102

2 release files

1.0.101

2 release files

1.0.100

2 release files

1.0.99

2 release files

1.0.98

2 release files

1.0.97

2 release files

1.0.96

2 release files

1.0.95

2 release files

1.0.94

2 release files

1.0.93

2 release files

1.0.92

2 release files

1.0.91

2 release files

1.0.90

2 release files

1.0.89

2 release files

1.0.88

2 release files

1.0.87

2 release files

1.0.86

2 release files

1.0.85

2 release files

1.0.84

2 release files

1.0.83

2 release files

1.0.82

2 release files

1.0.81

2 release files

1.0.80

2 release files

1.0.79

2 release files

1.0.78

2 release files

1.0.77

2 release files

1.0.76

2 release files

1.0.75

2 release files

1.0.74

2 release files

1.0.73

2 release files

1.0.72

2 release files

1.0.71

2 release files

1.0.70

2 release files

1.0.69

2 release files

1.0.68

2 release files

1.0.67

2 release files

1.0.66

2 release files

1.0.65

2 release files

1.0.64

2 release files

1.0.63

2 release files

1.0.62

2 release files

1.0.61

2 release files

1.0.60

2 release files

1.0.59

2 release files

1.0.58

2 release files

1.0.57

2 release files

1.0.56

2 release files

1.0.55

2 release files

1.0.54

2 release files

1.0.53

2 release files

1.0.52

2 release files

1.0.51

2 release files

1.0.50

2 release files

1.0.49

2 release files

1.0.48

2 release files

1.0.47

2 release files

1.0.46

2 release files

1.0.45

2 release files

1.0.44

2 release files

1.0.43

2 release files

1.0.42

2 release files

1.0.41

2 release files

1.0.40

2 release files

1.0.39

2 release files

1.0.38

2 release files

1.0.37

2 release files

1.0.36

2 release files

1.0.35

2 release files

1.0.34

2 release files

1.0.33

2 release files

1.0.32

2 release files

1.0.31

2 release files

1.0.30

2 release files

1.0.29

2 release files

1.0.28

2 release files

1.0.27

2 release files

1.0.26

2 release files

1.0.25

2 release files

1.0.24

2 release files

1.0.23

2 release files

1.0.22

2 release files

1.0.21

2 release files

1.0.20

2 release files

1.0.19

2 release files

1.0.18

2 release files

1.0.17

2 release files

1.0.16

2 release files

1.0.15

2 release files

1.0.14

2 release files

1.0.13

2 release files

1.0.12

2 release files

1.0.11

2 release files

1.0.10

2 release files

1.0.9

2 release files

1.0.8

2 release files

1.0.7

2 release files

1.0.6

2 release files

1.0.5

2 release files

1.0.4

2 release files

1.0.3

2 release files

1.0.2

2 release files

1.0.1

2 release files

1.0.0

2 release files

0.0.617

2 release files

0.0.616

2 release files

0.0.615

2 release files

0.0.614

2 release files

0.0.613

2 release files

0.0.612

2 release files

0.0.611

2 release files

0.0.610

2 release files

0.0.609

2 release files

0.0.608

2 release files

0.0.607

2 release files

0.0.606

2 release files

0.0.605

2 release files

0.0.604

2 release files

0.0.603

2 release files

0.0.602

2 release files

0.0.601

2 release files

0.0.600

2 release files

0.0.599

2 release files

0.0.598

2 release files

0.0.597

2 release files

0.0.596

2 release files

0.0.595

2 release files

0.0.594

2 release files

0.0.593

2 release files

0.0.592

2 release files

0.0.591

2 release files

0.0.590

2 release files

0.0.589

2 release files

0.0.588

2 release files

0.0.587

2 release files

0.0.586

2 release files

0.0.585

2 release files

0.0.584

2 release files

0.0.583

2 release files

0.0.582

2 release files

0.0.581

2 release files

0.0.580

2 release files

0.0.579

2 release files

0.0.578

2 release files

0.0.577

2 release files

0.0.576

2 release files

0.0.575

2 release files

0.0.574

2 release files

0.0.573

2 release files

0.0.572

2 release files

0.0.571

2 release files

0.0.570

2 release files

0.0.569

2 release files

0.0.568

2 release files

0.0.567

2 release files

0.0.566

2 release files

0.0.565

2 release files

0.0.564

2 release files

0.0.563

2 release files

0.0.562

2 release files

0.0.561

2 release files

0.0.560

2 release files

0.0.559

2 release files

0.0.558

2 release files

0.0.557

2 release files

0.0.556

2 release files

0.0.555

2 release files

0.0.554

2 release files

0.0.553

2 release files

0.0.552

2 release files

0.0.551

2 release files

0.0.550

2 release files

0.0.549

2 release files

0.0.548

2 release files

0.0.547

2 release files

0.0.546

2 release files

0.0.545

2 release files

0.0.544

2 release files

0.0.543

2 release files

0.0.542

2 release files

0.0.541

2 release files

0.0.540

2 release files

0.0.539

2 release files

0.0.538

2 release files

0.0.537

2 release files

0.0.536

2 release files

0.0.535

2 release files

0.0.534

2 release files

0.0.533

2 release files

0.0.532

2 release files

0.0.531

2 release files

0.0.530

2 release files

0.0.529

2 release files

0.0.528

2 release files

0.0.527

2 release files

0.0.526

2 release files

0.0.525

2 release files

0.0.524

2 release files

0.0.523

2 release files

0.0.522

2 release files

0.0.521

2 release files

0.0.520

2 release files

0.0.519

2 release files

0.0.518

2 release files

0.0.517

2 release files

0.0.516

2 release files

0.0.515

2 release files

0.0.514

2 release files

0.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page