鸣潮自动战斗脚本从零上手：挂机刷声骸、清日常、后台运行一次讲透

鸣潮自动战斗脚本从零上手：挂机刷声骸、清日常、后台运行一次讲透

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

凌晨两点半，我又一次对着屏幕上的声骸掉落界面发呆。刷了三个小时的 4C 声骸，背包里能看的没几个，手腕倒是先酸了。如果你也有过这种"肝到怀疑人生"的时刻，那今天要聊的这个开源项目，可能会让你松一口气——ok-ww（ok-wuthering-waves）是一款专门为《鸣潮》打造的自动化工具：自动战斗、自动刷声骸、一键日常，全部基于图像识别实现，不读内存、不改游戏文件，靠"看图说话"模拟你的操作。

说白了，它就像在你电脑旁边坐了个眼神极好的"代练"，盯着屏幕替你按键。这篇文章不打算讲什么高深原理，而是站在一个普通玩家的角度，从下载安装到挂机收菜，一步步带你把这套东西跑起来，顺便把那些最容易踩的坑提前给你填平。

一、先弄明白：脚本是"看"着游戏玩的，不是"读"游戏玩的

很多人一听"脚本"就联想到改内存、封号，其实 ok-ww 走的完全是另一条路。

它的工作流程可以压缩成一句话：截屏 → 认图 → 判断 → 按键。程序通过 Windows 接口抓取游戏画面，然后交给目标检测模型去"认"画面里有什么——哪个是敌人、技能冷却还剩多少、血条在什么位置、地图上的传送点在哪里。认完图之后，再根据预设的战斗和任务逻辑决定下一步该点什么、按哪个键。

这套"认图"的核心是一个基于 YOLOv8 的目标检测模型，项目里同时提供了两套推理引擎：ONNX Runtime 和 OpenVINO，分别对应src/OnnxYolo8Detect.py和src/OpenVinoYolo8Detect.py。两个引擎各有侧重，前者兼容性好，后者在带 NPU 的 Intel CPU 上跑得更快，实测推理速度大约在 8~15ms 一帧，属于"眼睛跟得上手"的水平。

至于"接下来该干什么"，则由一套状态判断机制来接管：游戏当前在战斗、在赶路、还是在结算界面，程序会先"确认自己在哪"，再决定下一步动作。场景识别的入口在src/scene/WWScene.py，你可以把它理解成脚本的"方向感"——先分清东南西北，才谈得上走路。

看到这里你大概明白了：它和你自己玩没区别，只是不累、不困、不手抖。那这种"电子代练"到底好不好装？接着往下看。

二、装好它，其实就三步

第一步，下载。注意一定要去官方发布页拿setup.exe安装包，别手滑下了 Source Code 源码压缩包——那个是给想折腾代码的人准备的，普通玩家直接装 exe 就行。

第二步，装完别急着开。先去杀毒软件（包括 Windows Defender）里把安装目录加进信任区或白名单。这一步不是多余，图像识别工具经常会被误报，不加白名单可能出现"文件被悄悄删了、程序打不开"的诡异情况。

第三步，进游戏前把显示设置收拾干净：

• 游戏内滤镜一般可以开，但显卡滤镜不能开（比如 NVIDIA 动态亮丽、AMD 锐化这类）；
• 亮度用游戏默认值；
• 关掉所有在画面上显示信息的叠加层，比如 MSI Afterburner、Fraps 的帧率显示。

这几条看着琐碎，实际全是为了同一个目标：让脚本看到的画面干净、稳定、可辨认。画面被滤镜和叠加层"污染"得越狠，识别翻车的概率就越高。

装好、配好，接下来就是见证奇迹的时刻——第一次把日常任务全部托管出去。

三、第一次跑"一条龙"：日常任务全托管

ok-ww 的任务体系在src/task/目录下，其中DailyTask.py就是传说中的"一条龙"：登录游戏、领月卡、刷体力本、补日常声骸、周常花园，一条链路全部串起来，中间不用你插手。

