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

kilostar/utils/logger.py

@@ -18,17 +18,11 @@ from loguru._logger import Logger
 
 
 def setup_logger() -> Logger:
-    """对现有的 setup logger 进行状态更新或属性覆盖。
-    基于增量变更原则，合并最新的配置或数据，并触发相关依赖组件的缓存刷新或事件通知。
-    Returns:         (Logger): 经由当前业务模型加工处理后所输出的具体数据实例或领域模型对象。"""
+    """初始化全局 loguru logger，输出格式为 ``actor:(...) | trace_id:(...) : message``。"""
     logger.remove()
 
     def format_record(record):
         # Format string for rich handler
-        """执行与 format record 相关的核心业务流转操作。
-        该方法封装了具体的算法策略或状态控制逻辑，确保操作能够在事务上下文中被原子且一致地执行。
-        Args:        record: 参与 format record 逻辑运算或数据构建的上下文依赖对象。
-        Returns:        : 经由当前业务模型加工处理后所输出的具体数据实例或领域模型对象。"""
         actor = record["extra"].get("actor_name", "System")
         trace_id = record["extra"].get("trace_id", "")
 
@@ -57,8 +51,5 @@ global_logger = setup_logger()
 
 
 def get_logger(actor_name: str, trace_id: str = "") -> Logger:
-    """检索并获取特定的 logger 数据集合或实例对象。
-    根据提供的查询条件或上下文凭证，从数据库、缓存或第三方服务中读取对应的资源状态。
-    Args:        actor_name (str): 赋予该实体的人类可读名称或标题字符串，主要用于前端 UI 展示、日志记录或模糊检索。        trace_id (str): 目标对象的唯一全局标识符 (UUID/ULID)，用于在数据库表或缓存结构中精准匹配该 trace 实例。
-    Returns:         (Logger): 经由当前业务模型加工处理后所输出的具体数据实例或领域模型对象。"""
+    """获取一个绑定了 actor_name 与可选 trace_id 的 logger，便于日志按 Actor/请求归类。"""
     return global_logger.bind(actor_name=actor_name, trace_id=trace_id)