DeepSeek Harness kurulum ve sürüm hataları nasıl çözülür?
DeepSeek Harness kurulumunda yaşanan sürüm çakışmalarını gidermek için belirli bir sürümü sabitleyin, npx önbelleğini temizleyin ve aktif npm yolunu kontrol edin.
DeepSeek Harness kurulumunun gerçek mahiyeti
DeepSeek Harness kurulumu tek bir komuttan ibarettir: npx @deepseek-ai/dsh web. Bir yükleyici veya yapılandırılacak bir servis yoktur. Kullanıcıların karşılaştığı sorunların çoğu kurulumla ilgili değildir. Sorun, sürüm çözümlemesidir: npx'in bugün hangi @deepseek-ai/dsh sürümünü çalıştırmaya karar verdiği ve Node.js sürümünüzün bunu çalıştırıp çalıştıramayacağıdır. Başladığında varsayılan bağlama localhost'tur; --host ve --port dinleyici ayarlarını geçersiz kılar ve yapılandırıldığında yazdırılan adres --public-url kullanır. Varsayılan bağlama ve Web arayüzünün neden sadece 127.0.0.1:3080 adresinde yanıt verdiği bu sayfadaki sorunlardan ayrı bir konudur.
Aşağıdaki her şeyi iki gerçek belirler. Birincisi, 27 Ekim 2026 itibarıyla npm üzerinde yayınlanan her @deepseek-ai/dsh sürümü bir ön sürümdü. Çoğu sürüm adayıdır (-rc.N) ve 30 Ağustos 2026'dan beri alfa sürümleri (-alpha.N) de mevcuttur. latest etiketi bir sürüm adayını işaret eder. 6 Kasım 2026 itibarıyla bu 0.2.2-rc.1 sürümüdür. İkincisi, proje README dosyası harness'ın geliştirici önizlemesi aşamasında olduğunu, hızla değiştiğini ve uyumluluğu bozan değişiklikler içereceğini belirtir. Geçen hafta çalışan bir bayrak bu hafta kaldırılmış olabilir. Üzerine bir şey inşa etmeden önce sürümü sabitleyin.
Önce bazı terimler. dsh, DeepSeek Harness komut satırı aracıdır. Node.js, ihtiyaç duyduğu JavaScript çalışma zamanıdır. npx, npm (node package manager) ile birlikte gelen paket çalıştırıcıdır ve bir paketi kalıcı olarak yüklemek yerine talep üzerine getirir. Eğer bu cümlede harness kelimesi alışılmadık bir anlamda kullanılıyorsa, bir agent harness, modelin etrafına sarılmış programdır; döngüyü, araçları, izinleri ve oturum durumunu tutar. Bu nedenle, seçmediğiniz bir sürüm numarası agent'ınızın davranışını değiştirebilir.
dsh hangi Node.js sürümüne ihtiyaç duyar?
Deponun 0.2.1-alpha.2 sürümünde olduğu 10 Ekim 2026 tarihinde, kök dizindeki package.json dosyası "engines": {"node": "^22.19.0 || >=24.0.0"} değerini beyan ediyordu. Bu artık geçerli bir gereksinim değildir. 27 Ekim 2026 tarihinde, depo 0.2.1-rc.3 sürümündeyken yapılan incelemede, kök dizindeki package.json dosyasının "engines": {"node": ">=24.9.0"} değerini beyan ettiği ve CLI kaynak kodundaki package.json dosyasının da aynı değeri belirttiği görülmüştür. 15 Ekim 2026 tarihli bir proje karar notuna göre, Node 22 kurulumlarının yükseltilmesi gerektiği ve Node 24.0 sürümünün de yeterli olmadığı belirtilmiştir; bunun nedeni, giriş noktalarının 24.0 sürümünde bulunmayan import.meta.main özelliğine ihtiyaç duymasıdır. Bu nedenle Node 24.9.0 veya daha yeni bir sürüm gereklidir. Node 20, Node 22 ve 24.9.0 öncesindeki tüm Node 24 sürümleri desteklenmemektedir. 27 Ekim 2026 tarihinde yapılan kontrolde, 0.2.1-rc.2 için yayın etiketlerinin, ardından latest yapısının işaret ettiği noktaların ve 0.2.1-rc.3 dosyasının hala eski aralığı taşıdığı görülmüştür; dolayısıyla yeni alt sınır bu tarihlerden sonra belirlenmiştir. Projenin şu an beyan ettiği aralık bu olduğu için yine de 24.9.0 sürümünü hedefleyin.
Her şeyden önce mevcut sürümünüzü kontrol edin.
node -v
npm -vİnsanları şaşırtan kısım burasıdır. 27 Ekim 2026 itibarıyla, yayınlanmış olan @deepseek-ai/dsh paketi, 0.2.1-rc.4 sürümüne kadar olan 38 sürümünün hiçbirinde kendi engines alanını taşımıyordu. Monorepo kök dizini bir değer beyan eder ancak bu kök dosya npm üzerinde asla yayınlanmaz. CLI kaynak kodundaki package.json dosyası 15 Ekim 2026 tarihli bir commit ile bu alanı kazanmıştır ancak 27 Ekim 2026 tarihinde kontrol edilen yayınlanmış yapıların hiçbiri bu alanı içermiyordu. Bu nedenle söz konusu yapılar, npm'e kontrol etmesi için dsh'ye özgü bir Node gereksinimi sunmuyordu. 6 Kasım 2026 itibarıyla, yayınlanmış 0.2.2-rc.1 paketi "engines": {"node": ">=24.9.0"} değerini beyan etmektedir. npm, engine-strict ayarını yapmadığınız sürece engines değerini yalnızca bir tavsiye olarak görür; bu nedenle varsayılan ayarlarda en fazla bir uyarı almayı bekleyin. Desteklenmeyen bir Node sürümünde kurulum başarılı görünür ancak hata, yüklü kod çalışma zamanınızda bulunmayan bir sözdizimine veya API'ye dokunduğunda ortaya çıkar. Hangi satırın ilk önce hata vereceği hangi modülün önce yüklendiğine bağlı olduğundan, arama yapabileceğiniz tek bir kararlı hata dizgisi yoktur. Hata mesajını okumak yerine node -v dosyasını okuyun.
Eğer Node sürümünüz çok eskiyse, bir VPS üzerinde en az müdahaleci çözüm nvm (node version manager) kullanmaktır; çünkü bu araç kurulumu ev dizininizin altına yapar ve sistemin kendi Node sürümüne dokunmaz.
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.6/install.sh | bash
exec $SHELL -l
nvm install 24
nvm use 24
node -vnode -v komutu artık v24. ile başlayan bir sürüm yazdırmalıdır. Eğer kabuk hala eski sürümü bildiriyorsa which node komutunu çalıştırın. ~/.nvm dışındaki bir yolun genellikle iki nedeni vardır. Ya nvm kabuk fonksiyonu yüklenmemiştir (yeni bir oturum açıp tekrar deneyin) ya da kabuk profilinizdeki bir satır, nvm'in kaynaklandığı satırlardan sonra PATH değişkenini değiştirerek başka bir Node sürümünü öne alıyordur; bu satırı nvm satırlarının üzerine taşıyın. Node 24, 10 Ekim 2026 tarihinde aktif LTS (uzun süreli destek) hattıydı ve 20 Ekim 2026 tarihinde bakım aşamasına geçti. 29 Ekim 2026 itibarıyla en yeni sürümü olan 24.22.2, 24.9.0 alt sınırının oldukça üzerindedir. >=24.9.0 aralığının da izin verdiği Node 26, 28 Ekim 2026 tarihinde 26.13.0 sürümüyle aktif LTS aşamasına girmiştir. Her iki sürüm de alt sınırı karşılar ve her ikisi de aşağıda ele alınan range-cache düzeltmesini içeren npm sürümleriyle birlikte gelir. Resmi Node 26 Linux ikili dosyaları ayrıca libatomic gerektirir; dağıtımınızın bunu ayrıca kurması gerekebilir.
npx neden her gün farklı bir sürüm çalıştırıyor?
npx @deepseek-ai/dsh web herhangi bir sürüm belirtmez. Mevcut dizininizde halihazırda yüklü bir @deepseek-ai/dsh yoksa (bu durumda npx yerel kopyayı çalıştırır), npx kayıt defterine latest etiketinin işaret ettiği sürümü sorar. Bu etiket sık sık değişir. 0.1.0-rc.8, 0.1.0-rc.7 sürümünden iki gün sonra, 19 Ağustos 2026 tarihinde yayınlanmıştır. 10 Ekim 2026 itibarıyla latest etiketi 0.2.0-rc.2 sürümünü, 27 Ekim 2026 itibarıyla ise 0.2.1-rc.2 sürümünü işaret etmekteydi. Etiket her değiştiğinde, notlarınızdaki komut herhangi bir uyarı veya değişiklik günlüğü sunmadan farklı bir kod çalıştırmaya başlar.
Komut satırı üzerinden tüm hareketli parçaları inceleyebilirsiniz.
npm view @deepseek-ai/dsh dist-tags
npm view @deepseek-ai/dsh versions --json
npm view @deepseek-ai/dsh time --jsondist-tags, latest etiketinin şu anda nereyi işaret ettiğini gösterir. 10 Ekim 2026 tarihinde hem latest hem de next etiketleri 0.2.0-rc.2 sürümünü işaret ederken, üçüncü bir etiket olan alpha, bir gün önce yayınlanan 0.2.1-alpha.2 sürümünü işaret etmekteydi. 27 Ekim 2026 tarihinde latest etiketi 0.2.1-rc.2 sürümünü, bir gün önce yayınlanan next etiketi 0.2.1-rc.4 sürümünü ve alpha etiketi ise 0.2.1-alpha.5 sürümünü işaret etmekteydi. 6 Kasım 2026 itibarıyla latest etiketi 0.2.2-rc.1 sürümünü işaret etmektedir. 4 Kasım 2026 tarihinde next etiketi 0.2.1-rc.5 sürümünü, alpha etiketi ise 0.2.2-alpha.3 sürümünü işaret etmekteydi. latest etiketi hala bir ön sürümü (prerelease) seçmektedir. versions listesi daha ilgi çekicidir çünkü içerisinde boşluklar barındırır. 10 Ekim 2026 tarihinde bu liste, 0.0.1-rc.1 sürümünden 0.2.1-alpha.2 sürümüne kadar 31 sürüm içermekteydi; 27 Ekim 2026 itibarıyla ise tamamı ön sürüm olan 38 sürüm içermekteydi. 0.0.1 hattı -rc.2 sürümünden -rc.5 sürümüne, 0.1.0 hattı -rc.3 sürümünden -rc.6 sürümüne atlamakta; alfa sürümleri 0.1.2-alpha.2 ve 0.1.3-alpha.2 ile başlamakta ve listede hiç 0.1.4 bulunmamaktadır. Yayınlanan listede bazı numaralar eksiktir; alfa sürümleri ve aday sürümler (release candidate) aynı liste içerisinde iç içe geçmiştir. Bir dağıtım betiğinde (deploy script) bir sonraki -rc.N sürümünü tahmin etmek başarısızlıkla sonuçlanacaktır; bu nedenle numaraları yukarı doğru saymak yerine listeyi okuyun.
npx neden eski bir sürümü çalıştırmaya devam ediyor?
Bu, diğer şikayetin tam tersidir ve paket belirtimine, yerel kuruluma ve çalıştırdığınız npm sürümüne bağlı olarak her ikisi de doğrudur.
npx, npm önbelleği içindeki _npx adlı bir klasörde, tarball önbelleğinden ayrı kendi paket dizinini tutar. Yolu yazdırın ve inceleyin.
npm config get cache
ls "$(npm config get cache)/_npx"npm 10.9.3, bir proje kurulumu dışındaki çıplak paket adları için kayıt defterini (registry) zaten kontrol eder. npm 11.2.0, sürüm aralıkları için önbellek tazelik kontrollerini değiştirdi. Belirtim çıplak bir isim olduğunda ve paket mevcut projede zaten kurulu değilse, npx manifesti preferOnline: true ile getirir ve _npx içindeki önbelleğe alınmış kopyayı yalnızca çözümlenen tarball kayıt defterinin döndürdüğüyle eşleştiğinde yeniden kullanır. Çıplak bir isim, kayıt defteri kontrolü olmaksızın mevcut projenin kurulu olan herhangi bir sürümüyle eşleşmeye devam eder. Bir sürüm aralığı için npm 10.9.3, eşleşen önbelleğe alınmış bir sürümü kabul eder; npm 11.2.0 ve daha yenileri ise aralığın daha yeni bir şeye çözümlenip çözümlenmediğini kontrol eder.
Hangi davranışla karşılaşacağınız, fiilen çalıştırdığınız npm sürümüne bağlıdır. npm'i npm install -g npm ile ayrıca yükseltmediyseniz, bu sürüm Node sürümünüzle birlikte gelen npm'dir:
- Node 20.20.2, npm 10.8.2 ile gelir.
- Node 22.19.0, npm 10.9.3 ile gelir.
- 27 Ekim 2026 itibarıyla en yeni 22 sürümü olan Node 22.23.4, npm 10.9.9 ile gelir.
- Harness'ın mevcut alt sınırı olan Node 24.9.0, npm 11.6.0 ile gelir.
- Node 24.19.0, npm 11.17.0 ile gelir.
- 29 Ekim 2026 itibarıyla en yeni 24 sürümü olan Node 24.22.2, npm 11.19.1 ile gelir.
- 29 Ekim 2026 itibarıyla en yeni 26 sürümü olan Node 26.13.0, npm 11.20.0 ile gelir.
Dolayısıyla tüm Node 22 serisi, 11.2.0'dan daha eski bir npm ile gelir. Harness, Ekim 2026 ortasına kadar Node 22'yi destekliyordu ancak artık desteklemiyor; yine de o tarihten önce dsh çalıştıran bir sunucu hala bu sürümde olabilir. Node 22.19.0 ile gelen npm 10.9.3, proje kurulumu dışındaki çıplak bir npx @deepseek-ai/dsh web paketini kayıt defterine karşı zaten yeniden kontrol eder, bu nedenle yalnızca eski bir _npx girdisi, eski bir sürüm adayını açıklamaz. Harness'ın artık kabul ettiği 24.9.0 ve üzerindeki her Node sürümü, aralık önbelleği düzeltmesini de içeren npm 11.6.0 veya daha yenisini içerir. Bir proje kurulumu yine de öncelik kazanabilir. Araca ne olduğunu sorun:
npx @deepseek-ai/dsh --versionnpx önbelleğini temizleme
npm 11.2.0 ve sonraki sürümlerde özel alt komutlar bulunur.
npm cache npx ls
npm cache npx rm --force--force olmadan npm her şeyi silmeyi reddeder ve Please use --force to remove entire npx cache çıktısını verir. Tüm girdiler yerine anahtara göre tek bir girdiyi kaldırmak istediğinizde önce npm cache npx ls kullanın.
npm 10 sürümlerinde bu alt komutlar mevcut değildir, bu yüzden dizini kendiniz silin.
rm -rf "$(npm config get cache)/_npx"npm cache clean --force burada işe yaramaz. Bu komut, tarball deposu olan _cacache'ü temizler ve _npx'e dokunmaz. Bu ayrım, npm'in daha sonra npm cache npx alt komutlarını eklemesinin tam nedenidir. _npx'yı temizlemenin kalıcı bir maliyeti de yoktur: burası indirilen paketleri tutar, oysa harness durumunuz $DSH_HOME altında, profiles/<name>, sessions, storages ve .credentials.yaml dahil olmak üzere ayrı olarak yaşar ve bu işlemden etkilenmez.
Tam bir sürüm adayı nasıl sabitlenir?
-rc.N kısmını da içerecek şekilde tam sürüm dizisini belirtin.
npx --yes @deepseek-ai/dsh@0.1.0-rc.7 webBu sayfadaki örnekler 0.1.0-rc.7 kullanmaktadır. Gerçekte test ettiğiniz derlemeyi kullanın. 27 Ekim 2026 itibarıyla latest etiketi 0.2.1-rc.2 sürümünü işaret etmekteydi.
--yes, npx'in paket yükleme onayını etkileşimli bir istem olmadan kabul eder.
Tam bir sürüm belirtmek dsh paketini sabitler ancak çevrimdışı başlatmayı garanti etmez. npx, önbellek dizinini yazdığınız belirtim dizisine göre anahtarlar ve orada halihazırda yüklü olan tam bir sürümü yeniden kullanabilir. Ancak eşleşen bir yerel kurulum yoksa, önceki yerel ağaç denetimi _npx dosyasını incelemeden önce preferOnline: true ile manifest dosyasını getirir. Yerel projede yüklü olan eşleşen tam bir sürüm, bu manifest aramasını engeller. dsh paketini yükleyen bir proje dışında çalıştırılan çıplak bir isim de, npm 10.9.3 dahil olmak üzere bir manifest araması tetikler.
Global bir kurulum da aynı şekilde sabitleme yapar ve size kısa bir komut sağlar.
npm install -g @deepseek-ai/dsh@0.1.0-rc.7
dsh --version@deepseek-ai/dsh@^0.1.0 için eşleşen sürüm bulunamadı
27 Ekim 2026 itibarıyla, düz bir şapka (caret) veya tilde aralığı bu paketle başarısız olmuştur. npm install -g @deepseek-ai/dsh@^0.1.0, ETARGET hata kodu ve No matching version found for @deepseek-ai/dsh@^0.1.0. satırı ile yanıt vermiştir. Kayıt defteri (registry) düzgün çalışmaktadır. Bu bir semver kuralıdır: Bir sürüm aralığı, aralığın kendi karşılaştırıcılarından biri aynı ana, ikincil ve yama numaralarına sahip bir ön sürümü (prerelease) adlandırmadığı sürece bir ön sürümle eşleşmez. 27 Ekim 2026 itibarıyla bu paketin yayınlanan her derlemesi, ya -rc.N ya da -alpha.N şeklinde bir ön sürümdü ve ^0.1.0 hiçbirini adlandırmadığı için hiçbir şeyle eşleşmedi. Tam sürümü yazın.
Bu kural iki yönlü işler. Düz bir aralık asla yeni bir sürüm adayına kaymaz, ancak bir ön sürümü adlandıran bir aralık kayabilir. ^0.1.0-rc.7, >=0.1.0-rc.7 <0.2.0-0 anlamına gelir; bu nedenle 0.1.0-rc.8 sürümünü kabul eder ve nihai 0.1.0 sürümünü de kabul ederdi, ancak 0.1.1-rc.1 numaraları farklı olduğu için kapsam dışında kalır. Bu, tam bir sürüm ile hareketli bir etiket arasında yarı sabitlenmiş bir durumdur ve siz hiçbir şeyi değiştirmeden çalışan sürümü değiştirir. Test ettiğiniz derlemeyi ve başka hiçbir şeyi istemiyorsanız, tam sürümü yazın.
npx mi yoksa dsh'yi global olarak mı kurmalıyım?
İlk inceleme için npx kullanın; paket, artık nasıl temizleyeceğinizi bildiğiniz bir önbellek dizininde tutulur. VPS üzerinde çalışır durumda kalması gereken bir coding agent gibi işlemler için sürümü sabitlenmiş bir global kurulum kullanın: VPS üzerinde çalışır durumda tuttuğunuz bir coding agent.
İkisini de kullandığınız bir sistemde sonuçlar farklı olabilir. Bu nedenle karşılaştırma yapın.
which dsh
dsh --version
npx @deepseek-ai/dsh --versionwhich dsh başarılı bir global kurulumun hemen ardından hiçbir sonuç göstermiyorsa bunun nedeni neredeyse her zaman npm'in global bin dizininin PATH içinde bulunmamasıdır. Kök dizini yazdırmak için npm prefix -g komutunu çalıştırın. İkili dosyalar, bu dizinin altındaki bin klasöründe bulunur.
Bir güvenlik notu. npx yeni bir şey çözümlerken registry'den kod indirir ve çalıştırır. Sunucuda bu durum teorik değil, gerçek bir güvenlik açığı oluşturur. Sürümü sabitlemek çözümün bir parçasıdır. Diğer bölümde şu konu açıklanmaktadır: npm supply chain saldırıları sunucuya nasıl ulaşır.
Geliştirici önizlemesinin tekrarlanabilirlik açısından anlamı
0.1.0-rc.6 13 Ağustos 2026 tarihinde, 0.1.0-rc.7 ise 17 Ağustos 2026 tarihinde yayımlandı. Aralarında dört gün var. O tarihten bu yana hız kesilmedi: 19 Ağustos ile 9 Ekim 2026 arasında 24 sürüm daha yayımlandı; buna 28 Eylül'deki 0.2.0-rc.1 ve ertesi günkü 0.2.0-rc.2 de dahil. 14 ile 26 Ekim 2026 arasında ise 0.2.1-rc.4 sürümüne kadar yedi sürüm daha geldi. Bu hızda, bir ay önce yazılan talimatlar artık var olmayan bir komut satırını tarif edebilir; bu sayfa da buna dahildir. Yazdığınız her sürüm iddiasını, kendi notlarınız dahil, tarihleyin.
İki alışkanlık, önizleme sürecini yönetilebilir kılar. Her komutta ve her betikte tam sürümü sabitleyin; böylece bir sunucuyu yeniden oluştururken aynı dsh sürümü seçilir. Bu tek başına bağımlılıkları yeniden oluşturmaz: yayımlanan 0.2.2-rc.1 paketi js-yaml: ^4.3.2 ve commander: ^15.0.0 gibi aralıklar kullanır ve npm shrinkwrap dosyası içermez. Tekrarlanabilir bağımlılık kurulumları için dsh'yi yerel bir projede tutun, package-lock.json dosyasını commit edin ve npm ci ile yeniden oluşturun. Ardından yardım çıktısını herhangi bir kılavuzdan değil, sabitlediğiniz yapıdan okuyun.
npx @deepseek-ai/dsh@0.1.0-rc.7 --help
npx @deepseek-ai/dsh@0.1.0-rc.7 web --dump-configTekrarlanabilirliğin ikinci yarısı profildir. dsh --profile <name>, $DSH_HOME/profiles/<name> dizininde saklanan profili başlatır; web ve headless profilleri ise ilk kullanımda sunulan şablonlardan kendilerini oluşturur. Profil yaması model ve uç nokta ayarlarını tutabilir, ancak kaydedilen API anahtarları $DSH_HOME/.credentials.yaml içinde yaşar. Ayarlar kimlik bilgisi referanslarını koruduğu için, sabitlenmiş bir sürüm ile çalışan bir yapılandırma, doğru yapılması gereken iki ayrı konudur. Ev dizini seviyesindeki ve komut satırı yamaları, profil ayarlarını geçersiz kılabilir. Dahili paketler, o an çalışan dsh kurulumundan çözümlenir; bu da sabitlenmiş sürümünüzü değiştirmenin bu paketleri de değiştireceği anlamına gelir. Dış kaynaklı eklentiler farklı davranır. Bunlar profil dizininde yaşar ve dsh plugin --profile <name> add <package>, argümanlarını yüklenmeleri için pnpm'e iletir. Bu nedenle pnpm'in PATH üzerinde bulunması gerekir; dsh, pnpm bulunmadığında bunu açıkça belirtir. Eklediğiniz her eklenti, aracınızın sahip olduğu izinlerle çalışır; bu da bir eklentiyi yüklemeden önce nelere erişebileceğini kontrol etmeyi gerektirir. Profilin kendi package.json dosyası bu eklentileri tanımlar; pnpm-lock.yaml dosyasını koruyun ve bağımlılık sürümlerini de tekrarlamak için pnpm install --frozen-lockfile kullanın.
Python araçlarını bir sunucuda yalıtılmış ortamlarda tuttuysanız, bu ayrım size tanıdık gelecektir: araç ve ona eklediğiniz şeyler ayrı yerlerde sabitlenir. Harness başladığında, bir sonraki soru genellikle sürümlerden ziyade ağ ile ilgilidir; bu noktada uzak bir VPS üzerinde dsh Web arayüzüne erişim ve DeepSeek Harness'in bir VPS üzerine kurulumu rehberleri devreye girer.
Gerçekte karşılaşacağınız argüman hataları
Bu hatalar CLI'ın kendi ayrıştırıcısından kaynaklanır ve her biri tam olarak sorunun ne olduğunu belirtir. İfadeler sürümler arasında büyük ölçüde sabit kalmıştır ancak tamamen değil; bu nedenle aşağıdaki mesajlar 6 Ekim 2026 tarihinde 0.2.0-rc.2 üzerinde kontrol edilmiştir.
error: --profile <name> is required
npx @deepseek-ai/dsh komutunu alt komut ve profil belirtmeden çalıştırdınız. Yalın komut bir profil başlattığı için bir isme ihtiyaç duyar. dsh web, --profile olmadan çalışır çünkü ayrıştırıcı, girilen ilk kelimeyi profil ismi olarak okur ve sizin için yüklü gelen web profilini başlatır.
error: --patch needs a path
--patch komutundan sonra hiçbir şey belirtilmedi. Bu bayrak tekrarlanabilir ve her kullanım bir dosya yolu gerektirir.
error: --dump-config and --dump-default-config are mutually exclusive
Birini seçin. 6 Ekim 2026 tarihinde işaret edilen latest sürümü olan 0.2.0-rc.2 içerisinde, mesaj üçüncü bir bayrağı belirtir ve error: --dump-config, --dump-default-config, and --dump-config-schema are mutually exclusive şeklinde görünür; çünkü profil girdileri ve yamalar için JSON şeması yazdıran --dump-config-schema, diğer ikisine katılmıştır. --dump-default-config, yüklü gelen paket katmanlarını yazdırır ve herhangi bir --patch kabul etmez. --dump-config, bir profil için oluşturulmuş yapılandırmayı yazdırır. Her üçü de harness'ı başlatmaktan kaçınır ancak şema toplama işlemi eklenti modüllerini içe aktarır ve getter'lar ile lazy builder'ları tetikleyebilir; yalnızca güvenilir eklentileri inceleyin ve betiklerinizde harici bir zaman aşımı uygulayın.
error: plugin needs pnpm arguments to forward (e.g. add <package>)
dsh plugin --profile <name> komutuna iletilecek hiçbir şey verilmedi. Alt komut, eksik olduğunda profili başlatır ve ardından komut satırının geri kalanını pnpm'e devreder; bu nedenle add @scope/dsh-plugin-example gibi argümanlara ihtiyaç duyar.
FAQ
DeepSeek Harness hangi Node.js sürümüne ihtiyaç duyar?
Node.js 24.9.0 veya daha yeni bir sürüm gereklidir. 27 Ekim 2026 tarihinde, 0.2.1-rc.3 sürümündeki depo incelendiğinde, kök dizindeki package.json dosyasının >=24.9.0 değerini tanımladığı görülmüştür. 10 Ekim 2026 tarihinde bu değer ^22.19.0 || >=24.0.0 olarak belirtilmişti; ancak 15 Ekim 2026 tarihli bir proje kararı ile Node 22 desteği kaldırılmış ve alt sınır 24.0 üzerine çekilmiştir. Node 20 ve Node 22 sürümleri çalışmayacaktır; aynı şekilde 24.9.0 sürümünden eski Node 24 sürümleri de desteklenmemektedir. 27 Ekim 2026 itibarıyla yayınlanan hiçbir npm paketi kendi engines alanına sahip değildi; bu nedenle npm, dsh'nin kendi Node gereksinimine dayanarak uyarı veremiyor veya engelleme yapamıyordu; desteklenmeyen bir çalışma zamanı kullanıldığında ise süreç daha sonra başarısız oluyordu. 6 Kasım 2026 tarihinde kontrol edilen yayınlanmış 0.2.2-rc.1 paketi, artık engines.node içerisinde >=24.9.0 değerini beyan etmektedir; npm varsayılan olarak uyarı verir ve engine-strict etkinleştirildiğinde uyumsuz bir çalışma zamanını reddeder. Öncelikle node -v komutunu kontrol edin. Alt sınırı karşılayan her Node sürümü, npm 11.2.0 ile gelen npx range-cache düzeltmesini içeren npm 11 veya daha yeni bir sürümü beraberinde getirir.
npx'i önbelleğe alınmış sürüm yerine en yeni dsh sürümünü kullanmaya nasıl zorlarım?
npm 10.9.3 ve güncel npm sürümleri, mevcut dizin dsh kurulu bir proje değilse, yalın paket isimleri için kayıt defterini (registry) zaten yeniden kontrol eder; eğer proje dizinindeyseniz npx yerel kopyayı çalıştırır. Kayıt defterinin latest etiketini açıkça talep etmek için npx @deepseek-ai/dsh@latest --version kullanın. npm 11.2.0, yalın isimler için değil, sürüm aralıkları için tazelik kontrollerini değiştirmiştir. npm 11.2.0 ve daha yeni sürümlerde npx önbelleğini npm cache npx rm --force ile temizleyin veya npm 10 kullanıyorsanız klasörü rm -rf "$(npm config get cache)/_npx" ile silin. Ardından npx @deepseek-ai/dsh --version ile doğrulayın. npm cache clean --force komutunun farklı bir dizini temizlediğini ve bu sorunu çözmeyeceğini unutmayın.
@deepseek-ai/dsh@^0.1.0 kurulumu neden başarısız oluyor?
27 Ekim 2026 itibarıyla npm, No matching version found for @deepseek-ai/dsh@^0.1.0. satırı ile birlikte ETARGET hata kodunu döndürmekteydi. O tarihte yayınlanan her yapı, 0.2.0-rc.2 veya 0.2.1-alpha.2 gibi bir ön sürümdü (prerelease); semver aralıkları, aralığın kendisi aynı major, minor ve patch numaralarına sahip bir ön sürümü açıkça belirtmediği sürece ön sürümlerle eşleşmez. Sonek dahil olmak üzere tam sürüm dizgisini kurun. Sürümler arasında boşluklar bulunduğu için hangi sürümlerin mevcut olduğunu görmek adına npm view @deepseek-ai/dsh versions --json komutunu çalıştırın.
dsh'yi global olarak mı kurmalıyım yoksa npx ile mi çalıştırmalıyım?
Paket önbellek dizininde kaldığı için npx ilk inceleme için uygundur; ayrıca harness kalıcı profil durumu oluşturur. npm install -g @deepseek-ai/dsh@0.1.0-rc.7 gibi sabitlenmiş bir global kurulum, çalışmaya devam etmesi gereken her durum için uygundur çünkü sürüm yalnızca siz değiştirdiğinizde değişir. Global kurulumdan sonra dsh komutu bulunamazsa, npm'in global bin dizini PATH yolunuzda eksiktir; npm prefix -g komutu, bu dizinin altında bulunduğu kök dizini yazdırır.
DeepSeek Harness üzerine inşa edilecek kadar kararlı mı?
Kendi açıklamasına göre henüz değil. README dosyası, projenin geliştirici önizlemesi aşamasında olduğunu, hızla değiştiğini ve uyumluluğu bozan değişiklikler içereceğini belirtmektedir. 0.1.0-rc.6 ve 0.1.0-rc.7 sürüm adayları Ağustos 2026'da dört gün arayla, 0.2.0-rc.1 ve 0.2.0-rc.2 Eylül 2026'da bir gün arayla, 0.2.1-rc.1 ve 0.2.1-rc.2 ise Ekim 2026'da aynı gün yayınlanmıştır. Desteklenen Node aralığı da Ekim 2026'da değişmiştir. Belirli bir sürümü sabitleyin ve herhangi bir rehber yerine o sabitlenmiş yapının içindeki --help dosyasını okuyun. Kendi notlarınıza tarih atın, böylece notlarınızın ne kadar eskidiğini anlayabilirsiniz.