nex_docus/IMPLEMENTATION_PLAN.md

2.1 KiB
Raw Blame 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文件不触发向量化 Status: In Progress (核心服务完成,待数据库创建)

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