nex_docus/docs/sdd/specs/DV-0006-zvec-vectorization/spec.md

28 lines
1000 B
Markdown
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

# DV-0006ZVec 向量化 规格Spec
- **状态**Implemented
- **关联 ADR**ADR-0004, ADR-0006
## 目标
将项目 MD 文档分块向量化,写入本地 ZVec 库并记录状态,为 RAG 提供语义检索基础。
## 范围
- **In**MD 分块向量化、增量同步、删除清理、整项目后台任务。
- **Out**:对话本身(归 DV-0007
## 用户故事
> 作为用户,我希望项目文档自动向量化,以便后续语义问答。
## 功能需求FR
| ID | 需求 | 验收要点 |
| --- | --- | --- |
| FR-10 | MD 分块 + embedding + ZVec 写入 + document_vector 记录 | 保存/新建/重命名触发删除清理PDF 不向量化;维度变更重建 |
| FR-11 | 整项目向量化后台任务 + 进度 | pending/running/success/failed 持久化 |
## 非功能需求NFR
| ID | 需求 |
| --- | --- |
| NFR-10 | embedding 失败不阻断;无配置跳过 |
| NFR-11 | 向量维度变更重建 collection 并全量重向量化 |