feat: async task pipeline for media and llm workflows

docs/API.md

@@ -75,7 +75,7 @@
 | 类型 | Mutation |
 | 认证 | **需认证** |
 | 输入 | `{ skillLevel: enum, durationDays: number, focusAreas?: string[] }` |
-| 输出 | `{ planId: number, plan: TrainingPlanData }` |
+| 输出 | `{ taskId: string, task: BackgroundTask }` |
 
 **输入验证：**
 - `skillLevel`：`"beginner"` / `"intermediate"` / `"advanced"`
@@ -105,7 +105,7 @@
 | 类型 | Mutation |
 | 认证 | **需认证** |
 | 输入 | `{ planId: number }` |
-| 输出 | `{ success: true, adjustmentNotes: string }` |
+| 输出 | `{ taskId: string, task: BackgroundTask }` |
 
 ---
 
@@ -187,8 +187,10 @@
 |------|-----|
 | 类型 | Mutation |
 | 认证 | **需认证** |
-| 输入 | `{ poseMetrics: object, exerciseType: string, detectedIssues: array }` |
-| 输出 | `{ corrections: string }` |
+| 输入 | `{ poseMetrics: object, exerciseType: string, detectedIssues: array, imageUrls?: string[], imageDataUrls?: string[] }` |
+| 输出 | `{ taskId: string, task: BackgroundTask }` |
+
+该接口始终走后台任务。若提供 `imageUrls` 或 `imageDataUrls`，服务端会优先走多模态纠正链路，并把相对地址规范化为可公网访问的绝对 URL。
 
 #### `analysis.list` - 获取用户所有分析记录
 
@@ -211,6 +213,48 @@
 
 ### 6. 训练记录模块 (`record`)
 
+### 5.1 后台任务模块 (`task`)
+
+#### `task.list` - 获取当前用户后台任务
+
+| 属性 | 值 |
+|------|-----|
+| 类型 | Query |
+| 认证 | **需认证** |
+| 输入 | `{ limit?: number }` |
+| 输出 | `BackgroundTask[]` |
+
+#### `task.get` - 获取单个后台任务
+
+| 属性 | 值 |
+|------|-----|
+| 类型 | Query |
+| 认证 | **需认证** |
+| 输入 | `{ taskId: string }` |
+| 输出 | `BackgroundTask | null` |
+
+#### `task.retry` - 重试失败任务
+
+| 属性 | 值 |
+|------|-----|
+| 类型 | Mutation |
+| 认证 | **需认证** |
+| 输入 | `{ taskId: string }` |
+| 输出 | `{ task: BackgroundTask }` |
+
+#### `task.createMediaFinalize` - 提交录制归档后台任务
+
+| 属性 | 值 |
+|------|-----|
+| 类型 | Mutation |
+| 认证 | **需认证** |
+| 输入 | `{ sessionId: string, title: string, exerciseType?: string }` |
+| 输出 | `{ taskId: string, task: BackgroundTask }` |
+
+该接口会校验媒体会话所属用户，并由后台 worker 轮询 Go 媒体服务状态，归档完成后自动登记到视频库。
+
+### 6. 训练记录模块 (`record`)
+
 #### `record.create` - 创建训练记录
 
 | 属性 | 值 |