🪖 Bulchimbeon(불침번)
你 Mac 的守夜士兵。一个菜单栏应用,只在你的 AI 编程智能体真正工作时让 Mac 保持唤醒,然后敬个礼说“交班!”,让 Mac 去睡觉。无需 hook,无需守护进程,无需安装 root helper。一个应用搞定。支持 macOS 13 及更高版本。在 Linux 上,一个带命令行和托盘图标的小型守护进程也能完成同样的工作:见 Linux。
你 Mac 的守夜士兵。一个菜单栏应用,只在你的 AI 编程智能体真正工作时让 Mac 保持唤醒,然后敬个礼说“交班!”,让 Mac 去睡觉。
无需 hook,无需守护进程,无需安装 root helper。一个应用搞定。支持 macOS 13 及更高版本。在 Linux 上,一个带命令行和托盘图标的小型守护进程也能完成同样的工作:见 Linux。
Bulchimbeon(불침번)是韩国军队里的夜间站岗:有人整夜不睡,好让其他人安心睡觉。一位像素画风的下等兵替你的 Mac 值这一班。
🌐 한국어 · 日本語 · 简体中文 💡 Ideas / 문의 / 建议 🗳️ Which agent do you use it with? Where did you get stuck? Vote and tell us

从这里开始
安装:brew install --cask s3onghyun/tap/bulchimbeon —— 或者下载最新的 macOS zip 并把它移到 /Applications。
首次启动:从 0.12.6 起,应用使用 Developer ID 签名并已通过 Apple 公证,所以它会直接打开。最多,macOS 会问一次是否要打开从互联网下载的应用:点击 Open。当它询问 Bulchimbeon 是否可以发送通知时,允许它;此后通知将来自 Bulchimbeon 本身。
那些版本是 ad-hoc 签名且未经公证,所以 macOS 会拦截一次:
- 打开 Bulchimbeon。macOS 提示无法打开;点击 Done。
- 前往系统设置 → 隐私与安全性,向下滚动到安全性。
- 在“‘Bulchimbeon’已被阻止”旁边,点击仍要打开,然后确认。(从 macOS 15 起,右键 → 打开不再能绕过此限制。)

