ok-ww 鸣潮自动化工具部署与使用指南

项目概览

ok-ww 是一款基于图像识别技术的鸣潮游戏自动化程序，支持后台自动战斗、声骸自动合成、肉鸽副本一键通关等核心功能。通过模拟Windows用户接口进行操作，无内存读取、无文件修改，完全遵循相关法律法规。

核心功能特性

• 高分辨率支持：流畅运行于4K及以下所有16:9分辨率（最低1600x900），部分功能兼容21:9等超宽屏
• 后台模式：支持游戏窗口最小化或被遮挡时在后台运行，不影响正常使用电脑
• 智能识别：全角色自动识别，无需手动配置技能序列，一键启动即可使用
• 自动静音：在后台运行时，可自动将游戏静音，减少资源占用

环境准备

系统要求

• 操作系统：Windows 10/11（64位）
• Python版本：仅支持Python 3.12（如需从源码运行）
• 游戏分辨率：1920×1080（16:9）或其他支持的16:9分辨率

软件依赖

• .NET Framework 4.8 runtime
• VC++ 2022 redistributable
• 确保安装在纯英文路径下

快速开始

安装方式

1. 直接下载安装包：下载最新的安装文件并按照向导完成安装
2. 从源码运行（开发者选项）：

# 克隆代码仓库
git clone https://gitcode.com/GitHub_Trending/ok/ok-wuthering-waves

# 进入项目目录
cd ok-wuthering-waves

# 安装依赖包
pip install -r requirements.txt --upgrade

运行模式

• 生产环境：python main.py（性能优先，关闭调试输出）
• 开发调试：python main_debug.py（显示识别框，输出详细日志信息）

命令行参数

支持通过命令行参数实现自动化启动：

# 示例：启动后自动执行第一个任务，并在任务完成后退出程序
ok-ww.exe -t 1 -e

参数说明：

• -t 或 --task：启动后自动执行第N个任务
• -e 或 --exit：任务执行完毕后自动退出程序

功能模块详解

角色系统

项目包含完整的角色实现系统，支持以下角色：

主要战斗角色：

• 卡卡罗（Calcharo）、今汐（Jinhsi）、吟霖（Yinlin）
• 忌炎（Jiyan）、长离（Changli）、折枝（Zhezhi）
• 相里要（Xiangliyao）、安可（Encore）、丹瑾（Danjin）

辅助角色：

• 维里奈（Verina）、白芷（Baizhi）、桃祈（Taoqi）
• 鉴心（Jianxin）、渊武（Yuanwu）、秋沅（Qiuyuan）

每个角色都有完整的技能循环识别与释放逻辑，支持自动切换和连招执行。

战斗系统

基于图像识别的智能战斗系统：

• 技能CD检测与自动释放
• 共鸣回路管理
• 解放技能时机判断
• 连招序列执行

资源收集

• 声骸自动识别与收集
• 宝箱探测与开启
• 地图资源自动采集

副本自动化

• 无妄者副本自动通关
• 五合一副本自动合并
• 肉鸽副本智能路径规划

配置说明

按键配置

在config.py中可以自定义游戏热键：

key_config_option = ConfigOption('Game Hotkey Config', {
    'Echo Key': 'q',
    'Liberation Key': 'r', 
    'Resonance Key': 'e',
    'Tool Key': 't',
}, description='In Game Hotkey for Skills')

分辨率适配

支持1280×720至3840×2160范围内所有16:9分辨率，在配置文件中可调整相关参数。

疑难解答

常见问题处理

1. 安装路径问题：确保软件安装在纯英文路径下
2. 杀毒软件拦截：将安装目录添加到杀毒软件白名单
3. 显示设置：关闭显卡滤镜和锐化功能，使用游戏默认亮度
4. 自定义按键：修改游戏内按键后需在软件设置中同步配置
5. 性能优化：确保游戏能稳定在60 FPS运行

错误排查流程

graph TD
    A[程序无法启动] --> B{是否报DLL错误}
    B -->|是| C[安装VC++运行库]
    B -->|否| D{目录是否含中文}
    D -->|是| E[迁移至纯英文路径]
    D -->|否| F[检查杀毒软件拦截]

安全使用规范

• 本软件为免费开源工具，仅供个人学习与交流使用
• 请勿用于任何商业或营利性目的
• 使用前请阅读并理解免责声明，自愿承担潜在风险
• 建议每账号每日自动化时长不超过2小时
• 定期更新程序至最新版本以获取兼容性修复

开发者信息

本项目基于ok-script框架开发，核心代码简洁易维护。欢迎有兴趣的开发者参与贡献或使用ok-script开发自己的自动化项目。

图示：声骸自动识别与收集功能演示

技术支持

如遇到问题，请先按照疑难解答章节进行排查。如问题仍未解决，可通过开发者社区寻求帮助。

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