/** * AI 能力路由(仅异步任务模式,旧同步端点已移除) */ import type { FastifyInstance } from "fastify"; import { isAvailable, loadConfig } from "../llm/client.js"; import { createTask, getTask, type TaskType } from "../task-queue.js"; import { logStore } from "../admin/store.js"; import { safeFetchText, UnsafeUrlError } from "../utils/ssrf-guard.js"; import { RateLimiter, intFromEnv } from "../utils/rate-limit.js"; import { checkToken } from "../utils/auth.js"; export async function aiRoutes(app: FastifyInstance): Promise { const config = loadConfig(); // 安全-03:AI 任务会消耗 LLM 额度,按来源限流(单进程粗粒度保护) const taskLimiter = new RateLimiter({ limit: intFromEnv("LPT_AI_RATE_LIMIT", 30), windowMs: intFromEnv("LPT_AI_RATE_WINDOW_MS", 60_000), }); // 安全-03:可选的入站令牌。设置了 LPT_AI_TOKEN 时,所有 /ai/* 请求都必须携带 app.addHook("preHandler", async (request, reply) => { if (!request.url.startsWith("/ai/")) return; if (!checkToken(request, reply)) { return reply; } return undefined; }); /** 取限流用的来源标识:优先真实客户端 IP(后面有反代时取 X-Forwarded-For 首段) */ const clientKey = (request: { ip?: string; headers: Record }): string => { const forwarded = request.headers["x-forwarded-for"]; if (typeof forwarded === "string" && forwarded.trim()) { return forwarded.split(",")[0].trim(); } return request.ip ?? "unknown"; }; app.get("/health", async () => ({ status: "ok", llmAvailable: isAvailable(config), model: config.model, })); /** 提交 AI 任务,立即返回 taskId */ app.post<{ Body: { type: string; params: Record; /** 可选:显式幂等键,用于跨请求去重 */ idempotencyKey?: string; /** 可选:跳过结果复用,强制重新生成 */ force?: boolean; }; }>("/ai/tasks", async (request, reply) => { const { type, params, idempotencyKey, force } = request.body ?? {}; const decision = taskLimiter.check(clientKey(request)); if (!decision.allowed) { app.log.warn({ key: clientKey(request) }, "AI 任务提交被限流"); return reply .status(429) .header("retry-after", String(Math.ceil(decision.retryAfterMs / 1000))) .send({ error: "提交太频繁了,请稍后再试" }); } if (!type || !["aggregate-report", "generate-mind-map", "compare-recall", "guidance"].includes(type)) { return reply.status(400).send({ error: "无效的 type,允许: aggregate-report, generate-mind-map, compare-recall, guidance" }); } if (!params || typeof params !== "object") { return reply.status(400).send({ error: "params 必须为非空对象" }); } const created = createTask(type as TaskType, params as Record, { ...(typeof idempotencyKey === "string" && idempotencyKey.trim().length > 0 ? { idempotencyKey } : {}), ...(force === true ? { force: true } : {}), }); // 固定返回 201:Java 端 AiServiceClient 把非 201 当作提交失败, // 所以不能改用 200 表达「复用」。复用信息放在响应体里。 return reply.status(201).send(created); }); /** 查询任务状态与结果 */ app.get<{ Params: { taskId: string } }>("/ai/tasks/:taskId", async (request, reply) => { const { taskId } = request.params; const task = getTask(taskId); if (!task) { return reply.status(404).send({ error: "任务不存在" }); } return task; }); /** * 抓取网页标题。 * *

安全-03:目标由调用方给出,因此在抓取前做协议、端口、DNS 解析与逐跳重定向校验, * 避免被当成探测内网与云元数据的跳板,同时对响应体做截断。

*/ app.post<{ Body: { url: string } }>("/fetch-title", async (request, reply) => { const { url } = request.body ?? {}; const t0 = Date.now(); if (!url || typeof url !== "string") { return reply.status(400).send({ error: "无效的 URL" }); } try { const { body } = await safeFetchText(url); const match = body.match(/]*>([^<]+)<\/title>/i); const title = match ? match[1].trim() : null; logStore.add({ timestamp: new Date().toISOString(), endpoint: "/fetch-title", model: "", durationMs: Date.now() - t0, status: 200, requestBody: { url }, responseBody: { url, title }, }); return { url, title }; } catch (err) { // 被安全校验拦下时返回 400(调用方的问题),其余按抓取失败处理 const blocked = err instanceof UnsafeUrlError; const message = err instanceof Error ? err.message : String(err); logStore.add({ timestamp: new Date().toISOString(), endpoint: "/fetch-title", model: "", durationMs: Date.now() - t0, status: blocked ? 400 : 502, requestBody: { url }, responseBody: { url, title: null }, error: message, }); if (blocked) { return reply.status(400).send({ error: message }); } return { url, title: null }; } }); }