SSD Nodes Learn Hosting plans →
गाइड Matt Connorलेखक: Matt Connor

dsh plugins कैसे काम करते हैं और उनकी जांच कैसे करें

dsh plugins आपके agent की अनुमतियों का उपयोग करके कोड रन करते हैं। किसी भी plugin को इंस्टॉल करने से पहले उसके एक्सेस दायरे और सुरक्षा जोखिमों को समझना आवश्यक है।

dsh plugin क्या है, और यह क्या कर सकता है?

dsh plugins वे Node packages हैं जिन्हें DeepSeek Harness अपनी प्रक्रिया (process) में लोड करता है। एक बार लोड होने के बाद, plugin आपके agent की अनुमतियों (permissions) के साथ किसी और का कोड उसी मशीन पर चलाता है जहाँ तक आपका agent पहले से पहुँच सकता है। इंस्टॉलेशन का चरण इससे अधिक सुरक्षित है। pnpm तब तक dependency build scripts को रोकता है जब तक आप उन्हें मंजूरी नहीं देते, और CLI reference कहता है कि "Bundle को जोड़ने, हटाने या अपडेट करने के बाद उस Profile को Restart करें," ताकि dsh plugin के साथ जोड़ा गया plugin अगले restart पर लोड हो सके। वेब Plugins पेज से इंस्टॉल किया गया plugin तुरंत लागू हो सकता है। एक लोड किए गए plugin और harness के बाकी हिस्सों के बीच कोई सुरक्षा नहीं होती। इसलिए, किसी plugin को इंस्टॉल करने से पहले यह पूछना जरूरी है कि वह कोड किन चीजों तक पहुँच सकता है, और आप उस दायरे को कैसे सीमित रख सकते हैं।

dsh (DeepSeek Harness) DeepSeek AI का ओपन-सोर्स agent harness है, जिसे Cordis नामक plugin framework पर बनाया गया है। यह बीच का शब्द बहुत महत्वपूर्ण है, क्योंकि an agent harness वह प्रोग्राम है जो मॉडल के चारों ओर लिपटा होता है और लूप, टूल्स और अनुमतियों को नियंत्रित करता है, और एक plugin ठीक उसी स्तर पर इसमें शामिल होता है। प्रोजेक्ट का अपना README कहता है कि सब कुछ एक plugin है। मॉडल एडाप्टर एक plugin है। जिस वेब इंटरफेस में आप टाइप करते हैं, वह एक plugin है। प्रोजेक्ट के बाहर से आप जो कुछ भी इंस्टॉल करते हैं, वह उसी ट्री में, उसी स्तर के भरोसे के साथ आता है जिस स्तर पर इसके साथ आए हिस्से होते हैं। यदि आपने अभी तक इसे सेटअप नहीं किया है, तो the DeepSeek Harness on a VPS से शुरुआत करें और कुछ भी जोड़ने से पहले वापस आएँ।

अगस्त 2026 में रिपॉजिटरी के AGENTS.md ने उन extension points को सूचीबद्ध किया था जहाँ तक एक plugin पहुँच सकता है, और उनमें शामिल थे:

  • LLM (large language model): वह प्रदाता जिसके लिए आपकी API key भुगतान करती है
  • Shell: bash क्षमता, local और pwsh प्रदाताओं के साथ
  • Filesystem: नीति-नियंत्रित फ़ाइल एक्सेस
  • Web: सर्च और फेच प्रदाता
  • Subprocess: एक प्रोसेस-ट्री प्रदाता
  • Workflow: वर्कर थ्रेड्स
  • Subagent: अन्य agents को कार्य सौंपना
  • Settings and credentials: आपकी सहेजी गई कॉन्फ़िगरेशन और environment variables

वह सूची अब AGENTS.md से हट गई है। 17 नवंबर 2026 तक, प्रोजेक्ट का docs/architecture.md इसके बजाय extension points के नाम बताता है, और यह मॉडल, टूल, शेल, फ़ाइल सिस्टम और सब-एजेंट सीम (seams) में सैंडबॉक्स बैकएंड, पर्सिस्टेंट टर्मिनल, बैकग्राउंड जॉब्स, मानवीय कमांड और वेबहुक-ट्रिगर सत्रों को जोड़ता है।

