NonSteamLaunchers-On-Steam-Deck 项目安装问题分析与解决方案

问题背景

在Steam Deck上使用NonSteamLaunchers-On-Steam-Deck项目安装第三方游戏平台启动器时，部分用户遇到了安装后启动器无法正常添加至Steam库的问题。具体表现为安装完成后，Epic Games启动器无法启动，而EA App和Rockstar Games Launcher虽然可以初次启动，但关闭后无法再次启动，因为它们并未被正确添加到Steam库中。

错误分析

通过查看安装日志，可以发现系统抛出了一个关键错误：

FileNotFoundError: [Errno 2] No such file or directory: '/home/deck/.steam/root/userdata//config/shortcuts.vdf'

这个错误表明程序在尝试访问Steam的快捷方式配置文件时失败，原因是无法正确获取用户的Steam ID。路径中的userdata目录后为空，说明程序未能成功解析出用户的Steam ID。

技术原理

在Steam Deck系统中，每个用户的游戏快捷方式都存储在特定路径下的shortcuts.vdf文件中。这个文件的路径结构通常为：

/home/[用户名]/.steam/root/userdata/[SteamID]/config/shortcuts.vdf

当NonSteamLaunchers尝试将新安装的启动器添加到Steam库时，需要先找到这个文件，然后修改它以添加新的快捷方式。如果程序无法正确获取SteamID，就无法定位到正确的配置文件，从而导致添加失败。

解决方案

项目维护者已经确认这是一个语法错误导致的Steam ID获取问题，并在后续版本中修复了这个问题。对于遇到此问题的用户，可以采取以下步骤：

1. 确保使用的是最新版本的NonSteamLaunchers-On-Steam-Deck
2. 如果问题仍然存在，可以尝试以下手动解决方案：
   • 检查/home/deck/.steam/root/userdata/目录下是否存在以数字命名的文件夹
   • 确认该数字文件夹下的config/shortcuts.vdf文件是否存在
   • 如果路径结构不同，可能需要手动调整程序中的路径解析逻辑

验证结果

多位用户反馈在更新到修复版本后，问题得到解决：

• 新安装的启动器现在能够正确出现在Steam库中
• Epic Games启动器可以正常启动
• 所有添加的启动器在关闭后可以重新从Steam库启动

总结

这个案例展示了在Steam Deck上自动化添加非Steam游戏启动器时可能遇到的路径解析问题。通过理解Steam系统的配置文件结构和位置，开发者能够快速定位并修复问题。对于终端用户来说，保持软件更新是解决此类问题的最佳实践。