ok-nte-enh

《异环》自动化挂机工具 · 强化自动战斗版

基于图像识别与声音驱动，提供后台挂机、自动战斗、深渊双队等能力。

🎯 项目定位

Important

本项目完全基于 ok-nte 开发，是 ok-nte 自动战斗逻辑的拓展。

本项目是 ok-nte 的衍生分支，所有角色战斗、自动闪避、深渊双队等核心逻辑均继承自 ok-nte 的战斗体系。本仓库不另起炉灶，只在 ok-nte 基础上新增角色与策略、优化战斗衔接，不改变其原有设计，并持续同步上游改动以保持与 ok-nte 主线一致。

在与 ok-nte 的定位关系上：ok-nte 是基础，ok-nte-enh 是面向单刷深渊、挂机刷经验的战斗增量拓展。

✨ 核心特性

强化自动战斗

• 新角色 伊洛伊（Iloy）：加入深渊双队识别与自动出招，支持聚集、治疗、入梦爆发衔接。
• 多角色连招优化：同步优化百川、明、真红、零、小吱等多角色连招与协作。
• 双队自动识配：优化队伍判定、战斗会话保持，以及目标短暂丢失时的策略延续。

便捷挂机功能

• 刷纽扣点（闪避流挂机）：新增 999 夜任务挂机点，进入战斗后只自动闪避、不攻击，适合挂机刷经验。
• 后台运行：支持 PC 游戏在后台运行时进行自动化操作。

日常与生活

• 一键日常：自动完成日常流程，支持经验与甲硬币、异能升级材料、弧盘突破材料、空幕、一咖舍任务、影院约会、羁遇赠礼。
• 羁遇赠礼：自动进行角色羁遇赠礼。
• 自动钓鱼：全自动钓鱼。
• 自动鼓组音游：自动完成鼓组音游。
• 店长特供：自动循环进出关卡（需配合游戏内挂机流派使用）。
• 自动粉爪大劫案：自动完成粉爪大劫案。

战斗辅助

• 角色中心：支持自定义出招表与特征管理，适配不同角色皮肤。
• 声音驱动：基于音频反馈实现自动闪避与反击。
• 跳过对话：跳过冗长剧情对话。
• 快速传送：自动点击地图传送。

独立娱乐

• 自动弹琴：自动分析 MIDI 音轨并完成钢琴演奏。

⚠️ 免责声明

Caution

本软件为开源、免费的外部工具，仅供学习和交流使用，旨在通过模拟操作简化《异环》的游戏玩法。

• 工作原理：程序仅通过识别现有游戏 UI 与游戏交互，不修改任何游戏文件或代码。
• 使用目的：旨在为用户提供便利，无意破坏游戏平衡或提供任何不公平优势。
• 账号风险：使用自动化工具可能导致账号受到处罚，请充分了解相关风险后再使用。
• 责任声明：使用本软件产生的所有问题及后果，均与本项目及开发者无关。

Warning

请注意：根据《异环》公平游戏宣言，官方严禁使用任何第三方工具破坏游戏公平性，包括但不限于自动挂机、技能加速等行为。一经查实可能采取扣除违规收益、冻结账号、永久封禁等措施。

您应充分了解并自愿承担使用本工具可能带来的所有风险。

🖥️ 运行环境与兼容性

• 操作系统：Windows
• 游戏分辨率：1920×1080 或更高（仅支持 16:9 比例）
• 游戏语言：简体中文 / English

🚀 安装指南

方式一：使用安装包（推荐）

此方法适合绝大多数用户，简单快捷，并支持自动更新。请前往本仓库 Releases 页面下载最新安装包。

方式二：从源码运行（适合开发者）

此方法需要您具备 Python 环境，适合希望进行二次开发与调试的用户。

1. 环境要求：确保已安装 Python 3.12 或更高版本。
2. 克隆仓库：

   git clone https://github.com/Guilliman-XIII/ok-nte-enh.git
   cd ok-nte-enh

3. 安装依赖：

   uv sync
   # 或
   pip install -r requirements.txt

4. 运行程序：

   # 运行正式版
   python main.py
   
   # 运行调试版（输出更详细的日志）
   python main_debug.py

📖 使用指南

为确保程序稳定运行，请在使用前确认以下配置：

一、使用前配置（必读）

Important

在启动自动化前，请务必检查并确认以下设置：

• 图形设置
  • 游戏亮度：使用游戏 默认亮度。
  • UI 设置：禁止 所有会导致 UI 与默认不同的设置，UI 透明度 须设为 1.0。
  • 显卡滤镜：关闭 所有显卡滤镜和锐化效果（如 NVIDIA Freestyle、AMD FidelityFX）。
• 分辨率：推荐使用 1920×1080 或以上 16:9 的横屏分辨率。
• 按键设置：请务必使用游戏 默认 按键绑定。
• 第三方软件：关闭任何在游戏画面上显示信息的悬浮窗（如 MSI Afterburner 的帧率显示）。

Warning

窗口与系统状态注意事项

• 鼠标干扰：当游戏窗口处于前台时，请勿移动鼠标，否则会干扰程序的模拟操作。
• 窗口状态：游戏窗口可以置于后台，但不可最小化。
• 系统状态：请勿让电脑熄屏或锁屏，否则将导致程序中断。

二、快速上手

1. 进入您想要自动化的关卡或场景。
2. 在程序界面上点击 "开始" 按钮即可。

💬 问题反馈

如果遇到问题，欢迎通过本仓库的 Issues 进行反馈。为帮助我们快速定位问题，请在提交时提供：

• 问题截图：清晰展示异常界面或错误提示。
• 日志文件：附上程序目录下的 .log 日志文件。
• 详细描述：您进行了哪些操作？问题具体表现是什么？是稳定复现还是偶尔发生？

🔗 致谢

本项目完全基于 ok-nte 开发，是 ok-nte 自动战斗逻辑的拓展，所有战斗核心逻辑均继承自 ok-nte。同时底层依赖 ok-script 框架。感谢 ok-nte 与 ok-script 的开发者和社区开源贡献者的付出。

📄 License

本项目采用 GPL-3.0 协议开源，详情请参阅 LICENSE。