苹果迷苹果迷  2026-11-21 21:15 苹果家园 |  隐藏边栏 |   抢沙发 |  4 
文章评分 0 次,平均分 0.0 :
导语: GravityNotch 是开源刘海工具,把锁屏播放器、同步歌词、音量亮度提示、屏幕取词、剪贴板和本机会话监视放进刘海。代理页读本机记录,显示的用量不是账户额度;音量亮度提示需要辅助功能权限,安装包还要在系统设置里放行。

GravityNotch 把锁屏播放器、音量与亮度提示、屏幕取词、剪贴板和编码代理会话都放进 MacBook 刘海。仓库 adrielakak/GravityNotch 于 2026 年 10 月 29 日建立,2026 年 11 月 21 日仍有推送,使用 Swift 编写,采用 GPL-3.0 许可。项目目前有 2 颗星、0 个派生仓库和 7 个未关闭的问题,公开了 15 个发行版。

最新的 gravitynotch-v1.2.12 在 2026 年 11 月 21 日发布,构建号为 278。它在设置的外观常规页新增两个开关,可以隐藏刘海里的计时器和 Caffeine 按钮,关闭时也会停下正在运行的计时或防睡眠。项目是 TheBoredTeam/boring.notch 的增强分支,README 明确致谢原作者,并沿用同一份许可证。

加亮后的项目动图首帧,刘海附近有两个小图标和鼠标指针
项目动图首帧加亮后的画面,只能辨出刘海附近的小图标与鼠标指针

锁屏播放器盖在锁屏之上

GravityNotch 的锁屏播放器用 SkyLight 窗口显示在 macOS 锁屏之上,面板采用磨砂玻璃外观。播放控制包括进度拖曳、上一首、重播当前曲目、播放暂停、下一首和 CoreAudio 输出设备切换。面板在播放器没有曲目或应用退出时会隐藏,曲目暂停时仍保持可见,避免每次锁屏都看到一块空面板。

歌词分两路取得,LRCLIB 返回的同步文本和 Apple Music 内嵌歌词。项目会自动清理曲名里的“Slowed”“Remix”这类后缀,点击任意一行可以跳到对应时间。动态封面这一项只认 Apple Music 的动态封面,按专辑缓存到本地,减少同一张专辑切歌时的闪烁;静态封面会在点按后放大在播放器里。

锁屏播放器实现要点,包括 SkyLight 窗口、播放控制、同步歌词、动态封面和空闲隐藏
锁屏播放器的层级、控制项、歌词来源和封面规则

Playing Next 把待播队列放到首页

播放控制里有一个 music.note.list 按钮,点开后能直接看 Playing Next 队列。首页还允许在日历和待播队列之间切换,点列表中的任意一首会立即播放,向上的箭头可以把这首歌提到队首。队列数据也覆盖 Apple Music 目录里的专辑曲目,项目在随机播放开启时会提醒用户,界面顺序和实际播放顺序可能不同。

这类队列视图依赖音乐应用给出的播放状态。切歌、提到队首这些动作发生在当前播放器里,GravityNotch 没有另建一份曲库。队列里显示的歌曲顺序一旦遇到随机播放,就需要按项目给出的提示来理解,界面上看到的下一首未必是实际播出的下一首。

音量亮度 HUD 走事件拦截

README 把音量、显示亮度、键盘背光和 Caps Lock 提示列为刘海内的系统 HUD,并写明兼容 macOS 26 Tahoe。实现上,源码把监听范围限在 NSSystemDefined 事件,先检查字段 99 的子类型,再读字段 149 的键码。只有音量、亮度和键盘背光键会被接管,播放暂停、上一首、下一首这些媒体键原样放行,避免把音乐控制一起吞掉。

事件监听跑在独立的 userInteractive 线程上。回调里还会检查辅助功能权限是否仍然有效,权限消失或信任记录超时后会停用监听,转入降级状态。刘海内显示音量与亮度需要辅助功能权限,这也是首次启动后必须按引导授权的一项;没有这个权限,按键仍归系统处理,刘海不会弹出对应提示。

系统交互实现要点,包括音量亮度、CGEvent 字段、屏幕取词、右键抓图和剪贴板
硬件按键、屏幕取词和剪贴板各自走的处理流程

