# 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. 启动前检查

```bash
# 检查Ollama是否运行
ollama list
```

应该能看到 `nomic-embed-text` 模型。

### 2. 启动应用

直接运行Spring Boot应用即可。

### 3. 上传知识文档

#### 方式一：通过Web界面（推荐）

1. 登录系统：`http://localhost:30081`
2. 进入"知识库管理"页面
3. 点击"上传文档"按钮
4. 选择文档文件（支持格式：txt、pdf、docx、md）
5. 系统会自动：
   - 解析文档内容
   - 使用Ollama生成向量嵌入
   - 存储到本地向量库

#### 方式二：直接放入文件夹

将文档文件直接复制到：`D:\wwwroot\RAG\uploads`

然后通过API触发处理：
```bash
curl -X POST http://localhost:30081/api/knowledge/rebuild
```

### 4. 使用AI分析

1. 进入"测评报告"页面
2. 选择一个测评报告
3. 点击"AI分析"按钮
4. 系统会：
   - 从向量库检索相关知识
   - 调用Kimi API生成专业分析报告
   - 显示分析结果和知识来源

## 📄 支持的文档格式

- ✅ `.txt` - 纯文本文件
- ✅ `.md` - Markdown文档
- ✅ `.pdf` - PDF文档
- ✅ `.docx` - Word文档

## 💡 推荐的知识文档

建议上传以下类型的心理学文档：

1. **心理测评标准**
   - 各类量表的解释标准
   - 评分规则和参考范围

2. **心理学理论**
   - 心理健康相关理论
   - 心理问题的成因分析

3. **干预建议**
   - 心理咨询技巧
   - 心理健康维护方法

4. **案例分析**
   - 典型案例及处理方法
   - 专业心理咨询经验

## 🔍 测试系统

运行测试脚本验证配置：

```bash
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`

---

**祝使用愉快！** 🎉