给 MacBook 刘海装了个 Claude Code 面板:额度、对话、待办,鼠标一指全看到

给 MacBook 刘海装了个 Claude Code 面板:额度、对话、待办,鼠标一指全看到

cyxj-notch:鼠标移到刘海上,展开 Claude Code 面板

cyxj-notch(我叫它「刘海台」)是一个 macOS 刘海面板。鼠标移到 MacBook 刘海上停一下,它从刘海里长出来,把 Claude Code 的额度、所有开着的对话、任务进度、缓存倒计时、我手上的内容待办,一次摆在眼前;鼠标移开,它缩回刘海,看不见。代码开源在 GitHub:chenyuxiaojin/cyxj-notch。

它解决什么问题

我平时同时开好几个 Claude Code 对话,一个在剪视频、一个在写文章、一个在改工具。想知道「额度还剩多少」「哪个跑完了」「哪个停太久缓存要凉了」,就得一个一个终端切过去看。

刘海台把这些全收到屏幕最上面。不管我在哪个 App 里,鼠标往上一推就看到了。

面板上有什么

展开后的面板:额度、对话、缓存、待办、发片节奏

区块显示什么
额度5 小时额度、本周额度各用了多少,什么时候重置
缓存最快凉停着的对话里,缓存剩得最少的那一个;所有对话都在干活时自动消失
对话每个开着的 Claude Code:运行中 / 空闲 / 刚跑完,做到第几步
正在推进的内容我内容待办里的条目,轮到我动手的标「等你」排最前
发片节奏距上次发片几天、下一次定时发布是什么时候

「缓存还热 12 分钟」这个说法可能要解释一下。你一直接着聊,Claude Code 会复用之前的上下文缓存,又快又省;停太久缓存就过期了,下一条消息要把整段上下文重新发一遍,更慢也更贵。按 Claude Code 官方文档,Pro/Max 订阅在套餐额度内,主对话的缓存是 1 小时。所以面板提醒我:先回快凉的那个。

怎么做到的:mod 写小文件,App 来读

Claude Code 有一种插件叫 mod(官方介绍):写一个 JavaScript 或 TypeScript 文件,在「对话开始」「每轮说完」这些时刻,让 Claude Code 帮你干点事,比如在状态栏显示一行字、弹个提醒、往本地写个文件。

刘海台就是这么搭的:

Claude Code 对话 → 5 个 mod → ~/.claude/notch/ 下的几个小 JSON 文件 → 刘海台每 2 秒读一次
mod在 Claude Code 里干什么给刘海台写什么
quota-status状态栏显示额度和缓存倒计时,快用完时弹提醒每个对话的额度和状态,60 秒一次
task-progress给 Claude 一个「报进度」工具,多步任务每做完一步走一格每个对话的进度
version-board列出后台跑出来的预览版本版本列表
todo-pane侧边面板显示我的内容待办待办列表
publish-pulse状态栏显示发片节奏发片节奏

刘海台自己只读不写,也不跟 Claude Code 直接对话。好处是:mod 坏了不影响 App,App 关了不影响 Claude Code;哪个对话关掉了,150 秒没更新就自动从面板上消失。5 个 mod 一共 44 个测试,在 Claude Code 2.1.295 上全部通过。

改了几轮才不丑

第一版能用,但我看着太丑:就是一块黑底上排了几行字。后面一轮一轮地改:

  1. 先换成卡片。额度变成大数字卡片,每个对话一张卡,状态用彩色小标签。原来「在忙」两个字我自己都看不懂,改成「正在推进的内容」。
  2. 再换成苹果原生那种毛玻璃底。但刘海本身是纯黑的硬件,毛玻璃是半透明的,直接接上会看到一块黑一块透。最后的办法是:贴着刘海那一截纯黑,往下慢慢渐变成毛玻璃,看不出接缝。
  3. 然后是宽度。原来收起的时候,刘海两边各多出一截小耳朵显示状态,看着就像在菜单栏上贴了一张纸。改成收起时和刘海一模一样大,藏在刘海里;只有鼠标指上去才变宽。
  4. 最后是动效。原来是硬生生地冒出来。现在展开时带一点回弹,里面的内容一块接一块浮现;收起更快、不回弹。出场比进场短,这是动效设计里的老规矩。

一个从源头解决的问题

待办里每条的「下一步」原来特别长,一条能串三四个步骤,面板上一眼看过去全是字。

一开始想的是在面板上截短,或者让一个小模型帮我压缩。后来发现更干净的办法在源头:我的内容待办文件本来就有一道「格式闸门」,AI 每次改它都会自动检查,不合格当场打回。那就给闸门加一条规则:下一步只写一步、最多 30 个字,开头写清轮到谁,小陈:、AI: 或 等 10-13 14:59: 三选一(开源版默认认的是 我:,可以换成自己的名字)。

规则一加,面板反而简单了:开头是我的,就标「等你」排最前;是 AI 的,标「AI 接手」压暗一点;是等某个时间的,右边显示时间。不用猜,也不用再花钱调模型。

想自己装一个

需要 macOS 14 以上、Claude Code v2.1.287 以上。额度那一块要 Pro 或 Max 订阅,因为 Claude Code 只给订阅用户报额度。

git clone https://github.com/chenyuxiaojin/cyxj-notch.git
cd cyxj-notch
./build.sh
open build/刘海台.app

再把仓库里 mods/ 下的 5 个文件夹加进 Claude Code 的设置,面板就有数据了。具体写法、每个 mod 怎么配,仓库 README 里都写了。没有刘海的 Mac 也能用,它会在屏幕顶部正中划一块当「假刘海」。


我是陈与小金,专注 AI 落地。本期就到这里,如果对你有帮助,欢迎评论转发。

祝你身体健康,永远平安。祝你 Token 无限,永远自由。