← 返回系统组成地图
这一层可以沿着 登录入口 → 会话管理 → 窗口显示 来理解。它们前后衔接，但不会在进入下一阶段后就全部退出：会话管理与窗口合成会继续维持桌面的运行。
| 组件 |
负责什么 |
如何与其他组件配合 |
| SDDM |
提供图形登录入口并启动所选会话 |
将用户带入桌面会话的启动流程 |
| UWSM |
协调 Wayland 会话、环境与用户服务的生命周期 |
为 Hyprland 及会话中的程序组织运行环境 |
| Hyprland |
组织窗口、工作区、显示器与输入 |
在会话中接收应用画面，并决定如何显示和分配输入 |
以登录后打开终端为例： SDDM 启动所选会话；采用 UWSM 的会话由它协调启动与环境；Hyprland 开始管理桌面。终端应用启动后负责自己的内容，Hyprland 决定窗口位置和焦点。Quickshell 提供的顶栏与菜单则是另一层界面，并不由 SDDM 绘制。
因此，登录界面没有出现、登录后立即退出、只有窗口排列不对，是三个不同阶段的问题，应分别从 SDDM、会话启动和 Hyprland 配置入手。这里表示职责衔接，不是所有安装方式都完全相同的进程启动图。
以下逐一介绍本分类已收录的全部组件，涵盖用途、原理、配置、排查、注意事项与学习资料。点击目录中的名称可跳转到相应正文。
本分类已收录的全部 3 个组件
Wayland 合成器：管理窗口、工作区、显示器与输入。
深入专题：组件协作、实际操作与故障诊断 →
- 包名
hyprland- 收录状态
- 核心清单
- Omarchy 配置或入口
~/.config/hypr/hyprland.lua
用途与日常使用
管理 Wayland 会话中的窗口排列、工作区、焦点、显示器布局和输入。平铺方式、窗口间距、快捷键与多屏位置都与这一层有关；顶栏显示什么内容则应查看 Omarchy Shell。
工作原理与协作关系
应用把可显示的内容提交给合成器，由它组织成屏幕画面并分配输入。UWSM 管理会话生命周期，桌面门户负责把屏幕共享等请求连接到桌面能力，Quickshell 则提供菜单和面板。
配置与定制
本 Omarchy 快照记录的入口为 ~/.config/hypr/hyprland.lua，并把显示器、输入、快捷键等覆盖设置拆分为 Lua 文件。先确定要改的是哪个职责，再编辑对应文件；网上其他版本的配置语法不一定能直接使用。
常见问题与排查思路
先查看 hyprctl version 和显示器信息，再逐项排查最近的覆盖配置。单个应用渲染异常与整个合成器无法启动应分开处理。记录配置修改前后的差异，避免同时改动画、显示器和输入设置后无法判断原因。
能力边界与修改注意事项
重启或替换合成器会影响整个图形会话。定制前保留可用配置，通过个人覆盖设置做小范围修改。它也不是显卡内核驱动；硬件识别层面的故障不能单靠修改窗口规则解决。
本机检查与版本确认
先查询本机包信息，确认是否安装及具体版本。下面的命令用于只读检查，不会安装、重启或修改配置；需要在自己的 Omarchy 环境中运行。
pacman -Qi hyprland
hyprctl version
包不存在、服务未运行、当前不在图形会话或项目目录时，部分查询可能返回错误；应结合组件用途解读，不要直接当作系统故障。服务与项目状态可能包含本机信息，分享前请检查。
来源与适用范围
Omarchy 集成以 2026-10-12 的 quattro 分支快照为依据；上游配置说明应与本机版本对应。这里提供的是文档整理与排查建议，未进行本机硬件实测。
通过 systemd 用户服务管理 Wayland 会话。
- 包名
uwsm- 收录状态
- 核心清单
用途与日常使用
把 Wayland 会话与应用的生命周期接入 systemd 用户服务。多数时候它在后台工作，用户在登录、启动应用和结束会话时，间接使用到它提供的会话管理能力。
工作原理与协作关系
会话环境和服务启动顺序是关键：在错误上下文里启动的应用，可能拿不到桌面会话中的环境变量。UWSM 管理这些会话层面的关系，而窗口合成仍由 Hyprland 完成，图形登录入口则由 SDDM 提供。
配置与定制
环境与会话设置应遵循 UWSM 文档。日常增加自启动应用时，优先使用 Omarchy 提供的自启动机制；不要为了启动一个应用而额外创建第二套桌面会话，也不要随意复制其他桌面的环境变量。
常见问题与排查思路
启动或退出卡住时，先查看失败的用户服务和用户日志。对比从当前桌面启动与从其他终端会话启动的区别，有助于发现环境变量或会话归属问题。单个程序退出失败不一定意味着合成器有问题。
能力边界与修改注意事项
它不是窗口管理器，也不是登录界面。重复启动会话管理器可能造成环境和服务状态混乱。调整会话启动方式应整体考虑登录入口与合成器，不能仅凭某个进程名就直接停用它。
本机检查与版本确认
先查询本机包信息，确认是否安装及具体版本。下面的命令用于只读检查，不会安装、重启或修改配置；需要在自己的 Omarchy 环境中运行。
pacman -Qi uwsm
systemctl --user --failed
包不存在、服务未运行、当前不在图形会话或项目目录时，部分查询可能返回错误；应结合组件用途解读，不要直接当作系统故障。服务与项目状态可能包含本机信息，分享前请检查。
来源与适用范围
Omarchy 集成以 2026-10-12 的 quattro 分支快照为依据；上游配置说明应与本机版本对应。这里提供的是文档整理与排查建议，未进行本机硬件实测。
显示管理器，负责图形登录会话的启动。
- 包名
sddm- 收录状态
- 核心清单
用途与日常使用
负责显示管理器这一阶段，启动用户的图形会话。登录外观和会话选择属于这里；用户已进入桌面后再次锁屏，则属于已有会话内的锁屏机制，不能混为一谈。
工作原理与协作关系
系统服务管理登录过程，再把控制权交给选定的会话。Omarchy 的服务启用脚本中包含 sddm.service；后续还需要 UWSM 与 Hyprland 配合。看到登录界面不代表桌面会话一定能成功启动。
配置与定制
SDDM 有独立的配置和主题系统。修改自动登录、会话选择或主题前，先核对本机现有配置与发行版集成。这些设置不是 Hyprland 窗口规则，也不应该通过修改桌面锁屏外观来实现。
常见问题与排查思路
登录界面根本不出现时，先检查系统服务；输入凭据后立即返回登录界面时，还需要检查所选会话和用户日志。把“登录认证失败”和“认证后桌面进程退出”区分开，才能选择正确排查方向。
能力边界与修改注意事项
重启显示管理器可能终止正在使用的图形会话。不要在未保存工作时把重启当作普通刷新；登录主题加载失败也不意味着需要更改身份认证配置。
本机检查与版本确认
先查询本机包信息，确认是否安装及具体版本。下面的命令用于只读检查，不会安装、重启或修改配置；需要在自己的 Omarchy 环境中运行。
pacman -Qi sddm
systemctl status sddm --no-pager
包不存在、服务未运行、当前不在图形会话或项目目录时，部分查询可能返回错误；应结合组件用途解读，不要直接当作系统故障。服务与项目状态可能包含本机信息，分享前请检查。
来源与适用范围
Omarchy 集成以 2026-10-12 的 quattro 分支快照为依据；上游配置说明应与本机版本对应。这里提供的是文档整理与排查建议，未进行本机硬件实测。
搜索所有组件 · 官方软件包清单索引
本页随共享组件目录更新；收录范围基于目录标注的源码快照，不代表所有版本或全部间接依赖。