docs: 更新架构文档,文件存储切换为七牛云对象存储

- _index.md: 技术栈加入七牛云对象存储
- api.md: 新增素材下载接口,asset URL 改为 CDN URL
- backend.md: 分层结构新增 storage.go,FormatAdapter 职责增加上传
- database.md: 文件存储改为七牛云,配置表新增 GEN2D_QINIU_* 环境变量
This commit is contained in:
2026-05-25 12:57:41 +08:00
parent 30a46ff74b
commit f61508a249
4 changed files with 43 additions and 34 deletions
+5 -3
View File
@@ -16,7 +16,8 @@ backend/internal/
│ ├── login.go # [已有] 用户登录(handler 骨架 + 参数校验)
│ ├── project.go # 工程 CRUD + 任务列表
│ ├── generate.go # 生成任务提交 / 查询 / WebSocket
│ └── project_style.go # 工程风格 CRUD
│ ├── project_style.go # 工程风格 CRUD
│ └── storage.go # [已有] 素材下载(重定向到七牛云 CDN)
├── service/ # 业务逻辑层
│ ├── pipeline.go # [已有] Eino compose.Graph 编排:PromptOptimizer → AssetGenerator → QualitySupervisor → FormatAdapter
│ ├── nodes.go # [已有] 管线四个节点的实现(每个节点单一职责)
@@ -24,7 +25,8 @@ backend/internal/
│ ├── inference.go # [已有] AI 推理 API 调用封装(当前为 mock 实现)
│ ├── pipeline_test.go # [已有] 管线测试(happy path / 重试 / 降级 / 风格合并)
│ ├── auth.go # 用户认证:注册、登录、JWT 签发与校验
│ └── project_style.go # 工程风格管理 & 风格合并逻辑
│ ├── project_style.go # 工程风格管理 & 风格合并逻辑
│ └── storage.go # [已有] 七牛云对象存储:上传、下载 URL 生成、删除
├── model/ # 数据模型 / DTO
│ ├── response.go # [已有] 统一响应
│ ├── user.go # [已有] 用户模型
@@ -106,7 +108,7 @@ finalStyle = merge(projectStyle.KVPairs, taskStyle.KVPairs)
- **输入**:通过质检的图片 + 素材类型
- **输出**:游戏引擎可用的素材文件 + 元数据
- **职责**:格式转换、spritesheet 打包、元数据生成。
- **职责**:格式转换、spritesheet 打包、元数据生成、上传素材到七牛云对象存储。
- **示例**:输入 4 张 64×64 的角色行走帧 PNG → 输出一张 256×64 的 spritesheet + JSON 元数据(帧尺寸、帧数、锚点偏移),可直接拖入 Unity 2D Animation 使用。
---