基于ShellBoost开发Windows Files On-Demand应用右键菜单适配问题咨询

我们计划开发一款类似Windows平台OneDrive的应用，实现云端存储文件列表同步及选中文件的按需同步功能。
在技术调研过程中，我们找到了一款可通过C#实现Windows On-Demand Files管理的优质库：ShellBoost。

云端文件映射为本地文件展示 #

在本地文件夹中展示按需文件列表：（file-list 示例图）
将包含文件的文件夹作为Namespace extension展示：（file-list-ext 示例图）
借助ShellBoost我们可以实现十分灵活的文件同步能力，支持同步状态展示、所有常规文件操作，还可按需新增同步项或移除已同步项。但我们在开发过程中遇到了如下限制：

文件右键菜单项适配问题 #

我们无法为未同步的文件添加自定义操作：目前我们使用SharpShell为文件添加额外右键菜单项，该方案在已同步文件上可正常生效：（已同步文件右键菜单示例图）
但在未同步文件上无法生效：（未同步文件右键菜单示例图）

OneDrive支持自定义右键菜单项 #

OneDrive可以正常为按需文件添加自定义右键菜单项：（OneDrive右键菜单示例图）

PowerToys可添加自定义右键菜单项 #

PowerToys也可以正常为我们的未同步按需文件添加自定义右键菜单项：（PowerToys右键菜单示例图）

示例代码 #

相关示例代码已上传至公开代码仓库。
请问该问题应如何排查解决？

排查与解决方案 #

1 校验SharpShell关联范围匹配问题

未同步的按需文件属于Shell Namespace Extension虚拟项，不是本地物理文件系统节点，默认SharpShell的文件上下文菜单扩展仅关联物理文件系统的ProgID，需调整扩展的关联配置：

• 打开自定义右键菜单类的特性声明，将AssociationType修改为AllFiles，同时追加AssociatedExtensions = "*"，额外添加对应ShellBoost虚拟项类标识的关联规则
• 注册扩展时需匹配资源管理器位数，64位系统使用64位模式注册，避免位数不兼容导致扩展不加载

2 优先使用ShellBoost原生右键菜单能力

ShellBoost本身内置上下文菜单扩展接口，无需额外依赖第三方库，对虚拟文件的兼容性更好：
在你的ShellBoost项目的ShellFolder类中重写GetContextMenuItems方法，直接添加自定义菜单项并绑定点击事件处理逻辑即可，该方法对同步/未同步的所有虚拟文件项都会生效，核心示例代码如下：

protected override IEnumerable<ShellMenuItem> GetContextMenuItems(ShellItem[] selectedItems)
{
    var syncMenuItem = new ShellMenuItem("立即同步该文件");
    syncMenuItem.Click += (sender, args) => 
    {
        // 编写选中文件的同步触发逻辑
    };
    // 合并自定义菜单项与系统默认菜单项
    return new[] { syncMenuItem }.Concat(base.GetContextMenuItems(selectedItems));
}

3 调整虚拟文件属性标记

如果需要继续使用SharpShell方案，需确认未同步的虚拟文件设置了正确的属性掩码，告知资源管理器该虚拟项兼容常规文件的扩展处理逻辑：
给未同步的ShellItem添加SFGAO_FILESYSTEM、SFGAO_HASPROPSHEET、SFGAO_CANCOPY属性标记，确保资源管理器会为这类虚拟项加载已注册的第三方上下文菜单扩展。

内容的提问来源于stack exchange，提问作者Adrian