DeepSeek Harness: 模型配置

1. 访问 https://platform.deepseek.com/
2. 注册/登录账号
3. 进入 API Keys 页面
4. 点击「创建 API Key」
5. 复制生成的 Key（以 sk- 开头）

顶部控制栏 → ⚙️ Settings → Models → DeepSeek API Key
┌─────────────────────────────────────────┐
│ DeepSeek API Key                         │
│ sk-•••••••••••••••••••••••••••xxxx       │
│ [Test Connection]  [Save]                │
└─────────────────────────────────────────┘

✅ Connection successful!
   Model: deepseek-chat
   Latency: 120ms

# 在 .env 文件或 shell 中配置
export DEEPSEEK_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# dsh.config.yaml
models:
  deepseek:
    api_key: "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
    base_url: "https://api.deepseek.com/v1"

┌──────────────────────────────────────────────┐
│ 📡 Model Providers                            │
│                                                │
│ ┌─ DeepSeek ────────────────────────────────┐ │
│ │ API Key: sk-•••••••••xxxx                 │ │
│ │ Base URL: https://api.deepseek.com/v1     │ │
│ │ Default Model: deepseek-chat              │ │
│ │ [Test] [Save]                             │ │
│ └───────────────────────────────────────────┘ │
│                                                │
│ ┌─ OpenAI Compatible ───────────────────────┐ │
│ │ API Key: sk-•••••••••xxxx                 │ │
│ │ Base URL: https://api.openai.com/v1       │ │
│ │ Default Model: gpt-4o                     │ │
│ │ [Test] [Save]                             │ │
│ └───────────────────────────────────────────┘ │
│                                                │
│ [+ Add Provider]                               │
└──────────────────────────────────────────────┘

# dsh.config.yaml
models:
  deepseek:
    api_key: "${DEEPSEEK_API_KEY}"
    default_model: deepseek-chat
    params:
      temperature: 0.7
      max_tokens: 4096
      top_p: 0.95
  openai:
    api_key: "${OPENAI_API_KEY}"
    default_model: gpt-4o
    params:
      temperature: 0.5
      max_tokens: 8192

# dsh.config.yaml
models:
  openai:
    api_key: "${OPENAI_API_KEY}"
    base_url: "https://api.openai.com/v1"
    default_model: gpt-4o

# dsh.config.yaml
models:
  azure:
    api_key: "${AZURE_OPENAI_API_KEY}"
    base_url: "https://your-resource.openai.azure.com/openai/deployments/your-deployment"
    default_model: gpt-4o
    headers:
      api-key: "${AZURE_OPENAI_API_KEY}"

# dsh.config.yaml
models:
  ollama:
    api_key: "ollama"           # Ollama 不需要真实 Key
    base_url: "http://localhost:11434/v1"
    default_model: llama3.2

    api_key: "${CUSTOM_API_KEY}"
    base_url: "https://your-llm-service.com/v1"
    default_model: your-model-name
    headers:
      X-Custom-Header: "custom-value"

[deepseek-chat ▼]
┌──────────────────────────┐
│ ● deepseek-chat          │
│   DeepSeek · 64K ctx     │
│                          │
│ ○ gpt-4o                 │
│   OpenAI · 128K ctx      │
│                          │
│ ○ llama3.2               │
│   Ollama · 8K ctx        │
└──────────────────────────┘

# dsh.config.yaml
routing:
  rules:
    - match:
        mode: ptc            # PTC 模式
      model: deepseek-reasoner   # 使用推理模型做规划
    
    - match:
        tool: file_edit      # 文件编辑
      model: deepseek-coder  # 使用代码模型
    
    - match:
        mode: creative       # 创造模式
      model: gpt-4o          # 使用 GPT-4o
    
    - match:
        default: true        # 默认路由
      model: deepseek-chat

# 指定模型启动
npx @deepseek-ai/dsh cli --model gpt-4o

# 运行中切换模型（CLI 内部命令）
/model deepseek-reasoner

# .env 文件（不提交到 Git）
DEEPSEEK_API_KEY=sk-xxxxxxxxxxxxxxxx
OPENAI_API_KEY=sk-yyyyyyyyyyyyyyyy

# .env.example 文件（提交到 Git，供团队参考）
DEEPSEEK_API_KEY=your-deepseek-api-key
OPENAI_API_KEY=your-openai-api-key

# .gitignore
.env
.env.local
.env.*.local

# dsh.config.yaml — 使用 ${VAR} 引用环境变量
models:
  deepseek:
    api_key: "${DEEPSEEK_API_KEY}"    # 运行时从环境变量读取
    base_url: "https://api.deepseek.com/v1"
  openai:
    api_key: "${OPENAI_API_KEY}"
    base_url: "https://api.openai.com/v1"

# dsh.config.yaml — AWS Secrets Manager 集成（示例）
models:
  deepseek:
    api_key:
      vault: aws-secrets-manager
      secret_id: "dsh/deepseek-api-key"
      region: "us-east-1"

1. 立即在 API 提供商平台禁用/删除泄露的 Key
2. 生成新 Key 并更新配置
3. 检查 API 调用日志，确认无异常使用
4. 审查 Git 历史，确保 Key 未被提交（如已提交，使用 git filter-branch 清除）

# 测试 DeepSeek API
curl -s https://api.deepseek.com/v1/models \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY"

# 测试 OpenAI 兼容端点
curl -s https://api.openai.com/v1/models \
  -H "Authorization: Bearer $OPENAI_API_KEY"

# 测试本地 Ollama
curl -s http://localhost:11434/v1/models

# 设置 HTTP 代理
export HTTP_PROXY="http://proxy.example.com:8080"
export HTTPS_PROXY="http://proxy.example.com:8080"

# 或在配置文件中指定
# dsh.config.yaml
models:
  deepseek:
    api_key: "${DEEPSEEK_API_KEY}"
    base_url: "https://api.deepseek.com/v1"
    proxy: "http://proxy.example.com:8080"