SuperAPI AI 工具集

omarchy

部署与运维

查看项目

更新于 10-16 08:02

技能介绍

用途:通过自然语言管理并配置 Omarchy Linux 系统,覆盖 Hyprland、Waybar、Walker、终端、主题、键位、显示器、字体、截图、系统更新与故障排查等。

核心约定:绝对不要修改核心文件。禁止编辑、写入或删除 ~/.local/share/omarchy/ 下的任何文件,该目录存放 Omarchy 核心系统文件;用户配置应放在 ~/.config/。若需改变由核心文件控制的行为,应改为在 ~/.config/ 中查找或创建对应覆盖配置。

命令发现:Omarchy 提供约 145 个命令,命名模式为 omarchy-<类别>-<动作>。可用以下命令查找: compgen -c | grep -E '^omarchy-' | sort -u 按类别查找示例:compgen -c | grep -E '^omarchy-theme' 或 compgen -c | grep -E '^omarchy-restart';查看某命令源码:cat $(which omarchy-theme-set)。

命令类别:omarchy-refresh-* 将配置重置为默认(先备份);omarchy-restart-* 重启服务/应用;omarchy-toggle-* 开关功能;omarchy-theme-* 主题管理;omarchy-install-* 安装可选软件;omarchy-launch-* 启动应用;omarchy-cmd-* 系统命令;omarchy-pkg-* 包管理;omarchy-setup-* 初始设置;omarchy-update-* 系统更新。

主要配置位置:Hyprland 位于 ~/.config/hypr/(hyprland.conf、bindings.conf、monitors.conf、input.conf、looknfeel.conf、envs.conf、autostart.conf、hypridle.conf、hyprlock.conf、hyprsunset.conf),Hyprland 保存配置后自动重载,无需重启;Waybar 位于 ~/.config/waybar/(config.jsonc、style.css);Walker 位于 ~/.config/walker/config.toml;终端配置为 alacritty.toml、kitty.conf、ghostty/config;其他包括 btop、fastfetch、lazygit、starship、git 配置。Omarchy 数据位于 ~/.local/share/omarchy/(bin/、config/、themes/、version)。

安全编辑流程:读取当前配置(cat ~/.config/<app>/config);改动前备份(cp ~/.config/<app>/config ~/.config/<app>/config.bak.$(date +%s));用 Edit 工具修改并保留原有结构与注释;应用改动(omarchy-restart-<app>,或 omarchy-refresh-<app> 重置并自动备份);最后解释所做修改。

常用操作:主题用 omarchy-theme-list、omarchy-theme-current、omarchy-theme-set <name>、omarchy-theme-next、omarchy-theme-bg-next、omarchy-theme-install <url>。键位编辑 ~/.config/hypr/bindings.conf,格式如 bind = SUPER, Return, exec, xdg-terminal-exec。显示器编辑 ~/.config/hypr/monitors.conf。系统命令包括 omarchy-update、omarchy-version、omarchy-debug、omarchy-lock-screen、omarchy-cmd-shutdown、omarchy-cmd-reboot。故障排查可用 omarchy-state、omarchy-debug、omarchy-upload-log、omarchy-refresh-<app>、omarchy-reinstall。

手册优先:遇到通用“如何做”类问题,应先获取 https://learn.omacom.io 上对应页面再回答,因为 Omarchy 的指导可能与通用 Linux 建议不同。以上内容均依据公开资料整理,未提供的细节暂未说明。