它们的通知会显示为“Script Editor”,因为 macOS 不会给未经公证的应用授予自己的通知权限。更新到 0.12.6 或更高版本即可消除这两点。
支持的智能体:Claude Code · Codex · Gemini CLI · Cursor Agent · Copilot CLI · Aider · OpenCode(以及你自己的自定义智能体)。
用你的 AI 智能体来安装
把这段粘贴到 Claude Code、Codex、Gemini CLI 或其他编程智能体中。智能体会按照 docs/install-for-agents.md 操作,并把 macOS 的任何首次启动提示留给你。
Install Bulchimbeon (https://github.com/s3onghyun/bulchimbeon) on this computer by following
https://raw.githubusercontent.com/s3onghyun/bulchimbeon/main/docs/install-for-agents.md step by step. Show me each command before you run it.
Rules: install only from the Homebrew cask s3onghyun/tap/bulchimbeon or github.com/s3onghyun/bulchimbeon releases,
and check the SHA-256 of anything you download. No sudo for the Mac app. Never remove the quarantine attribute
(xattr) or turn off Gatekeeper (spctl): if macOS asks about or blocks the first launch, stop and let me answer it myself.
Finish by checking with me that Agent watch is ticked in the menu.
安装后的 1 分钟检查
- 点击菜单栏上的下等兵,确认 🤖 Agent watch(auto shift)已被勾选。Agent watch 默认开启;如果你关掉过,就把它勾上。应用会记住你的选择。
- 给一个智能体分配任务,例如让 Claude Code 运行你的测试。
- 几秒钟内,菜单栏上的下等兵就会打开他的手电筒。
- 打开菜单。在欢迎说明下方(在你点击 Got it 之前会一直显示),状态行显示 Bulchimbeon — On duty · 0:12 · …,下面一行说明原因,例如 Claude Code working。
- 什么都没发生?运行 /Applications/Bulchimbeon.app/Contents/MacOS/Bulchimbeon --diagnose 看看它检测到了什么,并告诉我们你卡在了哪里。
文章标题:Show HN: Bulchimbeon,在 AI agent 工作时让 Mac 保持唤醒的夜间值守
正文: 要查看 macOS 自身持有的睡眠阻止状态,请运行 pmset -g assertions。值守期间:
2026-10-31 13:17:17 +0900
Assertion status system-wide:
BackgroundTask 0
ApplePushServiceTask 0
UserIsActive 0
PreventUserIdleDisplaySleep 0
SoftwareUpdateTask 0
PreventSystemSleep 0
ExternalMedia 0
PreventUserIdleSystemSleep 1
NetworkClientActive 0
Listed by owning process:
pid 2102(Bulchimbeon): [0x002847ba00019690] 13:31:53 PreventUserIdleSystemSleep named: "Bulchimbeon on duty: keeping AI agents awake"
Kernel Assertions: 0x100=MAGICWAKE
id=592 level=255 0x100=MAGICWAKE creat= mod= description=en0 owner=IOSkywalkNetworkBSDClient
- 2026-10-31 13:17:17 +0900:命令运行的时间。
- Assertion status system-wide:各类睡眠阻止状态,以及当前各自被持有多少个。PreventUserIdleSystemSleep 1 表示有某个东西正在阻止 Mac 进入空闲睡眠。PreventUserIdleDisplaySleep 0 表示显示器仍可睡眠,这是默认的值守模式。开启 Keep display on 后,Bulchimbeon 改为持有显示器阻止,因此 PreventUserIdleDisplaySleep 显示为 1,而下方 Bulchimbeon 自己的那一行会显示该类型。
- Listed by owning process:每个阻止状态由谁持有。pid 2102(Bulchimbeon) 是该应用(你的 pid 会不同),[0x002847ba00019690] 是该阻止的 ID,13:31:53 是值守取得它的时间。该时间不带日期,因此它可能来自更早的一天,显示的时间也可能晚于头部时间。PreventUserIdleSystemSleep 是它的类型(开启 Keep display on 时为 PreventUserIdleDisplaySleep),而 named: "Bulchimbeon on duty: keeping AI agents awake" 是要查找的固定名称。其他让 Mac 保持唤醒的应用也会列在这里。
- Kernel Assertions:macOS 自身的条目(这里是 en0 的网络唤醒),并非来自 Bulchimbeon;你的可能不同。
截取于 macOS 26.6.2,Apple Silicon,Bulchimbeon 0.11.0。
空闲时(没有 agent 在工作),Bulchimbeon 会释放它的阻止,因此 pmset -g assertions | grep -i bulchimbeon 不会打印出任何 Bulchimbeon 行。
常见问题
为什么不直接用 caffeinate 或 Amphetamine?当你想手动、固定地持有唤醒锁时,它们很好用。Bulchimbeon 则在 AI agent 活跃工作前后开始和结束锁,因此不会被整夜遗忘。
它会检查或发送什么?它不使用任何 hook。它唯一的网络请求是每天一次的更新检查,只发送版本号,且可以关闭。它仅观察你本地的进程元数据,以判断受支持的 agent 是否在工作;它从不存储或打印进程命令行或环境变量。
它能让合上的笔记本保持唤醒吗?可以,但开启合盖模式需要管理员批准。值守结束或应用退出时,它会恢复正常合盖睡眠。
| 状态 | 这个士兵 | 何时出现 |
|---|---|---|
| 💤 下班 | 戴着头盔打盹,zzz | 没有需要看守的东西 |
| 👀 待命 | 四处张望 | 等待 agent 上岗 |
| 🪖 值守 | 手电筒亮着,巡逻中 | Mac 不会睡眠 |
| 🫡 交班 | ^ ^ 敬礼 | agent 安静下来 / 值守时间结束 |
| 🥵 战斗休息 | 流着汗,闭着眼 | Mac 过热 |
🚶 巡逻模式
这个士兵带着手电筒,就在你的菜单栏下方巡逻。待命时他在角落里四处张望;交班时他会带着对话气泡敬礼。点击会直接穿透,指针靠近时他会淡出,并且他不会出现在全屏应用(演示、屏幕共享、视频)中。尺寸 2× / 3×,或将他关闭。
🗣️ 这个士兵的台词
Show HN:Bulchimbeon,在 AI 代理工作期间让 Mac 保持唤醒的夜间值守
| 何时 | 它说 |
|---|---|
| 值守中 | “不会打瞌睡!……大概吧。” · “安心睡吧。交给我!” |
| 待命 | “擦亮我的步枪……待命。” |
| Mac 过热 | “高温预警!补水 🥵” → “战斗休息!降温 🧊” |
| 电量低 | “向值班军官报告 🔋 电量 15%……体力不支,撤岗。10 分钟内插上电源,我会重新上哨。” |
| 睡眠阻止丢失 | “不是擅离职守!回到岗位!🫡” |
| 你回来了 | “交接报告!📋” |
为什么
以前为了让代理整夜运行,我会这样做:
caffeinate -d # ...and forget to turn it off
sudo pmset disablesleep 1 # ...and forget to turn it back on → battery at 0%
Bulchimbeon 只在代理工作时保持唤醒,工作结束后把 Mac 交还给正常睡眠。
功能
| 🤖 代理值守 | 检测 Claude Code、Codex
| Bulchimbeon | Adrafinil | |
|---|---|---|
| 如何判断 agent 正在工作 | 从外部观察:agent 的 caffeinate 子进程和 CPU 使用率 | 由 agent 主动告知:hooks(提交 prompt 时 acquire,回复结束时 release)外加观察 |
| 安装会改变什么 | 什么都不改。只有一个 app;绝不触碰 agent 配置文件 | 向 agent 配置中添加 hooks(一键安装/卸载)、一个用户守护进程、一个 root helper |
| macOS | 13 及更高版本 | 26.4 及更高版本 |
| 合盖保持唤醒 | 每次开启时都需要输入管理员密码;由 watchdog 保证该设置被恢复 | 安装时批准一次,之后不再需要密码 |
| Agent 请求保持唤醒(长时间构建) | — | CLI 和 MCP 工具 |
| 发热 | 即使开盖也会警告;过热时休息,冷却后自动恢复 | 合盖状态下过热时强制释放 |
| 分发方式 | Developer ID 签名并公证(从 0.12.6 起),个人 Homebrew tap | 已公证,官方 Homebrew cask |
如果你使用 macOS 26.4+,希望用 hooks 精确追踪轮次,或者希望 agent 自己请求唤醒时间,请选择 Adrafinil。如果你使用 macOS 13–15,不希望向 agent 配置或系统中安装任何东西,或者更希望有一个私有的守夜者,请选择 Bulchimbeon。
安装
brew install --cask s3onghyun/tap/bulchimbeon
# 更新——先刷新 tap,Homebrew 的自动更新间隔很长
brew update && brew upgrade --cask bulchimbeon
或者从 Releases 下载 zip 并移到 /Applications。macOS 13+,通用(Apple Silicon 和 Intel)。
首次启动:macOS 会拦截一次该 app;相关步骤见 Start here。
验证下载(可选)
发布 zip 仅在 GitHub Actions 中构建,并带有构建来源证明。
gh attestation verify Bulchimbeon-<version>.zip --repo s3onghyun/bulchimbeon
shasum -a 256 -c Bulchimbeon-<version>.zip.sha256
更新
该 app(以及 Linux 守护进程)每天向 GitHub 查询一次是否有更新的版本发布。如果有,菜单会显示 New version X.Y.Z — Update 和 Release notes;修复严重 bug 的版本会标注 (recommended: important fix)。在你点击 Update 并确认之前,不会下载或安装任何内容。
- 通过 Homebrew 安装:Terminal 会打开,并在你眼前运行 brew update && brew upgrade --cask bulchimbeon,然后重新打开 app。
- 从 zip 安装:app 会从该版本发布中下载 Bulchimbeon-X.Y.Z.zip 及其 .sha256,校验 checksum,并检查新 app 的代码签名是否有效、是否与正在运行的 app 具有相同的签名标识符和团队、是否使用 hardened runtime 且版本与提供版本完全一致。只有全部通过后,它才会替换自身并重启;当前守夜继续进行。如果任何一步失败,已安装的 app 保持原样,并改为提供发布页面。该 app 必须位于可写入的文件夹中,例如 /Applications。
- Linux:仅通知。bulchimbeon status、托盘菜单和 bulchimbeon doctor 会显示更新及按你的安装方式给出的命令(brew upgrade bulchimbeon-linux、sudo apt install ./….deb、sudo dnf install ./….rpm、yay -Syu bulchimbeon-bin 或 tarball),守护进程会在 journal 中注明。
隐私。该检查是一次 HTTPS GET https://api.github.com/repos/s3onghyun/bulchimbeon/releases/latest,每天最多一次,仅携带 User-Agent: Bulchimbeon/<version>、Accept 和固定的 Accept-Language: en。不会发送任何设置、值守日志、agent 名称、标识符或 cookie,也没有遥测。与任何网络请求一样,GitHub 会看到你的 IP 地址。这是 Bulchimbeon 唯一的网络访问。
要关闭它,在菜单中取消勾选 Check for updates (once a day),或者:
defaults write io.github.s3onghyun.bulchimbeon checkForUpdates -bool false # macOS
bulchimbeon config set checkForUpdates false # Linux
工作原理
| Watch mode | 底层机制 |
|---|---|
| 保持屏幕常亮 | IOPMAssertion PreventUserIdleDisplaySleep ,等同于 caffeinate -d |
| 允许屏幕休眠(默认) | IOPMAssertion PreventUserIdleSystemSleep ,等同于 caffeinate -i |
| 合上盖子 | 上述机制加上 pmset -a disablesleep 1 。合盖是硬件触发,assertion 无法阻止 |
Agent detection
Bulchimbeon 使用 libproc 扫描当前用户自己的进程,通过可执行文件名、argv[0]、安装路径或脚本路径来匹配 agent。绝不使用子串匹配(Claude Code 的 hooks 会运行 node -e "...'.claude'...",子串匹配会误中)。
| 安装方式 | 进程的样子 | 匹配依据 |
|---|---|---|
| Claude Code 原生安装器 | 可执行文件 ~/.local/share/claude/versions/2.1.296 (以版本号命名!) | argv[0] = claude ,或安装路径 |
| Homebrew / IDE 内置二进制 | .../claude 、 /opt/homebrew/bin/codex | 可执行文件名 |
| npm 全局安装 | node /opt/homebrew/bin/claude | 脚本名 |
| npx / 包路径 | node .../@anthropic-ai/claude-code/cli.js | 包路径 |
| bun / deno | bun .../@google/gemini-cli/... | 包路径 |
支持的 agent:Claude Code · Codex · Gemini CLI · Cursor Agent · Copilot CLI · Aider · OpenCode
只在工作时才算数。人们会同时开着好几个 Claude Code 会话,所以如果只统计打开的会话,Mac 就永远无法休眠。一个 agent 只有在显示出自己最近的活动时,才算处于工作状态:
| 信号 | 原因(在真实机器上测得) |
|---|---|
| agent 及其在过去 10 分钟内启动的进程平均 60 秒占用 ≥ 2% CPU | 覆盖回复和构建、测试等工具运行。空闲会话的占用为 0–0.1%(Linux 上为 0.6–0.9%)。5 秒的采样会让周期性的后台任务看起来永远在忙 |
| 运行超过 10 分钟的进程,只有它自身占用 ≥ 5% CPU 才算数 | 长时间构建仍然算数。MCP 服务器(约 0.3%)和 hook 轮询器(约 1%)不算,也不会再跨会话累加 |
| caffeinate 子进程只有在过去 10 分钟内启动的另一个子进程与它并行运行时才算数 | Claude Code 在一轮对话进行中会启动 caffeinate -i -t 300 ,但一个要等上好几个小时的 Stop hook 会让这一轮一直保持打开。工具调用和命令 hook 默认在 10 分钟后超时 |
| 在另一个 agent 下启动的 agent(由 hook 运行的 claude -p 辅助进程)按其自身情况判断 | 它的 CPU 不会计入启动它的那个会话 |
| 没有工具的无头会话( --tools= )被忽略 | 像 claude-mem 这样的插件会让辅助会话一直运行 |
要恢复旧行为(任何打开的 agent 进程都让 Mac 保持唤醒),请打开 Agent watch settings ▸ Count idle sessions as working(agentWatchCountsIdle)。交接前的 5 分钟宽限期在同一个子菜单里。 --diagnose 会显示每个 agent 是由上述哪条规则判定的。
查看你机器上会检测到什么,或添加一个不在列表中的 agent:
/Applications/Bulchimbeon.app/Contents/MacOS/Bulchimbeon --diagnose
defaults write io.github.s3onghyun.bulchimbeon customAgents -array goose amp
在 Docker 内或通过 SSH 在远程主机上运行的 agent 不是这台 Mac 上的进程,因此不会被检测到。
pmset -g assertions | grep Bulchimbeon # is it on watch right now?
值班逻辑位于一个纯状态机(DutyEngine)中,没有任何系统调用,用假时钟逐场景测试。设计说明,包括我们尝试过并否决的信号:docs/design.md。
Linux
Bulchimbeon 也能在 Linux 上运行,作为一个带有命令行和托盘图标的小型守护进程。它使用与 macOS 应用相同的引擎:一个 Go 移植版本,必须通过与 Swift 核心相同的黄金测试用例(testdata/engine),并在每个 pull request 的 CI 中运行。已在 Ubuntu 24.04(systemd 255)上测试。它需要 systemd 和 logind。值班期间,它通过你桌面环境自己的 inhibitor 阻止自动挂起;没有桌面环境时则使用 logind 的 inhibitor(见下文)。
Install
在 Linux 上使用 Homebrew(无需 root; brew upgrade 可获取新版本):
brew install s3onghyun/tap/bulchimbeon-linux
brew services start bulchimbeon-linux # systemd user unit, started at login
选择一种安装方式。如果使用 Homebrew,不要再安装 tarball,也不要启用 .deb 或 .rpm 单元(systemctl --user enable bulchimbeon),否则会运行两个守护进程。
或者从 Releases 下载:适用于 amd64 或 arm64 的 tarball 或 .deb,或者从 0.9.0 起,适用于 x86_64 或 aarch64 的 .rpm。
# Tarball: no root needed. Installs ~/.local/bin/bulchimbeon and a systemd user unit, then starts it
tar -xzf bulchimbeon_<version>_linux_amd64.tar.gz
cd bulchimbeon_<version>_linux_amd64 && ./install-linux.sh
# or the .deb: installs /usr/bin/bulchimbeon and the user unit; each user then enables it
sudo apt install ./bulchimbeon_<version>_amd64.deb
systemctl --user enable --now bulchimbeon
# or the .rpm (Fedora and others, from 0.9.0): the same files; each user then enables it
sudo dnf install ./bulchimbeon-<version>-1.x86_64.rpm
systemctl --user enable --now bulchimbeon
即将推出,尚未发布:Fedora COPR 仓库(dnf copr enable)和 AUR 包 bulchimbeon-bin。在此之前,在 Fedora 上使用 .rpm,在 Arch 上使用 tarball,或者在检出目录的 packaging/aur/bulchimbeon-bin 中运行 makepkg -si。
验证下载(可选):sha256sum -c SHA256SUMS --ignore-missing,以及 gh attestation verify <file> --repo s3onghyun/bulchimbeon。
卸载方式:brew services stop bulchimbeon-linux && brew uninstall bulchimbeon-linux、./install-linux.sh --uninstall,或者先 systemctl --user disable --now bulchimbeon,然后 sudo apt remove bulchimbeon 或 sudo dnf remove bulchimbeon。你的设置(~/.config/bulchimbeon)和值班日志(~/.local/state/bulchimbeon)会保留。
要在注销后仍保持服务运行,运行一次 loginctl enable-linger。
使用
bulchimbeon status # on duty or not, and why
bulchimbeon doctor # check the desktop session, systemd, logind and polkit
bulchimbeon config set agentGraceMinutes 10
bulchimbeon config set customAgents goose amp
bulchimbeon config set language ko # ko | en | zh | system (default: follows LANG)
journalctl --user -u bulchimbeon -f # the daemon's log
$ bulchimbeon status
🪖 Bulchimbeon — on duty for 0:35 (agent watch)
Lock: blocking auto-suspend via org.gnome.SessionManager · confirmed by the session
Why: Claude Code pid 1174857 11.7% (own + recent processes CPU ≥ 2.0%, 60 s average)
Agents: Claude Code ×7 open, 1 working
Handover: 5 min after the last agent goes quiet (agentGraceMinutes)
Power: battery: none · heat: normal (coretemp 49 °C, critical 105 °C) · lid: not handled (closing it still suspends)
bulchimbeon run 是守护进程本身;用户单元运行它。它始终执行 agent watch:相同的检测规则,每 5 秒检查一次,当某个 agent 及其在过去 10 分钟内启动的进程使用至少 2% CPU(60 秒平均值;Linux 没有 caffeinate 信号)时接管,在宽限时间后交接。
托盘图标
bulchimbeon tray 把列兵放进你的桌面面板,姿态与 Mac 菜单栏上相同,动画方式也相同:守护进程关闭时睡觉,等待 agent 时四处张望,值班时手电筒亮着,在战斗休息时流汗。悬停可查看完整状态。菜单按相同顺序显示 bulchimbeon status 的每一行,然后是一个 🧥 Uniform 选择器(用于设置 uniformTheme),以及 Quit tray(仅关闭图标:守护进程仍会在没有它的情况下继续监视)。
.deb 和 .rpm 会通过 XDG 自启动条目 /etc/xdg/autostart/bulchimbeon-tray.desktop 在每个桌面会话中启动它;install-linux.sh 会把相同的条目放到 ~/.config/autostart/。使用 Homebrew 时,把 bulchimbeon tray 添加到桌面的启动应用程序中。在无处显示它的情况下(SSH、无头机器、没有托盘的桌面),或者对于从未启动过守护进程的用户,它会记录一行日志然后退出。
文章标题:Show HN: Bulchimbeon,在 AI 代理工作时让你的 Mac 保持唤醒的夜间值守工具
正文: 它是一个 StatusNotifierItem,也就是 KDE、XFCE 和 GNOME AppIndicator 扩展所使用的托盘协议:
| 桌面环境 | 所需条件 |
|---|---|
| XFCE 4.16 或更高版本 | Status Tray 面板项(systray),默认面板已自带 |
| XFCE 4.14 或更早版本 | xfce4-statusnotifier-plugin 面板项 |
| GNOME | AppIndicator 扩展(gnome-shell-extension-appindicator,在 Ubuntu 中默认开启) |
| KDE Plasma | 无需任何条件。下班或待命时,该项为 Passive,因此 Plasma 会把它保留在托盘的隐藏图标中,直到 private 上岗 |
bulchimbeon tray & # 立即在当前桌面会话中显示
bulchimbeon tray --lang ko # 韩语菜单(ko | en | zh),不受语言设置影响
bulchimbeon config set uniformTheme navy # default | navy | arctic | desert:与 Uniform 菜单相同
要禁止它开机自启,请在桌面环境的会话与启动设置中将其关闭,或删除自启动文件。
在 Linux 上的工作方式
| Linux | |
|---|---|
| Agents | 来自 /proc 的你自己的进程,匹配规则和隐私限制与 macOS 上相同 |
| Sleep lock | 桌面会话的 suspend inhibitor,若没有则使用 logind sleep inhibitor(因桌面而异)。绝不使用 idle lock。若守护进程死亡,即使是被 kill -9 杀死,锁也随之释放 |
| Battery stand-down | /sys/class/power_supply |
| Heat | hwmon(coretemp、k10temp 等)或 thermal zones:在临界温度以下 15 °C 发出高温警告,在临界温度以下 5 °C 进入战斗休息 |
| Duty log | ~/.local/state/bulchimbeon/duty-log.txt,格式与 macOS 上相同 |
各桌面环境下的睡眠锁
| 会话 | 上岗期间的锁 | 仍然有效 |
|---|---|---|
| GNOME(Ubuntu、Fedora)、Cinnamon、MATE、Budgie | org.gnome.SessionManager.Inhibit,仅带 suspend 标志 | 屏幕变暗并锁定;从菜单手动挂起。GNOME 46(Ubuntu 24.04)会为任何 suspend inhibitor 附加自己的 logind block lock,因此在终端中执行 systemctl suspend 需要加 -i |
| KDE Plasma | org.freedesktop.PowerManagement.Inhibit,PowerDevil 仅将其应用于自动挂起 | 屏幕变暗、关闭并锁定;可手动挂起 |
| XFCE | 默认使用 logind sleep inhibitor,与无桌面环境时相同,在任何 systemd 版本上都无法阻止 xfce4-power-manager 的自动挂起(block 和 block-weak 都会放行你自己用户的挂起请求)。执行 bulchimbeon config set xfceKeepAwake true 可切换到 org.freedesktop.PowerManagement.Inhibit | 屏幕变黑并锁定;可手动挂起。启用 xfceKeepAwake 后,自动挂起也会被阻止,但 XFCE 的电源管理器会把任何 inhibitor 视为演示模式,因此上岗期间屏幕会保持常亮且不锁定 |
| 无桌面环境:headless、仅 SSH、sway、Hyprland、其他合成器 | logind sleep inhibitor,在 systemd 257 及更高版本上为 block-weak,在 256 及更早版本上为 block,由一个与管道绑定的 systemd-inhibit 子进程持有 | 你自己的挂起请求。它会阻止 logind 的 IdleAction 以及其他用户的挂起请求。在 systemd 256 及更早版本上,在终端中执行 systemctl suspend 需要加 -i |
为什么不在所有地方都用 logind:在 systemd 256 及更早版本(Ubuntu 24.04、Debian 12)上,对于持有 block inhibitor 的用户所发出的请求,logind 会忽略该 inhibitor,而 GNOME、XFCE 和 Cinnamon 的电源管理器会以你的身份请求 logind 挂起。在 Ubuntu 24.04 GNOME 上实测:Bulchimbeon 持有其锁时,gsd-power 的自动挂起请求仍通过了 logind。在 systemd 257 及更高版本上,logind block lock 确实能阻止它们,但也会拒绝你自己的手动挂起。
守护进程会在你的会话总线上查找桌面环境,也就是 systemd --user 为其服务提供的用户总线。在它上岗期间登录桌面环境,锁会在一次检查(5 秒)内转移到桌面环境;注销后则会移回 logind。守护进程的总线连接关闭时,桌面环境会释放其 inhibitor,因此崩溃也会释放锁。bulchimbeon status 显示当前持有哪种锁以及原因;bulchimbeon doctor 会逐一尝试每种锁。
限制
- 合上盖子仍会挂起。默认情况下 logind 会忽略盖子开关的抑制项(LidSwitchIgnoreInhibited=yes),而 Bulchimbeon 从不修改 logind 的设置。
- 通过 SSH 或在无头机器上,睡眠阻断需要一条 polkit 规则。默认情况下 polkit 只允许本地登录(即有人在机器屏幕前)持有睡眠阻断抑制项。从 SSH 会话中,或作为无人本地登录的机器上的用户服务,logind 会拒绝它,而 bulchimbeon status 会明确提示睡眠未被阻断。要为某个用户允许它,请将以下内容保存为 /etc/polkit-1/rules.d/50-bulchimbeon.rules(所有者 root,权限 0644),并替换为你的用户名;bulchimbeon doctor 会打印出已填入你名字的版本:// Bulchimbeon: let YOUR-USER-NAME hold a logind "sleep" block inhibitor from an SSH or // systemd --user session (polkit's default only allows it from a local session). // Grants nothing else. Remove this file to undo. polkit.addRule(function (action, subject) { if (action.id == "org.freedesktop.login1.inhibit-block-sleep" && subject.user == "YOUR-USER-NAME") return polkit.Result.YES; }); 它只向该用户授予 org.freedesktop.login1.inhibit-block-sleep;删除该文件即可撤销。Bulchimbeon 从不替你运行它。桌面会话不需要它:它自带的抑制项无需 polkit 权限。只有不使用桌面时的 logind 锁才需要。
通过 SSH 或在无头机器上,睡眠阻断需要一条 polkit 规则。默认情况下 polkit 只允许本地登录(即有人在机器屏幕前)持有睡眠阻断抑制项。从 SSH 会话中,或作为无人本地登录的机器上的用户服务,logind 会拒绝它,而 bulchimbeon status 会明确提示睡眠未被阻断。要为某个用户允许它,请将以下内容保存为 /etc/polkit-1/rules.d/50-bulchimbeon.rules(所有者 root,权限 0644),并替换为你的用户名;bulchimbeon doctor 会打印出已填入你名字的版本:
// Bulchimbeon: let YOUR-USER-NAME hold a logind "sleep" block inhibitor from an SSH or
// systemd --user session (polkit's default only allows it from a local session).
// Grants nothing else. Remove this file to undo.
polkit.addRule(function (action, subject) {
if (action.id == "org.freedesktop.login1.inhibit-block-sleep" && subject.user == "YOUR-USER-NAME") return polkit.Result.YES;
});
它只向该用户授予 org.freedesktop.login1.inhibit-block-sleep;删除该文件即可撤销。Bulchimbeon 从不替你运行它。桌面会话不需要它:它自带的抑制项无需 polkit 权限。只有不使用桌面时的 logind 锁才需要。
- sway、Hyprland 以及其他没有桌面电源管理器的合成器只能获得 logind 锁。它无法阻止以你的身份执行挂起的空闲守护进程(如运行 systemctl suspend 的 swayidle 或 hypridle),因为 logind 会放行你自己的挂起请求。Bulchimbeon 在这些环境上也不持有空闲锁:在那些合成器上,持有空闲锁还会连带阻止屏幕锁定。
- 在 XFCE 上,默认不会阻断自动挂起。xfce4-power-manager 会把任何挂起抑制项当作演示模式处理,并保持屏幕常亮且不锁定,因此 Bulchimbeon 不去动屏幕锁,只持有 logind 锁,而 xfce4-power-manager 自身的挂起在任何 systemd 版本上都能绕过它。bulchimbeon status 和 doctor 会说明这一点。若要强行阻断,并接受值班期间屏幕保持常亮且不锁定:bulchimbeon config set xfceKeepAwake true。
- 桌面抑制项只覆盖你自己的会话。同一台机器上另一个用户的会话(快速用户切换)仍可能使其挂起。会话总线为私有的桌面(用 dbus-launch 启动、未使用 dbus-user-session)对服务不可见,此时服务会退而持有 logind 锁。
- Linux 上只有“Display may sleep”一种监视模式(dutyMode 会被忽略),没有巡逻模式,通知会写入 journal。
- 计划支持 Windows:平台层位于 internal/platform。
安全
Show HN:Bulchimbeon,在 AI 代理工作时让你的 Mac 保持唤醒的夜间值守工具
该应用以管理员权限运行 pmset,并读取其他进程的元数据,因此它有自己的威胁模型:SECURITY.md。
- 除每天一次的更新检查外无网络访问,该检查仅发送应用版本且可关闭;无第三方依赖
- 更新仅在你点击后安装:Homebrew 安装通过 brew 在可见的终端中进行,zip 安装只在校验和与代码签名检查通过后才会被替换
- 无 shell 注入面:使用绝对路径、最小环境,且只有应用 PID、一个安全引用的应用自有停止标志路径和应用的引用启动时间会进入管理员命令
- 根权限的 lid watchdog 没有可延长的截止时间;所有监视计时都由应用掌控。一个用户所有、非全局可写的空停止标志只能让它运行 pmset -a disablesleep 0;它从不读取该标志、不跟随其指向别处,也不写入它
- 从不存储或打印其他进程的参数或环境;从不读取 AI 转录记录
- 启用强化运行时,发布版本提供 SHA-256 校验和与构建来源证明,CI 操作按提交 SHA 固定
开发
只需要 Command Line Tools,无需 Xcode。Linux 守护进程是一个 Go 模块(Go 1.27 或更高版本):go test ./... 和 go build ./cmd/bulchimbeon。
make test # unit + scenario tests
make app # dist/Bulchimbeon.app (ad-hoc signed)
make run # build and launch
make icons # regenerate the app icon and preview after editing sprites
# launch and start agent watch right away
open dist/Bulchimbeon.app --args --agent-watch
# print the engine's effects to stderr (for tracing)
BULCHIMBEON_DEBUG=1 dist/Bulchimbeon.app/Contents/MacOS/Bulchimbeon
想帮忙?从 CONTRIBUTING.md 开始。
发布(维护者)
git tag vX.Y.Z && git push origin vX.Y.Z # → the Release workflow builds, attests and uploads
./scripts/bump-cask.sh X.Y.Z # → verifies checksums and provenance, then updates the tap's cask and Linux formula
./scripts/bump-aur.sh X.Y.Z # → same checks, then updates packaging/aur for the AUR (packaging/aur/README.md)
# Fedora COPR, once set up: copr-cli buildscm ... --commit vX.Y.Z (packaging/rpm/README.md)
精灵图是 Sources/BulchimbeonCore/Sprites.swift 中的 ASCII 网格:一个字符代表一个像素,以矢量矩形绘制,因此 16 pt 的菜单栏图标和 1024 px 的应用图标都能保持清晰。
菜单栏动画与功耗
菜单栏精灵在可见时以每秒 2 帧推进。当屏幕锁定、显示器休眠或 AppKit 报告状态项窗口被完全遮挡时,它会完全停止;在低电量模式下以 0.67 fps 运行。计时器带有容差,单帧姿态完全不会安排计时器,因此不会产生重绘。
一个 AppKit NSStatusItem 会被 macOS 复制到每个菜单栏。AppKit 不会为这些副本提供可独立绘制的状态项或活动显示器,因此 Bulchimbeon 无法在不替换标准菜单栏项的情况下只为一个显示器做动画。因此,可见动画在每个活动显示器上保持完全一致。
2026-11-06 在一台使用交流电的 M5 Pro 上测得,内置面板加两台 LG 4K 显示器:此变更前 top 报告 2.04% CPU 和 167 次上下文切换/秒,变更后为 1.58% CPU 和 186 次上下文切换/秒(五次 2 秒采样,启用巡逻模式)。此 macOS 版本的 top 没有按进程的唤醒计数器,因此上下文切换被记录为可用的唤醒代理指标;正常可见动画有意不被声称是速度提升。节省来自不可见时零调度的菜单栏帧(而非每秒 2 帧),以及低电量模式下减少 67% 的帧。
路线图
以里程碑形式跟踪。1.0 意味着设置键、命令行标志和值班日志格式停止变化:参见兼容性承诺(韩文;表格本身不言自明)和 CHANGELOG。
- 像素艺术私有、巡逻模式、韩文/英文/简体中文界面
- 检测工作中的代理与空闲的代理
- Homebrew cask(个人 tap)
- Apple 公证(0.12.6)
- 官方 Homebrew cask
- 用于在合盖模式下移除管理员提示的特权助手
- 可解锁皮肤:Joseon 守夜人、学者
贡献
欢迎提交错误报告(“🚨 士兵行为异常”)、agent 请求、翻译修正,以及台词或精灵图的创意。英文、韩文、日文或中文的 issue 和 PR 都可以。寻找 good first issue 来开始,并阅读 CONTRIBUTING.md。
注意
合盖进行繁重、长时间的工作会使 Mac 发热。尽可能插上电源。