docs: 更新 README 与 API 文档,描述提示词优化链路

- README 新增提示词优化链路章节(流程图 + 特性 + API 说明)
- docs/api.md 新增提示词优化接口文档与调用链路
- 更新架构描述:PromptBuilder → PromptOptimizer
This commit is contained in:
2026-05-24 20:45:24 +08:00
parent 9ca1e65221
commit 36a6465f26
6 changed files with 244 additions and 41 deletions
+5 -5
View File
@@ -75,9 +75,9 @@ JobQueue.Pop() 取出 taskId
├── 2. 查询 task + project_style
├── 3. 构造 PipelineInput
├── 4. RunPipeline(ctx, input)
│ ├── PromptBuilder → stage 更新
│ ├── PromptOptimizer → stage 更新
│ ├── AssetGenerator → stage 更新
│ ├── QualitySupervisor → stage 更新(可能触发重试分支)
│ ├── QualitySupervisor → stage 更新(可能触发重优化分支)
│ └── FormatAdapter → stage 更新
├── 5. 保存素材到本地,写入 asset 表
├── 6. 更新 task.status = completed
@@ -125,7 +125,7 @@ func (s *TaskService) StartWorkers(n int) {
| 阶段 | stage 值 | 进度范围 | 说明 |
|------|----------|---------|------|
| 提示词构建 | `prompt_builder` | 0-20% | 合并风格,生成三段式提示词 |
| 提示词优化 | `prompt_optimizer` | 0-20% | 调用 PromptAgent/LLM 优化提示词,合并风格与技术参数 |
| 素材生成 | `asset_generator` | 20-60% | 调用 AI 推理 API 出图 |
| 质量检查 | `quality_supervisor` | 60-80% | 视觉模型质检 |
| 格式适配 | `format_adapter` | 80-100% | 格式转换、spritesheet 打包、保存素材 |
@@ -136,10 +136,10 @@ func (s *TaskService) StartWorkers(n int) {
### 质检重试(管线内重试)
QualitySupervisor 质检不通过时,Eino Graph 分支回到 PromptBuilder 重新生成:
QualitySupervisor 质检不通过时,Eino Graph 分支回到 PromptOptimizer 重新优化提示词:
```
QualitySupervisor -- fail --> PromptBuilder --> AssetGenerator --> QualitySupervisor
QualitySupervisor -- fail --> PromptOptimizer --> AssetGenerator --> QualitySupervisor
QualitySupervisor -- pass --> FormatAdapter
```