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://img.shields.io/github/downloads/ok-oldking/ok-wuthering-waves/total) Discord (https://img.shields.io/discord/296598043787132928?color=5865f2&label=%20Discord)

English Readme | 中文说明

演示与教程: YouTube (https://img.shields.io/badge/YouTube-%23FF0000.svg?style=for-the-badge&logo=YouTube&logoColor=white)

⚠️ 免责声明

本软件为外部辅助工具，旨在自动化《鸣潮》的部分游戏流程。它完全通过模拟常规用户界面与游戏交互，遵循相关法律法规。本项目旨在简化用户的重复性操作，不会破坏游戏平衡或提供不公平优势，也绝不会修改任何游戏文件或数据。

本软件开源、免费，仅供个人学习与交流使用，请勿用于任何商业或营利性目的。开发者团队拥有本项目的最终解释权。因使用本软件而产生的任何问题，均与本项目及开发者无关。

请注意，根据库洛官方的《鸣潮》公平运营声明：

严禁利用任何第三方工具破坏游戏体验。 我们将严厉打击使用外挂、加速器、作弊软件、宏脚本等违规工具的行为，这些行为包括但不限于自动挂机、技能加速、无敌模式、瞬移、修改游戏数据等操作。 一经查证，我们将视违规情况和次数，采取包括但不限于扣除违规收益、冻结或永久封禁游戏账号等措施。

使用本软件即表示您已阅读、理解并同意以上声明，并自愿承担一切潜在风险。

🚀 快速开始

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): 国内网盘，免费，但需要注册并使用其客户端下载。

✨ 主要功能

• 高分辨率支持: 流畅运行于 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. 寻求帮助：如果以上步骤都无法解决您的问题，请通过社区渠道提交详细的错误报告。