issue: [regression] [dev] a folder icon picked on the folder page does not show in the sidebar until a reload

在 Open WebUI 开发版中,从文件夹自己的页面修改文件夹图标后,图标会立即保存并显示在该页面和文件夹标签上,但侧边栏中的文件夹行要刷新页面后才更新。这属于文件夹页面与侧边栏之间的状态同步回归,优先排查文件夹页在保存图标后是否触发侧边栏数据更新。

快速结论:在 Open WebUI 开发版中,从文件夹自己的页面修改文件夹图标后,图标会立即保存并显示在该页面和文件夹标签上,但侧边栏中的文件夹行要刷新页面后才更新。这属于文件夹页面与侧边栏之间的状态同步回归,优先排查文件夹页在保存图标后是否触发侧边栏数据更新。

适用环境:Open WebUI 开发版(dev);Issue 确认出现问题的提交为 4acf39ec2,正常版本为 3bfc168d6,问题由文件夹页面重构提交 06491f013 引入。Issue 未提供操作系统、Python、CUDA、显卡或依赖版本信息。

最快修复方案:暂无确认的一步修复方案。Issue 中未给出已验证的修复提交或临时规避方法。

注意事项:刷新页面后图标能正常显示,说明图标已经持久化存储,问题只影响侧边栏的即时刷新。若通过回退或替换版本规避,建议先确认目标版本不包含文件夹页面重构,并注意测试仓库的 e2e 用例可能依赖具体提交。

问题场景

用户在使用 Open WebUI 的文件夹功能时,先从侧边栏创建一个文件夹并打开其文件夹页面,同时保持侧边栏的 Folders 区域展开。之后在文件夹页面点击“Change folder icon”并选择任意 emoji 图标,预期侧边栏中该文件夹行立即显示新图标,但实际侧边栏仍显示默认文件夹图标,约 10 秒后仍未更新,只有重新加载页面后才显示新图标。该问题在浏览器端 e2e 测试 e2e/chat/test_folder_projects.py::test_a_folders_icon_and_background_image_show_and_are_stored 中被捕获。

报错原文

issue: [regression] [dev] a folder icon picked on the folder page does not show in the sidebar until a reload

The sidebar row still shows the plain folder 10 seconds later. The icon only appears after a reload, so it was stored.

原因分析

可能原因:文件夹页面在保存图标后更新了文件夹页面自身及其标签页状态,但没有同步更新侧边栏所依赖的文件夹列表状态;侧边栏在重新挂载或重新加载数据前,仍使用旧的文件夹数据。Issue 指出问题由文件夹页面重构提交 06491f013 引入,且已有相关 Issue #28690 报告过同一底层问题:从文件夹页面重命名文件夹、修改图标或创建子文件夹时,侧边栏不会更新。

环境排查

  • 确认 Open WebUI 版本或提交号:问题提交为 4acf39ec2,正常提交为 3bfc168d6,疑似引入提交为 06491f013。
  • 确认部署方式是否为 dev 构建,以及是否包含文件夹页面重构相关代码。
  • 在浏览器中保持侧边栏 Folders 区域展开,以便观察修改文件夹图标后的即时状态。
  • Issue 未提供 Python、CUDA、PyTorch、显卡及节点版本,这些环境项无需作为本次问题的首要排查方向。

解决步骤

  1. 先复现问题:创建文件夹并打开文件夹页面,保持侧边栏展开,在文件夹页面修改图标,观察侧边栏是否立即更新。
  2. 刷新页面,确认侧边栏是否显示新图标。如果刷新后显示,说明图标已保存,问题属于侧边栏状态未同步。
  3. 对照提交号:若当前为 4acf39ec2,可确认处于问题版本;3bfc168d6 下该行为正常。
  4. 检查 06491f013 中文件夹页面保存图标后的状态更新逻辑,以及侧边栏文件夹列表的数据来源,确认保存后是否触发侧边栏重新获取或更新文件夹数据。
  5. 可优先尝试的一种处理方向:在保存文件夹图标成功后,同步刷新或更新侧边栏使用的文件夹列表状态。该方向基于问题现象推断,Issue 中未给出已验证的代码修复。
  6. 如短期内无法修复,可先接受刷新页面作为临时规避手段,但这不解决回归问题本身。

验证方法

在文件夹页面修改图标后,不刷新页面,直接观察侧边栏中该文件夹行是否立即显示新图标;同时可运行或关注 e2e 用例 test_a_folders_icon_and_background_image_show_and_are_stored,确认其通过。还可对比 3bfc168d6 与修复后的版本,验证侧边栏即时更新行为一致。

参考来源

open-webui/open-webui #34374

相关 Issue:open-webui/open-webui #28690

GamsGo AI

AI 工具推荐

想把多个 AI 模型放在一个入口?

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。

这个方案解决了吗?

celebrityanime
celebrityanime
文章: 35340

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注