dux-shell

项目概述

当你要在 Wayland 上拼一套完整桌面时，Dux Modular Shell 提供了一整套做法：顶栏、启动器、控制中心、通知中心、锁屏和桌面组件由一个外壳统一提供。界面用 Quickshell 的 QML 渲染，系统集成放在 Go 写的 dms 守护进程里，平时需要 waybar、swaylock、swayidle、mako、fuzzel、polkit 分别配置的活儿，被收进同一个仓库。仓库是一个 Monorepo，quickshell/ 是界面，core/ 是 Go 后端与命令行，distro/ 放各发行版打包文件。

项目	内容
平台	Wayland（niri、Hyprland、Sway 等）
技术栈	Quickshell / Qt 6 QML + Go 1.27.3
当前版本	v2.1.2
许可	MIT

一个外壳替掉一整排零散组件，主题与插件配置还能整体搬到另一台机器。

主要功能

• 动态配色：从壁纸取色，经 matugen 与 dank16 同步改写 GTK、Qt、终端以及 VS Code / VSCodium 的主题
• 系统监视：dms 守护进程采集 CPU、内存、GPU 占用与温度，进程列表可搜索并结束进程
• 启动器：Spotlight 式搜索，覆盖应用、文件、emoji、已开窗口、计算器与命令
• 控制中心：网络、蓝牙、音频设备、显示设置与夜间模式集中在同一面板
• 通知中心：按应用分组、支持富文本与键盘导航
• 媒体与剪贴板：MPRIS 播放控制、日历、天气、带图片预览的剪贴板历史
• 会话管理：锁屏、空闲检测，插电与电池分别设置自动锁屏与挂起
• 插件机制：~/.config/dms/plugins.lock.json 记录已托管插件及其精确 Git 提交号，可在另一台机器复现同一套插件

界面与组件

• TopBar：多显示器状态栏，带工作区切换
• DBar：可自定义的组件栏，支持插件接入
• Dock：应用坞，含窗口管理
• DDash：仪表盘，聚合监控数据与快捷开关
• DIsland：屏幕顶部的动态岛式提示区
• OSD 与通知：音量、亮度调节的浮层与应用通知弹窗
• 桌面层：桌面小部件层、桌面右键菜单、模糊或视频壁纸层

命令行与 IPC

• dms run：启动外壳
• dms ipc call：按对象调用能力，例如 dms ipc call spotlight toggle、dms ipc call audio setvolume 50
• dms brightness list：列出可调节的显示器
• dms plugins search / lock / restore：浏览插件仓库、刷新锁文件、用锁文件恢复插件
• dms doctor：检查运行环境是否齐备

适用人群

• 使用 niri 或 Hyprland 的 Wayland 用户
• 想让桌面外观统一的 Linux 用户
• 需要多显示器状态栏与工作区切换的人
• 想用 QML 编写桌面组件的开发者

快速上手

1. 确认当前是 Wayland 会话，合成器为 niri、Hyprland、Sway、MangoWC、labwc、Scroll 或 Miracle WM
2. 用发行版包安装：Arch 系直接装 dux-shell，或从 AUR 装 dux-shell-git，Fedora、Debian、Ubuntu、openSUSE、Gentoo 的打包文件在仓库 distro/ 下
3. 首次执行 dms run，确认顶栏与启动器正常弹出
4. 在设置里换一张壁纸，配色与终端、编辑器主题会随壁纸重新生成
5. 需要扩展时用 dms plugins search 浏览，装好后执行 dms plugins lock 固化版本
6. NixOS 用户在 flake 中引入 homeModules.dank-material-shell 即可声明式安装

系统要求

项目	要求
会话	Wayland，X11 下无法运行
合成器	niri、Hyprland、Sway、MangoWC、labwc、Scroll、Miracle WM 支持最完整
运行时	Quickshell、Qt 6；自行编译还需 Go 1.27.3
发行版	Arch、Fedora、Debian、Ubuntu、openSUSE、Gentoo、FreeBSD、NixOS
IPC	界面与 dms 守护进程按 API 版本协商，当前要求 apiVersion >= 38

注意事项

• 仅限 Wayland：工作区、图层壳与截图都依赖 Wayland 协议，X11 下没有可用路径
• 合成器决定功能完整度：只有上述七种合成器具备完整工作区切换、概览与显示器管理，其它合成器功能会缩水
• 接管范围较大：顶栏、锁屏、空闲管理由它接手，原有 waybar、swaylock 配置不再生效
• 锁文件是版本锚点：~/.config/dms/plugins.lock.json 固定到具体提交，跨机还原后插件不会自动跟随上游更新，升级需重新执行 dms plugins lock