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

DV-0006：ZVec 向量化 – 设计（Design）

上下文

zvec_service.py、file_vector_sync_service.py、project_vectorization_task_service.py。

分块

• 字符滑动窗口：chunk_size（默认 800）/ overlap（150）；每块生成 anchor、content_hash。

写入

• ZVec collection 每项目一个（vector_index/<project_id>）；embedding 用配置的 model_type=embedding 模型。
• document_vector 表逐块记录（zvec_id/chunk_text/status/error）。

触发

• 写路径：ProjectFileService → FileVectorSyncService（后台、按项目串行）。
• 全量：ProjectVectorizationTaskService（后台任务 + 进度表）。

维度变更

• 检测现有 collection 维度与模型不一致 → 重建 collection，旧向量作废需重向量化。