Token HUD 桌面助手

Token HUD — 用量,一眼可见

常驻系统托盘的桌面助手:菜单栏即可查看当日用量与额度余量,本机 Agent 工具一键配置接入。

DeepSeek HarnessWorkBuddyCodexClaude CodeTcode
产品功能

核心功能,完整呈现

用量面板

当日消耗全景实时呈现,3 秒自动刷新,异常状态即时可见。

用量面板:今日费用与 Token 双主数字、用量概览、额度进度
  • 今日费用与今日 Token 并列双主数字
  • 总 Token、上下行流量、请求数与成功率、平均响应同屏汇总
  • 日 / 月额度进度条,已用百分比与剩余量一目了然

工具接入

本机 Agent 工具集中管理,已装未装一眼分明,一键完成配置。

工具接入:DeepSeek Harness / WorkBuddy / Codex / Claude Code / Tcode 一键配置
  • 自动检测已安装工具,当前配置状态实时可见
  • DeepSeek Harness / WorkBuddy / Codex / Claude Code / Tcode 一键配置模型
  • 模型清单与网关地址自动写入,无需手动复制 Key
三档视图

三级信息密度,按需取用

托盘、悬浮球、弹出面板三种视图形态,覆盖从状态感知到明细查看的完整链路

托盘图标 · 状态感知

macOS 菜单栏直接显示今日 Token,图标颜色反映运行状态(正常蓝 / 超额红 / 离线灰),无需打开任何窗口即可确认当日消耗是否正常。

悬浮球 · 常驻监控

贴边圆形小窗常驻屏幕顶层,在 Token、流量、请求数、响应时间、费用五个指标间每 3 秒轮播,外圈进度环显示今日额度用量。支持拖动与位置记忆,单击展开面板。

弹出面板 · 明细分析

380px 浮层面板,展示今日费用与 Token 双主数字、流量与请求构成、额度进度,3 秒自动刷新;离线时保留最后一次已知状态并明确标注。

核心能力

全面的功能特性

围绕只读监控定位构建的完整能力体系

数据真实可信

每一个数字都经得起对账,异常情况如实呈现。

  • 托盘、面板与 Web 报表同一统计口径与格式化规则
  • 状态条明示数据源与新鲜度(实时 / MySQL 约 1 分钟延迟)
  • 无数据的指标隐藏而非显示 0,登录失效如实提示

托盘快捷操作

常用动作一步直达,不必先打开窗口。

  • 左键单击开合面板,悬停查看完整摘要
  • 右键菜单:刷新 / 打开 Web 后台 / 设置 / 退出
  • 面板一键跳转 Web 后台查看完整报表

轻量高效常驻

常驻一整天,也几乎感觉不到它的存在。

  • 面板展开时高频轮询,折叠自动降为 60 秒
  • 故障时指数退避与抖动错峰,不给服务端添压
  • 悬浮球独立轻量渲染,常驻内存目标 < 150MB

本机工具一键接入

自动将模型清单与网关地址写入本机 AI 工具的配置文件,接入即用。

  • DeepSeek Harness 一键配置模型
  • WorkBuddy / Codex 自动检测与一键接入
  • 无需手动复制 Key 与网关地址

自动更新

新版本后台静默下载,重启即完成升级。

  • 静默下载,不打扰工作
  • 重启即完成升级
  • 无需手动下载重装

实时数据通道

网关侧实时计数器直连桌面端,低延迟且不增加系统负载。

  • 网关 Lua 将当日用量实时写入 Redis 计数器
  • 读数延迟从约 1 分钟降到约 1 秒
  • 数据源异常时自动降级为聚合数据并明示来源
上手流程

从下载到看见用量,只要几分钟

无需手动填写 Key,浏览器授权即完成接入

1

下载安装包

按操作系统选择:Windows(64 位).exe,或 macOS(Apple 芯片 / Intel 芯片).dmg。

2

浏览器授权登录

启动后自动唤起系统浏览器完成 OAuth 授权(PKCE),无需手动填写任何 Key。

3

托盘就绪

授权成功后托盘出现图标、菜单栏显示今日 Token,连接即建立。

4

查看用量

点击托盘图标或悬浮球展开面板,3 秒自动刷新,实时掌握当日消耗。

5

一键接入工具

在面板中为 DeepSeek Harness / WorkBuddy / Codex 一键配置模型,接入即用。

只读与安全

只读、安全、零干扰

仅读取用量数据,不接管流量路径,不接触账号密码

纯只读监控

不代理任何流量、不修改任何配置,网关与计费链路不做任何变更——客户端仅读取报表数据。任何写操作(调整额度、签发 Key 等)均可一键跳转 Web 后台完成。

零干扰

无弹窗骚扰、无声音提醒,没有开机闪烁与常驻通知——它只在你想看的时候存在。

凭据安全

客户端不持有你的密码;登录凭据保存在系统安全存储(macOS Keychain / Windows DPAPI)中,token 不落明文。

离线可读

离线时保留最后一次已知状态并明确标注,连接恢复后自动续传,不会将过期数据呈现为实时数据。

系统要求

Windows 与 macOS 双平台

每个平台独立安装包,覆盖团队全部终端

Windows 10 / 11(64 位)

.exe 安装包(NSIS),托盘图标 + 悬浮球 + 面板全功能支持。

macOS 12+(Apple 芯片)

.dmg 安装包,菜单栏直接显示今日 Token,模板图标随系统明暗主题自动着色。

macOS 12+(Intel 芯片)

.dmg 安装包,与 Apple 芯片版功能完全一致。

让每一次消耗都在视野之内

不再等到被限流或阻断才发现额度耗尽。下载 Token HUD,当日用量实时可见、额度余量随时可查。