Omarchy 进阶定制：Hyprland、快捷键、顶栏与自定义主题

安全定制 Omarchy 的 Hyprland 布局、快捷键、Quickshell 顶栏、colors.toml 主题和应用模板，并保留升级与回退能力。

可维护的 Omarchy 定制应使用用户级覆盖、一次改变一个变量，并保留可回退记录。配置路径和 Lua/TOML/JSON 结构会随版本变化，当前系统文件和官方手册优先于旧教程。

定制前建立基线

保存当前主题、终端、编辑器和更新通道；
复制准备修改的用户文件，并记录日期；
如果配置目录已经受 Git 管理，先提交干净基线；
确认可以进入 TTY 或恢复已知可用配置；
每次只修改一个子系统并重新登录验证。

不要直接编辑 /usr/share/omarchy 中由软件包管理的默认文件。用户覆盖通常位于 ~/.config；通过 Omarchy 菜单打开的当前文件最可靠。

Hyprland 外观与布局

当前 Omarchy 把显示器与外观规则拆分到 Lua 配置，例如 ~/.config/hypr/monitors.lua 和 ~/.config/hypr/looknfeel.lua。可以调整窗口间距、边框、圆角和默认布局。

例如官方 Common Tweaks 使用 looknfeel.lua 的 hl.config 结构设置圆角或移除间距。不要把飞书中的 hyprland.conf 或旧式配置片段直接混入 Lua 文件；先打开当前注释示例，并用 hyprctl 验证语法和运行状态。

布局可在 dwindle 与 scrolling 之间切换。先在单独工作区临时体验，再决定是否设为默认。

自定义快捷键

先在系统 Hotkeys 帮助中确认动作和冲突，再找到当前版本的用户绑定入口。定制时记录：修饰键、按键、动作、描述和与输入法/应用的冲突。

安全原则：

保留菜单、终端、关闭窗口和故障恢复入口；
不把危险删除/关机动作绑定到容易误触的组合；
Mac 键盘和多语言布局要在实际硬件测试；
修改后热重载，并注销/重启再验证；
为每项自定义写一句目的，便于日后清理。

顶栏与 Quickshell

顶栏可拖动到屏幕边缘、重新排列组件，也可用 CLI：

omarchy bar position bottom
omarchy bar transparent toggle
omarchy plugin list

当前自定义布局保存在 ~/.config/omarchy/shell.json。一旦产生用户文件，它会成为完整配置而不是深度合并补丁，因此新版本新增的默认组件可能不会自动出现。需要回到官方布局时先备份，然后运行：

omarchy bar defaults

创建自定义主题

复制 /usr/share/omarchy/themes 中的现有主题到 ~/.config/omarchy/themes/<name>，主要编辑 colors.toml。颜色会生成终端、btop、Chromium、Hyprland、Neovim、Helix、VS Code、Obsidian 和 Omarchy Shell 等配置。

主题至少检查：

正文、链接、焦点和错误状态的对比度；
16 色终端及选中文本；
浅色主题的 mode = "light"；
壁纸版权和分发许可；
多屏、锁屏和高亮状态。

安装第三方主题时，Omarchy 会过滤部分可执行或高风险配置，但仍要审阅仓库、许可证和维护情况。

给未覆盖应用生成主题

~/.config/omarchy/themed/ 可以放置 .tpl 模板，使用颜色占位符生成应用配置。用户模板可能覆盖内置模板；先从官方 sample 复制最小版本，确认目标路径，再测试主题切换和回退。

更新后的维护

更新可能把冲突用户配置保存在同目录的 .bak 文件。逐行比较新默认、用户版本和备份，不要机械覆盖。单项损坏优先使用 Update → Config；整体异常再阅读快照与恢复。

来源：Common Tweaks、Making Your Own Theme、The Top Bar。