एक plugin ctx.tools पर टूल्स को भी रजिस्टर करता है, और दस्तावेज़ स्पष्ट हैं कि एक रजिस्टर्ड टूल का स्कीमा प्रॉम्प्ट असेंबली में शामिल हो जाता है। वह दूसरा हिस्सा वह है जिसे लोग अनदेखा कर देते हैं। एक plugin आपके agent के निर्णय लेने की प्रक्रिया को बदल सकता है बिना अपना कोई असामान्य कोड चलाए, क्योंकि जो विवरण वह प्रदान करता है वह उस टेक्स्ट का हिस्सा बन जाता है जिसे मॉडल पढ़ता है। यह prompt injection against coding agents जैसी ही समस्या है, बस एक अंतर के साथ: यह टेक्स्ट तब आता है जब आप इंस्टॉल करते हैं, और यह तब तक बना रहता है जब तक आप plugin को हटा नहीं देते।

dsh प्लगइन्स को कैसे ढूँढता और लोड करता है?

कोई ग्लोबल प्लगइन डायरेक्टरी नहीं होती है। एक चलता हुआ dsh, बूट के समय क्रमिक परतों (ordered layers) से बना एक प्लगइन ट्री होता है, और आपकी पसंद को सुरक्षित रखने वाली इकाई एक प्रोफाइल है। $DSH_HOME डिफ़ॉल्ट रूप से ~/.dsh पर सेट होता है, और प्रत्येक प्रोफाइल $DSH_HOME/profiles/<name> में स्थित होती है। web और headless प्रोफाइल पहली बार उपयोग किए जाने पर शिप किए गए टेम्प्लेट से खुद को बना लेती हैं।

एक प्रोफाइल डायरेक्टरी में दो फाइलें होती हैं जो सब कुछ निर्धारित करती हैं:

  • package.json, जिसमें आउट-ऑफ-ट्री प्लगइन डिपेंडेंसी और एक dsh.profile मैनिफेस्ट होता है जो क्रमिक bundles सूची को ले जाता है।
  • cordis.patch.yml, उन बंडलों के ऊपर आपकी अपनी पैच लेयर।
ls ~/.dsh
ls ~/.dsh/profiles/web

बूट इस क्रम में परतों को लागू करता है, और बाद वाली परतें प्रभावी होती हैं:

  1. एक खाली रूट
  2. प्रोफाइल के बंडल, उस क्रम में जिसमें मैनिफेस्ट उन्हें सूचीबद्ध करता है
  3. प्रोफाइल की cordis.patch.yml
  4. $DSH_HOME/cordis.patch.yml
  5. कमांड लाइन पर पास की गई कोई भी --patch <path> ओवरले

दो फ्लैग किसी भी चीज़ को शुरू किए बिना इस संयोजन का परिणाम प्रिंट करते हैं:

dsh --profile web --dump-default-config
dsh --profile web --dump-config

--dump-default-config केवल बंडल लेयर्स को प्रिंट करता है। --dump-config इसमें प्रोफाइल, होम पैच लेयर्स और किसी भी --patch ओवरले को जोड़ता है, इसलिए यह इस बात की सबसे सटीक सूची है कि आपका अगला बूट क्या लोड करेगा। किसी विरासत में मिली मशीन पर भरोसा करने से पहले इसे पढ़ें।

उन पैच फाइलों के बारे में एक चेतावनी। यहाँ कॉन्फ़िगरेशन निष्क्रिय डेटा नहीं है, क्योंकि फॉर्मेट प्लगइन के config ब्लॉक के तहत !!js टैग किए गए मानों की अनुमति देता है। किसी फ़ोरम पोस्ट से कॉपी किया गया cordis.patch.yml स्निपेट कोड होता है, इसलिए इसे उसी तरह समझें जैसे आप उसी स्रोत से प्राप्त शेल स्क्रिप्ट को समझते हैं।

dsh plugin add वास्तव में क्या रन करता है?

dsh plugin --profile <name> <args> अपने arguments को उस profile की directory के भीतर pnpm को forward करता है, इसलिए pnpm का PATH पर होना आवश्यक है। ये verbs pnpm के ही verbs हैं:

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 update

