【免费下载链接】ok-scriptModern Python Computer Vision Automation Framework项目地址https://gitcode.com/gh_mirrors/ok/ok-script点击查看免费下载ok-script是一个基于计算机视觉的 Python 自动化框架面向 Windows 游戏、安卓模拟器和 ADB 设备内置截图、模板匹配、OCR、任务调度与可视化调试工具。本文带你从环境安装、项目创建到跑通第一个游戏自动化任务完成 ok-script 快速上手的完整流程。ok-script 是什么一图看懂游戏自动化原理游戏自动化的核心循环只有三步游戏截图 → 图像分析 → 模拟操作。程序像人一样用眼睛看画面、用大脑做决策、用手点鼠标按键盘。图识别确定按钮的位置并自动点击ok-script 把这条链路的常用能力都封装好了能力说明多设备支持同一套任务代码可同时适配 Windows 客户端、安卓模拟器和 ADB 真机视觉识别模板匹配、找色、OCR、YOLO 目标检测输入控制模拟鼠标、键盘、滑动、滚动等键鼠操作任务系统单次任务、触发式循环任务、计划任务可视化调试截图测试、识别浮层、模板标注工具框架核心实现在 ok/ 目录任务系统见 ok/task/设备控制见 ok/device/模板特征见 ok/feature/。开始前的准备环境要求清单动手前请确认你的环境满足以下要求详见 快速开始文档✅ Windows 10 或 Windows 11✅ Python 3.11推荐Python 3.12安装时勾选Add Python to PATH✅ Git✅ 一个 Windows 客户端游戏或已开启 ADB 的安卓模拟器/真机验证 Python 版本python --version 新手提示建议使用 PyCharm 或 VS Code 作为编辑器后续所有命令都在项目根目录的终端中执行。一键安装 ok-scriptpip 命令与依赖选择ok-script 通过 pip 安装并支持无界面、桌面 Qt、Web 三种运行模式按需选择安装配置即可# 默认无界面模式核心能力 python -m pip install ok-script[default] # 桌面图形界面推荐新手使用本文后续界面截图均基于此模式 python -m pip install ok-script[qt] # 浏览器 Web 界面 / ADB 设备 / OCR 能力 python -m pip install ok-script[web] python -m pip install ok-script[adb] python -m pip install ok-script[ocr]⚠️关于 OpenCVok-script 不会自动替你选择 OpenCV你只需安装四个变体中的一个python -m pip install opencv-python桌面有界面程序选opencv-python纯服务器无头环境选opencv-python-headless。详见 README。获取第一个项目从模板仓库创建你的自动化项目强烈建议基于官方模板项目ok-script-app创建自己的仓库再克隆到本地开发git clone https://gitcode.com/gh_mirrors/ok/ok-script cd ok-script如果你要从模板仓库ok-script-app复刻出属于你自己的项目仓库请替换为你自己的仓库地址。配置项目修改 config.py 指向你的游戏配置是告诉框架要控制哪个目标的关键一步。打开模板项目的src/config.py至少填写以下两项之一适配 Windows 客户端游戏windows { exe: [YourGame.exe], # 游戏可执行文件名 interaction: PostMessage, # 交互方式 }适配安卓模拟器 / 真机adb { packages: [com.abc.yourgame], # 游戏包名 }两项可以同时保留脚本会根据实际运行中的窗口或设备自动匹配。跑通第一个任务调试模式与诊断模板项目提供两种运行入口模式命令用途调试模式python main_debug.py额外输出日志并在游戏画面上画出识别框方便开发正式模式python main.py无额外绘制用于正式挂机启动后按顺序完成两个验证截图测试点击界面中的截图测试按钮确认项目screenshots目录下生成了截图文件运行诊断任务点击运行诊断任务按钮自动检查环境、截图与输入链路是否正常。⚠️ 常见问题Windows 游戏的输入方式如 PostMessage 之外的一些交互可能需要管理员权限。如果画面识别正常但点击没反应请以管理员身份启动终端或 IDE。认识图形界面任务、截图、脚本与模板四大工作台安装ok-script[qt]后桌面界面把整个开发流程集成在一起完整说明见 界面与开发工具文档截图与交互页——连接游戏窗口、选择截图方式WGC 速度更快BitBlt 兼容性更好与交互方式任务页——展示项目提供的所有单次任务与组合任务展开卡片即可修改下拉框、开关等配置无需改代码脚本页——左侧按鼠标、按键、OCR、模板匹配等分类浏览 API右侧直接查看/编辑任务源码还可以运行或录制脚本快速验证模板页——以卡片形式管理 COCO 标注的截图素材可截取新源图、按名称搜索、调整标注框调试时开启调试浮层识别过程会直接画在捕获画面上矩形框是搜索区域标签是特征名称和阈值能帮你快速发现模板过宽、阈值过低等问题。编写你自己的任务从示例任务模仿开始模板项目的核心在于任务扩展两个示例文件就是最佳起点src/tasks/MyOneTimeTask.py只执行一次的单次任务例如点击签到src/tasks/MyTriggerTask.py基于触发器时间、图像识别循环执行的任务例如自动战斗。任务类继承自框架的BaseTask定义见 ok/task/task.py编写时只需关注几类常用 API场景常用 API说明找图find_one/wait_feature在截图中定位模板等待出现点击click_box/click_box_if_name_match点击识别到的按钮文字识别ocr/wait_click_ocr读取画面文字并点击状态等待wait_ocr/feature_exists监控画面直到满足条件例如等待某个按钮出现然后点击核心就两行逻辑wait_feature(确定按钮)click_box。所有方法的参数细节可查询 API 参考。遇到问题怎么办常见坑位清单现象可能原因与解决能截图但点击无反应交互方式不匹配或缺少管理员权限以管理员身份运行识别不到按钮模板分辨率与画面不一致建议用最高分辨率截图标注框架会自动缩放适配截图全黑/花屏更换截图方式WGC ↔ BitBltHDR 游戏参考 interface.md 的 HDR 说明模拟器连不上确认 ADB 已启用并已安装ok-script[adb]下一步学习路线跑通第一个项目后建议按这条路径深入入口都在 文档中心原理游戏自动化入门——截图、图像分析、决策与输入的基本原理进阶进阶指南——COCO 模板标注、i18n 多语言、自动化测试与打包发布APIAPI 参考——Box、BaseTask及找图/找色/OCR 全部方法。 到这里你已经完成了 ok-script 从 0 到 1 的完整上手安装框架 → 配置游戏 → 截图测试 → 运行诊断 → 编写任务。祝你的第一个自动化项目顺利跑起来赞分享【免费下载链接】ok-scriptModern Python Computer Vision Automation Framework项目地址https://gitcode.com/gh_mirrors/ok/ok-script点击查看免费下载相关推荐如何快速上手ThreadRace从零编译到跑通第一个并发基准的完整指南如何快速上手ThreadRace从零编译到跑通第一个并发基准的完整指南 ThreadRace 是一个 C 并发遥测Concurrency Telemet7步快速上手WiX Toolset从零构建专业级Windows安装包7步快速上手WiX Toolset从零构建专业级Windows安装包 WiX ToolsetWindows Installer XML是微软官方推荐的Wi开发工具构建工具如何快速上手InternVideo-1.0从下载模型到跑通第一个视频识别的完整指南如何快速上手InternVideo 1.0从下载模型到跑通第一个视频识别的完整指南 InternVideo 1.0 是 OpenGVLab 开源的 视频理解与创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/10/27 2:17:14 · 阅读 1.2k 如何快速上手ok-script：从0到1跑通第一个游戏自动化项目的完整指南
【免费下载链接】ok-scriptModern Python Computer Vision Automation Framework项目地址https://gitcode.com/gh_mirrors/ok/ok-script点击查看免费下载ok-script是一个基于计算机视觉的 Python 自动化框架面向 Windows 游戏、安卓模拟器和 ADB 设备内置截图、模板匹配、OCR、任务调度与可视化调试工具。本文带你从环境安装、项目创建到跑通第一个游戏自动化任务完成 ok-script 快速上手的完整流程。ok-script 是什么一图看懂游戏自动化原理游戏自动化的核心循环只有三步游戏截图 → 图像分析 → 模拟操作。程序像人一样用眼睛看画面、用大脑做决策、用手点鼠标按键盘。图识别确定按钮的位置并自动点击ok-script 把这条链路的常用能力都封装好了能力说明多设备支持同一套任务代码可同时适配 Windows 客户端、安卓模拟器和 ADB 真机视觉识别模板匹配、找色、OCR、YOLO 目标检测输入控制模拟鼠标、键盘、滑动、滚动等键鼠操作任务系统单次任务、触发式循环任务、计划任务可视化调试截图测试、识别浮层、模板标注工具框架核心实现在 ok/ 目录任务系统见 ok/task/设备控制见 ok/device/模板特征见 ok/feature/。开始前的准备环境要求清单动手前请确认你的环境满足以下要求详见 快速开始文档✅ Windows 10 或 Windows 11✅ Python 3.11推荐Python 3.12安装时勾选Add Python to PATH✅ Git✅ 一个 Windows 客户端游戏或已开启 ADB 的安卓模拟器/真机验证 Python 版本python --version 新手提示建议使用 PyCharm 或 VS Code 作为编辑器后续所有命令都在项目根目录的终端中执行。一键安装 ok-scriptpip 命令与依赖选择ok-script 通过 pip 安装并支持无界面、桌面 Qt、Web 三种运行模式按需选择安装配置即可# 默认无界面模式核心能力 python -m pip install ok-script[default] # 桌面图形界面推荐新手使用本文后续界面截图均基于此模式 python -m pip install ok-script[qt] # 浏览器 Web 界面 / ADB 设备 / OCR 能力 python -m pip install ok-script[web] python -m pip install ok-script[adb] python -m pip install ok-script[ocr]⚠️关于 OpenCVok-script 不会自动替你选择 OpenCV你只需安装四个变体中的一个python -m pip install opencv-python桌面有界面程序选opencv-python纯服务器无头环境选opencv-python-headless。详见 README。获取第一个项目从模板仓库创建你的自动化项目强烈建议基于官方模板项目ok-script-app创建自己的仓库再克隆到本地开发git clone https://gitcode.com/gh_mirrors/ok/ok-script cd ok-script如果你要从模板仓库ok-script-app复刻出属于你自己的项目仓库请替换为你自己的仓库地址。配置项目修改 config.py 指向你的游戏配置是告诉框架要控制哪个目标的关键一步。打开模板项目的src/config.py至少填写以下两项之一适配 Windows 客户端游戏windows { exe: [YourGame.exe], # 游戏可执行文件名 interaction: PostMessage, # 交互方式 }适配安卓模拟器 / 真机adb { packages: [com.abc.yourgame], # 游戏包名 }两项可以同时保留脚本会根据实际运行中的窗口或设备自动匹配。跑通第一个任务调试模式与诊断模板项目提供两种运行入口模式命令用途调试模式python main_debug.py额外输出日志并在游戏画面上画出识别框方便开发正式模式python main.py无额外绘制用于正式挂机启动后按顺序完成两个验证截图测试点击界面中的截图测试按钮确认项目screenshots目录下生成了截图文件运行诊断任务点击运行诊断任务按钮自动检查环境、截图与输入链路是否正常。⚠️ 常见问题Windows 游戏的输入方式如 PostMessage 之外的一些交互可能需要管理员权限。如果画面识别正常但点击没反应请以管理员身份启动终端或 IDE。认识图形界面任务、截图、脚本与模板四大工作台安装ok-script[qt]后桌面界面把整个开发流程集成在一起完整说明见 界面与开发工具文档截图与交互页——连接游戏窗口、选择截图方式WGC 速度更快BitBlt 兼容性更好与交互方式任务页——展示项目提供的所有单次任务与组合任务展开卡片即可修改下拉框、开关等配置无需改代码脚本页——左侧按鼠标、按键、OCR、模板匹配等分类浏览 API右侧直接查看/编辑任务源码还可以运行或录制脚本快速验证模板页——以卡片形式管理 COCO 标注的截图素材可截取新源图、按名称搜索、调整标注框调试时开启调试浮层识别过程会直接画在捕获画面上矩形框是搜索区域标签是特征名称和阈值能帮你快速发现模板过宽、阈值过低等问题。编写你自己的任务从示例任务模仿开始模板项目的核心在于任务扩展两个示例文件就是最佳起点src/tasks/MyOneTimeTask.py只执行一次的单次任务例如点击签到src/tasks/MyTriggerTask.py基于触发器时间、图像识别循环执行的任务例如自动战斗。任务类继承自框架的BaseTask定义见 ok/task/task.py编写时只需关注几类常用 API场景常用 API说明找图find_one/wait_feature在截图中定位模板等待出现点击click_box/click_box_if_name_match点击识别到的按钮文字识别ocr/wait_click_ocr读取画面文字并点击状态等待wait_ocr/feature_exists监控画面直到满足条件例如等待某个按钮出现然后点击核心就两行逻辑wait_feature(确定按钮)click_box。所有方法的参数细节可查询 API 参考。遇到问题怎么办常见坑位清单现象可能原因与解决能截图但点击无反应交互方式不匹配或缺少管理员权限以管理员身份运行识别不到按钮模板分辨率与画面不一致建议用最高分辨率截图标注框架会自动缩放适配截图全黑/花屏更换截图方式WGC ↔ BitBltHDR 游戏参考 interface.md 的 HDR 说明模拟器连不上确认 ADB 已启用并已安装ok-script[adb]下一步学习路线跑通第一个项目后建议按这条路径深入入口都在 文档中心原理游戏自动化入门——截图、图像分析、决策与输入的基本原理进阶进阶指南——COCO 模板标注、i18n 多语言、自动化测试与打包发布APIAPI 参考——Box、BaseTask及找图/找色/OCR 全部方法。 到这里你已经完成了 ok-script 从 0 到 1 的完整上手安装框架 → 配置游戏 → 截图测试 → 运行诊断 → 编写任务。祝你的第一个自动化项目顺利跑起来赞分享【免费下载链接】ok-scriptModern Python Computer Vision Automation Framework项目地址https://gitcode.com/gh_mirrors/ok/ok-script点击查看免费下载相关推荐如何快速上手ThreadRace从零编译到跑通第一个并发基准的完整指南如何快速上手ThreadRace从零编译到跑通第一个并发基准的完整指南 ThreadRace 是一个 C 并发遥测Concurrency Telemet7步快速上手WiX Toolset从零构建专业级Windows安装包7步快速上手WiX Toolset从零构建专业级Windows安装包 WiX ToolsetWindows Installer XML是微软官方推荐的Wi开发工具构建工具如何快速上手InternVideo-1.0从下载模型到跑通第一个视频识别的完整指南如何快速上手InternVideo 1.0从下载模型到跑通第一个视频识别的完整指南 InternVideo 1.0 是 OpenGVLab 开源的 视频理解与创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考