111 lines
2.5 KiB
Markdown
111 lines
2.5 KiB
Markdown
# 常见问题
|
||
|
||
## 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` 配置
|
||
- 确认构建产物路径正确
|
||
- 检查文件权限设置
|