从快捷指令、Raycast 或脚本控制 Keepresso

Keepresso 是一次菜单栏点击，但你也可以用它的快捷指令动作和 URL scheme，从快捷指令、聚焦搜索、Siri、Raycast、Alfred 或任意脚本免手动驱动它。

快捷指令动作

Keepresso 附带原生快捷指令动作，可以放进任意快捷指令，也可以直接从聚焦搜索和 Siri 运行：

• 开始保持唤醒（可选指定分钟数）
• 停止保持唤醒
• 切换保持唤醒

URL scheme

对于 Raycast、Alfred 或 shell 脚本，打开一个 keepresso:// URL：

keepresso://start              start an open-ended session
keepresso://start?duration=60  start for 60 minutes
keepresso://start?until=18:00  keep awake until 18:00
keepresso://stop               stop the session
keepresso://toggle             toggle it

在终端或脚本里，open "keepresso://start?duration=90" 效果相同。如果你更想用带正确退出码和状态的真正命令，请使用 keepresso 命令行工具。

它们会固定住

来自快捷指令或 URL 的任何命令都会先暂停你的触发器，这样你请求的会话才会真正站住，而不是一秒钟后被某条触发规则覆盖掉。

一瞥即控：小组件与控制中心

两个更轻的入口让你不用打开菜单也能查看或切换会话。

桌面和通知中心小组件（macOS 14 及更高版本）会显示是否有会话正在运行，对定时会话还会实时显示还剩多久。中等尺寸小组件还带有停止和暂停触发器按钮；小方块小组件则是紧凑的状态一览。在桌面上右键，或打开通知中心，选择编辑小组件，找到 Keepresso 并选一个尺寸即可添加。

控制中心开关（macOS 26）在 Wi-Fi 和专注模式旁加入 Keepresso 开关，你可以在切换系统其余设置的同一个地方启动或停止会话。在系统设置，控制中心下添加它，再拖到你喜欢的布局中。

事件钩子：反向的自动化

快捷指令和 URL 驱动 Keepresso。事件钩子则让 Keepresso 回调你。在偏好设置，自动化下，添加一个钩子，在有事发生时运行快捷指令、POST 一个 webhook，或执行 shell 命令：

• 会话启动或结束
• 触发器生效或解除
• 电池或热暂停触发，或热阶段变化
• AI 智能体转为闲置

经典用法是通宵智能体任务结束时推送到手机：把 webhook 指到一个 ntfy 主题，或在智能体已闲置时运行一个发送通知的快捷指令。shell 钩子可以启动别的任何事，从 git push 到关掉一盏灯。

一条安全说明：导入设置文件时，任何 shell 命令钩子都会以关闭状态带入，这样共享或下载的文件就不能在你背后执行命令。请在偏好设置，自动化下审查并重新启用它们。

面向脚本与 AI 智能体

快捷指令和 URL 是给你用的。对于无人值守运行的自动化，Keepresso 有专门的接口：脚本或智能体在工作期间不断续期的有界自动化租约（崩溃永远无法把 Mac 钉在唤醒状态）、一个 MCP 服务器，以及智能体一键即可安装的内置智能体技能。参见让 AI 智能体让 Mac 保持唤醒。