# ok-py **Repository Path**: itjee/ok-py ## Basic Information - **Project Name**: ok-py - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-05-03 - **Last Updated**: 2026-05-03 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README ## ok-py Python的按键精灵，基于ok-script开发，可用于快速开发并运行各种自动化脚本和项目。 ### 功能演示 **API列表, 脚本录制** ![image_scripting](docs/images/image_scripting.png) **支持多种截图以及交互方式** ![image_screenshot](docs/images/image_capture.png) **标注管理 (Template Matching)** ![image_template](docs/images/image_template.png) ![image_markup](docs/images/image_markup.png) ## ok-script文档和示例代码 * [游戏自动化入门](https://github.com/ok-oldking/ok-script/blob/master/docs/intro_to_automation/README.md) * [快速开始](https://github.com/ok-oldking/ok-script/blob/master/docs/quick_start/README.md) * [进阶使用](https://github.com/ok-oldking/ok-script/blob/master/docs/after_quick_start/README.md) * [API文档](https://github.com/ok-oldking/ok-script/blob/master/docs/api_doc/README.md) * 用户群: 1097603920 * 开发者群: 938132715 #### 文件说明 ``` src/tasks 任务类 src/config.py 项目配置 tests 自动化测试用例 deploy.txt 同步到更新库的文件列表, 如tests文件夹 main.py 入口 main_debug.py debug入口 pyappify.yml 打包exe配置文件 i18n 国际化文件, 可选 assets cv2使用的template, 需要使用coco格式 .github/workflows/build.yml 自动化构建任务 ``` ## 以下为ok-ww示例README.md

ok-ww logo
ok-ww

一个基于图像识别的鸣潮自动化程序，支持后台运行，基于 ok-script 开发。
An image-recognition-based automation tool for Wuthering Waves, with background mode support, developed with ok-script.

通过模拟 Windows 用户接口进行操作，无内存读取、无文件修改

