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

kilostar/utils/error.py

@@ -14,75 +14,66 @@
 
 
 class RetryableError(Exception):
-    """基类：所有可重试错误（如网络断开、抖动等临时性故障）"""
+    """基类：所有可重试错误（如网络断开、抖动等临时性故障）。"""
 
     pass
 
 
 class NonRetryableError(Exception):
-    """基类：所有不可重试错误（如数据验证失败、类型错误等业务逻辑故障）"""
+    """基类：所有不可重试错误（如数据验证失败、类型错误等业务逻辑故障）。"""
 
     pass
 
 
 class DemandError(NonRetryableError):
-    """DemandError 核心组件类。
-    这是一个自定义异常类，专门用于在 Demand 相关业务流程中触发中断。它携带了精确的错误上下文与追溯代码，帮助最外层网关能够统一捕获并返回友好的前端错误提示。"""
+    """需求/任务参数不合法或不满足前置条件时抛出。"""
 
     pass
 
 
 class ModelNotExistError(Exception):
-    """ModelNotExistError 核心组件类。
-    这是一个自定义异常类，专门用于在 ModelNotExist 相关业务流程中触发中断。它携带了精确的错误上下文与追溯代码，帮助最外层网关能够统一捕获并返回友好的前端错误提示。"""
+    """请求了一个未在 Provider 中注册的模型 ID 时抛出。"""
 
     pass
 
 
 class UserError(Exception):
-    """UserError 核心组件类。
-    这是一个自定义异常类，专门用于在 User 相关业务流程中触发中断。它携带了精确的错误上下文与追溯代码，帮助最外层网关能够统一捕获并返回友好的前端错误提示。"""
+    """用户相关错误的基类，HTTP 层会被统一映射为 4xx。"""
 
     pass
 
 
 class UserNotExistError(UserError):
-    """UserNotExistError 核心组件类。
-    这是一个自定义异常类，专门用于在 UserNotExist 相关业务流程中触发中断。它携带了精确的错误上下文与追溯代码，帮助最外层网关能够统一捕获并返回友好的前端错误提示。"""
+    """按用户名/ID 查询时用户不存在。"""
 
     pass
 
 
 class UserPasswordError(UserError):
-    """UserPasswordError 核心组件类。
-    这是一个自定义异常类，专门用于在 UserPassword 相关业务流程中触发中断。它携带了精确的错误上下文与追溯代码，帮助最外层网关能够统一捕获并返回友好的前端错误提示。"""
+    """口令校验失败（旧密码错误、登录密码错误等）。"""
 
     pass
 
 
 class ProviderError(Exception):
-    """ProviderError 核心组件类。
-    这是一个模型/服务提供商适配器类，屏蔽了外部不同供应商（如 OpenAI、Anthropic 等）的底层 API 差异。它负责标准化参数组装、网络请求发送、鉴权处理以及响应结构的反序列化。"""
+    """模型 Provider 相关错误的基类。"""
 
     pass
 
 
 class ProviderNotExistError(ProviderError):
-    """ProviderNotExistError 核心组件类。
-    这是一个模型/服务提供商适配器类，屏蔽了外部不同供应商（如 OpenAI、Anthropic 等）的底层 API 差异。它负责标准化参数组装、网络请求发送、鉴权处理以及响应结构的反序列化。"""
+    """请求了一个未注册的 Provider 时抛出。"""
 
     pass
 
 
 class WorkflowError(Exception):
-    """WorkflowError 核心组件类。
-    这是一个自定义异常类，专门用于在 Workflow 相关业务流程中触发中断。它携带了精确的错误上下文与追溯代码，帮助最外层网关能够统一捕获并返回友好的前端错误提示。"""
+    """工作流执行期错误的基类，HTTP 层会被统一映射为 5xx。"""
 
     pass
 
 
 class WorkflowExit(WorkflowError):
-    """WorkflowExit 核心组件类。
-    这是一个领域数据模型或功能封装类，承载了 WorkflowExit 相关的内聚属性定义与状态维护。它的存在隔离了局部的业务复杂性，并对外提供了类型安全的访问接口。"""
+    """工作流被显式终止（用户取消、上游决策跳出等）时抛出，是预期内的退出信号。"""
 
     pass