gen2d/README.md

# gen2d

AI 驱动的 2D 游戏素材生成工具。通过文本提示词或可视化参数，快速生成风格一致、管线友好的 Sprite、背景、UI 元素与动画帧。支持 Unity / Godot 一键集成。

[![Go](https://img.shields.io/badge/Go-00ADD8?logo=go&logoColor=white)](https://go.dev/)
[![Gin](https://img.shields.io/badge/Gin-008ECF?logo=gin&logoColor=white)](https://gin-gonic.com/)
[![React](https://img.shields.io/badge/React-61DAFB?logo=react&logoColor=black)](https://react.dev/)
[![TypeScript](https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
[![Vite](https://img.shields.io/badge/Vite-646CFF?logo=vite&logoColor=white)](https://vite.dev/)

### **[在线体验 http://47.121.181.112:10000](http://47.121.181.112:10000)**

架构采用多智能体协作管线（PromptBuilder → AssetGenerator → QualitySupervisor → FormatAdapter），详见 [docs/architecture.md](docs/architecture.md)。

## 快速开始

### 后端

```bash
cd backend
go mod tidy
go run cmd/main.go
```

服务默认运行在 `http://localhost:8080`。

### 前端

```bash
cd frontend
npm install
npm run dev
```

开发服务器默认运行在 `http://localhost:5173`，通过 Vite proxy 转发 API 请求到后端。

## 项目结构

```
gen2d/
├── backend/          # Go + Gin API 服务
├── frontend/         # Vite + React 前端
└── docs/             # 项目文档
    ├── architecture.md  # 架构设计
    └── api.md           # API 文档
```

详细架构说明见 [docs/architecture.md](docs/architecture.md)。

## API

接口统一前缀 `/api/v1/`，详见 [docs/api.md](docs/api.md)。

## 参与贡献

1. Fork 本仓库
2. 新建 Feat_xxx 分支
3. 提交代码
4. 新建 Pull Request