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

kilostar/core/postgres_database/module/provider.py

@@ -20,17 +20,14 @@ from kilostar.core.postgres_database.database_exception import database_exceptio
 
 
 class ProviderDatabase:
-    """ProviderDatabase 核心组件类。
-    这是一个模型/服务提供商适配器类，屏蔽了外部不同供应商（如 OpenAI、Anthropic 等）的底层 API 差异。它负责标准化参数组装、网络请求发送、鉴权处理以及响应结构的反序列化。"""
+    """Provider 表的 DAO：模型 Provider 的增删查改。"""
 
     def __init__(self, async_session_maker):
         self.async_session_maker = async_session_maker
 
     @database_exception
     async def get_provider(self) -> List[ProviderModel]:
-        """检索并获取特定的 provider 数据集合或实例对象。
-        根据提供的查询条件或上下文凭证，从数据库、缓存或第三方服务中读取对应的资源状态。
-        Returns:         (List[ProviderModel]): 经过筛选、排序或分页处理后的实体对象列表集合。"""
+        """返回全部 Provider，并将每行重新构造为新的 ``ProviderModel`` 实例（脱离 session）。"""
         async with self.async_session_maker() as session:
             statement = select(ProviderModel)
             results = await session.execute(statement)
@@ -53,9 +50,7 @@ class ProviderDatabase:
 
     @database_exception
     async def add_provider(self, **kwargs) -> None:
-        """创建并持久化新的 provider 实体。
-        接收构建参数，执行必要的数据校验与默认值填充后，将新记录安全地写入底层存储或系统注册表中。
-        Returns:         (None): 经由当前业务模型加工处理后所输出的具体数据实例或领域模型对象。"""
+        """新建一条 Provider 记录；字段通过 kwargs 直接传给 ProviderModel。"""
         async with self.async_session_maker() as session:
             provider = ProviderModel(**kwargs)
             session.add(provider)
@@ -63,10 +58,7 @@ class ProviderDatabase:
 
     @database_exception
     async def delete_provider(self, provider_id: str) -> None:
-        """安全地移除或注销 provider。
-        执行物理删除或逻辑删除操作，并妥善清理相关的关联数据及占用资源。
-        Args:        provider_id (str): 目标对象的唯一全局标识符 (UUID/ULID)，用于在数据库表或缓存结构中精准匹配该 provider 实例。
-        Returns:         (None): 经由当前业务模型加工处理后所输出的具体数据实例或领域模型对象。"""
+        """删除指定 ID 的 Provider；不存在时静默返回。"""
         async with self.async_session_maker() as session:
             provider = await session.get(ProviderModel, provider_id)
             if provider is not None:
@@ -75,10 +67,7 @@ class ProviderDatabase:
 
     @database_exception
     async def update_provider(self, provider_id: str, **kwargs) -> None:
-        """对现有的 provider 进行状态更新或属性覆盖。
-        基于增量变更原则，合并最新的配置或数据，并触发相关依赖组件的缓存刷新或事件通知。
-        Args:        provider_id (str): 目标对象的唯一全局标识符 (UUID/ULID)，用于在数据库表或缓存结构中精准匹配该 provider 实例。
-        Returns:         (Provider): 经由当前业务模型加工处理后所输出的具体数据实例或领域模型对象。"""
+        """部分更新指定 Provider 的字段；不存在时返回 None，否则返回刷新后的对象。"""
         async with self.async_session_maker() as session:
             provider = await session.get(ProviderModel, provider_id)
             if provider is not None: