ok-end-field

Downloads

English Readme | 中文说明

---

演示与教程:

---

⚠️ 免责声明

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

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

请注意，根据鹰角官方的《终末地》公平运营声明：

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

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

🚀 快速开始

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

📥 下载渠道

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

运行要求与推荐设置

• 系统：Windows
• 游戏分辨率：推荐 16:9（1920×1080 最佳），最低 1600×900（低于该分辨率可能导致识别与定位异常）
• 语言：当前部分功能仅支持简体中文
• 运行权限：建议管理员权限运行（源码模式必须）
• 路径：安装/运行路径尽量使用纯英文
• 帧率：推荐稳定 60 FPS，用于战斗和导航任务

---

文档入口

• 文档索引：docs/README.md
• 开发快速开始：docs/dev/QUICKSTART.md
• API 参考：docs/dev/API.md
• Windows 计划任务：docs/Windows%20计划任务.md

功能一览（按任务类型）

• 自动战斗：检测战斗状态并按技能序列自动释放
• 自动拾取：大世界白名单拾取 + 黑名单过滤
• 自动交互：自动跳过剧情 + 自动点击传送
• 自动登录：自动处理掉线/登出流程 + 领取月卡
• 物品导航：官方地图 WebSocket 或本地 WebSocket 驱动的物品采集点导航

一次性任务（完整列表）

• 日常任务：送礼、据点兑换、委托处理、买卖货、刷体力、奖励领取等一条龙
• 刷体力：普通/高阶/危境/能量淤积点，支持排轴和刷本序列
• 运送委托接取：按券种与金额筛选并自动抢单
• 自动送货：武陵委托自动接取与送货路径执行（7.31w/7.98w）
• 仓库物品转移：跨仓库批量转移指定物品
• 演算抽牌：自动进入演武集算页，循环抽取直到满足等级变化条件
• 影拓丰碑：自动完成当前所有普通影拓丰碑关卡
• 实时检测：循环运行 YOLO 检测，用于在线观察模型表现
• 启动一次游戏：配合任务计划程序提前启动游戏并自动退出
• 诊断：框架内置诊断任务的简单封装

定时任务

• 支持将声明 support_schedule_task = True 的一次性任务加入 Windows 任务计划，按设定时间自动启动执行。相关文档：Windows 计划任务

辅助能力

• OCR 识别、模板匹配、HSV 颜色识别
• UI 自动化、按键模拟
• 日志、异常处理、流程调度

🔧 疑难解答 (Troubleshooting)

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

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

---

🛠 维护区

维护文档

文档	说明
自动送货维护工作流	新增或调整送货地区时使用；说明如何维护地区数据、模板资源与验证步骤
日常送礼维护工作流	新增角色联络或礼物赠送功能时使用；说明如何添加角色数据与接触模板
主数据维护工作流	新增或调整游戏区域、关卡、商品数据时使用；说明所有世界数据结构的维护方法

---

💻 开发者专区

开发者文档

文档	说明
快速开始（QUICKSTART.md）	从源码运行项目、启动软件、新建触发式/一次性任务的最简流程
开发指南（DEVELOPMENT.md）	架构总览、目录结构、开发流程、测试、CI/CD、文档同步维护
API 参考（API.md）	BaseEfTask、Mixin、ScreenPosition、KeyConfigManager 等详细 API
i18n 与 OCR 配置流程	runtime locale、语言 JSON、OCR 匹配与纠错配置流程
装备词条识别轮子	已移除任务后的 OCR parser、CSV matcher 与模板资产复用说明
键盘操作体系（键盘操作体系.md）	热键映射、按键封装规范、send_key 例外清单

从源码运行 (Python)

本项目仅支持 Python 3.12 版本, 必须以管理员权限启动CMD, PyCharm, VSCode。

# 若首次 clone 未带子模块参数，请先执行
git submodule update --init --recursive

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

# 运行 Release 版本
python main.py

# 运行 Debug 版本
python main_debug.py

命令行参数

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

命令行参数由底层 ok-script 启动器解析，项目入口 main.py 负责传入 src/config.py 中的任务配置。

# 启动后自动执行第1个任务『日常任务』，并在任务完成后退出程序
ok-ef.exe -t 1 -e

• -t 或 --task: 启动后自动执行第N个任务。1 代表任务列表（文件 src/config.py 中的 onetime_tasks）中的第1个（也就是『日常任务』）。
• -e 或 --exit: 任务执行完毕后自动退出程序。

开发调试与测试

# 执行 tests/ 下全部测试脚本（PowerShell）
./run_tests.ps1

# 或逐个运行 unittest
python -m unittest tests/TestEssenceRecognizer.py

若你在开发“识别类任务”（OCR/模板/颜色识别），建议优先在 main_debug.py 下调试，配合日志与截图目录排查。

💬 加入我们

• QQ 交流群: 940581952 (入群答案: 终末地)
• QQ 频道: 点击加入 (群满或获取最新资讯)
• 开发者群: 1079581542 ( 注意: 此群仅面向有开发能力、拥有Github账号、希望参与贡献的开发者，入群前请确保您已能够从源码成功运行项目。)

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

🔗 使用ok-script的项目：

• 终末地 https://github.com/AliceJump/ok-end-field
• 鸣潮 https://github.com/ok-oldking/ok-wuthering-waves
• 鸣潮(日常一条龙-优化版) https://github.com/zzc-tongji/ok-ww-enhanced
• 原神(停止维护, 但是后台过剧情可用) 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.

致谢

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