DeepSeek Harness: モデル設定とAPI管理

2. アカウントを登録/ログイン
3. API Keys ページに移動
4. "Create API Key" をクリック
5. 生成された Key をコピー（sk- で始まる）

上部コントロールバー → ⚙️ Settings → Models → DeepSeek API Key
┌─────────────────────────────────────────┐
│ DeepSeek API Key                         │
│ sk-•••••••••••••••••••••••••••xxxx       │
│ [Test Connection]  [Save]                │
└─────────────────────────────────────────┘

   Model: deepseek-chat
   Latency: 120ms

# .env ファイルまたはシェルで設定
export DEEPSEEK_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

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

Settings → Models
┌──────────────────────────────────────────────┐
│ 📡 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

# dsh.config.yaml
models:
  custom:
    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       # 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"

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"