SleeperX 完整指南：让 Mac 学会“该睡就睡、不该睡绝不睡“的睡眠控制神器

2026/8/16 9:29:52

SleeperX 完整指南：让 Mac 学会"该睡就睡、不该睡绝不睡"的睡眠控制神器

【免费下载链接】SleeperXMacBook prevent idle/lid sleep! Hackintosh sleep on low battery capacity.项目地址: https://gitcode.com/gh_mirrors/sl/SleeperX

深夜 11 点，你合上 MacBook 盖子准备回家，第二天到公司却发现：通宵渲染的视频只有一半、编译了三个小时的代码工程损坏、从服务器拉取的大文件断在半路。如果你经历过任何一个瞬间，说明你的 Mac 正在用一套"一刀切"的睡眠策略，替你做着最坏的决定。

macOS 的睡眠机制从来只有一个开关：要么睡，要么不睡。系统不会关心你此刻是在开会演示、下载文件、编译代码，还是单纯忘了充电。SleeperX 是一款专为 Mac（尤其黑苹果）打造的开源菜单栏睡眠控制工具，它把"何时睡眠"的决定权交还给你：低电量自动入睡、充电时保持清醒、合盖不中断任务、禁用睡眠还能设定时自动恢复。本文将从初识到精通，带你完整掌握这台 Mac 睡眠控制神器。

一、先弄清一件事：你的 Mac 为什么会"乱睡"

在讲工具之前，值得花 30 秒搞清楚敌人是谁。macOS 的睡眠行为由三个相互独立的开关共同决定：

开关	控制什么	默认行为
闲置睡眠（idle sleep）	键盘鼠标长时间无操作后入睡	系统设置决定，通常 10~30 分钟
合盖睡眠（lid sleep）	合上盖子立即睡眠	笔记本默认开启
休眠模式（hibernatemode）	睡眠时内存是否写入磁盘	笔记本默认 mode 3

麻烦在于：黑苹果（Hackintosh）系统上，这三个开关经常表现错乱。有的黑苹果合盖后立即死机而非睡眠，有的低电量时不睡导致电池过度放电损坏，有的闲置 5 分钟就断 SSH。而苹果官方并没有提供图形化的细粒度控制界面——这正是 SleeperX 存在的理由。

二、初识：5 分钟装好，菜单栏多一位"睡眠管家"

SleeperX 是一个菜单栏应用，安装后常驻在屏幕右上角，点击图标即可看到电池百分比、充电状态和剩余时间，以及所有睡眠控制选项。

获取与安装：项目通过 Git 分发，克隆后按标准流程构建：

git clone https://gitcode.com/gh_mirrors/sl/SleeperX cd SleeperX uv sync --extra build uv run python build.py

构建产物是dist/SleeperX.app和对应的 zip 安装包，直接拖入「应用程序」即可。由于应用未签名，首次打开时 Gatekeeper 会拦截，两种方式放行：

右键点击应用 → 选择「打开」
或在终端执行：xattr -dr com.apple.quarantine /Applications/SleeperX.app

首次启动的欢迎流程会询问是否安装特权助手——先别急着跳过，下面会解释它为什么重要。整个安装过程不会超过三分钟。

三、上手：四个菜单项，看懂它的核心能力

装好之后，菜单栏里真正值得你记住的功能只有四个，每一个都对应前面提到的一个"睡眠开关"：

立即睡眠 / 息屏：手动触发整机睡眠或仅关闭显示器，适合下班前或临时离开。
禁用闲置睡眠：临时让 Mac 保持清醒，不被"闲置超时"打断。渲染视频、跑编译、看直播都靠它。
禁用合盖睡眠：合上盖子继续工作。外接显示器、下载大文件、远程桌面时是刚需。
定时自动取消：每个"禁用"后面都跟着一组时间选项（5 分钟、30 分钟、1 小时、3 小时、12 小时……），到期自动恢复系统默认睡眠策略，防止你忘了关开关导致整夜不睡。

