Merge branch 'develop' of gitee.com:hezhaohui123/gen2d into feat/async-generate-pipeline

Signed-off-by: 何朝晖 <hezhaohui0807@163.com>

docs/api.md

@@ -300,7 +300,7 @@ POST /api/v1/prompt/optimize
 
 ### DELETE /api/v1/projects/:projectId
 
-级联删除工程下的所有任务、素材及本地文件。
+级联删除工程下的所有任务、素材及七牛云对象。
 
 响应：
 
@@ -368,10 +368,11 @@ POST /api/v1/prompt/optimize
 
 | 状态 | 方法 | 路径 | 说明 |
 |------|------|------|------|
-| [ ] | POST | `/api/v1/generate` | 提交生成任务，返回 taskId |
-| [ ] | GET | `/api/v1/tasks/:taskId` | 查询任务状态与进度 |
-| [ ] | GET | `/api/v1/tasks/:taskId/assets` | 获取生成结果（素材列表 + 元数据） |
+| [x] | POST | `/api/v1/generate` | 提交生成任务，返回 taskId |
+| [x] | GET | `/api/v1/tasks/:taskId` | 查询任务状态与进度 |
+| [x] | 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 自动携带认证信息）