TLDR DeepSeek Harness (dsh), DeepSeek AI’nin açık kaynak ajan çalışma zamanı olup, yaklaşık 13 Ağustos 2026’da MIT lisansı altında geliştirici önizlemesi olarak yayımlandı. “Model + Harness = Agent” ilkesini izler; tüm yetenekler (modeller, araçlar, oturumlar, kum havuzları, döngüler, arayüz) değiştirilebilir Cordis eklentileri olarak uygulanmıştır.
Yerelde çalıştırmanın en hızlı yolu npx @deepseek-ai/dsh web (Node.js ^22.19 veya ≥24 gerektirir); bu komut http://127.0.0.1:3080. adresinde bir Web UI başlatır. Bir DeepSeek (veya OpenAI uyumlu) API anahtarı ve bir çalışma alanı sağlamalısınız. Kaynak derlemeleri, masaüstü uygulamaları, Docker, Python SDK ve Ollama entegrasyonları da mevcuttur. Harness’i kullanırken üretim düzeyinde çoklu model erişimi, güvenilirlik ve maliyet kontrolü için istekleri CometAPI’nin birleşik OpenAI uyumlu uç noktasından yönlendirin.
Temel Noktalar
- DeepSeek Harness bir model değildir—modellerin dosyalar, kabuklar, araçlar ve oturumlar üzerinde işlem yapmasını sağlayan yerel çalışma zamanı/orchestrator’dır.
- Resmi tek satırlık komut:
npx @deepseek-ai/dsh web→ 3080 portunda yerel Web UI açılır. - Node.js gereksinimi katıdır: ^22.19.0 veya ≥24.x.
- DeepSeek resmi modellerini (deepseek-v4-flash, deepseek-v4-pro), OpenAI uyumlu özel ağ geçitlerini ve eklentiler/Ollama aracılığıyla yerel modelleri destekler.
- Mimari tamamen eklenti tabanlıdır (Cordis çekirdeği); kipler arasında Standard, Minimal, Code ve Creator bulunur.
- Hızlı benimseme: lansmandan sonraki birkaç gün içinde on binlerden 100k+ GitHub yıldızına doğru.
- Güç kullanıcıları için öneri: 500+ modele erişim, %20–40 maliyet tasarrufu ve tek API anahtarı için CometAPI’yle eşleyin ().
DeepSeek Harness Nedir ve 2026’da Neden Önemlidir?
DeepSeek Harness (dsh), DeepSeek AI tarafından geliştirilen açık kaynak bir ajan çalışma zamanıdır. MIT lisansı altında geliştirici önizlemesi olarak yayımlanan ürün, bileşenlenebilirliğe vurgu yapar: model adaptörleri, araçlar, beceriler, oturumlar, kum havuzları, depolama, ajan döngüleri, zamanlama ve UI dahil her yetenek, yapılandırma yoluyla bağlanıp çıkarılabilen, değiştirilebilen veya yeniden birleştirilebilen bir Cordis eklentisi olarak sunulur. Yamalanması gereken ayrıcalıklı bir çekirdek fiilen yoktur.
Ana tasarım ilkeleri şunları içerir:
- Agent = Model + Harness.
- Devam etme, çatallama, arama ve yeniden oynatma destekli izlenebilir olay akışları.
- Birden çok çalışma kipi (tam araç setli standart, kod/orkestrasyon kipi, kıyaslama için minimal kip, yaratıcı/deneysel kipler).
- Etkileşimli kullanım için yerel öncelikli Web UI ile başsız ve SDK seçenekleri.
Resmi kaynaklar:
- GitHub: https://github.com/deepseek-ai/deepseek-harness
- Ürün/landing: https://www.deepseek.com/harness/en/ (ve Çince karşılığı)
- Kurulum rehberleri ve topluluk yansıları aynı temel komutları pekiştirir.
Önemli terim notu: “yerel kurulum” iki farklı şeyi ifade edebilir. Bu rehberde ele alınan DeepSeek Harness bilgisayarınızda yerel olarak çalışır, ancak standart
deepseek-harnessprojesi DeepSeek V4-Pro veya V4-Flash ile bir API üzerinden bağlanır. Bu, harness’in, yapılandırmanın, oturumların, doğrulamanın ve istemci mantığının yerel olabileceği, model çıkarımının ise normalde DeepSeek’in API’si tarafından yapıldığı anlamına gelir. Model ağırlıklarını kendi GPU’nuzda gerçekten çevrimdışı çalıştırmanız gerekiyorsa, bu farklı bir dağıtım mimarisidir.
Önkoşullar ve Sistem Gereksinimleri
Yüklemeden önce şunları doğrulayın:
- İşletim sistemleri: Windows 10+, macOS 10.15+, ana akım Linux (x64 veya arm64). Python SDK’sının ek kısıtları vardır (Linux x64/arm64 veya macOS 14+ arm64).
- Node.js: Ana Web UI yolu için gereklidir. Hedef aralık ^22.19.0 || ≥24.0.0.
node --versionile kontrol edin. Bu aralığın dışındaki tek sayılı ara sürümler desteklenmez. - Paket yöneticileri: npm/npx (Node ile gelir). Kaynaktan derlemek için pnpm gerekir (npm install -g pnpm ile kurun).
- Git: Kaynağı klonlamak için gereklidir.
- Python (isteğe bağlı): Resmi Python SDK için 3.10+.
- API anahtarı / uç nokta: platform.deepseek.com’dan bir DeepSeek API anahtarı veya herhangi bir OpenAI uyumlu uç nokta + anahtar + model adı.
- Donanım: Harness’in kendisi için GPU gerekmez—model çıkarımı uzaktan (veya yapılandırdığınız yerel sağlayıcı aracılığıyla) yapılır. Web UI ve orkestrasyon için sıradan bir dizüstü yeterlidir.
Gereksinim kaynakları: resmi README ve lansman sonrası kısa sürede yayımlanan çok sayıda bağımsız kurulum rehberi.
Yöntem 1: Resmi npx Tek Satırı (Çoğu Kullanıcı İçin Önerilen)
Bu yol en hızlı ve resmi olarak önerilendir.
- Node.js’in sürüm gereksinimini karşıladığından emin olun.
- Bir terminal açın ve şunu çalıştırın:
Bash
npx @deepseek-ai/dsh web
- Paket indirilir (veya önbellek kullanılır), Web UI profili başlar ve dinlenen adresi yazdırır—varsayılan olarak http://127.0.0.1:3080.
- Bu URL’yi tarayıcıda açın. Görünürse geliştirici önizleme bildirimini kabul edin.
- İlk kullanımda bir model sağlayıcıyı (Ayarlar → Modeller) yapılandırın; API anahtarınızı yapıştırın ve deepseek-v4-flash veya deepseek-v4-pro gibi bir model seçin.
- Bir çalışma alanı dizini seçin veya oluşturun.
- Görevleri vermeye başlayın.
Farklı bir port kullanmak için:
Bash
npx @deepseek-ai/dsh web --port 8080
Node’un varlığını da güvenceye alan platforma özgü tek satırlar topluluk sitelerinde mevcuttur (Windows’ta PowerShell + winget, macOS’ta Homebrew, Debian/Ubuntu’da NodeSource vb.).
Artılar: npm önbelleği dışında kalıcı kurulum izi yok; her zaman güncel bir yayımlı sürümü çeker; en basit başlangıç. Eksiler: İlk paket için ağa bağımlı; derin kaynak incelemesi veya özel derlemeler için daha az elverişli.
Yöntem 2: Kaynaktan Kur ve Çalıştır
Cordis eklentilerini okumak, bir commit’i sabitlemek, özel ön ayarlar geliştirmek veya katkı yapmak istediğinizde bunu kullanın.
Bash
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web
Aynı Web UI varsayılan portta görünür. Geliştirici önizleme derlemeleri commit’ler arasında kırılabilir; bunu deneysel bir yol olarak ele alın.
Yöntem 3: Masaüstü Uygulamaları (Sıfır Node Kurulumu)
Topluluk ve üçüncü taraf masaüstü sarmalayıcıları, kullanıcıların Node/pnpm kurmasına gerek bırakmayacak şekilde çalışma zamanını paketler:
- Başlangıçta paketlenmiş bir Node çalışma zamanını başlatan ve açılışta en güncel upstream harness’i senkronize eden Tauri tabanlı hafif istemciler. 127.0.0.1:3080 üzerinde çalışır, verileri yerelde tutar ve dsh komutlarını kaydederler.
- Sabitlenmiş bağımlılıklarla gelen Electron tabanlı paketleme.
Yükleyicileri ilgili GitHub Releases sayfalarından indirin (“deepseek-harness-desktop” arayın). İlk açılışta çekirdek bileşenler (birkaç yüz MB) indirilir. Geliştirici olmayanlar için kullanışlıdır ancak resmi DeepSeek ürünleri değildir—deponun kendisini ve SHA sağlama toplamlarını gözden geçirin.
Yöntem 4: Docker / Konteyner Dağıtımı
Web UI’yi bir konteyner içinde çalıştırmak için topluluk Docker imajları ve compose dosyaları mevcuttur; sıklıkla nginx ile HTTPS uçlandırması ve rastgele OpenAI uyumlu ağ geçitleri desteği sunarlar. Tipik akış:
Bash
git clone <docker-repo>
cd <docker-repo>
cp .env.example .env # set API key / public host
docker compose up -d --build
LAN erişimi, sunucular veya host üzerinde Node istenmeyen ortamlar için yararlıdır. Bazı kurulumlar DeepSeek dışı sağlayıcılar için custom settings.yaml destekler.
Yöntem 5: Programatik / Başsız Kullanım İçin Python SDK
Gözetimsiz ajanlar veya Python hatlarına entegrasyon için:
Bash
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
python -m pip install deepseek-harness-sdk
Ortam değişkenlerini ayarlayın:
Bash
export DEEPSEEK_API_KEY=sk-your-key-here
# optional: export DEEPSEEK_BASE_URL=http://127.0.0.1:8000/v1
# optional: export DSH_MODEL=deepseek-v4-flash
Ardından depoda bulunan örnekleri çalıştırın veya kendi kodunuzda, yalıtılmış bir çalışma alanı ve oturum dizinine karşı DeepSeekHarness sınıfını kullanın. SDK kendi çalışma zamanını paketler ve sistem Node.js gerektirmez.
Yöntem 6: Ollama Entegrasyonu
Ollama bir kolay başlatıcı sağlar:
Bash
ollama launch dsh
# or with a specific model
ollama launch dsh --model deepseek-v4-flash:cloud
Web araması ve araç desteği, seçilen modele ve Ollama bulut erişimine bağlıdır.
Modelleri ve Sağlayıcıları Yapılandırma (CometAPI Dahil)
Web UI içinde Ayarlar → Modeller’e gidin.
- Resmi DeepSeek için: platform.deepseek.com’dan anahtarı yapıştırın. Tipik modeller deepseek-v4-flash ve deepseek-v4-pro’dur.
- Katalog sağlayıcıları (Anthropic, OpenAI, vb.) için: “Sağlayıcı ekle” akışını kullanın.
- Özel / self-hosted / toplayıcı uç noktalar için: “Özel sağlayıcı ekle”yi seçin. Kalıcı bir Sağlayıcı Kimliği, temel URL, protokol (genellikle openai-completions), API anahtarı ortam referansı veya değeri ve en az bir model kimliği sağlayın.
CometAPI önerisi (birçok üretime yakın iş akışı için güçlü şekilde tavsiye edilir) CometAPI, tek bir OpenAI uyumlu uç nokta üzerinden 500+ modeli (DeepSeek varyantları, GPT, Claude, Gemini, Grok ve daha fazlası) sunan birleşik bir yapay zeka altyapı platformudur: https://api.cometapi.com/v1.
DeepSeek Harness ile kullanıldığında faydalar:
- Birden çok sağlayıcı kimliği yerine tek bir API anahtarı.
- Rekabetçi fiyatlandırma (birçok modelde doğrudan satıcı fiyatlarına göre raporlanan %20–40 tasarruf).
- Yüksek erişilebilirlik (hedef 99.9% SLA), düşük medyan gecikme ve kullandıkça öde faturalama.
- Yalnızca model kimliğini değiştirerek harness yapılandırmasının ötesine geçmeden A/B testi veya maliyet optimizasyonu için kolay model değiştirme.
- Sorunsuz uyumluluk: mevcut OpenAI SDK kalıpları sadece base_url ve anahtar değişimiyle çalışır.
Harness içindeki özel sağlayıcı formunda:
- Base URL:
https://api.cometapi.com/v1 - Protocol: openai-completions (veya eşdeğer desteklenen seçenek)
- API key: CometAPI anahtarınız
- Model ID: CometAPI model kataloğundaki herhangi bir desteklenen model dizgesi
Bu kombinasyon, güçlü yerel ajan çalışma zamanını korurken esnek, uygun maliyetli ve çok satıcılı model erişimi sağlar. Yeni kullanıcılar genellikle ücretsiz deneme kredileri alır. Dokümantasyon: https://apidoc.cometapi.com/.
Anahtarlar yalnızca yazılabilir biçimde saklanır (örn. $DSH_HOME/.credentials.yaml altında); UI yalnızca maskelemiş tanımlayıcıları gösterir.
DeepSeek Harness Sorun Giderme
DEEPSEEK_API_KEY bulunamadı
Kontrol edin:
echo $DEEPSEEK_API_KEY
Windows’ta:
echo $env:DEEPSEEK_API_KEY
Boşsa yeniden yapılandırın.
400 reasoning_content hatası
Bu genellikle çıkarım/akıl yürütme yaşam döngüsünün hatalı ele alındığına işaret eder.
Uygulamanızın çok turlu düşünme/araç çağrısı istekleri boyunca ilgili asistan akıl yürütme bilgisini koruduğunu doğrulayın.
Bu, harness’in özellikle ele almak üzere tasarlandığı temel konulardan biridir.
Bağlam uzunluğu hatası
Kontrol edin:
input tokens + max_tokens
Belgelendirilmiş sert tavan:
1,048,576 tokens
Girdi bağlamını veya istenen üretim boyutunu azaltın.
Akış sırasında araç çağrıları biçim bozuluyor
Akış parçalarının araç sırasına göre geleceğini varsaymayın.
Harness sözleşmesinin önerdiği gibi tool_call.index ile araç çağrısı deltalarını birleştirin.
İstekler beklenmedik şekilde pahalı
Şunları kontrol edin:
- düşünme modu
- çıktı uzunluğu
- önbellek isabet oranı
- istem ön eki kararlılığı
- model seçimi
- mevcut API fiyatlandırması
Sık görülen basit bir iyileştirme, rutin görevleri Pro’dan Flash’a taşımaktır.
Kurulum ve Dağıtım Yöntemlerinin Karşılaştırması
Veriler resmi dokümanlar ve lansman sonrası rehberlerden sentezlenmiştir (Ağustos 2026).
Sonuç ve Sonraki Adımlar
DeepSeek Harness, npx tek satırıyla neredeyse sıfır sürtünmeyle yerel makinelere temiz tasarımlı, tamamen eklenti tabanlı bir ajan çalışma zamanı getirir. Esnek model yönlendirmeyle—özellikle CometAPI gibi birleşik bir platform aracılığıyla—modern ajan temelli kodlama iş akışlarının gücünü, maliyet, model seçimi ve veri yerelliği üzerinde pratik denetimle birleştirirsiniz.
Bugün başlayın:
npx @deepseek-ai/dsh web
Bir DeepSeek veya CometAPI anahtarı yapılandırın, güvenli bir çalışma alanına işaret edin ve Standard kipini keşfedin. Ardından kıyaslamalar için Minimal kipini, maliyet optimizasyonu için özel sağlayıcıları veya otomasyon için Python SDK’yı deneyin.
En güncel resmi talimatlar için daima GitHub deposunu ve doc bağlantısını tercih edin. Harness’i çalıştırırken çoklu model güvenilirliği ve fiyatlandırma avantajları için CometAPI ve https://apidoc.cometapi.com/. adresindeki dokümantasyonunu inceleyin.


