issue: no way to reopen the chat controls pane after closing it

在使用 Open Terminal 终端连接时关闭了聊天控制面板(Controls / Files / Overview),之后找不到入口重新打开,重新加载页面也无法恢复。优先检查聊天标题栏右上角的 Controls(旋钮图标)按钮,并用它来切换面板开关。

快速结论:在使用 Open Terminal 终端连接时关闭了聊天控制面板(Controls / Files / Overview),之后找不到入口重新打开,重新加载页面也无法恢复。优先检查聊天标题栏右上角的 Controls(旋钮图标)按钮,并用它来切换面板开关。

适用环境:Open WebUI v0.11.4,自托管部署;Open Terminal 连接位于独立主机;浏览器为 Chromium。桌面端页面重载可保存并恢复面板开关状态。

最快修复方案:点击聊天标题栏右上角的 Controls 按钮(旋钮图标)即可重新打开或关闭面板;选中终端时会直接定位到 Files 标签。也可在 Settings > Shortcuts 中为 “Toggle Controls” 分配一个按键(默认无绑定)。

注意事项:原文正文中“只能通过断开并重连终端连接才能恢复面板”的说法已被维护者更正——无需重新连接终端,因此也不存在因此产生的 prompt 缓存重复处理开销。若你在聊天标题栏看不到 Controls 标签,却仍看不到旋钮按钮,可在原 Issue 中重新打开反馈。

问题场景

用户在 Open WebUI 中选中了一个 Open Terminal 终端连接,然后关闭了聊天控制面板(即包含 Controls / Files / Overview 的那个面板)。关闭之后,界面中找不到任何重新打开该面板的入口,刷新页面也没有恢复,面板始终处于关闭状态。

报错原文

issue: no way to reopen the chat controls pane after closing it

原因分析

报告者通过检查构建后的混淆 bundle 发现:showControls 是一个内存态 store,默认值为 false,不会写入 localStorage 或 sessionStorage(只有 fileNav:showHidden 被持久化)。其中能查到的调用只有 showControls.set(true),且与 showFileNavPath.set(...) 一起出现——也就是说面板是作为“展示某个文件”的副作用被打开的,而不是由用户操作触发;没有找到将其取反切换的调用,也没有绑定键盘快捷键。报告者同时指出,这是压缩混淆后的 JavaScript,可能遗漏了某些形式的 toggle,但观察到的行为与其分析一致。

此外,该问题被认为是一个修复的副作用:此前 Files 面板会自行重新打开,后来被修正为关闭后保持关闭,但“重新打开”的入口没有被补上。需要说明的是,维护者在关闭 Issue 时指出实际已存在 Controls 按钮和 “Toggle Controls” 快捷键,因此“没有入口”这一判断可能不成立——可优先尝试使用标题栏 Controls 按钮或快捷键。

环境排查

  • Open WebUI 版本:v0.11.4(报告者环境)。
  • 部署方式:自托管(self-hosted)。
  • 终端连接:Open Terminal 连接位于独立主机。
  • 浏览器:Chromium。
  • 终端状态:需要确认是否选中了终端连接,因为面板行为与终端选择相关。
  • 界面位置:确认聊天标题栏右上角是否能看到 Controls(旋钮)按钮、Controls 标签是否存在。

解决步骤

  1. 在聊天标题栏右上角找到 Controls 按钮(旋钮图标)。若当前面板已关闭,点击它即可重新打开;再次点击则关闭。
  2. 选中终端连接时,用 Controls 按钮打开面板会直接进入 Files 标签。
  3. 如需键盘操作,进入 Settings > Shortcuts,找到 “Toggle Controls” 并为其分配一个按键(默认无绑定)。
  4. 在桌面端,面板的开关状态会在页面重载时被保存和恢复,可作为确认手段。
  5. 不要通过断开再重连终端连接的方式来恢复面板——根据维护者说明,不必这样做,也不会因此触发 prompt 缓存的重复处理开销。

验证方法

点击 Controls 按钮后,面板应正常出现(选中终端时停在 Files 标签);再次点击可正常关闭。使用分配的 “Toggle Controls” 快捷键应能实现同样的开关效果。桌面端刷新页面后,面板开关状态应被恢复。若你能看到 Controls 标签但聊天标题栏没有旋钮按钮,属于异常情况,可在原 Issue 中重新打开反馈。

参考来源

open-webui/open-webui #31663

GamsGo AI

AI 工具推荐

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

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

了解 GamsGo AI

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

这个方案解决了吗?

celebrityanime
celebrityanime
文章: 26697

发表回复

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