用途：为全栈项目建立统一的错误分类体系，让每个运行时错误都具备错误码、类别、严重级别和用户可见消息，并打通 FastAPI 的 ErrorResponse 模型与 Next.js 的 ApiClientError 类。
主要能力：错误码采用 {DOMAIN}{CATEGORY}{SPECIFIC} 格式，例如 AUTH_VALIDATION_INVALID_TOKEN、AGENT_RUNTIME_TIMEOUT、DATA_VALIDATION_MISSING_FIELD。域包括 AUTH_、AGENT_、DATA_、WORKFLOW_、SYS_；类别包括 VALIDATION、RUNTIME、PERMISSION、NOTFOUND、CONFLICT、RATELIMIT、EXTERNAL。严重级别分 fatal（500-599，记录并告警升级）、error（400-499，记录并返回用户消息）、warning（200 带 warning 头，仅记录）。后端用 ErrorResponse 模型（detail、error_code、severity、field）抛出结构化 HTTPException，并注册全局 ValidationError 处理器转成 422 结构化响应。前端扩展 ApiError 与 ApiClientError，提供 isAuth、isValidation、isRetryable 判断，并用 ERROR_MESSAGES 映射表把技术错误码转成用户友好文案。
使用方式：新增错误码时先选域、再选类别、补具体标识，登记到错误码注册表，并在前端 ERROR_MESSAGES 中映射用户消息；抛出异常时使用 ErrorResponse 模型。
适用场景：创建或修改 API 错误响应、在 FastAPI 路由新增 HTTPException、实现前端错误处理或展示、设计 React 错误边界、审查前后端错误一致性。
限制：不适用于重试/弹性逻辑（应使用 retry-strategy）、React 错误边界组件设计（应使用 error-boundary），也不处理构建、lint 或类型错误。资料未提供安装命令、收费与平台信息。