如何10分钟在macOS 26上部署omacosy?全新Mac快速上手安装教程
如何10分钟在macOS 26上部署omacosy?全新Mac快速上手安装教程
omacosy 是一个专为 macOS 26(Tahoe)打造的 omarchy 风格桌面环境:一个命令完成安装,即可拥有真正的 Super 键、Hyprland 式 dwindle 平铺窗口管理、主题化状态栏、鼠标悬停聚焦、触控板三指/四指手势和工作区总览。整套环境常驻内存仅约 157MB,由一个仓库内的六个自研 Swift 组件驱动,专为 Apple Silicon 构建与测试。本文带你从一台全新 Mac 出发,走完 部署 → 授权 → 上手 的全部流程。
装好之后,桌面长什么样 🖥️
顶部是一条全透明的主题化状态栏(工作区切换、媒体控制、蓝牙、Wi-Fi、天气、音量、亮度、电池、时钟),平铺窗口带聚焦边框光环。原生菜单栏被隐藏,一切围绕键盘和触控板展开——这正是 omarchy / Hyprland 用户熟悉的体验,只是搬到了 Mac 上。
dwindle 布局是新窗口的自动拆分规则:宽窗口旁边开新窗口就左右分,高窗口旁边就上下分,第三个窗口自动旋成螺旋结构,不会像默认平铺那样被挤成三条窄带。
部署前准备:系统与硬件要求
| 项目 | 要求 |
|---|---|
| 系统 | macOS 26(Tahoe),Apple Silicon 芯片 |
| 硬件 | MacBook Pro + 外接显示器已验证;单屏同样可运行 |
| 依赖 | 无需预装任何工具,install.sh 会自动安装 Homebrew |
| 时间 | 约 10 分钟(含 macOS 权限弹窗等待) |
安装器是幂等的:重复运行、升级重跑都安全。它会自动完成这些事:
- 安装 Homebrew 并执行 Brewfile(AeroSpace、Karabiner、Ghostty、Raycast、fzf、btop 等)
- 编译六个自研 helper 二进制(状态栏、边框、手势、总览等)
- 生成 AeroSpace 配置并软链接进用户目录
- 隐藏原生菜单栏、应用默认主题 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 等 | 对应状态栏胶囊自动隐藏 |
另外两件必做的小事:
- Karabiner-Elements 首次启动时批准其驱动扩展(它是唯一以 root 运行的第三方组件,职责是把 Caps Lock 重映射为
cmd+ctrl+alt,即 Super 键) - 全部授权入口在 系统设置 → 隐私与安全性 中逐项开启
📌 想以后升级不再重复授权?在 Xcode 里免费创建一个 Apple Development 证书,重跑一次安装脚本即可——install.sh 会用稳定签名签署所有 helper,macOS 的权限随签名保留(README 中有详细步骤)。
装完先试这 5 个操作 ⚡
授权完成后,Super 就是长按 Caps Lock,单点一下仍是 Esc。按顺序体验:
Super+Enter—— 弹出一个 Ghostty 终端;再多按几次,感受 dwindle 自动螺旋分屏Super+1 ~ Super+9—— 秒切本显示器第 N 个工作区(无系统动画,即切即达)- 四指上滑 —— 呼出工作区总览
Super+K—— 呼出快捷键速查表Super+Shift+T—— 一键轮换主题,状态栏、边框、壁纸同步变色
总览界面支持输入即搜(边打字边过滤窗口标题与应用)、拖拽卡片重排工作区、数字键直达。它是常驻守护进程,呼出是瞬时的。
速查表由配置实时解析生成(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」一节对照排查。



