Trendorin/yami

项目介绍

yami 是一个用 Rust 编写的 Wayland shell，把 niri 合成器补成一套完整桌面：状态栏、启动器、Dock、通知服务、锁屏、OSD、小组件和设置都由它自己绘制，走共享内存的软件渲染，不依赖 GPU 上下文或 UI 工具箱。配套还有 yami-files（文件管理器兼 portal 文件对话框）、yami-view（图片查看与快速编辑）、yami-play（基于 libmpv 的视频音乐播放器）、SDDM 登录主题，以及打过补丁的 niri 构建 yami-niri。一套调色板会同时作用于 shell、壁纸、niri 边框、Qt/GTK 应用、终端、光标和登录界面。

目标用户是运行 niri 的 Linux/Wayland 用户，想要统一的像素风桌面，并且能接受源码构建和对系统配置文件的改动。功能清单与截图见项目 README。

快速使用

文档给出的主路径是在全新系统上运行交互式安装脚本：先把仓库取到 ~/.local/share/yami/src，再从那里执行：

bash <(curl -fsSL https://raw.githubusercontent.com/Trendorin/yami/main/install.sh)

也可以先克隆再执行脚本：git clone https://github.com/Trendorin/yami yami && yami/install.sh。安装器会依次询问语言、组件、配色、面板样式和应用字体，确认摘要后调用发行版包管理器安装依赖，用 cargo build --release --locked 构建工作区（需要 Rust ≥ 1.89），把四个二进制装进 ~/.local/bin，写入 niri、kitty、fastfetch 配置和快捷键，之后可选构建 yami-niri 并安装 SDDM 登录主题。重启或注销后选择 Niri 会话即可进入桌面。常用参数有 --yes、--dry-run、--no-sudo、--no-fork、--uninstall、--update，完整参数表见安装章节。

只想手动构建 shell 时，进入 shell/ 执行 cargo build --release --locked，再把 target/release/yami-shell 安装到 ~/.local/bin。运行时依赖 libxkbcommon 和 libpam；pactl、playerctl、nmcli、BlueZ、cliphist 等可选组件分别对应音量、媒体、Wi-Fi、蓝牙和剪贴板功能。

使用约束

这是围绕 niri 构建的 Linux/Wayland 桌面，不是能在任意显示服务器上运行的独立应用。安装需要网络和可用的发行版包管理器，支持 Arch、Fedora、Debian/Ubuntu、openSUSE、Void、Alpine、Gentoo 和 NixOS；首次构建和可选的 yami-niri 构建都耗时（上游 niri 分支构建约 5–25 分钟），且需要 1.89 以上的 Rust 工具链。构建并启用 yami-niri 和 SDDM 主题会改动系统级组件，需要预留重启时间并保住恢复手段，README 给出了用 fork/yami-niri.sh off 回退的方法。

配置保存在 ~/.config/yami-shell.json 和 yami 命令中；shell 自己管理多个 niri KDL 文件，最后 include ~/.config/niri/user.kdl，所以用户自己的绑定、规则和输出设置优先。已有配置文件会备份为 *.bak-DATE，旧名 DARK-4RMY 的安装会被迁移而非重复安装。代码采用 MIT 许可证，内置字体保留各自许可，yami-niri 基于 GPL-3.0 的上游 niri 构建。README 说明代码借助 Claude Code 编写，但每次发布前都会经过构建、tools/check.sh 检查和真机日常使用。

HotRepo 点评

yami 在 2026-11-05 首次出现在 Rust 新项目榜，当天记录的一小时窗口内新增 3 个 Star，快照时为 105 Star、1 个 Fork；没有全部语言日榜名次，采集窗口也太短，不足以判断趋势。仓库本身对一个新项目而言完成度不低：自带文件管理器、图片查看器、视频播放器，维护自己的合成器分支，发布标签签名，并有完整的更新和回滚流程，还给出了明确的资源占用数据（空闲 shell 约 15 MB）。真正需要留意的是安装方式——通过远程管道脚本安装并启用自定义合成器分支，对一个年轻项目来说是不小的信任决定，因此应把视觉收益和运维代价放在一起权衡，而不是只看 Star 数。