Develop/AIclinicalresearch
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(pkb): Replace Dify with self-developed pgvector RAG engine

Browse Source 
Major milestone: Successfully replaced Dify external service with PostgreSQL + pgvector RAG engine

Backend changes:
- Refactor ragService.ts: Remove dual-track mode, keep only pgvector
- Refactor knowledgeBaseService.ts: Remove Dify creation logic
- Refactor documentService.ts: Remove Dify upload/polling logic
- DifyClient.ts: Convert to deprecated stub file (for legacy compatibility)
- common/rag/index.ts: Update exports
- common/rag/types.ts: Remove Dify types, keep generic RAG types
- config/env.ts: Remove Dify configuration

Frontend changes:
- DashboardPage.tsx: Add delete knowledge base dropdown menu
- KnowledgeBaseList.tsx: Enhance quota warning display
- CreateKBDialog.tsx: Add quota exceeded modal with guidance
- knowledgeBaseApi.ts: Add auth interceptor

Documentation:
- Update PKB module status guide (v2.3)
- Update system status guide (v4.0)

Performance metrics:
- Single query latency: 2.5s
- Single query cost: 0.0025 CNY
- Cross-language accuracy improvement: +20.5%

Remaining tasks:
- OSS storage integration
- pg_bigm extension installation

Tested: End-to-end test passed (create KB -> upload doc -> vector search)
This commit is contained in:
HaHafeng
2026-01-21 22:35:50 +08:00
parent 40c2f8e148
commit 483c62fb6f
14 changed files with 741 additions and 1018 deletions
Download Patch File Download Diff File Expand all files Collapse all files

90
docs/00-系统总体设计/00-系统当前状态与开发指南.md
View File

