从小熊那拷贝一份

README.md

@@ -0,0 +1,27 @@
+# Token 排行榜
+
+Sub2API 用户用量排行，支持日 / 周 / 月和自定义日期区间。主表只列出本区间有请求的用户（排除系统账号 admin），点开一行看该用户每个模型的请求、Token 拆分和占比。右上角「可用模型」弹窗只展示分组账号实际挂载的模型，状态来自账号可用状态。
+
+## 开发
+
+```bash
+cp .env.example .env
+# 填入 ADMIN_API_KEY
+pnpm install
+pnpm dev
+```
+
+开发时 Vite 把 `/api` 代理到 Sub2API，并用 `.env` 里的 `ADMIN_API_KEY` 注入 `x-api-key`，浏览器里不会带上这把 key。
+
+打开 [http://127.0.0.1:5176](http://127.0.0.1:5176)。
+
+## 同域部署
+
+构建：
+
+```bash
+pnpm build
+```
+
+推荐独立域名部署（例如 `token.example.com`），Sub2API 现有 nginx 不用改。把 `dist/` 内容放到新站点网站目录，并反代 `/api/` 到本机 `127.0.0.1:8080`。详见 `deploy/DEPLOY.md`。
+