अतः, dsh plugin को install करने का security model वही है जो किसी भी npm-style dependency को install करने का होता है, साथ ही इसमें एक अतिरिक्त चरण भी है जहाँ परिणाम आपके agent में load होता है। यह package अपनी dependency tree साथ लाता है, और उस tree का प्रत्येक package एक ही process में समाप्त होता है। npm supply chain attacks सर्वर तक कैसे पहुँचते हैं में दी गई हर बात यहाँ बिना किसी बदलाव के लागू होती है।

pnpm 10 और उसके बाद के versions डिफ़ॉल्ट रूप से किसी dependency की build scripts को रन नहीं करते हैं, और अनुमोदन pnpm approve-builds या allowBuilds setting के माध्यम से प्रति package लिया जाता है। pnpm 11 ने पुरानी onlyBuiltDependencies setting को allowBuilds से बदल दिया है, इसलिए कोई guide या पुरानी config जो अभी भी onlyBuiltDependencies का उपयोग करती है, वह वर्तमान pnpm पर कुछ भी approve नहीं करती है। जाँचें कि आपके पास कौन सा pnpm है:

pnpm --version

Git-hosted plugins वे हैं जहाँ आप सबसे पहले इसका सामना करते हैं। CLI reference के अनुसार, एक git plugin जो source भेजता है, वह install के दौरान अपनी prepare script के माध्यम से build करता है, इसलिए पहली add, pnpm के allowBuilds hint के साथ विफल हो जाती है, और आप print की गई key को profile की pnpm-workspace.yaml में copy करते हैं और फिर से रन करते हैं। उस key को approve करने से repository की build आपके user की permissions के साथ रन हो जाती है। Built tarballs और local checkouts के लिए किसी अनुमति की आवश्यकता नहीं होती है।

वह डिफ़ॉल्ट सेटिंग उपयोगी है, और यह ecosystem में सबसे अधिक अनदेखा किया जाने वाला सुरक्षा फीचर भी है। Blocked build scripts install के दौरान कोड को रन होने से रोकती हैं। वे plugin के बारे में कुछ नहीं करती हैं, क्योंकि plugin का मुख्य उद्देश्य ही यह है कि harness उसे import करे और profile restart होने पर, या web Plugins page का उपयोग करने पर install लागू होते ही उसे call करे। किसी plugin को postinstall hook की आवश्यकता नहीं होती है। उसे आमंत्रित किया गया था।

dsh plugin install करने से पहले क्या पढ़ें

प्रकाशित tarball को download करें और उसे पढ़ें। archive को unpack करने पर कुछ भी execute नहीं होता है।

npm pack '<package-name>@<version>'
tar -tzf '<package-name>-<version>.tgz'
tar -xzf '<package-name>-<version>.tgz'
less package/package.json

उस package.json में मौजूद चार fields आपको वह सब कुछ बता देते हैं जिसकी आपको आवश्यकता है। preinstall, install और postinstall entries के लिए scripts पढ़ें। उन नामों के लिए dependencies पढ़ें जिन्हें आप नहीं पहचानते, या जो उन नामों से एक character दूर हैं जिन्हें आप जानते हैं। package को आपके PATH पर जो कुछ भी चाहिए, उसके लिए bin पढ़ें। entry file के लिए main या exports पढ़ें, फिर उस file को खोलें और उसका पालन करें।

इसके बाद वह code पढ़ें जो वास्तव में load होगा। एक plugin जो notification tool होने का दावा करता है, उसे ~/.ssh पढ़ने, किसी ऐसे host को call करने जिसे आपने कभी नहीं सुना, या shell spawn करने का कोई कारण नहीं है। यदि package केवल bundled या minified JavaScript के साथ आता है और public repository में कोई matching source मौजूद नहीं है, तो यही आपका उत्तर है। ऐसे plugins को प्राथमिकता दें जिनका source आप पढ़ सकते हैं, और छोटे plugins को चुनें।

आप कुछ भी install किए बिना registry से सवाल भी कर सकते हैं:

pnpm view '<package-name>' dependencies
pnpm view '<package-name>' versions

