ai-contract-platform/project-docs/V2-performance-baseline-2026-06-26.md

AI 合同平台 V2 性能基线收口

日期：2026-06-26

结论

当前 V2 的性能收口已经有可交付基线，不再停留在“只做了索引优化”：

• 常规合同列表、审批时间线、文件仓库、AI Trace、知识库管理等高频路径已进入毫秒级。
• 合同统一搜索已从 contracts.body_content 的直接全表扫描，收口到 contract_search_documents。
• AI 中台知识库检索已完成 pgvector HNSW 和 search_vector 两条路径的优化。
• 现阶段最大的风险不在普通列表，而在真实生产数据下的搜索回归和向量检索形态偏移。

已有基线来源

• project-docs/V2-database-performance-baseline-2026-06-24.md
• project-docs/V2-database-postgresql-explain-baseline-2026-06-24.md
• project-docs/V2-database-keyword-search-sql-optimization-2026-06-24.md
• project-docs/V2-database-pgvector-hnsw-query-shape-2026-06-24.md
• project-docs/V2-database-search-document-tsvector-2026-06-24.md
• project-docs/qa-artifacts/v2-database-explain-baseline/2026-06-24T18-45-59/explain-summary.tsv
• project-docs/V2-interface-performance-baseline-2026-06-27.md
• project-docs/qa-artifacts/v2-interface-benchmark/2026-06-27T00-51-47/interface-benchmark-summary.json

关键结果

合同库

查询	warm-cache
合同列表按状态	0.233 ms
合同状态计数	0.692 ms
文件仓库按合同	0.113 ms
审查 worker 领取	0.053 ms
合同审计时间线	0.110 ms
审批时间线	0.090 ms

合同搜索

查询	warm-cache	结论
合同正文统一搜索	0.273 ms	已切到 contract_search_documents
审查任务统一搜索	0.166 ms	已切到 contract_search_documents

AI 库

查询	warm-cache
AI Trace 最新列表	0.168 ms
AI Trace 按 provider/model	0.336 ms
AI 质量看板 14 天窗口	8.959 ms
知识库文档按 base/status	0.248 ms
知识库关键词检索	0.296 ms
知识库向量检索 HNSW	1.051 ms
worker 执行时间线	0.256 ms

现阶段判断

• DB/EXPLAIN 基线足以支撑 Phase 7 收口和 smoke 交付。
• 准生产接口级压测已经完成，7 个场景、420 次正式请求全部返回 200，总错误率 0%。
• 接口性能门禁尚未完全通过：合同详情和知识库 chunk 混合检索达标；合同列表、审批待办、统一搜索、AI Trace、知识库文档检索需要优化后复测。
• 合同正文搜索和审查任务搜索已经不再是最大数据库性能风险，但统一搜索在 HTTP 层仍需控制响应体和序列化成本。
• 后续真正要盯的是：
  • knowledge-documents/search 当前 p95 为 10694.15 ms，需要从 Python 侧过滤切到数据库侧全文检索或搜索文档表。
  • audit/ai-runs?limit=5 平均响应体约 504 KB，需要拆分轻量列表和详情懒加载。
  • 生产数据规模上来以后，search_vector 和 HNSW 是否继续命中。
  • ai_run_audits、contract_search_documents 是否需要更进一步的归档或分区。
  • 真实法规库导入后，RAG 查询是否保持稳定的命中率和延迟。

下一步建议

1. 先优化 knowledge-documents/search 和 audit/ai-runs 列表，再复跑 yuqei-infra/scripts/run-interface-benchmark.py。
2. 保留当前 EXPLAIN ANALYZE 和接口压测结果，作为发布前回归门槛。
3. 把性能回归检查纳入 smoke 或发布前验证脚本。
4. 在接口 p95 达标前，不建议把“生产上线性能门禁”标记为通过。