Keep Awake

Keep-Awake（Mac 合盖防睡眠）

一键启用 Mac「合盖防睡眠」：后台启动 caffeinate -s，创建 PreventSystemSleep assertion，防止合盖（Clamshell）与维护（Maintenance）两类系统级睡眠——合上盖子后进程继续跑、网络连接不断。

机制与前提（先读懂再用）

• caffeinate -s 的 PreventSystemSleep assertion 只在接电源（AC）时有效（man caffeinate 明确写明）。这是 macOS 的硬性前提，不是本脚本的限制。
• 电池供电时合盖是硬件强制睡眠，软件防不住。电池下 caffeinate -s 只能防空闲 / 维护类睡眠（开盖状态下部分有效），合盖必睡。
• 因此启用后的回复里必须重点提醒用户接入电源——这是防睡眠能否生效的决定性条件。

启用

bash ~/.claude/skills/keep-awake/scripts/on.sh

脚本行为（幂等，重复执行安全）：

1. pgrep 检查 caffeinate -s 是否已在跑，在跑则直接返回「已在跑」；
2. pmset -g batt 检测当前电源（AC / 电池）；
3. nohup caffeinate -s 后台启动并 disown，脱离当前 shell 存活；
4. 启动后再次 pgrep 确认进程在，失败则报错退出码 1。

启用成功后，回复用户时必须包含两点：

1. 已启用提示：合盖防睡眠已开启，合上盖子进程继续跑；
2. 电源重点提醒（不可省略）：⚠️ 合盖防睡眠只在接入电源时有效——请确认 Mac 已接电源；若当前是电池供电，合盖后仍会睡眠（硬件强制、软件防不住）。

停用

bash ~/.claude/skills/keep-awake/scripts/off.sh

pkill -f "caffeinate -s" 解除防睡眠。用户说「停用防睡眠」「恢复睡眠」「不需要防睡眠了」等时执行；无进程在跑时输出「无需停用」、不会报错。

状态查询

pgrep -f "caffeinate -s" && pmset -g assertions | grep -i PreventSystemSleep
``

用户问「防睡眠还开着吗」时执行。

## 根因背景（为什么是 caffeinate -s）

2026-07-24 DayTradingAgent 盯盘复盘：盯盘期间系统睡眠（合盖 / 维护）会暂停所有进程——富途 OpenD 的市场快照接口无 timeout、卡到 TCP 超时约 15 分钟才返回、整段采样空窗，代理、网络 CLI 同断。`caffeinate -s` 创建的 `PreventSystemSleep` assertion 能防住这两类系统级睡眠，是 macOS 上软件层面防合盖睡眠的标准做法；实现逻辑源自 DayTradingAgent 的 keep-awake skill（2026-08-17 提炼为全局通用能力）。DayTradingAgent 侧的盯盘场景已把防睡眠并入 trade 盯盘流程（preflight 无条件启用、停盯自动解除），不与本 skill 冲突——那边是盯盘专用链路，本 skill 是任意场景手动启用/停用的全局通用版。