排行榜升级为成本优先视角,并接入模型参考单价
- 主表默认按参考成本降序,成本、成本占比列紧跟用户列;表头支持双向排序(再点切换升/降) - 顶部统计卡新增参考成本与每百万 Token 均价,顺序调整为成本、Token、输入输出、请求、人数 - 走势图与用户明细图 tooltip 展示成本;总走势改为成本 + Token 双 Y 轴曲线 - 模型明细与「可用模型」弹窗新增单价列:优先分组配置价,缺价模型懒加载 Sub2API 内置计费目录,参考价统一带 ~ 前缀,表头全列可排序(默认单价降序) - 分组页模型列表默认按当日成本降序并增加成本列 - 取消 admin 排除逻辑,admin 有用量即入榜;移除未使用的 TARGET_GROUP_NAMES - 页面文案统一为用量排行 / 用量榜与 Token(去表头大写);配色收敛:成本橙、Token 钢蓝走 CSS 变量 - 新增 AGENTS.md 沉淀项目约定,README 同步功能现状
This commit is contained in:
28
AGENTS.md
Normal file
28
AGENTS.md
Normal file
@@ -0,0 +1,28 @@
|
||||
# token-list-share
|
||||
|
||||
Sub2API 用量排行榜前端(Vue 3 + Vite + ECharts,多页:index / list / groups)。
|
||||
|
||||
## 跑起来
|
||||
|
||||
```bash
|
||||
pnpm install && pnpm dev # http://127.0.0.1:5176,Vite 代理 /api 并注入 ADMIN_API_KEY
|
||||
pnpm build # vue-tsc 类型检查 + vite build,产出 dist/
|
||||
```
|
||||
|
||||
配置走 `.env`(已 gitignore,模板见 `.env.example`)。
|
||||
|
||||
## 必须守住的约定
|
||||
|
||||
- 排行**不排除 admin**,只过滤 `requests <= 0` 的账号(2026-09 决策,别再加回去)。
|
||||
- 成本字段用 `actual_cost`(参考成本口径,UI 文案叫「参考成本」,不叫「实际成本」)。
|
||||
- 模型「单价」是**参考价,一律带 `~` 前缀**:优先分组配置的 `model_pricing`,缺价模型懒加载 Sub2API 内置目录 `/admin/channels/model-pricing?model=`。
|
||||
- 单价逻辑只挂在模型上,**不要按人摊均**。
|
||||
- 界面文案统一 `Token`(首字母大写),表头样式禁用 `text-transform: uppercase`。
|
||||
- 页面名分保持中立(「用量排行」「用量榜」),不加评价性徽章/高亮等引导元素。
|
||||
- 颜色走 `src/style.css` 的 CSS 变量:成本 `--accent` 橙、Token `--token` 钢蓝、金 `--gold`;图表内因 ECharts 读不到 CSS 变量而硬编码同值,改色时两处同步。
|
||||
|
||||
## 结构
|
||||
|
||||
- `src/App.vue` 排行主页;`src/groups/GroupsApp.vue` 分组页(分组配 `src/groups.config.ts`)。
|
||||
- `src/api.ts` 所有 Sub2API 接口封装;`src/format.ts` 格式化与时区(Asia/Shanghai)。
|
||||
- 生产部署为同域反代,见 `deploy/DEPLOY.md`。
|
||||
Reference in New Issue
Block a user