AliceJump / ok-end-field

ok-ef 一个基于图像识别的终末地自动化程序，部分功能支持后台运行，基于 ok-script 开发。 An image-recognition-based automation tool for End Field, with background mode support, developed with ok-script . 通过模拟 Windows 用户接口进行操作，无内存读取、无文件修改 English Readme | 中文说明 **演示与教程: ** --- ⚠️ 免责声明 本软件为外部辅助工具，旨在自动化《终末地》的部分游戏流程。它完全通过模拟常规用户界面与游戏交互，遵循相关法律法规。本项目旨在简化用户的重复性操作，不会破坏游戏平衡或提供不公平优势，也绝不会修改任何游戏文件或数据。 本软件开源、免费，仅供个人学习与交流使用，请勿用于任何商业或营利性目的。开发者团队拥有本项目的最终解释权。因使用本软件而产生的任何问题，均与本项目及开发者无关。 请注意，根据鹰角官方的《终末地》公平运营声明： > 严禁利用任何第三方工具破坏游戏体验。 > 我们将严厉打击使用外挂、加速器、作弊软件、宏脚本等违规工具的行为，这些行为包括但不限于自动挂机、技能加速、无敌模式、瞬移、修改游戏数据等操作。 > 一经查证，我们将视违规情况和次数，采取包括但不限于扣除违规收益、冻结或永久封禁游戏账号等措施。 **使用本软件即表示您已阅读、理解并同意以上声明，并自愿承担一切潜在风险。** 🚀 快速开始 • **下载安装包**：从下方的“下载渠道”中选择一个，下载最新的 安装文件。 • **安装程序**：双击 文件，并按照安装向导的提示完成安装。 • **运行程序**：安装完成后，从桌面快捷方式或开始菜单启动 即可。 📥 下载渠道 • **GitHub**: 官方发布页，全球访问速度快。（**请下载 安装包，而不是 源码压缩包**） • **Mirror酱**: 国内镜像，下载可能需要购买其平台的 CD-KEY。 • **夸克网盘**: 国内网盘，免费，但需要注册并使用其客户端下载。 ✨ 主要功能 功能一览（模块化架构 & 任务类型） 日常任务自动化 • 送礼、信赖提升、干员联络 • 据点兑换、信用收集、委托转交、领取委托奖励 • 装备制造、线索收集、日常奖励一键领取 自动战斗与资源消耗 • 自动进入关卡、智能战斗、自动领奖 • 支持技能序列、理智消耗优化 • 多关卡类型（普通/高阶/能量淤积点） 自动交易与市场功能 • 市场物品识别、批量收集与比价 • 好友市场价格对比 • 自动买卖货物、信用商店自动刷新与购买 自动导航与交互 • 地图导航、目标追踪、自动对齐 • 干员联络站自动寻路与交互 • 多场景导航与容错 定时/触发式任务 • 自动拾取（白名单/黑名单过滤） • 自动登录、自动跳过剧情 • 支持 Windows 任务计划定时执行 辅助与通用功能 • OCR 识别、模板匹配、HSV 颜色识别 • UI 自动化、按键模拟 • 日志与异常处理、流程调度 可扩展的 Mixin 架构 • 各领域功能解耦，便于维护和扩展 • 支持多重继承组合业务流程 运行要求与推荐设置 • 系统：Windows • 游戏分辨率：推荐 16:9（1920×1080 最佳），最低 1280×720 • 语言：当前部分功能仅支持简体中文 • 运行权限：建议管理员权限运行（源码模式必须） • 路径：安装/运行路径尽量使用纯英文 • 帧率：推荐稳定 60 FPS，用于战斗和导航任务 --- 🔧 疑难解答 (Troubleshooting) 如果遇到问题，请在提问前按以下步骤逐一排查： • **安装路径**：请确保软件安装在**纯英文路径**下（例如 ），不要安装在 或包含中文字符的文件夹中。 • **杀毒软件**：将软件的安装目录添加到您的杀毒软件（包括 Windows Defender）的**信任区或白名单**中，以防文件被误删或拦截。 • **显示设置**： • 关闭所有显卡滤镜（如 NVIDIA Game Filter）和锐化功能，除非部分功能要求。 • 使用游戏默认的亮度设置。 • 关闭任何在游戏画面上显示信息的叠加层（如 MSI Afterburner、Fraps 等显示的帧率）。 • **自定义按键**：如果您修改了游戏内的默认按键，请务必在 的设置中进行同步配置。仅支持设置中列出的按键。 • **软件版本**：检查并确保您使用的是最新版本的 。 • **游戏性能**：请确保游戏能稳定在 **60 FPS** 运行。如果帧率不稳定，请尝试降低游戏画质或分辨率。 • **游戏断线**：如频繁遇到与服务器断开连接的问题，可以尝试先手动打开游戏运行5分钟后再启动本工具，或在断线后直接重新登录，不要退出游戏。 • **寻求帮助**：如果以上步骤都无法解决您的问题，请通过社区渠道提交详细的错误报告。 • **游戏/软件语言** 本软件目前部分功能仅支持简体中文，不支持其他语言。 --- 💻 开发者专区 从源码运行 (Python) 本项目仅支持 Python 3.12 版本, 必须以管理员权限启动CMD, PyCharm, VSCode。 命令行参数 您可以通过命令行参数实现自动化启动。 • 或 : 启动后自动执行第 N 个任务。 代表任务列表中的第一个。 • 或 : 任务执行完毕后自动退出程序。 开发调试与测试 若你在开发“识别类任务”（OCR/模板/颜色识别），建议优先在 下调试，配合日志与截图目录排查。 💬 加入我们 • **QQ 交流群**: (入群答案: ) • **QQ 频道**: 点击加入 (群满或获取最新资讯) • **开发者群**: ( **注意**: 此群仅面向有开发能力、拥有Github账号、希望参与贡献的开发者，入群前请确保您已能够从源码成功运行项目。) 本项目基于 ok-script 框架开发，简单易维护。欢迎有兴趣的开发者使用 ok-script 开发您自己的自动化项目。 🔗 使用ok-script的项目： • 终末地 https://github.com/ok-oldking/ok-end-field • 明日方舟:终末地 https://github.com/ok-oldking/ok-ef • 原神(停止维护, 但是后台过剧情可用) 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