bea4dev/shoji-bar-4

项目介绍

shoji-bar-4 是 ShojiWM 这个 Wayland 合成器的桌面 shell，用 Rust 基于 AntiWebUI 编写。它提供窗口管理器周边的一整套桌面组件：由悬浮岛组成的顶栏（启动器、工作区、当前窗口、滚动时钟、正在播放、托盘与状态图标）、底部自动隐藏并在指针靠近时升起的 Dock，以及快捷设置、日历、启动器、剪贴板历史、媒体播放器、通知、OSD 和锁屏。动态配色可从种子色或壁纸生成，并以弹簧动画同步应用到整个 shell（包括窗口边框）。项目称无动画时完全不绘制新帧，空闲时为 0% CPU。

它面向希望直接获得完整 Material 3 Expressive 桌面体验、而非自行拼装面板和小组件的 ShojiWM 用户，也适合想基于 AntiWebUI 开发 UI 的 Rust 开发者参考。

快速使用

需要先有 ShojiWM、Rust 工具链，以及常见的桌面服务：NetworkManager、BlueZ、PipeWire、UPower、power-profiles-daemon 和 logind。剪贴板历史还需要 cliphist 与 wl-clipboard，zenity 用于选择用户头像。

把仓库克隆到 ShojiWM 默认配置期望的位置后构建：

git clone https://github.com/bea4dev/shoji-bar-4 ~/.config/shoji-bar-4
cd ~/.config/shoji-bar-4
cargo build --release

ShojiWM 的默认配置会随会话启动 ~/.config/shoji-bar-4/target/release/shoji-bar-4，绑定 Super 打开启动器、Super+N 快捷设置、Super+C 日历、Super+V 剪贴板和 Super+L 锁屏等快捷键，并用 shell 的配色绘制窗口边框。若使用其他配置，参见与 ShojiWM 配合使用。

更多说明见功能文档和使用与设置指南。

使用约束

• 依赖 ShojiWM，不能作为其他 Wayland 合成器的独立桌面环境使用。
• 构建需要 Rust 工具链，首次构建会在本地编译 shell 及其 AntiWebUI 依赖。
• 网络、蓝牙、音频、电源和会话集成依赖 NetworkManager、BlueZ、PipeWire、UPower、power-profiles-daemon 与 logind 存在。
• 剪贴板历史依赖外部软件包 cliphist 和 wl-clipboard。
• 基于本地修改版 AntiWebUI 构建、离屏预览和 CPU 测量见开发说明。
• 项目采用 MIT 许可证。

HotRepo 点评

该项目于 2026-11-10 出现在 Rust 新项目榜，统计窗口为 06:58 至 22:45 UTC，期间新增 100 Star 和 4 Fork；全部语言日榜暂无最佳名次记录。项目非常新，现有数据还不足以说明持续采用情况。技术上值得注意的明确约束是空闲时不绘制新帧，以及弹簧驱动的配色过渡；仓库的目录结构与构建步骤足够具体，便于已有 ShojiWM 环境的用户判断是否适合自己。