feat(llm): add API Route provider (#6972)

Signed-off-by: dennyho0917 <dennyho0917@gmail.com>
Co-authored-by: jxxghp <jxxghp@gmail.com>

app/agent/llm/catalog.py

@@ -357,6 +357,14 @@ class _ProviderCatalog:
                 api_key_hint="填写 Atlas Cloud API Key。",
                 description="Atlas Cloud 聚合模型平台，一个 Key 覆盖 DeepSeek、智谱、月之暗面、通义千问与 MiniMax 等开源权重模型。",
             ),
+            openai_provider(
+                provider_id="api-route",
+                name="API Route",
+                default_base_url="https://global.api-route.com/v1",
+                sort_order=56,
+                api_key_hint="填写 API Route API Key，可在 https://api-route.com 获取。",
+                description="API Route OpenAI-compatible 聚合模型平台，支持刷新账户可用模型目录。",
+            ),
             ProviderSpec(
                 id="github-copilot",
                 name="GitHub Copilot",

tests/test_llm_provider_api_route.py

@@ -0,0 +1,60 @@
+"""API Route 预设通过共享 OpenAI 兼容通道发现模型的边界回归。"""
+
+from unittest.mock import AsyncMock
+
+import httpx
+import pytest
+
+from app.agent.llm.provider import LLMProviderManager
+from app.foundation.singleton import Singleton
+
+
+@pytest.fixture
+def manager(monkeypatch):
+    """隔离管理器单例及目录缓存，防止测试影响其他 provider。"""
+    key = (LLMProviderManager, (), frozenset())
+    monkeypatch.setattr(Singleton, "_instances", {k: v for k, v in Singleton._instances.items() if k != key})
+    instance = LLMProviderManager()
+    monkeypatch.setattr(instance, "get_models_dev_data", AsyncMock(return_value={}))
+    return instance
+
+
+@pytest.mark.asyncio
+@pytest.mark.parametrize(
+    "base_url, expected_url",
+    [
+        (None, "https://global.api-route.com/v1/models"),
+        ("https://relay.example/v1", "https://relay.example/v1/models"),
+    ],
+)
+async def test_api_route_discovers_authenticated_models(manager, monkeypatch, base_url, expected_url):
+    """预设及覆盖地址都传递密钥，保留完整模型 ID，不推断缺失的上下文元数据。"""
+    requests = []
+
+    def respond(request):
+        requests.append(request)
+        return httpx.Response(
+            200,
+            json={
+                "object": "list",
+                "data": [
+                    {"id": "gpt-6.1-sol", "object": "model", "created": 0, "owned_by": "api-route"},
+                    {"id": "other/model", "object": "model", "created": 0, "owned_by": "api-route"},
+                ],
+            },
+        )
+
+    monkeypatch.setattr(
+        manager,
+        "_build_sdk_http_client",
+        lambda use_proxy: httpx.AsyncClient(transport=httpx.MockTransport(respond)),
+    )
+
+    models = await manager.list_models("api-route", api_key="test-api-route-key", base_url=base_url)
+
+    assert len(requests) == 1
+    assert requests[0].method == "GET"
+    assert str(requests[0].url) == expected_url
+    assert requests[0].headers["Authorization"] == "Bearer test-api-route-key"
+    assert [model["id"] for model in models] == ["gpt-6.1-sol", "other/model"]
+    assert all(model["source"] == "provider" and model["context_tokens"] is None for model in models)