Keepresso：macOS 菜单栏防休眠工具

项目简介

Keepresso 是一款用 Swift + SwiftUI 编写的原生 macOS 菜单栏应用，通过 macOS 的电源断言（IOPMAssertion）阻止系统与显示器休眠，并在此之上加入基于条件的触发器，让 Mac 只在真正需要时保持唤醒。它常驻菜单栏，没有 Dock 图标。

目标用户是需要长时间在线的 Mac 用户：跑 AI agent、做服务器、下载渲染，或者只是不想让机器在关键时刻睡着。

主要功能

• 按需保持唤醒：系统休眠与显示器休眠可分别开关；支持无限期、定时会话（内置预设或自定义时长），以及「直到某个时刻」（如 until 18:00）。
• 让出屏保：系统保持唤醒的同时，允许屏保或显示器在空闲 N 分钟后休眠。
• 变暗而非休眠：长会话中显示器可在你离开后降到最暗但保持点亮，回来或会话结束后恢复亮度。
• 保持活跃（可选，默认关闭）：会议、聊天、远程桌面、VDI、云游戏等软件会把安静的键盘当作空闲，可选用模拟按键或光标移动让它们认为你还在。只有选用时才会请求辅助功能权限，且只在你空闲数秒后才介入。
• 触发器引擎：可依据充电/电池状态、外接显示器、指定 Wi-Fi 网络、VPN 连接、摄像头或麦克风占用、音频播放、指定蓝牙设备、日历日程、指定 App 或进程、挂载卷、CPU 占用阈值、网络吞吐阈值、指定文件夹中的下载、前台游戏、时间段等条件保持唤醒；条件可用 any（OR）或 all（AND）组合。菜单里的 Automatic / Manual 开关显示当前由谁控制。
• 感知 AI agent：coding agent 工作时保持唤醒，全部会话安静后按设定的宽限期允许睡眠。Claude Code、Cursor、Codex、Grok、Antigravity、Hermes Agent、Qwen Code、Devin、Kimi Code 可通过一键连接的 hook 精确上报工作 / 等待批准 / 空闲状态；菜单会列出每个会话及其运行位置。
• 为计划的 AI 任务唤醒：读取本地 AI 工具安排周期任务的时间表，提前几分钟唤醒并在任务结束前保持唤醒（合盖也可）；只读取时间与名称，不读取 prompt。
• 一键「Stop in」：15 分钟、30 分钟、1 小时等快捷按钮把进行中的会话变成定时会话（可编辑），可选在结束前提前提醒。
• 会议不中断：摄像头/麦克风条件通过系统的占用状态（绿点）判断，不读取音视频流，也不会请求摄像头或麦克风权限。
• 游戏相关：识别声明为游戏类别的 App、Steam 库中的游戏，以及 GeForce NOW、Boosteroid、Parsec、Moonlight、Shadow 等云游戏客户端；还有手柄条件与 Steam 下载条件。
• 其他工具：Keyboard Cleaner 键盘锁定；公共 Wi-Fi 门户诊断（打开登录页、刷新 DNS、重启 Wi-Fi）；游戏/串流设置中可临时暂停 AWDL 以降低延迟；预设规则包（AI Agent、Gaming、Cloud Gaming、Meetings、On AC Power 等）；首次运行引导窗口；桌面小组件与控制中心（macOS 26）开关。
• 可观测性：Activity 面板显示各 App 的实时电源断言（可读的 pmset -g assertions）、七天保持唤醒汇总，以及每次会话启停原因的决定日志；当 Keepresso 自身空闲时会标出是哪个 App 让 Mac 保持唤醒。
• 安全网：按电量阈值自动暂停、温度/风扇保护（可选提升风扇转速后再暂停会话）、菜单栏倒计时、全局快捷键等。

安装与使用

• 系统要求：macOS 14 及以上。
• 应用可从官网 keepresso.com 获取，版本发布见 Releases。
• 启动后应用常驻菜单栏：点击咖啡杯图标即可开关保持唤醒、选择定时会话或配置触发条件。首次在新 Mac 上运行会显示引导窗口，按工作方式（agentic coding、游戏直播、会议通话、远程访问）一键完成设置。
• 风扇加速、AWDL 暂停等高级功能需安装 administrator helper；未安装时部分操作会请求一次管理员密码。

注意事项

• 许可证为 GPL-3.0，仅支持 macOS，不提供 Windows 或 Linux 版本。
• 「保持活跃」默认关闭，且只在选择具体方式后才申请辅助功能权限；摄像头/麦克风条件不申请任何权限。
• 温度保护中的风扇加速依赖 administrator helper，安装后不再弹窗提示。

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