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

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.190
File Size Uploaded
ok_script-1.0.190.tar.gz 731.1 kB Details

Built distribution (wheel)

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

Total release size: 1.5 MB

Release files / ok_script-1.0.190.tar.gz

Download URL ok_script-1.0.190.tar.gz
Size 731.1 kB
Tags Source
SHA-256 checksum
How to use checksums 		28c3559ca2c13f2426752b5d67c6f36cfa1a52c770873f70d6c670890778cc5d
BLAKE2b-256 checksum
How to use checksums 		58ef205f9d843b11ec110dbeb6ed71d3a8ea138a414428beedda5822aec1dc12
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.190-py3-none-any.whl

Download URL ok_script-1.0.190-py3-none-any.whl
Size 777.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums 		3ac40e6a10b4d3e7945a98423678570b4aaf09f1347a2bd62726594ab5e41f62
BLAKE2b-256 checksum
How to use checksums 		271d9d53622928ab2dc9fb67cefc760243f07765edd78ed8476231a1618ca040
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

This release

1.0.190 This release

2 release files

1.0.189

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