Initial commit
This commit is contained in:
commit
57fc3525eb
7311 files changed
+1291398
No files matched your search
@@ -0,0 +1,364 @@
|
||||
"""
|
||||
app/core/config_parts/env_config.py - 环境变量与基础文件工具模块
|
||||
"""
|
||||
import os
|
||||
import json
|
||||
import tempfile
|
||||
import time
|
||||
from pathlib import Path
|
||||
from typing import Any, Dict, List, Optional
|
||||
|
||||
PROJECT_ROOT = Path(__file__).resolve().parents[3]
|
||||
DEFAULT_LOG_DIR = PROJECT_ROOT / "logs"
|
||||
|
||||
|
||||
def atomic_write_json(path: str | Path, payload: Any) -> None:
|
||||
"""Atomically write JSON to disk using a same-directory temporary file."""
|
||||
target = Path(path)
|
||||
target.parent.mkdir(parents=True, exist_ok=True)
|
||||
fd = None
|
||||
tmp_path: Optional[Path] = None
|
||||
|
||||
try:
|
||||
fd, tmp_name = tempfile.mkstemp(
|
||||
prefix=f".{target.name}.",
|
||||
suffix=".tmp",
|
||||
dir=str(target.parent),
|
||||
)
|
||||
tmp_path = Path(tmp_name)
|
||||
with os.fdopen(fd, "w", encoding="utf-8", newline="\n") as f:
|
||||
fd = None
|
||||
json.dump(payload, f, indent=2, ensure_ascii=False)
|
||||
f.write("\n")
|
||||
f.flush()
|
||||
os.fsync(f.fileno())
|
||||
_replace_file_with_retry(tmp_path, target)
|
||||
except Exception:
|
||||
if fd is not None:
|
||||
try:
|
||||
os.close(fd)
|
||||
except Exception:
|
||||
pass
|
||||
if tmp_path is not None:
|
||||
try:
|
||||
tmp_path.unlink(missing_ok=True)
|
||||
except Exception:
|
||||
pass
|
||||
raise
|
||||
|
||||
|
||||
def _replace_file_with_retry(source: str | Path, dest: str | Path) -> None:
|
||||
"""Replace a file, retrying transient Windows sharing violations."""
|
||||
source_path = Path(source)
|
||||
dest_path = Path(dest)
|
||||
attempts = 3 if os.name == "nt" else 1
|
||||
delay = 0.02
|
||||
for attempt in range(attempts):
|
||||
try:
|
||||
os.replace(source_path, dest_path)
|
||||
return
|
||||
except PermissionError:
|
||||
if attempt >= attempts - 1:
|
||||
raise
|
||||
time.sleep(delay)
|
||||
delay *= 2
|
||||
|
||||
|
||||
class classproperty:
|
||||
"""Allow config access via both `AppConfig.X` and `app_config.X`."""
|
||||
|
||||
def __init__(self, fget):
|
||||
self.fget = fget
|
||||
|
||||
def __get__(self, obj, owner=None):
|
||||
return self.fget(owner)
|
||||
|
||||
|
||||
def load_dotenv(env_file: str = ".env", override: bool = False):
|
||||
"""
|
||||
手动加载 .env 文件(不依赖 python-dotenv)
|
||||
"""
|
||||
env_path = Path(env_file)
|
||||
if not env_path.exists():
|
||||
return
|
||||
|
||||
try:
|
||||
with open(env_path, 'r', encoding='utf-8') as f:
|
||||
for line in f:
|
||||
line = line.strip()
|
||||
if not line or line.startswith('#'):
|
||||
continue
|
||||
if '=' in line:
|
||||
key, _, value = line.partition('=')
|
||||
key = key.strip()
|
||||
value = value.strip()
|
||||
if (value.startswith('"') and value.endswith('"')) or \
|
||||
(value.startswith("'") and value.endswith("'")):
|
||||
value = value[1:-1]
|
||||
if key:
|
||||
if override or key not in os.environ:
|
||||
os.environ[key] = value
|
||||
except Exception as e:
|
||||
print(f"[Config] 加载 .env 失败: {e}")
|
||||
|
||||
|
||||
load_dotenv(override=os.getenv("UWAPI_DOTENV_OVERRIDE", "").lower() in ("1", "true", "yes", "on"))
|
||||
|
||||
|
||||
class AppConfig:
|
||||
"""应用配置(从环境变量读取)"""
|
||||
|
||||
@staticmethod
|
||||
def _env_bool(name: str, default: bool = False) -> bool:
|
||||
value = os.getenv(name)
|
||||
if value is None or str(value).strip() == "":
|
||||
return bool(default)
|
||||
return str(value).strip().lower() in ("true", "1", "yes", "on")
|
||||
|
||||
@staticmethod
|
||||
def _env_bool_secure(name: str, default: bool = False) -> bool:
|
||||
"""安全开关专用布尔解析(H1):值存在但不是合法布尔字面量时 fail-closed 返回 True。
|
||||
|
||||
兼容逻辑:若值为 3.0.0 模板自带的占位符 ``your-secret-here``,视为未设置(回退 default),
|
||||
避免因无令牌 fail-closed 开启认证导致接口与控制面板 500。
|
||||
"""
|
||||
value = os.getenv(name)
|
||||
if value is None or str(value).strip() == "":
|
||||
return bool(default)
|
||||
lowered = str(value).strip().lower()
|
||||
if lowered == "your-secret-here":
|
||||
return bool(default)
|
||||
if lowered in ("true", "1", "yes", "on"):
|
||||
return True
|
||||
if lowered in ("false", "0", "no", "off"):
|
||||
return False
|
||||
return True
|
||||
|
||||
@staticmethod
|
||||
def _env_int(name: str, default: int) -> int:
|
||||
"""安全读取整数环境变量:空值/非法值一律回落默认值,避免服务启动期崩溃。"""
|
||||
raw = os.getenv(name)
|
||||
if raw is None or str(raw).strip() == "":
|
||||
return int(default)
|
||||
try:
|
||||
return int(str(raw).strip())
|
||||
except (TypeError, ValueError):
|
||||
return int(default)
|
||||
|
||||
@staticmethod
|
||||
def _env_float(name: str, default: float) -> float:
|
||||
"""安全读取浮点环境变量:空值/非法值一律回落默认值,避免服务启动期崩溃。"""
|
||||
raw = os.getenv(name)
|
||||
if raw is None or str(raw).strip() == "":
|
||||
return float(default)
|
||||
try:
|
||||
return float(str(raw).strip())
|
||||
except (TypeError, ValueError):
|
||||
return float(default)
|
||||
|
||||
# ===== 服务配置 =====
|
||||
@staticmethod
|
||||
def get_host() -> str:
|
||||
return os.getenv("APP_HOST", "127.0.0.1")
|
||||
|
||||
@staticmethod
|
||||
def get_port() -> int:
|
||||
return AppConfig._env_int("APP_PORT", 8199)
|
||||
|
||||
@staticmethod
|
||||
def is_debug() -> bool:
|
||||
return os.getenv("APP_DEBUG", "false").lower() in ("true", "1", "yes")
|
||||
|
||||
@staticmethod
|
||||
def get_log_level() -> str:
|
||||
return os.getenv("LOG_LEVEL", "INFO").upper()
|
||||
|
||||
# ===== 认证配置 =====
|
||||
@staticmethod
|
||||
def is_auth_enabled() -> bool:
|
||||
return AppConfig._env_bool_secure("AUTH_ENABLED", False)
|
||||
|
||||
@staticmethod
|
||||
def get_auth_token() -> str:
|
||||
return os.getenv("AUTH_TOKEN", "").strip()
|
||||
|
||||
@staticmethod
|
||||
def is_dashboard_auth_enabled() -> bool:
|
||||
value = os.getenv("DASHBOARD_AUTH_ENABLED")
|
||||
if value is None or str(value).strip() == "":
|
||||
return AppConfig.is_auth_enabled()
|
||||
return AppConfig._env_bool_secure("DASHBOARD_AUTH_ENABLED", False)
|
||||
|
||||
@staticmethod
|
||||
def get_dashboard_auth_token() -> str:
|
||||
token = os.getenv("DASHBOARD_AUTH_TOKEN", "").strip()
|
||||
return token or AppConfig.get_auth_token()
|
||||
|
||||
# ===== CORS 配置 =====
|
||||
@staticmethod
|
||||
def is_cors_enabled() -> bool:
|
||||
return os.getenv("CORS_ENABLED", "true").lower() in ("true", "1", "yes")
|
||||
|
||||
@staticmethod
|
||||
def get_cors_origins() -> List[str]:
|
||||
"""S1:默认不放行任何跨源来源。
|
||||
|
||||
控制面板与 API 同源,本来就不需要 CORS;非浏览器客户端(SDK、curl、酒馆后端)
|
||||
不受 CORS 影响。需要浏览器跨源调用时请显式列出来源,``*`` 仍可显式配置但不推荐。
|
||||
"""
|
||||
from app.core.http_security import parse_cors_origins
|
||||
|
||||
return parse_cors_origins(os.getenv("CORS_ORIGINS", ""))
|
||||
|
||||
# ===== 浏览器配置 =====
|
||||
@staticmethod
|
||||
def get_browser_port() -> int:
|
||||
return AppConfig._env_int("BROWSER_PORT", 9222)
|
||||
|
||||
@staticmethod
|
||||
def is_auto_open_browser_enabled() -> bool:
|
||||
return AppConfig._env_bool("AUTO_OPEN_BROWSER", True)
|
||||
|
||||
# ===== Dashboard 配置 =====
|
||||
@staticmethod
|
||||
def is_dashboard_enabled() -> bool:
|
||||
return os.getenv("DASHBOARD_ENABLED", "true").lower() in ("true", "1", "yes")
|
||||
|
||||
@staticmethod
|
||||
def get_dashboard_file() -> str:
|
||||
return os.getenv("DASHBOARD_FILE", "static/index.html")
|
||||
|
||||
# ===== 定时服务重启守护 =====
|
||||
@staticmethod
|
||||
def is_scheduled_restart_enabled() -> bool:
|
||||
return AppConfig._env_bool("SCHEDULED_RESTART_ENABLED", False)
|
||||
|
||||
@staticmethod
|
||||
def get_scheduled_restart_interval_seconds() -> int:
|
||||
return max(60, AppConfig._env_int("SCHEDULED_RESTART_INTERVAL_SECONDS", 10800))
|
||||
|
||||
@staticmethod
|
||||
def get_scheduled_restart_drain_timeout_seconds() -> int:
|
||||
return max(0, AppConfig._env_int("SCHEDULED_RESTART_DRAIN_TIMEOUT_SECONDS", 1800))
|
||||
|
||||
@staticmethod
|
||||
def get_scheduled_restart_tab_state_policy() -> str:
|
||||
"""Reserved for future tab-state cleanup; preserve is currently the only policy."""
|
||||
return os.getenv("SCHEDULED_RESTART_TAB_STATE_POLICY", "preserve").strip().lower() or "preserve"
|
||||
|
||||
# ===== AI 分析配置 =====
|
||||
@staticmethod
|
||||
def get_helper_api_key() -> str:
|
||||
return os.getenv("HELPER_API_KEY", "")
|
||||
|
||||
@staticmethod
|
||||
def get_helper_base_url() -> str:
|
||||
return os.getenv("HELPER_BASE_URL", "")
|
||||
|
||||
@staticmethod
|
||||
def get_helper_model() -> str:
|
||||
return os.getenv("HELPER_MODEL", "gpt-4")
|
||||
|
||||
@staticmethod
|
||||
def get_helper_api_provider() -> str:
|
||||
return os.getenv("HELPER_API_PROVIDER", "auto").lower()
|
||||
|
||||
@staticmethod
|
||||
def get_max_html_chars() -> int:
|
||||
return AppConfig._env_int("MAX_HTML_CHARS", 120000)
|
||||
|
||||
@staticmethod
|
||||
def get_canvas_image_max_size() -> int:
|
||||
try:
|
||||
value = AppConfig._env_int("CANVAS_IMAGE_MAX_SIZE", 1024)
|
||||
except Exception:
|
||||
value = 1024
|
||||
return max(1, value)
|
||||
|
||||
# ===== 错误标签页 AI 恢复配置 =====
|
||||
@staticmethod
|
||||
def is_tab_recovery_enabled() -> bool:
|
||||
return AppConfig._env_bool("TAB_RECOVERY_ENABLED", False)
|
||||
|
||||
@staticmethod
|
||||
def get_tab_recovery_api_url() -> str:
|
||||
return os.getenv("TAB_RECOVERY_API_URL", "").strip()
|
||||
|
||||
@staticmethod
|
||||
def get_tab_recovery_api_key() -> str:
|
||||
return os.getenv("TAB_RECOVERY_API_KEY", "").strip()
|
||||
|
||||
@staticmethod
|
||||
def get_tab_recovery_model() -> str:
|
||||
return os.getenv("TAB_RECOVERY_MODEL", "gpt-4o").strip() or "gpt-4o"
|
||||
|
||||
@staticmethod
|
||||
def get_tab_recovery_max_attempts() -> int:
|
||||
try:
|
||||
value = AppConfig._env_int("TAB_RECOVERY_MAX_ATTEMPTS", 1)
|
||||
except Exception:
|
||||
value = 1
|
||||
return max(0, value)
|
||||
|
||||
@staticmethod
|
||||
def get_tab_recovery_timeout_sec() -> float:
|
||||
try:
|
||||
value = AppConfig._env_float("TAB_RECOVERY_TIMEOUT_SEC", 120.0)
|
||||
except Exception:
|
||||
value = 120.0
|
||||
return max(1.0, value)
|
||||
|
||||
@staticmethod
|
||||
def get_tab_recovery_worker_exit_wait_sec() -> float:
|
||||
try:
|
||||
value = AppConfig._env_float("TAB_RECOVERY_WORKER_EXIT_WAIT_SEC", 600.0)
|
||||
except Exception:
|
||||
value = 600.0
|
||||
return max(0.0, value)
|
||||
|
||||
@staticmethod
|
||||
def is_tab_recovery_refresh_on_unknown() -> bool:
|
||||
return AppConfig._env_bool("TAB_RECOVERY_REFRESH_ON_UNKNOWN", True)
|
||||
|
||||
# ===== 配置文件路径 =====
|
||||
@staticmethod
|
||||
def get_sites_config_file() -> str:
|
||||
return os.getenv("SITES_CONFIG_FILE", "config/sites.json")
|
||||
|
||||
# ===== 便捷属性(支持类/实例两种访问方式)=====
|
||||
@classproperty
|
||||
def HOST(cls) -> str:
|
||||
return cls.get_host()
|
||||
|
||||
@classproperty
|
||||
def PORT(cls) -> int:
|
||||
return cls.get_port()
|
||||
|
||||
@classproperty
|
||||
def DEBUG(cls) -> bool:
|
||||
return cls.is_debug()
|
||||
|
||||
@classproperty
|
||||
def LOG_LEVEL(cls) -> str:
|
||||
return cls.get_log_level()
|
||||
|
||||
@classproperty
|
||||
def AUTH_TOKEN(cls) -> str:
|
||||
return cls.get_auth_token()
|
||||
|
||||
@classproperty
|
||||
def DASHBOARD_AUTH_TOKEN(cls) -> str:
|
||||
return cls.get_dashboard_auth_token()
|
||||
|
||||
|
||||
# 创建全局配置实例
|
||||
app_config = AppConfig()
|
||||
|
||||
|
||||
def get_tutorial_selectors_url() -> str:
|
||||
"""返回本地控制台教程中选择器配置章节的跳转链接。"""
|
||||
try:
|
||||
port = AppConfig.get_port()
|
||||
except Exception:
|
||||
port = 8199
|
||||
return f"http://127.0.0.1:{port}/static/tutorial/index.html#selectors"
|
||||
Reference in new issue
Block a user