From 05aa9a7c1c9ff847e75328ee309089fe3f5c4962 Mon Sep 17 00:00:00 2001
From: jxxghp <jxxghp@gmail.com>
Date: Mon, 14 Sep 2026 13:45:22 +0800
Subject: [PATCH] fix(auth): type site authentication configuration

---
 app/application/site/auth.py | 13 ++++++++++---
 1 file changed, 10 insertions(+), 3 deletions(-)

diff --git a/app/application/site/auth.py b/app/application/site/auth.py
index 243373e31..f12dc089e 100644
--- a/app/application/site/auth.py
+++ b/app/application/site/auth.py
@@ -3,11 +3,18 @@
 from __future__ import annotations
 
 from collections.abc import Mapping
-from typing import Optional
+from typing import Optional, TypedDict, cast
 
 from app.schemas.common import JsonData
 
 
+class _SiteAuthConfig(TypedDict):
+    """认证资源公共入口接受的站点配置形状。"""
+
+    site: str
+    params: dict[str, JsonData]
+
+
 def normalize_site_auth_params(
     site: Optional[str],
     params: Optional[Mapping[str, JsonData]],
@@ -46,7 +53,7 @@ def normalize_site_auth_params(
 def normalize_site_auth_config(
     auth_config: Optional[Mapping[str, JsonData]],
     auth_sites: Mapping[str, JsonData],
-) -> Optional[dict[str, JsonData]]:
+) -> Optional[_SiteAuthConfig]:
     """规范化持久化的站点认证配置，兼容旧字段名。"""
     if not auth_config:
         return None
@@ -58,4 +65,4 @@ def normalize_site_auth_config(
 
     normalized = dict(auth_config)
     normalized["params"] = normalize_site_auth_params(site, params, auth_sites)
-    return normalized
+    return cast(_SiteAuthConfig, normalized)