DLSS Swapper项目中的游戏列表动态过滤问题分析与解决方案

问题背景

在DLSS Swapper项目中，用户报告了一个关于游戏列表动态更新的问题：当程序扫描到新游戏或手动添加游戏时，这些游戏不会立即显示在列表中，必须重启应用程序才能看到。特别是在启用"隐藏无可交换项的游戏"过滤选项时，问题表现得尤为明显。

问题现象深度分析

该问题表现为以下几个典型特征：

1. 新添加的游戏在初始扫描后不会立即显示
2. 尝试手动添加已存在但未显示的游戏会提示"游戏已存在"错误
3. 重启应用后所有游戏都能正常显示
4. 问题仅在启用"隐藏无可交换项的游戏"过滤选项时出现

技术原理探究

游戏列表的加载流程

DLSS Swapper的游戏列表加载遵循以下流程：

1. 扫描系统发现游戏
2. 创建Game对象实例
3. 将游戏添加到_allGames集合
4. 应用过滤条件显示符合条件的游戏
5. 后台继续处理游戏文件扫描以确定是否有可交换的DLSS文件

过滤机制工作原理

游戏列表使用AdvancedCollectionView实现动态过滤，其核心过滤逻辑如下：

private Predicate<object> GetPredicateForAllGames(bool hideNonDLSSGames, string? filterText = null)
{
    return (obj) =>
    {
        var game = (Game)obj;
        bool matchesText = string.IsNullOrEmpty(filterText) || game.Title.Contains(filterText, StringComparison.OrdinalIgnoreCase);
        return (!hideNonDLSSGames || game.HasSwappableItems) && matchesText;
    };
}

问题根源定位

经过深入分析，发现问题源于以下技术细节：

1. 属性变更通知缺失：当游戏的后台扫描完成后，HasSwappableItems属性被更新，但AdvancedCollectionView未收到属性变更通知

2. 过滤观察配置不完整：虽然配置了观察IsFavourite属性变更，但未配置观察HasSwappableItems属性变更

3. 时序问题：游戏被添加到集合和初始过滤发生在扫描完成前，此时HasSwappableItems为false，导致被过滤掉

解决方案实现

核心修复方案

1. 确保属性可观察： 在Game类中确保HasSwappableItems属性实现了INotifyPropertyChanged接口，以便在值变更时发出通知

2. 配置过滤观察： 在所有使用到HasSwappableItems过滤条件的AdvancedCollectionView实例中添加属性变更观察

AllGamesView.ObserveFilterProperty(nameof(Game.HasSwappableItems));
FavouriteGamesView.ObserveFilterProperty(nameof(Game.HasSwappableItems));
// 对其他视图也进行相同配置

解决方案原理

该方案通过以下机制解决问题：

1. 当后台扫描完成并设置HasSwappableItems为true时，会触发PropertyChanged事件
2. AdvancedCollectionView收到属性变更通知后，自动重新评估过滤条件
3. 重新评估后，符合条件的游戏会自动显示在列表中
4. 整个过程无需用户干预或重启应用

额外问题处理

在实现核心修复后，还发现了一个相关的问题：

当尝试自动滚动到新添加的游戏项时，如果该项仍被过滤掉，会导致程序崩溃。这需要额外的边界条件处理，确保只在项可见时执行滚动操作。

技术总结

这个问题展示了在WPF/MVVM应用中处理动态过滤时的几个重要技术点：

1. 属性变更通知：在MVVM模式中，确保UI能响应数据变更的关键机制
2. 集合视图过滤：AdvancedCollectionView等高级集合视图的动态过滤能力
3. 异步操作时序：后台操作与UI更新的正确时序处理
4. 观察者模式应用：通过ObserveFilterProperty建立属性与视图间的观察关系

通过这个案例，开发者可以更好地理解WPF/MVVM应用中动态数据过滤的实现原理和常见问题解决方法。