पिछले सप्ताह प्रकाशित एक package, जिसमें केवल एक version है, कोई repository field नहीं है और जिसका नाम किसी लोकप्रिय चीज़ जैसा है, यह किसी भी registry में सबसे पुराना हथकंडा है। checksums के साथ downloads को verify करना अगली आवश्यक आदत है: उसे run करने देने से पहले ठीक-ठीक जानें कि आपने क्या fetch किया है।

Version को पिन करें और lockfile को सुरक्षित रखें

Floating version range का अर्थ है कि आपके agent की process के अंदर का code किसी भी install या update के दौरान आपकी अनुमति के बिना बदल सकता है। इसे पिन करें।

dsh plugin --profile web add --save-exact '<package-name>@<version>'

Flag का स्थान pnpm के अलग-अलग versions में बदल सकता है, इसलिए command पर भरोसा करने के बजाय परिणाम की जाँच करें। बाद में profile की package.json खोलें और पुष्टि करें कि dependency एक bare version के रूप में दिख रही है, जिसके आगे कोई ^ या ~ नहीं है। वही file तय करती है कि क्या install होगा।

इसके बाद lockfile को सुरक्षित रखें, जो केवल top-level name के बजाय पूरे transitive tree को पिन करती है:

find ~/.dsh -maxdepth 3 -name 'pnpm-lock.yaml'

इसे profile की package.json के साथ किसी backup स्थान पर copy करें। ये दोनों files किसी नए box पर वही tree फिर से बना सकती हैं। जब आप version बदलने का निर्णय लें, तभी dsh plugin --profile web update चलाएँ, इसे routine सफाई के रूप में कभी न करें, और बाद में lockfile diff को पढ़ें।

Registry के बजाय git से install किए गए plugin के लिए, branch के बजाय commit को पिन करें। github:owner/repo#<full commit sha> के रूप का spec आपको एक fixed tree देता है। Branch का नाम देने पर अगली बार pnpm द्वारा resolve किए जाने पर वह branch जो भी content रखेगी, वही install होगा, जो कि एक ऐसा निर्णय है जिसे आपने किसी और के हाथ में सौंप दिया है। Harness को स्वयं भी इसी अनुशासन की आवश्यकता है, क्योंकि npm latest release एक release candidate है और एक unpinned install किसी भी दिन अलग version पर resolve हो सकता है, जो कि अधिकांश dsh install और version संबंधी त्रुटियों का मुख्य कारण है।

प्लगइन मार्केट और "curated" होने का महत्व

dsh में एक मार्केटप्लेस है, जो एक प्लगइन के रूप में इंस्टॉल होता है। यह इसके आर्किटेक्चर के बारे में बहुत कुछ बताता है:

dsh plugin --profile web add dshmarket

रीस्टार्ट के बाद, dsh 0.2.1 और उससे नए वर्ज़न में यह Plugins पेज पर Installed के बगल में एक टैब के रूप में दिखाई देता है; पुराने hosts में Settings और फिर Plugin Market का उपयोग होता है। इसका README इसकी सीमाओं के बारे में स्पष्ट है। इंस्टॉलेशन केवल एक curated रजिस्ट्री में सूचीबद्ध स्रोतों तक सीमित हैं और किसी भी अन्य स्रोत को अस्वीकार कर दिया जाता है। बिल्ड स्क्रिप्ट्स डिफ़ॉल्ट रूप से ब्लॉक रहती हैं, और किसी एक को इनेबल करने के लिए प्रति-पैकेज (per-package) स्वीकृति की आवश्यकता होती है। टर्मिनल प्लगइन्स को वेब प्रोफाइल में जाने से पहले फ्लैग किया जाता है। सबसे महत्वपूर्ण वाक्य यह है कि लिस्टिंग का मतलब समर्थन (endorsement) नहीं है, क्योंकि प्लगइन्स थर्ड-पार्टी कोड होते हैं। उसी README में कहा गया है कि इसके माध्यम से इंस्टॉल किए गए अधिकांश प्लगइन्स पेज रिफ्रेश करने के बाद लाइव हो जाते हैं, रीस्टार्ट की आवश्यकता नहीं होती, इसलिए एक-क्लिक इंस्टॉल कुछ ही सेकंड बाद आपके एजेंट के अंदर चल सकता है।

