Skip to content
BranchesTags

Latest commit

 

History

9 Commits

Folders and files

NameName
Last commit message
Last commit date
.zcode/plans
.zcode/plans
 
 
desktop
desktop
 
 
server
server
 
 
web
web
 
 
.gitattributes
.gitattributes
 
 
.gitignore
.gitignore
 
 
README.md
README.md
 
 

Repository files navigation

TokenView · 多渠道 LLM Token 消耗仪表盘

聚合统计 14 个 AI 编程工具的真实 Token 用量（ZCode、Claude Code、Codex、WorkBuddy、LobsterAI 等），从核心指标、时间趋势、渠道占比、模型排行、工具维度、调用明细六个角度可视化呈现。

零数据库依赖：后端直接读取各工具的本地用量数据（SQLite / JSONL），实时计算统计。 官方市场价计费：费用按各模型官方 API 市场价自动估算。

✨ 功能特性

模块 说明
KPI 指标卡片 累计 Token、今日消耗（含较昨日环比）、累计费用、调用次数、活跃渠道、成功率
消耗趋势图 按日 / 周 / 月切换，支持 Tokens / 费用 / 调用三种指标
渠道占比环形图 各 LLM 供应商消耗占比，tooltip 显示费用与调用数
模型 Top 排行 横向条形图，tooltip 附市场单价
渠道排行榜 金/银/铜牌标识
工具统计面板 14 个工具渠道维度（调用 / Tokens / 费用 / 状态），无本地数据的工具可通过上报接口统计
模型市场价参考 全部模型的官方市场单价（元/百万 tokens）+ 累计费用核对
调用明细分页 渠道 / 来源（13 工具）/ 状态 / 日期范围筛选
上报 API 业务方实时上报 token 消耗，立即生效，tool 字段归入工具维度

🚀 快速开始

方式一：桌面应用安装包（推荐）

desktop/release/TokenView-Setup.exe（约 103 MB）——独立桌面应用，原生窗口运行，不再打开浏览器：

  1. 双击安装（免管理员；与旧版共用安装位置，原地升级保留数据）
  2. 双击桌面「TokenView」快捷方式 → 弹出 TokenView 应用窗口（内嵌服务自动启动）
  3. 关闭窗口即完全退出；控制面板可卸载
  • 数据目录：%LOCALAPPDATA%\TokenView\data\
  • 日志文件：%LOCALAPPDATA%\TokenView\logs\（自动记录）
  • 单实例：重复启动不会开第二个，仅聚焦已开窗口
  • 外部链接自动交给系统浏览器打开

构建：cd desktop && npm install && npm run build（装配 → electron-packager → Inno Setup 一条龙）

方式二：绿色单文件（无窗口服务模式，旧形态保留）

server/dist/TokenView.exe（约 90 MB，自包含 Node 运行时 + 前端 + 后端），目标机器无需安装任何依赖，拷贝即用；启动后自动打开浏览器，适合无窗口后台挂机场景：

TokenView.exe                      # 双击启动（控制台窗口显示日志，关闭即退出）
TokenView.exe --port 8080          # 指定端口（被占用时自动递增 3000→3010）
TokenView.exe --no-browser         # 不自动打开浏览器
TokenView.exe --log                # 启用文件日志（logs/ 目录）
TokenView.exe --data-dir <目录>     # 指定数据目录

数据默认写入 exe 同目录 data/（绿色便携），不可写时回退 %LOCALAPPDATA%\TokenView\data。

方式三：开发模式

# 终端 1：后端（端口 3000）
cd server && npm install && npm run dev
# 终端 2：前端（端口 5173，/api 自动代理到后端）
cd web && npm install && npm run dev
# 桌面端开发（装配后直接弹 Electron 窗口）
cd desktop && npm install && npm run dev

浏览器访问 http://localhost:5173

📊 数据接入：14 个工具渠道

