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.189

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.189
File Size Uploaded
ok_script-1.0.189.tar.gz 731.4 kB Details

Built distribution (wheel)

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

Total release size: 1.5 MB

Release files / ok_script-1.0.189.tar.gz

Download URL ok_script-1.0.189.tar.gz
Size 731.4 kB
Tags Source
SHA-256 checksum
How to use checksums 		a3878e032932446b9542923e59b669d8ad771e2340e2aade685d471ac4d9d50a
BLAKE2b-256 checksum
How to use checksums 		29667c25266b318e1580eb90ca9c5f980039794c16c5c22abe2e94b336ce7d01
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.189-py3-none-any.whl

Download URL ok_script-1.0.189-py3-none-any.whl
Size 777.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums 		e0d6ba03fe6ff746a8d2c184e93567b499430a5399139c7d4d828143b927a195
BLAKE2b-256 checksum
How to use checksums 		ccad530acf3febd7d12ab324e4a155d28741c015bd7bbb96ddeaacf89a470625
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

This release

1.0.189 This release

2 release files

1.0.188

2 release files

1.0.187

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