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

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.188
File Size Uploaded
ok_script-1.0.188.tar.gz 730.3 kB Details

Built distribution (wheel)

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

Total release size: 1.5 MB

Release files / ok_script-1.0.188.tar.gz

Download URL ok_script-1.0.188.tar.gz
Size 730.3 kB
Tags Source
SHA-256 checksum
How to use checksums 		5e2739a78e6ab6bb6a0f9219fc3c0ae4e210f78936c78148ca5900a08716eb49
BLAKE2b-256 checksum
How to use checksums 		4d8023c6f395fad5a185748e03202cd80ce2584cf60ebb857ea0ab05c6bf794c
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.188-py3-none-any.whl

Download URL ok_script-1.0.188-py3-none-any.whl
Size 777.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums 		72f45bbef2a62abdbcdb0fb8294c4cab3cadbadceb253eedbf85dbdacb03f685
BLAKE2b-256 checksum
How to use checksums 		4227a05c5f63ef9d8bfc06a93ab7f54f253e0c3701a04464eecabdeb6c43b45c
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

This release

1.0.188 This release

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