BetterGI 使用指南：自动拾取、自动秘境与钓鱼的视觉自动化如何从零跑通

BetterGI 使用指南自动拾取、自动秘境与钓鱼的视觉自动化如何从零跑通【免费下载链接】better-genshin-impactBetterGI · 更好的原神 - 自动拾取 | 自动剧情 | 全自动钓鱼(AI) | 全自动七圣召唤 | 自动伐木 | 自动刷本 | 自动采集/挖矿/锄地 | 一条龙 | 全连音游 | 自动烹饪 | 桌面分身 - UI Automation Testing Tools For Genshin Impact项目地址: https://gitcode.com/gh_mirrors/be/better-genshin-impact每天上线先沿着采集点一路按 F再到凯瑟琳处领完委托、重新派遣最后守着鱼塘盯漂收杆这些流程吃掉了大量在线时长。BetterGIbetter-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工作方式作为实时任务它每帧扫描画面中的拾取文字用 OCRPaddle 或 Yap 引擎读出材料名对照名单过滤后自动按 F按键可在配置中改。名单分黑白两种模式黑名单模式支持精确匹配与模糊匹配两套规则。配置入口User/config.json中AutoPick节点对应 AutoPickConfig.cs开关字段Enabled、模式字段ModeWhitelist/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.csPartyName填队伍名、DomainName填秘境名树脂消耗用统一的ResinUsage设置区分浓缩、原粹、须臾、脆弱树脂及各自次数。启用后的变化体力耗尽前挂着跑人离开电脑流程不中断每轮领完奖励自动开下一轮断点会停在遮罩日志里。一条龙把日常串成一次启动工作方式一键用历练点完成每日委托、领取奖励再按编排继续执行钓鱼、刷本、地脉花、首领讨伐等后续环节每个环节有独立开关执行顺序由TaskOrder维护中途失败会记录断点位置。配置入口User/config.json中OneDragonFlow节点对应 OneDragonFlowConfig.csTaskEnabledList控制各环节开关还有按星期分配秘境/地脉花的字段组。启用后的变化当日计划在软件里按顺序自动跑完你只负责观察日志确认每个环节正常收尾。配置文件与关键参数配置以 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-impactBetterGI · 更好的原神 - 自动拾取 | 自动剧情 | 全自动钓鱼(AI) | 全自动七圣召唤 | 自动伐木 | 自动刷本 | 自动采集/挖矿/锄地 | 一条龙 | 全连音游 | 自动烹饪 | 桌面分身 - UI Automation Testing Tools For Genshin Impact项目地址: https://gitcode.com/gh_mirrors/be/better-genshin-impact创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考