Agent HUD文档

光晕与面板

从光晕看额度,打开面板查看额度、余额、Token 与会话,一键回到会话。

静止时,HUD 告诉你额度用到了哪里、哪些 agent 在工作。悬停打开的面板里是详细信息。回复与额度提醒随时出现在 HUD 上,以动画呈现,从不使用 macOS 通知。

光晕

颜色额度已用比例
绿色不足 70%
黄色达到 70%
红色达到 90%
  • 每个 agent 一种颜色,只算有额度读数的 agent,按它用量最高的那个窗口着色。70% 与 90% 这两道线是固定的。
  • 有 agent 工作时动得更快:有 agent 运行时每 3 秒一个周期,全部空闲时每 7 秒一个周期,周期可以自己改。
  • 灰色且静止:没有可显示的读数时。
  • 位置:刘海形态下围绕刘海,动态形态下在图标背后。简约形态没有光晕。

菜单栏菜单里的隐藏灵动岛光晕,或在任何地方按 ⌥⌘H,会隐藏光晕与提醒,直到你再次显示。请求照样出现。

图标与 Bot

动态形态下,agent 工作时它的图标变成 Bot,表现出它在思考、工作还是在等你。空闲的图标偶尔变成 Bot 活动几秒。设置 → 显示里的 Bot 形象可以关闭这一效果,作用于所有屏幕。

面板

悬停 0.4 秒后面板展开。

面板:Claude 与 OpenAI 的额度窗口及重置时间,以及 DeepSeek 的余额
部分显示什么
额度明细每个 agent 一块:各额度窗口的已用比例;打开重置倒计时时,还有距离重置的时间。按余额计费的 agent(例如 DeepSeek)显示余额。
Token 消耗过去 24 小时的 Token,每 30 分钟一根柱子。7d 与 30d 切换为按天的柱子。
会话列表过去 24 小时里最多 5 个会话,最近有消息的排在前面。
  • 切换指标:每个 agent 那一块右上角的图标,把这一块从额度切换到其他指标,例如消耗速度。消耗速度与预测怎样计算,见额度。
  • 某个账户读取失败,不会挡住其他账户,原因写在它的账户旁边。
  • 已用还是剩余:百分比默认表示已用比例。要显示剩余比例,把设置 → 通用 → 额度百分比改为剩余(100% → 0%)。颜色与提醒始终按已用比例计算。
  • 底部:齿轮打开设置,用量统计打开统计窗口;有新版本时会出现一个箭头。

每块屏幕显示哪些部分、按什么顺序,在外观里设置。

点击

  • 点击一行会话,打开这个会话在统计窗口里的页面。点击会话标题,打开会话列表。
  • 会打开其他窗口的点击,会先收起 HUD。

一键回到会话

回到会话一键回到会话所在的线程、标签页或终端窗格。每张有新回复卡片和统计窗口里的会话页面上都有它。适用于 Claude Code、Codex、Antigravity、Grok Bot、OpenCode 与 Pi。

有新回复

Claude Code 的「有新回复」提醒

agent 结束一轮后,有新回复卡片显示 agent 与模型、会话标题、回复的开头几行、结束时间和这一轮用了多久。

  • 回到会话:回到这个会话。
  • 查看 Token 用量:打开这个会话的用量。

只有会上报回复的 agent 才有这张卡片(见支持的 agent),而且要在设置 → 智能体里为它打开实时状态与完成提醒。Agent HUD 启动之前就结束的轮次,不会补发提醒。

额度提醒

提醒何时出现
额度预警某个窗口的已用比例越过 90%、已经用完,或按最近的消耗速度会在重置前用完
额度已重置新读数确认窗口重新开始。提醒会写出这个账户里仍然用完的其他窗口。
获得使用重置某个 Codex 账户获得了可以使用的重置次数

同一个窗口、同一个周期里,每种提醒只来一次,重启 Agent HUD 也不会重复提醒。每种提醒何时出现、哪些会到手机上,见额度与余额。

提醒出现在哪里

  • 指针所在的那块屏幕上。 刘海形态下从刘海处展开;简约与动态形态下从发出提醒的 agent 图标里出来。刘海与动态形态下,光晕会闪一下提醒的颜色。
  • 一次一条,按到达的先后排队。回复与额度提醒在出现 4 秒后收起;指针停在上面时不会收起。
  • 请求优先。 请求在屏幕上时,回复提醒排队等候,额度提醒不再显示。
  • 没有声音。 Agent HUD 不播放提示音,也不往 macOS 通知中心发任何内容。有 Agent HUD Remote 时,提醒还会以通知的形式到达 iPhone 与 Apple Watch。

悬停时机

在设置 → 显示 → 悬停交互里设置,作用于所有屏幕:

设置作用默认
展开延迟指针停留多久后展开面板,0–1500 ms400 ms
收起延迟指针离开后面板再停留多久,0–1500 ms200 ms
按 Option 才展开只是悬停不会展开,悬停时按一下 Option 才打开面板关
鼠标触顶立即展开鼠标移到 HUD 正上方的屏幕顶边时,跳过展开延迟关

最后更新于

本页目录