एक curated लिस्ट न्यूनतम सुरक्षा स्तर को बढ़ाती है। यह आपके लिए कोड नहीं पढ़ती है, और यह आपको यह नहीं बता सकती कि किसी मेंटेनर अकाउंट के बदलने के बाद प्लगइन का अगला वर्ज़न क्या करेगा। एक-क्लिक इंस्टॉल के साथ वैसा ही व्यवहार करें जैसा आप उसी ऑथर के curl | bash के साथ करते। उस README की एक और पंक्ति दोहराने योग्य है: एक एक्सपोर्ट किया गया बैकअप आपकी प्रोफाइल कॉन्फ़िगरेशन से क्रेडेंशियल्स ले सकता है, इसलिए इसे कभी भी किसी पब्लिक इश्यू या पेस्ट साइट पर अटैच न करें। यदि आप किसी विधि के बजाय शुरुआती लिस्ट चाहते हैं, तो dsh plugins worth installing इस पोस्ट का साथी लेख है।

अब हार्नेस का अपना एक रूट भी है। Plugins पेज से चालू किया गया एक एक्सपेरिमेंटल Custom plugin indexes बंडल, एक Discover टैब जोड़ता है जो आपके द्वारा स्वयं जोड़े गए इंडेक्स फाइलों से फीड होता है। dsh कोई इंडेक्स स्रोत प्रदान नहीं करता है, और इसके डॉक्स कहते हैं कि इंडेक्स थर्ड-पार्टी कंटेंट हैं और dsh फाइल फॉर्मेट की जाँच करता है, लेकिन यह नहीं कि कोई इंडेक्स प्लगइन के टाइटल, ऑथर या स्रोत के बारे में क्या दावा करता है।

dsh को root के बजाय उसके अपने user के रूप में चलाएं

Vetting (जांच) से यह कम हो जाता है कि कोई हानिकारक चीज़ कितनी बार अंदर आती है। Least privilege (न्यूनतम विशेषाधिकार) यह तय करता है कि जब वह अंदर आती है, तो वह कहाँ तक पहुँच सकती है। एक VPS पर उस दूसरे हिस्से को सेट करना आसान है।

harness को उसका अपना unix account और अपना home दें, और इसे कभी भी root के रूप में न चलाएं:

sudo adduser --disabled-password --gecos "" dshrun
sudo -iu dshrun

उस session के अंदर, harness को इस तरह start करें कि वह उस account के तहत अपना home लिखे:

npx @deepseek-ai/dsh web

Web UI डिफ़ॉल्ट रूप से http://127.0.0.1:3080 पर serve होता है। इसे वहीं रहने दें। यदि आपने कभी किसी दूसरी machine से उस printed link पर click किया है और कुछ भी वापस नहीं मिला है, तो dsh के उस address को print करने का क्या अर्थ है इसका कारण बताता है। shipped web composition Host और Origin headers की जांच करता है और हर Host RPC method और WebSocket stream के लिए एक authenticated browser या API Peer की आवश्यकता होती है, और dsh web, --host 0.0.0.0 को अस्वीकार करता है। API callers /connect के माध्यम से authenticate होते हैं और एक signed API cookie प्राप्त करते हैं। उस login को एक दूसरा ताला मानें, न कि 3080 को publish करने का कारण। इसके पीछे एक agent होता है जिसके पास shell होती है, इसलिए एक लीक हुआ session token या public port पर login bug किसी अजनबी को एक friendly interface के साथ root-less remote shell दे देता है। इसे अपने laptop से SSH tunnel के माध्यम से access करें:

ssh -L 3080:127.0.0.1:3080 you@your-vps

फिर पुष्टि करें कि public address पर कुछ भी listen नहीं कर रहा है:

ss -lnt | grep 3080

