fix(sharecode): 支持分享码TTL配置并限制每MAC分享码数

- 配置增加 ShareCodeMaxPerMac 和 ShareCodeTTLMin 参数
- ShareCodeCache 支持自定义分享码有效期 TTL
- 生成分享码时使用配置的 TTL 替代固定30分钟
- 共享码处理添加限制，同一MAC有效分享码数量限制
- 路由层、处理器层和任务调度中增加TTL及限额参数传递
- 同步脚本默认同步路径调整，去除默认同步Docker文件，增加docs目录同步
- 修正上传脚本拼接远程路径时尾部斜杠问题

internal/handler/share_code.go

@@ -12,12 +12,13 @@ import (
 )
 
 type ShareCodeHandler struct {
-	cache *cache.ShareCodeCache
-	log   *zap.Logger
+	cache     *cache.ShareCodeCache
+	log       *zap.Logger
+	maxPerMac int
 }
 
-func NewShareCodeHandler(shareCache *cache.ShareCodeCache, log *zap.Logger) *ShareCodeHandler {
-	return &ShareCodeHandler{cache: shareCache, log: log}
+func NewShareCodeHandler(shareCache *cache.ShareCodeCache, log *zap.Logger, maxPerMac int) *ShareCodeHandler {
+	return &ShareCodeHandler{cache: shareCache, log: log, maxPerMac: maxPerMac}
 }
 
 // ExportShareCode 导出分享码
@@ -69,6 +70,25 @@ func (h *ShareCodeHandler) ExportShareCode(c *gin.Context) {
 	}
 
 	ctx := c.Request.Context()
+
+	// 限制同一 MAC 在有效期内的分享码数量
+	existing, err := h.cache.ListByMac(ctx, mac)
+	if err != nil {
+		h.log.Error("check existing share codes by mac failed", zap.String("mac", mac), zap.Error(err))
+		c.JSON(http.StatusOK, gin.H{
+			"code": 500,
+			"msg":  "系统错误",
+		})
+		return
+	}
+	if len(existing) >= h.maxPerMac {
+		c.JSON(http.StatusOK, gin.H{
+			"code": 0,
+			"msg":  "已有未过期的分享码，请稍后再试",
+		})
+		return
+	}
+
 	data, err := h.cache.Create(ctx, mac, clientIP, []byte(eqDataRaw))
 	if err != nil {
 		h.log.Error("create share code failed", zap.Error(err))