如何10分钟在macOS 26上部署omacosy?全新Mac快速上手安装教程

原创2026-10-31 17:37:522,309 阅读

如何10分钟在macOS 26上部署omacosy?全新Mac快速上手安装教程

omacosy 是一个专为 macOS 26(Tahoe)打造的 omarchy 风格桌面环境:一个命令完成安装,即可拥有真正的 Super 键、Hyprland 式 dwindle 平铺窗口管理、主题化状态栏、鼠标悬停聚焦、触控板三指/四指手势和工作区总览。整套环境常驻内存仅约 157MB,由一个仓库内的六个自研 Swift 组件驱动,专为 Apple Silicon 构建与测试。本文带你从一台全新 Mac 出发,走完 部署 → 授权 → 上手 的全部流程。

装好之后,桌面长什么样 🖥️

omacosy macOS 26 平铺桌面:osaka-jade 主题状态栏与壁纸

顶部是一条全透明的主题化状态栏(工作区切换、媒体控制、蓝牙、Wi-Fi、天气、音量、亮度、电池、时钟),平铺窗口带聚焦边框光环。原生菜单栏被隐藏,一切围绕键盘和触控板展开——这正是 omarchy / Hyprland 用户熟悉的体验,只是搬到了 Mac 上。

omacosy dwindle 平铺布局:三个 Ghostty 终端与聚焦边框光环

dwindle 布局是新窗口的自动拆分规则:宽窗口旁边开新窗口就左右分,高窗口旁边就上下分,第三个窗口自动旋成螺旋结构,不会像默认平铺那样被挤成三条窄带。

部署前准备:系统与硬件要求

项目 要求
系统 macOS 26(Tahoe),Apple Silicon 芯片
硬件 MacBook Pro + 外接显示器已验证;单屏同样可运行
依赖 无需预装任何工具,install.sh 会自动安装 Homebrew
时间 约 10 分钟(含 macOS 权限弹窗等待)

安装器是幂等的:重复运行、升级重跑都安全。它会自动完成这些事:

  1. 安装 Homebrew 并执行 Brewfile(AeroSpace、Karabiner、Ghostty、Raycast、fzf、btop 等)
  2. 编译六个自研 helper 二进制(状态栏、边框、手势、总览等)
  3. 生成 AeroSpace 配置并软链接进用户目录
  4. 隐藏原生菜单栏、应用默认主题 tokyo-night、启动所有后台服务

💡 关于窗口管理器:项目默认安装 AeroSpace,也可改用 OmniWM(Beta),二者可一键互切,详见 docs/why-aerospace.md 中完整的选型分析。

三步安装:全新 Mac 完整步骤

第 1 步:把仓库克隆到指定目录

打开终端(Terminal),粘贴执行:

d=~/.local/share/omacosy
if [ -d "$d/.git" ]; then git -C "$d" pull --ff-only; else git clone https://gitcode.com/gh_mirrors/om/omacosy "$d"; fi

目录为什么不能随便选? 配置以软链接方式挂载进仓库,而 macOS 的 TCC 隐私机制会禁止 launchd 后台服务读取 ~/Documents、~/Desktop、~/Downloads。克隆到这三个目录虽不会失败(安装器会退化为"复制模式"),但每次改配置都得重跑 install.sh 才能生效。

第 2 步:运行安装脚本

cd ~/.local/share/omacosy && ./install.sh

常用可选参数:

  • ./install.sh --omniwm:改用 OmniWM 作为窗口管理器(不装 AeroSpace)
  • ./install.sh --yazi:追加安装终端文件管理器 yazi,绑定 Super+Shift+Y
  • ./install.sh --yazi-full:yazi 完整版,附带视频缩略图与 RAW 照片预览

安装结束时脚本会打印"一次性 macOS 步骤"清单,照着做完即可。

第 3 步:按清单授权(关键步骤)⚠️

窗口管理器的权限是"真实工作量"所在。安装过程中 macOS 会弹出多个授权请求,核心是这几个:

