feat(frontend):优化前端页面设计

kilostar/api/provider.py

@@ -26,8 +26,7 @@ provider_router = APIRouter(prefix="/api/v1/provider", tags=["provider"])
 
 
 class ProviderRegister(BaseModel):
-    """ProviderRegister 核心组件类。
-    这是一个模型/服务提供商适配器类，屏蔽了外部不同供应商（如 OpenAI、Anthropic 等）的底层 API 差异。它负责标准化参数组装、网络请求发送、鉴权处理以及响应结构的反序列化。"""
+    """``POST /provider`` 入参：注册一个模型 Provider 的最小字段集。"""
 
     provider_type: Literal["openai", "claude", "deepseek"]
     provider_title: str
@@ -40,10 +39,7 @@ async def create_provider(
     provider_register: ProviderRegister,
     token_data: TokenData = Depends(RoleChecker(allowed_roles=UserAuthority.USER)),
 ) -> None:
-    """处理针对 create provider 相关的 HTTP API 请求。
-    该接口负责解析前端传入的载荷数据，调用底层核心业务逻辑进行处理，并组装标准化的 JSON 响应。
-    Args:        provider_register (ProviderRegister): 目标对象的唯一全局标识符 (UUID/ULID)，用于在数据库表或缓存结构中精准匹配该 provider_register 实例。        token_data (TokenData): 从客户端传递过来或由上游组件生成的核心业务数据体，通常需要进一步的清洗和结构化解析。
-    Returns:         (None): 序列化后的标准网络响应模型（如包含业务状态码、成功标志及对应的数据载荷 Data）。"""
+    """注册一个 Provider；owner 为当前登录用户的 ``user_id``。"""
     global_state_machine = ray_actor_hook("global_state_machine").global_state_machine
     await global_state_machine.add_provider_wrap.remote(
         provider_type=provider_register.provider_type,
@@ -58,10 +54,7 @@ async def create_provider(
 async def get_provider_list(
     _: TokenData = Depends(Accessor.get_current_user),
 ) -> Dict[str, Dict[str, Provider]]:
-    """处理针对 get provider list 相关的 HTTP API 请求。
-    该接口负责解析前端传入的载荷数据，调用底层核心业务逻辑进行处理，并组装标准化的 JSON 响应。
-    Args:        _ (TokenData): 参与 get provider list 逻辑运算或数据构建的上下文依赖对象。
-    Returns:         (Dict[str, Dict[str, Provider]]): 序列化后的标准网络响应模型（如包含业务状态码、成功标志及对应的数据载荷 Data）。"""
+    """返回当前所有已注册的 Provider，前端用以展示模型清单。"""
     global_state_machine = ray_actor_hook("global_state_machine").global_state_machine
     provider_list: Dict[
         str, Provider
@@ -76,10 +69,7 @@ async def delete_provider(
         RoleChecker(allowed_roles=UserAuthority.SUPER_ADMINISTRATOR)
     ),
 ) -> dict:
-    """处理针对 delete provider 相关的 HTTP API 请求。
-    该接口负责解析前端传入的载荷数据，调用底层核心业务逻辑进行处理，并组装标准化的 JSON 响应。
-    Args:        provider_title (str): 目标对象的唯一全局标识符 (UUID/ULID)，用于在数据库表或缓存结构中精准匹配该 provider_title 实例。        _ (TokenData): 参与 delete provider 逻辑运算或数据构建的上下文依赖对象。
-    Returns:         (dict): 序列化后的标准网络响应模型（如包含业务状态码、成功标志及对应的数据载荷 Data）。"""
+    """删除指定 ``provider_title`` 的 Provider；仅超管可调用。"""
     global_state_machine = ray_actor_hook("global_state_machine").global_state_machine
     await global_state_machine.delete_provider.remote(provider_title=provider_title)
     return {"message": "success"}