147 lines
5.2 KiB
TypeScript
147 lines
5.2 KiB
TypeScript
/**
|
||
* 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<void> {
|
||
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, unknown> }): 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<string, unknown>;
|
||
/** 可选:显式幂等键,用于跨请求去重 */
|
||
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<string, unknown>, {
|
||
...(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;
|
||
});
|
||
|
||
/**
|
||
* 抓取网页标题。
|
||
*
|
||
* <p>安全-03:目标由调用方给出,因此在抓取前做协议、端口、DNS 解析与逐跳重定向校验,
|
||
* 避免被当成探测内网与云元数据的跳板,同时对响应体做截断。</p>
|
||
*/
|
||
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[^>]*>([^<]+)<\/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 };
|
||
}
|
||
});
|
||
}
|