Files
gen2d/docs/multi-agent-pipeline.md
T

74 lines
2.4 KiB
Markdown
Raw Normal View History

# 多阶段生成管线
gen2d 的核心生成流程采用四阶段顺序管线,上一步输出即下一步输入,无需编排。
```mermaid
flowchart LR
A["PromptBuilder\n(提示词工程)"] --> B["AssetGenerator\n(AI 出图)"]
B --> C["QualitySupervisor\n(质检)"]
C --> D["FormatAdapter\n(格式适配)"]
```
---
## 1. PromptBuilder
- **输入**:用户文本 + 素材类型标签 + 工程风格 + 任务风格覆盖 + 技术参数
- **输出**:三段式完整生成提示词
- **职责**:
1. 解析用户文本,提取核心内容作为【主题】
2. 合并工程风格与任务风格覆盖(任务同名键覆盖工程),生成【约束】(含负面提示词)
3. 注入素材类型、分辨率等技术参数作为【内容】
4. 拼接为最终提示词
### 风格合并
```go
finalStyle = merge(projectStyle.KVPairs, taskStyle.KVPairs)
```
工程风格保证同一工程下所有素材风格一致;任务风格仅覆盖需要差异化的键。
### 三段式提示词结构
```
【主题】用户的原始描述核心内容
【约束】风格键值对生成的约束条件 + 负面提示词
【内容】素材类型、分辨率、帧数等技术参数
```
## 2. AssetGenerator
- **输入**:PromptBuilder 的输出
- **输出**:原始生成图片(单张或多张)
- **职责**:调用 AI 推理 API 出图。不同素材类型的差异化需求已在上一步注入提示词中。
## 3. QualitySupervisor
- **输入**:原始生成图片 + 风格配置
- **输出**:质量评分 + 是否通过
- **职责**:评估素材质量,不通过则触发重新生成(最多 3 次)。
## 4. FormatAdapter
- **输入**:通过质检的图片 + 素材类型
- **输出**:游戏引擎可用的素材文件 + 元数据
- **职责**:格式转换、spritesheet 打包、元数据生成。
---
## 预设风格键分类
前端以分类标签组织,用户点选:
| 分类 | 键名 | 可选值示例 |
|------|------|-----------|
| 美术风格 | `artStyle` | pixel, cartoon, hand-drawn, vector, flat |
| 色调 | `palette` | warm, cool, neutral, vibrant, muted, monochrome |
| 线条 | `lineWeight` | none, thin, medium, thick |
| 场景 | `scene` | forest, dungeon, city, space, underwater, desert |
| 光照 | `lighting` | bright, dim, dramatic, ambient, neon |
| 情绪 | `mood` | cheerful, dark, mysterious, epic, calm |
(具体键值后续可扩展,这里是初始集合)