BetterGI自动拾取按键自定义功能的技术解析与修复方案

问题背景

在BetterGI（Better Genshin Impact）0.43.0版本中，用户反馈按照官方文档指引修改自动拾取按键时遇到功能失效的问题。具体表现为：当用户尝试通过修改配置文件将拾取键从默认的F键改为G键时，修改无法生效，且在软件重启后配置会被自动覆盖。

技术分析

配置加载机制分析

BetterGI的自动拾取功能按键配置存储在User/config.json文件中，关键字段为"pickkey"。理论上，用户只需修改此字段并准备相应的按键图像资源即可实现按键自定义。

然而，实际运行中存在两个关键问题：

1. 配置覆盖机制：软件在启动时会读取UI界面中的默认值（仅包含F和E两个选项），并强制覆盖config.json中的自定义设置。这种设计导致用户手动修改的配置无法持久化。

2. UI限制：触发设置页面(TriggerSettingsPage.xaml)中引用了DefaultPickButtonNames集合，该集合仅预定义了F和E两个选项，缺乏扩展性，导致其他按键值无法被正确处理。

解决方案

代码层面修复

修复方案主要涉及以下修改点：

1. 移除强制覆盖逻辑：取消启动时对pickkey字段的强制覆盖，优先使用用户自定义配置。

2. 扩展UI兼容性：修改触发设置页面逻辑，使其能够接受并显示非默认(F/E)的按键值，同时保持对这些自定义值的持久化支持。

用户操作指南

经过修复后，用户可按以下步骤正确自定义自动拾取按键：

1. 修改User/config.json文件中的"pickkey"字段为所需按键（如G）
2. 准备对应的按键图像资源（如G.png），存放在GameTask/AutoPick/Assets/对应分辨率目录下
3. 确保游戏内设置与配置文件使用相同的交互按键
4. 重启BetterGI使配置生效

技术启示

此案例揭示了软件开发中几个值得注意的设计原则：

1. 配置持久化：应尊重用户手动修改的配置文件，避免程序自动覆盖用户自定义设置。

2. UI与逻辑解耦：界面显示选项不应限制实际功能的灵活性，应设计可扩展的配置系统。

3. 版本兼容性：新增功能时需考虑对现有用户工作流程的影响，本例中新增的配置保存功能意外破坏了原有的自定义机制。

结语

BetterGI开发团队快速响应并修复了此问题，展现了良好的开源项目管理能力。对于用户而言，理解软件配置机制有助于更高效地使用各种自定义功能。此次修复也提醒开发者，在增加新特性时需要全面考虑其对现有功能的影响，确保用户体验的一致性。