cs-note/hzh/Gen2D/00-index.md

Gen2D 架构讲解 — 答辩文档索引

AI 驱动的 2D 游戏素材生成工具

文档导航

#	文件	主题	核心要点
1	01-system-overview	系统总览	Gin → Handler → Service → 基础设施 → 外部依赖
2	02-worker-pool	协程池	有界并发、per-user 限流、背压、优雅关闭
3	03-task-queue	任务队列	可插拔接口 + Memory / RabbitMQ 双实现
4	04-rabbitmq	RabbitMQ 集成	AMQP 连接、持久化消息、重试/死信流程
5	05-generation-pipeline	生成管线	Eino 4 阶段图 + 质量回退 + 降级路径
6	06-sprite-processing	精灵图处理	背景移除 → 投影切割 → 后处理 → GIF 预览
7	07-observability	可观测性	35 Prometheus 指标 + 3 Grafana 仪表盘 + 10 告警
8	08-sse-push	SSE 实时推送	EventBus → SSEHandler → 浏览器 EventSource
9	09-rate-limiting	限流	Redis Lua 令牌桶 + 双层限流 + Fail-Open
10	10-middleware-chain	中间件链	Logger → Recovery → Metrics → Auth → RateLimit
11	11-consumer-producer	Consumer-Producer 桥接	TaskQueue → Consumer → WorkerPool 解耦
12	12-three-tier-fallback	三级降级策略	Queue → Pool → Legacy 降级链
13	13-prompt-engineering	标签驱动提示词	40+ 标签映射 + 风格一致性
14	14-deployment	部署架构	Docker Compose + Prometheus + Grafana
15	15-config-cascade	配置级联	Viper 三层配置：YAML → ENV → Default

架构总览图

┌─────────────────────────────────────────────────────────────────┐
│                        浏览器 (React)                           │
│  EventSource ← SSE ← EventBus ← Pipeline Progress              │
└────────────────────────────┬────────────────────────────────────┘
                             │ HTTP
┌────────────────────────────▼────────────────────────────────────┐
│                     Gin HTTP Server                              │
│  Logger → Recovery → Metrics → Auth → RateLimit → Handler       │
└────────────────────────────┬────────────────────────────────────┘
                             │
┌────────────────────────────▼────────────────────────────────────┐
│                      Handler 层                                  │
│  GenerateHandler / SSEHandler / PromptHandler                    │
└──────┬─────────────────────┬─────────────────────┬──────────────┘
       │                     │                     │
┌──────▼──────┐    ┌─────────▼─────────┐    ┌─────▼──────┐
│ TaskQueue   │    │   WorkerPool      │    │  EventBus  │
│ Memory/RMQ  │───→│  NumCPU*4 并发    │    │  Pub/Sub   │
└─────────────┘    │  Per-user 限流    │    └────────────┘
                   └─────────┬─────────┘
                             │
                   ┌─────────▼─────────┐
                   │  Eino Pipeline    │
                   │  4 阶段生成管线    │
                   └─────────┬─────────┘
                             │
              ┌──────────────┼──────────────┐
              ▼              ▼              ▼
        Image API      Quality Check    SplitSprite
        (DALL-E 3)     (GPT-4o)        + GIF Maker

配套图表

每份文档开头使用 Mermaid 流程图，可直接在 Markdown 渲染器中查看。