issue: When open-terminal is connected, the “Files” side panel keeps re-opening on page reload

用户在 Open WebUI(Docker 部署,版本 v0.10.2)中启用 Terminal(Open Terminal)功能。当 "Controls/Files" 侧面板被手动关闭后,执行页面刷新(F5 或浏览器重载)时,该侧面板会自动弹出并显示 "Files" 选项卡。关闭 Terminal

issue: When open-terminal is connected, the "Files" side panel keeps re-opening on page reload

issue: When open-terminal is connected, the “Files” side panel keeps re-opening on page reload

快速结论:此问题发生于 Open WebUI v0.10.2 中启用 “Terminal”(Open Terminal)功能时。用户手动关闭 “Controls/Files” 侧面板后,页面刷新会导致该面板自动重新打开并显示 “Files” 选项卡。开发者已确认这是预期行为,可通过界面设置中的选项默认隐藏文件侧面板。

问题场景

用户在 Open WebUI(Docker 部署,版本 v0.10.2)中启用 Terminal(Open Terminal)功能。当 “Controls/Files” 侧面板被手动关闭后,执行页面刷新(F5 或浏览器重载)时,该侧面板会自动弹出并显示 “Files” 选项卡。关闭 Terminal 功能后刷新,此问题不再复现。浏览器为 Firefox 152.0,操作系统为 Fedora 44。

报错原文

When open-terminal is enabled, the 'Controls/Files' side panel will re-open on every page reload

原因分析

根据 Issue 讨论,此行为被标记为 预期行为(Intended behaviour),并非软件缺陷。当 Open Terminal 功能连接时,系统会在侧面板中显示与终端集成的文件系统 (“Files” tab)。页面刷新时,为了维持 Terminal 功能的可见性和可访问性,侧面板会被强制重新打开,以确保用户能看到与终端关联的文件状态。开发者建议用户可以通过界面设置中的选项,默认隐藏文件侧面板,以绕过此行为。

环境排查

  • Open WebUI 版本:v0.10.2(请确认是否仍使用该版本或已升级至更新版本)
  • 部署方式:Docker
  • 浏览器:Firefox 152.0(建议测试其他浏览器以排除浏览器行为差异)
  • 操作系统:Fedora 44
  • Terminal(Open Terminal)功能:确认是否已启用
  • 侧面板状态:确认侧面板是手动关闭,而非因其他操作自动关闭

解决步骤

  1. 确认问题性质:此行为已被开发者确认为预期设计,无需作为错误修复。
  2. 使用界面设置隐藏文件侧面板:
    • 进入 Open WebUI 的 “Settings”(设置)页面。
    • 导航至 “Interface”(界面)或 “Appearance”(外观)相关设置。
    • 查找 “Default visibility of the Files sidebar”(文件侧面板默认可见性)或类似选项。
    • 将此选项关闭或设置为 “Hidden”(隐藏),以使侧面板在页面加载时默认不显示。
  3. 关闭 Terminal 功能(可选):如果不需要 Terminal 功能,可以在聊天中禁用它,然后刷新页面,侧面板将不再自动弹出。

验证方法

按照以下步骤验证问题是否已解决:

  1. 启用 Terminal 功能。
  2. 手动关闭 “Controls/Files” 侧面板。
  3. 刷新页面(F5)。
  4. 检查侧面板是否保持关闭状态。如果使用了设置中的默认隐藏选项,侧面板应保持隐藏。
  5. (可选)关闭 Terminal 功能后重复上述步骤,侧面板应始终遵循用户关闭操作,不自动弹出。

参考来源

open-webui/open-webui #26898

GamsGo AI

AI 工具推荐

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

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

了解 GamsGo AI

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

celebrityanime
celebrityanime
文章: 13834

发表回复

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