Skip to content

Repository files navigation

LLM-BillStatistics

大模型 API 用量统计工具。

将从模型供应商导出的用量统计文件拖拽上传至本应用,即可按供应商、模型、日期展示详细的用量统计数据,包括金额、各类 Token 用量及缓存命中率。完全在浏览器本地运行,无需联网。

功能特性

  • 自动识别供应商:根据 CSV 表头自动匹配解析器,无需手动选择
  • 多文件合并:支持同时上传多个 CSV 文件,数据自动合并
  • 图表可视化:基于 Chart.js 渲染每日用量柱状图,双 Y 轴分别展示金额和 Token 数,支持保存为图片
  • 数据表格:按日期逐条列出用量明细,支持导出为 CSV
  • 供应商切换:侧边栏切换不同供应商查看对应数据

支持的供应商

供应商 CSV 来源
小米(MiMo) 用量统计导出
DeepSeek 账单 CSV 导出
智谱(Zhipu) 账单 CSV 导出
OpenCode tools/opencode_export.sh(Windows 用 tools/opencode_export.ps1)导出(见下文)

OpenCode 账单获取

OpenCode 不提供账单文件下载,需用本仓库自带的命令行工具从 opencode.ai 抓取并导出为 CSV。脚本会自动检测环境中的 uv 或 Python 3,在 tools/src/python/.venv 中创建虚拟环境并安装依赖后运行。

# ① 一次性配置(运行后按提示输入 workspace_id 与 auth cookie:在浏览器登录
#    opencode.ai 后,网址输入栏将会变成 `https://opencode.ai/workspace/wrk_01K**`,
#    `wrk_01K**` 就是 workspace_id。auth cookie 通过 F12 → Application → Cookies 获取,
#    auth cookie 以 Fe26.2** 开头,有效期约 1 年。凭据保存在系统凭据管理器中,磁盘上不落明文)
./tools/opencode_export.sh save

# ② 导出指定月份账单(缺省 --month 为当月,缺省 --out 输出到终端)
./tools/opencode_export.sh export --month 2026-08 --out opencode-2026-08.csv

# ③ 将导出的 CSV 拖拽上传到本应用即可

# 如需删除本机保存的凭据
./tools/opencode_export.sh clear

也可使用跨平台的 PowerShell 脚本(Windows PowerShell 或 Linux/macOS 的 pwsh),用法相同:

./tools/opencode_export.ps1 save
./tools/opencode_export.ps1 export --month 2026-08 --out opencode-2026-08.csv
./tools/opencode_export.ps1 clear

⚠️ 凭据安全:OpenCode 的 auth cookie 一旦泄露无法吊销——实测登出并重新登录后旧 cookie 仍然有效,只能等其自然过期(约 1 年)。请谨慎保管:不要把凭据提交到仓库、写入脚本或通过聊天/截图分享;如怀疑泄露,应尽快轮换 opencode 后台的 API key,并等待旧 cookie 过期。

使用说明

将发行版解压缩后,用浏览器打开 index.html 即可使用。

注意:index.html 并不能单独使用,需要确保它与随压缩包一同发布的文件在同一文件夹内。

自行构建

需要 JDK 11+ 和 Gradle(项目自带 Gradle Wrapper)。

# 构建生产版本
./gradlew jsBrowserDistribution

构建完成后,用浏览器打开 build/dist/js/productionExecutable/index.html 即可使用。

开发模式

# 启动开发服务器(默认 http://localhost:8080)
./gradlew jsBrowserDevelopmentRun

修改代码后会自动热重载。

运行测试

./gradlew jsTest

使用说明

  1. 从供应商平台导出用量统计 CSV 文件
  2. 打开应用,将 CSV 文件拖拽到上传区域(或点击选择文件)
  3. 应用自动识别供应商并解析数据
  4. 通过左侧侧边栏切换不同供应商查看统计数据
  5. 上方柱状图展示每日金额和 Token 用量趋势
  6. 下方表格展示逐日明细,可点击「导出 CSV」保存统计结果

技术栈

  • 语言:Kotlin/JS(IR 编译器)
  • 构建:Gradle 8.14.4,Kotlin 2.1.20
  • 图表:Chart.js 4.4.7(通过 npm 依赖集成)
  • UI:纯 DOM 操作,无前端框架
  • 运行环境:浏览器(完全离线,无需网络)

许可证

该应用程序采用 MIT License

其他第三方库保留各自的原始许可,详见发布包中的 LLM-BillStatistics.js.LICENSE.txt

About

完全在本地浏览器运行,无需联网的大模型 API 用量账单统计工具。

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages