Omarchy 快照与系统恢复：回滚更新、重装配置和清理空间
理解 Omarchy 自动快照、Limine 启动恢复、配置重装、Reset 与磁盘清理边界，在更新失败后选择正确恢复层级。
Omarchy 的恢复工具解决的是不同层级的问题：快照回退根文件系统，配置恢复处理被改坏的默认配置，完整重装用于更广泛的系统损坏，而独立备份才负责个人文件。先判断故障层级，避免用最重的工具解决最小的问题。
四层恢复模型
| 层级 | 适用问题 | 不负责什么 |
|---|---|---|
| 撤销单个用户改动 | 刚修改的主题、热键、应用配置 | 系统包和磁盘错误 |
| 恢复单项/全部默认配置 | Omarchy 管理的配置损坏 | 用户数据恢复 |
| 启动并恢复系统快照 | 更新造成的系统包或根文件系统问题 | /home 中误删的文件 |
| 独立备份恢复 | 文件误删、磁盘损坏、设备丢失 | 自动重建系统配置 |
快照不是备份
官方快照恢复根文件系统，但不会恢复 /home，~/.config 也会保留。快照与数据位于同一磁盘时，磁盘损坏可能同时失去两者。
自动快照与手动快照
Omarchy 通过其更新入口升级时会自动建立更新前快照。需要在重大系统调整前手动创建时，当前官方命令是：
omarchy-snapshot create创建前检查磁盘空间，并记录时间、目的和系统状态。快照过多会消耗 Btrfs 空间；不要在磁盘已经接近满载时盲目创建更多。
从 Limine 启动并恢复
更新后无法正常使用时：
- 重启并进入 Limine 启动菜单；
- 根据日期和 Omarchy 版本选择更新前快照；
- 进入快照后先验证问题是否消失；
- 点击系统提示执行恢复，或运行官方命令；
- 恢复完成后重启并复查关键工作流。
omarchy-snapshot restore此功能要求使用 Limine；官方说明中它是 Omarchy 2.0 之后的默认引导器，GRUB 和 systemd-boot 安装不具备同样能力。启用 Direct Boot 后，需要从固件启动菜单主动选择 Limine 才能看到快照。
配置恢复与完整重装
如果只有某个 Omarchy 默认配置被改坏，优先在菜单 Update → Config 恢复对应配置。更新为保护用户改动而生成的 .bak 文件应先比较，不要直接覆盖回去。
系统包、通道和多组默认配置同时异常时，当前官方 CLI 提供：
omarchy reinstall它会重新安装默认 Omarchy 包、回到 stable、降级过新的包并重置默认配置。用户对 Omarchy 默认配置的修改会被覆盖，因此运行前必须阅读当前帮助并备份差异。
飞书或旧教程中可能出现 omarchy-reinstall、omarchy reinstall configs 等写法；命令体系已经变化，应以 omarchy --help 和当前官方手册为准。
Reset、Broom 与 Debug 的边界
- Reset：面向交接设备或重置用户环境，执行前必须确认账户、加密和个人数据影响；
- Broom/清理：用于清理缓存、旧包、日志或快照，先查看将释放什么，不手动删除未知 Btrfs 子卷；
- Debug：收集版本、服务和日志，用于诊断，不应自动被当成“修复命令”。
CLI 组名和菜单位置会变。先运行：
omarchy commands
omarchy debug
omarchy <group> --help公开 debug 输出前移除用户名、主机名、网络、挂载路径、令牌和设备序列号。
更新失败决策
- 单个应用异常：保留日志，重启应用并撤销最近配置；
- 多个应用异常但系统可用：核对更新输出和配置迁移；
- 桌面或核心包在更新后损坏：启动更新前快照；
- 快照正常：确认后恢复，并记录引发问题的包；
- 快照也失败：使用恢复介质和独立备份，不要连续执行未知命令。
日常更新流程见安全更新指南，命令发现方法见Omarchy CLI 速查。