VoidBreak

把专注计时、强制休息和一颗会吞文件的黑洞放进 macOS 桌面。

VoidBreak 是一个原生 macOS 菜单栏休息助手。工作阶段大部分时间保持安静； 连续工作 58 分钟后，它会用实时引力透镜效果接管屏幕，提醒你离开电脑休息。

下载与安装

从 GitHub Releases 下载 VoidBreak-0.1.0.dmg，打开后把 VoidBreak 拖进 Applications 文件夹即可。

当前安装包同时支持 Apple Silicon 和 Intel Mac。由于安装包尚未经过 Apple 公证，首次启动时如果被 Gatekeeper 拦截，请右键点击 VoidBreak 并选择 “打开”。

特性

• 原生 Swift + AppKit，使用 Swift Package Manager 构建。
• GPU 实时积分 Schwarzschild 光线轨迹，呈现引力透镜、光子环和吸积盘。
• 启动后每隔 12–40 分钟随机出现一次小黑洞，持续 30 秒；不受工作计时重置影响， 菜单中可查看下次出现的预计剩余时间。
• 监测键盘、鼠标与滚动活动，58 分钟后进入强制休息。
• 保持 1 分钟无输入即可结束休息；连续空闲 3 分钟会重置工作周期。
• 文件拖进黑洞时只会移入 macOS 系统废纸篓，仍可恢复。
• 只在随机小黑洞或强制休息显示期间启动 ScreenCaptureKit；黑洞隐藏时不会 录制屏幕。

系统要求

• macOS 13 或更高版本
• Apple Silicon 或 Intel Mac

构建与运行

从源码构建需要 Command Line Tools for Xcode，不需要完整 Xcode。

./scripts/test-state.sh
./scripts/build-app.sh
open "dist/VoidBreak.app"

开发运行：

swift run VoidBreak

构建脚本默认使用 ad-hoc 签名。若希望 macOS 在重复构建后稳定识别屏幕录制 权限，可指定自己的签名身份：

CODE_SIGN_IDENTITY="Your Signing Identity" ./scripts/build-app.sh

生成同时支持 Apple Silicon 和 Intel Mac 的 DMG 安装包：

./scripts/package-dmg.sh

首次启动后，在菜单栏选择“开启屏幕录制权限…”，并按提示重新打开应用。 全屏叠层只会在权限有效且收到可见的首帧后出现；无权限、空帧或全黑帧不会 覆盖桌面。

安全与隐私

VoidBreak 不上传屏幕画面、文件名或使用数据。ScreenCaptureKit 帧仅在本机 内存中用于实时着色，并在黑洞隐藏后清除。拖入的文件使用 macOS trashItem API 移到系统废纸篓，不会直接永久删除。

开源许可

项目本身使用 MIT License。

黑洞着色器改编自 MIT 许可的 s0xDk/ghostty-blackhole， 详细版权信息见 THIRD_PARTY_NOTICES.md。