""" Pydantic 数据模型定义。 从 bot-search-mcp 移植,适配 web-search-skills 的数据结构。 提供类型安全的搜索数据模型。 依赖: pydantic (>=2.0) """ from __future__ import annotations from dataclasses import dataclass, field from datetime import datetime from typing import Any, Optional # ============================================================ # 搜索结果模型(兼容 dataclass + pydantic 双模式) # ============================================================ @dataclass class SearchQuery: """搜索查询封装。""" query: str sources: Optional[list[str]] = None max_results: int = 10 region: Optional[str] = None site: Optional[str] = None recency: Optional[str] = None extra: dict[str, Any] = field(default_factory=dict) @dataclass class SourceRef: """引用来源。""" index: int title: str url: str source: str # ============================================================ # 性能计时模型 # ============================================================ @dataclass class EngineTiming: """单个引擎耗时记录。""" engine_name: str success: bool duration_ms: int result_count: int error: Optional[str] = None @dataclass class SearchMetadata: """搜索元数据(全链路计时)。""" total_engines: int = 0 total_raw_results: int = 0 engines_used: list[str] = field(default_factory=list) duration_ms: int = 0 engine_timings: list[EngineTiming] = field(default_factory=list) timed_out_engines: list[str] = field(default_factory=list) # ============================================================ # 最终响应 # ============================================================ @dataclass class SearchResponse: """完整搜索响应。""" query: str results: list[Any] = field(default_factory=list) sources: list[SourceRef] = field(default_factory=list) metadata: SearchMetadata = field(default_factory=SearchMetadata)