# 常见问题

## API Key 配置

### Q: 如何配置 API Key？

进入 **LLM 库** 或 **语音库** 页面，点击对应模型的配置按钮填写 API Key。

**步骤：**

1. 在左侧导航栏选择 **模型配置**
2. 选择 **LLM 库** 或 **语音库**
3. 点击已添加模型的 **编辑** 按钮
4. 在 API Key 字段填写你的密钥
5. 点击 **保存**

## 助手问题

### Q: 助手无法回复？

可能的原因和解决方案：

1. **检查模型配置是否正确**
   - 确认 API Key 已正确填写
   - 测试模型连接是否正常

2. **确认知识库已正确关联**
   - 进入助手配置的 **知识** 标签页
   - 检查是否已选择知识库

3. **查看系统日志排查错误**
   - 打开浏览器开发者工具（F12）
   - 检查 Console 和 Network 标签页

### Q: 助手回复内容不相关？

- 检查系统提示词是否清晰明确
- 调整 Temperature 参数（降低可提高准确性）
- 确认知识库内容与问题相关
- 增加知识库相似度阈值

## 语音识别

### Q: 语音识别不准确？

1. **确认 ASR 模型选择正确**
   - 中文场景推荐使用 SenseVoice
   - 英文场景推荐使用 Whisper

2. **检查音频采样率**
   - 推荐采样率：16kHz
   - 推荐格式：PCM 16-bit

3. **确认语言设置匹配**
   - 在 ASR 配置中选择正确的语言

### Q: 语音延迟较高？

- 检查网络连接稳定性
- 尝试切换 ASR 服务提供商
- 降低音频质量以减少传输数据量

## 语音合成

### Q: TTS 声音不自然？

- 尝试不同的音色选项
- 调整语速参数（推荐 0.8-1.2）
- 选择与内容风格匹配的声音

### Q: TTS 无法播放？

1. 检查浏览器是否允许自动播放音频
2. 确认 TTS API Key 配置正确
3. 检查网络连接

## 知识库

### Q: 知识库检索无结果？

- 确认文档已成功上传
- 降低相似度阈值（默认 0.7）
- 增加返回结果数量
- 检查文档内容是否与查询相关

### Q: 文档上传失败？

- 检查文件大小是否超过 10MB
- 确认文件格式支持（MD/PDF/TXT）
- 尝试减小文档内容

## 部署问题

### Q: 页面空白或加载失败？

1. 检查浏览器控制台错误信息
2. 确认后端服务已启动
3. 检查 VITE_API_URL 环境变量配置

### Q: API 请求失败？

- 确认 VITE_API_URL 配置正确
- 检查后端服务是否运行
- 查看网络请求响应状态码

### Q: 静态资源 404？

- 检查 Nginx `try_files` 配置
- 确认构建产物路径正确
- 检查文件权限设置
