cs-note/hzh/Gen2D/00-索引.md

tags, create time

tags	create time
index architecture gen2d overview	2026-06-03 09:00

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

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

概述

本文档是 Gen2D 系统架构讲解的导航索引，覆盖从整体分层架构到具体技术组件的 15 个核心知识点。通过本文档可以快速定位到任意模块的详细解读。

正文

文档导航

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

[!tip] 阅读顺序建议

建议按编号顺序阅读：先理解 01-系统总览 的全局架构，再深入各个具体组件（协程池、任务队列、RabbitMQ），最后学习运行时相关话题（SSE 推送、可观测性、降级策略）。QA 可作为答辩准备参考。

架构总览图

graph TB
    subgraph Browser["浏览器 (React)"]
        UI["三栏工作台"]
        SE["EventSource ← SSE"]
    end

    subgraph Gateway["Gin HTTP Server"]
        MW["中间件链<br/>Logger / Recovery / Metrics / Auth / RateLimit"]
    end

    subgraph Handler["Handler 层"]
        GH["GenerateHandler"]
        SH["SSEHandler"]
        PH["PromptHandler"]
    end

    subgraph Infra["基础设施层"]
        TQ["TaskQueue<br/>Memory / RabbitMQ"]
        WP["WorkerPool<br/>NumCPU*4 并发<br/>Per-user 限流"]
        EB["EventBus<br/>Pub/Sub"]
    end

    subgraph Pipeline["Service 层"]
        EP["Eino Pipeline<br/>4 阶段生成管线"]
    end

    subgraph External["外部依赖"]
        IMG["Image API<br/>DALL-E 3"]
        QC["Quality Check<br/>GPT-4o"]
        SP["SplitSprite + GIF Maker"]
    end

    UI -->|"HTTP"| GW
    SE --> UI
    GW --> MW
    MW --> Handler
    GH --> TQ
    GH --> WP
    SH --> EB
    TQ --> WP
    WP --> EP
    EP --> IMG & QC & SP

配套图表

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