Omarchy Quattro 升级全清单：Quickshell 重构桌面组件后的平滑迁移
Omarchy 4.0 Quattro 大版本升级实战指南：Quickshell 统一桌面架构解析、Hyprland Lua 配置迁移、菜单两步安全升级流程与系统快照回滚方案。
- quattro
- quickshell
- updates
- guide
Omarchy 4.0（代号 Quattro）是该项目诞生以来最大规模的底层架构重构。这不仅仅是一套全新的主题皮肤，而是将整个桌面环境全面重构并统一在 Quickshell 基础框架之上：顶部栏（Top Bar）、应用启动器、系统菜单、通知中心、屏幕状态显示（OSD）、控制面板、锁屏界面以及 Polkit 提权认证代理现已整合至单一进程中高效协同运行。
这意味着 3.x 时代的旧后台守护进程组合已正式退役：Waybar、Walker、Mako、SwayOSD、hyprlock、hypridle、swaybg 以及 polkit-gnome 均已被 Quickshell 原生组件取代。本升级手册将帮助现有 Omarchy 用户平稳、安全地过渡到 Quattro。
选择平滑升级还是全新安装？
| 当前机器状态 | 建议处理方式 |
|---|---|
| 已有 Omarchy 3.x 且配置了日常开发环境 | 原地平滑升级： 依次运行 Update > Omarchy 与 Update > Omarchy to Quattro |
| 新设备或希望彻底重构系统 | 全新安装： 下载官方 4.0.0 ISO 镜像 |
| 与 Windows 共存的双系统需求 | Quattro ISO 安装： 直接使用 4.0 引入的未分配空间安装（Free space install） |
Quattro 带来的核心架构变革
1. 基于 Quickshell 的统一桌面环境
- 原生交互式顶部栏： 深度集成了工作区切换器、时钟、天气预报、系统托盘、电量显示与系统更新状态指示灯。
- 全局综合主菜单 (
Super + Space)： 将应用检索启动与系统维护指令整合为一体化搜索界面。 - 独立应用启动器 (
Super + Alt + Space)： 专为快速检索和启动已安装应用保留的独立面板。 - 原生通知与历史回顾： 完整的通知管理体系，支持通过
Super + Shift + Alt + ,回放历史通知记录。 - 模块化控制面板： 音频 (
Super + Ctrl + A)、蓝牙 (Super + Ctrl + B)、网络 (Super + Ctrl + W)、显示器 (Super + Ctrl + D) 与电源 (Super + Ctrl + P) 均可通过快捷键一键唤起。 - 统一锁屏与鉴权： 锁屏与 Polkit 提权窗口均原生接入 Quickshell，无需额外配置。
2. Hyprland 配置全面采用 Lua 语法
Quattro 将 Hyprland 配置文件语法全面迁移为 Lua，以无缝兼容 Hyprland 0.56 及未来版本。用户自定义配置可通过 Setup 菜单在 ~/.config/hypr/*.lua 模块化文件中进行管理。
3. 标准化软件包分发机制
Omarchy 核心组件由原先的 Git 仓库维护模式演进为标准 Arch Linux 系统软件包（ALPM）。系统更新受专属保护机制接管，确保更新前自动触发快照备份。
升级前准备清单（Pre-Flight Check）
- 关键数据备份： 将重要工作文档、SSH 密钥、GPG 凭据、浏览器数据备份至外部移动存储。
- 检查磁盘剩余空间： 确保根分区留有充足容量供下载升级包及创建 Btrfs 系统快照。
- 保证网络通畅稳定： 在大版本更新过程中，建议优先连接有线网络以防中断。
- 核对更新通道： 可在主菜单
Update > Channel中确认当前所在通道（stable / rc / dev）。
标准两步升级流程
请在图形界面中通过官方菜单执行升级：
- 按下
Super + Space打开 Omarchy 主菜单。 - 首先点击并执行
Update > Omarchy。该步骤会同步系统软件源数据库并完成当前版本的必要前置迁移。 - 接下来点击并执行
Update > Omarchy to Quattro。 - 耐心等待升级脚本完成软件包替换并重构引导配置。
- 重启计算机： 重启是切换至 Quickshell 桌面环境的关键节点。
- 重启登录后，按下
Super + K验证全新 Quattro 快捷键体系已就绪。
升级期间注意事项：
- 切勿在终端事务执行中途强行断电或关闭窗口。
- 请勿直接执行未经封装的
pacman -Syu命令，官方omarchy update流程会自动处理快照创建与升级钩子。
升级后功能验证清单（Smoke Test）
系统重启后，建议快速核验以下核心功能：
- 顶部栏： 正常显示且可交互（双击顶栏空白处可切换半透明效果，支持拖拽调整屏幕边缘位置）。
- 综合菜单： 按下
Super + Space能顺畅呼出并检索应用。 - 快捷键帮助： 按下
Super + K正常展示全新的速查表。 - 网络控制面板： 按下
Super + Ctrl + W可正常连接 Wi-Fi 与以太网。 - 锁屏功能： 按下
Super + Ctrl + L可正常触发 Quickshell 锁屏。 - 终端与浏览器：
Super + Return启动 Foot 终端，Super + Shift + Return启动浏览器。
异常排查与快照回滚方案
若升级后遇到桌面加载异常或驱动不兼容：
- 一键快照回滚： 重启设备，在 Limine 启动菜单中选择 System Snapshots，选中升级前自动生成的快照即可无损回退系统。
- 获取诊断日志： 若能进入 TTY 控制台（快捷键
Ctrl + Alt + F3），可运行omarchy-debug导出排错报告。 - 寻求社区帮助： 官方 Discord 的
#omarchy-help频道有活跃的维护人员提供支持。 - 恢复默认配置： 若历史自定义配置与新组件冲突，可通过
omarchy reinstall重置系统默认配置文件。