ok-wuthering-waves自动化工具全流程部署指南

准备阶段：系统环境与工具适配

系统适配检测清单

检测项	最低要求	推荐配置	验证方法
操作系统	Windows 10 64位	Windows 11 64位	运行winver命令查看系统版本
处理器	Intel i3或同等AMD	Intel i5或同等AMD	任务管理器性能标签查看CPU信息
内存	8GB RAM	16GB RAM	wmic memorychip get capacity命令检测
显卡	集成显卡	NVIDIA GTX 1050Ti及以上	设备管理器显示适配器查看型号
游戏分辨率	1600x900	1920x1080	游戏设置界面确认显示分辨率
游戏模式	窗口化/无边框	无边框窗口	Alt+Enter切换后验证窗口状态

模块交互流程图

graph TD
    subgraph 核心模块
        A[配置管理系统] -->|加载参数| B[图像识别引擎]
        A -->|传递策略| C[自动化执行模块]
        B -->|场景分析| C
        C -->|生成指令| D[键鼠模拟驱动]
        D -->|操作反馈| B
    end
    subgraph 外部接口
        E[游戏客户端] -->|画面输出| B
        D -->|输入控制| E
        A -->|配置文件| F[用户设置界面]
    end

实施阶段：工具部署与基础配置

获取与安装工具

新手模式（普通用户）

1. 下载最新版ok-ww.exe可执行程序
2. 创建纯英文路径文件夹（如D:\Tools\ok-ww）
3. 将可执行文件复制到该目录并双击启动

进阶模式（开发人员）

git clone https://gitcode.com/GitHub_Trending/ok/ok-wuthering-waves
cd ok-wuthering-waves
pip install -r requirements.txt

基础功能配置

1. 启动工具后进入设置界面
2. 配置游戏窗口捕获参数：
   • 点击"选择窗口"按钮
   • 从列表中选择《鸣潮》游戏进程
   • 调整捕获区域至完整游戏画面
3. 启用核心功能开关：

图：自动战斗基础配置界面 - 显示核心功能开关与重置按钮，包括自动战斗、对话跳过和自动拾取功能

4. 保存配置并重启工具使设置生效

功能实施：场景化解决方案

自动战斗系统配置

场景需求：深渊副本高效通关

解决方案：

1. 进入"战斗设置"标签页
2. 配置技能释放优先级：
   • 拖动技能图标调整释放顺序
   • 设置大招触发阈值（如能量≥80%）
   • 启用"目标锁定"功能
3. 选择战斗结束条件（如敌人全灭/时间限制）

图：战斗参数配置界面 - 显示副本 farming 与世界BOSS挑战的启动控制区域

声骸自动化管理

场景需求：声骸筛选与合成优化

解决方案：

1. 进入"声骸设置"界面
2. 配置筛选规则：

   {
     "min_rarity": 4,
     "keep_primary_stats": ["攻击", "暴击率", "暴击伤害"],
     "auto_absorb": true,
     "max_keep_count": 200
   }
   

3. 启用自动合成功能并设置合成策略

图：声骸吸收界面 - 显示战斗胜利后自动吸收声骸的交互区域，包含"吸收"按钮与声骸识别框

肉鸽模式自动化

场景需求：肉鸽模式最优路线规划

解决方案：

1. 启用"肉鸽模式"功能
2. 选择路线策略：
   • 战斗优先：优先选择战斗节点
   • 奖励优先：优先选择宝箱与事件
   • 平衡模式：自动平衡战斗与奖励
3. 设置难度适应策略（如生命值低于30%时避开精英怪）

图：肉鸽模式地图导航界面 - 显示当前区域探索度、目标路线与关键节点标记

优化阶段：性能调优与问题解决

性能优化方案对照表

常见问题	症状描述	优化方案	预期效果
帧率下降	游戏画面卡顿，操作延迟	1. 降低识别频率至15FPS 2. 关闭垂直同步 3. 设置工具优先级为"低"	帧率提升15-20FPS，操作响应改善
识别错误	技能释放时机不准确	1. 调整游戏分辨率至1920x1080 2. 清理游戏缓存 3. 更新ONNX模型	识别准确率提升至95%以上
内存占用过高	工具运行2小时后卡顿	1. 降低缓存大小至256MB 2. 启用内存自动释放 3. 关闭后台不必要程序	内存占用减少40-50%

高级参数配置

对于高级用户，可修改config.py文件进行深度优化：

# 图像识别优化
RECOGNITION_THRESHOLD = 0.75  # 识别置信度阈值
SCREENSHOT_QUALITY = 0.8      # 截图质量压缩比

# 性能控制参数
MAX_THREADS = 2               # 最大工作线程数
LOOP_INTERVAL = 0.03          # 主循环间隔(秒)

验证阶段：功能测试与部署确认

功能验证流程

1. 基础功能测试：

   • 启动游戏并进入测试场景
   • 开启自动战斗功能，观察技能释放逻辑
   • 验证对话自动跳过功能是否正常

2. 压力测试：

   • 连续运行自动战斗1小时
   • 监控CPU/内存占用（推荐使用任务管理器）
   • 检查是否出现内存泄漏或性能下降

3. 集成测试：

   • 依次测试声骸刷取→合成→战斗流程
   • 验证各模块间数据传递是否正常
   • 检查日志文件是否有错误记录

部署确认清单

• [ ] 系统环境符合推荐配置
• [ ] 游戏设置已按要求优化（分辨率、窗口模式等）
• [ ] 工具能稳定识别游戏窗口（显示"已连接"状态）
• [ ] 自动战斗模块连续运行30分钟无异常
• [ ] 声骸筛选功能正确识别并保留高价值声骸
• [ ] 性能监控显示CPU占用<30%，内存占用<1GB

附录：实用工具与资源

部署自检工具（命令清单）

# 系统信息检查
systeminfo | findstr /B /C:"OS Name" /C:"OS Version"

# Python环境验证(源码运行时)
python --version && pip list | findstr -i "onnx opencv"

# 依赖检查
pip check

# 日志查看
type logs\app.log | findstr "ERROR"

常见问题速查表

错误现象	可能原因	解决方案
工具启动闪退	Python环境缺失	安装Python 3.8+并配置环境变量
游戏窗口无法识别	游戏以管理员权限运行	关闭游戏后右键工具选择"以管理员身份运行"
声骸识别错误	游戏亮度异常	恢复游戏默认亮度设置
自动战斗不释放技能	技能按钮位置变动	重新校准UI元素位置
工具运行卡顿	后台程序占用资源	关闭杀毒软件和不必要的后台进程