| AppLibrary |
Quickshell 中共享的 .desktop 应用索引，供 launcher/menu 等复用。 |
| atomic swap |
在 staging 完成后以 rename/替换让读者瞬间看到完整新版本。 |
| bar widget |
被 active bar 放进 left/center/right section 的插件 kind。 |
| cutover |
新旧实现真正切换的时刻；Quattro 升级中是 reboot。 |
| data plane |
真正执行窗口、包、服务、音频等工作的 Hyprland/pacman/systemd/PipeWire。 |
| deferred provisioning |
system install 时 owner 未知，把用户创建/finalization 延迟到首启。 |
| done marker |
记录某个用户生命周期动作已全部成功的状态文件。 |
| entrypoint |
插件 manifest 中某个 kind 对应的 QML 文件。 |
| first-party |
随 $OMARCHY_PATH 包发布、使用 omarchy.* 保留 ID 的 Shell 插件。 |
| first-run |
进入真实图形用户会话后执行的一次性初始化。 |
| generated state |
由命令从 defaults + user intent 编译出的活动结果，通常在 ~/.local/state。 |
| guard |
菜单条目的 when、checked、disabled Bash 条件。 |
| headless theme |
生成主题状态但跳过 Shell/Hyprland live hooks 的模式。 |
| hook |
用户在既定 event 后扩展行为的可执行文件或 .d 目录。 |
| IPC |
CLI 向已运行 Quickshell 调用方法的进程间通信边界。 |
| marker |
用文件存在性表达已完成/待处理事实；语义取决于所属目录。 |
| migration |
把已安装旧状态增量变成新版本预期状态的时间戳脚本。 |
| OMARCHY_PATH |
当前生效的 Omarchy 实现根；生产是 /usr/share/omarchy，开发可指 checkout。 |
| owner |
Omarchy 安装最终服务的非 root 桌面用户。 |
| package-backed |
实现/default 由 pacman 安装到系统路径，而非把 git checkout 当生产运行根。 |
| panel / overlay / menu |
按需加载并提供 open(payloadJson) / close() 的 Shell surface kinds。 |
| PluginRegistry |
发现、验证、合并并解析 Shell 插件身份与入口的常驻服务。 |
| provider |
菜单在运行时枚举 apps/fonts/power profiles 等动态 rows 的命名数据源。 |
| provisioning |
确定 owner、创建用户并完成用户级落地的过程。 |
| Quickshell |
Omarchy Shell 的 QML runtime；本文中的“Shell”通常指其常驻实例。 |
| staging |
在不可见临时位置验证/编译完整内容，再提交到活动位置。 |
| third-party plugin |
用户 plugins 目录中的未沙箱化 QML 代码，需显式 enable。 |
| UWSM |
将 Wayland compositor 与应用纳入 user systemd 会话的管理层。 |
| user intent |
用户明确维护、应在升级中保留的配置。 |
| user finalizer |
以 owner 身份补齐 home、默认应用和 fresh-install state 的阶段。 |
| wipe-pending |
Factory reset 的跨 boot 闸门；未清除时 provisioning 不得继续。 |