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

2026-02-06 05:41:29作者：盛欣凯Ernestine

项目概述

ok-ww 是一款基于图像识别技术的鸣潮游戏自动化工具，支持后台自动战斗、声骸自动合成、肉鸽副本一键通关等核心功能。通过模拟用户键鼠操作实现无侵入式游戏交互，兼容主流16:9分辨率，可在后台窗口化运行。

核心功能矩阵

战斗自动化：全角色技能循环识别与释放
资源管理：声骸自动筛选、上锁及合成
日常任务：一键完成每日委托、周本挑战
副本攻略：支持无妄者、五合一等多场景自动通关

技术架构说明

技术模块	实现方案	应用场景
图像识别	OnnxRuntime + YOLOv8	界面元素定位、技能CD检测
输入模拟	win32api	键鼠操作模拟、后台窗口控制
跨平台兼容	Python 3.12	保证Windows系统下稳定运行
配置管理	JSON格式存储	用户自定义键位、任务参数

环境准备

前置要求

操作系统：Windows 10/11（64位）
硬件配置：Intel i5/Ryzen 5同级处理器，8GB以上内存
软件依赖：.NET Framework 4.8 runtime，VC++ 2022 redistributable

环境校验清单

检查项	标准值	验证方法
Python版本	3.12.x	`python --version`
游戏分辨率	1920×1080（16:9）	设置→显示→分辨率
权限配置	管理员权限	右键exe→属性→兼容性
显卡驱动	最新版	Device Manager→显示适配器
游戏设置	亮度50%，关闭HDR	鸣潮设置→画面→显示

部署流程

基础部署

# 克隆代码仓库
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（显示识别框，输出日志信息）

高级配置

# 任务参数示例：自动执行第3个任务后退出
python main.py -t 3 -e

# 窗口化运行：指定游戏窗口句柄
python main.py -hwnd 0x123456

命令参数说明

参数	类型	描述
-t, --task	整数	指定启动后执行的任务编号
-e, --exit	标志	任务完成后自动退出程序
-hwnd	十六进制	绑定指定游戏窗口句柄
-l, --log	字符串	设置日志输出路径
-c, --config	字符串	加载自定义配置文件

进阶设置

分辨率适配

在config.py中修改SCREEN_RESOLUTION参数
支持1280×720至3840×2160范围内所有16:9分辨率
宽屏显示器需在游戏设置中锁定纵横比

键位自定义

启动程序后进入设置界面
在"输入设置"标签页配置技能按键
支持Q/E/R/空格等基础按键映射
配置完成后需重启程序生效

定时任务配置

创建Windows任务计划程序，设置：

触发器：每日18:00执行
操作：启动程序 ok-ww.exe -t 5 -e
条件：仅当计算机空闲10分钟后

常见问题

启动故障排除

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

识别异常处理

技能释放延迟：降低游戏画质至60FPS稳定运行
声骸识别错误：在设置中开启"高精度识别"模式
场景切换失败：确保游戏内已关闭"动态模糊"效果

性能优化建议

后台运行时设置程序优先级为"低"
禁用不必要的视觉效果（设置→画面→特效质量：低）
大内存环境（16GB+）可在config.py中调大DETECT_BUFFER_SIZE

附录

文件结构说明

ok-wuthering-waves/
├── assets/        # 图像资源与模型文件
├── src/           # 核心功能模块
│   ├── char/      # 角色技能逻辑
│   └── task/      # 任务流程控制
├── config.py      # 全局配置参数
└── main.py        # 程序入口