NonSteamLaunchers插件Ubisoft Connect重复安装问题分析

问题现象

在Steam Deck游戏模式下使用NonSteamLaunchers插件安装Ubisoft Connect时，出现了异常情况：安装过程看似正常完成，但系统会持续不断地重复添加Ubisoft Connect的非Steam快捷方式。用户不得不通过重启系统来终止这一过程，并手动删除大量重复创建的游戏快捷方式。

问题复现

该问题不仅出现在Ubisoft Connect的安装过程中，在尝试安装Amazon Games时也出现了类似现象。具体表现为：

1. 安装流程开始正常执行
2. 安装完成后系统不断重复添加快捷方式
3. 快捷方式数量持续增加
4. 只有系统重启才能终止该过程

环境信息

出现问题的运行环境具有以下特点：

• Steam Deck系统版本：3.6.9（Beta通道）
• Decky Loader版本：v3.0.0-pre9（预发布版）
• 安装的其他插件：SteamGridDB 1.4.0-030f9a1
• 运行模式：游戏模式下的插件版本

临时解决方案

在开发者修复该问题前，用户可以采取以下临时措施：

1. 将游戏扫描器设置为手动模式（避免自动扫描导致的重复添加）
2. 通过系统重启终止重复添加过程
3. 手动删除多余的非Steam快捷方式

问题排查建议

如果遇到类似问题，建议用户：

1. 检查并记录安装日志（位于桌面模式的下载文件夹中）
2. 尝试完全卸载并重新安装NonSteamLaunchers插件
3. 注意在重新安装插件时不要选择"全新开始"选项，以免丢失已安装的启动器和游戏

开发者响应

项目维护者已确认该问题，并在后续版本中增加了冷却系统来防止手动扫描时的重复添加。建议用户关注插件更新，及时获取修复版本。

技术背景

这类重复添加快捷方式的问题通常与以下因素有关：

1. 游戏扫描器的触发机制异常
2. 安装完成后的回调函数重复执行
3. 系统事件监听未正确解除
4. 在多线程环境下可能出现的状态同步问题

对于Steam Deck这类基于Linux的系统，非Steam游戏的添加快捷方式涉及较复杂的进程间通信和权限管理，任何环节出现问题都可能导致类似现象。