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

问题背景

在Steam Deck上安装非Steam游戏平台时，用户遇到了安装程序运行后无法正确添加游戏启动器的问题。具体表现为：通过桌面文件启动安装程序，选择Rockstar Social Club、PS Plus和Ubisoft Connect等平台后，虽然能看到下载进度条和Steam重启过程，但最终这些平台并未出现在非Steam游戏列表中。

问题分析

经过开发者调查，发现该问题主要与以下几个技术因素有关：

1. 浏览器依赖问题：部分用户反馈在移除系统自带的Firefox浏览器并安装Chromium后，问题得到解决。这表明安装过程中可能依赖特定的浏览器组件。

2. Google Chrome安装逻辑冲突：开发者确认脚本中Google Chrome的安装代码逻辑存在问题，会意外阻止其他启动器的正常安装。

3. 控制器配置兼容性：虽然不属于安装问题本身，但后续使用时出现的鼠标控制问题也与平台兼容性相关。

解决方案

针对上述问题，开发者提供了以下解决方案：

1. 使用3.7版本的安装脚本：在代码重构期间，建议暂时回退到更稳定的3.7版本脚本进行安装。

2. 浏览器环境调整：

   • 移除系统自带的Firefox浏览器
   • 安装Chromium或兼容的浏览器环境
   • 注意：Brave或Ungoogled Chromium等基于Chromium的浏览器也可作为替代方案

3. 等待版本更新：开发者确认将在后续版本中修复Google Chrome安装逻辑的冲突问题。

4. 控制器配置建议：对于安装后出现的鼠标控制问题，可以：

   • 使用Steam控制器设置中的"Web Browser"模板
   • 等待项目后续更新更完善的控制器配置方案

最佳实践

1. 安装前准备：

   • 确保系统环境干净，移除可能冲突的浏览器组件
   • 下载最新稳定版本的安装脚本

2. 安装过程：

   • 一次只安装一个平台，确认功能正常后再添加其他平台
   • 监控安装日志，及时发现问题

3. 问题排查：

   • 检查下载文件夹中的安装日志文件
   • 确认Steam客户端是否完全重启
   • 验证游戏平台是否确实下载完成

项目现状

目前该项目已发布3.8.7版本，解决了大部分安装问题。对于仍遇到困难的用户，建议：

1. 完全清除旧版本残留文件
2. 通过Decky插件进行全新安装
3. 按照开发者建议配置控制器

随着项目持续更新，预计将提供更稳定的一键安装体验和更完善的游戏平台兼容性支持。