DeepSeek Harness ile tasarlayın.
DeepSeek Harness; bir depoyu okuyabildiği, gerçek UI kodunu düzenleyebildiği, komutları çalıştırabildiği, proje talimatlarını yükleyebildiği ve yinelemeler boyunca oturumu koruyabildiği için açılış sayfaları, ürün arayüzleri, dashboard'lar ve frontend prototipleri oluşturabilir. Kendi başına sağlamadığı şey görsel zevktir: yararlı tasarım çalışmaları için hâlâ marka kuralları, referanslar, araçlar, izinler ve sonucu render edip denetleyen bir döngü gerekir.
Arayüz çalışmalarında görev tanımını ve kabul döngüsünü açıkça belirtin. Varsayılan DeepSeek yolu yalnızca metin destekler; bu nedenle en güvenilir başlangıç noktası kod ve spesifikasyona dayalı bir iş akışıdır. Ekran görüntülerini yalnızca görsel girdisi desteklediğini belirten bir model yolu seçtikten sonra ekleyin.
Modelin yine de görsel yönlendirmeye ihtiyacı vardır. Bunu sağlamanın en kolay yolu DeepSeek Harness'ı Open Design'a bağlamaktır: Open Design design system'i, frontend skill'lerini, çıktı önizlemesini ve inceleme yüzeyini sağlar; kodlama işini dsh yapar. Bu kılavuz, resmî [DeepSeek Harness ürün sayfasından](https://www.deepseek.com/harness/) ve [kaynak deposundan](https://github.com/deepseek-ai/deepseek-harness) tamamlanmış bir arayüze kadar bu iş akışını ele alır.
DeepSeek Harness tasarım yapabilir mi?
DeepSeek Harness; bir depoyu okuyabildiği, gerçek UI kodunu düzenleyebildiği, komutları çalıştırabildiği, proje talimatlarını yükleyebildiği ve yinelemeler boyunca oturumu koruyabildiği için açılış sayfaları, ürün arayüzleri, dashboard'lar ve frontend prototipleri oluşturabilir. Kendi başına sağlamadığı şey görsel zevktir: yararlı tasarım çalışmaları için hâlâ marka kuralları, referanslar, araçlar, izinler ve sonucu render edip denetleyen bir döngü gerekir.
- Kalıcı tasarım bağlamı: Varsayılan talimat yükleyici, proje hiyerarşisindeki `AGENTS.md` ve `CLAUDE.md` dosyalarını okur. Tasarım belirteçlerini, bileşen kurallarını, duyarlı tasarım kırılma noktalarını ve inceleme ölçütlerini her çalıştırmanın görebileceği bir yere koyun.
- Yeniden kullanılabilir beceriler: Yerel beceriler `.dsh/skills` veya `.agents/skills` altında bulunabilir. Bir frontend becerisi, her kullanıcı arayüzü görevinin sıfırdan başlamasını önleyen kesin görev tanımını, kontrol listesini, örnekleri ve betikleri paketleyebilir.
- Göreve göre sağlayıcı seçimi: Web kullanıcı arayüzünde DeepSeek, Anthropic veya OpenAI gibi katalog sağlayıcıları ve OpenAI uyumlu özel uç noktalar yapılandırılabilir. Ekran görüntüsü girdisi için görsel destekli olduğu belirtilen bir yol; metin, kod, DOM ve spesifikasyona dayalı işler için yerel DeepSeek yolu kullanın.
Önemli sınır her ajan için aynıdır: birleştirilebilirlik, tasarım zevki değildir. Bilinçli tipografi, boşluk, bileşen ve etkileşim kısıtları olmadan çalışma ortamı sıradan bir sonucu sadakatle otomatikleştirir. Open Design'ın rolü, bu tasarım girdilerini sağlamak ve düzenlemektir.
1. Adım: DeepSeek Harness'ı yükleyin ve yapılandırın
Önce DeepSeek Harness'ın kendi başına çalıştığından emin olun. Test edilmiş dsh sürümünü yükleyin, ardından Open Design'ı açmadan önce API anahtarını ve modeli yapılandırmak için yerel Web UI'yi açın. Geliştirici önizlemesi Node.js `^22.19.0` veya `>=24.0.0` gerektirir.
# Open Design currently tests DeepSeek Harness 0.1.0-rc.6
# Requires Node.js ^22.19.0 or >=24.0.0
npm install -g @deepseek-ai/[email protected]
# Verify the local executable
dsh --version
# Start the local Web UI and configure a provider and model
dsh web
# Open http://127.0.0.1:3080- Harness Web UI'yi açın: `dsh web` komutunu çalıştırın. Normalde `http://127.0.0.1:3080` adresini açar; tarayıcı açılmazsa terminalin yazdırdığı adresi kopyalayın ve tam olarak o adresi kullanın.
- DeepSeek API anahtarını ekleyin: Önizleme bildirimini geçin ve istendiğinde anahtarı kaydedin veya uygulayın. İstem görünmezse Ayarlar → Modeller → DeepSeek → API Anahtarı bölümünü açın. Yalnızca anahtarı yapıştırın; `DEEPSEEK_API_KEY=...` ifadesini veya tırnak işaretlerini eklemeyin. Değişiklik hemen geçerli olur; `dsh web` işlemini yeniden başlatmanız gerekmez. Gerekirse DeepSeek Platform üzerinden bir anahtar oluşturun.
- Modeli doğrulayın, ardından kurulum UI'sini kapatın: DeepSeek sağlayıcısı yapılandırılmış olarak görünmeli ve modelleri seçicide yer almalıdır. `MISSING_CREDENTIAL` görürseniz DeepSeek kartını yeniden açıp anahtarı tekrar kaydedin. Bir test prompt'u çalıştıktan sonra `Ctrl+C` tuşlarına basın; Open Design'ı kullanırken `dsh web` açık kalmak zorunda değildir.
DeepSeek Harness sağlayıcı kimlik bilgilerini yalnızca yazılabilen sırlar olarak saklar: UI bir anahtarın yapılandırılıp yapılandırılmadığını bildirebilir, ancak düz metin anahtarı okuyamaz veya gösteremez. Open Design, kullanıcı tarafından yüklenen bu dsh'yi ve model yapılandırmasını anahtarı Open Design'a kopyalamadan yeniden kullanır. Güvenilir bir iş akışı için dsh'yi test edilmiş `0.1.0-rc.6` sürümüne sabitleyin. Üst kaynakta kimlik bilgilerinin nasıl işlendiği için resmî sağlayıcı kılavuzuna bakın.
2–5. Adımlar: DeepSeek Harness'ı Open Design'a bağlayın
dsh yerelde çalıştıktan sonra geri kalan işlemler Open Design'da yapılır. DeepSeek Harness entegrasyonu Open Design 0.19.1 ve sonraki sürümlerde kullanılabilir.
- 2 · Open Design 0.19.1 veya sonraki bir sürümü indirin: Güncel masaüstü sürümünü Open Design indirme sayfasından alın, yükleyin ve uygulamayı başlatın.
- 3 · DeepSeek Harness'ı algılayın: Ayarlar → Modeller ve sağlayıcılar → Yerel CLI bölümünü açıp Yeniden tara'yı seçin. Open Design kurulum sırasında zaten açıksa yeniden başlatın veya tekrar tarayın. Open Design, 1. adımdaki `dsh` yürütülebilir dosyasını bulduğunda DeepSeek Harness kartı görünür.
- 4 · Open Design profilini bağlayın: DeepSeek Harness kartını seçin. Kartta “Bağlantı kurulumu gerekli” yazıyorsa “Yükle ve seç” seçeneğini onaylayın. Open Design kendi bileşenini doğrular, dsh'den bunu `open-design` profiline yüklemesini ister, yeniden tarar ve bağlantıyı test eder.
- 5 · Bir tasarım görevi başlatın: Kartın Harness sürümünü ve “CLI'den eşitlendi” ifadesini gösterdiğini doğrulayıp Test'e tıklayın. Test başarılı olduktan sonra bir proje açın veya oluşturun, DeepSeek Harness ile eşitlenmiş bir model seçin ve tasarım isteğinizi gönderin.
Böylece bağlantı tamamlanır. UI ve `od agent setup deepseek-harness --json` aynı yerel kurulum yolunu kullanır; her çalıştırma `dsh --profile open-design --stdio` işlemini başlatırken Harness sonraki mesajlar için oturum kimliğini korur.
Create a polished product landing page in this workspace.
Use DESIGN.md, AGENTS.md, and the installed frontend skill as the visual contract.
Reuse the project tokens and components; include desktop and mobile states.
Run the app, inspect the rendered result, fix visible spacing and hierarchy issues,
and leave the final HTML and assets in the project for Open Design to preview.
Sınır basittir: Harness; dsh, kimlik bilgileri, modeller ve oturumları yönetir; Open Design ise doğrulanmış bağlantı profiliyle tasarım çalışma alanını yönetir. Open Design, DeepSeek AI'dan bağımsızdır; DeepSeek ve DeepSeek Harness ilgili sahiplerinin ticari markalarıdır.
UI oluşturma ve inceleme döngüsünü çalıştırın
Arayüz çalışmalarında görev tanımını ve kabul döngüsünü açıkça belirtin. Varsayılan DeepSeek yolu yalnızca metin destekler; bu nedenle en güvenilir başlangıç noktası kod ve spesifikasyona dayalı bir iş akışıdır. Ekran görüntülerini yalnızca görsel girdisi desteklediğini belirten bir model yolu seçtikten sonra ekleyin.
- dsh'yi depodan başlatın, bu dizini çalışma alanı olarak seçin ve görev için model yolunu belirleyin.
- Marka sözleşmesini `AGENTS.md`, `CLAUDE.md` veya referans verilen bir `DESIGN.md` dosyasına koyun: belirteçler, temel öğeler, boşluklar, tipografi, kırılma noktaları, durumlar ve yasaklı kalıplar.
- `.dsh/skills` veya `.agents/skills` içinden odaklı bir frontend becerisi yükleyin; örnekleri ve doğrulama betiklerini talimatların yanında tutun.
- Ajandan mevcut bileşenleri yeniden kullanmasını, uygulamayı çalıştırmasını ve duyarlı durumları projenin kendi testleri ya da tarayıcı araçlarıyla doğrulamasını isteyin.
- Görünür sonucu inceleyin, belirli farkları kaydedin ve küçük commit'lerle yineleyin. Zayıf denemeleri, kötü bir temelin üzerine düzeltmeler yığmak yerine geri alın.
Kullanışlı bir istem hem görsel kısıtları hem de doğrulama kanıtlarını belirtir:
Implement the account dashboard in React + TypeScript.
Reuse the components and tokens named in AGENTS.md and DESIGN.md.
Use a 240px sidebar, a 12-column content grid, and the documented
mobile navigation pattern. Include loading, empty, error, and focus states.
Run the app and existing UI checks, inspect desktop and mobile breakpoints,
and report the exact files and states you verified.Ekran görüntüsü vazgeçilmezse önce görsel destekli bir sağlayıcı yapılandırın. Seçili yol görsel desteği belirtmiyorsa DeepSeek Harness, görseli göndermeden önce reddeder; bu, referansın sessizce yok sayılmasını önleyen yararlı bir korumadır.
Eklentiler ve skill'lerle iş akışını yeniden kullanılabilir hâle getirin
DeepSeek Harness'ı asıl farklılaştıran, sohbet yüzeyinin altında yatanlardır. Eklenti ağacı, ekiplerin tasarım iş akışını her oturuma yapıştırılan bir istem olmaktan çıkarıp çalışma ortamının bir parçası hâline getirmesine olanak tanır.
- AGENTS.md ve CLAUDE.md: Talimat eklentisi, kullanıcı genelindeki dosyayı ve proje hiyerarşisini yükler; ardından birinci taraf dosya işlemlerinden sonra ilgili iç içe talimat dosyalarını algılar. Bunu tek seferlik istekler için değil, kalıcı tasarım kuralları için kullanın.
- Dosya sistemi becerileri: Beceri kayıt sistemi proje ve kullanıcı köklerini keşfeder, yinelenenleri sıralar ve modele yönelik bir `skill` aracı sunar. Burası frontend ustalığı, erişilebilirlik, duyarlı tasarım kalite güvencesi ve tasarım sistemi prosedürleri için doğal bir yerdir.
- Profiller ve paketler: Bir profil, sıralı eklenti paketleri ile kullanıcı yamalarını üst üste dizer. Ekipler, gerçekten ihtiyaç duydukları sağlayıcıyı, araçları, izin politikasını ve beceri kaynaklarını içeren tasarım odaklı bir bileşim sürdürebilir.
- MCP ve haricî yetenekler: Kaynak ağacında MCP istemci yetenekleri bulunur, ancak kullanıcıya dönük yapılandırma hâlâ geliştirici odaklıdır. Önizleme döneminde entegrasyonları kararlı bir onay kutusu iş akışı olarak değil, sürümlenmiş eklenti çalışmaları olarak ele alın.
Uzun ömürlü bir dâhilî iş akışı oluşturmadan önce etkin ağacı `dsh --profile web --dump-config` ile inceleyin. Bu çıktı, gerçekte nelerin bağlandığını ve yamalanabildiğini gösterir; depodaki her paketin sunulan profilde etkin olduğunu varsaymaktan daha güvenilirdir.
Görsel çıktıyı bozan hatalardan kaçının
En büyük hatalar; bir önizlemeyi kararlı bir ürün, yalnızca metin destekleyen bir yolu görüntü modeli ya da esnek bir çalışma altyapısını görsel zevk kaynağı gibi görmekten doğar.
- Özelleştirmeden önce sürümü sabitleyin: Uyumluluğu bozan değişiklikler, açık bir önizleme politikasıdır. npm sürümünü sabitleyin ve profil yamalarını yükseltme sonrasında incelenebilecek kadar küçük tutun.
- Seçilen modelin kiplerini kontrol edin: Yerel DeepSeek chat-completions yolu yalnızca metin destekler. Ekran görüntüsünden koda geçişte, ekin anlaşılacağını varsaymak yerine görsel destekli bir sağlayıcı yolu seçip bunu belirtin.
- Tasarım zevkini veri olarak sağlayın: Ajana tasarım belirteçleri, standart bileşenler, referans durumlar ve yasaklı kalıplar verin. Tasarım sözleşmesi olmayan modüler bir çalışma ortamı yine sıradan kullanıcı arayüzü üretir.
- Profilin gerçekte neleri bağladığını doğrulayın: Depo paketleri yetenek sunar; ancak varsayılan profilin bunları etkinleştirdiğini kanıtlamaz. Bir entegrasyonu belgelemeden veya ona güvenmeden önce oluşturulan yapılandırmayı inceleyin.
Her önlem, bağlam ve doğrulamayla ilgili bir karardır. Bir tasarım katmanının, her projeyi bunu yeniden keşfetmeye bırakmak yerine tekrarlanabilir hâle getirmesi gereken iş tam olarak budur.
Harness'ın tasarıma katkısı
DeepSeek Harness (`dsh`), DeepSeek AI tarafından geliştirilen MIT lisanslı bir agent harness'tır. Resmî ürün sayfası projeyi tanıtır; GitHub deposunda kaynak kod, sürüm geçmişi ve güncel tutulan kılavuzlar bulunur. Herkese açık geliştirici önizlemesi, yerel bir Web UI ve headless profiller sunar.
Belirleyici fikri, "her şey bir eklentidir" yaklaşımıdır. Cordis; model bağdaştırıcısının, araç kayıt sisteminin, ajan döngüsünün, dosya sisteminin, kabuğun, korumalı alanın, becerilerin, alt ajanların, kalıcılığın ve kullanıcı arayüzünün profiller ve paketler aracılığıyla bağlanabildiği, değiştirilebildiği ya da yamalanabildiği bir ağaç oluşturur. Birlikte sunulan `web` ve `headless` profilleri sabit ürünler değil, başlangıç noktalarıdır.
- Yerel Web kullanıcı arayüzü: `npx @deepseek-ai/dsh web`, varsayılan olarak `127.0.0.1:3080` adresinde bir tarayıcı çalışma alanı başlatır. Bir model ekleyin, çalışma alanını seçin ve görevleri sohbet arayüzünden çalıştırın.
- Başsız mod: `headless` profili yeni ve kalıcı bir oturum çalıştırır, nihai yanıtı yazdırır ve kapanır. Betik tabanlı denetimler, derlemeler ve tekrarlanabilir tasarım kontrolleri için kullanışlıdır.
- Birleştirilebilir çalışma ortamı: Profiller, eklenti paketlerini ve kendi yamalarınızı üst üste dizer. Böylece bir ekip, ajan döngüsünün ayrı bir kopyasını oluşturmadan sağlayıcıları, araçları, politikayı ve kullanıcı arayüzü davranışını değiştirebilir.
- Geliştirici: DeepSeek AI (resmî proje)
- Durum: geliştirici önizlemesi; uyumluluğu bozan değişiklikler bekleniyor
- Lisans: MIT
- Birincil komut: `npx @deepseek-ai/dsh web`
DeepSeek Harness, DeepSeek TUI ve Open Design
DeepSeek Harness ve DeepSeek TUI, farklı yürütülebilir dosyalara sahip ayrı projelerdir. Open Design artık ikisini de yerel agent olarak desteklediğinden seçim, hangisinin tasarım çalışma alanına girebildiğiyle değil, hangi çalışma zamanını istediğinizle ilgilidir.
| Araç | Nedir? | En uygun tasarım kullanımı |
|---|---|---|
| DeepSeek Harness (`dsh`) | Yerel Web UI ve headless profillere sahip, eklenti öncelikli resmî DeepSeek AI harness'ı; birinci taraf Open Design adaptörü | Open Design'ın çıktı iş akışı içinde Harness oturumlarını, sağlayıcılarını ve eklenti bileşimini kullanma |
| DeepSeek TUI (`deepseek` / `codewhale`) | Kendi Open Design adaptörüne sahip ayrı bir terminal kodlama agent'ı | Harness profil mimarisi olmadan terminal öncelikli bir DeepSeek iş akışı |
| OpenCode | Olgun, açık kaynaklı ve sağlayıcıdan bağımsız terminal ajanı | AGENTS.md ve MCP içeren kararlı bir TUI iş akışında model değiştirmek |
| Claude Code | Terminal, IDE, masaüstü ve web yüzeylerinde çalışan olgun kodlama ajanı | Frontend muhakemesi, yoğun görsel referanslar ve yerleşik tasarım entegrasyonları |
| Open Design | Desteklenen kodlama ajanlarının çevresinde oluşturulmuş, ajan odaklı tasarım çalışma alanı ve kitaplığı | Özenle seçilmiş tasarım sistemleri, beceriler, görsel çıktılar ve tek bir model sağlayıcısından bağımsız yerel iş akışı |
Resmî Web UI, profil sistemi, model kataloğu ve sürdürülebilir Harness oturumlarını istiyorsanız DeepSeek Harness'ı seçin. Bu agent'ın terminal öncelikli iş akışını tercih ediyorsanız Open Design içindeki DeepSeek TUI'ı seçin. Open Design artık ikisini de aynı tasarım süreciyle sarmalayabilse de bunlar ayrı çalışma zamanları olarak kalır.
Tasarım için DeepSeek Harness kullanımı: SSS
-
01 DeepSeek Harness nedir?
DeepSeek Harness (`dsh`), DeepSeek AI'ın resmî açık kaynaklı ajan çalışma altyapısıdır. Modelleri, araçları, bağlamı, oturumları, politikayı, orkestrasyonu ve kullanıcı arayüzünü bir Cordis eklenti ağacı aracılığıyla birleştirir. Herkese açık sürüm şu anda MIT lisansı altında bir geliştirici önizlemesidir.
-
02 DeepSeek Harness'ı nasıl kurup çalıştırırım?
Test edilmiş CLI'yi `npm install -g @deepseek-ai/[email protected]` ile yükleyin, ardından `dsh web` komutunu çalıştırın. Önizleme bildirimini geçin ve Ayarlar → Modeller → DeepSeek → API Anahtarı altında yalnızca API anahtarının kendisini kaydedin. Sağlayıcı ile modelin çalıştığını doğrulayın, Web UI'yi `Ctrl+C` ile durdurun, Open Design 0.19.1 veya sonraki bir sürümü yükleyin, Yerel CLI agent'larını yeniden tarayın, Harness kartını bağlayın ve Test'e tıklayın.
-
03 DeepSeek Harness resmî bir DeepSeek projesi mi?
Evet. Depo, `deepseek-ai` GitHub kuruluşu altında yayımlanır ve dsh'yi DeepSeek AI tarafından geliştirilen bir ajan çalışma altyapısı olarak tanımlar. MIT lisanslıdır ve açıkça geliştirici önizlemesi olarak işaretlenmiştir.
-
04 DeepSeek Harness ekran görüntülerinden kullanıcı arayüzü oluşturabilir mi?
Yalnızca seçilen sağlayıcı yolu görsel girdisini desteklediğini belirtiyorsa. DeepSeek'in dsh içindeki kendi chat-completions yolu yalnızca metin destekler ve çalışma altyapısı, görsel eklerini yalnızca metin destekleyen bir yolda göndermeden önce reddeder. Ekran görüntüleri için görsel destekli bir sağlayıcı kullanın ya da hedefi kod, DOM, belirteçler ve yazılı spesifikasyonlarla tanımlayın.
-
05 DeepSeek Harness, AGENTS.md ve becerileri destekliyor mu?
Evet. Talimat eklentisi, AGENTS.md ve CLAUDE.md uyumlu proje dosyalarını yükler. Dosya sistemi beceri sağlayıcısı ise `.dsh/skills` ve `.agents/skills` altındaki proje becerilerinin yanı sıra yapılandırılmış kullanıcı ve paket köklerini de keşfeder.
-
06 DeepSeek Harness ile DeepSeek TUI arasındaki fark nedir?
Bunlar ayrı araçlardır. DeepSeek Harness, `dsh` çalıştırılabilir dosyasını kullanır ve DeepSeek AI'ın eklenti öncelikli resmî Web kullanıcı arayüzü/başsız çalışma ortamıdır. DeepSeek TUI ise `deepseek` veya `codewhale` dağıtıcısını kullanır ve Open Design'ın şu anda desteklediği ayrı DeepSeek bağdaştırıcısıdır.
-
07 Open Design, DeepSeek Harness'ı destekliyor mu?
Evet. Open Design resmî dsh kurulumunuzu algılar, açık onayınızdan sonra Open Design'a ait doğrulanmış profil bileşenini yükler, Harness model kataloğunu eşitler ve DeepSeek Harness'ı birinci taraf yerel agent olarak çalıştırır. Open Design dsh'yi yüklemez veya Harness tarafından yönetilen sağlayıcı sırlarını almaz.
-
08 DeepSeek Harness API anahtarımı nerede saklar?
Anahtarı Open Design'da değil, DeepSeek Harness'ta yapılandırın. Resmî model kılavuzuna göre sağlayıcı anahtarları `$DSH_HOME/.credentials.yaml` içinde yalnızca yazılabilen sırlar olarak saklanır: UI bir anahtarın yapılandırılıp yapılandırılmadığını görebilir, ancak düz metin değerini okuyamaz veya gösteremez. Open Design anahtarı uygulamaya yapıştırmanızı veya Open Design yapılandırmasına yazmanızı istemez.
Open Design'da DeepSeek Harness ile tasarlayın.
Resmî dsh çalışma zamanını yükleyin, bir kez bağlayın; ardından Open Design'ın design system'lerini, skill'lerini, eşitlenmiş modellerini ve yerel çıktı önizlemelerini tek bir iş akışında kullanın.