Back to Details

omarchy

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Omarchy Skill

Omarchy 技能

Manage Omarchy Linux systems - a beautiful, fun, agentic Arch Linux distribution with Hyprland.
This skill is for end-user customization on installed systems. It is not for contributing to Omarchy source code.
管理 Omarchy Linux 系统——一款搭载 Hyprland、美观有趣且具备 Agent 能力的 Arch Linux 发行版。
本技能用于已安装系统的终端用户自定义，不适用于 Omarchy 源码贡献场景。

When This Skill MUST Be Used

必须使用本技能的场景

ALWAYS invoke this skill for end-user requests involving ANY of these:
  • Editing ANY file in 
    ~/.config/hypr/
    (window rules, animations, keybindings, monitors, etc.)
  • Editing 
    ~/.config/omarchy/shell.json
    (status bar layout, widgets)
  • Editing terminal configs (alacritty, foot, kitty, ghostty)
  • Editing ANY file in 
    ~/.config/omarchy/
  • Window behavior, animations, opacity, blur, gaps, borders
  • Layer rules, workspace settings, display/monitor configuration
  • Themes, backgrounds, fonts, appearance changes
  • User-facing 
    omarchy
    commands (
    omarchy theme ...
    , 
    omarchy refresh ...
    , 
    omarchy restart ...
    , etc.)
  • Screenshots, screen recording, reminders, night light, idle behavior, lock screen
If you're about to edit a config file in ~/.config/ on this system, STOP and use this skill first.
Do NOT use this skill for Omarchy development tasks (editing the Omarchy source tree, creating migrations, or running 
omarchy dev ...
workflows).
当用户需求涉及以下任意场景时，务必调用本技能：
  • 编辑 
    ~/.config/hypr/
    下的任意文件（窗口规则、动画、快捷键、显示器等）
  • 编辑 
    ~/.config/omarchy/shell.json
    （状态栏布局、小组件）
  • 编辑终端配置（alacritty、foot、kitty、ghostty）
  • 编辑 
    ~/.config/omarchy/
    下的任意文件
  • 窗口行为、动画、透明度、模糊、间距、边框
  • 层规则、工作区设置、显示/显示器配置
  • 主题、背景、字体、外观修改
  • 面向用户的 
    omarchy
    命令（
    omarchy theme ...
    、
    omarchy refresh ...
    、
    omarchy restart ...
    等）
  • 截图、录屏、提醒、夜灯、闲置行为、锁屏
如果你即将编辑本系统中 ~/.config/ 下的配置文件，请先停止操作并使用本技能。
请勿将本技能用于 Omarchy 开发任务（编辑 Omarchy 源码树、创建迁移脚本或运行 
omarchy dev ...
工作流）。

Topic Guides

主题指南

Deeper instructions for common areas live next to this file. Read the matching guide before starting:
  • hyprland.md
     - keybindings, monitors, window rules, and other Hyprland config
  • plugins.md
     - the Omarchy shell: bar layout, widgets, plugins, idle behavior
  • theming.md
     - themes, backgrounds, and fonts
  • hooks.md
     - automation hooks that run on system events
  • capture.md
     - screenshots, screen recordings, OCR text capture, and file sharing
  • contributing.md
     - reporting Omarchy bugs and submitting fixes upstream
常见领域的详细说明位于本文件同级目录下。开始操作前请阅读对应的指南：
  • hyprland.md
     - 快捷键、显示器、窗口规则及其他 Hyprland 配置
  • plugins.md
     - Omarchy shell：状态栏布局、小组件、插件、闲置行为
  • theming.md
     - 主题、背景与字体
  • hooks.md
     - 系统事件触发的自动化钩子
  • capture.md
     - 截图、录屏、OCR 文字提取与文件分享
  • contributing.md
     - 上报 Omarchy 漏洞及向上游提交修复

Critical Safety Rules

关键安全规则

For privileged commands, follow the Privilege Escalation rules below: 
sudo
when a terminal is available for the password prompt, 
pkexec
when it is not. Do not wrap commands that already manage privilege elevation themselves.
For end-user customization tasks, NEVER modify anything in 
/usr/share/omarchy/
 - but READING is safe and encouraged.
