# 你的数据 [Agent HUD 文档](https://agenthud.app/docs/zh/) Agent HUD 在你的 Mac 上读取和保留什么，哪些数据会离开 Mac、何时离开、怎样受到保护，以及什么从不收集。 更新于 2026-10-28 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](https://agenthud.app/docs/zh/agents/supported/)。 - **额度与余额**：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 自己的任务文件夹标为已信任。每一项见[客户端回调](https://agenthud.app/docs/zh/agents/hooks/)。 ## 哪些数据会离开你的电脑、何时离开 ### 同一网络中的 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](https://agenthud.app/docs/zh/mcp/)。 ## 从不收集的内容 - AI 账户凭据、API key 与厂商令牌从不保存，也从不上传。 - 共享的对话从不包含工具参数、工具结果或 agent 的推理。 - 日志路径与 Mac 的硬件型号从不上传。 - 各端应用不含广告、统计或崩溃上报 SDK，不做任何跟踪。 ## 怎样关闭 | 想停止 | 这样做 | | --- | --- | | 手机在局域网中读取这台 Mac | 关闭**局域网共享**，或**撤销已配对设备** | | iCloud 里的对话 | 关闭**共享对话**，已共享的对话随即删除 | | 经由 iCloud 的请求与消息 | 关闭**远程会话**，它写入的请求随即删除 | | agent 设置里的回调 | 关闭**客户端回调**，见[客户端回调](https://agenthud.app/docs/zh/agents/hooks/) | | 所有采集与上传 | 退出 Agent HUD | 包含保留期限与网站部分的完整政策，见 [agenthud.app/privacy](https://agenthud.app/privacy)。 --- English: https://agenthud.app/docs/en/privacy/