ok-ww 增强版

English | 中文 | 日本語

简介

在保留 原版 ok-ww 全部功能的基础上，添加新版日常每日任务，增加任务鲁棒性和日志可读性，方便无人值守运行和调试。

代码变更：https://github.com/zzc-tongji/ok-ww-enhanced/compare/master..main?diff=split 。

构建方法变更：build.diff.html 。

新功能

所有新增功能用⭐标出。

新版体力任务（无音区、凝素领域、模拟领域）

• 支持设置刷取次数：
  • 如不需要刷取，设 0 。如需刷完所有体力，设一个大数。
  • 刷取次数以1倍（最低）体力计算。支持2倍体力刷取副本（相应刷取次数记为2）。
  • 实现方式是注入 use_stamina 函数。这是注入前后的对比 use_stamina.diff.html 。

新版刷4C声骸任务

• 支持 高级技能材料模式：
  • 如果启用，只会在下列三个条件均满足时执行：
    • 选项 "传送至Boss" 为 "战歌重奏"。
    • 高级技能材料 获取次数 未达每周上限。
    • 体力至少够刷1次。
  • 启用后，选项 "刷多少次" 将会被无视，实际刷取次数取决于 每周上限 和 剩余体力。
  • 代码变更报告：FarmEchoTask.diff.html 。

新版每日任务

• 采用新版体力任务（无音区、凝素领域、模拟领域）。支持每种体力任务独立设置刷取次数（支持 跳过刷取 和 刷完所有体力）。
• 采用新版刷4C声骸任务。如果启用 高级技能材料模式 则在 新版体力任务 前执行。
• 支持设置重试次数（对每个任务分别生效）。若重试次数用尽也无法完成，则记录日志并 截图。
• 日志文件 ./logs/ok-script.log 优化：
  • 如果某些任务无法完成，会包含文本 未完成，以便后续处理（例如发送通知）。
  • 在出现异常的情况下，会包含文本 每日任务错误 和错误堆栈，以便后续处理。
• 新版 DailyTask2.py 相比原版 DailyTask.py 的改动：
  • 相比原版，新版增加了任务重试、异常日志和异常截图。
  • 在出现异常的情况下：新版可以设置是否退出程序，原版不会退出程序。
  • 代码变更报告：DailyTask.diff.html 。

运行方法

GUI 运行

从 Release 下载最新的 ok-ww-e-win32-Global-setup.exe 然后双击安装。

CLI 运行

从 Release 下载最新的 ok-ww-e-win32-Global-setup.exe 然后双击安装。

cd "<ok-ww-e-installation-directory>\data\apps\ok-ww-e\working"

# 启动后自动执行第1个任务（新版每日任务），并在任务完成后退出程序。
ok-ww-e.exe -t 1 -e

# 启动后自动执行第6个任务（原版每日任务），并在任务完成后退出程序。
ok-ww-e.exe -t 6 -e

• -t 或 --task - 启动后自动执行第 N 个任务。
• 1 - 任务列表（config.py -> onetime_tasks）中的第1个。
• -e 或 --exit - 任务执行完毕后自动退出程序。

源码运行

建议将依赖安装到 miniconda 虚拟环境。

# requirement
conda create --name okww python=3.12 pip=25.0
pip install -r requirements.txt --upgrade
pip install -r requirements-dev.txt --upgrade

# release
python main.py

# debug
python main_debug.py

使用 VSCode 进行开发调试

ok-oldking#934

COCO 特征预览

图像特征 assets/coco_annotations.json 可以通过下列链接预览（持续更新）：

https://htmlpreview.github.io/?https://raw.githubusercontent.com/zzc-tongji/ok-ww-e-coco-preview/refs/heads/main/data/index.html

小贴士

• ok-ww-e 可以进行游戏热更新重启，但是需要关闭 设置 / 基本设置 / 游戏退出时，自动退出应用。
• 如果发现 ok-ww-e 无法启动游戏，请先尝试以管理员身份启动。如果无效，请通过管理员模式的 cmd 命令行启动 cmd /c start "" ok-ww-e.exe。

