开始使用
配置模型
接入 DeepSeek API、其他提供方与自定义 OpenAI 兼容端点
在 Web UI 中配置
打开 设置 → 模型：
- 输入 DeepSeek API 密钥；
- 保存后模型路由立即生效，无需重启服务器。
自定义端点
在模型页可以添加自定义提供方，填写任意 OpenAI 兼容端点的 Base URL 与密钥，即可接入其他模型服务。
环境变量（CLI / headless / 自动化）
命令行与自动化场景通过环境变量读取模型配置：
| 变量 | 作用 |
|---|---|
DEEPSEEK_API_KEY | DeepSeek API 密钥 |
DEEPSEEK_BASE_URL | 可选：自定义 Base URL |
headless 模式（dsh --profile headless "task"）与仓库的自动化测试都依赖这些变量；没有密钥时相关任务会自动跳过或失败。
密钥安全
- 不要提交密钥：不要把
.env、密钥写进代码仓库。 - 优先使用环境变量或 Web UI 设置，避免硬编码在配置文件中。
- 共享屏幕或录屏前注意隐藏密钥。
常见问题
- 模型不响应：检查密钥是否有效、网络能否访问 API 端点（见故障排查）。
- 想换模型：在设置 → 模型中切换即可，不影响已有会话记录。