Agent HUD文档

你的数据

Agent HUD 在你的 Mac 上读取和保留什么,哪些数据会离开 Mac、何时离开、怎样受到保护,以及什么从不收集。

Agent HUD 在你的 Mac 上完成工作。它读取各 agent 本来就保存的记录,用 agent 现有的登录状态向各厂商查询额度,算出的结果保存在本机数据库里。只有你打开的功能和更新检查,才会让数据离开你的电脑。

一览

数据在你的 Mac 上何时离开
agent 的日志与会话记录原地读取,从不改动从不以文件形式离开
Token 与额度历史本机数据库,保留 30 天只在局域网共享或 Agent HUD Remote 打开时
凭据与 API key只在发起请求时读取,从不保存只发给它所属的厂商
等你处理的请求等待期间保留,不作为历史保存只在远程会话打开时
对话最近 7 天的工作副本只在共享对话打开时

留在你 Mac 上的数据

  • 用量历史:按类别、模型与会话统计的 Token 数、费用估算,以及额度读数,保存在本机数据库里,保留 30 天。
  • 对话的工作副本:发行版从各 agent 的日志里读出最近 7 天的会话轮次,保存在只有你的 macOS 用户账户能打开的数据文件夹里,用于手机上的对话和 agent 之间的消息。
  • 请求:权限请求、提问或计划只在画成卡片时读取,你的回应直接交回 agent。请求内容不作为历史保存。
  • 发给 Claude Code 的消息:Agent HUD 交给 Claude Code 会话的消息,在只有你的用户账户能读的文件夹里等会话取走,最多保留 1 小时。

Agent HUD 读取什么

  • 各 agent 的记录:每个 agent 在你 Mac 上写下的日志、会话记录与本地数据库,以只读方式打开。每个 agent 读取哪些内容,见支持的 agent。
  • 额度与余额:Agent HUD 用 agent 现有的登录状态或已配置的密钥向各厂商查询,或者像对 Claude Code 与 Codex 那样,直接问本机安装的 agent。凭据只在发起这次请求时读取,只经 HTTPS 发给它所属的厂商,并拒绝重定向。令牌、请求头与原始响应从不保存、显示,也不写进错误信息。任何一次读取都不会向模型发送消息。
  • GitHub Copilot 的额度:只在你打开读取 GitHub Copilot 额度之后读取。
  • 中转站:只在你于设置 → 中转站中打开某个中转站之后读取。agent 本来就发给这个中转站的密钥,经 HTTPS 发往同一个地址,不发往别处。
  • 你网络中的模型服务:Claude Code 会话用的是这台电脑或局域网里的模型服务时,Agent HUD 会问这个服务运行的是哪个模型、上下文窗口多大。不会联系你网络中的其他任何设备。

Agent HUD 还会写入各 agent 的设置:它的回调,只在你打开客户端回调期间写入;你要求的那些附加项;以及 Claude Code 设置里的一条条目,把 Agent HUD 自己的任务文件夹标为已信任。每一项见客户端回调。

哪些数据会离开你的电脑、何时离开

同一网络中的 iPhone

在你于设置 → 局域网中打开局域网共享并配对设备之前,这项功能不工作。

  • Mac 把它的额度、用量与会话经 HTTPS 直接发给已配对的手机,配对时固定这台 Mac 的证书。中间不经过任何服务器。
  • 手机向这台 Mac 提供应用安装标识与设备名称,连接期间 Mac 也能看到手机的局域网地址。有 Agent HUD Remote 并打开远程会话时,手机也可以通过这条连接把消息交给 Mac;只在局域网里配对的手机只能查看,不能发送。
  • 撤销已配对设备会停止之后的读取,但不会删除手机已经缓存的数据。

Agent HUD Remote 与你自己的 iCloud