Local address को 127.0.0.1:3080 पढ़ना चाहिए। यदि यह 0.0.0.0:3080 पढ़ता है, तो shipped dsh web डिफ़ॉल्ट के अलावा किसी और चीज़ ने इसे वहां रखा है, जैसे कि कोई अलग composition या config में बदलाव, और वह composition अपने स्वयं के authentication का स्वामी है। project के docs बताते हैं कि underlying web server अपना कोई authentication या Origin policy नहीं लाता है, इसलिए जब तक आप यह नहीं जानते कि उस port की सुरक्षा क्या कर रहा है, यह मान लें कि आपका firewall ही एक अजनबी और आपके agent के बीच एकमात्र बाधा है, और इसे वापस loopback पर ले जाएं। VPS पर सुरक्षित रूप से Claude Code चलाने के पीछे का तर्क dsh पर भी अपरिवर्तित लागू होता है। agent को एक workspace directory दें जिसे वह खराब करने के लिए अधिकृत है, और ऐसी कोई भी चीज़ उस machine से दूर रखें जिसे आप rebuild नहीं कर सकते। इससे भी बेहतर, उस box को coding agents के लिए एक disposable VM के रूप में मानें, क्योंकि एक VPS को rebuild करने में एक घंटा लगता है जबकि एक का audit करने में एक सप्ताह लगता है।

आपकी कुंजियाँ कहाँ रहती हैं, और फ़ाइल अनुमतियाँ (file permissions) केवल एक सीमा तक ही क्यों प्रभावी हैं

dsh अपनी API कुंजियों को $DSH_HOME/.credentials.yaml में और environment values को $DSH_HOME/.env में रखता है, जबकि model सेटिंग्स सक्रिय प्रोफ़ाइल की cordis.patch.yml में होती हैं। जब अक्टूबर 2026 में इस गाइड की पहली बार जाँच की गई थी, तब एक पुराने रिलीज़ की $DSH_HOME/settings.yaml को एक बार इम्पोर्ट करके settings.yaml.imported के रूप में रीनेम किया गया था। कौन सी कुंजी किस फ़ाइल में होनी चाहिए, और प्रत्येक मोड में वास्तव में क्या डेटा मशीन से बाहर जाता है, यह dsh की API कुंजियों, मॉडलों और एंडपॉइंट्स को कॉन्फ़िगर करने के विषय में बताया गया है। किसी भी प्लगइन को जोड़ने से पहले इसे व्यवस्थित करना उचित है, क्योंकि आपके द्वारा जोड़ी गई प्रत्येक कुंजी को प्लगइन पढ़ सकता है। संवेदनशील फ़ाइलों को सुरक्षित करें:

chmod 600 ~/.dsh/.credentials.yaml ~/.dsh/.env
ls -l ~/.dsh

Mode 600 ओनर को पढ़ने और लिखने की अनुमति देता है और बाकी किसी को कुछ नहीं देता, जिसे दोनों नोटेशन (संख्यात्मक बनाम प्रतीकात्मक chmod मोड) में जानना उपयोगी है। यह स्पष्ट समझें कि यह क्या सुरक्षा प्रदान करता है। फ़ाइल मोड उन फ़ाइलों को मशीन पर मौजूद अन्य अकाउंट्स से सुरक्षित रखते हैं। वे प्लगइन के खिलाफ कुछ नहीं करते, क्योंकि प्लगइन उसी यूज़र के रूप में चलता है जो उनका ओनर है, और उसी प्रोसेस के अंदर चलता है जो उन्हें पढ़ती है। यही कारण है कि AI एजेंट की पहुँच से रहस्यों को दूर रखने का अर्थ है उन्हें मशीन पर रखना ही नहीं। एक dsh बॉक्स में केवल वही एक मॉडल कुंजी होनी चाहिए जिसकी उसे आवश्यकता है। आपके क्लाउड क्रेडेंशियल्स और साइनिंग कुंजियाँ कहीं और होनी चाहिए।

वेब पढ़ने वाला प्लगइन थ्रेट मॉडल को क्यों बदलता है

वेब सीम प्लगइन्स को सर्च और फेच प्रोवाइडर की सुविधा देता है। जो प्लगइन किसी पेज को आपके सेशन में लाता है, वह ऐसा टेक्स्ट खींच रहा है जिसे कोई हमलावर लिख सकता है। एक मॉडल प्रॉम्प्ट निर्देशों (instructions) को डेटा से अलग नहीं करता है, इसलिए फेच किया गया पेज आपके एजेंट को संबोधित एक लाइन ले जा सकता है, और शेल क्षमता रखने वाला हार्नेस इसे रन करने से बस एक आज्ञाकारी कदम दूर होता है।

