你的数据
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。
最后更新于