GAUGE

GAUGE · 衡

AI Agent 监控台

你调用了多少、花了多少、卡在哪儿，都在上面。

---

一、随便聊聊

用AI的且购买了 Coding Plan 的人，几乎都会在某个月底心里咯噔一下：明明没觉得用了多少，额度怎么就没了？这不是你的错觉！Agent 干活的时候，token 是在背后默默流走的。一次自动重试、一轮工具调用、一个小子代理跑完三遍才收敛，钱都记在你得烧的瘪瘪的钱包上，但你无感❗

官方的用量页只有一行汇总，它不告诉你钱花在哪个项目、哪次重试、哪段缓存没打中。

GAUGE 做的事很具体：把 ZCode 本机会话库里已经存在的数据，翻译成一张你能当场看懂的读数表。

它不登录你的账号（本来想做，想了下没必要☺），不接管你的调用，不猜你的 prompt。它只做一件事——读库，算账，给你看。

---

它长什么样

三个入口，一个数据源。

桌面贴纸是一块 380×460 的碳黑玻璃小面板，贴在桌面角落。抬眼就是两个数字：5 小时滚动窗口用了多少、本周用了多少。底下一条迷你柱状图，是最近七天的估算成本。不用打开，不用点开，它就在那儿，像仪表盘上的油表。

想看清楚一点，点展开，变成 740 宽——左边两张额度卡，右边一张放大的七天趋势图。

主面板是全量统计页，六个页签：总览、趋势、会话明细、成本分布、工具与质量、数据说明。想做横向对比、想按项目排序、想找上周三那次异常，都在这里。

托盘图标管日常：立即刷新、设自动刷新间隔（5/15/30 分钟）、弹一次今日用量气泡、开官方用量页。不需要它的时候，右键退出。

三个入口读的是同一份数据，同一个成本口径。贴纸上看到 393.39，主面板里也是 393.39，不会是两套账。

---

功能简单就是直接展示

滚动窗口与自然周，分开算

这是最容易搞混的地方，GAUGE 直接分成两张卡。

5h 窗口：滚动 5 小时。琥珀色大数字是占档位额度的百分比，下面写着「已用 160.9 / 2,000 积分」，还有一行「预计 2h 26m 后开始释放」。

本周：自然周，周一 00:00 起算，白字。它同时会提示你——官方的周额度是按订阅日重置的，跟自然周不完全对齐。这句提示挂着很重要，不然看到数字对不上又该怀疑人生了。

档位

Lite / Pro / Max 三档，托盘菜单里切。因为分母换了，百分比立刻跟着变。很多人默认自己是 Lite，其实早就升到 Pro 了，百分比一直虚高。切一下，误会就没了。

积分和 Token，随时对切

贴纸设置里有个「用量单位」。切到 Token，两张卡的大数字变成窗口 token 总量，下面拆成输入 / 缓存 / 输出三行。

积分模式看的是「还剩多少」，Token 模式看的是「跑了多少」。两种问题，两个视角。

明细页能真的查到东西

会话明细不是给你看趋势的，是给你查详情的。搜索标题或目录、按 Agent / 模型 / Provider / 项目筛、框定日期、只看含错误的、按成本或 Token 排序——十列数据一次排开。

典型的用法：发现这个月贵了，按项目排序，一眼看到是哪个仓库在烧钱。

价格能自己改

成本分布页底部有单价编辑器。你的实际价格和目录价不一致，直接改，全页即时重算，存在浏览器本地。

口径写在明面上：这是按官方目录价估算的，不是你的现金账单。Coding Plan 是按积分配额扣的，两者不等价。GAUGE 从头到尾没打算装作它是账单。（你也可以自己改这些很简单尤其是API朋友）

桌面上的几种姿势

• 钉桌面：贴纸嵌进壁纸层，图标之上、窗口之下。纯装饰，不挡事。

• 鼠标穿透：点击直接穿过去，挂机展示专用。

• 透明度三档：60 / 75 / 90。

这三个开关在托盘「贴纸设置」或贴纸自己的 ⚙ 面板里，改了立刻生效。

该提醒的时候才提醒

刷新成功，一声不吭，只是悄悄更新数字。失败了才弹气泡，把错误输出最后 200 字展示给你看。托盘悬停提示永远是一行「今日请求 N · 估算 ¥X」。

日志在 app.log，轮转写，单文件到 1MB 就换。双击没反应的时候，看日志，别猜。

---

谁在用，怎么用

天天挂着的人

装完勾选开机自启，就再也不用管它了。贴纸自动刷新，五小时窗口快满的时候，你能提前一小时知道。不用等到官方弹一句"额度不足"才发现今天已经用不了了。

月底要交账的人

打开主面板成本分布页，按项目看 Top10，按 Agent 看分布，按模型看构成。这周为什么比上周贵一倍？七日堆叠图里，可能就藏着一个跑飞的子代理。

在调 Agent 的人

趋势页有 TTFT 的 p50 / p95，有每日成功率，有错误类型分布，有请求时长分布。改了 system prompt 或者换了模型之后，曲线会不会变——图上见，不靠体感。

多人共用一台机器的人

会话明细按 Agent 分开列。主会话、Luna Worker、独立 Reviewer、通用子代理、Explore 只读探查，各自花了多少，一栏一栏摆着。

只想看一眼的人

双击托盘，气泡弹出「今日请求 1,520 · 估算 ¥393.39」。够了。关掉，干活。

---

关于数据，你需要知道的

它不碰你的对话内容。

这是设计上的硬边界，不是顺手写的一句免责声明。GAUGE 只读三张表的统计字段——会话表拿标题、目录、时间；usage 表拿 token、耗时、状态；工具表拿调用次数。message 和 part 这两张存正文的表，从头到尾没有出现在任何一条 SQL 里。

它不写你的库。

连接是 mode=ro 加 query_only，双重只读。刷新脚本从头到尾只用 Python 标准库，不会因为装了个第三方包就在你机器上留一堆东西。

它不联外网。

页面、图标、字体、贴纸，全部本地。你可以断着网用。唯一的出站动作是你自己点「官方用量页」的时候，它帮你打开浏览器。

顺路说句Zcode，更新就有可能改一次大模型的命名规则，这个很难受，更新了就要检查一次。