BetterGI（Better Genshin Impact · 更好的原神） 是一个完全开源且免费的项目，基于计算机视觉技术（OCR 文字识别 + YOLOv8 目标检测 + 模拟键鼠操作），实现原神自动拾取、自动剧情、全自动钓鱼、自动秘境、自动锄地等一整套自动化功能。
⚠️ 本软件不会在任何平台售卖软件本体。如果你是在闲鱼、淘宝等渠道花钱买的，请立即退款并举报商家。
一、官方链接汇总
GitHub 直连太慢，可用以下公益加速服务：
https://github.akams.cn/
https://ghfile.geekertao.top/
https://github.dpik.top/
https://gh.dpik.top/
二、系统环境要求
游戏端必须满足的设置
游戏语言：简体中文
分辨率：1920×1080 或其它 16:9 分辨率
游戏亮度：保持默认
禁止任何画面滤镜（HDR、N 卡滤镜、ReShade 等）
DirectX 层上不能有其他遮盖元素（例如 MSI Afterburner 的 FPS 悬浮显示）
窗口大小变化、切换分辨率、切换显示器后，必须重启 BetterGI
三、部署安装（三种方式）
方式 1：安装版（推荐新手）
打开 Releases 页面：https://github.com/babalae/better-genshin-impact/releases
按需下载（除打包方式外，各版本功能完全一致）：
双击运行安装程序，按向导完成安装
双击桌面 / 开始菜单快捷方式启动
方式 2：便携版（免安装）
下载
BetterGI_v版本号.7z用 7-Zip / WinRAR 解压到任意目录（建议路径不含中文与空格）
双击目录内的
BetterGI.exe运行
方式 3：源码构建（开发者）
git clone https://github.com/babalae/better-genshin-impact.git
cd better-genshin-impact
# 使用 Visual Studio 2022 打开解决方案，还原 NuGet 包后编译
dotnet build
dotnet run
首次启动与权限
启动时会弹出 UAC 提示，用于提升至管理员权限，请选择"是"
如果没有弹 UAC，请手动右键 → 以管理员身份运行，否则功能无法正常模拟操作
安全软件处理
模拟键鼠操作容易被安全软件拦截，已知 360 或自定义规则的 Windows Defender 会拦截部分类型的模拟点击。处理方法：
将 BetterGI 安装目录加入杀毒软件白名单，或临时关闭
若日志提示"模拟键鼠消息发送失败！"，基本就是这个原因
四、使用方法（快速上手流程）
第 1 步：设置游戏
按第二节"游戏端必须满足的设置"检查分辨率、语言、亮度、滤镜。
第 2 步：启动 BetterGI
打开 BetterGI 主界面
在"启动"选项卡中选择截图方式（见第五节）
默认勾选"同时启动原神"，点击"启动"按钮
⚠️ 使用云原神、电脑中有多个原神、或通过其他启动器（米哈游启动器等）启动游戏时，请关闭"同时启动原神"
启动后会自动激活原神窗口，等待窗口左下角刷出日志，即表示启动成功
第 3 步：先测试自动拾取（非常重要）
无论要用哪个功能，都先用"自动拾取"验证配置是否正确，测试通过后再用其他功能：
在"实时任务"选项卡确认"自动拾取"已开启（默认开启）
随便找一个采集物或掉落物，站在旁边，观察是否自动按 F 拾取
没有自动拾取时的排查顺序：
左下角日志有没有"交互或拾取"输出？
没有 → 切换到"启动"页换一种截图模式再试
有日志但没动作 → 模拟操作被拦截，确认管理员权限，并把 BetterGI 加入杀毒白名单
提示"模拟键鼠消息发送失败！" → 关闭杀毒软件或加白名单
所有截图方式都无效 → 一定是给游戏加了滤镜，或操作有误
第 4 步：启用具体功能
详见官方功能文档：https://www.bettergi.com/doc.html
五、四种截图方式的区别
六、功能总览
实时任务
自动拾取：遇可交互/拾取内容自动按 F，支持黑白名单
自动剧情：自动过剧情、自动选选项、自动提交物品、关闭书页；对话凯瑟琳时自动领取每日委托奖励、自动重新派遣、自动邀约
快速传送：地图上点击传送点自动传送
半自动钓鱼：AI 识别自动抛竿、自动收杆
独立任务
全自动七圣召唤：自动完成角色邀请、每周来客等 PVE 内容
自动伐木：利用上下线刷新木材原理挂机刷满一背包
自动秘境：全自动刷体力、进本、战斗、领奖励
自动幽境危战：主要用于难度三刷圣遗物
全自动钓鱼：自动完成钓鱼并切换昼夜
自动地脉花：支持绝大部分地脉花位置
自动音游：一键完成千音雅集专辑
自动烹饪：自动在完美区域完成烹饪
自动分解圣遗物：支持快速分解与按规则分解
全自动
一条龙：一键完成日常（使用历练点）并领取奖励
自动采集 / 挖矿 / 锄地：基于左上角小地图识别的地图追踪
键鼠录制回放：录制回放键鼠操作，建议配合调度器
操控辅助
那维莱特转圈圈（长按快捷键持续水平旋转视角）
圣遗物一键强化：快速切换详情/强化页跳过结果展示，快速 +20
商店一键购买：快速以满数量购买，适合清空活动兑换与尘歌壶商店
七、常见问题 FAQ
❓ 为什么需要管理员权限？ 游戏本身是以管理员权限启动的，BetterGI 不以管理员运行就没有权限模拟鼠标点击。
❓ 会不会封号？ 理论上不会。BetterGI 不修改游戏文件、不读写游戏内存，单纯依靠视觉算法 + 模拟操作实现。但用户条款明确第三方软件/模拟操作属于封号理由之一，当前方案仍存在被检测的可能。请低调使用，不要跳脸官方。
❓ 双击软件没反应 / 提示 You must install or update .NET？ 安装 .NET 8 桌面运行时：https://dotnet.microsoft.com/zh-cn/download/dotnet/latest/runtime
❓ 提示 "PaddleOcr 预热失败"？ 参见官方 FAQ：https://www.bettergi.com/faq.html
❓ 想边挂机边用电脑？ 使用"桌面分身启动"功能：https://www.bettergi.com/feats/command/session.html ，在独立桌面中运行游戏与 BetterGI，不影响原桌面的操作。要求 Windows 8 / Server 2012 及以上的非家庭版系统，且系统模块未被魔改。
八、技术架构
技术栈：C# / .NET 8 / WPF
AI 能力：集成 ONNXRuntime、YOLOv8 目标检测、多种 OCR 引擎（PaddleOCR 等）
图像捕获：GDI（BitBlt）、DWM、WindowsGraphicsCapture 等多种方式
脚本扩展：支持 JavaScript 脚本，社区脚本放在
User文件夹即可直接使用开源协议：见仓库 LICENSE，任何人可免费下载使用
本文整理自官方文档与 GitHub 仓库，软件更新较快，实际以 https://www.bettergi.com 为准。