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
+16 -2
View File
@@ -300,7 +300,7 @@ POST /api/v1/prompt/optimize
### DELETE /api/v1/projects/:projectId
级联删除工程下的所有任务、素材及本地文件。
级联删除工程下的所有任务、素材及七牛云对象。
响应:
@@ -372,6 +372,7 @@ POST /api/v1/prompt/optimize
| [ ] | GET | `/api/v1/tasks/:taskId` | 查询任务状态与进度 |
| [ ] | GET | `/api/v1/tasks/:taskId/assets` | 获取生成结果(素材列表 + 元数据) |
| [ ] | WS | `/api/v1/tasks/:taskId/ws` | WebSocket 实时进度推送 |
| [x] | GET | `/api/v1/assets/download` | 下载素材(重定向到 CDN) |
### POST /api/v1/generate
@@ -483,7 +484,7 @@ POST /api/v1/prompt/optimize
"assets": [
{
"id": "asset_001",
"url": "users/user_a1B2c3D4/projects/proj_abc123/tasks/task_xyz789/output/spritesheet.png",
"url": "https://cdn.example.com/users/user_a1B2c3D4/projects/proj_abc123/tasks/task_xyz789/output/spritesheet.png",
"format": "png",
"width": 256,
"height": 64,
@@ -499,6 +500,19 @@ POST /api/v1/prompt/optimize
}
```
### GET /api/v1/assets/download
需认证。返回 302 重定向到七牛云 CDN URL。
| 参数 | 类型 | 说明 |
|------|------|------|
| `key` | string | 对象存储 Key,查询参数 |
响应:
- HTTP 302,`Location` 头指向 CDN URL
- 400:缺少 key 参数
- 500:生成下载链接失败
### WebSocket 消息格式
连接路径:`ws://host/api/v1/tasks/:taskId/ws`(通过 httpOnly Cookie 自动携带认证信息)