# 外观

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

设置每块屏幕的样子：深色或浅色、透明度、大小、光晕、面板显示的内容，以及菜单栏图标。

更新于 2026-10-28

**设置 → 显示**决定 HUD 的样子。大多数设置只属于一块屏幕：有多块屏幕时，先在顶部的**显示器**菜单里选中它。改动立即生效。

## 外观

![设置 → 显示中一块屏幕的设置：HUD 形态、HUD 外观、透明度、布局密度、位置、HUD 样式与面板布局](https://agenthud.app/docs/images/settings/display-screens.zh.webp)

| 设置 | 选项 | 默认 |
| --- | --- | --- |
| **HUD 外观** | **深色**、**浅色**或**跟随系统** | 深色 |
| **透明度** | 0–100% | 0% |
| **布局密度** | 展开面板的内容间距：**宽松**、**普通**或**紧凑** | 普通 |

刘海形态下，在实体刘海处，刘海那一行始终是纯黑；从它展开的面板和卡片使用你选的外观。

应用的窗口（设置与统计）跟随的是**设置 → 通用 → 外观**：**跟随系统**、**浅色**或**深色**。同一处标为实验的**跟随所在屏幕**，让窗口外观跟随它所在屏幕的 HUD。同一页的**语言**把应用切换为中文或英文，或者跟随系统。

## 大小

动态形态：

| 设置 | 范围 | 默认 |
| --- | --- | --- |
| **Logo 大小** | 20–60 pt | 20 pt |
| **Logo 离屏幕边缘** | 0–20 pt | 2 pt |
| **Logo 间距** | Logo 大小的 0.1–0.6 倍，以 pt 显示 | 0.4 倍 |
| **显示 Logo** | 关掉只留背景，背景仍占着这些 Logo 的位置 | 开 |

简约形态：

| 设置 | 范围 | 默认 |
| --- | --- | --- |
| **大小** | 20–60 pt | 22 pt |
| **Logo 间距** | 大小的 0.1–0.6 倍，以 pt 显示 | 0.45 倍 |
| **显示圆环** | 把每个 agent 用得最多的额度窗口画成套在图标外的圆环 | 开 |
| **圆环粗细** | 1–4 pt | 1.5 pt |
| **显示数字** | 在图标旁显示额度百分比 | 开 |

## 光晕

![动态形态下图标背后的背景光晕](https://agenthud.app/docs/images/hud/mode-dynamic.zh.webp)

这一部分在刘海形态下叫**灵动岛光晕**，在动态形态下叫**背景光晕**。简约形态没有光晕，也就不显示这一部分。设置上方的预览会播放你选的动效。

| 设置 | 选项 | 默认 |
| --- | --- | --- |
| **光晕样式** | **柔光**、**点阵**、**字符**、**色块**、**盲文**、**二进制** | 柔光 |
| **动效** | **呼吸**、**流光**、**扫描**、**涟漪**、**闪烁**、**启动** | 呼吸 |
| **光晕亮度** | 20–100% | 90% |
| **光晕范围**（仅柔光） | 0–36 px | 14 px |
| **羽化**（仅柔光） | 0–36 px | 8 px |
| **仅向外扩散**（仅柔光） | 贴近 HUD 的边缘更浓，向外逐渐变淡 | 开 |
| **点距**（其他样式） | 4–12 pt | 10 pt |
| **密度**（其他样式） | 50%–150% | 100% |
| **实心**（其他样式） | 满强度的排数，0–8 | 0 |
| **渐隐**（其他样式） | 之后淡出的排数，0–8 | 5 |
| **工作时周期** | 有 agent 运行时的一个周期，1–12 秒 | 3 秒 |
| **空闲时周期** | 全部空闲时的一个周期，1–24 秒 | 7 秒 |
| **呼吸幅度**（仅呼吸） | 0–100% | 60% |

光晕的颜色始终跟随额度用量，见[光晕与面板](https://agenthud.app/docs/zh/hud/glow-and-panel/)。

## 面板内容

在**展开面板**下，为选中的屏幕设置：

- **会话列表**、**额度明细**与 **Token 消耗**分别显示或隐藏这些部分。**重置倒计时**显示每个窗口距离重置的时间。
- 下方的箭头调整这些部分以及各个 agent 明细的顺序。隐藏的部分会保留原位置。

## 图标与菜单栏

这两项作用于所有屏幕。

- **Bot 形象**：工作时保持 Bot，空闲时偶尔变成 Bot 活动几秒。悬停、等待批准或刚回复时也显示 Bot。默认开。
- **显示菜单栏图标**：快速查看用量、刷新与打开设置。默认开。

## 恢复与撤销

| 行 | 按钮 |
| --- | --- |
| **位置** | **重置位置**把 HUD 放回这块屏幕的顶部。 |
| **HUD 样式** | **恢复默认**把形态、位置、大小、外观与光晕恢复为默认；**恢复之前**撤销这一步。 |
| **面板布局** | **恢复默认**与**恢复之前**，只作用于这块屏幕的面板布局。 |

## 让 agent 来调整

![agent 调整过的面板：OpenAI 在前，Claude 只保留两个窗口](https://agenthud.app/docs/images/hud/panel-arranged.zh.dark.webp)

不必逐个开关自己设置，你可以告诉 agent 想要什么样的 HUD：「把 Codex 放在前面，只保留我关心的数据。」在**设置 → 智能体插件**里打开**允许智能体调整 HUD**，装有 Agent HUD 的 HUD 工具的 agent 就能重排面板、为任意一块屏幕的 HUD 换样式。

改动立即显示，在你于面板里按下**保存**之前都只是草稿。**丢弃**放弃草稿；没保存的草稿，Agent HUD 重启后就会丢弃。见[内置 MCP](https://agenthud.app/docs/zh/mcp/)。

---

English: https://agenthud.app/docs/en/hud/appearance/