nex_docus/docs/sdd/specs/DV-0007-rag-chat/design.md

DV-0007：知识库 RAG 对话 – 设计（Design）

上下文

chat.py（API）、rag_service.py（检索/生成/对齐）、zvec_service.search_similar。

数据模型

• chat_session、chat_message（status/duration_ms/thinking_log/referenced_files）。

接口设计

• POST /api/v1/chat/sessions、GET /chat/sessions、GET|PUT|DELETE /chat/sessions/{id}
• GET /chat/sessions/{id}/messages、DELETE /chat/messages/{id}
• POST /chat/send、/chat/send/stream、/chat/messages/{id}/interrupt
• GET /chat/search、（向量化系列归 DV-0006）

检索与生成

1. search_similar（top_k*4 命中去重，每文件最多 MAX_CHUNKS_PER_DOCUMENT=3）。
2. 上下文围绕命中锚点截取（CHUNK_CONTEXT_WINDOW=1200）。
3. 系统提示词约束：仅依知识库、必须 [n] 引用。
4. 历史仅注入最近用户问题（HISTORY_USER_QUESTION_LIMIT=3）作为指代。

引用对齐

• align_citation_quotes：答案论断句 ↔ 原文候选句向量对齐，回填 quote_occurrences。

状态与降级

• 中断：status=interrupted；旧数据按只读兼容判定（不回溯改库）。
• 对齐/embedding 失败 → 降级不返回支撑句。