[pytest]
  # 权威的 pytest 配置源。新增共享配置请放这里，不要再散落到各测试文件头部。
  #
  # testpaths 明确只扫 tests/（含 tests/ci/），刻意排除 tests/manual/。
  testpaths = tests
  # tests/manual/ 里的脚本依赖外部服务，不参与自动回归。
  norecursedirs = tests/manual
  
  addopts = -ra --strict-markers
  
  # 全局静默第三方的 DeprecationWarning，避免遮掩真正需要关注的业务警告。
  filterwarnings =
      ignore::DeprecationWarning
      ignore::PendingDeprecationWarning
  
  # 子系统 / 回归分层标记。新增 marker 前先在这里登记，未登记的 marker 会因
  # --strict-markers 直接报错。
  markers =
      regression: 提交/发布前必跑的回归锚点集合
      contract: API / 服务契约（tests/ci 默认全部归入）
      search: Searcher / 排序 / 召回管线
      query: QueryParser / 翻译 / 分词
      intent: 样式与 SKU 意图识别
      rerank: 粗排 / 精排 / 融合
      embedding: 文本/图像向量服务与客户端
      translation: 翻译服务与缓存
      indexer: 索引构建 / LLM enrich
      suggestion: 搜索建议索引
      eval: 评估框架
      manual: 需人工起服务，CI 不跑