快速结论:该报错发生在 Open WebUI 使用 Light(浅色)主题时,在聊天输入框中输入 / 弹出的斜杠命令菜单中,“Temporary”“Model”“Settings”三个主标签文字变成白色,与菜单白色背景重合导致不可见。优先检查是否为 CSS 颜色继承问题:浅色主题下 .tippy-box 强制设置的白色文字颜色未被组件覆盖。
适用环境:Open WebUI v0.11.3(dev 分支,commit 0c7ddbdb4);安装方式为 Git Clone;操作系统 Linux;浏览器为任意浏览器(Issue 指出该问题与浏览器无关,是 CSS 颜色继承问题)。
最快修复方案:Issue 正文明确提到作者已准备一行修复代码并计划提交 PR,但该修复尚未合并验证。当前暂无确认的一步修复方案。
注意事项:该修复涉及 src/lib/components/chat/MessageInput/Commands/SlashCommands.svelte 中命令行的文字颜色显式定义,需注意不要影响深色主题下的正常显示;修复需在 dev 分支验证并等待官方合并。
问题场景
用户在 Open WebUI 页面中将界面主题设置为 Light(Settings > Interface > Theme),新建聊天并在消息输入框中输入 / 后,弹出的斜杠命令建议菜单顶部出现三个主标签(Temporary、Model、Settings)显示为白色文字,叠加在白色菜单背景上导致不可见;而同菜单下方的 Prompts 和 Skills 等条目显示正常,其次要说明文字(如 Off、/model、/settings)也能正常显示——这使得菜单看起来只是“半空”而不是明显异常。
报错原文
issue: Slash command menu labels are invisible in Light theme
In Light theme, the command palette that opens when you type "/" in the chat input renders the "Temporary", "Model" and "Settings" labels as white text on the menu's white background, so they are invisible.
The three command labels are invisible. Their secondary text is not: "Off", "/model" and "/settings" still render in grey.
原因分析
Issue 正文给出了非常详细的根因分析,可归纳为以下 CSS 颜色继承链条:
- 斜杠命令菜单并非内联渲染,
getSuggestionRenderer在src/lib/components/common/RichTextInput/suggestions.ts中将其挂载到追加在document.body上的 tippy 弹层中,并使用theme: 'transparent'。 - Tippy 自带的样式表设置了
.tippy-box { color: #fff }(白色文字),而transparent主题在src/app.css中只中和了 tippy 的边框/背景等外观,但未重置其文字颜色。 src/lib/components/common/DropdownMenu.svelte设置了bg-white dark:bg-gray-850 dark:text-white,即文字颜色只在 dark(深色)模式下被显式定义;在 Light 模式下没有样式覆盖继承来的#fff。src/lib/components/chat/MessageInput/Commands/SlashCommands.svelte中的命令主行没有设置自己的颜色,因此继承了白色文字——这就是为什么只有主标签出问题:次要文字使用了app-muted(text-gray-500 dark:text-gray-400),而 Prompt 行使用了text-black dark:text-gray-100,它们都逃过了白色继承。
此外,@ 提及菜单使用相同的弹层渲染方式,但每一行都显式设置了颜色,因此不受影响。
环境排查
- 确认 Open WebUI 版本是否为
v0.11.3或更新版本(该 Bug 在dev分支、commit0c7ddbdb4上确认存在)。 - 确认界面主题已切换为 Light(Settings > Interface > Theme)。
- 该问题与浏览器无关,无需排查浏览器版本;与操作系统关联有限,Issue 环境为 Linux。
- 需检查是否使用 Git Clone 方式安装——Issue 报告来自此安装方式,其他安装方式存在同样问题的可能性尚待确认。
解决步骤
- 在官方修复合并前,临时解决方案是切换为非 Light 主题(如 Dark、System 或根据系统设置),避免浅色背景与白色文字叠加。
- 如果你是开发者或希望自行修补,可按以下路径定位:
- 打开
src/lib/components/chat/MessageInput/Commands/SlashCommands.svelte,检查其中的命令按钮(应用了slash-command-row类的六个按钮)是否缺少文字颜色定义。 - 可优先尝试:为该文件中的命令主行补充
text-black dark:text-white或与其下方 Prompt 行一致的text-black dark:text-gray-100类,以在浅色主题下覆盖 tippy 继承的#fff。此方案为 Issue 正文所述可行思路,但尚未经公开 PR 验证,前后端样式可能随版本变化。 - 另一种临时规避:在浏览器开发者工具中向
.tippy-box[data-theme~='transparent']追加color: black(仅 Light 模式),但不建议作为长期方案,因为会影响所有使用该 tippy 主题的弹层。 - 关注官方 PR(Issue 中提及
Opened as #29512)跟踪合并状态,在dev分支拉取最新代码验证官方修复。
验证方法
将 Open WebUI 主题切换为 Light,新建聊天并在输入框输入 /,观察弹出的 Commands 菜单顶部三个主标签(Temporary、Model、Settings)是否能清晰显示为深色文字。若问题存在则文字不可见、仅能看到下方灰色次要文字;修复后三个标签应与同菜单内 Prompts 和 Skills 条目一样清晰可读。
参考来源
AI 工具推荐
想把多个 AI 模型放在一个入口?
GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。
推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。
这个方案解决了吗?
可以继续搜索完整报错,或查看同一工具的其他排查指南。

![[Vulkan] FA f16-scratch fast path never enabled for hybrid-model (non-unified) KV caches](https://www.chat-gpts.plus/wp-content/uploads/2026/09/28135-2a4ef7fa-768x403.jpg)
