AI-VideoAssistant/docs/content/resources/faq.md

常见问题

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 配置
• 确认构建产物路径正确
• 检查文件权限设置