28 lines
1.2 KiB
Markdown
28 lines
1.2 KiB
Markdown
|
# 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 失败 → 降级不返回支撑句。
|
|||
|
|
|