ok-ww 增强版

简介

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

新功能

所有新增功能用⭐标出。

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

• 支持设置传送超时：
  • 可以自定义传送后等待场景加载的最大超时。
  • 任务中的部分超时会基于传送超时进行计算。
• 支持设置刷取次数：
  • 如不需要刷取，设 0 。如需刷完所有体力，设一个大数。
  • 刷取次数以1倍（最低）体力计算。支持2倍体力刷取副本（相应刷取次数记为2）。

新版一条龙任务

• 采用新版体力任务（无音区、凝素领域、模拟领域）。
• 支持设置重试次数：
  • 重试次数对 无音区、凝素领域、模拟领域、梦魇巢穴（梦魇祓除 和 残像聚落） 有效。
  • 无音区、凝素领域 任务失败后，重试时会尝试下一副本。
  • 若重试次数用尽也无法完成，则抛出异常并结束一条龙任务。在此之前，尝试返回游戏大世界 并且 尽最大可能完成 活跃度任务 。
• 在异常抛出点截图保存，方便查找原因。
• 日志文件 ./logs/ok-script.log 优化：
  • 如果某些任务无法完成，会包含文本 未完成，以便后续处理（例如发送通知）。
  • 在出现异常的情况下，会包含文本 一条龙错误 和错误堆栈，以便后续处理。
• 相比原版的改动：
  • 体力任务支持设置传送超时：新版有，原版无。
  • 在出现异常的情况下：新版可以设置是否退出程序，原版不会退出程序。
  • 热更新时自动重启：新版本多判断一次 wait_login，原版直接返回 False。

运行方法

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

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

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

源码运行

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

# requirement
conda create --name facefusion 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

小贴士

• 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 接口模拟用户进行操作，无内存读取、无文件修改

English Readme | 中文说明

演示与教程:

---

⚠️ 免责声明

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

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

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

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

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

🚀 快速开始

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 分辨率（最低 1600x900）。部分功能兼容 21:9 等超宽屏。
• 后台模式: 支持游戏窗口最小化或被遮挡时在后台运行，不影响您使用电脑。
• 智能识别: 全角色自动识别，无需手动配置技能序列，一键启动。
• 自动静音: 在后台运行时，可自动将游戏静音。

🔧 疑难解答 (Troubleshooting)

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

1. 安装路径：请确保软件安装在纯英文路径下（例如 D:\Games\ok-ww），不要安装在 C:\Program Files 或包含中文字符的文件夹中。
2. 杀毒软件：将软件的安装目录添加到您的杀毒软件（包括 Windows Defender）的信任区或白名单中，以防文件被误删或拦截。
3. 显示设置：
   • 关闭所有显卡滤镜（如 NVIDIA Game Filter）和锐化功能。
   • 使用游戏默认的亮度设置。
   • 关闭任何在游戏画面上显示信息的叠加层（如 MSI Afterburner、Fraps 等显示的帧率）。
4. 自定义按键：如果您修改了游戏内的默认按键，请务必在 ok-ww 的设置中进行同步配置。仅支持设置中列出的按键。
5. 软件版本：检查并确保您使用的是最新版本的 ok-ww。
6. 游戏性能：请确保游戏能稳定在 60 FPS 运行。如果帧率不稳定，请尝试降低游戏画质或分辨率。
7. 游戏断线：如频繁遇到与服务器断开连接的问题，可以尝试先手动打开游戏运行5分钟后再启动本工具，或在断线后直接重新登录，不要退出游戏。
8. 寻求帮助：如果以上步骤都无法解决您的问题，请通过社区渠道提交详细的错误报告。
9. 关闭自动奔跑：游戏设置里关闭自动奔跑。

---

💻 开发者专区

从源码运行 (Python)

本项目仅支持 Python 3.12 版本。

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

本项目基于 ok-script 框架开发，核心代码仅约 3000 行 (Python)，简单易维护。欢迎有兴趣的开发者使用 ok-script 开发您自己的自动化项目。

🔗 使用ok-script的项目：

• 鸣潮 https://github.com/ok-oldking/ok-wuthering-wave
• 原神(停止维护, 但是后台过剧情可用) 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