ok-script

用 Python 看屏幕做操作,游戏自动化少写底层代码

开源 🏷️定价信息待确认 ✅ 目前可打开 自动化工作流 🍴 复刻 237 🐛 待处理 23 👀 关注 6
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 823
维护状态 活跃
是否开源 开源
定价模式 🏷️定价信息待确认

项目预览

ok-script 项目界面预览图
图片来源:项目官网

项目数据

分类自动化工作流
开发团队ok-oldking
定价模式🏷️定价信息待确认
价格说明定价信息待确认
访问状态✅ 目前可打开
是否开源是
开源协议NOASSERTION
主要语言Python
技术栈/模型ai,automation,computervision,game,mcp,python,vibecoding
GitHub 星标★ 823
上线时间2023-12-16 00:00:00
代码更新2026-11-04
仓库体积44.0 MB
本站数据更新2026-11-05
维护状态活跃
收录时间2026-09-18
浏览次数2

项目介绍

ok-script 是一个基于 Python 的现代计算机视觉自动化框架,主要面向游戏自动化与桌面操作场景。它把图像识别、模板匹配、OCR 等视觉能力与自动化控制流程结合起来,让开发者可以用 Python 脚本描述“看到什么就做什么”的自动化逻辑,而不必从零搭建截图、识别、点击的底层链路。框架通常提供截图采集、图像匹配、坐标定位、键鼠模拟、流程编排等模块,并强调可配置与可扩展,适合需要根据屏幕内容动态决策的自动化任务。相比传统按键精灵式工具,它更贴近编程与视觉识别,能处理界面变化、按钮位置不固定等复杂情况。项目处于早期阶段,星标约 737,社区和文档仍在成长中,适合愿意阅读源码、动手调试的开发者使用。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-09-18 · 当前星标 ★ 823

技术标签

使用教程

ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。

难度:进阶 约 25 分钟 部署方式:本地安装 4 步

环境要求

  • Windows
  • Python 3.10+
  • 支持 MCP 的代理

安装与启动步骤

  1. 1建环境

    让 agent 通过 MCP 写并测试自动化脚本。

    python -m venv .venv
    .\.venv\Scripts\python.exe -m pip install "ok-script[default]"
  2. 2连 MCP

    把 ok-script 注册给编码代理。

    # 按 README 配置 MCP 连接
  3. 3让代理写任务

    描述需求,代理观察界面并产出 Python 任务。

    # 在代理里描述:每天登录后领取日常奖励
  4. 4脱离代理运行

    脚本保存后可从 GUI 或命令行重复跑。

    ok-script run <task>

如何确认成功

保存的脚本不依赖模型也能稳定重复执行。

注意事项

  • 它的思路是「一次性用 AI 写,长期无 AI 跑」。
  • 界面识别对分辨率敏感,换设备要复测。
  • 自动化仅用于你有权操作的应用。

核心亮点

  • 把截图、视觉识别与键鼠控制封装成 Python 可调用模块,减少重复造轮子
  • 面向游戏自动化场景,支持基于屏幕内容动态决策而非固定坐标点击
  • 纯 Python 技术栈,便于与现有脚本、AI 模型和自动化流程集成

不足之处

  • 项目处于早期,文档与示例可能不够完整,上手需要阅读源码
  • 视觉识别对分辨率、缩放和画面变化较敏感,稳定性依赖调参

适用场景

  • 游戏日常任务自动挂机与重复操作
  • 桌面软件界面自动化测试与流程回放
  • 需要根据屏幕画面变化做条件判断的 RPA 场景

替代项目

Airtest、PyAutoGUI

上一篇:MaaNTE

下一篇:guibot

同类项目推荐

mengwei-local-leads-workbench 开源

搭建本地获客自动化工作台,研究AI内容与发布流程

Half-developed local leads workbench prototype for AI content, video automation, key···

★ 188 2026-08-09
webcmd 开源

让AI代理浏览器操作省90%token,越用越省钱

Self-learning agent browser

★ 2762 2026-08-09
Backlog.md 开源

用 Git 里的 Markdown 任务文件,让人和 AI 一起管项目

Backlog.md - A tool for managing project collaboration between humans and AI Agents ···

★ 7273 2026-09-22
agent-standup 开源

把多个 AI 代理的工作状态变成实时动画会议

Your Claude Code, Codex and Mistral Vibe sessions as a live, animated team call: who···

★ 347 2026-10-24
EasyCLIProxyAPI 开源

图形界面一键配好 AI 代理,省去手写配置文件

A desktop GUI for CLIProxyAPI and a tool for automatically configuring popular AI ag···

★ 3385 2026-09-22
mobilerun 开源

说句话就让手机自己点,跨 App 自动跑流程

Automate your mobile devices with natural language commands - an LLM agnostic mobile···

★ 9928 2026-09-16
texera 开源

拖拽构建数据管道,AI 智能体协同分析

Human-AI Collaborative Data Science Using Visual Workflows

★ 329 2026-08-09
YES-BD2 开源

自动跑图做日常,把重复点击交给脚本

Brown Dust 2 (BD2) PC automation tool: daily tasks, map runs, trading, Fiend Hunt. 棕···

★ 150 2026-10-24
n8n-helm-chart 开源

一条命令在 Kubernetes 上部署 n8n,轻松搞定自动化工作流

A Kubernetes Helm chart for n8n - a workflow automation tool. Easily automate tasks ···

★ 709 2026-08-22