FileSyncShell.dll：Windows 云同步的 Shell 桥接组件

FileSyncShell.dll 是部署于系统目录（%SystemRoot%\System32）的 Shell 扩展模块，由 OneDrive 同步引擎注册并由资源管理器按需加载。它以 COM 服务器形式暴露多个处理程序接口，承担同步状态可视化、按需文件交互与同步指令下发等职责，是 Explorer 与云同步服务之间的关键连接层。

一、核心功能

• 同步状态图标叠加（Icon Overlay Handler）：为已同步、正在同步、仅联机可用等状态的文件绘制角标，并在增量扫描期间驱动视图刷新，使用户在文件列表中直接读取同步进度。
• 上下文菜单扩展（Context Menu Handler）：向文件与文件夹右键菜单注入“始终保留在此设备上”“释放空间”“联机查看”“复制链接”等命令项，并将用户操作转换为同步引擎可解析的请求。
• 按需文件（Files On-Demand）支撑：解析并呈现占位符文件的重解析点（Reparse Point）与稀疏属性，区分本地实体数据与云端元数据，使资源管理器无需实际下载即可展示大小、时间戳与缩略图。
• Shell 通知列与属性扩展：以 ColumnProvider 形式提供“状态”“可用性”等自定义列，并通过属性处理程序在详细信息窗格中输出同步信息。
• 与同步进程通信：通过命名管道与 COM 调用同 FileSyncHelper.exe、OneDrive.exe 交互，回传句柄级操作结果，并借助 SHChangeNotify 通知 Shell 刷新视图。

二、缺少该 DLL 的典型影响

• 状态角标消失：目录内所有文件不再显示同步图标，用户无法判断哪些内容已真正落盘。
• 右键菜单缺项：无法执行“释放空间”“始终保留在此设备上”，按需文件策略实质上失效。
• 资源管理器报错：启动 Explorer 或进入被同步目录时提示找不到 FileSyncShell.dll，模块加载失败并写入事件日志（SideBySide、应用程序错误）。
• 联机文件不可用：占位符无法正确解析，文件表现为 0 字节、无法打开或提示已损坏。
• 同步状态与实际脱节：客户端仍在后台同步，但 Shell 层无任何反馈，易造成重复下载或误删。
• 反复弹窗与卡顿：注册表 CLSID 残留引用使每次右键或刷新都触发错误弹窗，资源管理器响应变慢。
• 卸载残留问题：仅删除 OneDrive 客户端而未清理 Shell 扩展注册项时，缺文件报错会长期存在。

三、常见触发场景

安全软件或清理工具误删、DLL 被隔离、OneDrive 客户端更新不完整、系统还原或镜像恢复后文件版本不匹配，均可能造成该模块缺失或被错误版本覆盖。