# 光晕与面板

[Agent HUD 文档](https://agenthud.app/docs/zh/)

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

更新于 2026-10-28

静止时，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 的余额](https://agenthud.app/docs/images/hud/panel.zh.dark.webp)

| 部分 | 显示什么 |
| --- | --- |
| **额度明细** | 每个 agent 一块：各额度窗口的已用比例；打开**重置倒计时**时，还有距离重置的时间。按余额计费的 agent（例如 DeepSeek）显示余额。 |
| **Token 消耗** | 过去 24 小时的 Token，每 30 分钟一根柱子。**7d** 与 **30d** 切换为按天的柱子。 |
| **会话列表** | 过去 24 小时里最多 5 个会话，最近有消息的排在前面。 |

{/* figure: the lower part of the panel, Token usage bars and the Session list */}

- **切换指标**：每个 agent 那一块右上角的图标，把这一块从额度切换到其他指标，例如消耗速度。消耗速度与预测怎样计算，见[额度](https://agenthud.app/docs/zh/agents/quotas/)。
- **某个账户读取失败**，不会挡住其他账户，原因写在它的账户旁边。
- **已用还是剩余**：百分比默认表示已用比例。要显示剩余比例，把**设置 → 通用 → 额度百分比**改为**剩余（100% → 0%）**。颜色与提醒始终按已用比例计算。
- **底部**：齿轮打开设置，**用量统计**打开统计窗口；有新版本时会出现一个箭头。

每块屏幕显示哪些部分、按什么顺序，在[外观](https://agenthud.app/docs/zh/hud/appearance/)里设置。

### 点击

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

## 一键回到会话

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

## 有新回复

![Claude Code 的「有新回复」提醒](https://agenthud.app/docs/images/hud/reply.zh.webp)

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

- **回到会话**：回到这个会话。
- **查看 Token 用量**：打开这个会话的用量。

只有会上报回复的 agent 才有这张卡片（见[支持的 agent](https://agenthud.app/docs/zh/agents/supported/)），而且要在**设置 → 智能体**里为它打开**实时状态**与**完成提醒**。Agent HUD 启动之前就结束的轮次，不会补发提醒。

## 额度提醒

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

同一个窗口、同一个周期里，每种提醒只来一次，重启 Agent HUD 也不会重复提醒。每种提醒何时出现、哪些会到手机上，见[额度与余额](https://agenthud.app/docs/zh/agents/quotas/)。

## 提醒出现在哪里

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

## 悬停时机

在**设置 → 显示 → 悬停交互**里设置，作用于所有屏幕：

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

---

English: https://agenthud.app/docs/en/hud/glow-and-panel/