feat: 完善知识库预览功能与配置管理优化

server/src/app/core/config.py

@@ -1,22 +1,32 @@
-from __future__ import annotations
-
-from functools import lru_cache
-from os import environ
-from pathlib import Path
-
-from pydantic import Field
-from pydantic_settings import BaseSettings, SettingsConfigDict
-
-SERVER_DIR = Path(__file__).resolve().parents[3]
-ROOT_DIR = SERVER_DIR.parent
+from __future__ import annotations
+
+from os import environ
+from pathlib import Path
+
+from dotenv import dotenv_values
+from pydantic import Field
+from pydantic_settings import BaseSettings, SettingsConfigDict
+
+SERVER_DIR = Path(__file__).resolve().parents[3]
+ROOT_DIR = SERVER_DIR.parent
+DEFAULT_ENV_FILES = (ROOT_DIR / ".env", SERVER_DIR / ".env")
+ONLYOFFICE_FIELD_NAMES = {
+    "ONLYOFFICE_ENABLED": "onlyoffice_enabled",
+    "ONLYOFFICE_PUBLIC_URL": "onlyoffice_public_url",
+    "ONLYOFFICE_BACKEND_URL": "onlyoffice_backend_url",
+    "ONLYOFFICE_JWT_SECRET": "onlyoffice_jwt_secret",
+}
+
+_settings_cache: Settings | None = None
+_settings_cache_signature: tuple[tuple[str, bool, int | None, int | None], ...] | None = None
 
 
-class Settings(BaseSettings):
-    model_config = SettingsConfigDict(
-        env_file=(ROOT_DIR / ".env", SERVER_DIR / ".env"),
-        env_file_encoding="utf-8",
-        extra="ignore",
-    )
+class Settings(BaseSettings):
+    model_config = SettingsConfigDict(
+        env_file=DEFAULT_ENV_FILES,
+        env_file_encoding="utf-8",
+        extra="ignore",
+    )
 
     app_name: str = Field(default="X-Financial Server", alias="APP_NAME")
     app_env: str = Field(default="local", alias="APP_ENV")
@@ -73,16 +83,80 @@ class Settings(BaseSettings):
         if not path.is_absolute():
             path = SERVER_DIR / path
         return path.resolve()
-
-
-@lru_cache
-def get_settings() -> Settings:
-    return Settings()
-
-
-def refresh_settings(updated_values: dict[str, str]) -> Settings:
-    for key, value in updated_values.items():
-        environ[key] = value
-
-    get_settings.cache_clear()
-    return get_settings()
+
+def _resolve_env_files() -> tuple[Path, ...]:
+    env_files = Settings.model_config.get("env_file") or ()
+    return tuple(Path(item) for item in env_files)
+
+
+def _build_settings_signature() -> tuple[tuple[str, bool, int | None, int | None], ...]:
+    signature: list[tuple[str, bool, int | None, int | None]] = []
+
+    for env_file in _resolve_env_files():
+        if not env_file.exists():
+            signature.append((str(env_file), False, None, None))
+            continue
+
+        stat = env_file.stat()
+        signature.append((str(env_file), True, stat.st_mtime_ns, stat.st_size))
+
+    return tuple(signature)
+
+
+def _parse_onlyoffice_enabled(value: object) -> bool:
+    return str(value).strip().lower() in {"1", "true", "yes", "on"}
+
+
+def _load_onlyoffice_env_file_overrides() -> dict[str, object]:
+    overrides: dict[str, object] = {}
+
+    for env_file in _resolve_env_files():
+        if not env_file.exists():
+            continue
+
+        values = dotenv_values(env_file)
+        for alias, field_name in ONLYOFFICE_FIELD_NAMES.items():
+            if alias not in values:
+                continue
+
+            value = values[alias]
+            if field_name == "onlyoffice_enabled":
+                overrides[field_name] = _parse_onlyoffice_enabled(value)
+            else:
+                overrides[field_name] = "" if value is None else str(value)
+
+    return overrides
+
+
+def _clear_settings_cache() -> None:
+    global _settings_cache, _settings_cache_signature
+
+    _settings_cache = None
+    _settings_cache_signature = None
+
+
+def get_settings() -> Settings:
+    global _settings_cache, _settings_cache_signature
+
+    signature = _build_settings_signature()
+    if _settings_cache is None or _settings_cache_signature != signature:
+        settings = Settings()
+        onlyoffice_overrides = _load_onlyoffice_env_file_overrides()
+        if onlyoffice_overrides:
+            settings = settings.model_copy(update=onlyoffice_overrides)
+
+        _settings_cache = settings
+        _settings_cache_signature = signature
+
+    return _settings_cache
+
+
+get_settings.cache_clear = _clear_settings_cache  # type: ignore[attr-defined]
+
+
+def refresh_settings(updated_values: dict[str, str]) -> Settings:
+    for key, value in updated_values.items():
+        environ[key] = value
+
+    get_settings.cache_clear()
+    return get_settings()