Explorer Thumbnail Repair

一个安全重建 Windows 10/11 当前用户图标与缩略图缓存的单文件工具，主要用于修复文件夹缩略图黑底、空白、错乱或长时间不刷新。

本工具修复的是缓存损坏。若第三方缩略图处理器持续生成异常预览，问题可能再次出现。

下载与使用

下载 ExplorerThumbnailRepair.bat，双击运行：

1. 先选择 Diagnose only 查看缓存状态；
2. 选择 Repair caches 执行推荐修复；
3. 修复时 Windows 资源管理器会短暂关闭并自动恢复；
4. 图标和缩略图会在重新打开文件夹后逐步生成。

运行前请先完成正在进行的文件复制、移动或重命名操作。

命令行

ExplorerThumbnailRepair.bat diagnose
ExplorerThumbnailRepair.bat repair
ExplorerThumbnailRepair.bat repair "D:\Documents"
ExplorerThumbnailRepair.bat self-test
ExplorerThumbnailRepair.bat help

默认只修复当前登录用户，不要求管理员权限。

它会做什么

• 使用 Windows Known Folder API 定位 %LOCALAPPDATA%；
• 只停止当前登录会话中的 explorer.exe；
• 只删除以下可自动重建的缓存数据库：
  • %LOCALAPPDATA%\IconCache.db
  • %LOCALAPPDATA%\Microsoft\Windows\Explorer\iconcache*.db
  • %LOCALAPPDATA%\Microsoft\Windows\Explorer\thumbcache*.db
• 无论修复成功与否都尝试恢复 Explorer；
• 验证 Windows 是否重新生成缓存；
• 将日志写入 %LOCALAPPDATA%\ExplorerThumbnailRepair\Logs。

它不会做什么

• 不清空回收站；
• 不删除下载、文档、桌面或临时资料；
• 不删除缓存备份文件、其他 .db 文件或子目录内容；
• 不结束其他登录用户或 RDP 会话的 Explorer；
• 不修改注册表、组策略或文件关联；
• 不上传日志或任何用户数据。

为什么比常见 BAT 更安全

常见脚本会使用 taskkill /f /im explorer.exe 和通配符递归删除，有些还会清空 $Recycle.Bin。本工具增加了：

• 已知目录和父路径严格校验；
• reparse point / junction 拒绝机制；
• 精确缓存文件名匹配；
• 当前会话进程隔离；
• try/finally Explorer 恢复；
• 重试、日志、退出码和重建验证；
• 不触碰回收站及用户资料。

自检

self-test 会在系统临时目录创建隔离的模拟缓存结构，验证目标缓存会被删除、备份和无关文件会被保留。它不会停止 Explorer，也不会触碰真实缓存。

ExplorerThumbnailRepair.bat self-test

退出码

代码	含义
0	完成
2	用户取消
7	缓存删除不完整
8	Explorer 恢复失败
9	修复完成，但暂未观察到新缓存
10	参数错误
20	未处理异常或安全检查失败

故障恢复

如果资源管理器未恢复：

1. 按 Ctrl + Shift + Esc 打开任务管理器；
2. 选择“运行新任务”；
3. 输入 explorer.exe 并确定。

如果黑底反复出现，请检查 Icaros、K-Lite Codec Pack 或其他第三方缩略图/编解码组件，并在 Issue 中附上脱敏后的日志。

支持范围

• Windows 10 64 位
• Windows 11 64 位
• Windows PowerShell 5.1（系统自带）

安全与隐私

请阅读 SECURITY.md。日志默认只包含系统版本、会话、缓存文件名和执行结果；项目不会自动联网或上传数据。

许可证

MIT License