用途:当用户希望 Mac 在长时间受监督任务期间保持唤醒时使用,例如构建、下载或自动化运行,避免被休眠打断。该技能依赖 macOS 内置的 caffeinate 命令,无需安装。
主要能力与用法:标准命令为 caffeinate -d -i -t 7200,表示屏幕保持开启且系统不进入空闲休眠,持续 2 小时。时长由 -t <秒> 指定:2 小时为 7200,7 小时为 25200,通宵 9 小时为 32400。可用标志:-i 仅阻止系统空闲休眠(屏幕仍可能变暗或锁定);-d 阻止显示器休眠;-d -i 为默认选择;-d -i -s 增加 -s,仅在接通电源时生效;-u -t 1 模拟用户活动以立即唤醒显示器。默认使用 -d -i -t <秒>,除非用户另有说明。
也可绑定进程而非定时器:caffeinate -d -i -w <PID> 会保持唤醒直到该进程退出,适合构建;caffeinate -i npm run build 会包裹命令并在命令结束时退出。建议在用户自己的可见终端窗格中运行,便于查看和用 Ctrl+C 中断;否则作为后台 Bash 任务运行,不要阻塞自己的前台 shell。
验证与监控:可用 pgrep -fl caffeinate 检查是否运行及确切标志,ps -o etime= -p <PID> 查看已运行时长,pmset -g assertions 检查 PreventUserIdleSystemSleep 与 PreventUserIdleDisplaySleep 断言是否生效。注意 caffeinate 不打印输出并占用提示符,看似“卡住”实则正常,应通过 pgrep 验证而非观察终端。使用 -t 时到期会静默退出、无通知,若数小时后询问是否仍在运行,先检查 pgrep。键盘背光无法由 caffeinate 保持开启,其在 Apple Silicon 上无 CLI/API,需手动在系统设置中把“闲置后关闭键盘背光”设为“永不”。提前停止可 kill <记录的 PID> 或在运行该任务的窗格按 Ctrl+C;停止前先验证其命令,不要按宽泛模式停止无关会话。启动后应告知用户 PID、标志及到期时间。限制:改编自 davidondrej/skills,执行前需验证本地路径、工具、凭据和智能体功能;对命令、远程访问、调度、浏览器自动化或改文件工作流,需获得用户明确批准并确认目标环境。