GoGauge — OpenCode Go 用量仪表盘

本地优先的 OpenCode Go 用量统计面板：配额窗口、Token 构成、模型排行、使用记录，打开即见。

🌐 English

---

📸 截图

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

用量统计	使用记录

设置	登录	关于

---

✨ 功能

• 配额窗口实时监控：滚动 5 小时 / 每周 / 每月，进度条 + 剩余比例 + 重置倒计时
• 用量概览：缓存命中率 / 命中量 / 总 TOKEN（含缓存命中）/ 请求数 / 费用 / 会话数
• 今日趋势：24 小时输入 / 输出柱状图
• 用量统计：Token 构成（输入 / 输出 / 推理 / 缓存读 / 缓存写 / 会话）、模型用量环形图 + 排行、费用/请求/总 TOKEN 三线趋势
• 会话历史：按会话聚合请求数 / 输入 / 输出 / 推理 / 总 Token / 成本，分页浏览
• 使用记录：请求级明细分页浏览，支持模型筛选
• 内置 WebView 登录：独立登录窗口打开 opencode.ai 控制台登录页，自动回填会话凭证与工作区，无需手动复制
• 自动同步：增量同步（1/5/15/30 分钟可选）+ 同步范围设置（30/60/90/180 天 / 所有）
• 双主题：亮色 / 深色一键切换；中英双语界面
• 本地优先：所有数据保存在本机 SQLite，登录凭据仅用于同步官方接口

🖥 快速开始

直接使用（Windows）

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

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

需要 Windows 10/11（自带 WebView2 Runtime）。关闭窗口即退出应用。

⚠️ 从 v2.1.0 及更早版本升级：opencode.ai 已改用新的控制台接口，登录态随之失效。旧凭证会被自动清除，应用会回到欢迎页，重新登录一次即可（本地历史数据保留）。

源码运行

pip install -r requirements.txt
python entry.py

打包

build.bat

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

📊 数据说明

• 数据来源：opencode.ai 控制台接口（/console/api）—— go/status 配额 + request-logs 请求明细 + service-accounts Key 名称
• 总 TOKEN = 输入（含缓存命中）+ 输出 + 推理
• 缓存命中率 = 命中 /（命中 + 未命中）
• 费用：USD 原始值，人民币按 open.er-api.com 实时汇率换算（24h 缓存）
• 明细范围：官方接口仅保留最近 30 天请求明细（配额窗口不受影响）

🔒 隐私

• 登录 cookie 仅保存在本机，绝不写入日志、绝不上传
• 用量数据全部本地存储，应用不含任何遥测

🛠 技术栈

Python · pywebview (WebView2) · SQLite · Chart.js · pystray

📬 联系

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

📄 License

MIT © GoGauge