Omarchy 深度拆解：4.7 万星的 Arch 桌面，把 23 个 Agent 装成第一公民

Omarchy 深度拆解：4.7 万星的 Arch 桌面，把 23 个 Agent 装成第一公民

这次不是又一个 Ubuntu 皮肤，值得花十分钟看清楚。

我第一次翻 Omarchy 的手册目录时，本来只想扫一眼，结果在"AI"那一章停住了——里面是一张命令表：claude、codex、opencode、pi、crush、gemini、qwen、kimi……一共二十多个 Agent CLI，全部预置成可以直接敲的系统命令，还配了一套共享的 AGENTS.md。

一个 Linux 发行版，把 Coding Agent 当成了和终端、编辑器同级的默认组件。这件事本身就比"好看"更值得研究。

Omarchy 2025 年 6 月开源，2026 年 11 月初发布 4.5 版本，现在 GitHub 上是 46,879 star、6,073 fork，MIT 协议，主仓库仍在每天提交。它的作者是 Ruby on Rails 的创始人 DHH（David Heinemeier Hansson），一个长期在公开场合骂 Linux 桌面"丑、碎、难用"的人，最后自己下场做了一套。

这篇文章按一条实装的路径来写：它到底交付了什么、为什么这样做、装完会遇到哪些坑、更新和回滚的机制怎么运作、Agent 和主题这两块的设计怎么落地，最后说清楚什么情况下你不该用它。

本文提纲

  1. 是什么：一份"主厨套餐"，不是又一个发行版
  2. 为什么会有它：桌面 Linux 缺的从来不是包
  3. 装一遍：从 ISO 到第一屏
  4. 更新、快照与四个通道
  5. Agent 是一等公民
  6. 主题不是一个壁纸
  7. 这个发行版自己是用 Agent 写的
  8. 横向比较：跟 Ubuntu、裸 Arch、NixOS、macOS 比
  9. 边界与成本：什么时候别用

一、是什么：一份"主厨套餐"，不是又一个发行版

名字里藏着立场。Omarchy = omakase（日料里的"主厨发办"）+ Arch：你不用点菜，厨师按自己的判断给你上一套。

它的自我描述是 "Beautiful, Modern & Opinionated Linux"，重点在 opinionated（有主见）。这一条决定了它和绝大多数发行版的区别：Ubuntu、Fedora 交付的是"一堆可以自由拼装的包"，Omarchy 交付的是"拼装完成的结果"。快捷键、顶栏、菜单、主题、字体、截图录屏、剪贴板历史、通知栈、输入法、默认 GUI 应用，全是预设的一部分，你开机就能用，而不是开机才开始配置。

技术骨架是这样的：

  • 包管理层是 Arch。Omarchy 自己也以 pacman 包的形式发布，走自己的仓库 omacom-io/omarchy-pkgs。
  • 桌面是 Hyprland（平铺合成器，4.5 起每个工作区可以切到 floating 或 scrolling），外壳是 Quickshell 写的，源码在仓库的 shell/ 下。
  • 命令行工具链用 mise 管理，Agent CLI 也是。
  • 内置 23 套主题（Tokyo Night、Catppuccin、Gruvbox、Kanagawa、Jade Horse 等），主题不是壁纸包，而是分发给几十个应用的配色配置。
  • 文档本身就是产品的一部分：manual/ 有 51 章，从"从 Mac/Windows 过来"写到双系统安装和无加密安装。

同样重要的是它不是什么：

它不是一个服务器发行版。默认全盘加密、图形栈优先、桌面外壳常驻，拿它跑生产服务是给自己找事。它也不是"教你手动配置 Arch"的教程；恰恰相反，它把 Arch wiki 里那些需要你亲手做的决定全替你做了。它还不跟随 Arch 官方源：稳定通道走的是自己的镜像 omarchy-mirror，故意比 Arch 最新状态落后一个月。

至于"社区项目"这个标签，得打个折扣。它是 DHH 主导、180 多位贡献者参与的单一项目，决策权集中。这既带来了 4.5 那种"十二周合 740 个 PR"的执行力，也意味着路线会随一个人的审美变。

二、为什么会有它：桌面 Linux 缺的从来不是包

桌面 Linux 的老问题不是缺软件。Chrome、VS Code、Docker、OBS、Steam 都有 Linux 版，Arch 的 AUR 里几乎没有找不到的东西。真正难的是从"装完系统"到"这是一台能好好工作的机器"之间那段路：输入法要配、字体要调、HiDPI 要算缩放、通知要接、截图快捷键要自己绑、录屏要装三件套、剪贴板历史要么没有要么散在三个工具里。

