55 lines
2.5 KiB
Markdown
55 lines
2.5 KiB
Markdown
# ⚡ 模型评测网站（model-eval-site）
|
||
|
||
聚合展示各种大模型的**运行速度评测**（解码 / 预填充 / 首字延迟），并支持从
|
||
[llm-speed-tester](../llm-speed-tester/) 一键把测试结果发送到**对应账号**下展示。
|
||
|
||
- 端口：**16066**
|
||
- 技术栈：Flask + SQLite + data-chart-tool(16016) 图表
|
||
|
||
## 页面
|
||
|
||
| 页面 | 说明 |
|
||
|------|------|
|
||
| `/`（index.html） | 🏆 模型速度排行：按模型+提供商聚合所有提交，表头可排序 + 解码速度 TOP20 对比图 |
|
||
| `/model.html` | 单模型详情：按上下文长度的速度折线图 + 各账号提交明细 |
|
||
| `/submissions.html` | 📥 提交管理：分页/搜索/详情弹窗/删除 + 「🎲 生成演示数据」 |
|
||
| `/accounts.html` | 👥 账号管理：账号列表（含提交数）/ 新增 / 编辑 / 删除 |
|
||
|
||
## 与 llm-speed-tester 联动
|
||
|
||
1. 在 llm-speed-tester 左侧「📤 评测站同步」填评测站地址（默认 `http://127.0.0.1:16066`）和账号名
|
||
2. 测试完成后，在测试历史行点「📤 发送」，或在详情弹窗点「📤 发送到评测站」
|
||
3. 结果以 **POST /api/submit** 提交，账号不存在自动创建，提交后排行榜实时更新
|
||
|
||
## API
|
||
|
||
| 方法 | 路径 | 说明 |
|
||
|------|------|------|
|
||
| POST | `/api/submit` | 接收 llm-speed-tester 提交（头 `X-Token: meval16066`） |
|
||
| GET | `/api/health` | 健康检查 + 统计 |
|
||
| GET | `/api/stats` | 统计卡片（模型数/提交数/账号数/采样数） |
|
||
| GET | `/api/leaderboard` | 模型速度排行（可 `sort`/`order`/`limit`） |
|
||
| GET | `/api/model` | 单模型详情（`provider` + `model` 参数） |
|
||
| GET | `/api/submissions` | 提交列表（`page`/`page_size`/`q`/`account_id`/`model`/`provider`） |
|
||
| GET | `/api/submissions/<id>` | 单条提交详情 |
|
||
| DELETE | `/api/submissions/<id>` | 删除提交 |
|
||
| GET | `/api/submissions/<id>/chart` | 单条提交：上下文长度→速度折线图 PNG |
|
||
| GET/POST | `/api/accounts` | 账号列表 / 新增 |
|
||
| PUT/DELETE | `/api/accounts/<id>` | 改账号 / 删账号（连带删其提交） |
|
||
| POST | `/api/seed-demo` | 🎲 生成演示评测数据（便于看排行效果） |
|
||
| POST | `/api/chart` | 图表代理（转发 data-chart-tool 16016） |
|
||
|
||
## 数据
|
||
|
||
- `data/model_eval.db`：SQLite（accounts / submissions）
|
||
- 详细字段见 `database.py`
|
||
|
||
## 部署
|
||
|
||
```bash
|
||
./start.sh # 启动（默认 16066，PID 文件管理）
|
||
./start.sh stop # 停止
|
||
# 依赖: openclaw conda 环境 flask/requests；图表走 data-chart-tool(16016)
|
||
# Git: hz4th_coder/model-eval-site
|
||
```
|