![平台](https://img.shields.io/badge/platform-Windows-blue) [![GitHub release](https://img.shields.io/github/v/release/ok-oldking/ok-wuthering-waves)](https://github.com/ok-oldking/ok-wuthering-waves/releases) [![总下载量](https://img.shields.io/github/downloads/ok-oldking/ok-wuthering-waves/total)](https://github.com/ok-oldking/ok-wuthering-waves/releases) [![Discord](https://img.shields.io/discord/296598043787132928?color=5865f2&label=%20Discord)](https://discord.gg/vVyCatEBgA)
### [English Readme](README_en.md) | 中文说明 **演示与教程:** [![YouTube](https://img.shields.io/badge/YouTube-%23FF0000.svg?style=for-the-badge&logo=YouTube&logoColor=white)](https://youtu.be/h6P1KWjdnB4) --- ## ⚠️ 免责声明 本软件为外部辅助工具，旨在自动化《鸣潮》的部分游戏流程。它完全通过模拟常规用户界面与游戏交互，遵循相关法律法规。本项目旨在简化用户的重复性操作，不会破坏游戏平衡或提供不公平优势，也绝不会修改任何游戏文件或数据。 本软件开源、免费，仅供个人学习与交流使用，请勿用于任何商业或营利性目的。开发者团队拥有本项目的最终解释权。因使用本软件而产生的任何问题，均与本项目及开发者无关。 请注意，根据库洛官方的《鸣潮》公平运营声明： > 严禁利用任何第三方工具破坏游戏体验。 > 我们将严厉打击使用外挂、加速器、作弊软件、宏脚本等违规工具的行为，这些行为包括但不限于自动挂机、技能加速、无敌模式、瞬移、修改游戏数据等操作。 > 一经查证，我们将视违规情况和次数，采取包括但不限于扣除违规收益、冻结或永久封禁游戏账号等措施。 **使用本软件即表示您已阅读、理解并同意以上声明，并自愿承担一切潜在风险。** ## 🚀 快速开始 1. **下载安装包**：从下方的“下载渠道”中选择一个，下载最新的 `ok-ww-win32-China-setup.exe` 安装文件。 2. **安装程序**：双击 `ok-ww-win32-China-setup.exe` 文件，并按照安装向导的提示完成安装。 3. **运行程序**：安装完成后，从桌面快捷方式或开始菜单启动 `ok-ww` 即可。 ## 📥 下载渠道 * **[GitHub](https://github.com/ok-oldking/ok-wuthering-waves/releases)**: 官方发布页，全球访问速度快。（**请下载 `setup.exe` 安装包，而不是 `Source Code` 源码压缩包**） * **[Mirror酱](https://mirrorchyan.com/zh/projects?rid=okww&source=ok-ww-readme)**: 国内镜像，下载可能需要购买其平台的 CD-KEY。 * **[夸克网盘](https://pan.quark.cn/s/a1052cec4d13)**: 国内网盘，免费，但需要注册并使用其客户端下载。 ## ✨ 主要功能 QQ_1762960844719 * **高分辨率支持**: 流畅运行于 4K 及以下所有 16:9 分辨率（最低 1600x900）。部分功能兼容 21:9 等超宽屏。 * **后台模式**: 支持游戏窗口最小化或被遮挡时在后台运行，不影响您使用电脑。 * **智能识别**: 全角色自动识别，无需手动配置技能序列，一键启动。 * **自动静音**: 在后台运行时，可自动将游戏静音。 ## 🔧 疑难解答 (Troubleshooting) 如果遇到问题，请在提问前按以下步骤逐一排查： 1. **安装路径**：请确保软件安装在**纯英文路径**下（例如 `D:\Games\ok-ww`），不要安装在 `C:\Program Files` 或包含中文字符的文件夹中。 2. **杀毒软件**：将软件的安装目录添加到您的杀毒软件（包括 Windows Defender）的**信任区或白名单**中，以防文件被误删或拦截。 3. **显示设置**： * 关闭所有显卡滤镜（如 NVIDIA Game Filter）和锐化功能。 * 使用游戏默认的亮度设置。 * 关闭任何在游戏画面上显示信息的叠加层（如 MSI Afterburner、Fraps 等显示的帧率）。 4. **自定义按键**：如果您修改了游戏内的默认按键，请务必在 `ok-ww` 的设置中进行同步配置。仅支持设置中列出的按键。 5. **软件版本**：检查并确保您使用的是最新版本的 `ok-ww`。 6. **游戏性能**：请确保游戏能稳定在 **60 FPS** 运行。如果帧率不稳定，请尝试降低游戏画质或分辨率。 7. **游戏断线**：如频繁遇到与服务器断开连接的问题，可以尝试先手动打开游戏运行5分钟后再启动本工具，或在断线后直接重新登录，不要退出游戏。 8. **寻求帮助**：如果以上步骤都无法解决您的问题，请通过社区渠道提交详细的错误报告。 9. **关闭自动奔跑**：游戏设置里关闭自动奔跑。 --- ## 💻 开发者专区 ### 从源码运行 (Python) 本项目仅支持 Python 3.12 版本, 必须以管理员权限启动CMD, PyCharm, VSCode。 ```bash # 安装或更新依赖 pip install -r requirements.txt --upgrade # 运行 Release 版本 python main.py # 运行 Debug 版本 python main_debug.py ``` ## 💬 加入我们 * **QQ 交流群**: `1097603920` (入群答案: `老王同学OK`) * **QQ 频道**: [点击加入](https://pd.qq.com/s/djmm6l44y) (群满或获取最新资讯) * **开发者群**: `926858895` ( **注意**: 此群仅面向有开发能力、希望参与贡献的开发者，入群前请确保您已能够从源码成功运行项目。) 本项目基于 [ok-script](https://github.com/ok-oldking/ok-script) 框架开发，核心代码仅约 3000 行 (Python)，简单易维护。欢迎有兴趣的开发者使用 [ok-script](https://github.com/ok-oldking/ok-script) 开发您自己的自动化项目。 ## 🔗 使用ok-script的项目： * 鸣潮 [https://github.com/ok-oldking/ok-wuthering-wave](https://github.com/ok-oldking/ok-wuthering-waves) * 明日方舟:终末地 [https://github.com/ok-oldking/ok-ef](https://github.com/ok-oldking/ok-end-field) * 原神(停止维护, 但是后台过剧情可用) [https://github.com/ok-oldking/ok-genshin-impact](https://github.com/ok-oldking/ok-genshin-impact) * 少前2 [https://github.com/ok-oldking/ok-gf2](https://github.com/ok-oldking/ok-gf2) * 星铁 [https://github.com/Shasnow/ok-starrailassistant](https://github.com/Shasnow/ok-starrailassistant) * 星痕共鸣 [https://github.com/Sanheiii/ok-star-resonance](https://github.com/Sanheiii/ok-star-resonance) * 二重螺旋 [https://github.com/BnanZ0/ok-duet-night-abyss](https://github.com/BnanZ0/ok-duet-night-abyss) * 白荆回廊(停止更新) [https://github.com/ok-oldking/ok-baijing](https://github.com/ok-oldking/ok-baijing) ## ❤️ 赞助与致谢 ### 赞助商 (Sponsors) * **EXE 签名**: Free code signing provided by [SignPath.io](https://signpath.io/), certificate by [SignPath Foundation](https://signpath.org/). ### 致谢 * [lazydog28/mc_auto_boss](https://github.com/lazydog28/mc_auto_boss) * [ok-oldking/OnnxOCR](https://github.com/ok-oldking/OnnxOCR) * [zhiyiYo/PyQt-Fluent-Widgets](https://github.com/zhiyiYo/PyQt-Fluent-Widgets) * [Toufool/AutoSplit](https://github.com/Toufool/AutoSplit)