顶栏定制：布局更紧凑，文字更清楚

假设笔记本上的时钟太长，文字偏小，顶栏显得拥挤。我们依次完成三个目标：缩短时钟、调整组件顺序、放大 Shell 文字但不让横向顶栏随之自动变高。分开调整，才能知道是哪一步改善了体验。

示例适用于固定源码中的内置 Omarchy Shell 顶栏，不适用于 Waybar。先查看 omarchy version、omarchy bar --help 和 omarchy plugin list。如果本机仍用 Waybar 或没有这些命令，应查对应版本文档，不要照本页创建新文件。这里的版本是开发源码基准，不代表所有 4.x 安装都支持。

1. 布局与外观怎样配合

shell.json → 使用哪个顶栏、有哪些组件、顺序和组件设置
当前主题的 shell.toml → 主题提供的颜色、间距和尺寸
个人 shell.toml → 在主题之上覆盖局部外观
Omarchy Shell → 绘制顶栏和弹出面板

想做的事	使用的入口	改变的内容
移动顶栏或组件	omarchy bar / shell.json	位置
缩短时钟	时钟组件设置	显示内容
添加组件	插件命令	是否出现在布局中
放大 Shell 文字	个人 shell.toml 的 [font]	Shell 字体尺寸
固定顶栏高度	个人 shell.toml 的 [bar]	顶栏尺寸策略
改配色	主题选择器	主题提供的外观

定制后的 shell.json 是完整个人配置，不会把一个小片段与默认文件深度合并。不要用三行示例覆盖整个文件。shell.toml 则提供外观覆盖，个人键值优先于当前主题。因此，换主题时配色改变，个人固定高度仍可能保留。

2. 记录并备份原来的状态

下面都是查询命令，依次查看：

omarchy bar position
omarchy bar background
omarchy bar get omarchy.clock format
omarchy plugin list

时钟没有显式 format 时，查询可能没有值并以非零状态退出；记录为“继承默认格式”即可。再从当前 ~/.config/omarchy/shell.json 记录时钟所在区域和相邻组件。

文件存在时备份：

cp -i ~/.config/omarchy/shell.json ~/.config/omarchy/shell.json.before-bar-edit

如果文件不存在，记录“原来使用默认配置”。练习产生的新文件可以保留用于比较；要恢复原来的无文件状态，将新文件移到一个未占用的归档名称，再重启 Shell。不要用猜测的默认文件覆盖其他设置。

若个人 shell.toml 已存在，另外备份为 shell.toml.before-bar-edit。备份名称已占用时换一个名称，保留之前的恢复点。

3. 先缩短时钟，再决定是否删组件

omarchy bar set omarchy.clock format "HH:mm"

预期看到 14:35 这样的 24 小时时间。修改的是文字格式，不是系统时区。点击时钟确认日历仍能打开：缩短文字不应该失去原有面板入口。

想把时钟放到中间区域的第一项，再执行：

omarchy bar move omarchy.clock --section center --index 0

0 是该区域内的第一项，不是整个屏幕的第一个组件。中间锚点和其他区域的宽度仍会影响视觉位置。顶栏放到左右边缘时，组件可能改用紧凑形式，不会原样显示全部横向文字。

下面只是布局示意，不是系统截图：

修改前：[菜单 · 工作区] [状态 · 长时钟 · 天气] [托盘 · 系统控制]
修改后：[菜单 · 工作区] [短时钟 · 状态 · 天气] [托盘 · 系统控制]

先保留天气。如果缩短时钟已经解决拥挤，就不必为了截图整洁而删除有用功能。

4. 有目的地增减一个组件

从 omarchy plugin list 确认准确 id。比如本机提供 omarchy.media，且你需要播放控制：

omarchy plugin enable omarchy.media --section center

在能够提供媒体信息的应用中开始播放。已启用组件没有内容时可能不显示，这与“插件 id 不存在”不同。如果练习前没有它，可以这样撤销新增：

omarchy plugin disable omarchy.media

已经存在的组件用 omarchy bar move 移动；omarchy bar put 会保留已有位置。不要重复添加同一个 id 来尝试移动它。允许多实例的组件，还需要用来源区域与索引明确是哪一个实例。

右侧组件顺序改变，也可能改变数字快捷键对应的面板。检查你实际使用的鼠标操作与数字快捷键。

5. 放大文字并控制顶栏高度

用编辑器打开个人 ~/.config/omarchy/shell.toml。已有文件中合并下面键值，没有文件才创建；不要重复写 [font] 或 [bar] 节：

[font]
base-size = 14

[bar]
scale-with-font = false
size-horizontal = 28

这个例子调整 Shell 文字与横向顶栏。base-size 会影响菜单、弹出面板等 Shell 字体；尺寸开关阻止顶栏高度随基础字号同比增大。28 是尝试起点，不保证所有字体都能放下。

文字被裁切时，适当增加高度或减小字号。固定高度不会自动替你适配字体。受支持的屏幕刘海也可能抬高顶部栏的最小高度。竖栏使用 size-vertical；显示缩放会改变逻辑尺寸在屏幕上的实际大小，见显示器与多屏。

如果想同时调整 Shell、GTK 应用与终端文字，请看字体与文字大小。那个入口的影响范围比只改 Shell 更大。

6. 按现象定位失败环节

现象	下一步检查
命令提示未知参数	本机帮助和版本是否匹配
整个顶栏消失	顶栏隐藏开关、Shell 是否运行
只有一个组件缺失	准确 id、启用状态、是否有数据
编辑没效果	个人文件路径与 JSON/TOML 语法
换主题后只有高度不变	个人 [bar] 覆盖是否仍在
大字与图标重叠	可用空间、高度和字体字形尺寸

手动编辑 JSON 后，若已安装 jq，可以运行 jq empty ~/.config/omarchy/shell.json 检查 JSON 语法。它不能证明插件 id 正确或布局可用。编辑文件时先不要同时拖拽组件，两者都在修改同一份个人状态。

7. 验证与恢复要对应修改范围

检查时钟、面板、最小的屏幕，以及另一个主题。先记录原主题名称，比较后切回。需要确认登录后保留时，保存工作再注销并重新登录。

精确恢复时，复制回保存的 JSON 和 TOML 文件，再在未锁定的图形会话中运行 omarchy restart shell。这会短暂重启 Shell 界面，包括面板和通知处理，并非只刷新时钟。若 TOML 是新建的，删除本次增加的键值；只有文件没有其他要保留的设置时，才将整个文件归档。

omarchy bar reset 是切回内置顶栏，不会还原旧布局。omarchy bar defaults 会恢复随系统提供的顶栏布局及相关服务组件，不等于恢复你的个人备份。隐藏顶栏的开关也独立于布局文件，需要单独恢复。

来源与继续学习

顶栏命令源码 · Shell 配置与尺寸 · 官方顶栏手册

继续阅读配置如何生效、字体与文字大小或应用主题差异。