# Deepseek-Token-Usage

**Repository Path**: azhengzz/deepseek-token-usage

## Basic Information

- **Project Name**: Deepseek-Token-Usage
- **Description**: DeepSeek API 用量分析工具。上传账单 zip 文件，自动解析并可视化 Token 用量、费用趋势与缓存命中率，支持按日期、模型、API Key 筛选。纯前端实现，无需部署，浏览器直接打开即用。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-03
- **Last Updated**: 2026-06-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DeepSeek API 用量分析

上传账单 zip 文件，可视化分析 Token 用量、费用趋势与缓存命中率。

## 使用方法

1. 下载 [index.html](index.html) 到本地
2. 用浏览器直接打开
3. 上传从 DeepSeek 开放平台导出的用量数据 zip 文件

> zip 文件应包含 `cost-*.csv` 和 `amount-*.csv` 格式的账单数据。

## 功能

- **每日费用趋势** — 按模型分组的折线图
- **Token 用量趋势** — 缓存命中/未命中/输出的堆叠面积图
- **请求次数趋势** — 按模型堆叠的柱状图
- **API Key 用量对比** — 各 Key 的 Token 消耗横向柱状图
- **缓存命中率** — 环形图展示命中/未命中占比

## 筛选

支持按日期范围、模型（多选）、API Key 三个维度筛选，所有图表实时联动更新。

## 技术实现

纯前端实现，无需部署和后端服务。使用 [ECharts](https://echarts.apache.org/) 渲染图表，[JSZip](https://stuk.github.io/jszip/) 解析 zip 文件，所有依赖通过 CDN 加载。

## 示例
![alt text](./docs/images/upload-page.png)

![alt text](./docs/images/token-usage-panel.png)