Tasarım için DeepSeek Harness.
Bir model JSX yazabilir; ancak kullanışlı bir tasarım ajanı, model çıktısından fazlasına ihtiyaç duyar. Marka kuralları, referanslar, araçlar, izinler ve sonucu işleyip kontrol eden bir döngü gerekir. DeepSeek Harness, çevredeki bu parçaları gizlemek yerine erişime açar.
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.
Bu esneklik tasarım çalışmaları için kullanışlıdır; çünkü oluşturulan kullanıcı arayüzünün kalitesi modelin çevresindeki çalışma altyapısına bağlıdır: kalıcı proje kuralları, yeniden kullanılabilir beceriler, metin veya görsel girdisi için doğru sağlayıcı, dosya ve kabuk araçları ile bir doğrulama döngüsü. Bu kılavuz, çalışır durumdaki en kısa kurulumu, kullanıcı arayüzü görevlerinde önem taşıyan sınırları ve Open Design ile arasındaki gerçekçi sınırı gösterir: dsh henüz birinci taraf bir Open Design bağdaştırıcısı değildir; mevcut DeepSeek TUI bağdaştırıcısı ise farklı bir CLI'dır.
DeepSeek Harness'ı sıfırdan kurma
Herkese açık önizleme, Node.js `^22.19.0` veya `>=24.0.0` gerektirir. npm komutu, web profilini ilk kullanımda başlatır; böylece depoyu klonlamadan çalışan yerel bir kullanıcı arayüzüne ulaşabilirsiniz.
# 1. Start the official DeepSeek Harness Web UI
# Requires Node.js ^22.19.0 or >=24.0.0
npx @deepseek-ai/dsh web
# 2. Open the local UI (default)
# http://127.0.0.1:3080
# 3. In Settings → Models, add a DeepSeek API key
# or configure another supported provider.
# 4. Choose the project directory as your workspace.
# Optional: run one headless job after the profile is initialized
npx @deepseek-ai/dsh --profile headless "Audit this UI against AGENTS.md"
- Kimlik bilgileri referans olarak kalır: Web kullanıcı arayüzü, sağlayıcı sırlarını `$DSH_HOME/.credentials.yaml` içinde saklar; ayarlar bir kimlik bilgisi referansı tutar ve kullanıcı arayüzü gerçek anahtar yerine gizlenmiş bir tanımlayıcı alır.
- Önizlemeyi sürümü sabitlenmiş altyapı olarak ele alın: Bakımı üstlenenler, uyumluluğu bozan değişikliklerin yaşanacağını açıkça belirtiyor. Ekip iş akışı için sürümü sabitleyin ve güncellemeden önce sürüm değişikliklerini inceleyin.
Eklenti öncelikli bir çalışma altyapısı tasarım işlerine neden uygundur?
Bir model JSX yazabilir; ancak kullanışlı bir tasarım ajanı, model çıktısından fazlasına ihtiyaç duyar. Marka kuralları, referanslar, araçlar, izinler ve sonucu işleyip kontrol eden bir döngü gerekir. DeepSeek Harness, çevredeki bu parçaları gizlemek yerine erişime açar.
- 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.
Pratik bir DeepSeek Harness kullanıcı arayüzü ve frontend iş akışı
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, beceriler ve proje bağlamı
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.
Geliştirici önizlemesi ve tasarımla ilgili tuzaklar
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.
DeepSeek Harness gerçekte nedir?
DeepSeek Harness (`dsh`), DeepSeek AI tarafından geliştirilen MIT lisanslı bir ajan çalışma altyapısıdır. Herkese açık geliştirici önizlemesi, yerel bir Web kullanıcı arayüzü ve başsız bir çalıştırıcıyla gelir. Bu bir model ya da yalnızca bir terminal arayüzü değildir: modeli, araçları, bağlamı, izinleri, oturumları ve kullanıcı arayüzünü bir ajana dönüştüren çalışma ortamıdır.
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 ile DeepSeek TUI ve diğer tasarım ajanlarının karşılaştırması
Adları karıştırmak kolaydır. DeepSeek Harness ve şu anda Open Design'da listelenen DeepSeek TUI, farklı çalıştırılabilir dosyalara ve entegrasyon durumlarına sahip ayrı projelerdir.
| Araç | Nedir? | En uygun tasarım kullanımı |
|---|---|---|
| DeepSeek Harness (`dsh`) | Yerel Web kullanıcı arayüzü ve başsız profiller sunan, eklenti öncelikli resmî DeepSeek AI çalışma altyapısı; geliştirici önizlemesi | Bir tasarım iş akışının çevresinde çalışma ortamını, becerileri, sağlayıcıları, politikayı ve kullanıcı arayüzünü bir araya getirmek isteyen ekipler |
| DeepSeek TUI (`deepseek` / `codewhale`) | Ayrı bir terminal kodlama ajanı ve Open Design'ın şu anda desteklediği DeepSeek bağdaştırıcısı | DeepSeek'i bugün Open Design içinden kullanmak |
| 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ışı |
Genişletmek istediğiniz şey çalışma altyapısının kendisiyse dsh'yi seçin. Şu anda desteklenen DeepSeek bağdaştırıcısını ve hazır bir tasarım katmanını istiyorsanız Open Design içindeki DeepSeek TUI'ı seçin. Gelecekteki bir bağdaştırıcıyla birleşebilirler, ancak bugün birbirlerinin yerine kullanılamazlar.
DeepSeek Harness'ı ajan odaklı bir tasarım çalışma alanıyla kullanma
Open Design ve DeepSeek Harness birbirine komşu katmanlarda yer alır. dsh bir ajan çalışma ortamı oluşturur; Open Design ise bir ajanı görsel çalışmalarda kullanışlı kılan tasarım sistemlerini, becerileri ve yerel çıktı iş akışını özenle seçer. Open Design henüz özel bir `dsh` bağdaştırıcısı sunmadığı için bugün doğru iş akışı, ikisini yan yana kullanmaktır.
- Open Design'ı kurun ve projenin görsel sözleşmesini oluşturmak için tasarım sistemleri ile becerilerini kullanın.
- Ortaya çıkan `DESIGN.md` dosyasını, referansları ve proje talimatlarını DeepSeek Harness'ın çalışma alanı olarak açtığı aynı depoda tutun.
- Eklenti öncelikli deneyler ve kod görevleri için dsh'yi çalıştırın; ikinci bir tasarım özeti tutmak yerine aynı belirteçleri, kuralları, varlıkları ve doğrulama ölçütlerini yeniden kullanın.
- Bugün DeepSeek'i doğrudan Open Design içinde kullanmanız gerektiğinde mevcut DeepSeek TUI bağdaştırıcısını seçin. Gelecekteki bir dsh bağdaştırıcısını mevcut davranış olarak değil, ayrı bir entegrasyon olarak ele alın.
Sonuç, yerel öncelikli iki araçta tek bir sahipli kod tabanı ve taşınabilir tek bir tasarım sözleşmesidir. Open Design, DeepSeek AI'dan bağımsızdır; DeepSeek ve DeepSeek Harness ilgili sahibinin ticari markalarıdır.
DeepSeek Harness 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?
Desteklenen bir Node.js sürümünü kurun, ardından `npx @deepseek-ai/dsh web` komutunu çalıştırın. Varsayılan olarak yerel Web kullanıcı arayüzünü `http://127.0.0.1:3080` adresinde başlatır. Settings → Models bölümünden bir model ekleyin, çalışma alanını seçin ve bir oturum başlatı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?
Henüz özel, birinci taraf bir bağdaştırıcı olarak desteklemiyor. Open Design şu anda ayrı DeepSeek TUI bağdaştırıcısını destekler. Yine de Open Design'ın tasarım sistemlerini, becerilerini, DESIGN.md dosyalarını ve çıktılarını aynı yerel depoda dsh ile birlikte kullanabilirsiniz.
-
08 DeepSeek Harness API anahtarımı nerede saklar?
Resmî model kılavuzuna göre sağlayıcı anahtarları `$DSH_HOME/.credentials.yaml` içinde saklanır. Ayarlar yalnızca bir kimlik bilgisi referansı tutar ve Web kullanıcı arayüzü gerçek sır yerine gizlenmiş bir tanımlayıcı alır.
DeepSeek iş akışınızın çevresine tasarım katmanını kurun.
Open Design'ın yerel tasarım sistemlerini, becerilerini ve çıktı iş akışını bugün kullanın; aynı proje sözleşmesini bundan sonra seçeceğiniz ajan çalışma ortamına hazır tutun.