VibeGauge：把 AI 编程额度、Token 用量和 MCP 清理放进 Mac 菜单栏

Vibe Coding 进入日常之后，最容易失控的往往不是模型本身，而是它留下的状态：Claude、Codex、Gemini、Grok 各有自己的额度窗口，Token 消耗散落在 CLI 日志里，终端关掉后还可能有 MCP 进程继续占内存。VibeGauge 把这些信息收进一个原生 Mac 菜单栏面板，目标是让你在下一次请求前知道机器和额度到底处于什么状态。

本文按 v1.1.2 发布版 的 README、源码结构和 Release 资产整理，未在本机安装运行。开发分支的新变化不能自动视为当前下载包的功能；文章也会把“本地解析”和确实会联网的功能分开说明。

先看额度，再决定今天怎么用

Subscriptions 面板可以汇总 Claude、Codex、Gemini / Antigravity 和 Grok 的订阅状态、已用额度与重置时间。不同供应商的数据入口不同：有的来自本地会话日志，有的来自 CLI 传给状态栏的官方额度，有的来自缓存文件。查不到时显示无数据，比用一个估算数字伪装成实时额度更可靠。

周额度预测不是把今天的速度简单乘七。VibeGauge 会参考最近七天真实使用发生在什么时间、上个周期用了多少，以及五小时窗口的近期节奏；因此你晚上集中工作，不会被机械地外推成整夜都在消耗。预测仍然是预测，不是厂商承诺的剩余额度。

Token、缓存和价格表都留在你的解释范围内

Statistics 面板可以累计上下文 Token、输出 Token、thinking / reasoning Token、请求轮数和 Prompt Cache 命中率，并保留最近交互的检查视图。历史记录写入 ~/.config/vibegauge/usage-daily.json，统计引擎会增量扫描本地日志；对于同一调用既出现在 CLI 日志又经过代理的情况，v1.1.2 修正了重复计费。

成本并不是凭空猜出来的。VibeGauge 只使用你自己提供的 ~/.config/vibegauge/prices.json，没有内置容易过期的生产价格；没有价格的模型不会被强行折算。要把“Token 数”理解成“实际账单”，仍需结合供应商账单和你填写的价格表。

MCP 清理器需要边界，而不是一个大扫除按钮

Orphaned MCP Reaper 会寻找父进程已经失效、没有监听端口、不是系统白名单进程、并且符合 MCP 特征的无头 node / python 进程，再允许清理。它还可以清理 ~/.npm/_npx 缓存，并支持每 30 分钟的静默扫描。这个功能会终止进程，所以应先检查列表再操作，别把它当作无条件安全的垃圾回收器。

v1.1.2 特别修正了一类容易误伤的情况：你用 npx 启动、关掉终端后仍在运行的普通后台工具，不再仅因为进程孤儿化就被当作 MCP；官方 MCP 服务器特征会被单独识别。发送信号前还会重新检查端口和自动清理开关，并按实际退出数报告结果。

Network Tab 是体检，不是万能证明

Network 面板可以探测 Anthropic、ChatGPT、OpenAI API 和 Grok 等域名的 /cdn-cgi/trace，查看出口 IP、IPv6 可达性和可能的 DNS 泄漏；Gemini 的路线则依赖本地 Clash 连接表。它还可以读取本机回环地址上的 Clash / mihomo / sing-box 控制接口，但不会修改网络配置。

这些结果是指标，不是“所有请求都绝对走同一条线路”的证明。探测失败会显示未知或不可用，而不是冒充一个绿色结论。对网络敏感的用户，这种诚实的边界比一个看起来很确定的分数更有价值。

本地优先，但不是“完全不联网”

用量分析不上传 Prompt 或使用日志，Token、历史统计和本地缓存留在 Mac 上。连接 Claude Code 或 agy 的额度时，VibeGauge 安装一个可撤销的状态栏桥接脚本，先备份原设置，再把同一份状态栏输入交给原命令；它不读取凭据，也不替你登录。

仍然有几类明确的网络行为：每天向公开 GitHub API 检查更新；Network Tab 发出前面提到的体检请求；可选 API 代理为了查询余额会把你通过它使用的 API Key 保存在内存中并访问对应供应商的余额接口；可选 Codex 远程同步需要你配置免密 SSH。因此安装前应按自己的威胁模型开启功能。

安装：下载官方 Universal ZIP

截至核查时，没有找到 VibeGauge 的官方 Mac App Store 条目。普通用户直接下载 VibeGauge v1.1.2 ZIP，也可以先查看 Release 页面。这是 Apple 芯片和 Intel 通用包，要求 macOS 14 或更高版本。解压后把 VibeGauge.app 拖到 /Applications，启动后图标会出现在菜单栏。

首次打开如果遇到 macOS Gatekeeper 提示，按项目说明前往“系统设置 → 隐私与安全性 → 仍要打开”确认。若使用 Bartender 或 Ice 等菜单栏整理工具，还要检查 VibeGauge 是否被收进隐藏区域。

如果要检查下载文件是否与官方发布摘要一致，可同时下载 VibeGauge.zip.sha256，在两个文件所在目录运行：

shasum -a 256 -c VibeGauge.zip.sha256

有 Release，就不必先自己编译

v1.1.2 已提供可用的预编译包，所以源码构建适合开发者、需要改代码或想运行自测的人，而不是普通用户的第一安装路径。源码采用 Swift / SwiftUI / AppKit，仓库说明没有第三方 Swift 依赖，只需系统的 Swift 命令行工具即可构建。

git clone https://github.com/MaxHaiCom/vibe-gauge.git
cd vibe-gauge
./build.sh
open VibeGauge.app

构建后的命令行程序支持 --selftest，可以在不启动界面的情况下检查解析逻辑；--install-proxy 和 --uninstall-proxy 用于管理可选的本地 API 记账代理。第一次使用时，建议先打开面板的 System / Settings，确认日志目录、代理和权限都符合自己的预期。

适合谁

如果你同时使用多个 AI 编程 CLI，想在菜单栏快速查看额度窗口、Token 量、缓存命中率和机器网络状态，VibeGauge 的信息密度很合适。它也适合经常启动 MCP、需要观察本机资源的人。它不是任何一家模型供应商的官方账单页，不能替你绕过额度限制，也不能保证第三方日志格式永久不变。

许可证

VibeGauge 采用 MIT License。你可以查看、修改和重新分发源码，但应保留许可证和版权声明；受控的 CLI、模型供应商、账号和网络服务仍有各自的条款。当前版本的变更可查看 v1.1.2 changelog。

open https://github.com/MaxHaiCom/vibe-gauge/releases/download/v1.1.2/VibeGauge.zip

演示