feat: swag.

controllers/ai.go

@@ -283,6 +283,23 @@ func callAIForAnalysis(prompt string) (*aiAnalysisResult, error) {
 	}, nil
 }
 
+// @Summary AI分析
+// @Description 上传心率CSV和教案文件，通过AI生成课堂分析报告，支持流式和非流式输出
+// @Tags AI分析
+// @Accept multipart/form-data
+// @Produce json
+// @Param heart_rate_data formData file true "心率数据CSV文件"
+// @Param step_data formData file false "步数数据CSV文件(analysis_type为heart_rate_with_steps时必填)"
+// @Param teaching_plan formData file false "教案DOCX文件(teaching_plan_source为upload/wechat时必填)"
+// @Param analysis_type formData string false "分析类型: heart_rate_only(默认) | heart_rate_with_steps"
+// @Param teaching_plan_source formData string false "教案来源: upload(默认) | cloud | wechat"
+// @Param regionid formData string false "区域ID"
+// @Param trainid formData string false "训练ID"
+// @Param lesson_plan_id formData string false "云端教案ID(teaching_plan_source=cloud时必填)"
+// @Param stream formData string false "是否流式输出: true | false"
+// @Success 200 {object} SwagAPIResponse "分析成功"
+// @Failure 400 {object} SwagAPIResponse "请求参数错误"
+// @Router /train-records/analysis-by-ai [post]
 func (tc *TrainingController) AnalyzeByAI(c *gin.Context) {
 	form, err := c.MultipartForm()
 	if err != nil {