在 Mac 上安装
下载 Agent HUD，放进「应用程序」，打开客户端回调以接收请求与回复，并保持更新。
Agent HUD 的 Mac 版从 agenthud.app/mac 下载，经过签名并由 Apple 公证。把它装进「应用程序」文件夹，它会自己找到你 Mac 上的 agent。
系统要求
| macOS | 14 或更高版本 |
| Mac | Apple 芯片或 Intel，各有各的下载 |
| Agent | 安装并登录你想关注的 agent。支持的 agent 列出了它们。 |
| iPhone 与 Apple Watch | 可选，从 App Store 获取。见 iPhone。 |
GitHub 上的部分发行页面还附有 Windows 与 Linux 的未签名测试版，它们尚未在真机上测试，也不会自动更新。
安装
下载
打开 agenthud.app/mac，它会跳到 GitHub 上的最新发行版。Apple 芯片的 Mac 下载 arm64 的 DMG，Intel 的 Mac 下载 x86_64 的 DMG。
移到「应用程序」
打开 DMG，把 Agent HUD 拖到 Applications 上。
打开
从「应用程序」文件夹打开 Agent HUD。
放在「应用程序」里
只有位于 /Applications/Agent HUD.app 的 Agent HUD 才能给 agent 添加客户端回调与 HUD 工具。从其他位置打开时，这些开关不可用。
首次启动
- 每块屏幕上出现 HUD：有刘海的屏幕用刘海形态，其他屏幕用动态形态。见形态。
- 菜单栏出现图标，里面有各个 agent 的读数，以及隐藏灵动岛光晕、统计…、刷新数据、设置…和退出。
- Agent HUD 把自己加入登录项，登录 Mac 后自动启动。可以在设置 → 通用 → 登录时启动关闭。
- 它会找到你的 agent，开始读取它们在你 Mac 上的记录，以及厂商报告的额度。
只有打开设置或统计窗口时，Agent HUD 才在程序坞里显示图标。Agent HUD 运行时，再从「应用程序」打开它，会打开设置。
打开客户端回调
请求以及大多数 agent 的回复，经由各 agent 自己设置里的小段回调来到 HUD。客户端回调默认关闭，由你打开。
打开设置 → 通用。
在客户端下，打开客户端回调。
需要的话，修改等待回答：请求在 HUD 上等多久，到时交还 agent。默认 10 分钟。
Codex 要等你在 Codex 中审阅并信任新的回调后才会运行它。在那之前，Codex 的请求留在 Codex 里。
关闭客户端回调会移除 Agent HUD 的回调，你自己的回调保持原样。每个 agent 里写了什么，见客户端回调；在 HUD 上能回应什么，见请求。
更新
Agent HUD 每天检查一次新版本。有新版本时，菜单栏菜单里出现发现新版本…，面板底部出现一个箭头，两者都会打开设置 → 更新。
| 设置 | 作用 | 默认 |
|---|---|---|
| 自动检查更新 | 每天检查一次新版本 | 开 |
| 自动下载更新 | 下载新版本并验证签名，安装仍需你确认 | 关 |
| 接收测试版 | 改用测试版更新源，切换时清除已下载的待更新版本 | 关 |
同一页里有检查更新；有新版本时，还有下载更新、安装更新、立即重启和跳过此版本。在你选择安装更新之前，不会安装任何东西。
新版本会写明它需要的 iPhone 应用版本（需要 iPhone 版本）。如果你在用 iPhone 应用，请先更新它。
退出或卸载
退出：打开菜单栏图标，选择退出（⌘Q）。
卸载：先移除 Agent HUD 加进 agent 设置里的内容。在设置 → 通用关闭客户端回调，其余各项按全部移除里列出的步骤移除。然后退出 Agent HUD，把它从「应用程序」移到废纸篓。
只删除应用，回调仍会留在 agent 的设置里，指向一个已经不存在的应用。
最后更新于