issue: the Search row’s Ctrl+K hint stays on screen after closing Search with a click outside

这是 Open WebUI 侧边栏 Search 行的提示(hint)残留问题:用鼠标点击 Search 窗口外关闭 Search 后,焦点回到 Search 行,行内仍显示提示,因此 Ctrl+K 提示留在屏幕上,直到下一次点击页面任意位置才消失。优先排查焦点回退逻辑以及“聚焦时显示提示”的判断条

快速结论:这是 Open WebUI 侧边栏 Search 行的提示(hint)残留问题:用鼠标点击 Search 窗口外关闭 Search 后,焦点回到 Search 行,行内仍显示提示,因此 Ctrl+K 提示留在屏幕上,直到下一次点击页面任意位置才消失。优先排查焦点回退逻辑以及“聚焦时显示提示”的判断条件。

适用环境:Open WebUI dev 分支(Git Clone 安装);Ubuntu 26.04.1 LTS;浏览器 Firefox;Ollama v0.40.16。问题出现在前端界面,浏览器控制台和服务端日志均无报错。

最快修复方案:暂无确认的一步修复方案。Issue 中未给出已验证的配置项、命令或补丁;可行的方向是在关闭 Search 时不让焦点停留在 Search 行,或让提示不因鼠标点击产生的焦点而显示(可优先尝试,需自行验证)。

注意事项:Issue 被标记为 bug / confirmed issue,并关联到 #33169(同类 tooltip 残留问题)与 #33449(Search 窗口焦点处理)。相关修复可能在其他 Issue 中完成,本 Issue 正文没有给出具体改动内容,因此不要把上述方向当作官方结论。

问题场景

在 Open WebUI 中打开侧边栏后点击 Search,再点击 Search 窗口外部将其关闭。此时鼠标已移开侧边栏,但侧边栏 Search 行上的 Ctrl+K 提示仍然显示,只有再次点击页面任意位置后才会消失。

报错原文

issue: the Search row's Ctrl+K hint stays on screen after closing Search with a click outside

该问题为界面行为异常,浏览器控制台与服务端日志中均无错误输出。

原因分析

Issue 作者提供的说明是:Search 窗口关闭时会把焦点交还给 Search 行,而侧边栏的 hover 提示在其所在行获得焦点时也会显示,包括鼠标点击产生的焦点。因此点击外部关闭 Search 后,焦点落在 Search 行上,提示被当作“聚焦状态”保留在屏幕上,直到下一次点击改变焦点。

可能原因还包括关闭流程中没有清除 Search 按钮的聚焦状态,或提示显示条件同时接受了 hover 与 focus 两种触发来源且未区分鼠标关闭场景。以上未经代码层面确认。

环境排查

  • 确认 Open WebUI 版本:Issue 在 dev 分支复现,最新正式版未勾选验证。
  • 确认浏览器:Issue 使用 Firefox;建议在其他浏览器对照测试,判断是否与浏览器焦点行为相关。
  • 确认安装方式:Issue 为 Git Clone,非 Docker 等其他安装方式未在 Issue 中说明。
  • 确认 Ollama 版本:v0.40.16(与前端提示行为无直接证据关联)。
  • 检查浏览器控制台与服务端日志是否有异常,Issue 中两者均无报错。

解决步骤

  1. 按 Issue 复现路径操作:打开侧边栏 → 点击 Search → 点击 Search 窗口外部关闭 → 移开鼠标,观察 Search 行上的 Ctrl+K 提示是否仍显示。
  2. 点击页面任意位置,确认提示是否随焦点变化而消失,以定位问题与焦点状态有关。
  3. 可优先尝试:关闭 Search 后按 Escape 或点击其他控件,观察提示是否立即消失;若按 Escape 关闭不触发残留,则进一步说明问题出在“点击外部关闭”的焦点回退路径。
  4. 关注关联 Issue #33169 与 #33449 的讨论与修复,判断是否有可用的代码改动或版本升级。
  5. 如需临时规避,可在每次关闭 Search 后点击页面其他位置,使焦点离开 Search 行。

验证方法

重新执行复现步骤后,在鼠标移开侧边栏且未点击任何位置的情况下,Search 行上不再显示 Ctrl+K 提示,即视为问题解决;同时确认正常悬停 Search 行时提示仍能按预期出现,未影响原有交互。

参考来源

open-webui/open-webui #34644

GamsGo AI

AI 工具推荐

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

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

了解 GamsGo AI

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

这个方案解决了吗?

celebrityanime
celebrityanime
文章: 36045

发表回复

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