ComfyUI-Custom-Scripts中缩略图显示问题的分析与解决方案

问题现象描述

近期，许多ComfyUI-Custom-Scripts用户报告了一个共同的问题：在模型加载器节点（包括Checkpoint加载器和Lora加载器）中，原本应该显示的缩略图预览突然无法正常展示。这个问题表现为：

1. 在鼠标悬停于模型选项上时，不再显示对应的预览图像
2. 问题出现具有随机性，有时工作正常，有时则完全失效
3. 重新安装ComfyUI后可能暂时恢复，但问题会再次出现

问题根源分析

经过社区成员的深入调查和测试，确认该问题与ComfyUI前端版本更新有关。具体表现为：

1. 前端版本兼容性问题：ComfyUI_frontend在v1.5.19之后的版本中引入了界面改进（如下拉列表滚动速度调整、滚动条添加等），这些改动意外影响了缩略图预览功能的正常工作。

2. 版本更新机制：通过ComfyUI管理器进行更新后，系统会自动获取最新版本的前端代码，这可能导致缩略图功能失效。

3. 功能依赖关系：缩略图预览功能依赖于前端代码对图像预览事件的处理逻辑，当这部分代码被修改后，自定义脚本中的预览功能就会受到影响。

解决方案

方法一：降级前端版本（推荐）

1. 下载ComfyUI_frontend v1.5.19版本的压缩包
2. 解压后将其中的文件替换ComfyUI安装目录下web文件夹中的内容
3. 刷新浏览器页面（无需重启ComfyUI服务）

注意：此方法不会影响其他功能，仅回退前端界面到稳定版本。

方法二：使用稳定版本更新脚本

对于便携版用户：

1. 关闭ComfyUI
2. 导航至ComfyUI安装目录下的update文件夹
3. 运行update_comfyui_stable.bat脚本
4. 这将自动将ComfyUI回退到最后一个标记为稳定的版本

长期解决方案建议

1. 开发者应关注ComfyUI官方的前端更新日志，及时调整自定义脚本以适应新版本
2. 用户可暂时固定使用v1.5.19前端版本，等待官方修复此兼容性问题
3. 考虑在自定义脚本中添加版本检测逻辑，当检测到不兼容的前端版本时给出明确提示

技术细节补充

1. 缩略图工作机制：当用户在模型选择器中悬停时，系统会查找与模型同名的图片文件（如model.safetensors对应model.png）并显示预览。

2. 版本影响范围：此问题不仅影响Lora加载器，也影响标准Checkpoint加载器，说明是核心预览机制受到影响。

3. 子文件夹支持：值得注意的是，Pythongosss的Lora加载器因其子文件夹支持功能而备受用户青睐，这使得缩略图预览功能对工作流程尤为重要。

用户操作建议

1. 在进行任何修改前，建议备份现有web文件夹
2. 如果使用版本控制工具（如git），可在修改前创建分支以便回退
3. 关注ComfyUI-Custom-Scripts项目的更新，等待官方发布永久修复方案

通过以上方法，用户可以在保持系统稳定的同时，继续享受模型缩略图预览带来的工作便利。这个问题也提醒我们，在AI工作流工具链中，各组件版本间的兼容性管理至关重要。