Omarchy 插件
Libre WebUI 为 Omarchy（一款观点鲜明的 Arch Linux + Hyprland 桌面环境）提供官方插件。一个状态栏图标，一个面板：Libre WebUI 服务器是否在线、运行的是哪个版本、响应速度如何，以及一键启动应用。
该插件已在 Omarchy 插件市场通过验证——由市场维护者在已发布的确切提交上审核。
功能
- 一目了然的状态 — 服务器下线时状态栏图标会亮起；面板显示在线/离线状态、正在运行的版本以及响应延迟。探测使用无需身份验证的
/health/live端点，因此不会存储任何凭据，对本地和远程服务器同样适用。 - 一键启动 — 将 Libre WebUI 作为无边框的 Web 应用窗口（
omarchy-launch-webapp）或普通浏览器标签页打开。右键点击状态栏图标可直接启动。 - 离线时启动 — 配置一个可选的启动命令（
systemctl --user start libre-webui、docker start libre-webui等），服务器离线时会出现一个启动按钮，并以更快的频率重新探测直到服务器响应。 - 键盘优先 — Enter 打开应用，
R刷新，方向键和 Escape 的行为与其他所有 Omarchy 面板一致。
安装
omarchy plugin add https://github.com/libre-webui/omarchy-libre-webui.git --enable
然后从状态栏设置中将该小组件添加到状态栏。还没有 Libre WebUI？一条命令即可：
npx libre-webui@latest
小组件的默认服务器 URL（http://localhost:8080）会立即找到它。
设置
| 设置 | 默认值 | 用途 |
|---|---|---|
| 服务器 URL | http://localhost:8080 | Libre WebUI 服务器所在位置——本地或远程。 |
| 刷新间隔 | 30 秒 | 健康探测运行的频率。 |
| 打开方式 | Web 应用窗口 | omarchy-launch-webapp 应用窗口，或 xdg-open 浏览器标签页。 |
| 启动命令 | （空） | 服务器离线时启动按钮运行的可选命令。 |
鼠标与 IPC
| 操作 | 效果 |
|---|---|
| 左键点击 | 切换面板 |
| 右键点击 | 启动 Libre WebUI |
| 中键点击 | 立即刷新 |
该小组件响应 shell IPC，因此可以在 Hyprland 中绑定按键：
omarchy-shell shell toggle org.librewebui.companion
其他 IPC 动词：refresh、launch。
卸载
omarchy plugin remove org.librewebui.companion
安全性
该插件刻意保持精简：它唯一的网络访问是对你所配置的服务器 URL 进行健康探测，响应体在生成端就有大小上限，且该 URL 永远不会被拼接进 shell 文本。市场的安全审查正是覆盖了这些特性；完整历史记录公开在源码仓库和市场提交讨论串中。