fix: add warning logs and named constants for max_retries validation

Author: Blueteemo

astrbot/core/provider/sources/openai_source.py

@@ -495,14 +495,29 @@ def __init__(self, provider_config, provider_settings) -> None:
 
         self.reasoning_key = "reasoning_content"
 
+    _MAX_RETRIES_DEFAULT = 10
+    _MAX_RETRIES_UPPER_BOUND = 50
+
     def _get_max_retries(self) -> int:
-        """获取并验证最大重试次数，确保为正整数。"""
-        raw = self.provider_config.get("max_retries", 10)
+        """获取并验证最大重试次数，确保为 1 到 _MAX_RETRIES_UPPER_BOUND 之间的整数。"""
+        raw = self.provider_config.get("max_retries", self._MAX_RETRIES_DEFAULT)
         try:
             value = int(raw)
         except (TypeError, ValueError):
-            return 10
-        return max(1, min(value, 50))
+            logger.warning(
+                "max_retries 配置无效 (%s)，使用默认值 %d。",
+                raw,
+                self._MAX_RETRIES_DEFAULT,
+            )
+            return self._MAX_RETRIES_DEFAULT
+        clamped = max(1, min(value, self._MAX_RETRIES_UPPER_BOUND))
+        if clamped != value:
+            logger.warning(
+                "max_retries 配置值 %d 超出范围，已调整为 %d。",
+                value,
+                clamped,
+            )
+        return clamped
 
     def _ollama_disable_thinking_enabled(self) -> bool:
         value = self.provider_config.get("ollama_disable_thinking", False)