KeepAwake (CoffeeORTea) 是一个原生 macOS 菜单栏工具。它可以让你的 Mac 一直保持激活,不再因为休眠而中断。无论是后台的 AI agent 运行、大文件下载,还是远程控制场景,都能为你保驾护航。
传统的熄屏和电源休眠会导致 macOS 清除显示器图形拓扑结构,造成后台截图、AI Computer Use 代理或远程桌面无法正常工作。Blackout Mode 完美解决了这一难题。
KeepAwake 挂载了独立 Watchdog 守护进程。支持通过鼠标晃动或连续按键 3 次迅速解锁回复原亮度。
抛弃臃肿的前端框架与复杂的配置,用原生 AppKit 呈现极简高效的体验。
直接通过系统 caffeinate -w PID 断言防休眠,KeepAwake 退出后断言自动安全释放,绝不会遗留孤儿子进程。
提供 15 分钟、1 小时、3 小时、直到早上 8:00 以及永久保持唤醒等多种快捷时长,菜单栏直观倒计时展示。
内置屏采用 DisplayServices,外接显示器优先使用 DDC/CI VCP 指令调亮降至 0,不支持时自动 Gamma 降级。
Blackout 写入临时恢复文件并启动独立 Watchdog;即使主进程异常崩溃退出,守护进程也会安全将亮度复原。
无缝适配中英双语菜单与系统通知。自动跟随 macOS 系统首选语言设定,符合 Mac 审美标准。
纯 Swift 单文件直接编译,原生支持 Apple Silicon (M1/M2/M3/M4) 与 Intel 芯片 Mac,零运行库负担。
KeepAwake 仅响应防空闲休眠断言,不修改系统的屏保、密码解锁或合盖认证策略。不会绕过 macOS 的身份验证机制。
KeepAwake 只管理自身启动的 caffeinate 进程。关闭状态或退出时不会强行杀死其他开发工具或下载器启动的防休眠断言。
项目使用了 DisplayServices 与 Apple Silicon IOAVService DDC 接口,适合开源编译及自签名。公开发布时使用 Developer ID 即可。
无需完整安装 Xcode,安装命令行工具后即可完成 Universal App 编译、安装与运行。
"Please clone https://github.com/KhalilHsu/CoffeeORTea.git, cd into CoffeeORTea, run ./install.sh, and launch /Applications/KeepAwake.app."
CoffeeORTea 是仓库全名与代号,灵感来自于用咖啡(☕️)或茶(🍵)提神保持清醒。KeepAwake 是用户系统菜单栏中实际显示的应用名称。
DDC/CI 的支持取决于显示器固件、HDMI/DP/Type-C 转接线以及 Apple Silicon 接口层。KeepAwake 提供了双重降级方案:若 DDC 无响应,会自动使用 macOS Gamma 曲线衰减机制将亮度屏幕调暗。
快速摇晃/移动鼠标,或者在 2 秒内连续按键盘任意键 3 次,或者通过系统菜单栏图标关闭开关键,都能触发亮度瞬间还原。