feat(admin): 「我的用量」面板 me.html —— 用户自查询 (1.0.30)

基于 1.0.29 `/api/v1/me` 新增 recent 块,每个用户可以**自助**看自己的
用量,不必 admin 帮忙——也省得同事自己 curl 拼 JSON。

**面板能力**(来自 `/api/v1/me`):
- 6 张概览卡片:用户名 / 24h 调用 / 7d 调用 / 24h token / 上次调用
- 24h 调用分布:bar chart(来自 `recent.hour_24h`,按本地小时分桶)
- 近 7 天按 slot 拆分表格:calls_24h / calls_7d / tin / tout / last_status
- 我能调的 LLM 上游:白名单过滤后的完整 slot + base_url + models
- 我能调的 API 代理:enabled 列表 + 调用方式(`<code>GET /apix/...` 或
  `<code>POST /apixp/...`) + desc 截前 80 字
- 我的域名列表

**鉴权**:
- 用户首次进入 → 输入 sk_ → sessionStorage 存 → 调 `/me` → 渲染
- 不能复用 `IP.api`(那个走 cookie)—— 新加 `meApi` helper 走 `X-API-Key`
- Key 只在 sessionStorage,**关页面即清**,不会落盘不会上传
- 401 自动清 Key 跳回输 Key 卡片
- 顶部 nav 加「我的用量」入口:admin 也能用自己的 sk_ 查

**安全考虑**:
- 用户拿 sk_ 看自己:API key 天然按 username 隔离,**不能看别人** ✓
- 面板只读,没有任何写操作

回归 108/0 全绿(gateway 108,含 me.html 200 断言)。
This commit is contained in:
admin committed 2026-09-15 17:32:49 +08:00
1 parent fe7816450e
commit faae6b95d4
4 files changed
+354 -1

No files matched your search

