ok-ww 如何跑通：鸣潮自动战斗到一键日常的实操指南
【免费下载链接】ok-wuthering-waves鸣潮 后台自动战斗 自动刷声骸 一键日常 Automation for Wuthering Waves项目地址: https://gitcode.com/GitHub_Trending/ok/ok-wuthering-waves
按下任务列表里的 Start 后，鸣潮窗口沉到后台，角色独自进了副本；几分钟后副本打完，地上的声骸已被自动吸收。这是 ok-ww 的日常——一个基于图像识别的鸣潮自动化工具，替你接手自动战斗、刷声骸、一键日常这类重复操作。下面从首次启动讲起，把它跑通。
🧭 项目定位与适用边界
ok-ww 是基于 ok-script 框架开发的鸣潮自动化程序，核心是三条识别路线：模板匹配找 UI 按钮、YOLO 模型检测声骸、OCR 读取界面文字。操作则通过 Windows 接口向游戏窗口投递键鼠消息（PostMessage）完成——不读内存、不修改游戏文件。
- 适合：Windows 10/11 64 位；游戏分辨率为 16:9，1280x720 到 4K 均可，部分功能兼容 21:9 超宽屏；想自动化日常、刷声骸等重复流程的玩家。
- 不适合：Mac 或 Linux 用户；以及任何想修改游戏数据、在竞技内容中获取优势的场景——项目不提供这类能力。
⚙️ 核心能力速览：三组场景
日常自动化
- 一键日常（DailyTask）：登录、领月卡、刷声骸、领每日奖励一整条链路，可选挂上湮灭、伪造、模拟挑战
- 自动登录、跳过对话、大世界自动采花（AutoPickTask）、快速传送等触发式任务按需生效
- 多账号日常（MultiAccountDailyTask）支持多号轮流跑
战斗自动化
- 自动战斗（AutoCombatTask）是后台触发任务，以 0.1 秒级别的间隔检测战斗状态，进入战斗即接管
- 全角色自动识别，不需要你手动配置技能序列；战斗前后可自动切换治疗角色
- 支持后台模式：游戏窗口最小化或被遮挡也能运行，并可自动静音游戏
声骸批量管理
- 4C 声骸刷取（FarmEchoTask）：副本或世界 Boss，可自动传送、循环刷取
- 五合一（MergeEchoTask）、强化（EnhanceEchoTask）、替换（ChangeEchoTask）等整理任务
- 拾取过程自动走向声骸并按 F 吸收，界面会统计累计声骸数与每小时声骸数
🚀 从零到跑通：五个步骤
第一步：环境确认。Windows 10/11 64 位，游戏分辨率选 16:9（1280x720 到 4K）。在游戏设置里关闭自动奔跑；显示层面保持干净：不开显卡级滤镜（NVIDIA 动态亮丽、AMD 锐化），游戏亮度用默认值，关掉 MSI Afterburner、Fraps 这类叠加层。这里有个细节容易忽略：识别依赖屏幕原始像素，任何改变画面像素的东西都会造成误判。
第二步：获取程序。从官方发布页下载安装包ok-ww-win32-China-setup.exe（注意是 setup 安装包，不是源码压缩包）；或者走源码：
# 克隆仓库 git clone https://gitcode.com/GitHub_Trending/ok/ok-wuthering-waves装到纯英文路径，并把安装目录加入杀毒软件（含 Windows Defender）白名单，这是后续大部分"文件消失"类问题的源头。
第三步：启动与基础配置。启动 ok-ww 前，把游戏切到"已编队且身处大世界"的状态（画面右下角能看到队伍图标）。然后在设置页核对 Game Hotkey 一栏：声骸键默认q、解放技r、共鸣技e、闪避lshift、工具t——你在游戏内改过按键的，必须在这里同步。再开启"启动后关闭启动器"，避免启动器进程导致游戏断线。
第四步：触发第一个任务。新手建议先启用 Auto Combat 触发任务，进任意副本打起来它就会接管；想直接体验完整链路，就点 Daily Task 跑一次一键日常。
第五步：验证结果。运行日志写在logs目录，任务失败时会自动往screenshots目录存现场截图。第一次跑完翻一遍这两处，比看教程更有效。
🔍 功能深潜：三个典型场景
当你在副本里：自动战斗接管整场
触发方式：任务列表里打开 Auto Combat 开关即可。它是后台触发任务，每 0.1 秒检查一次是否处于战斗状态，进入战斗即开始接管，战斗结束自动退回大世界。
执行中的观察点：
- 首次运行会预加载全部角色模板，之后持续识别当前出手的角色
- 默认开启自动索敌；关掉它则只在你用中键手动锁定后接管
- 每个角色在 src/char/ 下有独立类，技能循环、能量判断各归各管
- 死亡会被检测并告警；战斗前后可以自动切到治疗角色，降低团灭概率
产出：战斗自动打完、界面自动收拢。大世界模式下可以选择不放解放技来压缩单场耗时。
可调参数：
Auto Target：关闭后仅在手动锁定时战斗Use Liberation：大世界省解放技，省时间Check Levitator：释放浮空类技能后校验角色是否真的悬浮Switch to Healer before and after Combat：战斗前后切治疗
当你想刷声骸：从副本刷取到一条龙
两个入口。单独跑"Farm Echo in Dungeon"任务：先自己进副本或传送到 Boss，再点 Start。或者把它并入 Daily Task：程序自动登录、领月卡、刷声骸、领奖励，还能串联湮灭、伪造挑战或模拟挑战。
Farm Echo 任务内部的关键项：
- Boss 与等级（50 到 90），等级选"能掉声骸的最低档"
Teleport to Boss支持经 F2 菜单传送到周本、Boss 挑战、特殊梦魇，并可选具体位置序号Echo Pickup Method三选一：Yolo（YOLO 模型检测声骸坐标后走过去）、Run in Circle（绕圈）、Walk（步行）
观察点：Boss 死亡后，程序用 YOLO 找出地面声骸、走近、按 F 吸收；界面上的 Echo Count 与 Echo per Hour 会随刷取持续累加。角色阵亡时会自动传送回血再传回 Boss，循环不断。
可调参数：Repeat Farm Count（循环次数）、Combat Wait Time（每场战斗前等待秒数）、Boss Level。
当你的声骸袋满了：强化、筛选与吸收
声骸攒多了就需要整理，ok-ww 把整理也任务化了：
- EnhanceEchoTask：自动强化声骸，处理材料选择与结果确认
- MergeEchoTask：五合一合并；一键日常里还可以勾"废弃声骸超过 1000 个时自动合并"
- ChangeEchoTask：声骸替换
- 游戏内筛选界面可按主属性（暴击率、暴击伤害、攻击百分比等）逐项勾选
这些任务都可以挂到 Daily Task 的 Additional Tasks 里，日常跑完后自动接着执行。
🛠️ 进阶调优：三个维度
1. 命令行：定时跑完即退
# 启动后自动执行任务列表中的第 1 个任务（一键日常），完成后自动退出 ok-ww.exe -t 1 -e-t/--task指定启动后执行第 N 个任务，-e/--exit让程序在任务结束后退出。适合想每天固定时间跑一条龙、跑完不留进程的场景。
2. 游戏按键与识别同步
游戏内改过键位的，必须在设置里同步。默认按键定义在 config.py 的 key 配置段中：
# config.py 中游戏热键的默认值 'Echo Key': 'q', # 声骸技能 'Liberation Key': 'r', # 解放技 'Resonance Key': 'e', # 共鸣技 'Dodge Key': 'lshift', # 闪避 'Tool Key': 't', # 工具/交互 'Jump Key': 'space', # 跳跃 'Bag Key': 'b', # 背包识别层面，文字识别走 ONNX OCR，默认开启 OpenVINO 与 NPU 加速；模板匹配默认阈值 0.8。若个别界面元素识别不到，先按排障一节检查显示设置，再考虑动代码。
3. 源码运行与二次开发入口
# 推荐 Python 3.12（要求 3.9 及以上，其他版本未经完整测试） pip install -r requirements.txt --upgrade python main.py # Release 版本 python main_debug.py # Debug 版本任务清单同样在 config.py：onetime_tasks是一次性任务列表，trigger_tasks是后台触发任务列表，增删任务从这里入手。想改某个角色的技能循环，看 src/char/ 下对应角色的类；图形界面里的角色代码页支持导入/导出整套队伍配置。战斗状态判定逻辑集中在 src/scene/WWScene.py。
🩺 排障：现象、原因与处理
| 现象 | 可能原因 | 处理 |
|---|---|---|
| 自动战斗反复锁敌但不攻击 | 队伍中有角色未装备主声骸 | 给所有角色装备主声骸（右下角可见声骸技能图标） |
| UI 识别频繁失败 | 显卡滤镜、叠加层或非默认亮度改了画面像素 | 关 NVIDIA 动态亮丽、AMD 锐化等显卡滤镜，关叠加层，恢复默认亮度 |
| 操作卡顿、战斗节奏乱 | 帧率不稳 | 降低游戏画质，让游戏稳定在 60 FPS |
| 游戏中途断线 | 游戏启动器进程仍在运行 | ok-ww 设置里开启"启动后关闭启动器" |
| OpenVINO 报 0x000005 | Intel NPU 驱动过旧 | 更新 Intel 最新 NPU 驱动 |
| 文件被删、程序无法启动 | 杀毒软件误报 | 安装目录加入信任区/白名单 |
性能上的三条建议：长时间挂机前清掉其他吃 GPU 的后台程序；后台模式下开启自动静音，适合固定环境跑日常；版本保持最新，游戏大版本更新后 UI 会变化，识别模板也需要跟随更新。
⚖️ 使用边界与建议
先说清技术边界：ok-ww 只向游戏窗口发送键鼠消息，不触碰内存、不修改游戏文件与数据；项目开源免费，定位是个人学习与交流，不用于商业用途。同时要如实面对风险：库洛《鸣潮》公平运营声明明确打击宏脚本、自动挂机等第三方工具，查证后可能采取扣除收益、封号等处理，使用与否的风险由你自行承担。
几条务实的建议：
- 用测试号先把所有设置项跑通一遍，再上主号
- 版本跟最新版走，游戏更新后旧版识别率下降很快
- 不要 24 小时不间断运行，保持合理节奏
- 想搞懂原理的话，这份源码本身就是一个图像识别加 UI 自动化的完整样例
下一步
先跑通副本里的自动战斗，再试一次一键日常，声骸袋满了再挂上整理任务。某个角色的技能循环不合你的配队时，去 src/char/ 找对应角色的类，或用角色代码功能导入别人的配置。想再往下走，社区的开发者群里有人能接得住你的问题。祝刷得开心。
【免费下载链接】ok-wuthering-waves鸣潮 后台自动战斗 自动刷声骸 一键日常 Automation for Wuthering Waves项目地址: https://gitcode.com/GitHub_Trending/ok/ok-wuthering-waves
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
