KeepAwake
下载

macOS 菜单栏工具

Mac 优雅防休眠

KeepAwake (CoffeeORTea) 是一个原生 macOS 菜单栏工具。它可以让你的 Mac 一直保持激活，不再因为休眠而中断。无论是后台的 AI agent 运行、大文件下载，还是远程控制场景，都能为你保驾护航。

下载 macOS 版 从源码构建

v1.4.0 Universal macOS 13+ Apple 公证

Finder File Edit View Go Window
—
这是一个可以操作的菜单：打开开关，拖动时长，再试试「假装下钟」。

Blackout Mode

为什么需要 Blackout Mode？

传统的熄屏和电源休眠会导致 macOS 清除显示器图形拓扑结构，造成后台截图、AI Computer Use 代理或远程桌面无法正常工作。Blackout Mode 完美解决了这一难题。

传统熄屏 / 休眠
  • 系统发送屏保/显示器关机命令，断开 DDC 连接
  • 后台截图捕获到黑色全空帧或引发系统渲染异常
  • Computer Use AI 代理由于无法读取 UI 元素而中断
KeepAwake Blackout 模式
  • 内置屏采用 DisplayServices，外接屏优先使用 DDC/CI 降亮
  • 保持 Mac 在系统的图形拓扑中，后台渲染与截图持续可用
  • 无需物理遮挡屏幕，节能护眼，完美契合 AI 挂机与自动化测试

体验屏幕唤醒防护与快速恢复机制

KeepAwake 挂载了独立 Watchdog 守护进程。支持通过鼠标晃动或连续按键 3 次迅速解锁回复原亮度。

功能

轻量强悍，专为 macOS 打造

抛弃臃肿的前端框架与复杂的配置，用原生 AppKit 呈现极简高效的体验。

系统级 Caffeinate 绑定

直接通过系统 caffeinate -w PID 断言防休眠，KeepAwake 退出后断言自动安全释放，绝不会遗留孤儿子进程。

灵活预设定时器

提供 15 分钟、1 小时、3 小时、直到早上 8:00 以及永久保持唤醒等多种快捷时长，菜单栏直观倒计时展示。

多显示器 DDC/CI 控制

内置屏采用 DisplayServices，外接显示器优先使用 DDC/CI VCP 指令调亮降至 0，不支持时自动 Gamma 降级。

Watchdog 守护与恢复

Blackout 写入临时恢复文件并启动独立 Watchdog；即使主进程异常崩溃退出，守护进程也会安全将亮度复原。

自定义全局快捷键

为保持唤醒和息屏模式分别录入快捷键，无需打开菜单即可一键切换；快捷键注册不需要辅助功能权限。

原生双语 · Universal

中英双语菜单与通知自动跟随系统语言；纯 Swift 编译为 Universal 二进制，原生支持 Apple Silicon 与 Intel Mac。

安全

明确的安全边界与规范

锁屏与密码保护

KeepAwake 仅响应防空闲休眠断言，不修改系统的屏保、密码解锁或合盖认证策略。不会绕过 macOS 的身份验证机制。

断言只针对自身

KeepAwake 只管理自身启动的 caffeinate 进程。关闭状态或退出时不会强行杀死其他开发工具或下载器启动的防休眠断言。

签名、公证与私有 API

官方 DMG 使用 Developer ID 签名并经 Apple 公证。项目使用了 DisplayServices 与 Apple Silicon IOAVService DDC 接口，因此不上架 Mac App Store。

安装

下载即用，或从源码构建

KeepAwake v1.4.0

Universal · macOS 13 及以上 · 2.6 MB

下载 DMG
  1. 打开下载的 DMG
  2. 把 KeepAwake 拖进「应用程序」
  3. 启动后，它会出现在菜单栏

Developer ID 签名 · Apple 公证 发布说明与 SHA-256

一键 Clone、构建与安装

无需完整安装 Xcode，安装命令行工具后即可完成 Universal App 编译、安装与运行。

zsh 
$ git clone https://github.com/KhalilHsu/CoffeeORTea.git
$ cd CoffeeORTea
$ ./install.sh
$ open /Applications/KeepAwake.app

还没有命令行工具？先运行 xcode-select --install

问答

常见问题解答

为什么项目名称是 CoffeeORTea 但生成 App 是 KeepAwake？

CoffeeORTea 是仓库全名与代号，灵感来自于用咖啡（☕️）或茶（🍵）提神保持清醒。KeepAwake 是用户系统菜单栏中实际显示的应用名称。

所有外接显示器都能完美支持 DDC/CI 亮度调零吗？

DDC/CI 的支持取决于显示器固件、HDMI/DP/Type-C 转接线以及 Apple Silicon 接口层。KeepAwake 提供了双重降级方案：若 DDC 无响应，会自动使用 macOS Gamma 曲线衰减机制将亮度屏幕调暗。

Blackout Mode 如何恢复显示？

快速摇晃/移动鼠标，或者在 2 秒内连续按键盘任意键 3 次，或者通过系统菜单栏图标关闭开关键，都能触发亮度瞬间还原。