免责申明

本软件是一个外部工具，旨在自动化鸣潮的游戏玩法。它仅通过现有用户界面与游戏交互，并遵守相关法律法规。该软件包旨在简化用户与游戏的交互，不会破坏游戏平衡或提供不公平优势，也不会修改任何游戏文件或代码。

本软件开源、免费，仅供个人学习交流使用，仅限于个人游戏账号，不得用于任何商业或营利性目的。开发者团队拥有本项目的最终解释权。使用本软件产生的所有问题与本项目及开发者团队无关。若您发现商家使用本软件进行代练并收费，这是商家的个人行为，本软件不授权用于代练服务，产生的问题及后果与本软件无关。本软件不授权任何人进行售卖，售卖的软件可能被加入恶意代码，导致游戏账号或电脑资料被盗，与本软件无关。

请注意，根据库洛的《鸣潮》公平运营声明:

严禁利用任何第三方工具破坏游戏体验。
我们将严厉打击使用外挂、加速器、作弊软件、宏脚本等违规工具的行为，这些行为包括但不限于自动挂机、技能加速、无敌模式、瞬移、修改游戏数据等操作。
一经查证，我们将视违规情况和次数，采取包括但不限于扣除违规收益、冻结或永久封禁游戏账号等措施。

---

原版 ok-ww 的 README

---

ok-ww

一个基于图像识别的鸣潮自动化程序，支持后台运行，基于 ok-script 开发。
An image-recognition-based automation tool for Wuthering Waves, with background mode support, developed with ok-script.

通过 Windows 接口模拟用户进行操作，无内存读取、无文件修改

官方网站： https://ok-script.com/ok-ww

English | 中文说明 | 繁體中文 | 日本語

演示与教程:

---

⚠️ 免责声明

本软件为外部辅助工具，旨在自动化《鸣潮》的部分游戏流程。它完全通过模拟常规用户界面与游戏交互，遵循相关法律法规。本项目旨在简化用户的重复性操作，不会破坏游戏平衡或提供不公平优势，也绝不会修改任何游戏文件或数据。

本软件开源、免费，仅供个人学习与交流使用，请勿用于任何商业或营利性目的。开发者团队拥有本项目的最终解释权。因使用本软件而产生的任何问题，均与本项目及开发者无关。

请注意，根据库洛官方的《鸣潮》公平运营声明：

严禁利用任何第三方工具破坏游戏体验。 我们将严厉打击使用外挂、加速器、作弊软件、宏脚本等违规工具的行为，这些行为包括但不限于自动挂机、技能加速、无敌模式、瞬移、修改游戏数据等操作。 一经查证，我们将视违规情况和次数，采取包括但不限于扣除违规收益、冻结或永久封禁游戏账号等措施。

使用本软件即表示您已阅读、理解并同意以上声明，并自愿承担一切潜在风险。

🚀 快速开始

1. 下载安装包：从下方的“下载渠道”中选择一个，下载最新的 ok-ww-win32-China-setup.exe 安装文件。
2. 安装程序：双击 ok-ww-win32-China-setup.exe 文件，并按照安装向导的提示完成安装。
3. 运行程序：安装完成后，从桌面快捷方式或开始菜单启动 ok-ww 即可。

📥 下载渠道

• GitHub: 官方发布页，全球访问速度快。（请下载 setup.exe 安装包，而不是 Source Code 源码压缩包）
• Mirror酱: 国内镜像，下载可能需要购买其平台的 CD-KEY。
• 百度网盘: 免费下载
• 夸克网盘: 免费下载

✨ 主要功能

• 高分辨率支持: 流畅运行于 4K 及以下所有 16:9 分辨率（最低 1280x720）。部分功能兼容 21:9 等超宽屏。
• 后台模式: 支持游戏窗口最小化或被遮挡时在后台运行，不影响您使用电脑。
• 智能识别: 全角色自动识别，无需手动配置技能序列，一键启动。
• 自动静音: 在后台运行时，可自动将游戏静音。

