nex_docus/IMPLEMENTATION_PLAN.md

59 lines
2.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

# 三阶段实现计划:远端合并 + 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文件不触发向量化
**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