NonSteamLaunchers-On-Steam-Deck 安装器故障排查指南

问题现象分析

在使用 NonSteamLaunchers-On-Steam-Deck 项目时，用户可能会遇到安装器在成功安装几个启动器后突然停止工作的情况。具体表现为：

1. 新安装的启动器无法正常运行，启动后几秒内自动关闭
2. 安装器界面不再显示已安装启动器的路径信息
3. 后续尝试安装任何启动器都会失败

根本原因

通过日志分析，发现问题主要源于以下两个方面：

1. 兼容数据文件夹损坏：Steam的compatdata目录中存在损坏的符号链接或无效文件
2. Proton运行环境异常：Proton GE版本可能存在某些配置问题

解决方案

第一步：检查并修复compatdata目录

1. 导航至Steam的compatdata目录：

   ~/.local/share/Steam/steamapps/compatdata/
   

2. 查找并删除所有损坏的符号链接：

   find -L . -type l -delete
   

3. 特别检查NonSteamLaunchers目录下的文件完整性

第二步：更新Proton GE

1. 完全卸载当前安装的Proton GE版本
2. 从官方渠道下载最新版本的Proton GE
3. 重新安装并确保安装路径正确

第三步：清理并重试

1. 删除安装器生成的旧日志文件
2. 重新启动Steam Deck
3. 再次尝试安装启动器

预防措施

1. 定期维护：建议定期检查compatdata目录的健康状态
2. 版本更新：保持Proton GE和NonSteamLaunchers安装器为最新版本
3. 安装顺序：避免短时间内连续安装多个启动器，给系统足够的处理时间

技术细节说明

当安装器工作时，它会尝试在Proton环境中修改Windows注册表项。失败日志中显示的关键错误是：

FileNotFoundError: [Errno 2] No such file or directory: '/home/deck/.local/share/Steam/steamapps/compatdata/NonSteamLaunchers/pfx.lock'

这表明Proton无法正确访问或创建必要的锁文件，通常是由于：

• 文件权限问题
• 目录结构损坏
• Proton环境配置错误

通过上述解决方案，大多数情况下可以恢复安装器的正常功能。如果问题仍然存在，建议检查系统日志获取更详细的错误信息。