4.0 KiB
4.0 KiB
RAG知识库系统 - 快速使用指南
📋 当前配置
运行模式
✅ 混合模式 (Hybrid)
- 文档嵌入：本地Ollama (
nomic-embed-text) - AI生成：远程Kimi API (
moonshot-v1-32k) - 向量存储：SimpleVectorStore（文件持久化）
文件路径
- 文档上传：
D:\wwwroot\RAG\uploads - 系统日志：
D:\wwwroot\RAG\logs - 向量数据：
D:\wwwroot\RAG\data\chroma_db\vector_store.json
🚀 使用步骤
1. 启动前检查
# 检查Ollama是否运行
ollama list
应该能看到 nomic-embed-text 模型。
2. 启动应用
直接运行Spring Boot应用即可。
3. 上传知识文档
方式一：通过Web界面（推荐）
- 登录系统：
http://localhost:30081 - 进入"知识库管理"页面
- 点击"上传文档"按钮
- 选择文档文件（支持格式：txt、pdf、docx、md）
- 系统会自动：
- 解析文档内容
- 使用Ollama生成向量嵌入
- 存储到本地向量库
方式二：直接放入文件夹
将文档文件直接复制到：D:\wwwroot\RAG\uploads
然后通过API触发处理：
curl -X POST http://localhost:30081/api/knowledge/rebuild
4. 使用AI分析
- 进入"测评报告"页面
- 选择一个测评报告
- 点击"AI分析"按钮
- 系统会：
- 从向量库检索相关知识
- 调用Kimi API生成专业分析报告
- 显示分析结果和知识来源
📄 支持的文档格式
- ✅
.txt- 纯文本文件 - ✅
.md- Markdown文档 - ✅
.pdf- PDF文档 - ✅
.docx- Word文档
💡 推荐的知识文档
建议上传以下类型的心理学文档：
-
心理测评标准
- 各类量表的解释标准
- 评分规则和参考范围
-
心理学理论
- 心理健康相关理论
- 心理问题的成因分析
-
干预建议
- 心理咨询技巧
- 心理健康维护方法
-
案例分析
- 典型案例及处理方法
- 专业心理咨询经验
🔍 测试系统
运行测试脚本验证配置：
test-rag-system.bat
这会测试：
- ✅ Ollama连接
- ✅ Kimi API连接
- ✅ 文档上传
- ✅ 知识检索
- ✅ AI生成
📊 系统状态查看
访问：http://localhost:30081/api/knowledge/status
返回信息包括：
- AI服务状态（Ollama + Kimi）
- 向量存储状态
- 文档数量
- 配置信息
⚙️ 配置说明
不需要安装的服务
❌ ChromaDB - 使用内置SimpleVectorStore ❌ DeepSeek本地模型 - 使用远程Kimi API
需要运行的服务
✅ Ollama - 用于文档嵌入（已安装） ✅ MySQL - 系统数据库 ✅ Redis - 缓存服务
🎯 工作流程
上传文档
↓
解析文本内容
↓
Ollama生成嵌入向量 (本地)
↓
存储到SimpleVectorStore (内存 + 文件)
↓
自动保存到 vector_store.json
↓
用户请求AI分析
↓
检索相关知识片段
↓
Kimi API生成报告 (远程)
↓
返回分析结果
💰 成本说明
- 文档处理：完全免费（本地Ollama）
- AI生成：使用你的Kimi API额度
- 数据存储：本地存储，无额外费用
🔧 常见问题
Q: 向量数据会丢失吗？
A: 不会！系统已启用文件持久化，所有向量数据自动保存到 D:\wwwroot\RAG\data\chroma_db\vector_store.json。应用重启后会自动加载。
Q: 如何备份向量数据？
A: 直接复制 D:\wwwroot\RAG\data\chroma_db\vector_store.json 文件即可。
Q: 如何清空知识库？
A: 调用API：DELETE /api/knowledge/clear 或删除 vector_store.json 文件后重启应用。
Q: 文档上传后多久可以使用？
A: 立即可用。系统会实时处理文档并生成嵌入。
Q: 可以上传多大的文档？
A: 建议单个文档不超过10MB。大文档会自动分块处理。
📞 技术支持
如有问题，请查看日志：
- 应用日志：控制台输出
- RAG日志：
D:\wwwroot\RAG\logs
祝使用愉快！ 🎉