GoGauge：OpenCode Go 用量统计面板，把 Token 花销看得明明白白

项目地址：yphyphyph/opencode-go-gauge（MIT License）
技术栈：Python · pywebview (WebView2) · SQLite · Chart.js · pystray

用 AI 编程助手最怕什么？不知道 Token 烧了多少、配额什么时候重置、钱花在了哪。

GoGauge 就是为 OpenCode Go 用户打造的一款本地优先的用量统计面板——配额窗口、Token 构成、模型排行、使用记录，打开即见。单文件 exe，无需安装，双击就能用。

一、先看效果

主页（亮色）	主页（暗色）

用量统计	使用记录

设置	登录	关于

二、功能亮点

配额窗口实时监控

面板对滚动 5 小时 / 每周 / 每月三种配额窗口做了实时监控，进度条、剩余比例、重置倒计时一目了然。额度还剩多少、什么时候刷新，不用再去官方页面反复确认。

用量概览

打开首页就能看到一组核心指标：缓存命中率与命中量、总 TOKEN（含缓存命中）、请求数、费用、会话数。配合 24 小时输入/输出柱状图，一天里什么时候用量最猛也清清楚楚。

用量统计

这一页信息量最大：

• Token 构成：输入 / 输出 / 推理 / 缓存读 / 缓存写 / 会话
• 模型用量环形图 + 排行：哪个模型最烧钱一眼便知
• 费用 / 请求 / 总 TOKEN 三线趋势：观察整体走势

使用记录

历史记录按 10 条/页分页浏览，支持按模型筛选。想查某次对话花了多少钱、某个模型用了多少，翻记录就行。

内置 WebView 登录

登录窗口直接内嵌在应用里，打开官方授权页完成授权后，自动回填 cookie 与工作区，不需要手动复制粘贴任何东西。这是很多同类工具做不到的顺滑体验。

自动同步

支持增量同步，间隔可选 1 / 5 / 15 / 30 分钟；同步范围可选 30 / 60 / 90 / 180 天或全部。按自己的使用频率挑一个就行。

体验细节

• 双主题：亮色 / 深色一键切换，界面中英双语
• 系统托盘：关闭窗口最小化到托盘，图标用的是品牌 Logo
• 本地优先：所有数据保存在本机 SQLite，登录凭据只用于同步官方接口，不上传、不遥测

三、快速开始

方式一：直接使用（Windows，推荐）

从 Releases 下载 GoGauge.exe（单文件，无需安装）：

1. 双击运行，欢迎页点击「立即登录」弹出官方授权窗口
2. 完成登录后自动进入面板并同步用量数据
3. 数据保存在 exe 同目录的 data\ 文件夹

需要 Windows 10/11（自带 WebView2 Runtime）。关闭窗口会最小化到系统托盘。

方式二：源码运行

pip install -r requirements.txt
python entry.py

打包

build.bat

输出 dist\GoGauge.exe（约 38 MB，--noconsole 无黑窗，含 logo 图标与托盘支持）。

四、数据说明

• 数据来源：opencode.ai 工作区用量接口（/_server server-fn）+ 配额页 HTML 解析
• 总 TOKEN = 输入（含缓存命中）+ 输出 + 推理
• 缓存命中率 = 命中 /（命中 + 未命中）
• 费用：USD 原始值，人民币按 open.er-api.com 实时汇率换算（24h 缓存）

五、隐私说明

登录 cookie 仅保存在本机，绝不写入日志、绝不上传；用量数据全部本地存储，应用不含任何遥测。对在意数据隐私的用户来说，这一点可以放心。

联系

• GitHub：yphyphyph/opencode-go-gauge
• CSDN：Ying_ph

如果你也在用 OpenCode Go 且在意用量和费用，GoGauge 是目前最省心的本地统计方案——打开即见、隐私友好、托盘常驻，值得一试。