一个典型用法：开完会合上盖子准备离开，顺手点「禁用合盖睡眠 → 2 小时后自动取消」，下载任务在后台继续跑，两小时后策略自动复位——你不用记得自己做过什么，SleeperX 会替你善后。

四、进阶：充电与低电量，两套智能策略替你兜底

如果说上面的手动开关是"遥控器"，那这一节讲的才是 SleeperX 的"自动驾驶"。

充电时自动保持清醒

在「偏好设置」中打开两个开关：

充电时禁用闲置睡眠：插着电源时，闲置多久都不会自动入睡。桌面工作站、外接屏合盖、SSH 常驻连接，全都不再断。
充电时禁用合盖睡眠：插电状态下合盖，任务照常运行。

这两项是"有电就放肆"的策略，配合前面说的定时取消，几乎覆盖了所有"需要在固定时段保持清醒"的场景。

低电量保护性睡眠

反过来，在电池供电且电量告急时，SleeperX 会主动让 Mac 入睡，避免过度放电损伤电池。默认阈值是电量 6% 或剩余使用时间 10 分钟，均可自定义：

# 配置文件中对应的字段（config.json） low_battery_capacity_sleep: true # 启用低电量自动睡眠 low_battery_capacity: 6 # 电量 ≤6% 时触发 low_time_remaining: 10 # 剩余时间 ≤10 分钟时触发

注意，这套低电量保护只在使用电池（放电状态）时生效，充电时不会误触发——这正是它与系统自带策略的关键区别：系统只会"无脑睡"，而 SleeperX 会看电源状态、看电量、看你的设定，再做决定。

五、精通：合盖锁屏、休眠模式与权限安全模型

当你开始把 SleeperX 当作生产力基础设施的一部分，下面三个细节会带来质的提升。

合盖即锁屏，安全不留死角

禁用合盖睡眠后，Mac 合盖不再入睡，但屏幕依然可以锁定。SleeperX 在合盖时自动触发锁屏，让你既能合盖跑任务，又不至于让屏幕内容一直暴露在外——远程维护服务器时尤其安心。

深度休眠模式（hibernatemode）

在「高级选项」里，你可以切换三种睡眠模式：

模式	行为	适合谁
0	内存不入盘，唤醒快	台式机、外接电源用户
3	内存入盘 + 内存供电，唤醒快且有保险	笔记本默认，最均衡
25	内存完全断电，从磁盘恢复，最省电	追求极致续航的黑苹果

黑苹果用户常遇到的"睡眠即死机"问题，很多时候就是休眠模式与硬件不匹配导致的，这个开关值得一试。

为什么它敢要 root 权限，却又值得信任

禁用合盖睡眠和修改休眠模式必须写入系统级pmset命令，普通权限做不到。SleeperX 的解决方案是安装一个LaunchDaemon 特权助手，安全模型有三层保障：

一次性授权：仅在安装助手时输入一次管理员密码，密码不落盘、不存储、不传输；
白名单命令：助手只会执行固定的一组pmset命令，没有 shell、没有通用执行能力；
双重校验：通信走 Unix socket，配合 socket 权限与对端 uid 校验，防止其他进程冒充调用。

也就是说，其余所有功能（整机睡眠、息屏、禁用闲置睡眠、低电量保护）都不需要 root，权限面被压到了最小。

六、日常使用与排障：几个值得知道的细节

多语言零切换成本：SleeperX 内置英文、简体中文、繁体中文、日文、韩文五种语言，在菜单里一键切换，界面即时重建。
崩溃与日志：应用内置日志系统，路径在~/Library/Application Support/com.hsojo.sleeperx/logs/。导出日志时敏感信息会自动脱敏，可以放心把日志发给开发者排查问题。
开机自启：偏好设置里可开关登录时自动启动，本质是一个用户级 LaunchAgent，随时可移除。
升级检查：菜单栏内置「检查更新」，自动比对最新版本，不必手动盯仓库。

如果某个功能"没反应"，排查顺序建议是：先确认 macOS 版本 ≥ 10.12（Sierra）；再看日志里是否有 pmset 相关的权限报错；最后重启应用——大多数问题到此为止。