
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)功能:确认是否已启用
- 侧面板状态:确认侧面板是手动关闭,而非因其他操作自动关闭
解决步骤
- 确认问题性质:此行为已被开发者确认为预期设计,无需作为错误修复。
- 使用界面设置隐藏文件侧面板:
- 进入 Open WebUI 的 “Settings”(设置)页面。
- 导航至 “Interface”(界面)或 “Appearance”(外观)相关设置。
- 查找 “Default visibility of the Files sidebar”(文件侧面板默认可见性)或类似选项。
- 将此选项关闭或设置为 “Hidden”(隐藏),以使侧面板在页面加载时默认不显示。
- 关闭 Terminal 功能(可选):如果不需要 Terminal 功能,可以在聊天中禁用它,然后刷新页面,侧面板将不再自动弹出。
验证方法
按照以下步骤验证问题是否已解决:
- 启用 Terminal 功能。
- 手动关闭 “Controls/Files” 侧面板。
- 刷新页面(F5)。
- 检查侧面板是否保持关闭状态。如果使用了设置中的默认隐藏选项,侧面板应保持隐藏。
- (可选)关闭 Terminal 功能后重复上述步骤,侧面板应始终遵循用户关闭操作,不自动弹出。