नियंत्रण पहले से ही हार्नेस में मौजूद है। dsh-base, जो web, headless, sdk और acp प्रोफाइल्स का साझा पहला बंडल है, सैंडबॉक्स और अप्रूवल पॉलिसी को शिप करता है (sdk-minimal प्रोफाइल जानबूझकर इसे छोड़ देता है)। इसका उपयोग करें। जो सेशन अविश्वसनीय पेजों को फेच कर सकता है, उसे किसी भी ऐसी चीज पर अप्रूवल की आवश्यकता होनी चाहिए जो लिखती या निष्पादित (execute) करती है, ताकि फेच किया गया निर्देश अपने आप में कोई एक्शन न बन जाए। एजेंट एक्शन्स को अप्रूवल के पीछे गेट करना इस बारे में बताता है कि उस सीमा को कहाँ तय करना है। यह संबंध दोनों दिशाओं में काम करता है, क्योंकि आपका अपना सर्वर भी एक पेज है जिसे किसी का एजेंट फेच करेगा, जो आपके सर्वर पर AI क्रॉलर्स को ब्लॉक करने का मामला है।

मैं यह कैसे जाँचूँ कि किसी plugin ने क्या बदलाव किए हैं?

install करने से पहले snapshot लें, install करें, फिर बाद में snapshot लें और अंतर देखें।

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.txt

diff यह दिखाता है कि install ने composed tree में कौन सी plugin entries जोड़ी हैं। केवल वही package tree में शामिल होता है जो bundle patch घोषित करता है; एक साधारण dependency वहाँ कुछ भी नहीं जोड़ती है और dsh इसके बारे में एक बार चेतावनी देता है। यदि आपने किसी छोटे feature के लिए कोई plugin install किया है और वह ऐसी कई entries जोड़ देता है जिन्हें आप समझ नहीं पा रहे हैं, तो उसे boot करने से पहले रुकें और source code पढ़ें। dsh plugin --profile web why <package-name> दूसरे प्रश्न का उत्तर देता है: आपकी किन direct dependencies ने किसी विशेष package को pull किया है।

Installed packages profile के अपने node_modules में, $DSH_HOME/profiles/<name>/node_modules पर स्थित होते हैं, इसलिए आप disk पर भी tree को देख सकते हैं:

ls ~/.dsh/profiles/web/node_modules

एक दूसरा profile रखें जिसमें आप कभी प्रयोग न करें। जब कोई install harness को खराब कर देता है, तो dsh --profile <clean-name> को boot करने से कुछ ही seconds में पता चल जाता है कि समस्या plugin के कारण हुई है या नहीं।

dsh plugin को कैसे हटाएँ?

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.txt

Dependency को हटाने से हमेशा configuration नहीं हटती है। profile की cordis.patch.yml में लिखी गई entries वहीं बनी रहती हैं, क्योंकि वह फ़ाइल आपकी है और harness उसे आपके लिए फिर से नहीं लिखेगा। उसे खोलें और उस package का नाम बताने वाले किसी भी block को हटा दें जिसे आपने छोड़ दिया है।

less ~/.dsh/profiles/web/cordis.patch.yml

इसके बाद उस हिस्से को देखें जिसे कोई भी uninstall command ठीक नहीं कर सकती। यदि आपने किसी plugin को इसलिए हटाया है क्योंकि आप उस पर भरोसा नहीं करते, तो जो कुछ भी वह पढ़ सकता था, उसे वह पहले ही पढ़ चुका है। provider console में DeepSeek API key को rotate करें, और $DSH_HOME में मौजूद किसी भी अन्य चीज़ को भी rotate करें। फिर यह पता लगाएँ कि जिस unix account के रूप में वह चल रहा था, वह आपके नेटवर्क के बाकी हिस्सों में कहाँ तक पहुँच सकता था।

संक्षिप्त विवरण

  • इंस्टॉलेशन से पहले प्रकाशित tarball को पढ़ें, जिसकी शुरुआत scripts और एंट्री फाइल से होती है।
  • सटीक version को पिन करें, या git spec के लिए सटीक commit को पिन करें, और lockfile को सुरक्षित रखें।
  • एक ही profile में इंस्टॉल करें, और एक साफ-सुथरी profile बनाए रखें जिसे आप किसी खराबी के समय boot कर सकें।
  • हर इंस्टॉलेशन से पहले और बाद में --dump-config का diff देखें।
  • harness को अपने स्वयं के unix user के रूप में, loopback पर चलाएं, जिसे SSH के माध्यम से एक्सेस किया जा सके।
  • बॉक्स पर केवल एक API key रखें, और जिस दिन आप किसी ऐसे plugin को हटाते हैं जिस पर अब आपको भरोसा नहीं है, उस दिन उसे rotate कर दें।