这条路每一段都有教程，但没人负责把它们拼成一致的整体。结果就是同一套硬件，两个人装出来是两台完全不同的机器，出了问题也没法互相求助。

Omarchy 的赌注是：把"默认值"当成核心产品来做。4.5 的更新日志里能看出这种取向——它没有去追新功能清单，而是补那些"每天都要碰但一直没人管"的地方：酒店机场 Wi-Fi 的认证页、通知卡片上的验证码、把窗口最小化到 dock、把主题切成视频背景。这些都是体验债，不是技术亮点。

数据上，这不是一个人的周末项目：4.5 从 4.0 到发布用了十二周，合并 740 多个 PR，来自 180 多位贡献者。同时它也付出了代价：GitHub 上 6,687 个 open issue，说明吞吐量上来了，清理跟不上。

三、装一遍：从 ISO 到第一屏

安装流程本身很短，短到有点反常识。

下载 ISO（omarchy.org），用 Rufus、balenaEtcher 或 caligula 写进 U 盘，从 U 盘引导。然后在 BIOS 里关掉 Secure Boot 和 TPM——手册里的原话是"它们是微软的安全方案，为 Windows 和微软相关的 Linux 发行版准备"，不关就装不了。

接下来选全盘安装还是空闲空间安装（后者就是双系统，Windows 那边得先关掉 BitLocker），选盘，等。安装默认开全盘加密，这不是可选项而是默认值，手册的建议很直白：任何可能丢失或被盗的电脑都该加密。

这里有个具体的坑：全盘加密在开机时要输密码，而蓝牙键盘在解密阶段是不工作的，原因和进不了 BIOS 一样。所以要么用有线键盘，要么用 2.4G 接收器的那种。DHH 自己在手册里安利了一款 Lofree Flow84，这段读起来很像个人博客而不是发行版文档，但它确实是一个新手会踩的坑。

4.5 换掉了安装器。以前是逐个装 940 个左右的包，现在叫 F1 的新安装器直接解包一份预构建的 root 镜像，只额外装这台机器独有的包，安装时间大概减半。极端案例是 AMD 的工程师 Anush Elangovan 在自己的笔记本上做到了 7 秒装完。这个数字更像营销素材，但机制是实的：从"包管理器解依赖"变成"解压镜像"。

还有两个不太常见的能力。在安装器第一个界面按 Ctrl + C，可以切到"为别人装"的模式：系统照装，但键盘布局、用户名、密码这些个人信息全部推迟到新主人第一次开机时再填，加密密码也用他选的。另一个是无人值守安装，把配置放在第二块盘上，全程不需要键盘，批量部署虚拟机或机群时用得上。

对中文用户有个实际利好：安装器里可以直接选简体中文拼音输入法，50 种语言和 5 套输入法（日语 Mozc、韩语 Hangul、拼音、注音、仓颉）都带对应的字形字体，Super + I 切换输入语言，候选窗跟随主题配色。

四、更新、快照与四个通道

Omarchy 的更新不是 pacman -Syu，而且它明确不让你这么干。

正门是 Super + Space 打开 Omarchy 菜单里的 Update > Omarchy，或者终端敲 omarchy update。这条命令负责的不只是包：它先给根文件系统打一份快照，然后跑 pacman 事务（Omarchy 包 + Arch 镜像 + 你装的 AUR 包），事务结束后再跑 migrations——那些把系统配置同步到新版本形态的脚本，仓库里现在有 263 个，按 Unix 时间戳命名。

MERMAID_BLOCK_0

为什么必须走这条路径？因为直接升级会跳过快照、跳过 migrations、跳过配置更新。所以 Omarchy 在 pacman 里装了拦截：你手敲 pacman -Syu 或 yay -Syu，会被中止并被告知改用 omarchy update；它也会告诉老手怎么单次绕过这个拦截。

快照能救什么，救不了什么

快照在每次更新时自动创建，用的是 Limine 引导器（2.0 起是默认，GRUB 和 systemd-boot 下没有这个功能）。更新后出问题，重启时在引导菜单里选更新前的那份快照就能进去，进去后点通知或敲 omarchy-snapshot restore 恢复。

