🍨BetterGI使用指南：从入门到精通的自动化之旅

欢迎使用BetterGI（更好的原神）自动化工具！本教程将帮助你快速掌握从环境准备到高级配置的全流程，让你的原神冒险之旅更加轻松愉快。无论是自动拾取、智能钓鱼还是角色培养，BetterGI都能为你提供全方位的自动化支持。

📦 准备阶段：认识你的自动化工具箱

项目组成解析

BetterGI采用模块化设计，各个组件协同工作以实现丰富的自动化功能。让我们来认识一下这个强大工具箱的核心组成部分：

• BetterGenshinImpact：主程序源代码目录，包含了所有核心功能的实现，是整个工具的大脑。
• Fischless：游戏捕获相关的子模块集合，包括GameCapture（游戏画面捕获）和HotkeyCapture（热键捕获）等，为自动化操作提供基础输入支持。
• Build：编译相关文件存放地，包含打包脚本和安装程序配置，负责将源代码转换为可执行程序。
• GameTask：各类自动化任务的具体实现，如AutoFishing（自动钓鱼）、AutoFight（自动战斗）等，是实现各种自动化功能的具体执行者。

核心文件介绍

🔍 关键文件定位：

• 启动文件：在Build目录下可以找到编译后的可执行文件，它是启动BetterGI的入口点。
• 配置文件：程序运行时会在用户目录下生成配置文件，存储你的个性化设置。
• 资源文件：BetterGenshinImpact/Resources目录下存放了程序所需的图片等资源，如图标和界面元素。

图1：BetterGI程序主界面展示，直观呈现各项自动化功能入口

🚀 启动阶段：开启你的自动化之旅

快速启动步骤

1. 获取程序：通过项目仓库获取最新版本的BetterGI程序包。
2. 解压文件：将下载的压缩包解压到你选择的目录，建议路径中不要包含中文和特殊字符。
3. 启动程序：找到Build目录下的可执行文件，双击运行。首次启动时，系统可能会弹出安全提示，请允许程序运行。

首次启动设置

🔍 重要配置步骤：

• 权限授予：程序启动后可能会请求管理员权限和屏幕捕获权限，请确保授予这些权限，否则部分功能可能无法正常工作。
• 游戏路径设置：首次启动时，程序会引导你设置原神游戏的安装路径。请选择正确的游戏可执行文件路径，以便程序能够正常识别和控制游戏。
• 初始配置向导：跟随程序的初始配置向导完成基本设置，如语言选择、界面主题等。

⚙️ 配置阶段：定制你的自动化体验

配置文件详解

BetterGI的配置系统采用模块化设计，将不同功能的设置分门别类，方便你进行精细化调整。主要配置模块及其默认值如下：

配置模块	核心参数	默认值	推荐设置	功能说明
通用设置	CaptureMode	BitBlt	性能好的电脑可尝试Graphics	游戏画面捕获方式，影响性能和兼容性
	TriggerInterval	50ms	低配置电脑可设为100ms	自动化触发器的检测频率
自动拾取	Enable	true	保持开启	是否自动拾取地面物品
	Interval	1000ms	根据需求调整	拾取操作的间隔时间
自动钓鱼	AutoFish	false	需要时开启	是否启用自动钓鱼功能
	FishTarget	Any	根据需求选择特定鱼类	设置钓鱼目标类型
自动战斗	AutoRun	false	需要时开启	是否启用自动战斗功能
	SkillPriority	Normal>Skill>Burst	根据角色调整	技能释放优先级设置

配置修改注意事项

🔍 配置调整建议：

• 备份配置：在修改配置前，建议备份当前配置文件，以便出现问题时可以快速恢复。
• 逐步调整：每次只修改少数几个参数，测试效果后再进行下一步调整，避免因多个参数同时变动而难以定位问题。
• 注意兼容性：某些高级配置可能对系统环境有特定要求，如Graphics捕获模式需要较新的显卡驱动支持。
• 重启生效：大部分配置修改后需要重启程序才能生效，请记住在修改配置后重启BetterGI。

🛠️ 进阶阶段：释放自动化全部潜力

高级功能探索

BetterGI提供了许多高级功能，让你可以根据自己的游戏习惯进行深度定制：

• 宏录制：使用MacroConfig模块录制复杂的操作序列，实现一键执行多步操作。
• 任务调度：通过配置文件中的NextScheduledTask设置，可以安排自动化任务在特定时间执行。
• 多账号管理：配合脚本功能，可以实现多账号的自动切换和任务执行。

自定义脚本开发

对于有编程基础的用户，BetterGI支持通过脚本扩展功能：

1. 在ScriptConfig中启用自定义脚本支持。
2. 在指定目录下创建C#脚本文件。
3. 使用提供的API编写自定义自动化逻辑。
4. 在程序中加载并启用你的自定义脚本。

🧩 常见问题解决

启动问题

• 程序无法启动：检查是否安装了.NET运行时，可从微软官网下载最新版本。
• 游戏无法识别：确认游戏路径设置正确，游戏版本与BetterGI兼容。尝试以管理员身份运行程序。
• 捕获黑屏：尝试切换不同的CaptureMode，更新显卡驱动，或检查游戏是否运行在全屏模式下。

功能问题

• 自动钓鱼失效：检查游戏内是否处于正确的钓鱼位置，是否启用了游戏内的钓鱼功能。尝试调整游戏画质设置，降低抗锯齿等级。
• 拾取功能不工作：确认Enable参数为true，检查游戏内是否关闭了自动拾取功能（部分玩家可能手动关闭了游戏内的自动拾取）。
• 快捷键冲突：进入HotKeyConfig检查是否有快捷键与其他程序冲突，尝试修改冲突的快捷键。

性能问题

• 程序卡顿：尝试增大TriggerInterval值，降低捕获频率，或切换到更轻量级的CaptureMode。
• 高CPU占用：关闭DetailedErrorLogs，检查是否有多个自动化任务同时运行，尝试关闭暂时不需要的功能。

如果遇到其他问题，可以查看项目文档或在社区寻求帮助。BetterGI的开发团队和活跃用户会尽力为你提供支持。

祝你使用愉快，愿BetterGI为你的原神之旅带来更多便利和乐趣！