Omarchy 系统组成：理解 Linux 桌面的各个组件

Omarchy 把 Arch Linux 基础系统、Wayland 桌面、后台服务和应用，通过自己的配置与工具组合起来。先弄清一个组件负责什么，再沿着关联关系理解下一层。

浏览组件目录 → · 查询软件包清单

主要部分怎样协作？

可以把一个任务看成跨越几个边界：固件与引导工具启动系统，图形会话管理窗口与输入，面板提供后台服务的控制入口，应用完成具体工作，Omarchy 在这些部分之间提供默认设置与集成。这是简化的学习路线，不代表每个动作都必须经过一条严格链路。

例如视频会议需要应用、可用网络、音频路由，还可能需要桌面共享。桌面可用，不能证明麦克风选对了。从失败动作开始，确定负责层次，再检查合作组件。

问题	从哪一层开始	对应任务指南
电脑怎样进入桌面？	启动层 → 桌面层	安装与启动
谁绘制顶栏，谁组织窗口？	桌面交互与窗口	个性定制
谁处理 Wi-Fi、蓝牙与声音？	网络与音视频	网络与硬件
谁解释命令和编辑项目？	开发工具	应用与工具
谁保护系统状态与个人工作？	存储	维护与恢复

选择浏览方式

• 理解架构： 按下方十个层次进入子页面。每页先解释协作，再介绍该分类当前收录的全部组件。
• 查询一个程序： 使用可搜索的组件目录，查看用途、配置入口、关联组件与上游证据。
• 核对软件包名字： 查看清单索引。源码列出，不等于本机已经安装。

层级页面负责概念与实践解释，目录负责快速查询，清单索引保留源码归属。三种入口共享证据，回答不同问题。

系统组成地图

点击层次名称进入分类子页面，了解职责与完整组件清单；点击组件名称可直达详情。表中列出当前目录的全部组件，按主要功能归类，不是严格的软件包依赖图。

当前目录全部 40 个组件 · 10 个分类

层次	职责	已收录组件
启动与基础系统 →2 个组件	固件启动引导程序，再由内核与系统服务启动系统；不同平台的启动链有所不同。	Limine · Plymouth
桌面与窗口 →3 个组件	登录管理器启动会话，合成器组织窗口和显示器。	Hyprland · UWSM · SDDM
桌面交互 →2 个组件	菜单、面板和通知，为底层服务提供操作入口。	Quickshell · wl-clipboard
网络与连接 →4 个组件	连接管理、蓝牙协议和局域网发现解决不同的问题。	NetworkManager · BlueZ · Avahi · UFW
音频与视频 →6 个组件	音视频处理、路由策略和桌面共享分工不同。	WirePlumber · PipeWire · Hyprland desktop portal · GPU Screen Recorder · mpv · wf-recorder
输入与显示 →5 个组件	输入法引擎不等于键盘布局，屏幕背光不等于显示色温。	Fcitx 5 · Fcitx 5 Chinese Addons · hyprsunset · brightnessctl · ddcutil
终端与开发 →8 个组件	终端承载 Shell；编辑器、提示符与运行时管理工具各有职责。	Foot · Starship · tmux · Neovim · Git · Lazygit · mise · Docker
应用与软件包 →4 个组件	应用完成具体工作，包管理工具负责安装和更新。	Chromium · Files / Nautilus · yay · CUPS
存储与维护 →4 个组件	挂载设备、回滚系统与备份个人文件是不同任务。	udiskie · Snapper · Btrfs tools · Power Profiles Daemon
Omarchy 集成工具 →2 个组件	Omarchy 用预设、菜单和自有应用把上游组件连接起来。	Omarchy Neovim configuration · Omasnap

从实际任务开始学

实体学习路线可先看 Hyprland：合成器、状态查看与个人配置，或 Quickshell：宿主、插件与独立 QML 练习。层次页仍保留完整已收录组件表，实体专题增加具体任务，不再复制一份清单。

1. 连接 Wi-Fi： 桌面网络面板是操作界面，NetworkManager 才是连接管理组件。先读 Wi-Fi 指南，再看组件详情。
2. 排查蓝牙耳机： BlueZ 负责蓝牙，PipeWire 处理音频，WirePlumber 管理路由与策略。结合音频和蓝牙排查逐层定位。
3. 定制桌面： Hyprland 管窗口，基于 Quickshell 的 Omarchy Shell 绘制顶栏和面板，两者配置职责不同。从第一次定制开始。
4. 理解中文输入： Fcitx 5 是框架，Chinese Addons 提供输入引擎。装好包不等于已经选好输入法，继续阅读中文输入指南。

如何理解收录范围

第一版讲解 40 个组件，并索引固定提交中五份官方清单出现的全部独立包名。暂不逐一讲解所有间接依赖，也不包含每个可选菜单安装器或所有历史组件。quattro 分支快照是内容依据，不表示适用于每个发行版本。

“核心清单”表示列入基础包文件，仍可能有架构排除规则。“其他安装候选”不能直接理解为“可选安装”：原文件混合了系统包、硬件驱动和可选软件。软件包索引保留原始文件归属，方便进一步核对。

详情中的“一起理解”表示值得关联学习的组件，不是严格依赖关系。检查命令只读取本机软件包信息。跨 Omarchy 版本使用配置前，应先核对自己的实际版本。

配置归属也要分清：个人覆盖配置放在 ~/.config，/usr/share/omarchy 是系统管理的默认配置。参阅官方 Dotfiles 文档。

一个实用学习练习

选择一项任务，例如连接耳机。列出面向用户的动作、负责服务、相关应用设置和预期结果。沿地图阅读关联组件，先了解用途与检查方式，再考虑修改配置。

然后用一句话描述失败边界：“配对成功，耳机播放正常，但这个应用录到的是笔记本麦克风。”这比重装整个音频组件更有助于缩小范围。窗口、输入法与联网也可以用同样方法理解。

系统整体介绍见 Omarchy 是什么？。需要诊断而不是学习架构时，进入网络与硬件。地图解释职责，任务指南帮助证明结果。