新增分享码功能

internal/handler/curve.go

@@ -39,6 +39,19 @@ func NewCurveHandler(repo *repository.CurveRepository, curveCache *cache.CurveCa
 }
 
 // ModelCurve 获取机型默认曲线（固定 target: Harman over-ear 2018）
+//
+//	@Summary	获取机型默认频响曲线
+//	@Description	返回指定机型的频响曲线数据（fr），固定使用 Harman over-ear 2018 target
+//	@Tags		Curve
+//	@Produce	json
+//	@Param		brand		query		string	true	"品牌名称"
+//	@Param		name		query		string	true	"型号名称"
+//	@Param		base64Resp	query		string	false	"是否返回 base64 编码响应"
+//	@Success	200			{object}	map[string]any	"成功返回 fr 数据"
+//	@Failure	400			{object}	map[string]any	"参数校验失败"
+//	@Failure	500			{object}	object
+//	@Router		/audio/modelCurve [get]
+//
 // GET /audio/modelCurve?brand=xxx&name=xxx&base64Resp=true
 func (h *CurveHandler) ModelCurve(c *gin.Context) {
 	brand := strings.TrimSpace(queryParam(c, "brand"))
@@ -114,6 +127,20 @@ func (h *CurveHandler) ModelCurve(c *gin.Context) {
 }
 
 // GetCurve 获取目标曲线
+//
+//	@Summary	获取目标曲线参数化 EQ
+//	@Description	根据机型和目标曲线名称，计算并返回 parametric_eq 数据
+//	@Tags		Curve
+//	@Produce	json
+//	@Param		brand		query		string	true	"品牌名称"
+//	@Param		name		query		string	true	"型号名称"
+//	@Param		target		query		string	true	"目标曲线名称"
+//	@Param		base64Resp	query		string	false	"是否返回 base64 编码响应"
+//	@Success	200			{object}	map[string]any	"成功返回 parametric_eq 数据"
+//	@Failure	400			{object}	map[string]any	"参数校验失败"
+//	@Failure	500			{object}	object
+//	@Router		/audio/getCurve [get]
+//
 // GET /audio/getCurve?brand=xxx&name=xxx&target=xxx&base64Resp=true
 func (h *CurveHandler) GetCurve(c *gin.Context) {
 	brand := strings.TrimSpace(queryParam(c, "brand"))