Skip to content

feat: add support for Milvus as vector database#394

Closed
cjxhaaa wants to merge 2 commits intoTencent:mainfrom
cjxhaaa:feature/retriever
Closed

feat: add support for Milvus as vector database#394
cjxhaaa wants to merge 2 commits intoTencent:mainfrom
cjxhaaa:feature/retriever

Conversation

@cjxhaaa
Copy link

@cjxhaaa cjxhaaa commented Nov 4, 2025

Pull Request

描述 (Description)

增加了milvus支持,由于目前user的检索引擎相关配置在账号创建时就绑定了,所以要使用milvus需要新建账号才行。

变更类型 (Type of Change)

  • 🐛 Bug 修复 (Bug fix)
  • ✨ 新功能 (New feature)
  • 💥 破坏性变更 (Breaking change)
  • 📚 文档更新 (Documentation update)
  • 🎨 代码重构 (Code refactoring)
  • ⚡ 性能优化 (Performance improvement)
  • 🧪 测试相关 (Test related)
  • 🔧 配置变更 (Configuration change)
  • 🐳 Docker 相关 (Docker related)
  • 🎨 前端 UI/UX (Frontend UI/UX)

影响范围 (Scope)

  • 后端 API (Backend API)
  • 前端界面 (Frontend UI)
  • 数据库 (Database)
  • 文档解析服务 (Document Reader Service)
  • MCP 服务器 (MCP Server)
  • Docker 配置 (Docker Configuration)
  • 配置文件 (Configuration)
  • 其他 (Other):

测试 (Testing)

  • 单元测试 (Unit tests)
  • 集成测试 (Integration tests)
  • 手动测试 (Manual testing)
  • 前端测试 (Frontend testing)
  • API 测试 (API testing)

测试步骤 (Test Steps)

  1. 修改.env的RETRIEVE_DRIVER=milvus,新增MILVUS_ADDR=http://milvus:19530
  2. 运行./scripts/build_images.sh -p重新build后端镜像
  3. docker compose up -d启动服务,docker logs -f WeKnora-app查看log
  4. 访问前端,更新知识库设置时会尝试根据Embedding模型的维度生成milvus对应的collection,在log上搜关键字出现Update Collection dim xxxx success说明配置正确。同时也可尝试多次切换Embedding模型测试。
  5. 知识库上传文档,能正常问答

检查清单 (Checklist)

  • 代码遵循项目的编码规范
  • 已进行自我代码审查
  • 代码变更已添加适当的注释
  • 相关文档已更新
  • 变更不会产生新的警告
  • 已添加测试用例证明修复有效或功能正常
  • 新功能和变更已更新到相关文档
  • 破坏性变更已在描述中明确说明

相关 Issue

Fixes #190
Fixes #127

截图/录屏 (Screenshots/Recordings)

数据库迁移 (Database Migration)

  • 需要数据库迁移
  • 不需要数据库迁移

配置变更 (Configuration Changes)

.env文件新增MILVUS_ADDR字段,RETRIEVE_DRIVER支持了milvus
docker-compose.yml新增milvus,etcd

部署说明 (Deployment Notes)

milvus-io/milvus#43946
milvus使用docker compose部署重启时偶尔会出现错误信息,与该issue报告一致,暂时不确定官方是否修复

其他信息 (Additional Information)

@cjxhaaa cjxhaaa closed this Jan 30, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

1 participant