This directory is owned by the omarchy package. Any local changes will be overwritten on the next 
omarchy update
.
/usr/share/omarchy/     # READ-ONLY - NEVER EDIT (reading is OK)
├── bin/                    # Command source (packaged binaries are on PATH)
├── config/                 # Default config templates
├── themes/                 # Stock themes
├── default/                # System defaults
├── shell/                  # Omarchy shell source and defaults
├── migrations/             # Update migrations
└── install/                # Installation scripts
Reading 
/usr/share/omarchy/
is SAFE and useful - do it freely to:
  • Understand how omarchy commands work: 
    omarchy theme set --help
    or 
    cat $(which omarchy-theme-set)
  • See default configs before customizing: 
    cat "$OMARCHY_PATH/config/omarchy/shell.json"
  • Check stock theme files to copy for customization
  • Reference default hyprland settings: 
    cat /usr/share/omarchy/default/hypr/*
Always use these safe locations instead:
  • ~/.config/
    - User configuration (safe to edit)
  • ~/.config/omarchy/themes/<custom-name>/
    - Custom themes
  • ~/.config/omarchy/hooks/
    - Custom automation hooks
If the request is to develop Omarchy itself, this skill is out of scope. Follow repository development instructions instead of this skill.
对于特权命令，请遵循下方的权限提升规则：当终端可用于密码输入时使用 
sudo
，否则使用 
pkexec
。不要对本身已具备权限提升能力的命令再做封装。
对于终端用户自定义任务，切勿修改 
/usr/share/omarchy/
下的任何内容——但读取是安全且被鼓励的。
该目录归 omarchy 软件包所有，任何本地修改都会在下次执行 
omarchy update
时被覆盖。
/usr/share/omarchy/     # 只读 - 切勿编辑（可读取）
├── bin/                    # 命令源码（打包后的二进制文件在 PATH 中）
├── config/                 # 默认配置模板
├── themes/                 # 官方自带主题
├── default/                # 系统默认值
├── shell/                  # Omarchy shell 源码与默认配置
├── migrations/             # 更新迁移脚本
└── install/                # 安装脚本
读取 
/usr/share/omarchy/
是安全且有用的——你可以放心读取以实现以下目的：
  • 了解 omarchy 命令的工作原理：
    omarchy theme set --help
    或 
    cat $(which omarchy-theme-set)
  • 在自定义前查看默认配置：
    cat "$OMARCHY_PATH/config/omarchy/shell.json"
  • 复制官方主题文件用于自定义
  • 参考 Hyprland 默认设置：
    cat /usr/share/omarchy/default/hypr/*
请始终使用以下安全位置进行修改：
  • ~/.config/
    - 用户配置（可安全编辑）
  • ~/.config/omarchy/themes/<custom-name>/
    - 自定义主题
  • ~/.config/omarchy/hooks/
    - 自定义自动化钩子
如果需求是开发 Omarchy 本身，则不在本技能的覆盖范围内，请遵循仓库开发说明而非本技能的指引。

Privilege Escalation

权限提升

For an interactive script or command run in a visible terminal, use 
sudo
for privileged work. Omarchy may grant passwordless 
sudo
access to particular commands, and the terminal is the appropriate place to request a password when one is needed.
Use 
pkexec
only when the caller cannot interact with a terminal or cannot enter a password there, such as a command launched by an agent or a graphical background process. Do not replace 
sudo
with 
pkexec
merely because a command changes system state.
对于在可见终端中运行的交互式脚本或命令，执行特权操作时请使用 
sudo
。Omarchy 可能会为特定命令授予免密 
sudo
权限，而当需要输入密码时，终端是合适的请求位置。
仅当调用方无法与终端交互或无法在终端中输入密码时（例如由 Agent 启动的命令或图形化后台进程），才使用 
pkexec
。不要仅因为命令会修改系统状态就用 
pkexec
替换 
sudo
。

System Architecture

系统架构

Omarchy is built on:
ComponentPurposeConfig Location
Arch LinuxBase OS
/etc/
, 
~/.config/
HyprlandWayland compositor/WM
~/.config/hypr/
Omarchy shellStatus bar + notifications (Quickshell)
~/.config/omarchy/shell.json
Launcher/menusQuickshell menu
~/.config/omarchy/extensions/omarchy-menu.jsonc
Alacritty/Foot/Kitty/GhosttyTerminals
~/.config/<terminal>/
Omarchy OSDOn-screen displayQuickshell plugin
Omarchy 基于以下组件构建：
组件用途配置位置
Arch Linux基础操作系统
/etc/
, 
~/.config/
HyprlandWayland 合成器/窗口管理器
~/.config/hypr/
Omarchy shell状态栏 + 通知（基于 Quickshell）
~/.config/omarchy/shell.json
启动器/菜单Quickshell 菜单
~/.config/omarchy/extensions/omarchy-menu.jsonc
Alacritty/Foot/Kitty/Ghostty终端
~/.config/<terminal>/
Omarchy OSD屏幕上显示（OSD）Quickshell 插件

Command Discovery

命令查找

Omarchy ships a single 
omarchy
CLI that dispatches to all 
omarchy-*
binaries via 
omarchy <group> <action>
. Always prefer this form — it is self-documenting and stable. The underlying 
omarchy-*
binaries still exist on 
PATH
and remain safe to read for source.
bash
undefined
Omarchy 提供了统一的 
omarchy
CLI，通过 
omarchy <组> <操作>
的形式调度所有 
omarchy-*
二进制文件。请始终优先使用这种形式——它具备自文档化特性且稳定可靠。底层的 
omarchy-*
二进制文件仍存在于 
PATH
中，可安全读取其源码。
bash
undefined

List every documented command and its summary (--all includes hidden commands)

列出所有有文档的命令及其摘要（--all 包含隐藏命令）

omarchy commands
omarchy commands

Show the commands inside a group

查看某个命令组下的所有命令

omarchy theme --help omarchy refresh --help omarchy restart --help
omarchy theme --help omarchy refresh --help omarchy restart --help

Show help for a specific command (does not execute it)

查看特定命令的帮助（不会执行命令）

omarchy theme set --help
omarchy theme set --help

Machine-readable listing (binary, route, summary, args, aliases)

机器可读格式的命令列表（二进制文件、路由、摘要、参数、别名）

omarchy commands --json
omarchy commands --json

Read a command's source to understand it

读取命令源码了解其实现逻辑

cat $(which omarchy-theme-set)
undefined
cat $(which omarchy-theme-set)
undefined

Command Groups

命令组

Run 
omarchy --help
for the full list. The most common groups:
GroupPurposeExample
omarchy refresh
Reset config to defaults (backs up first)
omarchy refresh shell
omarchy restart
Restart a service/app
omarchy restart shell
omarchy toggle
Toggle feature on/off
omarchy toggle nightlight
omarchy theme
Theme management
omarchy theme set <name>
omarchy bar
Bar layout and widgets
omarchy bar move omarchy.clock --section right
omarchy plugin
Manage/clone shell plugins
omarchy plugin clone omarchy.clock
omarchy hook
Install automation hooks
omarchy hook install theme-set <script>
omarchy install
Install optional software / packages
omarchy install docker dbs
omarchy launch
Launch apps
omarchy launch browser
omarchy capture
Screenshots and recordings
omarchy capture screenshot
omarchy reminder
Desktop notification reminders
omarchy reminder 15 "Pickup Jack"
omarchy pkg
Package management
omarchy pkg add <pkg>
omarchy setup
Interactive setup wizards
omarchy setup security fingerprint
omarchy update
System updates
omarchy update
运行 
omarchy --help
查看完整列表。最常用的命令组：
命令组用途示例
omarchy refresh
将配置重置为默认值（会先备份）
omarchy refresh shell
omarchy restart
重启服务/应用
omarchy restart shell
omarchy toggle
切换功能开关
omarchy toggle nightlight
omarchy theme
主题管理
omarchy theme set <name>
omarchy bar
状态栏布局与小组件
omarchy bar move omarchy.clock --section right
omarchy plugin
管理/克隆 shell 插件
omarchy plugin clone omarchy.clock
omarchy hook
安装自动化钩子
omarchy hook install theme-set <script>
omarchy install
安装可选软件/软件包
omarchy install docker dbs
omarchy launch
启动应用
omarchy launch browser
omarchy capture
截图与录屏
omarchy capture screenshot
omarchy reminder
桌面通知提醒
omarchy reminder 15 "Pickup Jack"
omarchy pkg
软件包管理
omarchy pkg add <pkg>
omarchy setup
交互式设置向导
omarchy setup security fingerprint
omarchy update
系统更新
omarchy update

Configuration Locations

配置位置

Hyprland config lives in 
~/.config/hypr/
— see 
hyprland.md
. The Omarchy shell (bar, notifications, plugins, idle) is configured in 
~/.config/omarchy/shell.json
— see 
plugins.md
.
Hyprland 配置位于 
~/.config/hypr/
——参见 
hyprland.md
。Omarchy shell（状态栏、通知、插件、闲置行为）在 
~/.config/omarchy/shell.json
中配置——参见 
plugins.md
。

Terminals

终端

~/.config/alacritty/alacritty.toml
~/.config/foot/foot.ini
~/.config/kitty/kitty.conf
~/.config/ghostty/config
Command: 
omarchy restart terminal
~/.config/alacritty/alacritty.toml
~/.config/foot/foot.ini
~/.config/kitty/kitty.conf
~/.config/ghostty/config
命令： 
omarchy restart terminal

Other Configs

其他配置

AppLocation
btop
~/.config/btop/btop.conf
fastfetch
/etc/fastfetch/config.jsonc
default; 
~/.config/fastfetch/config.jsonc
user override
lazygit
~/.config/lazygit/config.yml
starship
~/.config/starship.toml
git
~/.config/git/config
应用位置
btop
~/.config/btop/btop.conf
fastfetch默认位于 
/etc/fastfetch/config.jsonc
；用户覆盖配置位于 
~/.config/fastfetch/config.jsonc
lazygit
~/.config/lazygit/config.yml
starship
~/.config/starship.toml
git
~/.config/git/config

Safe Customization Patterns

安全自定义模式

Edit User Config Directly

直接编辑用户配置

For simple changes, edit files in 
~/.config/
:
bash
undefined
对于简单修改，直接编辑 
~/.config/
下的文件：
bash
undefined

1. Read current config

1. 读取当前配置

cat ~/.config/hypr/bindings.lua
cat ~/.config/hypr/bindings.lua

2. Backup before changes

2. 修改前备份

cp ~/.config/hypr/bindings.lua ~/.config/hypr/bindings.lua.bak.$(date +%s)
cp ~/.config/hypr/bindings.lua ~/.config/hypr/bindings.lua.bak.$(date +%s)

3. Make changes with Edit tool

3. 使用编辑工具进行修改

4. Apply changes

4. 应用更改

- Hyprland: auto-reloads on save, but MUST validate with 
hyprctl reload
and 
hyprctl configerrors

- Hyprland：保存时自动重载，但必须通过 
hyprctl reload
和 
hyprctl configerrors
验证配置

- Omarchy shell: shell.json and user plugin code under ~/.config/omarchy/plugins/ hot-reload on save

- Omarchy shell：保存时热重载 shell.json 和 ~/.config/omarchy/plugins/ 下的用户插件代码

- Menus/launcher: ~/.config/omarchy/extensions/omarchy-menu.jsonc hot-reloads on save

- 菜单/启动器：保存时热重载 ~/.config/omarchy/extensions/omarchy-menu.jsonc

- Terminals: apply with 
omarchy restart terminal
(reloads running terminals; foot picks changes up in new windows)

- 终端：通过 
omarchy restart terminal
应用（会重载正在运行的终端；foot 会在新窗口中生效）

undefined
undefined

Reset to Defaults -- ALWAYS SEEK USER CONFIRMATION BEFORE RUNNING

重置为默认值——运行前务必征得用户确认

When customizations go wrong:
bash
undefined
当自定义出现问题时：
bash
undefined

Reset specific config (creates backup automatically)

重置指定配置（自动创建备份）

omarchy refresh shell omarchy refresh hyprland
omarchy refresh shell omarchy refresh hyprland

The refresh command:

refresh 命令的执行流程：

1. Backs up current config with timestamp

1. 带时间戳备份当前配置

2. Copies default from $OMARCHY_PATH/config/

2. 从 $OMARCHY_PATH/config/ 复制默认配置

3. Restarts the component where the refresh needs it (e.g. 
refresh shell
)

3. 重启需要刷新配置的组件（例如执行 
refresh shell
时重启 shell）

undefined
undefined

System Commands

系统命令

bash
omarchy update                  # Full system update
omarchy version                 # Show Omarchy version
omarchy debug --no-sudo --print # Debug info (ALWAYS use these flags)
omarchy system lock             # Lock screen
omarchy system shutdown         # Shutdown
omarchy system reboot           # Reboot
IMPORTANT: Always run 
omarchy debug
with 
--no-sudo --print
flags to avoid interactive sudo prompts that will hang the terminal.
bash
omarchy update                  # 完整系统更新
omarchy version                 # 查看 Omarchy 版本
omarchy debug --no-sudo --print # 调试信息（请始终使用这些参数）
omarchy system lock             # 锁屏
omarchy system shutdown         # 关机
omarchy system reboot           # 重启
重要提示： 运行 
omarchy debug
时请始终带上 
--no-sudo --print
参数，避免交互式 sudo 提示导致终端挂起。

Troubleshooting

故障排查

bash
undefined
bash
undefined

Get debug information (ALWAYS use these flags to avoid interactive prompts)

获取调试信息（请始终使用这些参数以避免交互式提示）

omarchy debug --no-sudo --print
omarchy debug --no-sudo --print

Reset specific config to defaults

将指定配置重置为默认值

omarchy refresh <app>
omarchy refresh <app>

Refresh specific config file

刷新指定配置文件

config-file path is relative to ~/.config/

配置文件路径相对于 ~/.config/

eg. 
omarchy refresh config hypr/hyprland.lua
will refresh ~/.config/hypr/hyprland.lua

例如：
omarchy refresh config hypr/hyprland.lua
会刷新 ~/.config/hypr/hyprland.lua

omarchy refresh config <config-file>
omarchy refresh config <config-file>

Full reinstall of configs (nuclear option)

完全重装配置（终极方案）

omarchy reinstall
undefined
omarchy reinstall
undefined

Decision Framework

决策框架

When user requests system changes:
  1. Is it a stock omarchy command? Use it directly
  2. Is it a config edit? Edit in 
    ~/.config/
    , never 
    /usr/share/omarchy/
  3. Is it a theme customization? Follow 
    theming.md
    ; create a NEW custom theme directory
  4. Is it automation? Follow 
    hooks.md
    ; use 
    omarchy hook install
    and the hook 
    .d
    directories
  5. Is it a package install? Use 
    omarchy pkg add <pkgs...>
    (or 
    omarchy pkg aur add <pkgs...>
    for AUR-only packages)
  6. Is it built-in shell/plugin code? Follow 
    plugins.md
    ; clone it with 
    omarchy plugin clone
    , never edit the packaged copy
  7. Unsure if command exists? Run 
    omarchy commands
    (or 
    omarchy <group> --help
    for one group)
当用户提出系统修改需求时：
  1. 是否为 Omarchy 内置命令？ 直接使用
  2. 是否为配置编辑？ 在 
    ~/.config/
    下编辑，切勿修改 
    /usr/share/omarchy/
  3. 是否为主题自定义？ 遵循 
    theming.md
    ；创建全新的自定义主题目录
  4. 是否为自动化需求？ 遵循 
    hooks.md
    ；使用 
    omarchy hook install
    和钩子 
    .d
    目录
  5. 是否为软件包安装？ 使用 
    omarchy pkg add <pkgs...>
    （AUR 专属包使用 
    omarchy pkg aur add <pkgs...>
    ）
  6. 是否为内置 shell/插件代码？ 遵循 
    plugins.md
    ；使用 
    omarchy plugin clone
    克隆，切勿编辑打包版本
  7. 不确定命令是否存在？ 运行 
    omarchy commands
    （或查看单个命令组的帮助：
    omarchy <group> --help
    ）

Reminder Requests

提醒需求

When the user asks to set a reminder, use 
omarchy reminder <minutes> [message]
directly. Convert natural language durations to minutes and title-case short reminder labels when appropriate.
bash
omarchy reminder 15 "Pickup Jack"
omarchy reminder 60 "Check laundry"
omarchy reminder show
omarchy reminder clear
当用户要求设置提醒时，直接使用 
omarchy reminder <分钟数> [消息]
。将自然语言描述的时长转换为分钟数，并在合适的情况下将简短提醒标签转为首字母大写格式。
bash
omarchy reminder 15 "Pickup Jack"
omarchy reminder 60 "Check laundry"
omarchy reminder show
omarchy reminder clear

Out of Scope

不在覆盖范围内

This skill intentionally does not cover Omarchy source development. Do not use this skill for:
  • Editing files in 
    /usr/share/omarchy/
    (
    bin/
    , 
    config/
    , 
    default/
    , 
    shell/
    , 
    themes/
    , 
    migrations/
    , etc.)
  • Creating or editing migrations
  • Running 
    omarchy dev ...
    commands
本技能刻意不覆盖 Omarchy 源码开发场景，请勿将本技能用于：
  • 编辑 
    /usr/share/omarchy/
    下的文件（
    bin/
    、
    config/
    、
    default/
    、
    shell/
    、
    themes/
    、
    migrations/
    等）
  • 创建或编辑迁移脚本
  • 运行 
    omarchy dev ...
    命令

Example Requests

需求示例

  • "Change my theme to catppuccin" -> 
    omarchy theme set catppuccin
  • "Add a keybinding for Super+E to open file manager" -> Check existing bindings first, then use 
    o.rebind
    to replace one or 
    o.bind
    to add one in 
    ~/.config/hypr/bindings.lua
  • "Configure my external monitor" -> Edit 
    ~/.config/hypr/monitors.lua
  • "Make the window gaps smaller" -> Edit 
    ~/.config/hypr/looknfeel.lua
  • "Turn on night light" -> 
    omarchy toggle nightlight
    (for time-based schedules, edit 
    ~/.config/hypr/hyprsunset.conf
    profiles, then 
    omarchy restart hyprsunset
    )
  • "Set a reminder to pickup jack in 15 minutes" -> 
    omarchy reminder 15 "Pickup Jack"
  • "Show my reminders" -> 
    omarchy reminder show
  • "Clear all reminders" -> 
    omarchy reminder clear
  • "Customize the catppuccin theme colors" -> Overlay: put an edited 
    colors.toml
    in 
    ~/.config/omarchy/themes/catppuccin/
    , then re-apply the theme (see 
    theming.md
    )
  • "Run a script every time I change themes" -> Install it with 
    omarchy hook install theme-set <script>
  • "Change how workspace labels are rendered" -> Clone 
    omarchy.workspaces
    , which switches the bar to 
    <username>.workspaces
    , then edit the clone
  • "Lock after ten minutes" -> Set 
    idle.lock
    to 
    600
    in 
    ~/.config/omarchy/shell.json
  • "Reset shell/bar to defaults" -> 
    omarchy refresh shell
  • "Record my screen" -> 
    omarchy screenrecord --fullscreen
    , then 
    omarchy screenrecord --stop-recording
    (see 
    capture.md
    )
  • "Report this bug to Omarchy" -> Gather diagnostics and a capture of the problem, then file it (see 
    contributing.md
    )
  • "把我的主题改成 catppuccin" -> 
    omarchy theme set catppuccin
  • "添加 Super+E 快捷键打开文件管理器" -> 先检查现有绑定，然后在 
    ~/.config/hypr/bindings.lua
    中使用 
    o.rebind
    替换或 
    o.bind
    新增
  • "配置我的外接显示器" -> 编辑 
    ~/.config/hypr/monitors.lua
  • "把窗口间距调小" -> 编辑 
    ~/.config/hypr/looknfeel.lua
  • "打开夜灯" -> 
    omarchy toggle nightlight
    （如需定时 schedule，编辑 
    ~/.config/hypr/hyprsunset.conf
    配置文件，然后执行 
    omarchy restart hyprsunset
    ）
  • "设置15分钟后提醒我接 jack" -> 
    omarchy reminder 15 "Pickup Jack"
  • "查看我的提醒" -> 
    omarchy reminder show
  • "清除所有提醒" -> 
    omarchy reminder clear
  • "自定义 catppuccin 主题的颜色" -> 覆盖方式：将编辑后的 
    colors.toml
    放入 
    ~/.config/omarchy/themes/catppuccin/
    ，然后重新应用主题（参见 
    theming.md
    ）
  • "每次切换主题时运行一个脚本" -> 使用 
    omarchy hook install theme-set <script>
    安装
  • "修改工作区标签的渲染方式" -> 克隆 
    omarchy.workspaces
    ，状态栏会切换为 
    <username>.workspaces
    ，然后编辑克隆后的版本
  • "十分钟后自动锁屏" -> 在 
    ~/.config/omarchy/shell.json
    中设置 
    idle.lock
    为 
    600
  • "将 shell/状态栏重置为默认值" -> 
    omarchy refresh shell
  • "录制我的屏幕" -> 
    omarchy screenrecord --fullscreen
    ，结束时执行 
    omarchy screenrecord --stop-recording
    （参见 
    capture.md
    ）
  • "向 Omarchy 上报这个 bug" -> 收集诊断信息和问题截图，然后提交 issue（参见 
    contributing.md
    ）