NonSteamLaunchers-On-Steam-Deck项目：解决GOG游戏无法自动导入Steam库的问题

问题背景

在Steam Deck上通过NonSteamLaunchers项目安装GOG平台后，部分用户发现从GOG客户端下载的游戏（如《博德之门3》）无法像Epic游戏那样自动添加到Steam库中。虽然GOG启动器本身可以正常运行，但游戏扫描功能似乎存在异常。

技术分析

该问题涉及两个层面的机制：

1. NonSteamLaunchers的自动扫描服务
   项目通过systemd服务nslgamescanner.service实时监控游戏安装目录。正常情况下，当用户在GOG Galaxy客户端安装游戏后，该服务会自动检测并创建对应的Steam快捷方式。

2. Boilr工具的兼容性问题
   第三方工具Boilr的Linux版本目前对GOG游戏路径的识别存在局限，这与其扫描逻辑和GOG Linux客户端的特殊文件结构有关。但值得注意的是，Boilr的功能与NonSteamLaunchers的核心扫描服务是相互独立的。

解决方案

经过开发者排查，发现问题源于游戏图标下载路径的权限设置。通过以下步骤可彻底解决：

1. 手动执行扫描服务诊断
   访问路径/home/deck/.config/systemd/user/NSLGameScanner.py，右键将其属性设为"可执行"，然后通过Konsole终端运行。这将实时显示扫描日志，帮助确认具体错误。

2. 应用热修复更新
   开发者已推送针对图标存储路径的修复补丁。用户需：

   • 在NonSteamLaunchers界面点击"StopScanner"按钮
   • 重新启动扫描服务
   • 系统将自动创建正确的/grid/目录结构并完成游戏导入

补充说明

对于技术爱好者，还需注意：

• GOG游戏的默认安装路径位于Steam的兼容层目录（Proton前缀）内，路径结构为.../NonSteamLaunchers/pfx/drive_c/Program Files (x86)/GOG Galaxy/Games
• 系统级扫描服务比第三方工具更可靠，建议优先依赖内置的自动扫描机制
• 若后续新增游戏未被识别，可尝试重启扫描服务或检查游戏安装路径权限

结语

该案例展示了Steam Deck第三方启动器集成方案的自我修复能力。通过日志分析和快速响应，开发者完善了自动化游戏管理的闭环流程，为用户提供了更稳定的跨平台游戏体验。