DeepSeek Harness: إعداد النماذج

1. زُر https://platform.deepseek.com/
2. سجّل/سجّل الدخول لحسابك
3. انتقل لصفحة API Keys
4. انقر "Create API Key"
5. انسخ المفتاح المُولَّد (يبدأ بـ sk-)

شريط التحكم العلوي → ⚙️ الإعدادات → النماذج → DeepSeek API Key
┌─────────────────────────────────────────┐
│ DeepSeek API Key                         │
│ sk-•••••••••••••••••••••••••••xxxx       │
│ [اختبار الاتصال]  [حفظ]                │
└─────────────────────────────────────────┘

✅ الاتصال ناجح!
   النموذج: deepseek-chat
   زمن الاستجابة: 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"

الإعدادات → النماذج
┌──────────────────────────────────────────────┐
│ 📡 مزودو النماذج                            │
│                                                │
│ ┌─ DeepSeek ────────────────────────────────┐ │
│ │ API Key: sk-•••••••••xxxx                 │ │
│ │ Base URL: https://api.deepseek.com/v1     │ │
│ │ النموذج الافتراضي: deepseek-chat              │ │
│ │ [اختبار] [حفظ]                             │ │
│ └───────────────────────────────────────────┘ │
│                                                │
│ ┌─ متوافق مع OpenAI ───────────────────────┐ │
│ │ API Key: sk-•••••••••xxxx                 │ │
│ │ Base URL: https://api.openai.com/v1       │ │
│ │ النموذج الافتراضي: gpt-4o                     │ │
│ │ [اختبار] [حفظ]                             │ │
│ └───────────────────────────────────────────┘ │
│                                                │
│ [+ إضافة مزود]                               │
└──────────────────────────────────────────────┘

# 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 لا يحتاج مفتاحًا حقيقيًا
    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     │
│                          │
│ ○ gpt-4o                 │
│   OpenAI · سياق 128K     │
│                          │
│ ○ llama3.2               │
│   Ollama · سياق 8K       │
└──────────────────────────┘

# 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

# تبديل النماذج خلال الجلسة (أمر داخلي لسطر الأوامر)
/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
2. أنشئ مفتاحًا جديدًا وحدّث الإعدادات
3. تحقق من سجلات استدعاء API لتأكيد عدم وجود استخدام غير طبيعي
4. راجع سجل Git للتأكد من أن المفتاح لم يُرفع (إذا رُفع، استخدم 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"