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

准备阶段：你的设备准备好了吗？

检查系统兼容性

如何判断你的电脑能否流畅运行自动化工具？让我们通过几个简单步骤验证系统环境：

1. 按下 Win + R 输入 dxdiag 打开系统诊断工具
2. 检查"操作系统"项是否为 Windows 10/11 64位版本
3. 查看"处理器"和"内存"信息是否满足基本要求

⚠️ 风险提示：32位系统或Windows 7及以下版本不支持运行此工具，可能导致无法启动或功能异常。

系统环境检查脚本（复制到记事本保存为 .bat 文件运行）：

@echo off
systeminfo | findstr /B /C:"OS Name" /C:"OS Version" /C:"System Type" /C:"Total Physical Memory"
echo.
echo 推荐配置参考：
echo - Windows 11 64位
echo - Intel i5或同等AMD处理器
echo - 16GB内存
echo - NVIDIA GTX 1050Ti及以上显卡
pause

优化游戏设置

自动化工具如同一位精密的外科医生，需要清晰的"手术视野"才能准确操作。请按以下步骤配置游戏：

1. 分辨率设置为 1920x1080（工具针对此分辨率优化）
2. 游戏模式选择 窗口化无边框（确保工具能捕捉完整画面）
3. 关闭所有画面特效和滤镜（减少识别干扰）
4. 亮度调整为默认值50%（保持UI元素清晰可见）

图1：工具正常工作时的游戏战斗界面状态

选择部署方式

根据你的技术背景选择合适的部署路径：

普通玩家路线（推荐）：

• 下载可执行程序 ok-ww.exe
• 安装到纯英文路径（如 D:\Games\ok-ww）
• 直接双击运行

开发者路线：

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

⚠️ 常见误区：将工具安装在包含中文或特殊字符的路径中，会导致图片识别失败或配置文件无法保存。

实施阶段：如何让工具开始工作？

配置游戏识别参数

首次启动工具后，需要完成基础设置以建立与游戏的连接：

1. 启动工具和游戏，确保游戏窗口可见
2. 在工具设置中点击"自动检测游戏窗口"
3. 调整识别区域框覆盖整个游戏画面
4. 点击"测试识别"验证UI元素捕捉效果

预期效果：工具应能正确标出游戏中的技能按钮、角色头像等关键元素，如未成功请检查游戏分辨率设置。

设置核心功能模块

自动战斗配置：

1. 进入"战斗设置"标签页
2. 启用"自动战斗"开关
3. 拖动技能图标到对应技能槽位
4. 设置技能释放优先级（数字越小优先级越高）

# 配置示例（config.py）
AUTO_COMBAT_CONFIG = {
    "enabled": True,
    "skill_priority": [1, 3, 2],  # 技能释放顺序
    "ultimate_threshold": 80,     # 大招能量阈值（%）
    "heal_threshold": 50          # 自动治疗阈值（%）
}

声骸自动管理：

1. 在"声骸设置"中启用"自动吸收"
2. 设置保留规则：
   • 最低稀有度：4星及以上
   • 保留主属性：攻击、暴击率、暴击伤害
   • 自动吸收重复声骸

图2：工具自动识别声骸并执行吸收操作

验证基础功能

完成配置后进行功能测试：

1. 启动游戏并进入战斗区域
2. 点击工具"开始运行"按钮
3. 观察工具是否能正确识别战斗状态
4. 测试技能释放和目标锁定功能

预期效果：工具应能自动选择目标并按设定顺序释放技能，战斗结束后自动拾取掉落物。

优化阶段：让工具更智能高效

性能参数调优

根据你的电脑配置调整以下参数，找到性能与效果的平衡点：

• 识别频率：低配置电脑建议设为15 FPS，高性能电脑可设为30 FPS
• 画面采样率：低配0.5（半分辨率识别），高配1.0（全分辨率）
• 缓存大小：低配256MB，高配1024MB

💡 优化技巧：在资源管理器中设置工具进程优先级为"高"，可提升识别响应速度。

高级配置指南

对于进阶用户，可以通过修改配置文件实现更精细的控制：

# 声骸筛选高级设置（config.py）
ECHO_FILTER = {
    "min_rarity": 4,
    "keep_primary_stats": ["攻击", "暴击率", "暴击伤害"],
    "auto_absorb": True,
    "max_keep_count": 200,
    # 新增：自定义评分规则
    "score_weights": {
        "攻击": 1.0,
        "暴击率": 0.9,
        "暴击伤害": 0.85,
        "生命值": 0.5
    }
}

自动化流程定制

根据你的游戏习惯创建个性化自动化流程：

1. 日常任务流程：每日委托 → 素材收集 → 体力恢复
2. 刷本流程：选择副本 → 战斗 → 声骸筛选 → 重复
3. 肉鸽模式：路线规划 → 战斗策略 → 奖励选择

图3：肉鸽模式下的自动导航路径显示

验证阶段：确保一切正常工作

功能验证清单

完成部署后，请对照以下清单进行全面测试：

• [ ] 游戏窗口识别正常，无闪烁或偏移
• [ ] 自动战斗能正确释放技能和切换目标
• [ ] 声骸筛选功能按设定规则保留/吸收
• [ ] 肉鸽模式能正确识别地图和导航
• [ ] 连续运行30分钟无崩溃或卡顿

常见问题诊断

遇到问题时，可按以下流程排查：

1. 工具无法启动 → 检查Python环境（源码版）或重新下载可执行文件
2. 游戏无法识别 → 确认游戏窗口化无边框模式和分辨率设置
3. 识别错误 → 更新图像识别模型（assets/echo_model/echo.onnx）
4. 性能问题 → 降低识别频率或关闭其他后台程序

配置备份与恢复

定期备份你的配置文件，避免设置丢失：

1. 配置文件路径：ok-wuthering-waves/config.py
2. 备份方法：复制文件并重命名为 config_backup_日期.py
3. 恢复方法：将备份文件重命名为 config.py 并替换原文件

最终验证脚本

运行以下Python脚本检查系统环境和依赖：

# verify_environment.py
import sys
import platform
import importlib.util

def check_environment():
    print("=== 系统环境检查 ===")
    print(f"操作系统: {platform.system()} {platform.release()}")
    print(f"Python版本: {sys.version.split()[0]}")
    
    required_packages = ["cv2", "numpy", "onnxruntime", "pyautogui"]
    print("\n=== 依赖检查 ===")
    for pkg in required_packages:
        if importlib.util.find_spec(pkg):
            print(f"✓ {pkg} 已安装")
        else:
            print(f"✗ {pkg} 未安装")

if __name__ == "__main__":
    check_environment()

通过以上步骤，你已完成ok-wuthering-waves自动化工具的部署与优化。建议先在简单场景中测试各项功能，逐步调整参数以获得最佳体验。定期检查项目更新以获取最新功能与优化。