+1
View File
@@ -292,6 +292,7 @@ ck "账号页 → 200" 200 "$(code -b "$JAR" $ADMIN/admin/users.html)"
ck "上游页 → 200" 200 "$(code -b "$JAR" $ADMIN/admin/upstreams.html)"
ck "用量页 → 200" 200 "$(code -b "$JAR" $ADMIN/admin/usage.html)"
ck "24h 热力页 → 200(1.0.27 直接读 meta.jsonl 聚合)" 200 "$(code -b "$JAR" $ADMIN/admin/hourly.html)"
ck "我的用量页 → 200(1.0.30 账号态面板)" 200 "$(code $ADMIN/admin/me.html)"
ck "登录页 → 200" 200 "$(code $ADMIN/admin/login.html)"
ck "共享样式 → 200" 200 "$(code $ADMIN/admin/assets/admin.css)"
ck "共享内核 → 200" 200 "$(code $ADMIN/admin/assets/core.js)"
+2 -1
View File
@@ -20,7 +20,8 @@ window.IP = (function () {
{ key: "upstreams", name: "LLM 上游", href: "upstreams.html" },
{ key: "apix", name: "API 代理", href: "apix.html" },
{ key: "usage", name: "用量统计", href: "usage.html" },
{ key: "hourly", name: "24h 热力", href: "hourly.html" }
{ key: "hourly", name: "24h 热力", href: "hourly.html" },
{ key: "me", name: "我的用量", href: "me.html" }
];
var state = {
+231
View File
@@ -0,0 +1,231 @@
/* 账号态「我的用量」面板(1.0.30)
输入 API Key → 调 /api/v1/me → 渲染概览 / 24h 小时分布 / 按 slot 拆分 /
我能调的上游 + apix + 我的域名。
Key 只在 sessionStorage,关页面即清。
*/
(function () {
"use strict";
var KEY_STORE = "ipass.me.key";
var $ = IP.$;
function esc(s) { return IP.esc(s); }
function setKey(k) {
if (k) sessionStorage.setItem(KEY_STORE, k);
else sessionStorage.removeItem(KEY_STORE);
}
function getKey() {
return sessionStorage.getItem(KEY_STORE) || "";
}
/** 走 X-API-Key 头,调 API。不能用 IP.api(那个走 cookie)。
* 401 直接 throw 让 UI 显出重新输入 Key。 */
function meApi(method, path, body) {
var key = getKey();
if (!key) return Promise.reject(new Error("未设置 API Key"));
var opt = { method: method, headers: { "X-API-Key": key } };
if (body) {
opt.headers["Content-Type"] = "application/json";
opt.body = JSON.stringify(body);
}
return fetch(path, opt).then(function (res) {
return res.json().catch(function () { return { code: res.status, msg: "响应解析失败" }; })
.then(function (data) {
if (!res.ok) throw new Error(data.msg || ("请求失败 HTTP " + res.status));
return data;
});
});
}
function showKeyCard() {
$("keyCard").hidden = false;
$("dashCard").hidden = true;
$("apiKey").focus();
}
function showDash() {
$("keyCard").hidden = true;
$("dashCard").hidden = false;
}
function renderTopbar(me) {
$("topbar").innerHTML =
'<div class="topbar">' +
'<div class="brand"><b>尚数网 山海关</b><span>个人用量面板</span></div>' +
'<div class="user-box">' +
'<span id="whoami">' + esc(me.username) + " · " +
(me.role === "admin" ? "管理员" : "账号") + "</span>" +
'<button class="btn-sm" id="topbarAdminBtn" ' + (me.role === "admin" ? "" : "hidden") + '>管理控制台</button>' +
'<button class="btn-sm btn-danger" id="topbarLogoutBtn">退出</button>' +
"</div>" +
"</div>";
if (me.role === "admin") {
$("topbarAdminBtn").addEventListener("click", function () {
// 跳 admin login(cookie 鉴权不走 me Key)
location.href = "login.html";
});
}
$("topbarLogoutBtn").addEventListener("click", function () {
setKey("");
showKeyCard();
$("apiKey").value = "";
});
}
function renderHourly(hour24) {
var el = $("dHourChart");
IP.chart.bars(el, {
labels: hour24.map(function (_, i) { return i; }),
items: [{ name: "调用数", values: hour24.map(function (v) { return Number(v) || 0; }) }],
emptyText: "过去 24 小时没有调用记录"
});
}
function renderSlots(bySlot) {
var body = $("dSlotBody");
if (!bySlot || !bySlot.length) {
body.innerHTML = '<tr><td colspan="6" class="empty">过去 7 天没有调用记录</td></tr>';
return;
}
body.innerHTML = bySlot.map(function (s) {
var lastStatus = s.last_status || 0;
var badgeClass = lastStatus >= 200 && lastStatus < 300 ? "b-ok"
: lastStatus >= 400 && lastStatus < 500 ? "b-warn"
: lastStatus >= 500 ? "b-bad" : "b-gray";
return '<tr>' +
'<td class="mono">' + esc(s.slot) + '</td>' +
'<td>' + (s.calls_24h || 0) + '</td>' +
'<td>' + (s.calls_7d || 0) + '</td>' +
'<td>' + IP.chart.fmtNum(s.tin_7d || 0) + '</td>' +
'<td>' + IP.chart.fmtNum(s.tout_7d || 0) + '</td>' +
'<td><span class="badge ' + badgeClass + '">' + lastStatus + '</span></td>' +
'</tr>';
}).join("");
}
function renderUpstreams(upstreams) {
var el = $("dUpstream");
if (!upstreams || !upstreams.length) {
el.innerHTML = '当前账号无可用上游(可能白名单为空,或全部 slot 被停用)';
return;
}
el.innerHTML = '<table><thead><tr><th>slot</th><th>base_url</th><th>models</th></tr></thead><tbody>' +
upstreams.map(function (u) {
return '<tr>' +
'<td class="mono">' + esc(u.slot || "") + '</td>' +
'<td class="mono" style="font-size:12px"><code>' + esc(u.base_url || "") + '</code></td>' +
'<td>' + ((u.models || []).map(esc).join("、") || "—") + '</td>' +
'</tr>';
}).join("") + '</tbody></table>';
}
function renderApix(apix) {
var el = $("dApix");
if (!apix || !apix.length) {
el.innerHTML = '当前账号无可用 API 代理';
return;
}
el.innerHTML = '<table><thead><tr>' +
'<th>slug</th><th>用途</th><th>调用方式</th><th>说明</th>' +
'</tr></thead><tbody>' +
apix.map(function (a) {
var mode = a.mode || "vendor";
var call = mode === "passthrough"
? '<code>POST /apixp/' + esc(a.slug) + '/&lt;tail&gt;</code>'
: '<code>GET /apix/' + esc(a.slug) + '?参数=值</code>';
return '<tr>' +
'<td class="mono">' + esc(a.slug || "") + '</td>' +
'<td>' + esc(a.display_name || a.url || "—") + '</td>' +
'<td style="font-size:12.5px">' + call + '</td>' +
'<td class="muted" style="font-size:12px">' + esc((a.desc || a.usage_hint || "").slice(0, 80)) + '</td>' +
'</tr>';
}).join("") + '</tbody></table>';
}
function renderDomains(domains) {
var el = $("dDomains");
if (!domains || !domains.length) {
el.innerHTML = '当前账号没有域名(需要去"全部域名"页申请)';
return;
}
el.innerHTML = '<table><thead><tr>' +
'<th>子域名</th><th>后端</th><th>状态</th><th>创建时间</th>' +
'</tr></thead><tbody>' +
domains.map(function (d) {
return '<tr>' +
'<td class="mono">' + esc(d.full || d.subdomain || "—") + '</td>' +
'<td class="mono" style="font-size:12px">' + esc(d.backend || "—") + '</td>' +
'<td><span class="badge ' + (d.enabled ? "b-ok" : "b-gray") + '">' +
(d.enabled ? "启用" : "停用") + '</span></td>' +
'<td class="muted">' + esc(d.created_at_text || "") + '</td>' +
'</tr>';
}).join("") + '</tbody></table>';
}
function renderDash(me) {
renderTopbar(me);
$("dUser").textContent = me.username || "-";
var r = me.recent || {};
$("dCalls24").textContent = r.calls_24h || 0;
$("dCalls7").textContent = r.calls_7d || 0;
$("dTin24").textContent = IP.chart.fmtNum(r.tin_24h || 0);
$("dTout24").textContent = IP.chart.fmtNum(r.tout_24h || 0);
$("dLast").textContent = r.last_at
? esc(r.last_at + " · " + (r.last_slot || "-"))
: "—";
renderHourly(r.hour_24h || []);
renderSlots(r.by_slot || []);
renderUpstreams(me.upstreams || []);
renderApix(me.apix || []);
renderDomains(me.domains || []);
}
function loadDash() {
IP.toast("加载中…");
meApi("GET", "/api/v1/me").then(function (resp) {
var me = resp.data || {};
if (!me.username) {
IP.toast("接口返回异常:缺 username", true);
showKeyCard();
return;
}
renderDash(me);
showDash();
IP.toast("已加载");
}).catch(function (err) {
if (err.message && err.message.indexOf("HTTP 401") >= 0) {
setKey("");
IP.toast("Key 无效或已过期,请重新输入", true);
showKeyCard();
$("apiKey").value = "";
$("apiKey").focus();
} else {
IP.toast("加载失败:" + (err.message || err), true);
}
});
}
function bind() {
$("keyForm").addEventListener("submit", function (e) {
e.preventDefault();
var k = $("apiKey").value.trim();
if (!k) { IP.toast("请输入 API Key", true); return; }
setKey(k);
loadDash();
});
$("refreshBtn").addEventListener("click", loadDash);
}
function boot() {
bind();
if (getKey()) loadDash();
else showKeyCard();
}
if (document.readyState === "loading") {
document.addEventListener("DOMContentLoaded", boot);
} else {
boot();
}
})();
+120
View File
@@ -0,0 +1,120 @@
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<base href="/admin/">
<title>我的用量 · 尚数网 山海关</title>
<link rel="stylesheet" href="assets/admin.css">
</head>
<body>
<div id="topbar"></div>
<div class="wrap">
<!-- 输 Key 卡片(首次进入时显示) -->
<div id="keyCard" class="panel" style="max-width:560px;margin:60px auto 0">
<div class="panel-head">
<div>
<h2>用 API Key 看我的用量</h2>
<div class="desc">
输入账号的 <code>sk_xxx</code> 即可查询本账号的最近调用、消耗、能用的上游/代理等数据。
<b>Key 只在浏览器 sessionStorage</b>,关页面即清,<b>不会落盘也不会上传</b>。
</div>
</div>
</div>
<form id="keyForm" class="login-card" style="box-shadow:none;padding:8px 0">
<div class="field">
<label for="apiKey">API Key</label>
<input id="apiKey" type="password" autocomplete="off" placeholder="sk_xxxxxxxxxxxxxxxxxxxxxxxxxx" required>
</div>
<div class="muted" id="keyHint" style="font-size:12.5px;margin:4px 0 12px">
忘记 Key?联系管理员重置。
</div>
<div class="row-actions">
<button class="btn-sm btn-ok" type="submit" id="keySubmit">查 询</button>
<a class="btn-sm" href="login.html">管理员登录</a>
</div>
</form>
</div>
<!-- 面板(鉴权后显示) -->
<div id="dashCard" hidden>
<div class="stats">
<div class="stat"><div class="k">用户名</div><div class="v" id="dUser" style="font-size:18px">-</div></div>
<div class="stat"><div class="k">24h 调用</div><div class="v" id="dCalls24">-</div></div>
<div class="stat"><div class="k">7d 调用</div><div class="v" id="dCalls7">-</div></div>
<div class="stat"><div class="k">24h 入 token</div><div class="v" id="dTin24">-</div></div>
<div class="stat"><div class="k">24h 出 token</div><div class="v" id="dTout24">-</div></div>
<div class="stat"><div class="k">上次调用</div><div class="v" id="dLast" style="font-size:14px">-</div></div>
</div>
<div class="panel">
<div class="panel-head">
<div>
<h2>24h 调用分布</h2>
<div class="desc">按本地自然小时分桶;含被拒的 401/404 之类——审计全量视角。</div>
</div>
<div class="row-actions">
<button class="btn-sm" id="refreshBtn">刷新</button>
<button class="btn-sm btn-danger" id="logoutBtn">退出</button>
</div>
</div>
<div class="chart" id="dHourChart" style="min-height:160px"></div>
</div>
<div class="panel">
<div class="panel-head">
<div>
<h2>近 7 天按上游 slot</h2>
<div class="desc">按 calls_7d 降序。last_status 是最近一次调用的 HTTP 状态码。</div>
</div>
</div>
<table>
<thead><tr>
<th>slot</th><th>24h</th><th>7d</th><th>7d 入 token</th><th>7d 出 token</th><th>最近状态</th>
</tr></thead>
<tbody id="dSlotBody"></tbody>
</table>
</div>
<div class="panel">
<div class="panel-head">
<div>
<h2>我能调的 LLM 上游</h2>
<div class="desc">
按白名单过滤后的可用 slot;base_url 是<a href="https://doc.你的域名" target="_blank" rel="noopener">调用方视角</a>的完整 URL,客户端可直接配。
</div>
</div>
</div>
<div id="dUpstream" class="muted" style="font-size:13px"></div>
</div>
<div class="panel">
<div class="panel-head">
<div>
<h2>我能调的 API 代理</h2>
<div class="desc">仅列 enabled 代理;每条带示例调用方式(<code>GET /apix/&lt;slug&gt;?...</code> 或 <code>POST /apixp/&lt;slug&gt;/&lt;tail&gt;</code>)。</div>
</div>
</div>
<div id="dApix"></div>
</div>
<div class="panel">
<div class="panel-head">
<div>
<h2>我的域名</h2>
<div class="desc">本账号申请并被审批通过的子域名列表。</div>
</div>
</div>
<div id="dDomains"></div>
</div>
</div>
</div>
<div id="toast"></div>
<script src="assets/core.js"></script>
<script src="assets/chart.js"></script>
<script src="assets/me.js"></script>
</body>
</html>