# 一次请求的完整旅程

从 HTTP 到像素 — 追踪一个生成请求的全链路

<div class="text-sm mt-2">

```
POST /api/v1/generate  {prompt: "像素风骑士", assetType: "sprite", style: {artStyle: "pixel"}}
```

</div>

<v-clicks>

<Item title="① Middleware 层（~1ms）">
JWT 认证 → 解析 userID → 用户级限流检查（Redis Lua）→ 全局限流检查 → 放行
</Item>

<Item title="② Handler 层（~5ms）">
参数绑定 + 校验 → 去重检查 `hash(prompt+type+params)` → 创建 Task（DB 写入）→ 入队 TaskQueue → 返回 `taskId`
</Item>

<Item title="③ Pipeline 执行（~30s）">
goroutine 取出任务 → PromptOptimizer（风格合并 + LLM）→ AssetGenerator（文生图 API）→ QualitySupervisor（视觉模型质检，可能重试）→ FormatAdapter（精灵表拆分 + GIF）
</Item>

<Item title="④ 收尾（~2s）">
上传素材到七牛云 Kodo → 写入 Asset 表 → 更新 Task status=completed → WebSocket 推送完成通知
</Item>

</v-clicks>

<div v-click class="mt-2 text-center text-gray-400 text-sm">
  全程异步：前端拿到 taskId 后通过 WebSocket 实时监听进度变化
</div>

<!--
这就是一个请求的完整生命周期。注意看耗时分布：管线占了 95% 的时间，这就是为什么要做异步。
-->