refactor: 共享请求管道、按需懒加载、流式内存护栏与连接池治理

- 抽取 ApiRequestPipeline 单例,44 个路由文件共享同一实例
- Handler/Adapter 模块级 __getattr__ 延迟导入,减少启动时间
- 新增 ensure_stream_buffer_limit() 流式内存护栏(16MB 单行 / 32MB 总量)
- HTTP 空闲连接清理与 curl_cffi LRU 会话池
- ensure_providers_bootstrapped 按需引导指定 provider_types
- Usage 事件序列化迁移至 msgpack,Redis codec 隔离
- 启动预热任务(/readyz 就绪门控)与优雅关闭
- 通知邮件模块独立开关与 SMTP 配置校验
- CryptoService DCL 线程安全修复
- 通知模块开关 DB 查询 30s 内存缓存
- /readyz 对 unknown 状态返回 503
- 预热关闭 5s 超时保护
- 预热适配器逐个 try-except 容错
- FormatConversionRegistry 哨兵模式防并发重复物化
- 流式缓冲检查无条件执行

Closes #230

Co-authored-by: AAEE86 <ppk0227@hotmail.com>
This commit is contained in:
fawney19
2026-03-14 11:59:07 +08:00
parent 45985f1c04
commit e0286aebe3
111 changed files with 2775 additions and 1102 deletions

View File

@@ -0,0 +1,46 @@
"""
通知邮件模块
提供错误通知邮件发送开关,并复用 SMTP 配置页。
"""
from __future__ import annotations
from typing import TYPE_CHECKING
from src.core.modules.base import ModuleCategory, ModuleDefinition, ModuleMetadata
if TYPE_CHECKING:
from sqlalchemy.orm import Session
def _validate_config(db: Session) -> tuple[bool, str]:
"""
验证通知邮件模块配置。
启用要求SMTP 基础配置有效(至少 host + from_email
"""
from src.services.email.email_sender import EmailSenderService
if not EmailSenderService.is_smtp_configured(db):
return False, "请先完成邮件配置SMTP"
return True, ""
notification_email_module = ModuleDefinition(
metadata=ModuleMetadata(
name="notification_email",
display_name="异常通知",
description="为 5xx 异常发送邮件通知,可在模块管理中启用或禁用",
category=ModuleCategory.INTEGRATION,
env_key="NOTIFICATION_EMAIL_AVAILABLE",
default_available=True,
required_packages=[],
# 通知邮件与 SMTP 配置复用同一页面,不在模块卡片展示独立“配置”入口。
admin_route=None,
admin_menu_icon="Mail",
admin_menu_group="system",
admin_menu_order=58,
),
validate_config=_validate_config,
)