鸣潮游戏自动化工具ok-ww完整使用指南
项目地址: https://gitcode.com/GitHub_Trending/ok/ok-wuthering-waves 项目介绍
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分钟后
常见问题
启动故障排除
程序无法启动时，按以下步骤排查：
- 检查是否报DLL错误，如有则安装VC++运行库
- 确认目录不含中文字符
- 检查杀毒软件是否拦截
识别异常处理
- 技能释放延迟：降低游戏画质至60FPS稳定运行
- 声骸识别错误：在设置中开启"高精度识别"模式
- 场景切换失败：确保游戏内已关闭"动态模糊"效果
性能优化建议
- 后台运行时设置程序优先级为"低"
- 禁用不必要的视觉效果（设置→画面→特效质量：低）
- 大内存环境（16GB+）可在config.py中调大DETECT_BUFFER_SIZE
图：技能冷却时间检测界面
图：自动化战斗识别效果展示
图：声骸自动合成功能界面
安全使用规范
- 避免同时运行多个自动化工具
- 每账号每日自动化时长建议不超过2小时
- 定期更新程序至最新版本以获取兼容性修复
项目结构说明
ok-wuthering-waves/
├── assets/ # 图像资源与模型文件
├── src/ # 核心功能模块
│ ├── char/ # 角色技能逻辑
│ └── task/ # 任务流程控制
├── config.py # 全局配置参数
└── main.py # 程序入口
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
