ok-ww 新手安装配置指南：鸣潮自动战斗与一键日常三步跑起来

【免费下载链接】ok-wuthering-waves鸣潮 后台自动战斗 自动刷声骸 一键日常 Automation for Wuthering Waves项目地址: https://gitcode.com/GitHub_Trending/ok/ok-wuthering-waves

每天登录《鸣潮》做委托、刷声骸、锻造，多开还要来回切号，四十分钟的重复点击吃掉大半空闲时间。ok-ww（仓库名 ok-wuthering-waves）是一个基于图像识别的鸣潮自动化程序：自动战斗、刷声骸、一键日常都能自动跑，还支持游戏窗口最小化时在后台运行，开源免费。下面带你从零装好并跑通。

动手前先自检

环境要求不多，动手前确认以下几项即可：

四项都过，开始装。

三步跑起来

第一步：获取代码

git clone https://gitcode.com/GitHub_Trending/ok/ok-wuthering-waves cd ok-wuthering-waves

成功后当前目录出现main.py、config.py、requirements.txt、assets/等文件，说明这一步完成了。

第二步：安装依赖

pip install -r requirements.txt

依赖包含opencv-python、openvino、ok-script等，体积较大需要等一会儿。输出末尾出现Successfully installed且没有ERROR，即安装成功。

第三步：首次运行

python main.py

你应该看到一个标题为 OK-WW 的窗口，主界面按行列出「Auto Combat」「Skip Dialog during Quests」「Farm Echo in Dungeon」等任务，每项带开关或 Start 按钮。GUI 能打开，安装就成功了。

仓库提供三个入口，用途不同：

若仓库里已有.venv虚拟环境，按贡献指南的做法，把上面的python换成.\.venv\Scripts\python.exe再运行。

它能替你做什么

OK-WW 主界面的任务分两类：一次性任务（点 Start，跑完为止）和触发任务（常驻开启，遇到对应场景自动触发）。全部任务源码在 src/task/。

• 自动战斗（AutoCombatTask）：深渊、世界 BOSS 等战斗场景自动操作，全角色自动识别，不用手动配技能序列。开关打开后进入战斗即生效，适合所有用户。
• 一键日常（DailyTask）：一次性任务列表的第一个，把每日委托一次做完。README 说明支持启动参数ok-ww.exe -t 1 -e：启动后自动执行第 1 个任务，完成后退出，适合每天固定时段自动跑日常。
• 刷声骸 / 合并 / 强化（FarmEchoTask / MergeEchoTask / EnhanceEchoTask）：去无念、阙等副本刷声骸并自动合并强化，不用反复手操。

• 锻造（ForgeryTask）、噩梦巢（NightmareNestTask）、终焉矩阵（TacetTask）、模拟世界（SimulationTask）：周常挑战内容，列表里都有。
• 后台触发任务：AutoPickTask 自动拾取、SkipDialogTask 自动跳过对话、AutoLoginTask 自动登录、FastTravelTask 快速传送，属于常驻型，配置一次之后就不用再管。
• 多账号（MultiAccountDailyTask）：多个游戏账号依次跑日常，配置方法见 docs/multi-account-config.md。

调出最佳状态

工具靠图像识别工作，游戏端设置直接决定识别成功率。先做这几项：

• 游戏分辨率设为 16:9（1280x720~2560x1440），帧率稳定 60 FPS；
• 游戏设置里关闭「自动奔跑」；
• 用游戏默认亮度；关闭 RTX Dynamic Vibrance、AMD 锐化等显卡滤镜；
• Windows HDR 可以开，但必须关闭 Auto HDR；
• 关闭 MSI Afterburner、Fraps 等在游戏画面上叠加帧率的工具；
• 队伍中每个角色都要装备主声骸：画面右下角应显示声骸技能图标。任何角色没装，自动战斗会反复锁定敌人却不攻击。

两个常改的配置项都在仓库根目录 config.py：

• Game Hotkey：q/e/r/t/space/lshift 等游戏内键位都列在这里。改过游戏内按键就同步改这里，否则技能按错。
• Character Config：'Iuno C6': False、'Chisa DPS': False这类开关，按你实际拥有的角色开启，自动战斗才会走对应角色的输出逻辑。

出问题了先看这里

• 识别不到画面、找不到窗口→ 游戏分辨率不是 16:9 或低于 1280x720 → 恢复分辨率并重启游戏。
• 文件被删、程序闪退→ 杀毒软件误杀 → 把程序安装目录加入白名单（含 Windows Defender）。
• 自动战斗锁定敌人却不攻击→ 有角色未装主声骸 → 给全队补装主声骸。
• 报0x000005错误（Intel NPU 机型）→ NPU 驱动过旧 → 更新 Intel 最新 NPU 驱动。
• 运行中频繁断线→ 游戏启动器进程仍在运行 → 在 ok-ww 设置中开启「启动后关闭启动器」，或改用源码方式运行。
• 技能按键不对→ 游戏内改过默认键位 → 在Game Hotkey中同步。

用得久，用得稳

• 库洛官方《鸣潮》公平运营声明明确禁止自动挂机类第三方工具，违规可能被扣除收益、冻结甚至封号。ok-ww 通过 Windows 接口模拟常规输入，无内存读取、无游戏文件修改，但使用风险由自己承担，重要账号请谨慎。
• 项目开源免费，仅供个人学习交流，请勿用于商业或营利。
• 你的自定义配置保存在configs/目录，日志在logs/ok-ww.log。大版本更新前备份一次configs/目录即可。
• 新功能和修复看项目社区渠道，群号在 README.md「加入我们」一节。

延伸阅读：

• docs/zh-CN/index.md：中文文档，含免责声明与疑难解答清单
• docs/development/contributing.md：源码运行、测试与贡献流程
• src/task/：各任务源码，想自定义执行顺序从这里入手

【免费下载链接】ok-wuthering-waves鸣潮 后台自动战斗 自动刷声骸 一键日常 Automation for Wuthering Waves项目地址: https://gitcode.com/GitHub_Trending/ok/ok-wuthering-waves