重构对话框组件，使用 React.forwardRef 优化 DialogOverlay 和 DialogContent 的实现，提升代码可读性和可维护性。同时，更新 ReferralSettingsPage 和 SettingsPage 以使用新的 API 路径，确保数据获取和保存逻辑的一致性，增强用户体验。

soul-api/internal/handler/db.go

@@ -122,6 +122,167 @@ func DBConfigGet(c *gin.Context) {
 	c.JSON(http.StatusOK, gin.H{"success": true, "data": data})
 }
 
+// AdminSettingsGet GET /api/admin/settings 系统设置页专用：仅返回免费章节、功能开关、站点/作者与价格
+func AdminSettingsGet(c *gin.Context) {
+	db := database.DB()
+	out := gin.H{
+		"success":       true,
+		"freeChapters":  []string{"preface", "epilogue", "1.1", "appendix-1", "appendix-2", "appendix-3"},
+		"featureConfig": gin.H{"matchEnabled": true, "referralEnabled": true, "searchEnabled": true, "aboutEnabled": true},
+		"siteSettings":  gin.H{"sectionPrice": float64(1), "baseBookPrice": 9.9, "distributorShare": float64(90), "authorInfo": gin.H{}},
+	}
+	keys := []string{"free_chapters", "feature_config", "site_settings"}
+	for _, k := range keys {
+		var row model.SystemConfig
+		if err := db.Where("config_key = ?", k).First(&row).Error; err != nil {
+			continue
+		}
+		var val interface{}
+		if err := json.Unmarshal(row.ConfigValue, &val); err != nil {
+			continue
+		}
+		switch k {
+		case "free_chapters":
+			if arr, ok := val.([]interface{}); ok && len(arr) > 0 {
+				ss := make([]string, 0, len(arr))
+				for _, x := range arr {
+					if s, ok := x.(string); ok {
+						ss = append(ss, s)
+					}
+				}
+				if len(ss) > 0 {
+					out["freeChapters"] = ss
+				}
+			}
+		case "feature_config":
+			if m, ok := val.(map[string]interface{}); ok && len(m) > 0 {
+				out["featureConfig"] = m
+			}
+		case "site_settings":
+			if m, ok := val.(map[string]interface{}); ok && len(m) > 0 {
+				out["siteSettings"] = m
+			}
+		}
+	}
+	c.JSON(http.StatusOK, out)
+}
+
+// AdminSettingsPost POST /api/admin/settings 系统设置页专用：一次性保存免费章节、功能开关、站点/作者与价格（不包含小程序配置，该配置已移除）
+func AdminSettingsPost(c *gin.Context) {
+	var body struct {
+		FreeChapters  []string               `json:"freeChapters"`
+		FeatureConfig map[string]interface{} `json:"featureConfig"`
+		SiteSettings  map[string]interface{} `json:"siteSettings"`
+	}
+	if err := c.ShouldBindJSON(&body); err != nil {
+		c.JSON(http.StatusOK, gin.H{"success": false, "error": "请求体无效"})
+		return
+	}
+	db := database.DB()
+	saveKey := func(key, desc string, value interface{}) error {
+		valBytes, err := json.Marshal(value)
+		if err != nil {
+			return err
+		}
+		var row model.SystemConfig
+		err = db.Where("config_key = ?", key).First(&row).Error
+		if err != nil {
+			row = model.SystemConfig{ConfigKey: key, ConfigValue: valBytes, Description: &desc}
+			return db.Create(&row).Error
+		}
+		row.ConfigValue = valBytes
+		if desc != "" {
+			row.Description = &desc
+		}
+		return db.Save(&row).Error
+	}
+	if body.FreeChapters != nil {
+		if err := saveKey("free_chapters", "免费章节ID列表", body.FreeChapters); err != nil {
+			c.JSON(http.StatusOK, gin.H{"success": false, "error": "保存免费章节失败: " + err.Error()})
+			return
+		}
+	}
+	if body.FeatureConfig != nil {
+		if err := saveKey("feature_config", "功能开关配置", body.FeatureConfig); err != nil {
+			c.JSON(http.StatusOK, gin.H{"success": false, "error": "保存功能开关失败: " + err.Error()})
+			return
+		}
+	}
+	if body.SiteSettings != nil {
+		if err := saveKey("site_settings", "站点与作者配置", body.SiteSettings); err != nil {
+			c.JSON(http.StatusOK, gin.H{"success": false, "error": "保存站点设置失败: " + err.Error()})
+			return
+		}
+	}
+	c.JSON(http.StatusOK, gin.H{"success": true, "message": "设置已保存"})
+}
+
+// AdminReferralSettingsGet GET /api/admin/referral-settings 推广设置页专用：仅返回 referral_config
+func AdminReferralSettingsGet(c *gin.Context) {
+	db := database.DB()
+	defaultConfig := gin.H{
+		"distributorShare":   float64(90),
+		"minWithdrawAmount":  float64(10),
+		"bindingDays":       float64(30),
+		"userDiscount":      float64(5),
+		"enableAutoWithdraw": false,
+	}
+	var row model.SystemConfig
+	if err := db.Where("config_key = ?", "referral_config").First(&row).Error; err != nil {
+		c.JSON(http.StatusOK, gin.H{"success": true, "data": defaultConfig})
+		return
+	}
+	var val map[string]interface{}
+	if err := json.Unmarshal(row.ConfigValue, &val); err != nil || len(val) == 0 {
+		c.JSON(http.StatusOK, gin.H{"success": true, "data": defaultConfig})
+		return
+	}
+	c.JSON(http.StatusOK, gin.H{"success": true, "data": val})
+}
+
+// AdminReferralSettingsPost POST /api/admin/referral-settings 推广设置页专用：仅保存 referral_config（请求体为完整配置对象）
+func AdminReferralSettingsPost(c *gin.Context) {
+	var body struct {
+		DistributorShare   float64 `json:"distributorShare"`
+		MinWithdrawAmount  float64 `json:"minWithdrawAmount"`
+		BindingDays        float64 `json:"bindingDays"`
+		UserDiscount       float64 `json:"userDiscount"`
+		EnableAutoWithdraw bool    `json:"enableAutoWithdraw"`
+	}
+	if err := c.ShouldBindJSON(&body); err != nil {
+		c.JSON(http.StatusOK, gin.H{"success": false, "error": "请求体无效"})
+		return
+	}
+	val := gin.H{
+		"distributorShare":   body.DistributorShare,
+		"minWithdrawAmount":  body.MinWithdrawAmount,
+		"bindingDays":        body.BindingDays,
+		"userDiscount":       body.UserDiscount,
+		"enableAutoWithdraw": body.EnableAutoWithdraw,
+	}
+	valBytes, err := json.Marshal(val)
+	if err != nil {
+		c.JSON(http.StatusOK, gin.H{"success": false, "error": err.Error()})
+		return
+	}
+	db := database.DB()
+	desc := "分销 / 推广规则配置"
+	var row model.SystemConfig
+	if err := db.Where("config_key = ?", "referral_config").First(&row).Error; err != nil {
+		row = model.SystemConfig{ConfigKey: "referral_config", ConfigValue: valBytes, Description: &desc}
+		err = db.Create(&row).Error
+	} else {
+		row.ConfigValue = valBytes
+		row.Description = &desc
+		err = db.Save(&row).Error
+	}
+	if err != nil {
+		c.JSON(http.StatusOK, gin.H{"success": false, "error": err.Error()})
+		return
+	}
+	c.JSON(http.StatusOK, gin.H{"success": true, "message": "推广设置已保存"})
+}
+
 // DBConfigPost POST /api/db/config
 func DBConfigPost(c *gin.Context) {
 	var body struct {

soul-api/internal/router/router.go

@@ -59,6 +59,10 @@ func Setup(cfg *config.Config) *gin.Engine {
 			admin.DELETE("/referral", handler.AdminReferral)
 			admin.GET("/withdrawals", handler.AdminWithdrawalsList)
 			admin.PUT("/withdrawals", handler.AdminWithdrawalsAction)
+			admin.GET("/settings", handler.AdminSettingsGet)
+			admin.POST("/settings", handler.AdminSettingsPost)
+			admin.GET("/referral-settings", handler.AdminReferralSettingsGet)
+			admin.POST("/referral-settings", handler.AdminReferralSettingsPost)
 		}
 
 		// ----- 鉴权 -----