@@ -1,11 +1,12 @@
# AIclinicalresearch 系统当前状态与开发指南
> **文档版本：** v3.9
> **文档版本：** v4.0
> **创建日期：** 2025-11-28
> **维护者：** 开发团队
> **最后更新：** 2026-01-21
> **重大进展：** 🎉 **RAG 引擎完整实现！Postgres-Only 架构完成！**
> - 🆕 ekb_schema 第13个独立Schema，3张表，HNSW 向量索引
> **🎉 重大里程碑：** **成功替换 Dify！PKB 模块完全使用自研 pgvector RAG 引擎！**
> - ✅ **Dify 已移除**：PKB 模块不再依赖外部 RAG 服务
> - ✅ ekb_schema 第13个独立Schema，3张表，HNSW 向量索引
> - ✅ 完整 RAG 链路：文档处理 → 向量化 → 检索 → Rerank
> - ✅ 跨语言支持：DeepSeek V3 查询理解 + text-embedding-v4
> - ✅ 端到端测试通过，生产就绪
@@ -43,7 +44,7 @@
| 模块代号 | 模块名称 | 核心功能 | 商业价值 | 当前状态 | 优先级 |
|---------|---------|---------|---------|---------|--------|
| **AIA** | AI智能问答 | 12个智能体（选题→方案→评审→写作） | ⭐⭐⭐⭐⭐ | 🎉 **V2.1完成（90%）** - Prompt管理集成 | **P0** |
| **PKB** | 个人知识库 | RAG问答、私人文献库 | ⭐⭐⭐ | ✅ **核心功能完成（90%）** | P1 |
| **PKB** | 个人知识库 | RAG问答、私人文献库 | ⭐⭐⭐ | 🎉 **Dify已替换！自研RAG上线（95%）** | P1 |
| **ASL** | AI智能文献 | 文献筛选、Meta分析、证据图谱 | ⭐⭐⭐⭐⭐ | 🎉 **智能检索MVP完成（60%）** - DeepSearch集成 | **P0** |
| **DC** | 数据清洗整理 | ETL + 医学NER（百万行级数据） | ⭐⭐⭐⭐⭐ | ✅ **Tool B完成 + Tool C 99%（异步架构+性能优化-99%+多指标转换+7大功能）** | **P0** |
| **IIT** | IIT Manager Agent | AI驱动IIT研究助手 - 智能质控+REDCap集成 | ⭐⭐⭐⭐⭐ | 🎉 **Phase 1.5完成（60%）- AI对话+REDCap数据集成** | **P0** |
@@ -126,14 +127,14 @@
## 🚀 当前开发状态（2026-01-21）
### 🏆 最新进展：RAG 引擎完整实现（2026-01-21）
### 🏆 最新进展：成功替换 Dify！PKB 完全使用自研 RAG 引擎（2026-01-21）
#### ✅ PostgreSQL 原生 RAG 引擎上线
#### ✅ Dify 已完全移除，pgvector RAG 引擎生产可用
**背景**：
- 替代 Dify 外部服务，实现 Postgres-Only 架构
- 支持中英文跨语言检索
- 完整的文档处理 → 向量化 → 检索 → Rerank 链路
**重大里程碑**：
- 🎉 **彻底移除 Dify 依赖**：PKB 模块不再依赖任何外部 RAG 服务
- 🎉 **自研引擎上线**：完全使用 PostgreSQL + pgvector 的本地 RAG 方案
- 🎉 **Postgres-Only 架构完成**：所有核心功能都在 PostgreSQL 内实现
**核心技术栈**：
| 组件 | 技术 | 状态 |
@@ -144,13 +145,14 @@
| 查询理解 | DeepSeek V3 | ✅ |
| 重排序 | 阿里云 qwen3-rerank | ✅ |
**完成工作**：
- ✅ **数据库层**：创建 `ekb_schema`，3张表（KB/Document/Chunk），HNSW 向量索引
- ✅ **Python 微服务**：添加 pymupdf4llm，实现 `/api/document/to-markdown` 接口
- ✅ **Node.js 服务**：4个核心 Service（Embedding/Chunk/VectorSearch/DocumentIngest）
- ✅ **业务集成**：PKB 双轨模式适配器（支持 pgvector/dify/hybrid 切换）
- ✅ **跨语言优化**：DeepSeek V3 查询重写 + 中英双语检索
- ✅ **端到端测试**：文档入库 → 向量检索 → Rerank 全流程验证通过
**本次完成工作（2026-01-21）**：
- ✅ **移除 Dify 代码**：
- 重构 `ragService.ts` - 移除双轨模式，只保留 pgvector
- 重构 `knowledgeBaseService.ts` - 移除 Dify 创建逻辑
- 重构 `documentService.ts` - 移除 Dify 上传/轮询逻辑
- 删除 `DifyClient.ts` - 改为废弃桩文件（兼容 Legacy 代码）
- 移除 `env.ts` 中的 Dify 配置项
- ✅ **端到端测试通过**：创建知识库 → 上传文档 → 向量检索 全流程验证
**架构亮点**：
```
@@ -160,7 +162,7 @@ Brain-Hand 模型：
完整链路：
PDF → Markdown → 分块 → 向量化 → 存储(pgvector)
用户查询 → DeepSeek翻译 → 向量检索 → Rerank → Top 5
用户查询 → DeepSeek翻译 → 向量检索 → Rerank → Top K
```
**性能指标**：
@@ -168,17 +170,15 @@ Brain-Hand 模型：
- 单次成本：¥0.0025
- 跨语言准确率提升：+20.5%
**文件变更**：
- `backend/src/common/rag/` - 5个核心服务（1800+行代码）
- `backend/src/modules/pkb/services/ragService.ts` - 双轨适配器
- `extraction_service/services/` - 文档处理增强
- `backend/prisma/schema.prisma` - 添加 ekb_schema
- `backend/src/tests/` - 5个测试脚本
**遗留问题**：
- 🔧 OSS 存储集成待完善（当前文档直接入库，未持久化到 OSS）
- 🔧 pg_bigm 扩展待安装（优化中文关键词检索）
- 🔧 Legacy 代码保留 Dify 桩文件（兼容性考虑）
**使用文档**：
- 📖 [RAG 引擎使用指南](../02-通用能力层/03-RAG引擎/05-RAG引擎使用指南.md)
- 📖 [数据模型设计](../02-通用能力层/03-RAG引擎/04-数据模型设计.md)
- 📖 [分阶段实施方案](../02-通用能力层/03-RAG引擎/03-分阶段实施方案.md)
- 📖 [pgvector替换Dify计划](../02-通用能力层/03-RAG引擎/02-pgvector替换Dify计划.md)
---
@@ -481,20 +481,21 @@ data: [DONE]\n\n
**详细文档：** [AIA模块状态与开发指南](../../03-业务模块/AIA-AI智能问答/00-模块当前状态与开发指南.md)
#### 3. PKB模块 - 个人知识库 🎉 **pgvector RAG基础设施就绪！**
#### 3. PKB模块 - 个人知识库 🎉 **成功替换 Dify！自研 RAG 引擎上线！**
**开发进度**：
- ✅ **后端API**：100%完成（v1 + v2双路由运行）
- ✅ **前端Dashboard**：90%完成（基于知识库仪表盘V5原型）
- ✅ **前端Workspace**：85%完成（基于工作台V3原型）
- ✅ **全文阅读模式**：90%完成（Chat组件集成）
- ✅ **逐篇精读模式**：85%完成（文档选择+对话）
- 🔧 **批处理模式**：70%完成（UI完成，API待调试）
- 🟡 **RAG检索模式**：基础设施就绪（pgvector 0.8.1 已安装），业务逻辑待实现
- ✅ **前端Dashboard**：95%完成（基于知识库仪表盘V5原型）
- ✅ **前端Workspace**：95%完成（基于工作台V3原型）
- ✅ **全文阅读模式**：95%完成（Chat组件集成）
- ✅ **逐篇精读模式**：95%完成（文档选择+对话）
- ✅ **批处理模式**：95%完成（完整流程+结果导出）
- ✅ **RAG检索模式**：100%完成（🎉 **2026-01-21 替换 Dify 完成！**）
**核心功能**：
- 知识库CRUD + 文档管理
- 3种工作模式（全文阅读、逐篇精读、批处理）
- 4种工作模式（全文阅读、逐篇精读、批处理、RAG检索）
- 自研 pgvector RAG 引擎（替代 Dify）
- Ant Design X Chat组件集成
- 响应式全屏布局
@@ -504,11 +505,12 @@ data: [DONE]\n\n
- ✅ 复用shared/components/Chat通用组件
- ✅ 单层Header + 紧凑工作模式栏设计
- ✅ **pgvector 0.8.1 已集成**（2026-01-19）
- ✅ **自研 RAG 引擎上线，Dify 已移除**（2026-01-21）
- ✅ **跨语言检索**：DeepSeek V3 查询理解 + 中英双语
**待解决问题**：
- 🔧 批处理API执行待调试
- 🔧 知识资产页面导航条待完善
- 🔧 RAG 检索业务逻辑待实现（向量表设计、Embedding服务）
- 🔧 OSS 存储集成待完善
- 🔧 pg_bigm 扩展待安装（优化中文关键词检索）
**详细文档**：[PKB模块当前状态](../03-业务模块/PKB-个人知识库/00-模块当前状态与开发指南.md)
@@ -1001,7 +1003,8 @@ AIclinicalresearch/
| **2026-01-07 上午** | **PKB前端V3** 🎉 | ✅ PKB模块前端V3设计实现完成（Dashboard+Workspace+3种工作模式） |
| **2026-01-07 下午** | **PKB批处理完善** 🏆 | ✅ 批处理完整流程调试通过（执行+进度+结果导出）+ 文档上传功能 + UI优化 |
| **2026-01-19** | **pgvector集成** 🎉 | ✅ pgvector 0.8.1 安装成功，PKB RAG基础设施就绪 |
| **当前** | **PKB模块生产可用** | ✅ 核心功能全部实现（90%），pgvector已集成，RAG业务逻辑待开发 |
| **2026-01-21** | **🎉 Dify替换完成** | ✅ PKB 成功替换 Dify，完全使用自研 pgvector RAG 引擎 |
| **当前** | **PKB模块生产可用** | ✅ 核心功能全部实现（95%），Dify已移除，自研RAG引擎上线 |
| **2026-01-07 晚** | **RVW模块开发完成** 🎉 | ✅ Phase 1-3完成（后端迁移+数据库扩展+前端重构） |
---
@@ -1180,8 +1183,8 @@ npm run dev # http://localhost:3000
- **总计**：约 85,000 行
### 模块完成度
- ✅ **已完成**：AIA V2.0（85%，核心功能完成）、平台基础层（100%）、RVW（95%）、通用能力层升级（100%）
- 🚧 **开发中**：PKB（90%，核心功能完成）、ASL（80%）、DC（Tool C 98%，Tool B后端100%，Tool B前端0%）、IIT（60%，Phase 1.5完成）
- ✅ **已完成**：AIA V2.0（85%，核心功能完成）、平台基础层（100%）、RVW（95%）、通用能力层升级（100%）、**PKB（95%，Dify已替换）** 🎉
- 🚧 **开发中**：ASL（80%）、DC（Tool C 98%，Tool B后端100%，Tool B前端0%）、IIT（60%，Phase 1.5完成）
- 📋 **未开始**：SSA、ST
### 部署完成度
@@ -1302,7 +1305,8 @@ if (items.length >= 50) {
1. ✅ **Platform-Only 架构**：统一任务管理，零代码重复 🏆
2. ✅ **智能双模式处理**：小任务快速响应，大任务可靠执行 🏆
3. ✅ **🆕 RAG 引擎完整实现**：替代 Dify，Postgres-Only 架构完成 🏆 **2026-01-21 上线！**
3. ✅ **🎉 Dify 成功替换！自研 RAG 引擎生产上线！** 🏆 **2026-01-21**
- ✅ **彻底移除 Dify 依赖**：PKB 模块完全使用自研 pgvector 引擎
- pgvector 向量检索 + DeepSeek V3 查询理解 + qwen3-rerank 重排序
- 跨语言支持：中文查询匹配英文文档（准确率 +20.5%）
- Brain-Hand 架构：业务层思考，引擎层执行
@@ -1324,9 +1328,9 @@ if (items.length >= 50) {
---
**文档版本**：v3.8
**最后更新**：2026-01-19
**下次更新**：PKB RAG检索功能实现 或 生产环境pgvector部署
**文档版本**：v4.0
**最后更新**：2026-01-21
**下次更新**：OSS 存储集成 或 pg_bigm 扩展安装
---

193
docs/03-业务模块/PKB-个人知识库/00-模块当前状态与开发指南.md
View File

@@ -1,12 +1,12 @@
# PKB个人知识库模块 - 当前状态与开发指南
> **文档版本：** v2.2
> **文档版本：** v2.3
> **创建日期：** 2026-01-07
> **维护者：** PKB模块开发团队
> **最后更新：** 2026-01-20
> **重大进展：** 🎉 **知识库能力提升为通用能力层，PKB 将作为首个接入模块！**
> **基础设施：** ✅ pgvector 0.8.1 已安装，RAG检索模式基础设施就绪
> **架构变更：** 知识库引擎迁移至 `common/rag/`，详见通用能力层文档
> **最后更新：** 2026-01-21
> **🎉 重大里程碑：** **成功替换 Dify！完全使用自研 pgvector RAG 引擎！**
> **技术架构：** ✅ PostgreSQL + pgvector 0.8.1 + DeepSeek V3 查询理解 + qwen3-rerank
> **架构变更：** 知识库引擎完全迁移至 `common/rag/`，移除 Dify 依赖
> **文档目的：** 反映模块真实状态，记录开发历程
---
@@ -43,10 +43,10 @@ PKB（Personal Knowledge Base）个人知识库模块提供：
| **全文阅读模式** | ✅ 已完成 | 95% | Chat组件集成完成 |
| **逐篇精读模式** | ✅ 已完成 | 95% | 文档选择+对话 |
| **批处理模式** | ✅ 已完成 | 95% | 完整流程+结果导出 |
| **文档上传** | ✅ 已完成 | 100% | 拖拽+进度显示 |
| **RAG检索模式** | ⏸️ 暂缓 | 0% | 优先级调整 |
| **文档上传** | ✅ 已完成 | 100% | 拖拽+进度显示+pgvector入库 |
| **RAG检索模式** | ✅ 已完成 | 100% | 🎉 **2026-01-21 完成！替换 Dify** |
**整体完成度：约90%** 🎉
**整体完成度：约95%** 🎉
---
@@ -68,24 +68,28 @@ UI组件: Ant Design v6 + Ant Design X
```
框架: Fastify v4 (Node.js 22)
数据库: PostgreSQL 15 + Prisma 6 + pgvector 0.8.1
Schema: pkb_schema (独立隔离)
Schema: pkb_schema (业务数据) + ekb_schema (向量数据)
向量存储: pgvector (PostgreSQL原生向量扩展) ✅ 2026-01-19 已集成
Embedding: 阿里云 text-embedding-v4 (1024维) ✅
查询理解: DeepSeek V3 (中英双语翻译) ✅
重排序: 阿里云 qwen3-rerank ✅
LLM: DeepSeek-V3, Qwen-Max (通过LLMFactory)
RAG: 通用能力层知识库引擎 (common/rag/) 🔄 2026-01-20 架构升级中
存储: OSS对象存储
RAG: 自研 pgvector 引擎 (common/rag/) ✅ 2026-01-21 完成
存储: OSS对象存储 (待完善)
```
### 依赖的通用能力层
| 通用能力 | 用途 | 状态 |
|----------|------|------|
| **知识库引擎** | 文档入库、向量检索、RAG 问答 | 🔄 开发中 |
| **RAG 引擎** | 文档入库、向量检索、Rerank | ✅ **2026-01-21 完成** |
| **文档处理引擎** | PDF/Word/Excel → Markdown | ✅ 已就绪 |
| **LLM 网关** | 大模型调用 | ✅ 已接入 |
| **存储服务** | 文档存储到 OSS | ✅ 已接入 |
| **存储服务** | 文档存储到 OSS | 🔧 待完善 |
> 📍 **架构说明**：知识库能力已提升为通用能力层，PKB 模块将调用 `common/rag/KnowledgeBaseEngine`，
> 详见 [通用能力层 - 知识库引擎](../../02-通用能力层/03-RAG引擎/README.md)
> 📍 **架构说明**：2026-01-21 **成功替换 Dify**，完全使用自研 pgvector RAG 引擎。
> PKB 模块调用 `common/rag/` 中的服务（EmbeddingService、VectorSearchService、DocumentIngestService）。
> 详见 [RAG 引擎使用指南](../../02-通用能力层/03-RAG引擎/05-RAG引擎使用指南.md)
### API路由
@@ -225,43 +229,68 @@ frontend-v2/src/modules/pkb/
**当前状态**：🔧 API执行待调试
### 4. RAG检索模式（基础设施就绪）
### 4. RAG检索模式 ✅ **已完成（2026-01-21）**
**功能说明**：
- 基于向量检索
- 基于向量检索 + 关键词检索的混合模式
- 精准定位相关段落
- 适合快速查找
- 支持中英文跨语言检索
**当前状态**：🟡 基础设施已就绪（pgvector 0.8.1 已安装），后端业务逻辑待实现
**当前状态**：✅ **完全可用** - 成功替换 Dify！
**技术基础**（2026-01-19 完成）：
- ✅ pgvector 扩展已安装（版本 0.8.1）
- ✅ 支持 HNSW 和 IVFFlat 索引
- ✅ 与阿里云 RDS pgvector 0.8.0 兼容
- ⏳ 向量表设计待实现
- ⏳ Embedding 服务集成待实现
- ⏳ 相似度检索 API 待实现
**技术实现**（2026-01-21 完成）：
- ✅ pgvector 扩展（版本 0.8.1）+ HNSW 索引
- ✅ EmbeddingService（阿里云 text-embedding-v4，1024维）
- ✅ VectorSearchService（向量检索 + 关键词检索 + RRF 融合）
- ✅ QueryRewriter（DeepSeek V3 中英双语翻译）
- ✅ RerankService（阿里云 qwen3-rerank 重排序）
- ✅ DocumentIngestService（文档分块 + 向量化入库）
- ✅ ragService.ts 适配器（PKB → EKB 知识库映射）
**性能指标**：
- 单次检索延迟：~2.5秒
- 单次检索成本：¥0.0025
- 跨语言准确率提升：+20.5%
---
## ⚠️ 已知问题
### 1. RAG检索模式业务逻辑未实现 🟡 中优先级
### 1. ~~RAG检索模式业务逻辑未实现~~ ✅ 已解决（2026-01-21）
**已完成**：
- ✅ 完全替换 Dify，使用自研 pgvector RAG 引擎
- ✅ 向量表设计完成（ekb_schema: knowledge_bases, documents, chunks）
- ✅ Embedding 服务集成（阿里云 text-embedding-v4）
- ✅ 相似度检索 API 实现（混合检索 + Rerank）
### 2. OSS 存储集成待完善 🟡 中优先级
**问题描述**：
- pgvector 基础设施已就绪（2026-01-19）
- RAG检索业务逻辑待实现
- 当前优先全文阅读和逐篇精读模式
- 当前文档上传直接入库，未存储到 OSS
- 需要集成 `common/storage` 存储抽象层
**影响**：工作模式选择有限
**影响**：文档无法持久化存储到云端
**解决方案**：
- v2.1版本实现RAG检索（基于pgvector，不再依赖Dify）
- 设计向量表结构（pkb_schema.document_embeddings）
- 集成 Embedding 服务（OpenAI/智谱）
- 实现相似度检索 API
- 使用 StorageFactory 选择存储适配器
- 开发环境使用 LocalAdapter
- 生产环境使用 OSSAdapter
### 2. 批处理模板有限 🟢 低优先级
### 3. pg_bigm 扩展待安装 🟢 低优先级
**问题描述**：
- 当前关键词检索使用基础 LIKE 查询
- pg_bigm 可提升中文关键词检索性能
**影响**：中文关键词检索可能较慢
**解决方案**：
- 安装 pg_bigm 扩展
- 创建 GIN 索引优化中文检索
### 4. 批处理模板有限 🟢 低优先级
**问题描述**：
- 当前只支持1个模板（临床研究信息提取）
@@ -289,39 +318,42 @@ frontend-v2/src/modules/pkb/
## 📝 下一步开发计划
### v2.1 版本（短期）
### v2.3 版本（短期）✅ 已完成
1. **RAG检索模式** 🟡 （基础设施已就绪 ✅）
1. **RAG检索模式** ✅ **已完成（2026-01-21）**
- ✅ pgvector 0.8.1 已安装
- 设计向量表结构（pkb_schema.document_embeddings）
- 集成 Embedding 服务（文本向量化）
- 实现相似度检索 API
- 添加工作模式选择器
- 测试检索准确度
- ✅ 向量表设计完成（ekb_schema）
- ✅ Embedding 服务集成（阿里云 text-embedding-v4）
- ✅ 相似度检索 API 实现
- ✅ 替换 Dify，完全使用自研引擎
- ✅ 中英双语跨语言检索
2. **性能优化** 🟡
### v2.4 版本（短期）
2. **OSS 存储集成** 🟡
- 集成 common/storage 抽象层
- 文档持久化存储到 OSS
- 支持大文件上传
3. **性能优化** 🟡
- 批处理并发优化
- 文档加载缓存
- API响应时间优化
### v2.2 版本（中期）
### v2.5 版本（中期）
3. **批处理增强** 🟢
4. **批处理增强** 🟢
- 增加药物安全性模板
- 增加患者基线特征模板
- 支持自定义模板
4. **用户体验优化** 🟢
5. **用户体验优化** 🟢
- 文档筛选和排序
- 批量操作
- 快捷键支持
### 中期任务（2周内）
5. **RAG检索模式**
- 后端API开发
- 前端集成
6. **PDF预览增强**
- 集成PDF查看器
- 支持标注
@@ -395,15 +427,16 @@ frontend-v2/src/modules/pkb/
### 开发进度
```
整体进度：约75%
整体进度：约95% 🎉
- 后端API：100% ✅
- Dashboard页面：90% ✅
- Workspace页面：85% ✅
- 全文阅读模式：90% ✅
- 逐篇精读模式：85% ✅
- 批处理模式：70% 🔧
- RAG检索模式：0% ❌
- Dashboard页面：95% ✅
- Workspace页面：95% ✅
- 全文阅读模式：95% ✅
- 逐篇精读模式：95% ✅
- 批处理模式：95% ✅
- RAG检索模式：100% ✅ (2026-01-21 完成)
- OSS存储集成：50% 🔧
```
---
@@ -427,6 +460,45 @@ frontend-v2/src/modules/pkb/
## 📝 更新日志
### 2026-01-21 🎉 成功替换 Dify！完全使用自研 RAG 引擎
**重大里程碑**：
- ✅ **彻底移除 Dify 依赖**：删除 DifyClient.ts，重构所有相关服务
- ✅ **自研 RAG 引擎上线**：基于 PostgreSQL + pgvector 的完整 RAG 链路
- ✅ **跨语言检索支持**：DeepSeek V3 查询理解 + 中英双语检索
- ✅ **端到端测试通过**：文档入库 → 向量检索 → Rerank 全流程验证
**技术架构**：
```
Brain-Hand 模型：
业务层 (Brain) → DeepSeek V3 查询理解 → 生成检索词
引擎层 (Hand) → 向量+关键词 → RRF → Rerank → 结果
完整链路：
PDF → Markdown → 分块 → 向量化 → 存储(pgvector)
用户查询 → DeepSeek翻译 → 向量检索 → Rerank → Top K
```
**修改文件**：
- `backend/src/modules/pkb/services/ragService.ts` - 移除双轨模式，只保留 pgvector
- `backend/src/modules/pkb/services/knowledgeBaseService.ts` - 移除 Dify 创建逻辑
- `backend/src/modules/pkb/services/documentService.ts` - 移除 Dify 上传逻辑
- `backend/src/common/rag/DifyClient.ts` - 改为废弃桩文件（兼容 Legacy）
- `backend/src/common/rag/index.ts` - 更新导出
- `backend/src/common/rag/types.ts` - 移除 Dify 类型
- `backend/src/config/env.ts` - 移除 Dify 配置
**性能指标**：
- 单次检索延迟：~2.5秒
- 单次检索成本：¥0.0025
- 跨语言准确率提升：+20.5%
**遗留问题**：
- OSS 存储集成待完善
- pg_bigm 扩展待安装（优化中文关键词检索）
---
### 2026-01-19 pgvector 向量数据库集成
**重大变更**：
@@ -441,14 +513,9 @@ frontend-v2/src/modules/pkb/
- 支持索引类型：HNSW、IVFFlat
- 向量维度：最高支持 16000 维
**下一步**：
- 设计 `pkb_schema.document_embeddings` 表
- 集成 Embedding 服务
- 实现 RAG 检索 API
---
**最后更新：** 2026-01-19
**最后更新：** 2026-01-21
**文档维护：** PKB模块开发团队
**联系方式：** 项目Issues