Agent HUD文档

Token 与费用

Agent HUD 怎样统计各 agent 的 Token,怎样按 API 标价估算费用,以及在你的 Mac 上保留 30 天历史。

Agent HUD 读取各 agent 本来就保存的记录,告诉你 Token 用在了哪里:哪些 agent、模型、会话和轮次用掉了它们,同样的工作按 API 标价大约要花多少。额度告诉你还剩多少,Token 用量告诉你是怎么用掉的。

统计什么

每次调用都拆成互不重叠的五类,五类相加正好是这次调用的全部:

类别包含什么
输入没有经过缓存的新提示 Token
输出回复本身,不含思考
思考回复之前用于思考的输出
缓存写入写入缓存、供后续调用使用的提示 Token
缓存读取从缓存读回的提示 Token
  • 很多日志把思考算在输出里,把缓存的部分算在输入里。Agent HUD 把它们拆出来,每一类只算一次。
  • 日志里重复记下的同一次响应,只计一次。
  • 一个会话的 Token 包含它启动的子 agent。跨 agent 的合计里,每个子 agent 的记录只算一次。
  • 缓存命中是提示 Token(输入、缓存写入与缓存读取)中从缓存读取的比例。

缓存读取是 agent 每次调用都要读回的上下文,它随会话变长而增长,和这段会话做了多少事关系不大。所以 Token 图表默认不含缓存读取。比较两个总数时,先让它们包含相同的类别。

在哪里看

  • 悬停面板:过去 24 小时的 Token,显示在额度旁边。
  • 统计窗口:点悬停面板底部的用量统计打开,有 Token 与会话两个标签页。
  • 会话页:在会话标签页或悬停面板里点一个会话。
  • iPhone 与 Apple Watch:Token 统计、会话及其 Token。见 iPhone。
  • 你的 agent:内置 MCP 服务用同一份数据回答关于用量、会话与统计的问题。

Token 标签页

控件或区域显示什么
统计范围5 小时、24 小时、7 天或 30 天
时间粒度5 小时与 24 小时可选 15 分钟、30 分钟或 1 小时;7 天可选 1 小时或 1 天;30 天按 1 天
类别不含缓存读取(默认)、全部 Token,或五类中的任意组合
智能体与模型只看部分 agent 或模型
按智能体每个 agent 在所选范围里的 Token、占比与估算费用,以及用得最多的模型与会话
API 余额DeepSeek 等余额,附每天的花费
近期用量今天、近 7 天与近 30 天,各带缓存命中率与用得最多的模型
活跃热力图 · 近 7 天agent 在哪些钟点工作

会话页

会话页显示这个会话的 Token(含子 agent 的部分)、估算费用、上下文占用与缓存命中。Claude Code、Codex 与 DeepSeek Harness 的会话还会列出每一轮新增的 Token,以及这一轮里每次调用的模型、上下文和它请求的工具。需要把上下文重新发送一遍的调用,标有缓存过期,上下文重发。

费用

费用是估算:同样的调用按厂商的 API 标价计算,标 ≈。它不是实际扣费,也不是订阅的账单。

  • 每类 Token 按各自的单价计算,每次调用按它的提示长度所在的价格档位计算。
  • 中国区或国际区价目:DeepSeek、智谱 GLM、Kimi(月之暗面)、通义千问与小米 MiMo 都公布两套价格。Agent HUD 按 agent 所连的平台取价:看它配置的端点或套餐,DeepSeek 看余额的币种。看不出来,或者一个 agent 两边都连时,按国际区价目。
  • 人民币与美元分开累计,从不换算。
  • 没有标价的模型不计入估算,估算的说明里会写出它的名字。
  • 经过中转站的调用,优先用中转站自己的价格表;没有时按官方价乘以你设置的倍率。你自己电脑上的模型服务按免费计算。

修正价格

设置 → 价格列出最近 30 天里 agent 用过的每个模型,附它的 Token、每百万 Token 的价格,以及价格来源:价目表、中转站价格表、倍率、自定义或本地。点设置价格填写你自己的价格,费用随即重算;点改回自动价格即可恢复。

历史与时间范围

  • Token 历史保存在你 Mac 本机的数据库里,保留 30 天,更早的用量逐日清理。第一次启动 Agent HUD 时,它会读取 Mac 上已有的记录,最远回溯到这 30 天。
  • 会话标签页列出近 7 天里活跃过的会话。按日期按最后活跃的日期分组;活跃只列近 24 小时里活跃过或仍在运行的会话。可以按来源和项目路径筛选,也可以按标题、来源、模型或路径搜索。
  • 子 agent 不单独列出,从启动它的会话里进入。
  • 归档或删除的会话:你在 agent 里归档或删除一个会话后,它的 Token 仍计入合计,会话本身从所有列表里消失。

数据从哪里来

Token 数来自各 agent 写在你 Mac 上的记录:它的日志或本地数据库,只读,不做改动。agent 写下新的用量后,统计随之更新。有两个 agent 不同:

  • Cursor 不在本机保存 Token;从 Cursor 3.27 起,它的完成回调会报告每次生成的 Token,前提是客户端回调已打开。
  • Grok Bot 的 Bot 运行在 Cursor 的服务器上,由服务器给出每个 Bot 每天的 Token。

Token 总数说明不了额度还剩多少:额度百分比是厂商自己对你套餐的读数。见额度与余额。

最后更新于

本页目录