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

kilostar/api/platform/frontend.py

@@ -26,8 +26,7 @@ client_router = APIRouter(prefix="/api/v1/adapter/client", tags=["client"])
 
 
 class Message(BaseModel):
-    """Message 核心组件类。
-    这是一个领域数据模型或功能封装类，承载了 Message 相关的内聚属性定义与状态维护。它的存在隔离了局部的业务复杂性，并对外提供了类型安全的访问接口。"""
+    """``POST /client`` 入参：来自前端的一段聊天文本。"""
 
     message: str
 
@@ -36,10 +35,7 @@ class Message(BaseModel):
 async def create_message(
     message: Message, token_data: TokenData = Depends(Accessor.get_current_user)
 ):
-    """处理针对 create message 相关的 HTTP API 请求。
-    该接口负责解析前端传入的载荷数据，调用底层核心业务逻辑进行处理，并组装标准化的 JSON 响应。
-    Args:        message (Message): 参与 create message 逻辑运算或数据构建的上下文依赖对象。        token_data (TokenData): 从客户端传递过来或由上游组件生成的核心业务数据体，通常需要进一步的清洗和结构化解析。
-    Returns:        : 序列化后的标准网络响应模型（如包含业务状态码、成功标志及对应的数据载荷 Data）。"""
+    """把前端消息转交给 RegulatoryNode 处理，并把回复透传给前端。"""
     logger.info("收到消息，来源：客户端")
     logger.debug(f"消息内容：{message.message}")
     regulatory_node = ray_actor_hook("regulatory_node").regulatory_node
@@ -56,10 +52,7 @@ async def upload_file(
     file: UploadFile = File(...),
     token_data: TokenData = Depends(Accessor.get_current_user),
 ):
-    """处理针对 upload file 相关的 HTTP API 请求。
-    该接口负责解析前端传入的载荷数据，调用底层核心业务逻辑进行处理，并组装标准化的 JSON 响应。
-    Args:        file (UploadFile): 参与 upload file 逻辑运算或数据构建的上下文依赖对象。        token_data (TokenData): 从客户端传递过来或由上游组件生成的核心业务数据体，通常需要进一步的清洗和结构化解析。
-    Returns:        : 序列化后的标准网络响应模型（如包含业务状态码、成功标志及对应的数据载荷 Data）。"""
+    """以流式方式把上传文件落到 ``uploads/`` 目录；失败抛 500。"""
     try:
         upload_dir = "uploads"
         os.makedirs(upload_dir, exist_ok=True)