feat(voice): add async selectable summaries

server/API.md

@@ -52,7 +52,7 @@ TENCENT_CLOUD_ASR_SECRET_KEY=your-secret-key
 TENCENT_CLOUD_ASR_ENGINE_TYPE=16k_zh
 ```
 
-反馈汇总支持可选的 OpenAI 兼容 Chat Completions 接口。未配置时使用本地抽取式汇总，录音转录和保存流程仍可工作：
+反馈汇总支持可选的 OpenAI 兼容 Chat Completions 接口。配置后，后台任务按“片段事实提取 -> 单次录音压缩 -> 全部所选录音统一改写”处理，最终只返回一份不按录音次数分栏的正文。未配置时使用本地抽取式汇总，录音转录和保存流程仍可工作：
 
 ```text
 FEEDBACK_SUMMARY_API_URL=https://api.example.com/v1/chat/completions
@@ -103,7 +103,12 @@ Authorization: Bearer <access-token>
 | `POST` | `/api/v1/feedback-lessons/{lesson_id}/mark-applied` | 标记该节转写已手动加入反馈。 |
 | `POST` | `/api/v1/audio-segments/{segment_id}/retry` | 重试失败片段的转录。 |
 | `DELETE` | `/api/v1/audio-segments/{segment_id}` | 放弃失败片段；空课堂会一并删除。 |
-| `POST` | `/api/v1/feedback-sessions/{session_id}/generate` | 汇总多节转录并生成反馈正文。 |
+| `POST` | `/api/v1/feedback-sessions/{session_id}/summary-runs` | 选择已就绪录音并创建异步总结任务。 |
+| `GET` | `/api/v1/feedback-summary-runs/{run_id}` | 查询总结状态和预览正文。 |
+| `POST` | `/api/v1/feedback-summary-runs/{run_id}/apply` | 确认后用预览正文替换反馈草稿。 |
+| `POST` | `/api/v1/feedback-sessions/{session_id}/generate` | 旧版同步汇总接口，仅保留客户端兼容。 |
+
+总结任务使用请求中的 `idempotency_key` 防止重复点击创建重复任务。`queued` 和 `processing` 状态由 API 内的持久化 worker 自动恢复；生成完成进入 `ready`，此时尚未修改反馈草稿。只有调用 `/apply` 后才进入 `applied` 并替换草稿。原始转录不限制为 2000 字，只有最终反馈正文和输入框受 2000 字限制。
 
 ### 创建学生档案