token-list-share/AGENTS.md

token-list-share

Sub2API 用量排行榜前端（Vue 3 + Vite + ECharts，多页：index / list / groups）。

跑起来

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。
• 页面名分保持中立（「用量排行」「用量榜」），不加评价性徽章/高亮等引导元素。
• 面向用户的品牌名是「行业应用」（页眉 eyebrow）；代码注释里指代后端系统仍可写 Sub2API，不要全局替换。
• 线上整站有 nginx HTTP Basic Auth（含 /api/、/data/、/bailian-admin/），账号密码只在服务器 htpasswd（apr1），不进 git；对线上做 curl/探测要么预期 401，要么带 -u。开关与换人用 deploy.sh auth，不要手改 nginx 配置里的 auth_basic。
• 颜色走 src/style.css 的 CSS 变量：成本 --accent 橙、Token --token 钢蓝、金 --gold；图表内因 ECharts 读不到 CSS 变量而硬编码同值，改色时两处同步。
• 百炼 Token Plan 额度：数据来自服务器探针写出的静态快照 /data/bailian.json（契约见 types.ts 的 BailianSnapshot，schema: 1，含只读的 reset_cards 重置卡列表）。Cookie/Key 只留在服务器 /etc/bailian-probe.env，绝不进前端产物、快照文件或 git；探针（bailian-probe.py）只调 reset-card/list 等只读接口，绝不接 reset-card/use。用卡写操作只有 deploy/reset-card-server.py（本机 127.0.0.1:18082，nginx /bailian-admin/）在 Admin Key + 卡归属校验后才允许代发；分组页入口默认 CSS 隐藏，需 localStorage.bailian-reset-card='1' 开启。Sub2API 的智谱额度通道（账号 extra.zhipu_*）复用不到百炼：平台是 openai/anthropic、account_mode 为空、域名不在识别表内，别指望接进 cn_provider_quota_service。

结构

• src/App.vue 排行主页；src/groups/GroupsApp.vue 分组页（分组配 src/groups.config.ts，含百炼额度卡）。
• src/api.ts 数据层（Sub2API 接口 + 百炼快照读取，快照失败返回 null 不阻断页面）；src/format.ts 格式化与时区（Asia/Shanghai）。
• deploy/bailian-probe.py 百炼额度探针（Python 3 标准库，cookie 主路 / apikey 验证路）；部署见 deploy/DEPLOY.md 第 5 节。
• 生产部署为同域反代，见 deploy/DEPLOY.md；现行环境（10.1.192.225:18081 → /usr/dcits/token-list-share）的发布/换 Cookie 用根目录 deploy.sh（web / cookie / probe / nginx / auth / status / all）。