refactor(ai-gateway): _TIER_RANK 单源化消除重复定义，nginx 限流双层设计加注释说明

Author: Aparencia

server/ai-gateway/config/__init__.py

@@ -24,6 +24,7 @@
     ALIYUN_ACCESS_KEY_SECRET,
     AI_PROVIDERS,
     MODEL_ROUTING,
+    _TIER_RANK,  # 单源 tier 优先级（rate_limit 等消费方从此导入，避免重复定义）
     get_provider_for_feature,
 )
 from config.fallback import (  # noqa: F401
@@ -46,6 +47,7 @@
     "ALIYUN_ACCESS_KEY_SECRET",
     "AI_PROVIDERS",
     "MODEL_ROUTING",
+    "_TIER_RANK",
     "get_provider_for_feature",
     "PROVIDER_FALLBACK_CHAIN",
     "_resolve_model_name",

server/ai-gateway/middleware/rate_limit.py

@@ -18,7 +18,7 @@
 from starlette.middleware.base import BaseHTTPMiddleware
 
 from cache.redis_cache import get_cache
-from config import RATE_LIMITS, TIMEOUT_CONFIG
+from config import RATE_LIMITS, TIMEOUT_CONFIG, _TIER_RANK
 
 logger = logging.getLogger(__name__)
 
@@ -42,8 +42,8 @@
 
 DEFAULT_TIER = "free"
 
-# Tier 优先级（模块级常量，避免每次调用重新创建字典）
-_TIER_RANK = {"free": 0, "observer": 1, "active": 2, "pro": 3, "core": 4, "lifetime": 5}
+# Tier 优先级：单源定义于 config.providers（2026-08 R5 消除重复定义），
+# 此处从 config 导入，与 providers.get_effective_tier 共享同一 rank 表。
 
 
 def get_tier_limits(beta_tier: str | None = None, paid_tier: str | None = None) -> dict:

server/nginx/nginx.conf

@@ -25,6 +25,10 @@ http {
     gzip_min_length 1000;
 
     # Rate limiting
+    # 双层限流说明（2026-08 审计复核）：nginx 层（本 zone）按 IP 防洪泛，
+    # 网关内 Redis 滑动窗口按账号 tier 配额（15-120 次/天）。两层互补：
+    # nginx 30r/m 只拦截单 IP 突发刷量（正常用户每日调用远低于此），
+    # 不会误伤；账号级每日配额由网关精确执行（nginx 不感知 tier）。
     limit_req_zone $binary_remote_addr zone=api:10m rate=30r/m;
     limit_req_zone $binary_remote_addr zone=ai:10m rate=30r/m;
     # 安装包下载并发限制（按 IP），避免大文件下载挤占 API 带宽