有 Agent HUD Remote 时,你的 Mac 把记录写进你自己 iCloud 账户的私有数据库,iPhone、它的小组件与 Apple Watch 在任何网络下从那里读取。

  • 加密:记录正文端到端加密,密钥在你的 iCloud 钥匙串里。Apple 和 Agent HUD 的开发者都读不到。
  • 不在加密范围内的:每条记录的种类与时间;提醒和请求还有提醒的标题、正文与所属会话,以便 iOS 显示提醒。
  • Mac 写入的内容:它的名称与应用版本;用量合计及费用估算;每个账户的额度窗口、余额与套餐,以及厂商返回的账户名或邮箱;会话的标题、agent、项目路径、时间、Token 与 agent 最后一条可见回复;以及提醒。
  • 共享对话,默认关闭:再加上它所跟踪会话的轮次正文,也就是你的提问与 agent 的可见回复。工具调用、调用结果与 agent 的推理从不包含在内。关闭后,已共享的对话会被删除。
  • 远程会话,默认关闭:再加上 agent 正在等你处理的请求(工具批准请求的工具、摘要、命令或文件路径与拟修改内容的片段;提问及其选项;计划全文),以及可以开新会话的 agent 与项目文件夹。手机与手表的回答和消息以同样的方式加密写回,Mac 取走后即删除。

没有 Agent HUD Remote 时,Mac 在你的 iCloud 里只写领取 Remote 名额的申报,以及一条设备记录:它的名称、应用版本,局域网共享打开时还有加密的连接信息。

提醒与实时活动

这两项都需要 Agent HUD Remote。

  • 提醒经 Apple 的推送服务到达你的 iPhone 与 Apple Watch。
  • 运行中会话的实时活动经过 Agent HUD 的中转服务 push.agenthud.app(运行在 Cloudflare 上),交给 Apple 的推送服务。对于运行中、等待中或 5 分钟内结束的会话,每台 Mac 向中转服务发送它的安装标识与名称、会话键的散列、agent、标题、状态与时间。中转服务不保留 iCloud 账户身份,也不记录令牌、凭据或会话文字。Mac 最后一次上报 24 小时后,它的会话被删除;30 天没有请求的账户整个删除。

更新检查

在设置 → 更新中打开自动检查更新后,发行版每天在 agenthud.app/updates/stable.json(测试版渠道为 beta.json)检查一次新版本,请求由这个地址转到 GitHub 上的发行版,更新包也从 GitHub 下载。检查时不发送用量、会话、许可证或安装标识。Cloudflare 与 GitHub 会收到 IP 地址等常规请求信息,网站只按渠道统计检查次数。

许可证

如果你用许可证而不是 App Store 开启 Agent HUD Remote,Mac 会向 Lemon Squeezy 核对许可证,它会收到每台已激活 Mac 的名称与激活标识;也会向 Agent HUD 的许可证服务核对,这个服务只列出许可证下的 Mac,不保存任何数据。许可证保存在 Mac 的钥匙串里,并经你的 iCloud 共享给你的其他 Mac。

源码构建

用 GitHub 源码构建的应用不上传任何数据。

你的 agent 与 HUD 工具

为某个 agent 添加 HUD 工具后,它可以通过你 Mac 上的 Agent HUD MCP 服务读取你的用量、会话与统计。工具返回的内容会进入这个 agent 的对话,agent 会把对话发给它自己的模型厂商。为 agent 截取的 HUD 截图会遮住你的账户。见内置 MCP。

从不收集的内容

  • AI 账户凭据、API key 与厂商令牌从不保存,也从不上传。
  • 共享的对话从不包含工具参数、工具结果或 agent 的推理。
  • 日志路径与 Mac 的硬件型号从不上传。
  • 各端应用不含广告、统计或崩溃上报 SDK,不做任何跟踪。

怎样关闭

想停止这样做
手机在局域网中读取这台 Mac关闭局域网共享,或撤销已配对设备
iCloud 里的对话关闭共享对话,已共享的对话随即删除
经由 iCloud 的请求与消息关闭远程会话,它写入的请求随即删除
agent 设置里的回调关闭客户端回调,见客户端回调
所有采集与上传退出 Agent HUD

包含保留期限与网站部分的完整政策,见 agenthud.app/privacy。

最后更新于

本页目录