Zebar：用 Web 技术打造你的专属桌面状态栏 #

Zebar 是什么？ #

Zebar 是一款基于 Web 技术构建的开源跨平台桌面状态栏工具，它会在你的屏幕边缘常驻一条可完全自定义的信息栏，用来展示系统状态、时间日期、媒体播放、窗口管理等内容。与传统状态栏软件不同，Zebar 把「小部件」的渲染交给了 HTML、CSS 和 JavaScript，也就是说，只要你懂前端，就能像写网页一样设计状态栏的每一个像素和每一段逻辑。

它主要解决两类痛点：一是系统自带任务栏/菜单栏信息密度低、样式无法修改；二是第三方美化工具普遍封闭、模板固定、难以深度定制。Zebar 通过开放的 Web 渲染层和配套的 JavaScript API，让桌面状态栏真正变成一块「可以编程的画布」，适合开发者、极客、窗口管理器用户以及所有希望桌面更贴合自身工作流的用户。

Zebar 有哪些亮点特色？ #

• Web 技术全量自定义：状态栏小部件使用 HTML、CSS、JavaScript 编写，配色、字体、圆角、动效、交互逻辑全部由你决定，无需学习私有配置语法或插件格式。

• 开箱即用的 React 支持：官方提供基于 React 的小部件开发方式和组件库，熟悉前端生态的用户可以直接复用现有工具链与组件，显著降低上手成本。

• 内置丰富的数据源（Providers）：通过配套的 JavaScript API，小部件可以直接读取系统信息，例如 CPU 与内存占用、电池状态、当前时间日期、音频播放信息，以及与 GlazeWM 等窗口管理器协作时的虚拟桌面/工作区状态。

• 与 GlazeWM 深度协同：由 GlazeWM 团队（glzr-io）维护，可与同门窗口管理器配合使用，把工作区切换、窗口标题、平铺模式等状态实时呈现在状态栏上，形成完整的 Windows 平铺工作流。

• 跨平台一致体验：同时提供 Windows、macOS 与 Linux 版本，一份配置思路可在多系统间迁移，多设备用户无需维护两套桌面美化方案。

• 基于 Tauri 的轻量架构：应用使用 Rust 与 Tauri 构建，安装包体积控制在十几 MB 级别（不同平台略有差异），相比同类的 Electron 系工具占用更小、启动更轻快。

• 多显示器与多实例支持：可以针对不同显示器配置不同的状态栏实例，为主屏和副屏分别设置侧边位置与显示内容。

• 完全开源免费：项目托管于 GitHub（glzr-io/zebar），源码公开可审计，无付费订阅、无广告、无强制账号登录，可放心长期使用（具体开源许可证以仓库说明为准）。

免费下载 Zebar #

以下为官方提供的各平台安装包，点击链接即可下载。请根据你的操作系统与 CPU 架构选择对应文件。

说明：以上文件版本号为 v3.3.1（依据下载文件名整理），各平台对应的系统最低版本要求官网未说明，建议在较新的 Windows 10/11、macOS 与主流 Linux 发行版上使用。若需要最新版本或源码编译，请访问官方仓库 https://github.com/glzr-io/zebar 查看 Releases 页面。

Zebar 如何使用？ #

Zebar 的核心理念是「配置即代码」，使用流程大致分为以下几步：

1. 安装并启动：完成安装后启动 Zebar，屏幕上会出现一条默认状态栏。首次运行时，程序会自动在用户目录下创建配置文件夹与默认小部件，用于存放你的个性化设置。

2. 认识「小部件（Widget）」概念：状态栏由若干个小部件拼接而成，每个小部件本质上是一个网页。你可以把状态栏理解为「一个缩小到屏幕边缘的浏览器容器」，里面装载着若干独立的 Web 页面。

3. 打开配置文件：在配置文件夹中找到 Zebar 的配置文件，其中声明了状态栏的名称、位置（顶部/底部/左侧/右侧）、尺寸，以及起始端（start）和结束端（end）分别加载哪些小部件。配置文件的具体路径与字段名随版本演进可能调整，官网未说明统一路径，建议以仓库 README 与文档目录为准。

4. 添加或替换小部件：把官方示例小部件复制到小部件目录，或在配置中指向你自建的小部件文件夹。每个小部件目录内通常包含 HTML 入口文件、样式与脚本，你可以直接编辑它们来改变外观。

5. 用 JavaScript API 获取系统数据：在小部件脚本中调用官方提供的 API，即可订阅系统信息变化（如 CPU、内存、电池、时间、音频、窗口管理器状态等），再把这些数据渲染到页面上。熟悉 React 的用户也可以直接使用官方提供的 React 小部件模板与钩子函数。

6. 保存并自动生效：修改配置或小部件代码后，Zebar 通常会自动重新加载（部分版本需要重启程序或执行重新加载命令）。建议先用默认配置跑通流程，再逐步替换成自己的设计。

提示：Zebar 面向的是愿意动手的用户。如果你只想「装完即用」，可以先使用官方示例小部件，再按需微调 CSS 配色，同样能快速获得比系统任务栏更贴合审美的效果。

Zebar 的常见问题？ #

Zebar 是免费的吗？ 是。Zebar 为开源免费项目，不收取任何费用，也没有广告和内购。你可以在 GitHub 上查看完整源码、提交 Issue 或参与贡献。

