nex_docus/IMPLEMENTATION_PLAN.md

59 lines
2.0 KiB
Markdown
Raw Normal View History

# 三阶段实现计划:远端合并 + ZVec集成 + 知识库对话
## Stage 1: 远端更新合并 & 模型配置集成
**Goal**: 合并远端的新增功能(项目管理、文件管理、分享等),保留本地的模型配置功能
**Success Criteria**:
- 无冲突合并远端代码
- 本地LLMModelConfig功能完全保留
- 所有数据库迁移脚本就位
- 前后端依赖关系正确
**Tests**:
- 数据库初始化成功
- 项目CRUD操作正常
- 模型配置API正常工作
**Status**: Complete
## Stage 2: 删除Graphy + 集成ZVec向量化
**Goal**: 移除graphy组件实现ZVec自动向量化MD文件操作时
**Success Criteria**:
- ✅ 删除所有graphy相关文件和导入
- ✅ 创建ZVec集成服务
- ✅ 在文件操作(创建/修改/删除时自动调用ZVec仅限MD
- ✅ 向量化结果存储到数据库
**Tests**:
- 创建MD文件时触发向量化
- 修改MD文件时重新向量化
- 删除MD文件时清理向量数据
- PDF文件不触发向量化
2026-07-24 07:37:22 +00:00
**Status**: Complete
## Stage 3: 知识库对话功能
**Goal**: 基于ZVec向量化的文档实现大模型知识库对话
**Success Criteria**:
- ✅ 创建知识库对话页面/组件
- ✅ 支持项目选择
- ✅ 支持LLM模型选择使用Stage 1的模型配置
- ✅ RAG检索+大模型生成对话
- ✅ 对话历史记录
**Tests**:
- 能成功创建对话会话
- 向量检索返回相关文档
- 大模型生成回复正常
- 对话历史保存正确
**Status**: Complete
---
## 关键技术决策
1. **ZVec集成方式**通过项目文件监听或API触发取决于项目架构
2. **向量存储**在DocumentMeta模型中新增embedding字段或创建单独的向量表
3. **RAG实现**:使用向量相似度检索 + LLMProviderService进行生成
4. **前端交互**Chat页面侧边栏项目/模型选择,消息列表
## 已有基础
- ✅ LLMProviderService多协议支持
- ✅ LLMModelConfig模型和API
- ✅ 项目管理系统
- ✅ 文件管理系统
- ✅ 前端框架React+Ant Design