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/ota.go

@@ -22,18 +22,18 @@ func NewOTAHandler(repo *repository.OTARepository, log *zap.Logger) *OTAHandler
 
 // GetOTA 获取 OTA 升级信息
 //
-//	@Summary	获取 OTA 升级信息
+//	@Summary		获取 OTA 升级信息
 //	@Description	根据设备型号和硬件版本查询最新 OTA 记录，支持黑名单过滤和定向升级逻辑
-//	@Tags		OTA
-//	@Produce	json
-//	@Param		model	query		string	true	"设备型号"
-//	@Param		hw		query		int		true	"硬件版本"
-//	@Param		mac		query		string	false	"设备 MAC 地址"
-//	@Param		beta	query		int		false	"是否 beta 通道 (0=否,1=是)"
-//	@Success	200		{object}	object	"成功返回 OTA 信息"
-//	@Failure	400		{object}	object
-//	@Failure	500		{object}	object
-//	@Router		/audio/ota [get]
+//	@Tags			OTA
+//	@Produce		json
+//	@Param			model	query		string	true	"设备型号"
+//	@Param			hw		query		int		true	"硬件版本"
+//	@Param			mac		query		string	false	"设备 MAC 地址"
+//	@Param			beta	query		int		false	"是否 beta 通道 (0=否,1=是)"
+//	@Success		200		{object}	object	"成功返回 OTA 信息"
+//	@Failure		400		{object}	object
+//	@Failure		500		{object}	object
+//	@Router			/audio/ota [get]
 func (h *OTAHandler) GetOTA(c *gin.Context) {
 	modelVal := strings.TrimSpace(c.Query("model"))
 	hwStr := strings.TrimSpace(c.Query("hw"))