feat(ai-gateway): 新增套餐列表 API GET /api/v1/license/plans

Author: Aparencia

server/ai-gateway/middleware/auth.py

@@ -123,7 +123,8 @@ def extract_tiers(payload: dict) -> tuple[Optional[str], Optional[str]]:
 # 不需要认证的路径白名单
 # 注意：license_webhook 是支付平台服务端回调（无用户 token），
 # 防伪依赖 HMAC 签名 + order_id 查询确认（见 payment_adapter），而非 JWT。
-PUBLIC_PATHS = {"/health", "/health/quick", "/health/live", "/api/v1/license/webhook"}
+# license/plans 是公开套餐目录，供前端 PlanCompareModal 无需登录拉取。
+PUBLIC_PATHS = {"/health", "/health/quick", "/health/live", "/api/v1/license/webhook", "/api/v1/license/plans"}
 
 
 async def verify_token(request: Request) -> str:

server/ai-gateway/routers/license.py

@@ -60,6 +60,58 @@ class StatusResponse(BaseModel):
     licenses: list[dict] = []
 
 
+class Plan(BaseModel):
+    id: str
+    name: str
+    price: float
+    period: str  # "month" | "year" | "lifetime"
+    duration_days: int
+    daily_quota: int
+    featured: bool = False
+    badge: str | None = None
+    models: list[str] = []
+    multimodal: bool = False
+    early_access: int = 0
+    sync_devices: int = 1
+    savings: str | None = None
+
+
+class PlanListResponse(BaseModel):
+    plans: list[Plan]
+
+
+# ============================================================
+# 套餐目录（PlanCompareModal 数据源）
+# ============================================================
+# @ai-context: 公开套餐目录，供前端 PlanCompareModal 拉取并渲染价格/周期/
+# 配额对比；无需登录（auth.PUBLIC_PATHS 白名单）。
+
+PLANS: list[Plan] = [
+    Plan(
+        id="pro_monthly", name="Pro 月卡", price=12.0, period="month",
+        duration_days=30, daily_quota=80, featured=False,
+        models=["基础模型", "DeepSeek"], multimodal=False, early_access=0, sync_devices=2,
+    ),
+    Plan(
+        id="pro_yearly", name="Pro 年卡", price=99.0, period="year",
+        duration_days=365, daily_quota=80, featured=True, badge="最受欢迎",
+        models=["基础模型", "DeepSeek"], multimodal=False, early_access=0, sync_devices=2,
+        savings="省 ¥45",
+    ),
+    Plan(
+        id="lifetime", name="终身 Pro", price=199.0, period="lifetime",
+        duration_days=36500, daily_quota=120, featured=False, badge="终身早鸟价",
+        models=["全部模型"], multimodal=True, early_access=5, sync_devices=3,
+    ),
+]
+
+
+@router.get("/plans", response_model=PlanListResponse)
+async def get_plans():
+    """返回当前可购买套餐列表（公开接口，无需登录）。"""
+    return PlanListResponse(plans=PLANS)
+
+
 # ============================================================
 # 激活码验证逻辑
 # ============================================================

server/ai-gateway/tests/test_license_plans.py

@@ -0,0 +1,52 @@
+"""
+测试套餐列表 API
+
+覆盖：
+- 返回三个套餐（月卡/年卡/终身）
+- 各套餐字段正确（价格/周期/时长/推荐标记/多模态）
+- 无需认证即可访问
+"""
+
+import sys
+from pathlib import Path
+
+GATEWAY_ROOT = str(Path(__file__).resolve().parent.parent)
+if GATEWAY_ROOT not in sys.path:
+    sys.path.insert(0, GATEWAY_ROOT)
+
+from fastapi.testclient import TestClient
+
+from main import app
+
+client = TestClient(app)
+
+
+class TestGetPlans:
+    """套餐列表接口（无需认证）"""
+
+    def test_returns_three_plans(self):
+        resp = client.get("/api/v1/license/plans")
+        assert resp.status_code == 200
+        data = resp.json()
+        assert "plans" in data
+        assert len(data["plans"]) == 3
+
+    def test_pro_monthly_fields(self):
+        resp = client.get("/api/v1/license/plans")
+        monthly = [p for p in resp.json()["plans"] if p["id"] == "pro_monthly"][0]
+        assert monthly["price"] == 12.0
+        assert monthly["period"] == "month"
+        assert monthly["duration_days"] == 30
+
+    def test_pro_yearly_is_featured(self):
+        resp = client.get("/api/v1/license/plans")
+        yearly = [p for p in resp.json()["plans"] if p["id"] == "pro_yearly"][0]
+        assert yearly["featured"] is True
+        assert yearly["badge"] == "最受欢迎"
+        assert yearly["savings"] == "省 ¥45"
+
+    def test_lifetime_multimodal(self):
+        resp = client.get("/api/v1/license/plans")
+        lifetime = [p for p in resp.json()["plans"] if p["id"] == "lifetime"][0]
+        assert lifetime["multimodal"] is True
+        assert lifetime["daily_quota"] == 120