工具 数据位置（只读） 状态
ZCode ~/.zcode/cli/db/db.sqlite（model_usage 表） ✅ 直读
Claude Code ~/.claude/projects/**/*.jsonl ✅ 直读
Codex ~/.codex/sessions/**/rollout-*.jsonl ✅ 直读
WorkBuddy ~/.workbuddy/projects/*/*.jsonl ✅ 直读
LobsterAI AppData\Roaming\LobsterAI\openclaw\state\agents\main\sessions\*.jsonl ✅ 直读
JoyClaw AppData\Roaming\JoyClaw\state\desktop-token-usage-state.json ✅ 直读（结构就绪，暂无数据）
CodeBuddy CN VS Code secret storage（v10t 加密） ⚠️ 可解密但缓存仅含时间戳，无 token 明细
Qoder VS Code secret storage（v10t 加密） ⚠️ 可解密但缓存仅含额度配额，无 token 明细
Kimi / OpenSquilla 未安装 / 无本地数据 🔧 上报接口统计
Trae / Trae CN / TRAE SOLO CN 会话在服务端，本地无数据 🔧 上报接口统计
扣子（Coze） 桌面端为 Web 壳，本地无用量数据 🔧 上报接口统计（tool=扣子）

原理：server/src/data/ 下每个工具一个适配器，getRows(startMs, endMs) 返回统一行结构；统计接口每次请求直查数据源，无同步延迟；全程只读，不修改任何工具数据。

无本地数据的工具如何统计：上报时携带 tool 字段即可归入对应工具维度（完整参数与校验规则见下方 API 参考）：

curl -X POST http://localhost:3000/api/usage/report \
  -H "Content-Type: application/json" \
  -d '{"channel":"DeepSeek","model":"deepseek-chat",
       "prompt_tokens":1234,"completion_tokens":567,
       "tool":"Trae","request_id":"req_001"}'

💰 费用：按官方市场价计算

真实数据只有 token 数、没有价格，费用按 server/src/data/prices.json 中的官方市场价（元 / 1K tokens，2026-08 查询，美元计价按汇率 6.8 换算）估算：

{
  "deepseek-v4-flash": { "input": 0.001, "output": 0.002 },
  "glm-5.2":           { "input": 0.008, "output": 0.028 },
  "gpt-5.6-sol":       { "input": 0.034, "output": 0.204 }
}
费用 = (输入tokens × 输入单价 + 输出tokens × 输出单价) / 1000
  • 未配置单价的模型费用为 0；缓存 tokens 计入总量但不参与计价
  • 仪表盘「模型市场价参考」面板展示全部模型单价与累计费用，支持自定义：点「＋ 新增模型」添加价表中没有的模型，或对已有模型点「编辑」覆盖默认单价（行内带「自定义」标记，可一键「恢复默认」）；自定义价持久化于 <数据目录>/custom-prices.json，立即生效且重启保留
  • 中转渠道实际费率不同时，除面板编辑外也可直接修改 prices.json（默认价表，保存立即生效）

🔌 API 参考

上报接口统计（无本地数据源的工具）

工具渠道分两类：ZCode、Claude Code、Codex 等工具的用量数据落在本地，TokenView 直读文件自动统计；而 Kimi、OpenSquilla、Trae / Trae CN / TRAE SOLO CN、扣子（Coze） 等工具没有本地用量明细（会话在服务端或是 Web 壳），仪表盘无法直接读取 —— 这类工具由业务方在每次 LLM 调用后调用上报接口，把用量推给 TokenView。

上报数据实时生效，与本地直读数据同台呈现：计入渠道占比、模型排行、调用明细，携带 tool 字段时归入工具统计维度（面板中来源标记为 api）。数据落盘于 <数据目录>/reports.jsonl，与直读数据互不影响。

接口定义 POST /api/usage/report

  • Content-Type：application/json
  • 端口：开发模式与绿色单文件默认 3000；桌面应用默认随机端口（避免冲突），实际端口见日志文件 %LOCALAPPDATA%\TokenView\logs\，或启动时用 --port / 环境变量 TOKENVIEW_PORT 固定，便于业务方对接
字段 类型 必填 校验与说明
channel string ✅ LLM 渠道名称（如 deepseek），计入渠道占比；空则 400
model string ✅ 模型名称（如 deepseek-v4-flash）；需与 prices.json 键名一致才会计费，未配置单价的模型费用记 0；空则 400
prompt_tokens number ✅ 输入 tokens；负数按 0 处理
completion_tokens number ✅ 输出 tokens；两者之和必须 > 0，否则 400
tool string 否 工具标识（如 Trae、kimi、扣子），归入工具统计维度；超 32 字符截断
latency_ms number 否 调用延迟毫秒，默认 0，负数按 0 处理
status number 否 1 成功 / 0 失败，默认 1；非 0 值均按成功计
request_id string 否 调用方幂等 ID，未传自动生成；相同 ID 重复上报按成功幂等忽略（网络重试安全），响应中 data.duplicate: true

请求示例：

curl -X POST http://127.0.0.1:3000/api/usage/report \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "deepseek",
    "model": "deepseek-v4-flash",
    "prompt_tokens": 1234,
    "completion_tokens": 567,
    "tool": "Trae",
    "latency_ms": 850,
    "request_id": "req_001"
  }'

成功响应（费用按 prices.json 市场价实时估算）：

{
  "code": 0,
  "message": "上报成功",
  "data": {
    "request_id": "req_001",
    "channel": "deepseek",
    "model": "deepseek-v4-flash",
    "total_tokens": 1801,
    "cost": 0.0024
  }
}

失败响应（HTTP 400）：{"code":400,"message":"channel 与 model 为必填项"}、{"code":400,"message":"token 数量必须大于 0"}

统计接口

方法 路径 说明
GET /api/stats/overview?days=30 KPI 汇总（含今日环比、日均）
GET /api/stats/trend?days=30&granularity=day&channel= 时间趋势（day / week / month）
GET /api/stats/channels?days=7 渠道维度统计（含占比）
GET /api/stats/models?days=7&limit=10 模型 Top 排行（含单价）
GET /api/stats/tools 14 工具统计（调用 / Tokens / 费用 / 状态）
GET /api/stats/prices 模型市场价参考列表（含 custom 自定义标记）
POST /api/stats/prices 新增/修改自定义单价 {model, input, output}（元/1K tokens，覆盖默认价）
POST /api/stats/prices/reset 恢复默认单价 {model}（删除自定义覆盖）
GET /api/stats/usage?page=1&pageSize=20&channel=&source=&status=&start=&end= 调用明细分页
GET /api/channels 渠道列表
GET /api/health 健康检查

🛠️ 构建与打包

cd server && npm install

npm run build:exe     # 绿色单文件 → dist/TokenView.exe（需 Node 24+）
npm run build:setup   # 安装包 → dist/TokenView-Setup.exe（需 Inno Setup 6）

构建流程：前端 npm run build → 资源打包（assets.bin）→ esbuild 后端单文件 → Node SEA 注入 → postject 注入 blob →（安装包）iscc 编译。

📁 项目结构

tokenView/
├── server/                     # 后端（Express，零数据库）
│   ├── src/
│   │   ├── index.js            # 入口（静态托管 / 单实例 / 端口递增 / 日志）
│   │   ├── runtime.js          # SEA 环境适配（资源解包 / 数据目录 / 参数）
│   │   ├── config.js           # 配置加载
│   │   ├── data/               # 数据访问层
│   │   │   ├── zcode.js / claude-code.js / codex.js / workbuddy.js
│   │   │   ├── lobsterai.js / joyclaw.js / codebuddy-cn.js / qoder.js
│   │   │   ├── vscode-secret.js # VS Code secret 解密工具（DPAPI + AES-GCM）
│   │   │   ├── reports.js      # 上报存储（JSONL，幂等）
│   │   │   ├── stats.js        # 多源合并聚合
│   │   │   └── prices.json     # 官方市场价配置
│   │   └── routes/             # stats 统计 / usage 上报
│   ├── scripts/                # build-exe.js / build-setup.js
│   ├── installer/              # tokenview.iss + TokenView-run.vbs
│   └── dist/                   # 构建产物（TokenView.exe / TokenView-Setup.exe）
├── web/                        # 前端（Vue3 + Vite + ECharts）
│   └── src/
│       ├── views/Dashboard.vue
│       ├── components/         # KPI / 趋势 / 占比 / 排行 / 工具统计 / 市场价 / 明细
│       ├── api/ utils/ styles/
└── README.md

❓ 常见问题

Q：工具显示"待上报"？ 该工具本地无用量数据（会话在云端 / 未安装 / 缓存仅含配额），通过上报接口带 tool 字段即可统计；工具统计面板状态会实时变为"有数据"。

Q：费用显示不准？ 费用是按官方市场价的估算值。中转渠道（AkuCb AI 等）实际费率不同时，修改 server/src/data/prices.json 对应模型单价即可。

Q：数据存在哪里？ 安装版：%LOCALAPPDATA%\TokenView\data\reports.jsonl；绿色版：exe 同目录 data/；可用 --data-dir 指定。日志：--log 参数启用后写入 <数据目录上级>/logs/。

Q：端口被占用？ 自动递增探测（3000→3010）；或 --port 显式指定。

Q：重复双击启动了多个实例？ 单实例保护：第二个实例检测到已在运行，仅打开浏览器后退出。

技术栈

层 技术
前端 Vue 3 + Vite + ECharts + Axios
后端 Node.js + Express（依赖仅 express + dotenv）
数据访问 Node 内置 node:sqlite + JSONL 扫描（只读）
单文件打包 Node SEA + esbuild + postject
安装包 Inno Setup 6

About

全方位展示统计token

Resources

Readme
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages