dsh eklentileri nasıl çalışır ve nasıl denetlenir?
dsh eklentileri, ajanınızın izinleriyle Node paketlerini çalıştırır. Güvenlik riski oluşturmamak için eklentiyi yüklemeden önce kodun erişim kapsamını nasıl inceleyeceğinizi öğrenin.
dsh eklentisi nedir ve ne işe yarar?
dsh eklentileri, DeepSeek Harness'ın kendi sürecine yüklediği Node paketleridir. Bir eklenti yüklendiğinde, başka birinin kodunu sizin ajanınızın izinleriyle ve ajanınızın zaten erişebildiği makinede çalıştırır. Kurulum adımı bunun ötesinde daha sıkı korunur. pnpm, siz onay verene kadar bağımlılık derleme betiklerini bekletir ve CLI referansı, "Bir Paket ekledikten, kaldırdıktan veya güncelledikten sonra Profili yeniden başlatın" uyarısında bulunur; böylece dsh plugin ile eklenen bir eklenti bir sonraki yeniden başlatmada yüklenir. Web üzerindeki Plugins sayfasından yüklenen bir eklenti ise doğrudan uygulanabilir. Yüklenmiş bir eklenti ile harness'ın geri kalanı arasında hiçbir engel yoktur. Bu nedenle, bir eklenti yüklemeden önce sorulması gereken soru, o kodun nelere erişebileceği ve bu erişim alanının nasıl dar tutulacağıdır.
dsh (DeepSeek Harness), DeepSeek AI'ın Cordis adlı bir eklenti çerçevesi üzerine inşa edilmiş açık kaynaklı ajan harness'ıdır. Bu orta kelime işin ağırlığını taşır, çünkü bir ajan harness'ı, döngüye, araçlara ve izinlere sahip olan modelin etrafını saran programdır ve bir eklenti tam olarak bu seviyede sisteme dahil olur. Projenin kendi README dosyası, her şeyin bir eklenti olduğunu belirtir. Model bağdaştırıcısı bir eklentidir. Yazı yazdığınız web arayüzü bir eklentidir. Proje dışından yüklediğiniz her şey, onunla birlikte gelen parçalarla aynı güven seviyesinde, aynı ağaç yapısına yerleşir. Eğer henüz bir kurulum yapmadıysanız, DeepSeek Harness'ı bir VPS üzerinde kurarak başlayın ve herhangi bir eklenti eklemeden önce buraya geri dönün.
Ağustos 2026 itibarıyla deponun AGENTS.md dosyası, bir eklentinin erişebileceği genişletme noktalarını listeliyordu ve bunlar şunları kapsıyordu:
- LLM (büyük dil modeli): API anahtarınızın ödeme yaptığı sağlayıcı
- Shell: yerel ve pwsh sağlayıcıları ile bash yeteneği
- Filesystem: politika kontrollü dosya erişimi
- Web: arama ve getirme sağlayıcıları
- Subprocess: süreç ağacı sağlayıcısı
- Workflow: işçi iş parçacıkları (worker threads)
- Subagent: diğer ajanlara yetki devri
- Settings and credentials: kayıtlı yapılandırmanız ve ortam değişkenleriniz
Bu liste o zamandan beri AGENTS.md dosyasından kaldırıldı. 17 Kasım 2026 itibarıyla projenin docs/architecture.md dosyası bunun yerine genişletme noktalarını isimlendiriyor ve model, araç, shell, dosya sistemi ve alt ajan bağlantı noktalarına; sandbox arka uçları, kalıcı terminaller, arka plan işleri, insan komutları ve webhook ile tetiklenen oturumları ekliyor.
Bir eklenti ayrıca ctx.tools üzerinde araçlar kaydeder ve belgeler, kayıtlı bir aracın şemasının istem (prompt) oluşturma sürecine dahil olduğunu açıkça belirtir. Bu ikinci kısım, insanların gözden kaçırdığı noktadır. Bir eklenti, kendi kodu sıra dışı bir şey yapmasa bile ajanınızın ne yapacağına karar verme sürecini değiştirebilir; çünkü sağladığı açıklama, modelin okuduğu metin haline gelir. Bu, kodlama ajanlarına karşı istem enjeksiyonu ile aynı yapıdaki bir sorundur, ancak tek bir farkla: bu metin siz yükleme yaptığınızda gelir ve siz eklentiyi kaldırana kadar orada kalır.
dsh eklentileri nasıl bulur ve yükler?
Global bir eklenti dizini bulunmamaktadır. Çalışan bir dsh, önyükleme sırasında sıralı katmanlardan oluşturulan bir eklenti ağacıdır ve seçimlerinizi barındıran birim bir profildir. $DSH_HOME varsayılan olarak ~/.dsh değerini kullanır ve her profil $DSH_HOME/profiles/<name> içinde yaşar. web ve headless profilleri, ilk kullanımda sunulan şablonlardan kendilerini oluşturur.
Bir profil dizini, her şeyi belirleyen iki dosya barındırır:
package.json, ağaç dışı eklenti bağımlılıkları ve sıralıbundleslistesini taşıyan birdsh.profilemanifestosu ile birlikte.cordis.patch.yml, bu paketlerin üzerindeki kendi yama katmanınız.
ls ~/.dsh
ls ~/.dsh/profiles/webÖnyükleme, katmanları bu sırayla uygular ve sonraki katmanlar önceliklidir:
- boş bir kök
- manifestonun listelediği sırayla profilin paketleri
- profilin
cordis.patch.ymldosyası $DSH_HOME/cordis.patch.yml- komut satırından iletilen tüm
--patch <path>katmanları
İki bayrak, hiçbir şeyi başlatmadan bu kompozisyonun sonucunu yazdırır:
dsh --profile web --dump-default-config
dsh --profile web --dump-config--dump-default-config yalnızca paket katmanlarını yazdırır. --dump-config ise profil ve ev dizini yama katmanlarını ve tüm --patch katmanlarını ekler; bu nedenle bir sonraki önyüklemenin ne yükleyeceğine dair en dürüst envantere en yakın şeydir. Devraldığınız bir makineye güvenmeden önce bunu okuyun.
Bu yama dosyalarıyla ilgili bir uyarı: Yapılandırma burada durağan veri değildir, çünkü format bir eklentinin config bloğu altında !!js etiketli değerlere izin verir. Bir forum gönderisinden kopyalanan bir cordis.patch.yml parçası koddur, bu nedenle ona aynı kaynaktan gelen bir shell betiğine nasıl davranıyorsanız öyle davranın.
dsh plugin add aslında ne çalıştırır?
dsh plugin --profile <name> <args>, argümanlarını ilgili profilin dizinindeki pnpm'e iletir; bu nedenle pnpm'in PATH üzerinde bulunması gerekir. Kullanılan fiiller pnpm'in kendi fiilleridir:
dsh plugin --profile web add '<package-or-git-spec>'
dsh plugin --profile web remove '<package-name>'
dsh plugin --profile web why '<package-name>'
dsh plugin --profile web updateBir dsh eklentisi kurmanın güvenlik modeli, herhangi bir npm tarzı bağımlılığı kurmanın güvenlik modeliyle aynıdır; buna ek olarak sonucun aracınıza yüklendiği bir adım daha bulunur. Paket kendi bağımlılık ağacını beraberinde getirir ve bu ağaçtaki her paket aynı süreç içerisinde çalışır. npm tedarik zinciri saldırılarının bir sunucuya nasıl ulaştığı konusundaki her şey, burada hiçbir değişiklik olmaksızın geçerlidir.
pnpm 10 ve sonraki sürümler, varsayılan olarak bir bağımlılığın derleme betiklerini çalıştırmaz; onay işlemi pnpm approve-builds veya allowBuilds ayarı aracılığıyla paket bazında yapılır. pnpm 11, eski onlyBuiltDependencies ayarını allowBuilds ile değiştirdiğinden, onlyBuiltDependencies kullanan eski bir yapılandırma veya kılavuz güncel pnpm üzerinde hiçbir şeyi onaylamaz. Hangi pnpm sürümüne sahip olduğunuzu kontrol edin:
pnpm --versionGit tabanlı eklentiler, bu durumla ilk karşılaştığınız yerdir. CLI referansı, Git eklentilerinin kurulum sırasında prepare betiği aracılığıyla kaynak derlemeleri gerçekleştirdiğini belirtir; bu nedenle ilk add komutu pnpm'in allowBuilds ipucu ile başarısız olur. Yazdırılan anahtarı profilin pnpm-workspace.yaml dosyasına kopyalayıp komutu tekrar çalıştırmanız gerekir. Bu anahtarı onaylamak, deponun derleme sürecinin kullanıcı izinlerinizle çalışmasına olanak tanır. Derlenmiş tarball dosyaları ve yerel checkout işlemleri için herhangi bir izin gerekmez.
Bu varsayılan ayar oldukça değerlidir ve ekosistemdeki en çok göz ardı edilen güvenlik özelliğidir. Engellenen derleme betikleri, kodun kurulum sırasında çalışmasını durdurur. Ancak eklentinin kendisi üzerinde hiçbir etkileri yoktur; çünkü bir eklentinin temel amacı, ana yapının (harness) onu içe aktarması ve profil yeniden başlatıldığında veya web üzerindeki Eklentiler sayfası kullanılarak kurulum uygulandığı anda çalıştırmasıdır. Bir eklentinin postinstall kancasına ihtiyacı yoktur. Zaten içeri davet edilmiştir.
Bir dsh eklentisi kurmadan önce okunması gerekenler
Yayınlanmış tarball dosyasını indirin ve okuyun. Bir arşivi açtığınızda hiçbir şey çalıştırılmaz.
npm pack '<package-name>@<version>'
tar -tzf '<package-name>-<version>.tgz'
tar -xzf '<package-name>-<version>.tgz'
less package/package.jsonpackage.json içindeki dört alan, ihtiyacınız olan bilgilerin çoğunu size sunar. preinstall, install ve postinstall girdileri için scripts dosyasını okuyun. Tanımadığınız veya bildiğiniz isimlere çok benzeyen isimler için dependencies dosyasını inceleyin. Paketin PATH üzerinde ihtiyaç duyduğu her şey için bin dosyasını okuyun. Giriş dosyası için main veya exports dosyasına bakın, ardından bu dosyayı açın ve içeriğini takip edin.
Daha sonra gerçekten yüklenecek olan kodu okuyun. Bir bildirim aracı olduğunu iddia eden eklentinin ~/.ssh dosyasını okuması, daha önce hiç duymadığınız bir sunucuya çağrı yapması veya bir shell başlatması için hiçbir neden yoktur. Eğer paket yalnızca paketlenmiş veya küçültülmüş (minified) JavaScript içeriyorsa ve halka açık bir depoda eşleşen kaynak kodu bulunmuyorsa, bu durum sizin için bir yanıt niteliğindedir. Kaynak kodunu okuyabildiğiniz eklentileri tercih edin ve küçük boyutlu olanlara öncelik verin.
Ayrıca hiçbir şey kurmadan önce kayıt defterini sorgulayabilirsiniz:
pnpm view '<package-name>' dependencies
pnpm view '<package-name>' versionsGeçen hafta yayınlanmış, tek bir sürümü olan, repository alanı bulunmayan ve popüler bir paketin ismini taklit eden bir paket, her kayıt defterindeki en eski numaradır. İndirmeleri sağlama toplamları ile doğrulama bir sonraki adımdır: çalıştırmasına izin vermeden önce ne indirdiğinizi tam olarak bildiğinizden emin olun.
Sürümü sabitleyin ve lockfile dosyasını koruyun
Değişken bir sürüm aralığı, ajanınızın sürecindeki kodun herhangi bir kurulum veya güncelleme sırasında sizin müdahaleniz olmadan değişebileceği anlamına gelir. Sürümü sabitleyin.
dsh plugin --profile web add --save-exact '<package-name>@<version>'Bayrak yerleşimi pnpm sürümleri arasında farklılık gösterir, bu nedenle komuta güvenmek yerine sonucu kontrol edin. İşlemin ardından profilin package.json dosyasını açın ve bağımlılığın önünde ^ veya ~ karakterleri olmadan yalın bir sürüm numarasıyla göründüğünü doğrulayın. Nelerin kurulacağına bu dosya karar verir.
Ardından, yalnızca en üst düzey ismi değil, tüm geçişli bağımlılık ağacını sabitleyen lockfile dosyasını koruyun:
find ~/.dsh -maxdepth 3 -name 'pnpm-lock.yaml'Bu dosyayı, profilin package.json dosyasıyla birlikte yedeklediğiniz bir yere kopyalayın. Bu iki dosya, yeni bir makinede aynı ağacı yeniden oluşturmanızı sağlar. dsh plugin --profile web update komutunu yalnızca sürüm yükseltmeye karar verdiğinizde çalıştırın; bunu rutin bir temizlik işlemi olarak görmeyin ve sonrasında lockfile dosyasındaki farkları mutlaka inceleyin.
Bir kayıt defteri (registry) yerine git üzerinden kurulan eklentiler için dal (branch) yerine commit değerini sabitleyin. github:owner/repo#<full commit sha> biçimindeki bir tanımlama size sabit bir ağaç sağlar. Bir dal ismi kullanmak, pnpm bir sonraki çözümleme yaptığında o dalda ne varsa onu almanıza neden olur; bu, kontrolü başkasına devretmek demektir. Harness'ın kendisi de aynı disiplini gerektirir, çünkü npm üzerindeki latest sürümü bir aday sürümdür (release candidate) ve sabitlenmemiş bir kurulum herhangi bir günde farklı bir sürüme çözümlenebilir; dsh kurulum ve sürüm hataları vakalarının çoğu bu durumdan kaynaklanır.
Eklenti pazarı ve "küratörlü" olmanın değeri
dsh bir pazar yerine sahiptir ve bir eklenti olarak kurulur; bu durum mimari hakkında size bir fikir verir:
dsh plugin --profile web add dshmarketYeniden başlatmanın ardından, dsh 0.2.1 ve daha yeni sürümlerde Eklentiler sayfasında, Yüklü sekmesinin yanında bir sekme olarak görünür; daha eski ana makineler ise Ayarlar ve ardından Eklenti Pazarı yolunu kullanır. README dosyası sınırlamalar konusunda açıktır. Kurulumlar, küratörlü bir kayıt listesinde yer alan kaynaklarla sınırlandırılmıştır ve diğer her şey reddedilir. Derleme betikleri varsayılan olarak engellenmiştir ve birini etkinleştirmek paket bazında onay gerektirir. Terminal eklentileri, bir web profiline girmeden önce işaretlenir. En önemli cümle, listelemenin bir onay anlamına gelmediğidir, çünkü eklentiler üçüncü taraf kodlarıdır. Aynı README dosyası, bu yolla kurulan çoğu eklentinin sayfa yenilemeden sonra yeniden başlatmaya gerek kalmadan canlıya geçtiğini belirtir; bu nedenle tek tıkla kurulum, saniyeler sonra aracınızın içinde çalışır durumda olabilir.
Küratörlü bir liste, taban seviyesini yükseltir. Sizin yerinize kodu okumaz ve bir eklentinin bir sonraki sürümünün, geliştirici hesabı el değiştirdikten sonra ne yapacağını size söyleyemez. Tek tıkla kurulumu, aynı yazardan gelen curl | bash dosyasına nasıl yaklaşıyorsanız öyle değerlendirin. O README dosyasından tekrarlanmaya değer bir satır daha var: dışa aktarılan bir yedekleme, profil yapılandırmanızdan kimlik bilgileri içerebilir, bu yüzden asla halka açık bir sorun kaydına veya bir yapıştırma sitesine eklemeyin. Bir yöntem yerine başlangıç listesi istiyorsanız, kurulmaya değer dsh eklentileri bu yazının tamamlayıcı içeriğidir.
Harness artık kendi rotasına da sahiptir. Eklentiler sayfasından açılan deneysel Özel eklenti dizin paketi, kendi eklediğiniz dizin dosyalarıyla beslenen bir Keşfet sekmesi ekler. dsh herhangi bir dizin kaynağı ile gelmez ve belgeleri, dizinlerin üçüncü taraf içeriği olduğunu; dsh'nin dosya biçimini kontrol ettiğini ancak bir dizinin eklenti başlığı, yazarı veya kaynağı hakkında iddia ettiklerini doğrulamadığını belirtir.
dsh'yi root olarak değil, kendi kullanıcısı ile çalıştırın
İnceleme süreci, kötü niyetli bir yazılımın sisteme sızma olasılığını azaltır. En az yetki prensibi ise sızma gerçekleştiğinde bu yazılımın nelere erişebileceğini belirler. Bir VPS üzerinde bu ikinci adımı uygulamak oldukça kolaydır.
Harness için kendi ev dizinine sahip ayrı bir Unix hesabı oluşturun ve onu asla root olarak çalıştırmayın:
sudo adduser --disabled-password --gecos "" dshrun
sudo -iu dshrunBu oturum içerisinde, harness'ı kendi ev dizinine yazacak şekilde başlatın:
npx @deepseek-ai/dsh webWeb arayüzü varsayılan olarak http://127.0.0.1:3080 üzerinde hizmet verir. Bu ayarı değiştirmeyin. Eğer daha önce yazdırılan bağlantıya başka bir makineden tıkladıysanız ve yanıt alamadıysanız, dsh'nin bu adresi yazdırdığında ne demek istediği bölümü bunun nedenini açıklar. Sunulan web yapısı Host ve Origin başlıklarını kontrol eder; her Host RPC metodu ve WebSocket akışı için kimliği doğrulanmış bir tarayıcı veya API Peer gerektirir ve dsh web, --host 0.0.0.0 bağlantılarını reddeder. API çağrıları yapanlar /connect üzerinden kimlik doğrulaması yapar ve imzalı bir API çerezi alır. Bu girişi ikinci bir kilit olarak görün, 3080 portunu dış dünyaya açmak için bir neden olarak değil. Bunun arkasında bir kabuğa (shell) sahip bir aracı çalışır; bu nedenle sızdırılan bir oturum belirteci veya herkese açık bir porttaki giriş hatası, bir yabancıya dostane bir arayüze sahip, root yetkisi olmayan bir uzak kabuk erişimi sağlar. Buna dizüstü bilgisayarınızdan bir SSH tüneli üzerinden erişin:
ssh -L 3080:127.0.0.1:3080 you@your-vpsArdından hiçbir şeyin herkese açık bir adreste dinleme yapmadığını doğrulayın:
ss -lnt | grep 3080Yerel adres 127.0.0.1:3080 olarak görünmelidir. Eğer 0.0.0.0:3080 olarak görünüyorsa, varsayılan dsh web ayarları dışında bir yapılandırma veya değişiklik söz konusudur ve bu yapılandırma kendi kimlik doğrulamasından sorumludur. Projenin belgeleri, temel web sunucusunun kendi başına bir kimlik doğrulama veya Origin politikası getirmediğini belirtir; bu nedenle o portu neyin koruduğundan emin olana kadar güvenlik duvarınızın bir yabancı ile aracınız arasındaki tek engel olduğunu varsayın ve portu tekrar loopback adresine taşıyın. Claude Code'u bir VPS üzerinde güvenli bir şekilde çalıştırma mantığı dsh için de aynen geçerlidir. Araca bozmasına izin verilen tek bir çalışma dizini verin ve yeniden oluşturamayacağınız hiçbir şeyi o makinede tutmayın. Daha da iyisi, sunucuyu kodlama araçları için tek kullanımlık bir sanal makine olarak değerlendirin; çünkü bir VPS'i yeniden oluşturmak bir saat sürerken, denetlemek bir hafta sürebilir.
Anahtarlarınızın konumu ve dosya izinlerinin neden sınırlı kaldığı
dsh, API anahtarlarını $DSH_HOME/.credentials.yaml içinde, ortam değişkenlerini $DSH_HOME/.env içinde ve aktif profile ait model ayarlarını cordis.patch.yml içinde tutar. Bu kılavuz Ekim 2026'da ilk kez kontrol edildiğinde, daha eski bir sürüme ait $DSH_HOME/settings.yaml dosyası bir kez içe aktarılmış ve settings.yaml.imported olarak yeniden adlandırılmıştı. Hangi anahtarın bu dosyalardan hangisine ait olduğu ve her modda sunucudan dışarıya gerçekte neyin çıktığı, dsh API anahtarlarını, modellerini ve uç noktalarını yapılandırma konusunun içeriğidir. Bir eklenti eklemeden önce bu konuyu netleştirmekte fayda vardır; çünkü sisteme bağladığınız her anahtar, bir eklentinin okuyabileceği yeni bir veri demektir. Hassas olan iki dosyayı kilitleyin:
chmod 600 ~/.dsh/.credentials.yaml ~/.dsh/.env
ls -l ~/.dsh600 modu, dosya sahibine okuma ve yazma yetkisi verirken diğer tüm kullanıcılara hiçbir yetki vermez; bu durumun her iki gösterim biçiminde de bilinmesi yararlıdır (sayısal ve sembolik chmod modları). Bu modun size ne sağladığı konusunda dürüst olun. Dosya modları, ilgili dosyaları sunucudaki diğer hesaplardan korur. Ancak bir eklentiye karşı hiçbir koruma sağlamazlar; çünkü eklenti, dosyaların sahibi olan kullanıcı yetkileriyle ve dosyaları okuyan süreç içerisinde çalışır. Sırları bir yapay zeka aracının erişemeyeceği yerde tutmak ifadesinin, bu sırları makineye hiç koymamak anlamına gelmesinin nedeni budur. Bir dsh sunucusu, yalnızca ihtiyaç duyduğu tek bir model anahtarını barındırmalıdır. Bulut kimlik bilgileriniz ve imzalama anahtarlarınız başka bir yerde tutulmalıdır.
Web okuyan bir eklentinin tehdit modelini neden değiştirdiği
Web arayüzü, eklentilere arama ve veri çekme sağlayıcıları sunar. Bir sayfayı oturumunuza çeken eklenti, bir saldırganın yazabileceği metni içeri aktarmaktadır. Model istemi, talimatları veriden ayırmaz; bu nedenle çekilen bir sayfa, temsilcinize hitaben yazılmış bir satır içerebilir. Kabuk yeteneğine sahip bir donanım (harness), bu komutu çalıştırmaya sadece bir itaat adımı uzaklıktadır.
Denetim mekanizması halihazırda donanım içerisinde mevcuttur. dsh-base, web, headless, sdk ve acp profillerinin paylaşılan ilk paketi, korumalı alanı (sandbox) ve onay politikasını içerir (sdk-minimal profili bunu bilinçli olarak dışarıda bırakır). Bunu kullanın. Güvenilmeyen sayfaları çekebilen bir oturum, yazma veya yürütme yapan her işlem için onay gerektirmelidir; böylece çekilen bir talimat kendi başına bir eyleme dönüşemez. Temsilci eylemlerini onay mekanizmasıyla kısıtlama bölümü, bu sınırın nereye konulması gerektiği konusundaki yaklaşımı ele almaktadır. Bu ilişki her iki yönde de işler; zira kendi sunucunuz da bir başkasının temsilcisinin çekeceği bir sayfadır ve bu durum sunucunuzda yapay zeka tarayıcılarını engelleme konusunun temelini oluşturur.
Bir eklentinin neleri değiştirdiğini nasıl kontrol ederim?
Kurulumdan önce bir snapshot alın, kurulumu gerçekleştirin, ardından kurulumdan sonra ikinci bir snapshot alarak aradaki farkı inceleyin.
dsh --profile web --dump-config > /tmp/dsh-before.txt
dsh plugin --profile web add '<package-name>@<version>'
dsh --profile web --dump-config > /tmp/dsh-after.txt
diff -u /tmp/dsh-before.txt /tmp/dsh-after.txtFark çıktısı (diff), kurulumun oluşturulan ağaca hangi eklenti girdilerini eklediğini gösterir. Yalnızca bir bundle patch bildiren paketler ağaca dahil olur; düz bir bağımlılık oraya hiçbir şey eklemez ve dsh bu konuda bir kez uyarı verir. Yalnızca küçük bir özellik için yüklediğiniz ancak açıklayamadığınız birçok girdi ekleyen bir eklenti, sistemi başlatmadan önce durup kaynak kodunu incelemeniz için bir nedendir. dsh plugin --profile web why <package-name> diğer soruyu yanıtlar: doğrudan bağımlılıklarınızdan hangisinin belirli bir paketi içeri çektiği.
Yüklü paketler profilin kendi node_modules dizininde, $DSH_HOME/profiles/<name>/node_modules konumunda yer alır, bu sayede ağacı disk üzerinde de inceleyebilirsiniz:
ls ~/.dsh/profiles/web/node_modulesÜzerinde deneme yapmadığınız ikinci bir profil tutun. Bir kurulum harness yapısını bozduğunda, dsh --profile <clean-name> ile başlatma yapmak eklentinin buna neden olup olmadığını saniyeler içinde size söyler.
Bir dsh eklentisi nasıl kaldırılır?
dsh plugin --profile web remove '<package-name>'
dsh --profile web --dump-config > /tmp/dsh-after-removal.txt
diff -u /tmp/dsh-before.txt /tmp/dsh-after-removal.txtBağımlılığın kaldırılması, yapılandırmayı her zaman silmez. Profilin cordis.patch.yml dosyasına yazılan girdiler orada kalmaya devam eder; çünkü bu dosya size aittir ve araç sizin yerinize dosyayı yeniden yazmaz. Dosyayı açın ve kaldırdığınız paketi adlandıran tüm blokları silin.
less ~/.dsh/profiles/web/cordis.patch.ymlArdından hiçbir kaldırma komutunun düzeltemeyeceği kısımla yüzleşin. Bir eklentiyi ona güvenmeyi bıraktığınız için kaldırdıysanız, okuyabildiği her şeyi zaten okumuş demektir. Sağlayıcı konsolundan DeepSeek API anahtarını döndürün (rotate) ve $DSH_HOME içinde bulunan diğer her şeyi de yenileyin. Sonrasında, eklentinin çalıştığı unix hesabının ağınızın geri kalanında nerelere erişebildiğini tespit edin.
Kısa özet
- Kurulumdan önce yayınlanan tarball dosyasını,
scriptsve giriş dosyasından başlayarak inceleyin. - Tam sürümü veya git spesifikasyonu için tam commit değerini sabitleyin ve lockfile dosyasını koruyun.
- Tek bir profile kurulum yapın ve bir sorun oluştuğunda önyükleme yapabileceğiniz temiz bir profil tutun.
- Her kurulumdan önce ve sonra
--dump-configfarklarını (diff) kontrol edin. - Harness'ı kendi unix kullanıcısı altında, loopback üzerinde ve SSH üzerinden erişilecek şekilde çalıştırın.
- Sunucuda tek bir API anahtarı bulundurun ve artık güvenmediğiniz bir eklentiyi kaldırdığınız gün bu anahtarı yenileyin.
Bunların hiçbiri eklentilerden kaçınmak için bir neden değildir. Eklenti modeli dsh aracını kullanışlı kılan şeydir; genişletemediğiniz bir harness, er ya da geç değiştireceğiniz bir harness'tır. Bu maddeler; neyi, kimden, hangi sürümde kurduğunuzu bilmeniz ve tüm yapıyı yeniden inşa edebileceğiniz bir ortamda çalıştırmanız için birer nedendir.
FAQ
dsh eklentileri birbirinden yalıtır mı?
Hayır. Bir eklenti, Cordis aracılığıyla harness sürecine yüklenir ve shell, dosya sistemi, web, alt süreç, alt aracı ve kimlik bilgileri dahil olmak üzere belgelenmiş yetenek sınırlarına erişebilir. dsh-base, yani web, headless, sdk ve acp profillerinin paylaşılan ilk paketi, aracın araçlarının neler yapabileceğini düzenleyen sandbox ve onay politikasını içerir; korumanız bu politikadan sağlanır. Eklenti bazında bir izin sınırı yoktur; bu nedenle dürüst model, bir eklenti yüklemenin güveninizi hem eklentinin yazarına hem de bağımlılık ağacındaki her pakete genişlettiğiniz anlamına gelir.
Bir dsh eklentisini, yükleme betiklerini çalıştırmadan kurabilir miyim?
pnpm 10 ve sonraki sürümler bağımlılık oluşturma betiklerini varsayılan olarak engeller ve dsh plugin ... add komutu pnpm'e yönlendirme yapar; bu nedenle güncel bir pnpm sürümünde, paketi onaylamadığınız sürece yükleme işlemi paket betiklerini çalıştırmaz. Sürümünüzü pnpm --version ile doğrulayın. Bu durum, içeriği incelenmemiş bir eklentiyi güvenli kılmaz. Eklentinin kendi kodu, harness onu yüklediğinde çalışır; bu durum dsh plugin yüklemesinden sonraki profil yeniden başlatmasında veya genellikle web üzerindeki Plugins sayfasından yapılan bir yüklemeden hemen sonra gerçekleşir ve hiçbir yükleme zamanı kısıtlaması bunu etkilemez.
dsh eklentileri ve yapılandırmaları aslında nerede bulunur?
$DSH_HOME varsayılan olarak ~/.dsh dizinini kullanır. Profiller $DSH_HOME/profiles/<name> içinde yer alır; her biri, eklenti bağımlılıklarını içeren bir package.json, sıralı paketlerin dsh.profile manifestosu ve bir cordis.patch.yml yama katmanı barındırır. Yüklenen paketler, her profilin kendi node_modules dizininde, $DSH_HOME/profiles/<name>/node_modules altında konumlanır. Anahtarlar $DSH_HOME/.credentials.yaml içinde, ortam değerleri $DSH_HOME/.env içinde bulunur ve kullanıcı seviyesindeki bir $DSH_HOME/cordis.patch.yml dosyası tüm profiller üzerinde geçerli olur. Sistemi başlatmadan oluşturulan sonucu görmek için dsh --profile web --dump-config komutunu çalıştırın.
dsh eklenti marketinden kurulum yapmak güvenli midir?
Market, kurulumları denetlenen bir kayıt defterindeki kaynaklarla sınırlar ve paket bazında onay vermediğiniz sürece oluşturma betiklerini engeller; bu, bir sohbet penceresinden paket adı kopyalamaya göre gerçek bir iyileştirmedir. Marketin kendi README dosyası, listelenen öğelerin onaylandığı anlamına gelmediğini belirtir çünkü eklentiler diğer kişilere ait üçüncü taraf kodlarıdır. Kaynak kodunu okuyun ve sürümü sabitleyin. Harness'ı, kaybetmeyi göze alabileceğiniz bir kullanıcı hesabında ve ideal olarak ayrı bir makinede çalıştırın.