用途：为 Omarchy 桌面创建和管理主题。核心是在 colors.toml 中定义颜色，颜色会自动传播到所有桌面应用，包括终端（Alacritty/Kitty/Ghostty）、Hyprland、Waybar、btop 等。
主要能力：定义 22 个必需颜色变量（ANSI 常规 8 个 color0-color7、明亮 8 个 color8-color15，以及 accent、cursor、foreground、background、selection_foreground、selection_background 等）；支持模板变量三种格式：{{ name }} 输出 #RRGGBB（用于 CSS、TOML）、{{ name_strip }} 输出无井号值（用于 Hyprland rgb()）、{{ name_rgb }} 输出 R,G,B（用于 RGBA）。
使用方式：在 ~/.config/omarchy/themes/{theme-name}/ 下创建 colors.toml，必须定义全部 22 个变量，仅用 HEX 格式（#RRGGBB），并包含 backgrounds/ 目录及至少一张壁纸；浅色主题需创建空的 light.mode 文件。可选文件包括 preview.png、icons.theme、neovim.lua、vscode.json、btop.theme、chromium.theme、hyprland.conf。应用主题命令：omarchy-theme-set my-theme。其他命令：omarchy-theme-current、omarchy-theme-list、omarchy-theme-install <git-url>、omarchy-theme-remove my-theme、omarchy-theme-update、omarchy-theme-bg-next。
适用场景：为 Omarchy 桌面定制统一配色主题，覆盖终端、窗口管理器与状态栏等组件。
限制：缺少变量会导致错误；不支持 RGB、HSL 或命名颜色；应用未套用主题时可将静态配置放入主题目录覆盖模板，并检查变量名与 colors.toml 键一致；出现 yq 错误可执行 sudo pacman -S yq。更详细的各应用变量用法见 reference.md。