恢复的边界必须讲清楚：它只恢复根文件系统，不动 /home。所以它能救"更新把系统搞坏了"，救不了"我把文件删了"。更麻烦的是 migrations 的运行记录存在 ~/.local/state/omarchy/migrations/ 里，也就是在 /home 下，恢复时会一起保留。结果是：你回滚到旧快照，那些在快照之后跑过的 migration 仍然被标记为已完成，下次更新不会重跑，旧版本需要的那部分配置就永久缺了。这不是 bug，是设计取舍，但它是回滚后最容易踩的暗坑。

配置文件也有类似情况：~/.config 原样保留，如果你回滚的是一个"配置格式变新了"的应用，得手动收拾。

四个通道

稳定通道（stable）是新装默认，跟官方 release，Arch 镜像落后一个月，留出时间发现需要改配置的不兼容。RC 通道用于大版本发布前的收尾验证。edge 通道让你跟最新开发构建和最新 Arch 包，官方明说只适合能自己救系统的老手。dev 通道直接把系统链到 ~/omarchy 的 git 检出，配合 edge 包，属于开发 Omarchy 本身的人用的。

切换在 Update > Channel 或 omarchy-channel-set。另外系统跑的是自己的 linux-omarchy 内核，可以并装官方 linux 或实验内核，用 omarchy-kernel set 切换，其余内核仍留在引导菜单里做后备；固件更新走 Update > Firmware，内部是 fwupd。

真把配置搞坏了还有最后一招 omarchy reinstall：重装默认包、切回 stable、降级过新的包、重置配置文件。代价是你对默认配置的所有改动都会被覆盖。

五、Agent 是一等公民

这是 Omarchy 和其他 Linux 桌面最不一样的地方，也是最容易被误读的地方：它没有内置一个 AI 聊天框，它的做法是把二十多个 Agent CLI 当成系统级命令来分发。

命令 Agent
claude Claude Code
codex OpenAI Codex
opencode OpenCode
pi Mario Zechner 的 Pi
amp Amp
crush Charm 的 Crush
grok xAI Grok Build
qwen 阿里 Qwen Code
kimi Kimi Code
hermes Nous Research 的 Hermes
ori OpenRouter 的 harness，可以拿它的模型目录驱动别的 Agent

（完整清单在手册 17-ai.md 里，一共 23 条，包括 Copilot、Cursor CLI、Devin、Antigravity、MiniMax、Muse、Kiro 等。）

机制上有三个点值得单独看。

第一是懒安装。除了 Hermes，这些 CLI 都不在系统镜像里，而是交给 mise：第一次敲命令时才装，之后复用；mise 最多每四小时检查一次新版本，失败或离线就用已装版本继续跑。这个设计让基础镜像不必为二十多个 Agent 付体积代价，但也带来一个反直觉的冲突：Agent 自带的更新器不认这套安装。codex update 会直接失败；claude update 可能报成功，却装出第二份 mise 不跟踪的副本。想用官方安装器的人得把对应包加进 disable_tools 里，明确退出这套管理。

第二是统一的指令文件。所有 Agent 的个人规则写在 ~/.agents/AGENTS.md，共享技能放 ~/.agents/skills，然后 Omarchy 把这份文件软链到每个 harness 自己的全局位置：~/.claude/CLAUDE.md、~/.codex/AGENTS.md、~/.pi/agent/AGENTS.md、~/.config/opencode/AGENTS.md、Copilot 的 ~/.copilot/copilot-instructions.md。Crush 和 Amp 读的是 ~/.config/AGENTS.md 这个链，omp、Kimi、DeepSeek Harness 直接读 ~/.agents/AGENTS.md。你只维护一份规则，换 harness 不用重写。

这个模式在 Omarchy 自己的仓库里也用着：根目录的 CLAUDE.md 只有 11 个字节，内容是一行 @AGENTS.md。

第三是调度的快捷键。Super + Shift + Ctrl + A 在独立终端里起默认 Agent；Super + ~ 从任意界面拉下一个 Quake 风格的终端浮层，第一次打开就会启动默认 Agent，再按一次收回，会话还在原地。终端里还有 a（当前终端内联跑默认 Agent）、c/cx/cy 分别直起 OpenCode、Claude Code、Codex。

注意这里有个真实的危险：以这种方式启动的 Agent 跑在各自"不问就直接干"的模式里，包括 omarchy agent prompt "..." 把任务直接递过去。手册用感叹号提醒过这一点，它不是开玩笑。

