/**
* 管理员路由:日志查询 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 · 管理面板
| 时间 | 端点 | 状态 |
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 };
});
}