Initial qiwei secondary development handoff

config/docs/用户通知_知识库配置修复.md

@@ -0,0 +1,101 @@
+# 知识库配置修复通知
+
+## 问题说明
+
+如果您遇到以下情况：
+- ✅ 知识库文件显示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目录下的最新日志）