feat(share): 新增 shareList 接口 + 分享码模块全链路优化

- 新增 GET /audio/shareList?mac=xx 查询未过期分享码（纯 Redis，ZSET 索引）
- share:mac:{mac} 从 SET 改为 ZSET（score=expire_at），支持 ZREMRANGEBYSCORE 精确过期清理
- 空 ZSET 自动 DEL，避免 key 累积
- share:import:pending 增加 12h 兜底 TTL，防止 DB 不可用时内存泄漏
- 导入日志 field 改为 mac:code（去掉 nanotime），同 MAC+code 多次导入幂等去重
- MarkPersisted 保存/恢复 PTTL，防御性编程
- shareCreate 改为 POST + JSON body
- 全量 handler 补充 Swagger 注释，集成 swag 文档生成
- Makefile 使用 $(go env GOPATH)/bin/swag 解决 PATH 问题

internal/handler/model_csv.go

@@ -29,18 +29,18 @@ func NewModelCSVHandler(s3 *storage.S3Storage, log *zap.Logger) *ModelCSVHandler
 
 // GetModelCSV 从 S3 读取耳机 CSV 频响数据
 //
-//	@Summary	获取耳机原始频响 CSV 数据
+//	@Summary		获取耳机原始频响 CSV 数据
 //	@Description	从 S3 读取指定机型的测量 CSV 数据，返回 frequency 和 raw 数组
-//	@Tags		Curve
-//	@Produce	json
-//	@Param		brand		query		string	true	"品牌名称"
-//	@Param		model		query		string	true	"型号名称"
-//	@Param		form		query		string	true	"耳机类型 (in-ear/over-ear)"
-//	@Param		base64Resp	query		string	false	"是否返回 base64 编码响应"
-//	@Success	200			{object}	map[string]any	"成功返回 frequency 和 raw 数组"
-//	@Failure	400			{object}	map[string]any	"参数校验失败"
-//	@Failure	500			{object}	object
-//	@Router		/audio/getModelCSV [get]
+//	@Tags			Curve
+//	@Produce		json
+//	@Param			brand		query		string			true	"品牌名称"
+//	@Param			model		query		string			true	"型号名称"
+//	@Param			form		query		string			true	"耳机类型 (in-ear/over-ear)"
+//	@Param			base64Resp	query		string			false	"是否返回 base64 编码响应"
+//	@Success		200			{object}	map[string]any	"成功返回 frequency 和 raw 数组"
+//	@Failure		400			{object}	map[string]any	"参数校验失败"
+//	@Failure		500			{object}	object
+//	@Router			/audio/getModelCSV [get]
 //
 // GET /audio/getModelCSV?brand=Abyss&model=Dinan DZ&form=over-ear&base64Resp=true
 func (h *ModelCSVHandler) GetModelCSV(c *gin.Context) {