This release is a pre-release and may not be stable for production use.
ok-script
无界面、桌面与 Web 模式
自动化核心现已与 Qt 解耦。使用 ok-script 可无界面运行，使用
ok-script[qt] 启用原有桌面界面，或使用 ok-script[web] 启用 FastAPI
浏览器界面；对应命令为 ok run_task、ok gui 和 ok web。详见
运行时架构。
基于计算机视觉的 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
按使用场景安装界面依赖：
python -m pip install "ok-script[qt]"
python -m pip install "ok-script[web]"
开发本仓库时，使用 pyproject.toml 中的 default 依赖组安装完整开发环境：
python -m pip install --editable . --group default
如果要创建完整的自动化项目，建议从 ok-script-app 模板开始，而不是直接在本仓库中编写业务脚本。
文档
从文档中心选择适合你的阅读路径：
想先体验完整工具链，也可以使用基于 ok-script 的按键精灵项目 ok-py。
界面预览
| 任务配置 | 截图与交互 |
|---|---|
 |
 |
| 脚本与 API | 模板管理 |
|---|---|
 |
 |
查看界面与开发工具完整说明，包括模板识别调试浮层。
使用 ok-script 的项目
社区与发布
许可证
本项目采用 AGPL-3.0 许可证。
1 maintainer
Release files for ok-script 2.0.0b2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| ok_script-2.0.0b2.tar.gz | 1.0 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ok_script-2.0.0b2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 2.1 MB
Release files / ok_script-2.0.0b2.tar.gz
| Download URL | ok_script-2.0.0b2.tar.gz |
|---|---|
| Size | 1.0 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ae0635f870119f6675f5dce55b7324d737eb7683cf1fa9790d997a23a3d8af0c
|
|
BLAKE2b-256 checksum How to use checksums |
17fc92edfae32c052f965a11a4211cccf59df4aa0c9328c7715e2302a57f4ef0
|
| 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-2.0.0b2-py3-none-any.whl
| Download URL | ok_script-2.0.0b2-py3-none-any.whl |
|---|---|
| Size | 1.0 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
df5ed7860d91b4c215dda8bbe31c64c90bdc4ea642abab4ee0a61cd01687f3eb
|
|
BLAKE2b-256 checksum How to use checksums |
b12aec2482135bc3b3fbb16620a642795d7c7001e73d47ba37f943ed4467b7f7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
