请求检查器
请求检查器（Request Inspector）是 Luker 的核心后端模块之一，用于追踪每个 AI 生成请求从发起到完成的完整生命周期，并记录详细的 Token 用量数据。它是生成诊断能力的基础设施。
问题背景
在 SillyTavern 中，AI 生成请求发出后，后端不会系统性地记录请求的 Token 消耗。用户无法得知每次生成实际花费了多少 Token，管理员也无法追踪多用户场景下的资源使用情况。
Luker 实现了一套完整的请求生命周期追踪系统，覆盖文本生成、图像生成、向量嵌入 / 重排三类请求。
核心能力
请求生命周期追踪
每个 AI 生成请求都会经历以下状态流转：
- 开始 — 记录请求元数据，标记请求进入追踪
- 完成 — 请求成功返回，记录 Token 用量
- 失败 — 请求出错，记录错误信息
- 中止 — 用户主动取消生成
Token 用量统计
请求检查器记录每次生成的详细 Token 数据：
- Prompt Tokens — 输入提示词消耗的 Token 数
- Completion Tokens — 模型生成内容消耗的 Token 数
- Total Tokens — 总用量
这些数据从 API 响应中提取，并与用户账户关联，用于用量统计和诊断分析。
流式响应的 Token 统计
对于流式（SSE）响应，Token 用量信息通常包含在最后一个 SSE 事件中。请求检查器会从 SSE 事件流中提取 usage 字段，确保流式生成也能准确统计 Token 消耗。
图像生成请求追踪
除文本生成外，请求检查器还追踪图像生成请求，覆盖所有图像生成后端。
向量嵌入与重排请求追踪
请求检查器同样覆盖向量子系统，记录发往所有远端向量提供方（OpenAI、Cohere、Jina、Ollama、VLLM、Voyage 等）的嵌入、查询和重排调用，以及 KoboldCpp 直连嵌入桥接。仅在本地进程内推理的源不会离开本机，因此会被跳过，让环形缓冲专注于真正的上游流量。
与存储配额的关系
请求检查器追踪的 Token 用量是独立的统计功能，用于帮助用户和管理员了解 AI 生成的资源消耗情况。这与认证与配额中的存储配额管理是两个独立的系统：
- Token 用量统计：请求检查器记录每次 AI 生成的 Token 消耗，提供用量可视化和诊断数据
- 存储配额管理：管理文件存储空间的分配和限制
TIP
请求检查器会随服务器自动启用，无需额外配置。