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

1. 项目概览

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

1.1 核心功能矩阵

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

1.2 技术架构说明

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

2. 环境准备

2.1 前置要求

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

2.2 环境校验清单

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

3. 部署流程

3.1 基础部署

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

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

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

3.1.1 运行模式选择

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

3.2 高级配置

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

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

命令参数说明

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

4. 进阶设置

4.1 分辨率适配

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

4.2 键位自定义

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

4.3 定时任务配置

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

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

5. 常见问题

5.1 启动故障排除

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

5.2 识别异常处理

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

5.3 性能优化建议

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

6. 附录

6.1 文件结构说明

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

6.2 安全使用规范

• 避免同时运行多个自动化工具
• 每账号每日自动化时长建议不超过2小时
• 定期更新程序至最新版本以获取兼容性修复

图：自动化战斗识别效果展示（红色框为技能CD识别区域）

图：技能CD检测界面展示

图：自动地图导航功能演示