# 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 并全量重向量化 |