体力本支持三类选择：Tacet 抑制（无音区）、锻造挑战（角色/武器材料）、模拟挑战（经验/金币），并且能指定打第几个、选什么材料奖励。跑完体力之后，它还会根据你的勾选接着干别的活——比如自动刷噩梦巢穴来补每日声骸任务，或者顺路把周常花园清掉。任务之间还支持"追加任务"配置，你可以把想一起处理的活都挂进去，出门前点一下开始，回来时全部搞定。

如果你是那种追求"一键到底"的人，还有个更省事的方式——命令行参数。在配置好任务列表后，直接运行：

ok-ww.exe -t 1 -e

意思是启动后自动执行第一个任务，跑完自动退出程序，全程零操作。初次使用还是建议先在界面里手动点一次，确认每个环节都正常，再考虑全自动托管。

日常跑通之后，很多人下一个念头就是：能不能让它挂后台，我自己去忙别的？这就得聊聊它最受欢迎的一个特性了。

四、人走脚本不停：后台运行与分辨率适配

ok-ww 支持后台模式——游戏窗口最小化或者被其他窗口完全遮挡，它照样能跑。这个特性的含金量，只有被"挂机必须把游戏放前台、一开其他软件就断"折磨过的人才懂。

更贴心的是，后台运行的同时它可以自动把游戏静音，你开着文档、放着歌、刷着剧，一点不受影响。技能冷却、血条状态这些战斗要素都能在后台持续识别，工作学习两不误。

适配方面它做得也相当宽容：1280x720 到 4K 之间所有 16:9 分辨率都能流畅运行，部分功能兼容 21:9 超宽屏。不过要提醒一句，游戏画面分辨率太低会拖累识别精度，日常使用建议至少 1600x900，帧率最好稳定在 60 FPS——这是官方明确给出的建议，帧率忽高忽低是识别错乱的常见诱因。

后台挂机能解决"时间"问题，但"刷到什么"才是真正的痛点。接下来进入重头戏：声骸。

五、声骸怎么刷、怎么筛：从 4C 到五合一

鸣潮玩家的日常绕不开两个字：声骸。而这套脚本在声骸这件事上，服务得相当到位。

先说刷。FarmEchoTask.py是声骸刷取的主力任务：它支持在副本或大地图 Boss 处开刷 4C 声骸，可以指定 Boss（比如异构武装、荣耀狮像、罗蕾莱等），也能直接通过 F2 菜单传送到周本或 Boss 挑战位。打完一场会自动拾取掉落、判定是否该继续，还能按你设定的次数无限循环。针对不同 Boss 它甚至会智能处理特殊机制——比如罗蕾莱需要切换到夜晚，脚本会自己调整昼夜；某些 Boss 战斗前需要等待几秒，它也内置了对应的等待参数。

再说筛。刷出来一堆"歪词条"的声骸怎么处理？FiveToOneTask.py实现了"数据坞五合一"：通过 OCR 逐条读取声骸属性，再按你勾选的主属性规则（暴击率、暴击伤害、攻击/生命/防御百分比、各类元素伤害加成、共鸣效率、治疗加成等）自动判断留哪个、合哪个。勾选的就是要保留的，没勾的统统自动合成，配合"丢弃数超过 1000 自动合并"这类选项，背包管理基本不用再手动清。

这套刷+筛的组合拳效果相当可观。参考社区里的实测反馈，声骸收集循环从手动的 110 分钟压缩到 18 分钟左右，装备筛选整理从 30 分钟压到 5 分钟上下，日常任务清理则从 25 分钟降到 4 分钟，副本挑战从 45 分钟降到 8 分钟。数字只是参考，但"从肝到闲"的体验差异是实打实的。

刷声骸绕不开打架，那战斗这块，脚本又是怎么做到"全角色通吃"的？

六、全角色自动识别：每个角色都有自己的"剧本"

ok-ww 最省心的一点是：不需要你手动配置技能序列。它内置了全角色识别，启动即用。

