/** * 管理员路由:日志查询 API + 自包含 HTML 面板。 */ import type { FastifyInstance } from "fastify"; import { logStore } from "./store.js"; import { checkToken, configuredToken, queryTokenMatches, TOKEN_COOKIE } from "../utils/auth.js"; import { fetchUpstreamBalance } from "./balance.js"; const PANEL_HTML = ` lpt-ai · 管理面板

lpt-ai 管理面板

请求日志 & 调试
时间端点状态 Token 输入/输出缓存命中费用(USD) 耗时调用次数模型
暂无请求记录
`; export async function adminRoutes(app: FastifyInstance): Promise { // 管理面板会展示完整 prompt 与学习内容,与 /ai/* 共用同一个可选令牌(安全-03) if (!configuredToken()) { app.log.warn( "未设置 LPT_AI_TOKEN,/admin 面板与 /ai/* 无访问保护(面板会展示 prompt 与学习内容)", ); } app.addHook("preHandler", async (request, reply) => { if (!checkToken(request, reply)) { return reply; } }); // —— 面板页面 —— app.get<{ Querystring: { token?: string } }>("/admin", async (request, reply) => { // 用 `?token=` 打开面板时换发一个 HttpOnly cookie: // 面板 HTML 与它后续的 fetch 是两个独立请求,只在 URL 上带令牌会让面板永远空白 if (queryTokenMatches(request)) { reply.header( "set-cookie", `${TOKEN_COOKIE}=${encodeURIComponent(configuredToken())}; Path=/admin; HttpOnly; SameSite=Strict`, ); } return reply.type("text/html; charset=utf-8").send(PANEL_HTML); }); // —— 日志列表 —— app.get<{ Querystring: { endpoint?: string } }>("/admin/logs", async (request) => { const endpoint = request.query.endpoint || undefined; const summaries = logStore.list(endpoint); // 用量统计只算真正消耗 LLM 的记录;/fetch-title 这类请求混进来会把分母撑大 const llm = summaries.filter((s) => s.isLlmCall); const sum = (pick: (s: (typeof llm)[number]) => number | null | undefined): number => llm.reduce((total, item) => total + (pick(item) ?? 0), 0); const cacheHitTokens = sum((s) => s.usage?.cacheHitTokens); const cacheMissTokens = sum((s) => s.usage?.cacheMissTokens); const cacheTotal = cacheHitTokens + cacheMissTokens; const stats = { total: summaries.length, ok: summaries.filter((s) => s.status >= 200 && s.status < 300).length, err: summaries.filter((s) => s.status < 200 || s.status >= 300).length, avgMs: summaries.length > 0 ? Math.round(summaries.reduce((a, s) => a + s.durationMs, 0) / summaries.length) : 0, endpoints: logStore.endpoints(), llmCalls: llm.length, promptTokens: sum((s) => s.usage?.promptTokens), completionTokens: sum((s) => s.usage?.completionTokens), totalTokens: sum((s) => s.usage?.totalTokens), cacheHitTokens, cacheMissTokens, // 分母为 0 时返回 null,面板显示「—」而不是 0% cacheHitRate: cacheTotal > 0 ? cacheHitTokens / cacheTotal : null, costUsd: llm.reduce((total, item) => total + (item.costUsd ?? 0), 0), unreportedUsageCalls: llm.filter((s) => s.usage?.promptTokens == null).length, }; return { logs: summaries, stats }; }); // —— 上游余额(对账)—— app.get("/admin/usage/balance", async () => fetchUpstreamBalance()); // —— 日志详情 —— app.get<{ Params: { id: string } }>("/admin/logs/:id", async (request, reply) => { const id = parseInt(request.params.id, 10); if (isNaN(id)) { return reply.status(400).send({ error: "无效 ID" }); } const entry = logStore.get(id); if (!entry) { return reply.status(404).send({ error: "日志不存在" }); } return entry; }); // —— 清空日志 —— app.delete("/admin/logs", async () => { logStore.clear(); return { ok: true }; }); }