4.5 还把订阅管理做进去了。顶栏的 agents 面板把每个 Agent、每个账号的套餐、5 小时会话额度、每周额度、重置倒计时、预付余额放在一页，数据每 15 分钟由 omarchy agent usage-update 重新生成，也能通过同步目录合并其他机器的用量。多订阅（比如公司一个 Claude、个人一个 Claude）可以同时保持登录，omarchy agent account add claude Work 添加，第二个账号起走隐私窗口登录以免浏览器里已登录的账号被误认，千万别用 CLI 的 logout 来做切换——它会把保存的登录凭证吊销掉。换机器时 omarchy agent account copy user@laptop 通过 SSH 把三家（Claude、Codex、Grok）的登录一次搬过去，设置、技能和会话历史仍留在各自机器上。

我的判断：统一 AGENTS.md 那一套是真省事，一次维护处处生效；懒安装是真聪明，但它和官方更新器的冲突会让"我明明 update 了却还是旧版本"这种问题变得难查。

六、主题不是一个壁纸

23 套内置主题看起来像审美问题，实际上是一个配置分发系统。

一套主题的核心是 colors.toml。omarchy-theme-set 执行时会把主题复制到一个暂存目录，叠加你的用户覆盖（~/.config/omarchy/themes/<name>/），然后用 default/themed/*.tpl 这一批模板渲染出各应用自己的配置文件，最后整体搬到 ~/.local/state/omarchy/current/theme，并通知正在运行的桌面外壳。

渲染规则里有一条很关键：模板不覆盖已存在的文件。所以你可以只写一个 shell.toml 或 hyprland.lua 覆盖模板输出，其余照旧；用户的模板（~/.config/omarchy/themed/*.tpl）先于内置模板处理，同名输出会跳过内置版本。

主题生效后要做重着色，分成两组并行执行：第一组是屏幕上看得见的东西——终端以及终端里跑的程序、Hyprland 重载；第二组是 GTK、浏览器策略、编辑器、Agent、键盘背光。从菜单或脚本切换时不等待第二组，直接返回，失败写进 ~/.local/state/omarchy/theme-set.log 并在通知里点名；在终端里跑或设置 OMARCHY_THEME_WAIT=1 才会等全部完成。批量切换用 flock 串行，避免旧主题的慢写入落在新主题之后。

4.5 给主题加了两样东西：背景可以是视频（锁屏显示这一帧静帧），以及每套主题可以带一段 5 到 7 秒的静音开场动画，登录或切换时播放。文件名配对即可，backgrounds/0-winding-road.webp 配 backgrounds/intros/0-winding-road.mp4，不需要注册表也不需要校验文件。不想要就在 Appearance > Animations 里关掉。

这套设计的价值在于：主题作者写一份 colors.toml，就能让编辑器、浏览器、终端、Agent 的配色全部对齐，而不是各自去改 dotfile。代价也明显——想做主题得理解模板渲染和覆盖优先级，这不是拖一张图片进去的事。

七、这个发行版自己是用 Agent 写的

翻仓库的 AGENTS.md（15.9KB）会发现一件更有意思的事：这份给 Agent 读的说明，本身就是在教 Agent 怎么改这个系统。

它把工作分成若干类，每类配一份任务指南，放在 agents/skills/：改 bin/ 里的命令看 command-metadata.md；动 install/ 看 install-scripts.md；改 mise 管理的工具看 mise-tools.md；改 shell/ 下的 Quickshell 桌面看 shell-dev.md；加图标字体看 icon-font.md；写图形化验收测试看 acceptance-tests.md；跑 qemu 里的整套测试看 oligarchy-tests.md；改任何动画看 motion.md；改完有视觉效果的必须看 visual-verification.md；改 migrations 看 migrations.md。

文档树也按用途拆成三份：agents/skills/ 写"做 X 的时候按这个步骤"，docs/ 写"系统是怎么长的"（更新流程、主题、外壳架构、生命周期分发、i18n、输入法、通知），manual/ 写给最终用户，且明令不许写内部实现。

这几件事凑在一起说明一个取向：这个项目的迭代速度依赖 Agent，而 Agent 要产出可合并的代码，前提是把"怎么改"写成它能读的流程，再加上能在 qemu 里跑、能截图验证的自动化验收。263 个 migration 不是手写的浪漫，是有配套流程的结果。

删功能的方向也说明立场。4.5 之后新装系统不再带 OBS Studio 和 Kdenlive，被自研的 Monologue（一键录屏）和 Omacut（裁剪）替代；Lazydocker 移出默认（Docker 和 Compose 仍在）；Xournal++ 被 Signed 取代，后者只做一件事——打开 PDF、贴签名、填日期、存副本。一个发行版敢把成熟工具换掉，通常意味着它更在意"默认路径要短"，而不是"功能要全"。

八、横向比较：跟 Ubuntu、裸 Arch、NixOS、macOS 比

交付什么 更新与回滚 上手成本 适合谁
Omarchy 装好的 Arch + Hyprland + 预设体验 + Agent 集成 omarchy update，自动快照，Limine 回滚（仅根分区） 中：会用快捷键就会用，但坏了要懂 Arch 个人主力机、愿意接受滚动更新的人
裸 Arch + 手动 Hyprland 一个空系统加 wiki 链接 pacman，回滚靠自己搭 高：配置要几天到几周 想完全掌控每一行配置的人
Ubuntu LTS 稳定但保守的桌面 apt，版本回滚基本没有 低 企业统一环境、要 vendor 支持的场景
NixOS 声明式整机配置 生成式回滚，回滚粒度最细 很高：要学一套语言 多机一致、可复现环境
macOS / Windows 硬件绑定的完整生态 系统级还原点 低 需要商业软件与硬件生态的人

跟前代比，进步是具体的：2.0 引入 Limine 和快照，4.0 把 Omarchy 彻底包化，4.5 补上 floating 工作区加 dock（对从 macOS/Windows 来的人是降门槛的关键）、50 种语言、原生装到 M1/M2/M3 和 Neo MacBook（brew install omacom/mac/omarchy）、首个 ARM ISO 支持 NVIDIA DGX Spark 和 N1X 笔记本。

跟替代方案比，它牺牲的东西同样具体：Arch 的滚动更新风险一点没减少，只是加了快照兜底；没有 LTS，没有商业支持，没有企业 MDM 那套东西；Secure Boot 必须关，这在很多公司电脑上直接是死路。

九、边界与成本：什么时候别用

把坑集中说清楚。

硬件与固件层面，必须关 Secure Boot 和 TPM，这一条会劝退三类人：公司发的笔记本（固件锁或 MDM 策略）、部分固件不配合自定义 EFI 项的机器（Direct Boot 功能干脆拒绝在 American Megatrends 和 Apple 固件上运行）、以及想保留 Windows 双系统又不想动 BitLocker 的人。全盘加密加上蓝牙键盘不可用，是另一道具体的门槛。

平台成熟度层面，Apple Silicon 的安装器只覆盖 M1、M2、M3 和 Neo，M4/M5/M6 还在做；ARM ISO 刚落地，DGX Spark 和 N1X 属于"初步支持、有毛刺"，Snapdragon 还没到。想在这些新硬件上当天日常机，最好等一两个版本。

维护层面，项目是单一主导者加高吞吐贡献者，6,687 个 open issue 是这种模式的直接体温。它的更新策略也确实激进：稳定通道的 Arch 镜像只落后一个月，意味着你在用一个比 Ubuntu 激进得多的包集合，快照能救系统，但救不了"某个库升级后你的老项目跑不起来"。

回滚层面，记住两条：快照只恢复根分区，/home 原样保留，所以别指望它救误删的文件；migrations 的完成标记在 /home 里，回滚后那些 migration 不会重跑，缺的配置要自己补。

还有一个学习曲线问题。Omarchy 的入口是 Super + Space 的菜单，几乎所有系统操作都能从那里摸到，这对新手友好；但底层仍是 Hyprland，输入配置现在是 Lua 的 ~/.config/hypr/input.lua。想深度定制，绕不开 Hyprland 和 Arch 的基础知识——它省掉的是配置时间，不是学习成本。

所以什么时候别用：需要厂商支持的生产环境、需要团队统一且有合规要求的办公机、要求硬件加密与 Secure Boot 同时在线的设备、以及任何服务器。什么时候值得试：你自己的主力笔记本，愿意接受滚动更新，想要一套装完就能干活、还顺手把 Agent 接进来的桌面。

参考文档与链接

你会为了预设体验放弃自己配 Arch 的掌控感吗？评论区聊聊你的取舍。觉得有用就点个赞，让更多在纠结桌面的人看到。

作者: itech001
来源: 公众号：AI人工智能时代(the-ai-era)
网站: https://www.theaiera.top/
关注每日最新AI新闻和技术博客，主页有更多的文章的AI 技术参考：https://www.theaiera.top

本文首发于 AI人工智能时代，转载请注明出处。

posted @ 2026-11-12 23:59  iTech  阅读(3)  评论(0)    收藏  举报