DeepSeek

DeepSeek 是专注于代码和数学推理的 AI 模型提供商，提供高质量的开源模型。

支持的模型

• deepseek-coder - 专门的代码模型
• deepseek-coder-instruct - 指令调优的代码模型
• deepseek-chat - 通用对话模型
• deepseek-math - 数学推理模型

配置方法

基础配置

在 config.yaml 或 ~/.bytebuddy/config.yaml 中配置：

models:
  - name: "deepseek-coder"
    provider: "deepseek"
    model: "deepseek-coder-instruct"
    apiKey: "${DEEPSEEK_API_KEY}"
    roles: ["chat", "edit"]
    defaultCompletionOptions:
      temperature: 0.2
      maxTokens: 4096

多模型配置

models:
  - name: "deepseek-coder"
    provider: "deepseek"
    model: "deepseek-coder-instruct"
    apiKey: "${DEEPSEEK_API_KEY}"
    roles: ["chat", "edit"]
    defaultCompletionOptions:
      temperature: 0.2
      maxTokens: 4096

  - name: "deepseek-math"
    provider: "deepseek"
    model: "deepseek-math"
    apiKey: "${DEEPSEEK_API_KEY}"
    roles: ["chat"]
    defaultCompletionOptions:
      temperature: 0.1
      maxTokens: 2048

配置字段说明

必需字段

• name: 模型配置的唯一标识符
• provider: 设置为 "deepseek"
• model: 模型名称
• apiKey: DeepSeek API 密钥

可选字段

• roles: 模型角色 [chat, edit, apply]
• defaultCompletionOptions:
  • temperature: 控制输出的随机性（0-2）
  • maxTokens: 最大令牌数
  • topP: 核采样参数
  • topK: 采样候选数量
  • frequencyPenalty: 频率惩罚
  • presencePenalty: 存在惩罚

环境变量配置

# ~/.bashrc 或 ~/.zshrc
export DEEPSEEK_API_KEY="your-deepseek-api-key"

获取 API 密钥

1. 访问 DeepSeek 官网
2. 注册账户并完成验证
3. 在 API Keys 页面创建新密钥
4. 将密钥保存到环境变量中

使用场景配置

代码生成

models:
  - name: "code-generator"
    provider: "deepseek"
    model: "deepseek-coder-instruct"
    apiKey: "${DEEPSEEK_API_KEY}"
    roles: ["chat", "edit"]
    defaultCompletionOptions:
      temperature: 0.2
      maxTokens: 4096

数学推理

models:
  - name: "math-solver"
    provider: "deepseek"
    model: "deepseek-math"
    apiKey: "${DEEPSEEK_API_KEY}"
    roles: ["chat"]
    defaultCompletionOptions:
      temperature: 0.1
      maxTokens: 2048

故障排除

常见错误

1. 401 Unauthorized: 检查 API 密钥是否正确
2. 429 Too Many Requests: 达到速率限制，等待后重试
3. Model Not Found: 确认模型名称拼写正确

调试步骤

1. 验证 API 密钥格式和有效性
2. 检查网络连接
3. 确认配额未超限
4. 查看错误日志获取详细信息

最佳实践

1. 安全性

• 使用环境变量存储 API 密钥
• 避免在代码中硬编码密钥
• 定期轮换 API 密钥

2. 性能优化

• 代码任务使用低温度值（0.1-0.3）
• 设置合理的 maxTokens 限制
• 根据任务选择合适的模型

3. 成本控制

• 监控 API 使用量
• 为简单任务使用基础模型
• 设置请求超时避免长时间等待