stage 1

internal/config/loader.go

@@ -94,6 +94,9 @@ func applyHubDefaults(h *HubConfig) {
 	} else {
 		h.Module = strings.ToLower(trimmed)
 	}
+	if rollout := strings.TrimSpace(h.Rollout); rollout != "" {
+		h.Rollout = strings.ToLower(rollout)
+	}
 	if h.ValidationMode == "" {
 		h.ValidationMode = string(hubmodule.ValidationModeETag)
 	}

internal/config/modules.go

@@ -1,3 +1,8 @@
 package config
 
-import _ "github.com/any-hub/any-hub/internal/hubmodule/legacy"
+import (
+	_ "github.com/any-hub/any-hub/internal/hubmodule/docker"
+	_ "github.com/any-hub/any-hub/internal/hubmodule/legacy"
+	_ "github.com/any-hub/any-hub/internal/hubmodule/npm"
+	_ "github.com/any-hub/any-hub/internal/hubmodule/pypi"
+)

internal/config/runtime.go

@@ -1,7 +1,10 @@
 package config
 
 import (
+	"time"
+
 	"github.com/any-hub/any-hub/internal/hubmodule"
+	"github.com/any-hub/any-hub/internal/hubmodule/legacy"
 )
 
 // HubRuntime 将 Hub 配置与模块元数据合并，方便运行时快速取用策略。
@@ -9,17 +12,16 @@ type HubRuntime struct {
 	Config        HubConfig
 	Module        hubmodule.ModuleMetadata
 	CacheStrategy hubmodule.CacheStrategyProfile
+	Rollout       legacy.RolloutFlag
 }
 
-// BuildHubRuntime 根据 Hub 配置和模块元数据创建运行时描述。
-func BuildHubRuntime(cfg HubConfig, meta hubmodule.ModuleMetadata) HubRuntime {
-	strategy := hubmodule.ResolveStrategy(meta, hubmodule.StrategyOptions{
-		TTLOverride:        cfg.CacheTTL.DurationValue(),
-		ValidationOverride: hubmodule.ValidationMode(cfg.ValidationMode),
-	})
+// BuildHubRuntime 根据 Hub 配置和模块元数据创建运行时描述，应用最终 TTL 覆盖。
+func BuildHubRuntime(cfg HubConfig, meta hubmodule.ModuleMetadata, ttl time.Duration, flag legacy.RolloutFlag) HubRuntime {
+	strategy := hubmodule.ResolveStrategy(meta, cfg.StrategyOverrides(ttl))
 	return HubRuntime{
 		Config:        cfg,
 		Module:        meta,
 		CacheStrategy: strategy,
+		Rollout:       flag,
 	}
 }

internal/config/runtime_flags.go

@@ -0,0 +1,62 @@
+package config
+
+import (
+	"fmt"
+	"strings"
+
+	"github.com/any-hub/any-hub/internal/hubmodule"
+	"github.com/any-hub/any-hub/internal/hubmodule/legacy"
+)
+
+// parseRolloutFlag 将配置中的 rollout 字段标准化，并结合模块类型输出最终状态。
+func parseRolloutFlag(raw string, moduleKey string) (legacy.RolloutFlag, error) {
+	normalized := strings.ToLower(strings.TrimSpace(raw))
+	if normalized == "" {
+		return defaultRolloutFlag(moduleKey), nil
+	}
+
+	switch normalized {
+	case string(legacy.RolloutLegacyOnly):
+		return legacy.RolloutLegacyOnly, nil
+	case string(legacy.RolloutDual):
+		if moduleKey == hubmodule.DefaultModuleKey() {
+			return legacy.RolloutLegacyOnly, nil
+		}
+		return legacy.RolloutDual, nil
+	case string(legacy.RolloutModular):
+		if moduleKey == hubmodule.DefaultModuleKey() {
+			return legacy.RolloutLegacyOnly, nil
+		}
+		return legacy.RolloutModular, nil
+	default:
+		return "", fmt.Errorf("不支持的 rollout 值: %s", raw)
+	}
+}
+
+func defaultRolloutFlag(moduleKey string) legacy.RolloutFlag {
+	if strings.TrimSpace(moduleKey) == "" || moduleKey == hubmodule.DefaultModuleKey() {
+		return legacy.RolloutLegacyOnly
+	}
+	return legacy.RolloutModular
+}
+
+// EffectiveModuleKey 根据 rollout 状态计算真实运行的模块。
+func EffectiveModuleKey(moduleKey string, flag legacy.RolloutFlag) string {
+	if flag == legacy.RolloutLegacyOnly {
+		return hubmodule.DefaultModuleKey()
+	}
+	normalized := strings.ToLower(strings.TrimSpace(moduleKey))
+	if normalized == "" {
+		return hubmodule.DefaultModuleKey()
+	}
+	return normalized
+}
+
+// RolloutFlagValue 返回当前 Hub 的 rollout flag（假定 Validate 已经通过）。
+func (h HubConfig) RolloutFlagValue() legacy.RolloutFlag {
+	flag := legacy.RolloutFlag(strings.ToLower(strings.TrimSpace(h.Rollout)))
+	if flag == "" {
+		return defaultRolloutFlag(h.Module)
+	}
+	return flag
+}

internal/config/types.go

@@ -5,6 +5,8 @@ import (
 	"strconv"
 	"strings"
 	"time"
+
+	"github.com/any-hub/any-hub/internal/hubmodule"
 )
 
 // Duration 提供更灵活的反序列化能力，同时兼容纯秒整数与 Go Duration 字符串。
@@ -68,6 +70,7 @@ type HubConfig struct {
 	Proxy           string   `mapstructure:"Proxy"`
 	Type            string   `mapstructure:"Type"`
 	Module          string   `mapstructure:"Module"`
+	Rollout         string   `mapstructure:"Rollout"`
 	Username        string   `mapstructure:"Username"`
 	Password        string   `mapstructure:"Password"`
 	CacheTTL        Duration `mapstructure:"CacheTTL"`
@@ -105,3 +108,14 @@ func CredentialModes(hubs []HubConfig) []string {
 	}
 	return result
 }
+
+// StrategyOverrides 将 hub 层的 TTL/Validation 配置映射为模块策略覆盖项。
+func (h HubConfig) StrategyOverrides(ttl time.Duration) hubmodule.StrategyOptions {
+	opts := hubmodule.StrategyOptions{
+		TTLOverride: ttl,
+	}
+	if mode := strings.TrimSpace(h.ValidationMode); mode != "" {
+		opts.ValidationOverride = hubmodule.ValidationMode(mode)
+	}
+	return opts
+}

internal/config/validation.go

@@ -84,6 +84,11 @@ func (c *Config) Validate() error {
 			return newFieldError(hubField(hub.Name, "Module"), fmt.Sprintf("未注册模块: %s", moduleKey))
 		}
 		hub.Module = moduleKey
+		flag, err := parseRolloutFlag(hub.Rollout, hub.Module)
+		if err != nil {
+			return newFieldError(hubField(hub.Name, "Rollout"), err.Error())
+		}
+		hub.Rollout = string(flag)
 		if hub.ValidationMode != "" {
 			mode := strings.ToLower(strings.TrimSpace(hub.ValidationMode))
 			switch mode {