BetterGI 使用指南:自动拾取、自动秘境与钓鱼的视觉自动化如何从零跑通
【免费下载链接】better-genshin-impact📦BetterGI · 更好的原神 - 自动拾取 | 自动剧情 | 全自动钓鱼(AI) | 全自动七圣召唤 | 自动伐木 | 自动刷本 | 自动采集/挖矿/锄地 | 一条龙 | 全连音游 | 自动烹饪 | 桌面分身 - UI Automation Testing Tools For Genshin Impact项目地址: https://gitcode.com/gh_mirrors/be/better-genshin-impact
每天上线,先沿着采集点一路按 F,再到凯瑟琳处领完委托、重新派遣,最后守着鱼塘盯漂收杆,这些流程吃掉了大量在线时长。BetterGI(better-genshin-impact)是一款本地运行的原神自动化辅助,通过计算机视觉识别游戏画面、再模拟键鼠执行操作,把自动拾取、自动剧情、自动秘境、钓鱼这类流程从你手里接管过去,你只需要决定"刷什么、去哪钓"。
工作原理 🖥️
BetterGI 的技术路线分两段:识别端通过截图获取游戏画面,用模板匹配、OCR 文字识别和 AI 模型判断当前处于什么状态(比如出现拾取文字、对话选项、鱼上钩提示);执行端则通过SendInput(前台)和PostMessage(后台)两套通道模拟键鼠输入,相关实现集中在Fischless.WindowsInput与Core/Input目录,设计说明见 input-hub.md。启动后它会弹出一个覆盖在游戏窗口上的遮罩窗口,实时显示运行日志和识别框,方便确认程序到底"看到了什么"。
它的边界同样明确:不改游戏文件、不读写游戏内存、不提供数值类外挂,全部能力建立在"看屏幕 + 模拟点击"之上。
把它跑起来
| 项目 | 最低要求 | 说明 |
|---|---|---|
| 操作系统 | Windows 10 或更高版本(64 位) | 不支持 32 位系统 |
| 运行时 | .NET 10 | 官方发布包已自带,无需单独安装 |
| 游戏窗口 | 1920x1080 窗口化,16:9 | 不支持全屏、无边框;不支持 HDR、N 卡滤镜等画面效果 |
| 硬件底线 | 中画质 60 帧流畅游玩原神 | 图像识别吃性能,低配机部分功能体验下降 |
安装与初始配置:
- 从项目 Release 页下载最新版安装包;想自行编译则执行
git clone https://gitcode.com/gh_mirrors/be/better-genshin-impact,需要 .NET 10 SDK 与 10.0.22621.0 以上版本的 Windows SDK,编译方法见 BetterGenshinImpact/README.md。 - 将原神设为 1920x1080 窗口化,关闭 HDR 与任何画面滤镜,亮度保持默认。
- 以管理员权限运行 BetterGI——游戏通常以管理员身份启动,权限不足时模拟点击会被拒绝。
- 把 BetterGI 加入安全软件白名单,360 及部分自定义规则的防火墙会拦截部分模拟点击。
- 打开软件,在"启动"页选择截图方式,点击启动按钮,遮罩窗口覆盖到游戏画面上即表示截图链路已建立。
- 首跑验证:到任务设置里勾选「自动拾取」,在游戏里走到任意一个可拾取材料旁。如果程序自动按下 F 拾取、遮罩窗口的日志同步输出拾取识别事件,说明识别与模拟输入整条链路都通了。
按场景使用核心功能
自动拾取:不用手按 F
工作方式:作为实时任务,它每帧扫描画面中的拾取文字,用 OCR(Paddle 或 Yap 引擎)读出材料名,对照名单过滤后自动按 F(按键可在配置中改)。名单分黑白两种模式,黑名单模式支持精确匹配与模糊匹配两套规则。
配置入口:User/config.json中AutoPick节点(对应 AutoPickConfig.cs),开关字段Enabled、模式字段Mode(Whitelist/Blacklist);名单是独立文本文件,如User/pick_black_lists.txt(黑名单精确名)、User/pick_fuzzy_black_lists.txt(模糊匹配),编辑窗口也可直接维护。
启用后的变化:靠近薄荷、蒲公英籽这类低价值材料不再被塞进背包——把它们写进黑名单即可;只有名单内的材料才会触发 F 键。遮罩日志会逐条打印每次命中,是否生效当场可验。
自动剧情与委托闭环
工作方式:实时识别对话文本,自动点击推进剧情、选择选项、关闭弹出书页;与凯瑟琳对话时,若出现橙色选项,自动领取「每日委托」奖励并重新派遣探险队,对应开关AutoGetDailyRewardsEnabled与AutoReExploreEnabled默认均为开启。
配置入口:User/config.json中AutoSkip节点(对应 AutoSkipConfig.cs)。
启用后的变化:日常委托从"走到 NPC 后连续点二十多下"变成"走过去就行",领奖励和重新派遣在对话里自动完成,省掉的是每次交互的连续点击。
钓鱼:半自动与全自动
工作方式:同一功能提供两档。实时任务的半自动模式下,AI 识别鱼影自动抛竿(AutoThrowRodEnabled开关,抛竿后未咬钩的超时时间AutoThrowRodTimeOut默认 15 秒);独立任务的全自动模式则在你面向鱼塘、画面出现钓鱼 F 键时启动,程序包办抛竿、等待咬钩、收杆,并按昼夜策略FishingTimePolicy自动切换白天/夜晚(可选All/Daytime/Nighttime/DontChange)。
配置入口:User/config.json中AutoFishing节点(对应 AutoFishingConfig.cs),整体任务超时WholeProcessTimeoutSeconds默认 300 秒。
启用后的变化:挂机时段切全自动,程序自己完成整轮钓鱼并轮换昼夜;想参与时切回半自动,只保留收杆动作。
自动秘境刷体力
工作方式:独立任务,自动循环执行"进入秘境 → 开启钥匙 → 执行战斗策略 → 走到古树领奖励",战后间隔由FightEndDelay(默认 5 秒)控制,战斗死亡后按ReviveRetryCount(默认 3 次)重试。战斗本身由 JSON 策略文件驱动,角色上下场与技能释放节奏都写在策略里,入口统一走AutoFightEntryTask,策略体系说明见 auto-fight-strategy.md。
配置入口:User/config.json中AutoDomain节点(对应 AutoDomainConfig.cs):PartyName填队伍名、DomainName填秘境名,树脂消耗用统一的ResinUsage设置区分浓缩、原粹、须臾、脆弱树脂及各自次数。
启用后的变化:体力耗尽前挂着跑,人离开电脑流程不中断;每轮领完奖励自动开下一轮,断点会停在遮罩日志里。
一条龙:把日常串成一次启动
工作方式:一键用历练点完成每日委托、领取奖励,再按编排继续执行钓鱼、刷本、地脉花、首领讨伐等后续环节;每个环节有独立开关,执行顺序由TaskOrder维护,中途失败会记录断点位置。
配置入口:User/config.json中OneDragonFlow节点(对应 OneDragonFlowConfig.cs),TaskEnabledList控制各环节开关,还有按星期分配秘境/地脉花的字段组。
启用后的变化:当日计划在软件里按顺序自动跑完,你只负责观察日志确认每个环节正常收尾。
配置文件与关键参数
配置以 JSON 存放在程序用户目录,主文件是User/config.json(所有功能节点的开关与参数都在这里),拾取名单单独拆成了若干文本文件便于编辑:
BetterGenshinImpact/ # 程序用户目录 ├── User/ │ ├── config.json # 全部功能配置:开关、名单模式、树脂、一条龙编排 │ ├── pick_black_lists.txt # 自动拾取黑名单(精确匹配) │ ├── pick_fuzzy_black_lists.txt # 自动拾取模糊黑名单 │ └── pick_white_lists.txt # 白名单(黑名单模式下作为"必拾"使用) └── Assets/Config/Pick/ └── default_pick_black_lists.json # 内置默认名单,与用户文件合并生效常见调优各改哪里:
- 想调"哪些材料被拾取":改
User/下对应名单文件,精确名写pick_black_lists.txt,模糊词(如带"花"字的一概不拾)写pick_fuzzy_black_lists.txt;模式切换改config.json中AutoPick.Mode字段。 - 想调"钓鱼跑多久、钓哪段时段":改
config.json中AutoFishing节点的FishingTimePolicy(时段策略)和AutoThrowRodTimeOut(空竿重试间隔,默认 15 秒)。 - 想调"秘境烧多少树脂":改
AutoDomain节点的ResinUsage,按树脂种类设次数,ReviveRetryCount控制死亡重试上限。
问题定位
启动后无响应或闪退——最可能的原因是没有以管理员权限运行,或自行编译时 Windows SDK 版本过低。先确认用的是官方发布包(已自带 .NET 10 运行时);再以管理员身份重新启动;自编译用户核对 Windows SDK 是否为 10.0.22621.0 及以上;仍无响应则查 Windows 事件查看器里对应进程的错误条目。
识别不到游戏画面——最可能的原因是游戏不在 16:9 窗口化,或开了 HDR、显卡滤镜。先把分辨率切回 1920x1080 窗口化;关闭 HDR 与滤镜、亮度回默认;注意任何窗口大小、分辨率或显示器的变动之后都要重启 BetterGI。
点击了但游戏没反应——最可能的原因是游戏窗口未处于前台激活状态,或模拟点击被安全软件拦截。点一下游戏窗口使其激活;再观察遮罩日志有没有输出该功能的识别事件;有事件但不生效,多为 360 或自定义规则防火墙拦截,加入白名单后重试。
某功能不触发——最可能的原因仍是权限或拦截,其次为任务开关没开。确认对应功能的Enabled开关状态;再看遮罩日志是否持续输出识别事件;无事件则按上一条排查拦截问题。
资源占用偏高、帧率下降——最可能的原因是实时任务与独立任务叠加,识别负载过高。只保留当前在用的任务开关;把游戏画质降到中档保证 60 帧;低配机先停掉独立任务再观察。
游戏更新后某功能失效——最可能的原因是界面元素变化导致识别模板失配。先更新 BetterGI 到最新版;确认游戏仍在 16:9 窗口化下运行;仍失效则到仓库提 Issue 并附日志截图。
项目边界与生态
- 开源协议:GPL v3。
- 反馈渠道:仓库 Issue,或官方 QQ 群 761949201。
- 技术边界:所有功能基于计算机视觉 + 模拟键鼠,不修改游戏文件、不读写游戏内存、不提供数值类外挂;想深入看代码的话,识别核心在
Core/Recognition,任务实现在GameTask,设计文档集中在 Docs/design/。 - 风险提示:官方用户条款明确将第三方软件与模拟操作列为封号理由之一,当前方案仍存在被检测的可能,请低调使用,风险自行评估。
BetterGI 把拾取、委托、秘境、钓鱼这些占满在线时长的流程变成了可以挂着的自动执行,你只保留决策部分。建议分阶段采用:先只开自动拾取和自动剧情,观察遮罩日志连续两三天识别稳定、安全软件不再拦截,再逐个启用钓鱼、秘境和一条龙,每加一个环节都确认日志闭环正常再叠加下一个。
【免费下载链接】better-genshin-impact📦BetterGI · 更好的原神 - 自动拾取 | 自动剧情 | 全自动钓鱼(AI) | 全自动七圣召唤 | 自动伐木 | 自动刷本 | 自动采集/挖矿/锄地 | 一条龙 | 全连音游 | 自动烹饪 | 桌面分身 - UI Automation Testing Tools For Genshin Impact项目地址: https://gitcode.com/gh_mirrors/be/better-genshin-impact
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考