92 lines
2.2 KiB
Markdown
92 lines
2.2 KiB
Markdown
|
# 常见问题
|
|||
|
|
|
|||
|
|
## 如何快速切换 LLM 平台？
|
|||
|
|
|
|||
|
|
### 方式一：浏览器配置（推荐）
|
|||
|
|
|
|||
|
|
1. 访问 `http://localhost:5173/admin` 系统管理页面
|
|||
|
|
2. 在"系统配置"标签页选择不同的 LLM 提供商
|
|||
|
|
3. 填入对应的 API Key
|
|||
|
|
4. 保存并刷新页面
|
|||
|
|
|
|||
|
|
### 方式二：后端环境变量配置
|
|||
|
|
|
|||
|
|
修改 `backend/.env` 中的配置：
|
|||
|
|
|
|||
|
|
```env
|
|||
|
|
# 切换到 OpenAI
|
|||
|
|
LLM_PROVIDER=openai
|
|||
|
|
LLM_API_KEY=your_key
|
|||
|
|
|
|||
|
|
# 切换到通义千问
|
|||
|
|
LLM_PROVIDER=qwen
|
|||
|
|
LLM_API_KEY=your_key
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 遇到请求超时怎么办？
|
|||
|
|
|
|||
|
|
1. 增加超时时间：`LLM_TIMEOUT=300`
|
|||
|
|
2. 使用代理：配置 `LLM_BASE_URL`
|
|||
|
|
3. 切换到国内平台：通义千问、DeepSeek、智谱AI 等
|
|||
|
|
4. 降低并发：`LLM_CONCURRENCY=1`
|
|||
|
|
|
|||
|
|
## 如何使用 Ollama 本地大模型？
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 1. 安装 Ollama
|
|||
|
|
curl -fsSL https://ollama.com/install.sh | sh # macOS/Linux
|
|||
|
|
# Windows: 访问 https://ollama.com/download
|
|||
|
|
|
|||
|
|
# 2. 拉取模型
|
|||
|
|
ollama pull llama3 # 或 codellama、qwen2.5、deepseek-coder
|
|||
|
|
|
|||
|
|
# 3. 配置后端
|
|||
|
|
# 在 backend/.env 中设置：
|
|||
|
|
LLM_PROVIDER=ollama
|
|||
|
|
LLM_MODEL=llama3
|
|||
|
|
LLM_BASE_URL=http://localhost:11434/v1
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
推荐模型：`llama3`（综合）、`codellama`（代码专用）、`qwen2.5`（中文）
|
|||
|
|
|
|||
|
|
## 百度文心一言的 API Key 格式？
|
|||
|
|
|
|||
|
|
百度需要同时提供 API Key 和 Secret Key，用冒号分隔：
|
|||
|
|
|
|||
|
|
```env
|
|||
|
|
LLM_PROVIDER=baidu
|
|||
|
|
LLM_API_KEY=your_api_key:your_secret_key
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
获取地址：https://console.bce.baidu.com/qianfan/
|
|||
|
|
|
|||
|
|
## Windows 导出 PDF 报错怎么办？
|
|||
|
|
|
|||
|
|
PDF 导出功能使用 WeasyPrint 库，在 Windows 系统上需要安装 GTK 依赖：
|
|||
|
|
|
|||
|
|
### 方法一：使用 MSYS2 安装（推荐）
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 1. 下载并安装 MSYS2: https://www.msys2.org/
|
|||
|
|
# 2. 打开 MSYS2 终端，执行：
|
|||
|
|
pacman -S mingw-w64-x86_64-pango mingw-w64-x86_64-gtk3
|
|||
|
|
|
|||
|
|
# 3. 将 MSYS2 的 bin 目录添加到系统 PATH 环境变量：
|
|||
|
|
# C:\msys64\mingw64\bin
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 方法二：使用 GTK3 Runtime 安装包
|
|||
|
|
|
|||
|
|
1. 下载 GTK3 Runtime: https://github.com/nickvidal/gtk3-runtime/releases
|
|||
|
|
2. 安装后将安装目录添加到系统 PATH
|
|||
|
|
|
|||
|
|
### 方法三：使用 Docker 部署（最简单）
|
|||
|
|
|
|||
|
|
使用 Docker 部署后端可以避免 Windows 上的依赖问题：
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
docker-compose up -d backend
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
安装完成后重启后端服务即可正常导出 PDF。
|