fuji-mak/Capsomnia

A tiny macOS app that turns Caps Lock into a physical keep-awake switch for closed-lid MacBook work.

解决的问题

Capsomnia 可防止 MacBook 在合盖时进入睡眠,解决了标准睡眠预防工具(如 caffeinate)在合盖使用时常无法维持本地进程运行的问题。这对于维持 AI 代理、长时间运行的脚本以及远程 SSH 会话的运行特别有用,无需保持笔记本电脑开启。

运作原理

该应用将物理 Caps Lock 键变为防止睡眠的硬件切换开关。当 Caps Lock 开启时(由绿色 LED 指示灯显示),应用会使用特权原生辅助程序来禁用系统睡眠。当 Caps Lock 关闭时,则恢复正常的睡眠行为。它还可以选择性地防止 Caps Lock 键实际输入大写字母,并能为远程 UI 工具保持显示会话为活动状态。

适用对象

需要在 MacBook 上运行 AI 编码代理、无人值守脚本或远程工作负载,并希望通过物理且可见的指示灯来确认机器在合盖时是否保持唤醒状态的开发人员与高级用户。

特色亮点

  • 物理切换开关:使用 Caps Lock LED 作为唤醒状态的清晰视觉指示。
  • 支持合盖运行:专为在合盖时保持本地任务运行而设计。
  • 自动关闭计时器:可选的计时器(从 1 分钟到 24 小时),可自动恢复睡眠行为,并可在合盖时触发立即睡眠。
  • 远程 UI 兼容性:可选的“保持显示唤醒”模式,允许远程 UI 操作(例如 Computer Use)在合盖时继续进行。
  • 注重隐私:无遥测、无需账户,且仅将网络用于更新。

相关