🔧 疑难解答 (Troubleshooting)

如果遇到问题，请在提问前按以下步骤逐一排查：

1. 杀毒软件：将软件的安装目录添加到您的杀毒软件（包括 Windows Defender）的信任区或白名单中，以防文件被误删或拦截。
2. 显示设置：
   • 一般可以开启游戏内滤镜，但不能开启显卡滤镜，例如 NVIDIA 动态亮丽、AMD 锐化。
   • 使用游戏默认的亮度设置。
   • 关闭任何在游戏画面上显示信息的叠加层（如 MSI Afterburner、Fraps 等显示的帧率）。
3. 自定义按键：如果您修改了游戏内的默认按键，请务必在 ok-ww 的设置中进行同步配置。仅支持设置中列出的按键。
4. 软件版本：检查并确保您使用的是最新版本的 ok-ww。
5. 游戏性能：请确保游戏能稳定在 60 FPS 运行。如果帧率不稳定，请尝试降低游戏画质或分辨率。
6. 游戏断线：在 ok-ww 设置中开启“启动后关闭启动器”，确保启动器进程未在运行；或者使用源码运行。
7. OpenVINO 报错：如果遇到 0x000005 报错，并且使用的是带 NPU 的 Intel CPU，请更新至 Intel 最新的 NPU 驱动。
8. 寻求帮助：如果以上步骤都无法解决您的问题，请通过社区渠道提交详细的错误报告。
9. 关闭自动奔跑：游戏设置里关闭自动奔跑。
10. 为所有角色装备主声骸：队伍中的每个角色都必须装备主声骸（画面右下角应显示声骸技能图标）。任何一个角色未装备主声骸时，自动战斗将无法正常运行，并可能反复锁定敌人而不攻击。

---

💻 开发者专区

从源码运行 (Python)

推荐使用 Python 3.12。要求 Python 3.9 及以上版本，但其他版本尚未经过完整测试。

# 安装或更新依赖
pip install -r requirements.txt --upgrade

# 运行 Release 版本
python main.py

# 运行 Debug 版本
python main_debug.py

命令行参数

您可以通过命令行参数实现自动化启动。

# 示例：启动后自动执行第一个任务（一条龙），并在任务完成后退出程序
ok-ww.exe -t 1 -e

• -t 或 --task: 启动后自动执行第 N 个任务。1 代表任务列表中的第一个。
• -e 或 --exit: 任务执行完毕后自动退出程序。

💬 加入我们

• QQ 交流群: 1035795301 (入群答案: 老王同学OK)
• QQ 频道: 点击加入 (群满或获取最新资讯)
• 开发者群: 926858895 ( 注意: 此群仅面向有开发能力、希望参与贡献的开发者，入群前请确保您已能够从源码成功运行项目。)

本项目基于 ok-script 框架开发，简单易维护。欢迎有兴趣的开发者使用 ok-script 开发您自己的自动化项目。

🔗 使用ok-script的项目：

• 鸣潮 https://github.com/ok-oldking/ok-wuthering-waves
• 原神(停止维护, 但是后台过剧情可用) https://github.com/ok-oldking/ok-genshin-impact
• 少前2 https://github.com/ok-oldking/ok-gf2
• 星铁 https://github.com/Shasnow/ok-starrailassistant
• 星痕共鸣 https://github.com/Sanheiii/ok-star-resonance
• 二重螺旋 https://github.com/BnanZ0/ok-duet-night-abyss
• 白荆回廊(停止更新) https://github.com/ok-oldking/ok-baijing

❤️ 赞助与致谢

赞助商 (Sponsors)

• EXE 签名: Free code signing provided by SignPath.io, certificate by SignPath Foundation.

致谢

• lazydog28/mc_auto_boss
• ok-oldking/OnnxOCR
• zhiyiYo/PyQt-Fluent-Widgets
• Toufool/AutoSplit