New API Monitor

只读方式接入 new-api 数据库的模型用量与可用性监控面板。 实时展示 Token 消耗、花费、Top 模型、模型可用性点阵热力图，便于观察在不同时间段各模型的请求量与成功率。

本项目仅 SELECT 读取 logs 表，不做任何写入，可安全挂接生产库。

• 实时概览：Token（输入 / 输出 / 缓存）、请求量、花费、成功率，WebSocket 推送
• N 天趋势：可选 7 / 14 / 30 天请求量与 Token 走势
• Top 模型排行：按 Quota 消耗排序的前 5 模型
• 模型可用性点阵：
  • 24H / 7D 切换（7D 按 8 小时聚合为 21 格）
  • 每格以绿点 / 红点呈现请求量与成功 / 失败比
  • 基于 FLOOR(created_at/3600) UTC 整点桶，跨日与时区无错位
  • 同时统计 type=2（成功消费）与 type=5（错误请求）
• Token 分析页：按模型、按 Token 类型的用量细分

newapi-data/
├── server/                 后端（Express + TS）
│   └── src/
│       ├── routes/         REST 路由：overview / tokens / heatmap
│       ├── services/       SQL 查询服务（只读）
│       ├── cache.ts        Redis withCache 封装
│       ├── websocket.ts    实时指标推送
│       ├── db.ts           MySQL 连接池
│       └── index.ts        入口
├── web/                    前端（React + Vite）
│   └── src/
│       ├── pages/          Dashboard / Heatmap / TokenUsage
│       ├── components/     ModelHeatmap / TopModelsChart / TrendChart …
│       ├── hooks/          useWebSocket
│       └── api/            HTTP 客户端
├── Dockerfile              三段式构建（前端 → 后端 → 运行时）
├── docker-compose.yml      app + redis
├── env.config.json.example 本地开发配置样例
├── .env.example            docker-compose 环境变量样例
└── package.json            根工作区（concurrently 启动 dev）

• Node.js ≥ 20
• 可访问的 new-api MySQL（只需 SELECT 权限）
• Redis 6+

# 1) 安装全部依赖（root / server / web）
npm run install:all

# 2) 复制配置
cp env.config.json.example env.config.json
# 编辑 env.config.json，填入真实 SQL_DSN 与 REDIS_CONN_STRING

# 3) 启动（同时起前后端）
npm run dev

• 前端：http://localhost:5173
• 后端：http://localhost:3002

Windows 用户可直接双击 install.bat → start.bat。

cp .env.example .env
# 编辑 .env，至少填写 SQL_DSN
docker-compose up -d --build

默认映射到 http://<host>:16302。健康检查：/api/health。

优先级：环境变量 > env.config.json（server/src/config.ts）。

⚠️ 不要把真实数据库凭据提交到仓库。.env 与 env.config.json 已在 .gitignore 中。

所有查询走 Redis withCache 短 TTL 缓存（热力图 15s，其余 300s）。

• 时区无关的小时桶：FLOOR(created_at / 3600) 生成 UTC epoch 桶，前端按 (currentBucket - cellBucket) 定位 slot，彻底规避 FROM_UNIXTIME + CONVERT_TZ 双重转换导致的 8 小时偏移。
• 成功 / 失败口径：WHERE type IN (2, 5)，success = SUM(type=2)，fail = total - success。
• 点阵密度：dots = round(sqrt(total / globalMax) * 16)，sqrt 缩放压制长尾。失败率 > 0 时强制保留至少 1 红点。

• 只读数据库：服务层禁止出现 INSERT / UPDATE / DELETE / DDL。
• 任何 SQL 改动前，先在只读账号下用 EXPLAIN 评估索引命中。