28 lines
1000 B
Markdown
28 lines
1000 B
Markdown
|
# DV-0006：ZVec 向量化 – 规格（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 并全量重向量化 |
|
|||
|
|
|