# 知识库配置修复通知

## 问题说明

如果您遇到以下情况：
- ✅ 知识库文件显示10个，但查询时AI只能看到2个
- ✅ 知识库页面出现错误：`Unsupported model 'gte-rerank-v2' for OpenAI compatibility mode`

**这是因为模型配置填写错误导致的。**

## 问题原因

**Embedding 模型** 和 **Rerank 模型** 填写混淆了！

### 错误配置示例 ❌
```
Embedding 模型: gte-rerank-v2  ← 这是Rerank模型，填错了！
Rerank 模型: qwen3-rerank      ← 正确
```

### 正确配置示例 ✓
```
Embedding 模型: text-embedding-v4  ← 正确：用于文本向量化
Rerank 模型: qwen3-rerank           ← 正确：用于结果重排序
```

## 如何修复

### 方法1：自动修复（推荐）

更新到最新版本后：
1. 系统会自动检测并修正错误配置
2. 打开"自动客服"页面
3. 进入"知识库"模块
4. 点击"重建索引"按钮
5. 等待重建完成（可能需要几分钟）

### 方法2：手动修复

1. 打开"自动客服"页面
2. 进入"知识库"模块
3. 找到模型配置区域
4. 将 **Embedding 模型** 改为：`text-embedding-v4`
5. 将 **Rerank 模型** 改为：`qwen3-rerank`（如果之前填写的是embedding模型）
6. 点击"保存配置"
7. 点击"重建索引"

## 模型选择指南

### Embedding 模型（文本向量化）
推荐使用以下模型之一：
- `text-embedding-v4` （推荐，512维）
- `text-embedding-v3` （1024维）
- `bge-large-zh`
- `gte-large`

### Rerank 模型（结果重排序）
推荐使用以下模型之一：
- `qwen3-rerank` （推荐）
- `gte-rerank-v2`
- `bge-rerank-large`

## 新版本改进

最新版本包含以下改进：
1. ✨ 自动检测并修正错误的模型配置
2. ✨ 更友好的错误提示信息
3. ✨ 输入框下方添加了说明文字和示例
4. ✨ 保存前会验证配置是否正确

## 注意事项

⚠️ **不要将模型名称混淆**：
- Embedding 模型通常包含 "embedding" 关键词
- Rerank 模型通常包含 "rerank" 关键词

⚠️ **重建索引需要时间**：
- 10个MD文件大约需要1-3分钟
- 重建期间不影响正常使用
- 重建完成后查询结果会更准确

## 验证修复

修复后，可以通过以下方式验证：

1. 查看"知识库"模块的状态
   - 知识文件数量应显示正确（如：10个）
   - 知识片段数量应显示正确（如：389个）
   - 向量片段数量应与知识片段相同或接近

2. 测试查询
   - 询问："现在知识库有哪些文件"
   - AI应该能列出所有10个文件
   - 不应再出现404错误

## 技术支持

如果按照以上步骤操作后问题仍未解决，请联系技术支持并提供：
1. 错误截图
2. 当前的模型配置截图
3. 日志文件（Log目录下的最新日志）