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:
Latest release

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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ok_script-1.0.185.tar.gz (658.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ok_script-1.0.185-py3-none-any.whl (730.4 kB view details)

Uploaded Python 3

File details

Details for the file ok_script-1.0.185.tar.gz.

File metadata

  • Download URL: ok_script-1.0.185.tar.gz
  • Upload date:
  • Size: 658.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.10

File hashes

Hashes for ok_script-1.0.185.tar.gz
Algorithm Hash digest
SHA256 64646541b02da6d4ac07f96f22d9c51447290cc5e81291a636006d60c8447a05
MD5 a19a495af48e951c8e592eb66f596a6c
BLAKE2b-256 018b30ff85090848d62be1233f48abebe3098af904795bf19b709e4e536de6a3

See more details on using hashes here.

File details

Details for the file ok_script-1.0.185-py3-none-any.whl.

File metadata

  • Download URL: ok_script-1.0.185-py3-none-any.whl
  • Upload date:
  • Size: 730.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.10

File hashes

Hashes for ok_script-1.0.185-py3-none-any.whl
Algorithm Hash digest
SHA256 f4a3828f9c63ff48d0dd35553921aa0c10c423ab2afa457e704ae8bbb7c95803
MD5 d5eecd2063d7db4e670ff2b9b799fe59
BLAKE2b-256 2d32fb63a713f8cbd45a835b3841e279448a05b4d6ecdd9204c71a0c8779bded

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

1.0.185

1.0.184

1.0.183

1.0.182

1.0.181

1.0.180

1.0.179

1.0.178

1.0.177

1.0.176

1.0.175

1.0.174

1.0.173

1.0.172

1.0.171

1.0.170

1.0.169

1.0.168

1.0.167

1.0.166

1.0.165

1.0.163

1.0.162

1.0.161

1.0.160

1.0.159

1.0.158

1.0.157

1.0.156

1.0.155

1.0.154

1.0.153

1.0.152

1.0.151

1.0.150

1.0.149

1.0.148

1.0.147

1.0.145

1.0.144

1.0.143

1.0.142

1.0.141

1.0.140

1.0.139

1.0.138

1.0.137

1.0.136

1.0.135

1.0.134

1.0.133

1.0.132

1.0.131

1.0.130

1.0.129

1.0.128

1.0.127

1.0.126

1.0.125

1.0.124

1.0.123

1.0.122

1.0.121

1.0.120

1.0.119

1.0.118

1.0.117

1.0.116

1.0.115

1.0.114

1.0.113

1.0.112

1.0.111

1.0.110

1.0.109

1.0.108

1.0.107

1.0.106

1.0.105

1.0.104

1.0.103

1.0.102

1.0.101

1.0.100

1.0.99

1.0.98

1.0.97

1.0.96

1.0.95

1.0.94

1.0.93

1.0.92

1.0.91

1.0.90

1.0.89

1.0.88

1.0.87

1.0.86

1.0.85

1.0.84

1.0.83

1.0.82

1.0.81

1.0.80

1.0.79

1.0.78

1.0.77

1.0.76

1.0.75

1.0.74

1.0.73

1.0.72

1.0.71

1.0.70

1.0.69

1.0.68

1.0.67

1.0.66

1.0.65

1.0.64

1.0.63

1.0.62

1.0.61

1.0.60

1.0.59

1.0.58

1.0.57

1.0.56

1.0.55

1.0.54

1.0.53

1.0.52

1.0.51

1.0.50

1.0.49

1.0.48

1.0.47

1.0.46

1.0.45

1.0.44

1.0.43

1.0.42

1.0.41

1.0.40

1.0.39

1.0.38

1.0.37

1.0.36

1.0.35

1.0.34

1.0.33

1.0.32

1.0.31

1.0.30

1.0.29

1.0.28

1.0.27

1.0.26

1.0.25

1.0.24

1.0.23

1.0.22

1.0.21

1.0.20

1.0.19

1.0.18

1.0.17

1.0.16

1.0.15

1.0.14

1.0.13

1.0.12

1.0.11

1.0.10

1.0.9

1.0.8

1.0.7

1.0.6

1.0.5

1.0.4

1.0.3

1.0.2

1.0.1

1.0.0

0.0.617

0.0.616

0.0.615

0.0.614

0.0.613

0.0.612

0.0.611

0.0.610

0.0.609

0.0.608

0.0.607

0.0.606

0.0.605

0.0.604

0.0.603

0.0.602

0.0.601

0.0.600

0.0.599

0.0.598

0.0.597

0.0.596

0.0.595

0.0.594

0.0.593

0.0.592

0.0.591

0.0.590

0.0.589

0.0.588

0.0.587

0.0.586

0.0.585

0.0.584

0.0.583

0.0.582

0.0.581

0.0.580

0.0.579

0.0.578

0.0.577

0.0.576

0.0.575

0.0.574

0.0.573

0.0.572

0.0.571

0.0.570

0.0.569

0.0.568

0.0.567

0.0.566

0.0.565

0.0.564

0.0.563

0.0.562

0.0.561

0.0.560

0.0.559

0.0.558

0.0.557

0.0.556

0.0.555

0.0.554

0.0.553

0.0.552

0.0.551

0.0.550

0.0.549

0.0.548

0.0.547

0.0.546

0.0.545

0.0.544

0.0.543

0.0.542

0.0.541

0.0.540

0.0.539

0.0.538

0.0.537

0.0.536

0.0.535

0.0.534

0.0.533

0.0.532

0.0.531

0.0.530

0.0.529

0.0.528

0.0.527

0.0.526

0.0.525

0.0.524

0.0.523

0.0.522

0.0.521

0.0.520

0.0.519

0.0.518

0.0.517

0.0.516

0.0.515

0.0.514

0.0.1

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page