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

kilostar/utils/retry.py

@@ -19,23 +19,20 @@ from kilostar.utils.error import RetryableError
 
 
 def retry_on_retryable_error(max_retries=3, base_delay=1):
-    """执行与 retry on retryable error 相关的核心业务流转操作。
-    该方法封装了具体的算法策略或状态控制逻辑，确保操作能够在事务上下文中被原子且一致地执行。
-    Args:        max_retries: 参与 retry on retryable error 逻辑运算或数据构建的上下文依赖对象。        base_delay: 参与 retry on retryable error 逻辑运算或数据构建的上下文依赖对象。
-    Returns:        : 经由当前业务模型加工处理后所输出的具体数据实例或领域模型对象。"""
+    """指数退避重试装饰器：仅在抛出 ``RetryableError`` 时重试。
+
+    同步/异步函数都支持。第 n 次重试前会 ``sleep(base_delay * 2**n)``。
+
+    Args:
+        max_retries: 最多尝试次数（含首次），超过后会把最后一次异常重新抛出。
+        base_delay: 退避基准秒数。
+    """
 
     def decorator(func):
-        """执行与 decorator 相关的核心业务流转操作。
-        该方法封装了具体的算法策略或状态控制逻辑，确保操作能够在事务上下文中被原子且一致地执行。
-        Args:        func: 参与 decorator 逻辑运算或数据构建的上下文依赖对象。
-        Returns:        : 经由当前业务模型加工处理后所输出的具体数据实例或领域模型对象。"""
         if asyncio.iscoroutinefunction(func):
 
             @wraps(func)
             async def async_wrapper(*args, **kwargs):
-                """执行与 async wrapper 相关的核心业务流转操作。
-                该方法封装了具体的算法策略或状态控制逻辑，确保操作能够在事务上下文中被原子且一致地执行。
-                Returns:        : 经由当前业务模型加工处理后所输出的具体数据实例或领域模型对象。"""
                 for attempt in range(max_retries):
                     try:
                         return await func(*args, **kwargs)
@@ -49,9 +46,6 @@ def retry_on_retryable_error(max_retries=3, base_delay=1):
 
             @wraps(func)
             def sync_wrapper(*args, **kwargs):
-                """执行与 sync wrapper 相关的核心业务流转操作。
-                该方法封装了具体的算法策略或状态控制逻辑，确保操作能够在事务上下文中被原子且一致地执行。
-                Returns:        : 经由当前业务模型加工处理后所输出的具体数据实例或领域模型对象。"""
                 import time
 
                 for attempt in range(max_retries):