Zebar 和 GlazeWM 是什么关系？ 两者由同一个团队（glzr-io）维护。GlazeWM 是面向 Windows 的平铺式窗口管理器，Zebar 则是与之配套的桌面状态栏。Zebar 也可以独立使用，但配合 GlazeWM 时，才能在状态栏上实时展示工作区、窗口标题等窗口管理信息。

我不懂前端，能用 Zebar 吗？ 可以，但体验有限。Zebar 自带默认小部件，安装后即可直接显示；不过要做出真正个性化的效果，需要具备基础的 HTML/CSS 知识。如果你完全没有前端经验，建议先从修改官方示例的配色和字号入手。

为什么状态栏没有显示，或者显示位置不对？ 常见原因包括：显示器缩放比例异常、状态栏位置参数与屏幕边缘冲突、小部件代码报错导致渲染失败、被其他窗口管理器或全屏程序遮挡等。建议先检查配置文件中的位置与尺寸设置，并查看程序日志中的报错信息（参考社区常见反馈）。

Zebar 会明显占用系统资源吗？ Zebar 基于 Rust 与 Tauri 构建，运行时以系统 WebView 渲染小部件，整体开销通常低于 Electron 类桌面工具。但如果你在小部件中写了死循环动画或高频轮询逻辑，仍然会造成额外的 CPU 与内存消耗，建议合理设置数据刷新频率。

可以给多个显示器分别设置状态栏吗？ 可以。Zebar 支持配置多个状态栏实例，为每个显示器指定不同的位置和显示内容。具体配置写法请参考官方仓库中的示例配置。

Zebar 如何安装？ #

Windows #

1. 根据你的设备架构选择安装包：普通 x64 电脑下载 zebar-v3.3.1-opt1-x64.msi，ARM 设备（如骁龙 X 系列）下载 zebar-v3.3.1-opt2-arm64.msi。
2. 双击 .msi 文件，按照向导点击「下一步」完成安装。
3. 若需要在企业环境中静默安装，可在命令行执行：msiexec /i zebar-v3.3.1-opt1-x64.msi /qn。
4. 安装完成后从开始菜单启动 Zebar，程序会在用户目录下生成默认配置。

macOS #

1. 下载 zebar-v3.3.1-opt3.dmg 并双击打开镜像。
2. 将 Zebar 图标拖拽到「应用程序」文件夹。
3. 首次启动时，如果出现「无法验证开发者」的提示，请前往「系统设置 → 隐私与安全性」，点击「仍要打开」。
4. 若希望状态栏随系统登录自动启动，可在 Zebar 设置或系统「登录项」中开启自启。

Linux（Debian / Ubuntu 系） #

1. 下载 zebar-v3.3.1-opt4-x64.deb。
2. 在终端中进入下载目录，执行：sudo apt install ./zebar-v3.3.1-opt4-x64.deb（推荐，可自动处理依赖）；或执行 sudo dpkg -i zebar-v3.3.1-opt4-x64.deb 后再运行 sudo apt -f install 补全依赖。
3. 安装完成后，可在应用菜单中搜索 Zebar 并启动。

Linux（AppImage 免安装版） #

1. 下载 zebar-v3.3.1-opt5-x64.AppImage。
2. 赋予可执行权限：chmod +x zebar-v3.3.1-opt5-x64.AppImage。
3. 直接运行：./zebar-v3.3.1-opt5-x64.AppImage。
4. 部分发行版需要预先安装 FUSE 才能运行 AppImage；若提示缺少 FUSE，请通过包管理器安装 fuse 或 libfuse2。

注意事项：不同 Linux 桌面环境（GNOME、KDE、Sway、Hyprland 等）对状态栏层级与窗口规则的处理方式不同，可能出现被其他面板遮挡或无法置顶的情况，建议根据所用桌面环境调整窗口规则（参考社区常见反馈）。Windows 与 macOS 的最低系统版本要求官网未说明。

Zebar 如何卸载？ #

Windows #

1. 打开「设置 → 应用 → 已安装的应用」（或控制面板「程序和功能」）。
2. 在列表中找到 Zebar，点击「卸载」并确认。
3. 如需静默卸载，可在命令行执行：msiexec /x zebar-v3.3.1-opt1-x64.msi /qn。
4. 卸载后，用户目录下仍会残留配置文件和小部件文件，如不再需要可手动删除对应配置文件夹。

macOS #

1. 打开「访达 → 应用程序」，找到 Zebar。
2. 将其拖拽到废纸篓，或右键选择「移到废纸篓」。
3. 输入管理员密码完成删除。
4. 如需彻底清理，请手动删除用户目录下的 Zebar 配置与缓存文件夹（具体路径因版本而异，官网未说明）。

Linux（.deb 安装） #

1. 在终端中执行：sudo apt remove zebar（若包名不同，可先用 dpkg -l | grep -i zebar 查询实际包名）。
2. 如需连同配置一起删除，执行：sudo apt purge zebar。
3. 用户目录下的配置文件通常不会被自动清除，可手动删除对应配置文件夹。

Linux（AppImage 便携版） #

1. AppImage 不写系统注册表，直接删除 .AppImage 文件即可完成卸载。
2. 手动删除用户目录下由 Zebar 生成的配置文件夹与小部件目录，避免残留。

通用提醒：Zebar 的个性化配置（小部件、样式、脚本）通常保存在用户主目录下，卸载程序一般不会自动清除。如果你打算日后重装并保留现有配置，请不要删除该目录。