授权 请求方 拒绝的后果
辅助功能(Accessibility) AeroSpace、omacosy-ffm、omacosy-bar 核心:没有它窗口无法平铺
输入监控(Input Monitoring) Karabiner-Elements、omacosy-gesture 没有 Super 键和滑动手势
屏幕录制(Screen Recording) 首次启动总览的进程 工作区总览卡片退化为图标+标题
蓝牙 / 定位 / 自动化 omacosy-bar 等 对应状态栏胶囊自动隐藏

另外两件必做的小事:

  1. Karabiner-Elements 首次启动时批准其驱动扩展(它是唯一以 root 运行的第三方组件,职责是把 Caps Lock 重映射为 cmd+ctrl+alt,即 Super 键)
  2. 全部授权入口在 系统设置 → 隐私与安全性 中逐项开启

📌 想以后升级不再重复授权?在 Xcode 里免费创建一个 Apple Development 证书,重跑一次安装脚本即可——install.sh 会用稳定签名签署所有 helper,macOS 的权限随签名保留(README 中有详细步骤)。

装完先试这 5 个操作 ⚡

授权完成后,Super 就是长按 Caps Lock,单点一下仍是 Esc。按顺序体验:

  1. Super+Enter —— 弹出一个 Ghostty 终端;再多按几次,感受 dwindle 自动螺旋分屏
  2. Super+1 ~ Super+9 —— 秒切本显示器第 N 个工作区(无系统动画,即切即达)
  3. 四指上滑 —— 呼出工作区总览
  4. Super+K —— 呼出快捷键速查表
  5. Super+Shift+T —— 一键轮换主题,状态栏、边框、壁纸同步变色

omacosy 工作区总览:实时窗口预览卡片与空工作区指示块

总览界面支持输入即搜(边打字边过滤窗口标题与应用)、拖拽卡片重排工作区、数字键直达。它是常驻守护进程,呼出是瞬时的。

omacosy 快捷键速查表:Super 键全部键位绑定一览

速查表由配置实时解析生成(Super+K 随时可调出),无需死记硬背。

个性化:换应用与换主题

自定义启动快捷键对应的应用:默认绑定终端 Ghostty、音乐 Spotify、消息 Slack(见 config/apps.conf)。浏览器和邮件快捷键刻意跟随 macOS 系统默认应用。想改?在 config/apps.local.conf(gitignore,不会被更新覆盖)里写一行:

TERMINAL=Korren
BROWSER=Arc

保存后重跑 ./install.sh 生效。个人 shell 配置则写进 ~/.zshrc.local,仓库的 zsh/zshrc 会自动加载它。

主题:内置 tokyo-night、catppuccin、gruvbox、osaka-jade 四套,每套都带 omarchy 风格壁纸集(见 themes/)。命令切换:

theme-set gruvbox        # 立即切换
theme-set catppuccin     # 另一套
theme-bg-next            # 当前主题内换壁纸

theme-set 一次覆盖状态栏、边框光环和全部显示器的壁纸。

后续维护:更新、暂停与卸载

场景 命令
检查更新 omacosy-update --check
拉取并应用更新 omacosy-update(只重编译有源码变动的二进制)
临时变回原生 Mac omacosy-toggle off(不卸载,随时 on 恢复)
彻底卸载 ~/.local/share/omacosy/uninstall.sh

uninstall.sh 是清单驱动的:安装时记录了这台机器"实际新增"了什么(新装的 Homebrew 包、改过的 defaults 键值、原壁纸路径),卸载时精确移除并恢复,绝不碰你原有的工具和设置。脚本结束前还会把所有 omacosy 配置备份到 ~/omacosy-backup-<时间戳>/。

💡 隐私说明:整个环境唯一的网络请求是状态栏天气胶囊定时访问 wttr.in;无遥测、无分析、无崩溃上报,所有自研二进制都以普通用户身份运行,install.sh 全程不用 sudo。


小结:一台全新 Mac,git clone + ./install.sh + 按弹窗授权,10 分钟即可拥有 Super 键平铺桌面、dwindle 布局、主题化状态栏、触控板手势与实时工作区总览。遇到问题先看 /tmp/omacosy-*.log 调试日志,或回到项目仓库的 README「Permissions」一节对照排查。

登录后查看全文
omacosy