# ADR-0006：写路径异步索引同步

- **状态**：Accepted

## 背景
文件变更（创建/修改/删除/移动）需同步维护向量索引与全文索引，但不能阻塞主请求线程。

## 决策
文件操作经 `ProjectFileService` → `FileVectorSyncService`（独立 DB 会话、按项目串行、后台 `asyncio.Task`）触发 ZVec 重向量化/删除；全文索引经 `search_service` 同步更新。整项目向量化走 `ProjectVectorizationTaskService`（后台任务 + 进度表）。

## 后果
- 写请求返回快，索引最终一致。
- 需处理并发同一项目的串行化与任务去重。

## 关联
DV-0002, DV-0006, DV-0010。