实现的思路很有意思——在src/char/目录下，每个角色都有一个独立的 Python 文件：卡卡罗、忌炎、今汐、长离、吟霖、守岸人……你可以看到一份相当长的角色清单。每个文件里写的是这个角色的专属战斗逻辑：什么时候该放哪个技能、什么时候切人、什么时候开大招，相当于给每个角色写了一份"剧本"。开发者在docs/zh-CN/index.md里也详细说明了这套机制的使用方式。

战斗时，脚本会结合技能冷却识别（还记得前面那张冷却截图吗）、敌人状态和角色资源情况，按剧本执行操作。底层逻辑在src/task/BaseCombatTask.py和src/combat/CombatCheck.py里，想看战斗判定逻辑的可以从这两个文件入手。

不过有一个非常容易踩的坑必须提前说：队伍里的每个角色都必须装备主声骸。判断标准很简单——画面右下角要能看到声骸技能图标。只要有任何一个角色没带主声骸，自动战斗就可能出现"反复锁定敌人却不出手"的诡异表现。这个问题在官方疑难解答里排得很靠前，很多人排查半天，最后发现是漏装备了。

说到疑难解答，这套工具毕竟依赖图像识别，出点小状况很正常。真遇到了别慌，按下面的清单走一遍，八成能解决。

七、翻车排查清单：照着做就行

1. 被"墙"了：程序打不开或文件莫名消失？先去杀毒软件白名单里看看。
2. 识别飘了：先确认显卡滤镜关了、亮度是默认值、叠加层全关了。
3. 按键没反应：如果你改过游戏内按键，记得在 ok-ww 设置里同步，它只认自己列表里的按键。
4. 走得歪歪扭扭：游戏设置里关闭"自动奔跑"，这个开关不关容易和脚本的移动逻辑打架。
5. 掉线：在设置里打开"启动后关闭启动器"，确保启动器进程没在运行。
6. OpenVINO 报 0x000005：如果你用的是带 NPU 的 Intel CPU，去更新 Intel 最新 NPU 驱动。
7. 反复锁定不攻击：检查全员主声骸装备（上面专门讲过）。
8. 还是不行：确认用的是最新版本，游戏稳定 60 FPS，然后把错误报告发到社区。

排完这些，绝大多数问题都能归位。如果你不满足于"用现成的"，还想自己动手改点东西，最后这部分是给你的。

八、进阶玩法：想折腾源码的人看这里

项目基于 Python 编写，推荐使用 Python 3.12（3.9 以上均可）。从源码跑起来很简单：

pip install -r requirements.txt --upgrade python main.py

想调试运行就看main_debug.py，会输出更详细的日志。全局配置集中在config.py，游戏路径、窗口设置、按键映射都在这里管。

想加深理解的话，tests/目录里躺着大量带截图的测试脚本，从战斗判定到技能冷却再到地图寻路，每一个功能都有对应的测试用例，是很好的学习素材。想参与贡献的开发者，可以先读docs/development/contributing.md了解协作规范。另外，多账号玩家可以关注MultiAccountDailyTask.py，它支持配置多个账号按序执行日常，属于"肝帝福音"级别的功能。

写在最后：省下的时间，是它给你的最大价值

回头看看这套东西：图像识别负责"看"，状态判断负责"想"，任务调度负责"做"，角色剧本负责"打"，三个环节各司其职，组成了一个相当完整的自动化闭环。对普通玩家来说，它意味着每天省下一两个小时重复劳动；对技术爱好者来说，它又是一个能拆开慢慢研究的图像识别 + 自动化实战案例。

最后必须说句实在话：这类工具始终存在账号风险，项目文档里也明确引用了库洛官方的公平运营声明，使用即代表已知晓并自担风险。我的建议是——先从小任务试水，跑通一个环节再逐步扩展，别一上来就把所有账号都挂上。工具是死的，人活得灵活一点，总没坏处。

现在，去下载那个 setup.exe，给它三分钟，然后看看你的日常任务能不能在你去泡杯咖啡的工夫里，自己悄悄跑完。

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