技术选型理由

Next.js 16 与 React 19

选择 Next.js 是因为它能同时承载展示页、后台页面、API 路由和文档浏览，单一框架降低部署与维护成本。App Router 的 Server Component 让本地文档读取、后台数据聚合和页面渲染保持清晰边界。动态路由按 Next.js 16 规则使用 Promise params，浏览器能力如 Mermaid 渲染放在 client component。

PostgreSQL、pgvector 与 Redis

PostgreSQL 承担订单、会话、消息、工单、知识库、Prompt 和质检数据，便于用 SQL 做运营分析。pgvector 提供向量检索扩展空间，但项目保留文本检索和 RRF 融合作为轻量方案。Redis 用于缓存和短状态，不承担核心业务事实。

OpenAI 兼容协议

LLM 层使用 OpenAI SDK 兼容接口，而不是绑定单一厂商。这样可以在 DeepSeek、Qwen、GLM 或中转模型之间切换，也方便把生成回复和自动质检分配给不同模型，避免模型自评偏向。系统设计的重点不是模型供应商，而是产品边界、工具调用和质检闭环。