op-plugins 0.4.8.3

Python bindings for OP Windows automation plugin

OP - Windows 自动化插件

English

OP (Operator & Open) 是一个面向 Windows 的开源自动化插件，提供窗口操作、后台键鼠、截图、找色找图、OCR、OpenCV 图像处理、内存读写等能力。项目以 C++ 实现，提供 COM 接口，支持 x86/x64。

OCR 同时支持两条路径：固定字体场景可以使用本地点阵字库，兼容 OP 二进制字库和大漠文本点阵字库格式；不使用点阵字库时，可以接入独立 OCR HTTP 服务 op_ocr_engine，支持 Tesseract 和 PaddleOCR 等通用/模型 OCR 后端。

YOLO 检测采用同类外部 HTTP 服务模式：OP 负责截图、读图和 HTTP 调用，YOLO11/YOLOv11 模型推理由独立服务完成。接口与返回格式见 YOLO HTTP 检测。 仓库内提供了最小服务样例：tools/op_yolo_engine.py。

文档

• GitHub Wiki：安装、接口说明、OpenCV、OCR、免注册、多语言示例
• 插件下载
• 测试工具 OPTestTool

主要能力

• 窗口查询、窗口状态、窗口布局和后台绑定
• 前台/后台鼠标键盘模拟
• GDI、DXGI、WGC、DirectX、OpenGL 等截图方式
• 找色、找图、图片输入源和内存图片输入
• 点阵字库 OCR，兼容 OP 字库和大漠文本点阵字库格式
• 独立 OCR HTTP 服务接入，支持 Tesseract、PaddleOCR 等通用/模型 OCR 后端
• 独立 YOLO HTTP 检测服务接入，支持 YOLO11/YOLOv11 等外部检测后端
• OpenCV 模板匹配、特征匹配和文件预处理
• 进程内存读写、汇编调用和基础算法工具

目录概览

op/
├─ libop/          核心插件源码
│  ├─ com/         COM 注册、IDL、类型库和 IOpInterface 对外接口实现
│  ├─ background/  窗口绑定、截图输入源、后台显示/鼠标/键盘调度
│  ├─ imageProc/   找色、找图、点阵 OCR、OCR HTTP 服务封装
│  ├─ opencv/      OpenCV 模板匹配、特征匹配、预处理和桥接层
│  ├─ winapi/      窗口、进程、内存、注入等 Windows API 封装
│  ├─ core/        公共工具、路径、环境、管道、窗口布局等基础能力
│  ├─ include/     图像、颜色、字库、共享内存等内部基础结构
│  ├─ algorithm/   A* 等通用算法
│  ├─ libop.cpp    C++ 主接口实现，COM/SWIG 最终调用到这里
│  └─ libop.h      C++ 主接口声明
├─ include/        对外头文件和导出接口
├─ tools/          免注册加载工具源码，生成 tools.dll
├─ swig/           Python SWIG 绑定文件
├─ python/         pip wheel 包源码（python/pyop）
├─ examples/       本地测试示例和测试资源
├─ tests/          C++ 单元测试和集成测试
├─ doc/op.wiki/    GitHub Wiki 文档源码
├─ 3rd_party/      第三方源码或本地依赖
├─ ci/             CI 辅助脚本
├─ bin/            预置或构建后的运行文件
├─ out/            历史或可选输出目录
├─ build.py        推荐的一键构建入口
└─ CMakeLists.txt  CMake 工程入口

快速开始

下载 Release 后，根据宿主程序位数注册对应 DLL：

# 32 位宿主程序
regsvr32 op_x86.dll

# 64 位宿主程序
regsvr32 op_x64.dll

Python 最小示例（COM，与 Python 版本无关）：

from win32com.client import Dispatch

op = Dispatch("op.opsoft")
print("op version:", op.Ver())

pip 安装（推荐 Python 用户使用）

op-plugins 通过 PyPI 发布多版本 wheel（Python 3.9–3.12，win32/win_amd64），自动匹配本地 Python 版本，无需手动挑选 _pyop.pyd：

# 从 PyPI 安装（推荐）
pip install op-plugins

# 或从 GitHub Release 安装指定 wheel（将 <tag> 和 <wheel> 替换为实际文件名）
pip install https://github.com/WallBreaker2/op/releases/download/<tag>/<wheel>.whl

# 示例：64 位 Python 3.12
pip install https://github.com/WallBreaker2/op/releases/download/v1.0.0/op_plugins-1.0.0-cp312-cp312-win_amd64.whl

安装后使用 SWIG 绑定：

from pyop import libop

op = libop()
print("op version:", op.Ver())

注意：

• 64 位 Python 请安装 win_amd64 wheel；32 位 Python / 32 位游戏场景请安装 win32 wheel
• wheel 已内置 op_x64.dll / op_x86.dll 和 tools.dll，无需单独下载 zip
• 若仍使用 zip 分发，须确保 _pyop.pyd 与本地 Python 版本一致（如 cp312 对应 Python 3.12）

验证安装：

python -c "from pyop import libop; print(libop().Ver())"

免注册调用请参考 Wiki：

• 安装与免注册
• Python 免注册示例
• C# / Lua / Golang / Rust / Node.js / Java 示例

源码编译

环境要求：

• Visual Studio 2022 或更新版本
• CMake 3.24 或更新版本
• Windows SDK 10.0.19041.0 或更新版本

推荐使用根目录 build.py：

# 默认 Release + x64
python build.py

# 构建 x86
python build.py -a x86

# Debug
python build.py -t Debug

# 指定环境
python build.py -t Release -a x64 -g vs2022

Release 产物会安装到 bin/x86 或 bin/x64。

本地构建 pip wheel（推荐用脚本自动 bootstrap 依赖并设置 CMake 参数）：

# 先确保已安装构建依赖
pip install scikit-build-core setuptools-scm

# 一键构建（默认 x64，自动检测 VS 版本）
./scripts/build_wheel.ps1

# 或手动：先 bootstrap，再 pip wheel
python build.py -t Release -a x64
pip wheel . --no-deps -w wheelhouse

# 本地模拟 CI 的单版本双架构 wheel 构建
pip install cibuildwheel==2.23.4
$env:CIBW_BUILD="cp312-*"
$env:CIBW_ARCHS_WINDOWS="AMD64"
$env:CIBW_BEFORE_BUILD_WINDOWS="powershell ./scripts/cibw_before_build.ps1"
$env:CIBW_ENVIRONMENT_WINDOWS='CMAKE_GENERATOR="Visual Studio 17 2022" CMAKE_ARGS="-A x64 -DOP_PYTHON_WHEEL=ON -DOP_BUILD_TESTS=OFF -Dbuild_swig_py=ON"'
python -m cibuildwheel --platform windows

$env:CIBW_ARCHS_WINDOWS="x86"
$env:CIBW_ENVIRONMENT_WINDOWS='CMAKE_GENERATOR="Visual Studio 17 2022" CMAKE_ARGS="-A Win32 -DOP_PYTHON_WHEEL=ON -DOP_BUILD_TESTS=OFF -Dbuild_swig_py=ON"'
python -m cibuildwheel --platform windows

若 pip wheel 报 BlackBone 未找到，说明尚未运行 python build.py 或 ./scripts/build_wheel.ps1 完成依赖引导。

社区

• GitHub Issues
• GitHub Discussions
• QQ 群：743710486、27872381

许可证

MIT License

参考项目

• TSPLUG
• Kiero