屏幕取词和剪贴板放在同一处

刘海顶部的 text.viewfinder 按钮有两种操作。左键框选屏幕区域后,Apple Vision 的 VNRecognizeTextRequest 会识别其中文字并放进剪贴板;右键可以抓下指定的区域、窗口或界面元素,送到 Shelf 暂存。两条路径共用刘海入口,识别文字和保留画面各有自己的去向。

Clips 标签页监视 NSPasteboard.general,记录文字、链接、文件和十六进制色值,色值会显示实时色块。页面支持搜索、固定、一键复制和发送到 Shelf。Shelf 里还能对拖入的图片做文字识别、ZIP 压缩、PNG 转换和背景移除,背景移除使用 Vision 的 VNGenerateForegroundInstanceMaskRequest;分享按钮走 0x0.st,文件会离开本机。

代理标签页读的是本机会话

Agents 标签页汇总 Claude Code、Codex CLI 和 Antigravity 的会话。源码读取用户主目录下的 .claude/projects 和 .codex/sessions,再解析 Antigravity 的记录。页面显示输入、缓存读取和输出 token,给出缓存命中率、步数、进度清单、改动文件及差异数量,还有工具活动列表和代表工作状态的像素图标。

这些读数来自本机会话文件里的字段。标签页里的 token 表示一段会话已经用掉的量,账户还剩多少额度需要到各家应用里看。监视器最多保留 6 个会话快照,按活跃状态、是否正在工作和更新时间排序;手动选中某个会话后,两分钟且当前会话安静时会回到最新活动会话。代理结束或等待输入时,闭合的刘海会显示状态,旁边也会弹出提示。

代理标签页要点,包括读取本机记录、状态指标、运行判断、自动跟随和完成提示
代理标签页读取本机记录,并把 token、步数和工具活动放在一起

安装、权限和更新要看清

项目提供 DMG 和 Homebrew 两种安装方式,Homebrew 命令是 brew install --cask adrielakak/tap/gravitynotch。README 写明支持 macOS 14 Sonoma 及以上,Apple Silicon 与 Intel 都在范围内,源码构建要求 Xcode 16 及以上。首次打开如果被系统拦截,要到系统设置的隐私与安全性里点“仍要打开”;入口没有出现时,项目给出的命令是 xattr -cr /Applications/GravityNotch.app。

启动引导会要求授予辅助功能权限,刘海内的音量与亮度提示依赖这项授权。从 v1.2.6 起,内置 Sparkle 更新会从 GitHub 检查并安装新版本;v1.2.12 这一版的主要变化就是前面提到的两个显示开关。项目按 GPL-3.0 分发,对外提供修改版时要按同一许可证给出对应源码。

安装与功能边界对照,包括系统要求、首次打开、必要权限、更新方式、开源许可和功能边界
系统要求、首次打开步骤、必要权限和更新方式

各功能依赖的接口不同

SkyLight 负责把锁屏面板放到锁屏层级,CGEvent 负责接管硬件按键,Vision 负责文字识别与背景分离,CoreAudio 负责输出设备切换。Caffeine 用 IOKit 电源断言让 Mac 保持唤醒,档位包括不限时、15 分钟、30 分钟、1 小时和 2 小时。每一处都借用了 macOS 已有的接口,系统版本变化后,对应功能需要项目继续跟进。README 列出的 Caps Lock 提示也和这些系统 HUD 放在同一组功能里。

0x0.st 分享会把文件发到外部服务,动态封面只对 Apple Music 生效,代理标签页里的 token 只来自本机会话记录。这些限制分散在各自的功能里,使用前需要按具体项目判断。项目仓库还很年轻,star 数为 2,问题列表里有 7 项未关闭,功能和接口适配仍在快速推进。

README 的演示动图首帧亮度很低,正文使用的那一帧经过统一加亮,画面仍只保留刘海附近的小图标和鼠标指针。页面上的几张卡片按源码和 README 拆开写了各项功能的来源与边界,锁屏播放器、系统 HUD 和代理标签页各自的读取范围都写在对应段落里。

声明:本文来自投稿,不代表苹果家园立场,版权归原作者所有,欢迎分享本文,转载请保留出处!

发表评论

表情 格式 链接 私密 签到

友情链接

    扫一扫二维码分享