xinli/知识库管理-使用说明.md

# 知识库管理 - 使用说明

## 🎯 功能概述

系统提供了完整的知识库管理功能，支持文档上传、自动处理、查询和删除。

## 📍 访问路径

登录系统后，进入：
```
系统管理 → 心理测评 → 知识库管理
```

或直接访问：
```
http://localhost:30081/#/psychology/knowledge
```

## 🚀 主要功能

### 1. 文档上传（自动处理）

**操作步骤**：
1. 点击"上传文档"按钮
2. 选择文档分类：
   - 测评标准
   - 理论知识
   - 案例分析
   - 干预方法
   - 其他
3. 拖拽或选择文件上传
4. 点击"确定"

**自动处理流程**：
```
上传文件
    ↓
保存到服务器
    ↓
解析文档内容
    ↓
文本分块（800字/块）
    ↓
Ollama生成向量
    ↓
存储到向量库
    ↓
自动保存到文件
    ↓
完成！
```

**支持格式**：
- `.txt` - 纯文本文件
- `.pdf` - PDF文档
- `.docx` - Word文档
- `.md` - Markdown文档

**文件限制**：
- 单个文件最大 10MB
- 建议文档内容清晰、结构化

### 2. 文档列表

**显示信息**：
- 文档名称
- 分类标签
- 片段数量
- 文件大小
- 上传时间

**操作**：
- 查看：查看文档详细信息
- 删除：从知识库中删除文档

### 3. 统计信息

页面顶部显示实时统计：
- **文档数量**：已上传的文档总数
- **知识片段**：文档分块后的片段总数
- **AI服务**：Ollama连接状态
- **向量存储**：SimpleVectorStore状态

### 4. 重建索引

**使用场景**：
- 批量上传文档后
- 修改了配置参数
- 向量数据损坏

**操作**：
1. 点击"重建索引"按钮
2. 确认操作
3. 等待处理完成（可能需要几分钟）

**注意**：重建索引会重新处理所有文档，耗时较长。

### 5. 清空知识库

**警告**：此操作会删除所有知识库数据，不可恢复！

**操作**：
1. 点击"清空知识库"按钮
2. 确认操作
3. 所有文档和向量数据将被删除

## 💡 使用建议

### 文档准备

**推荐文档结构**：
```
心理测评标准.txt
---
一、抑郁症评估标准

轻度抑郁（10-15分）：
- 症状描述
- 干预建议

中度抑郁（16-25分）：
- 症状描述
- 干预建议

...
```

**文档质量要点**：
1. 内容准确、专业
2. 结构清晰、分段明确
3. 避免大量无关内容
4. 使用标准术语

### 分类管理

建议按以下方式组织文档：

**测评标准**：
- 各类量表的评分标准
- 症状判断标准
- 风险等级划分

**理论知识**：
- 心理学基础理论
- 心理问题成因分析
- 心理健康知识

**案例分析**：
- 典型案例及处理
- 成功干预经验
- 注意事项

**干预方法**：
- 心理咨询技巧
- 自我调节方法
- 专业治疗建议

### 上传策略

**初次使用**：
1. 先上传核心文档（20-50个）
2. 测试AI分析效果
3. 根据效果调整和补充

**日常维护**：
1. 定期更新过时内容
2. 补充新的知识
3. 删除无效文档

**批量上传**：
1. 将文档放入 `D:\wwwroot\RAG\uploads\`
2. 点击"重建索引"
3. 系统自动处理所有文档

## 🔍 AI分析使用

上传文档后，在测评报告页面：

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

**分析质量取决于**：
- 知识库文档的质量和数量
- 文档内容与测评的相关性
- AI模型的理解能力

## 📊 监控和维护

### 查看状态

定期检查统计信息：
- 文档数量是否合理（建议50-200个）
- AI服务是否正常连接
- 向量存储是否正常

### 性能优化

如果系统响应慢：
1. 检查文档数量（建议<5000片段）
2. 检查Ollama服务状态
3. 考虑删除无用文档

### 数据备份

定期备份重要数据：
```bash
# 备份向量数据
copy D:\wwwroot\RAG\data\chroma_db\vector_store.json backup\

# 备份文档
xcopy D:\wwwroot\RAG\uploads backup\uploads\ /E /I
```

## ❓ 常见问题

### Q: 上传后看不到文档？
A: 刷新页面，或检查上传是否成功（查看提示消息）

### Q: AI分析没有使用知识库？
A: 检查：
1. 知识库是否有相关文档
2. 文档内容是否与测评相关
3. 查看系统日志

### Q: 文档上传失败？
A: 可能原因：
1. 文件格式不支持
2. 文件大小超过10MB
3. Ollama服务未运行
4. 磁盘空间不足

### Q: 如何提高AI分析质量？
A: 
1. 上传更多高质量文档
2. 确保文档内容专业、准确
3. 文档内容要与测评相关
4. 定期更新知识库

### Q: 重建索引需要多久？
A: 取决于文档数量：
- 10个文档：1-2分钟
- 50个文档：5-10分钟
- 100个文档：10-20分钟

## 🎓 最佳实践

1. **从小规模开始**：先上传20-30个核心文档
2. **测试效果**：上传后测试AI分析质量
3. **逐步完善**：根据效果补充和调整
4. **定期维护**：更新过时内容，删除无效文档
5. **分类清晰**：使用分类功能组织文档
6. **质量优先**：精选高质量文档比大量低质量文档更有效

---

**祝使用愉快！** 🎉

如有问题，请查看系统日志或联系技术支持。