इनमें से कोई भी बात plugins से बचने का कारण नहीं है। plugin मॉडल ही वह कारण है जिससे dsh उपयोगी है, और जिस harness को आप extend नहीं कर सकते, उसे आप अंततः बदल देंगे। यह सब जानने का कारण यह है कि आपने क्या इंस्टॉल किया है, किससे किया है, किस version पर किया है, और पूरी प्रक्रिया को ऐसी जगह चलाएं जिसे आप दोबारा बना सकें।

FAQ

क्या dsh plugins को एक-दूसरे से sandbox करता है?

नहीं। एक plugin को Cordis के माध्यम से harness process में load किया जाता है और यह documented capability seams तक पहुँच सकता है, जिसमें shell, filesystem, web, subprocess, subagent और credentials शामिल हैं। dsh-base, जो web, headless, sdk और acp profiles का पहला साझा bundle है, वह sandbox और approval policy प्रदान करता है जो यह नियंत्रित करती है कि agent के tools क्या कर सकते हैं, और आपकी सुरक्षा इसी policy से सुनिश्चित होती है। यहाँ प्रति-plugin कोई permission boundary नहीं है, इसलिए सही मॉडल यह है कि plugin install करना उस plugin के लेखक और उसकी dependency tree में मौजूद हर package पर आपके भरोसे को बढ़ाता है।

क्या मैं बिना install scripts चलाए dsh plugin install कर सकता हूँ?

pnpm 10 और उसके बाद के versions डिफ़ॉल्ट रूप से dependency build scripts को रोक देते हैं, और dsh plugin ... add pnpm को ही forward करता है, इसलिए वर्तमान pnpm पर install के दौरान package scripts तब तक नहीं चलतीं जब तक आप उस package को approve न करें। pnpm --version के साथ अपना version confirm करें। यह किसी unread plugin को सुरक्षित नहीं बनाता है। plugin का अपना code तब चलता है जब harness उसे load करता है, जो dsh plugin install के बाद अगले profile restart पर होता है, या अक्सर web Plugins page से install करने के तुरंत बाद, और install-time की कोई भी पाबंदी इसे प्रभावित नहीं करती है।

dsh plugins और उनकी config वास्तव में कहाँ रहती हैं?

$DSH_HOME डिफ़ॉल्ट रूप से ~/.dsh का उपयोग करता है। Profiles $DSH_HOME/profiles/<name> में स्थित होते हैं, जिनमें से प्रत्येक में plugin dependencies के साथ एक package.json, bundles का क्रमबद्ध dsh.profile manifest, और एक cordis.patch.yml patch layer होता है। Installed packages प्रत्येक profile के अपने node_modules में, $DSH_HOME/profiles/<name>/node_modules पर स्थित होते हैं। Keys $DSH_HOME/.credentials.yaml में होती हैं, environment values $DSH_HOME/.env में होती हैं, और एक home-level $DSH_HOME/cordis.patch.yml हर profile पर लागू होता है। बिना boot किए composed result देखने के लिए dsh --profile web --dump-config चलाएँ।

क्या dsh plugin market से install करना सुरक्षित है?

Market installs को केवल curated registry के स्रोतों तक सीमित रखता है और build scripts को तब तक रोकता है जब तक आप उन्हें प्रति-package approve न करें, जो कि chat window से package name copy-paste करने की तुलना में एक वास्तविक सुधार है। इसके अपने README में अभी भी यह लिखा है कि listing का मतलब endorsement नहीं है, क्योंकि plugins अन्य लोगों द्वारा बनाया गया third-party code हैं। source code पढ़ें और version को pin करें। harness को ऐसे user account पर रखें, और आदर्श रूप से ऐसी machine पर, जिसे खोने का जोखिम आप उठा सकते हैं।

क्या यह लेख उपयोगी था?