ApolloShell：macOS 桌面 Shell

项目简介

ApolloShell 是一款用原生 Swift 编写的 macOS 桌面 Shell，把 Linux 上 Caelestia 一类桌面外壳的外观带到 Mac 上。它不会替换 Finder 或窗口管理器，只是在屏幕边缘添加面板，其余时间保持不打扰。所有面板都由可自由排列的「块」组成，侧边栏、Dock、启动器、仪表盘和控制中心都能按自己的习惯重排。

项目设计参考 Caelestia，但为独立项目，不包含 Caelestia 的代码。界面提供英语和德语。

主要功能

• 侧边栏：位于屏幕左边缘，包含 Spaces、时钟、状态图标和电源按钮，可增删和重排块，也可从预设开始。
• Dock：嵌在侧边栏中，显示固定和正在运行的应用，点击、菜单、拖放与角标的行为与 Apple Dock 类似。
• 启动器：按 ⌥Space 唤出，输入后回车即可启动，常用应用会排在前面。
• 仪表盘：从屏幕顶部边缘打开，显示天气、日历、系统状态和正在播放的内容。
• 控制中心：位于右下角，提供保持唤醒、音量、Wi-Fi、深色模式、Night Shift、取色器和自定义按钮。
• 主题：一个 CSS 文件即可定义整个外壳的颜色、渐变、字体和尺寸，保存文件后立即生效。
• Nexus：设置应用，所有面板都在这里重新排列。
• 其他：音量显示、电源与音频通知、桌面时钟、会话菜单，以及自动更新提示。

仪表盘	控制中心	启动器
<img src="https://raw.githubusercontent.com/Silvertree2010/ApolloShell/main/docs/images/dashboard.png" alt="仪表盘">	<img src="https://raw.githubusercontent.com/Silvertree2010/ApolloShell/main/docs/images/utilities.png" alt="控制中心">	<img src="https://raw.githubusercontent.com/Silvertree2010/ApolloShell/main/docs/images/launcher.png" alt="启动器">

安装与使用

需要 macOS 26 Tahoe 或更高版本，支持 Apple silicon 与 Intel。

下载安装包：从最新 Release 下载 .dmg，把 ApolloShell 拖入「应用程序」。应用未做公证，首次启动会被 macOS 拦截，可到「系统设置 → 隐私与安全性」点击「仍要打开」，或执行：

xattr -dr com.apple.quarantine /Applications/ApolloShell.app

Homebrew（在本地从源码构建）：

brew trust --tap Silvertree2010/apolloshell
brew tap Silvertree2010/apolloshell
brew install apolloshell

从源码构建：只需 Command Line Tools，无需 Xcode。

git clone https://github.com/Silvertree2010/ApolloShell.git
cd ApolloShell
scripts/setup-signing.sh
./build.sh

常用快捷键：⌥Space 打开启动器，⌃⌥D 打开仪表盘，⌃⌥U 打开控制中心，⌃⌥, 打开 Nexus，均可在 Nexus → Keyboard Shortcuts 中修改。

主题文件放在 ~/Library/Application Support/ApolloShell/themes，使用 --apollo-* 令牌定义颜色、尺寸、字体和渐变，不支持脚本与自定义选择器；格式说明见 docs/THEMES.md。

注意事项

• 权限：首次启动会引导授权。辅助功能权限用于避免窗口滑到侧边栏下方，并为 Dock 的窗口列表提供支持；自动化 → System Events 仅用于注销、重启和关机。
• 合盖保持唤醒需要一次管理员权限，会在 /etc/sudoers.d/apolloshell 写入仅允许 pmset -a disablesleep 1 和 0 的规则，可在 Nexus 中移除。
• 隐私：无遥测、无账号；唯一网络流量是天气，所选地点会发送给 Open-Meteo、MET Norway 或 wttr.in。崩溃后会询问是否发送崩溃报告。配置存放在 ~/Library/Application Support/ApolloShell/，删除该文件夹即可重置。
• 私有接口：Spaces、全屏检测、Night Shift、深色模式、窗口列表和「正在播放」依赖未公开的 macOS API，启动时会检测，缺失则关闭对应功能。这也是它无法上架 Mac App Store 的原因。
• 目前是早期版本，macOS 系统更新可能导致部分功能失效；系统更新后若辅助功能失效，可在系统设置中移除 ApolloShell 后重新添加并重启。
• 许可证为 AGPL-3.0。

---

本作品整理自 GitHub 开源项目 Silvertree2010/ApolloShell，原作者 @Silvertree2010，许可证 AGPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。