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

DeepSeek Harness इंस्टॉलेशन और वर्जन एरर कैसे ठीक करें

DeepSeek Harness का लेटेस्ट बिल्ड अभी भी प्री-रिलीज़ है। इंस्टॉलेशन एरर ठीक करने के लिए एक सटीक dsh वर्जन पिन करें, npx कैश साफ़ करें और जांचें कि आप कौन सा npm रन कर रहे हैं।

DeepSeek Harness इंस्टॉलेशन वास्तव में क्या है

DeepSeek Harness इंस्टॉलेशन केवल एक कमांड है: npx @deepseek-ai/dsh web। इसमें कोई इंस्टॉलर नहीं है और कॉन्फ़िगर करने के लिए कोई सर्विस नहीं है। लोग जिन समस्याओं का सामना करते हैं, उनमें से अधिकांश इंस्टॉलेशन से संबंधित नहीं होती हैं। यह वर्जन रिज़ॉल्यूशन (version resolution) की समस्या है: npx ने आज @deepseek-ai/dsh का कौन सा बिल्ड चलाने का निर्णय लिया है, और क्या आपका Node.js वर्जन उसे चलाने में सक्षम है। जब यह शुरू होता है, तो localhost डिफ़ॉल्ट बाइंडिंग होती है; --host और --port लिसनर सेटिंग्स को ओवरराइड करते हैं, और कॉन्फ़िगर होने पर प्रिंट किया गया पता --public-url का उपयोग करता है। डिफ़ॉल्ट बाइंडिंग और Web UI केवल 127.0.0.1:3080 पर उत्तर क्यों देता है इस पृष्ठ पर दी गई समस्याओं से अलग एक समस्या है।

नीचे दी गई हर बात दो तथ्यों पर आधारित है। पहला, 27 October 2026 तक npm पर प्रकाशित @deepseek-ai/dsh का प्रत्येक वर्जन एक प्री-रिलीज़ था। अधिकांश रिलीज़ कैंडिडेट्स (-rc.N) हैं, और 30 August 2026 से अल्फा बिल्ड्स (-alpha.N) भी उपलब्ध हैं। latest टैग एक रिलीज़ कैंडिडेट की ओर इशारा करता है। 6 November 2026 तक वह 0.2.2-rc.1 है। दूसरा, प्रोजेक्ट README में कहा गया है कि हार्नेस डेवलपर प्रीव्यू में है, इसमें तेज़ी से बदलाव हो रहे हैं, और इसमें ऐसे बदलाव होंगे जो कम्पैटिबिलिटी को तोड़ सकते हैं। जो फ्लैग पिछले सप्ताह काम कर रहा था, वह इस सप्ताह गायब हो सकता है। किसी भी चीज़ को उस पर आधारित करने से पहले एक वर्जन को पिन (pin) करें।

पहले कुछ शब्दों को समझें। dsh, DeepSeek Harness कमांड लाइन टूल है। Node.js वह JavaScript रनटाइम है जिसकी इसे आवश्यकता होती है। npx वह पैकेज रनर है जो npm (node package manager) के साथ आता है, और यह पैकेज को स्थायी रूप से इंस्टॉल करने के बजाय मांग पर फेच (fetch) करता है। यदि उस वाक्य में 'हार्नेस' शब्द का उपयोग अपरिचित लग रहा है, तो एजेंट हार्नेस वह प्रोग्राम है जो मॉडल के चारों ओर लिपटा होता है, जो लूप, टूल्स, अनुमतियों और सेशन स्टेट को संभालता है, यही कारण है कि आपके द्वारा न चुना गया वर्जन नंबर आपके एजेंट के व्यवहार को बदल सकता है।

dsh को किस Node.js version की आवश्यकता है?

10 अक्टूबर 2026 को, जब repository version 0.2.1-alpha.2 पर थी, तब इसके root package.json ने "engines": {"node": "^22.19.0 || >=24.0.0"} घोषित किया था। अब वह आवश्यकता नहीं रही। 27 अक्टूबर 2026 को, जब repository version 0.2.1-rc.3 पर थी, तब root package.json ने "engines": {"node": ">=24.9.0"} घोषित किया, और CLI के अपने source package.json ने भी अब यही घोषित किया है। 15 अक्टूबर 2026 के एक project decision note के अनुसार Node 22 installations को upgrade करना होगा, और Node 24.0 भी पर्याप्त नहीं है, क्योंकि entry points import.meta.main पर निर्भर हैं, जो 24.0 में उपलब्ध नहीं है। इसलिए Node 24.9.0 या उससे नया version आवश्यक है। Node 20 और Node 22 बाहर हैं, और 24.9.0 से पहले का कोई भी Node 24 release भी मान्य नहीं है। 27 अक्टूबर 2026 को जाँच करने पर, 0.2.1-rc.2 के release tags, फिर build latest जिसे इंगित किया गया था, और 0.2.1-rc.3 में अभी भी पुरानी range थी, इसलिए नई न्यूनतम सीमा उनके बाद लागू हुई। फिर भी 24.9.0 के लिए योजना बनाएँ, क्योंकि project अब यही range घोषित करता है।

किसी भी अन्य कार्य से पहले जाँचें कि आपके पास क्या है।

node -v
npm -v

यहाँ वह हिस्सा है जो लोगों को आश्चर्यचकित करता है। 27 अक्टूबर 2026 तक, प्रकाशित @deepseek-ai/dsh package में 0.2.1-rc.4 तक के अपने 38 versions में से किसी में भी अपना engines field नहीं था। monorepo root एक field घोषित करता है, और वह root file कभी भी npm पर प्रकाशित नहीं होती है। CLI के source package.json में 15 अक्टूबर 2026 के एक commit में यह field जुड़ा, लेकिन 27 अक्टूबर को जाँचे गए किसी भी प्रकाशित build में यह शामिल नहीं था। इसलिए उन builds ने npm को जाँचने के लिए कोई dsh-विशिष्ट Node आवश्यकता नहीं दी। 6 नवंबर 2026 तक, प्रकाशित 0.2.2-rc.1 package "engines": {"node": ">=24.9.0"} घोषित करता है। npm engines को केवल सलाह के रूप में मानता है जब तक कि आप engine-strict set न करें, इसलिए default setting के साथ अधिक से अधिक एक warning की अपेक्षा करें। एक unsupported Node पर install ऐसा दिखेगा जैसे यह काम कर गया, और विफलता बाद में आती है, जब loaded code ऐसी syntax या API को छूता है जो आपके runtime में नहीं है। खोजने के लिए कोई एक स्थिर error string नहीं है, क्योंकि कौन सी line पहले विफल होगी यह इस पर निर्भर करता है कि कौन सा module पहले load होता है। crash को पढ़ने के बजाय node -v पढ़ें।

यदि आपका Node बहुत पुराना है, तो VPS पर nvm (node version manager) सबसे कम invasive समाधान है, क्योंकि यह आपके home directory के अंतर्गत install होता है और system Node को प्रभावित नहीं करता है।

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 -v

node -v को अब v24. से शुरू होने वाला version print करना चाहिए। यदि shell अभी भी पुराना version दिखाता है, तो which node चलाएँ। ~/.nvm के बाहर एक path के दो सामान्य कारण होते हैं। या तो nvm shell function load नहीं हुआ था, इसलिए एक नया login shell खोलें और पुनः प्रयास करें, या आपके shell profile की कोई line nvm को source करने वाली lines के बाद PATH को बदल देती है और किसी अन्य Node को पहले रख देती है, इसलिए उस line को nvm lines के ऊपर ले जाएँ। Node 24, 10 अक्टूबर 2026 को active LTS (long term support) line थी और 20 अक्टूबर 2026 को maintenance में चली गई। 29 अक्टूबर 2026 तक इसका नवीनतम release 24.22.2 है, जो 24.9.0 की न्यूनतम सीमा से काफी ऊपर है। Node 26, जिसे >=24.9.0 range भी अनुमति देती है, 28 अक्टूबर 2026 को version 26.13.0 के साथ active LTS में प्रवेश कर गया। दोनों ही न्यूनतम सीमा को पूरा करते हैं, और दोनों में नीचे वर्णित range-cache fix के साथ npm versions शामिल हैं। आधिकारिक Node 26 Linux binaries के लिए libatomic की भी आवश्यकता होती है, जिसे आपके distribution को अलग से install करने की आवश्यकता हो सकती है।

npx हर दिन अलग version क्यों चलाता है?

npx @deepseek-ai/dsh web किसी version का नाम नहीं लेता है। जब तक कि आपकी वर्तमान directory में मौजूद project में @deepseek-ai/dsh पहले से installed न हो (जिस स्थिति में npx उस copy को चलाता है), npx registry से पूछता है कि latest tag किस ओर इशारा कर रहा है। वह tag बदलता रहता है, और अक्सर बदलता है। 0.1.0-rc.8, 0.1.0-rc.7 के दो दिन बाद, 19 August 2026 को आया था। 10 October 2026 तक latest, 0.2.0-rc.2 की ओर इशारा कर रहा था, और 27 October 2026 तक यह 0.2.1-rc.2 की ओर इशारा करने लगा। हर बार जब यह बदलता है, तो आपके notes में मौजूद command अलग code चलाना शुरू कर देती है, बिना किसी prompt या आपके सामने किसी changelog के।

आप command line से हर बदलते हिस्से की जाँच कर सकते हैं।

npm view @deepseek-ai/dsh dist-tags
npm view @deepseek-ai/dsh versions --json
npm view @deepseek-ai/dsh time --json

dist-tags दिखाता है कि latest अभी किस ओर इशारा कर रहा है। 10 October 2026 को latest और next दोनों 0.2.0-rc.2 की ओर इशारा कर रहे थे, और एक तीसरा tag, alpha, एक दिन पहले publish हुए 0.2.1-alpha.2 की ओर इशारा कर रहा था। 27 October 2026 को latest, 0.2.1-rc.2 की ओर, next एक दिन पहले publish हुए 0.2.1-rc.4 की ओर, और alpha, 0.2.1-alpha.5 की ओर इशारा कर रहे थे। 6 November 2026 तक, latest, 0.2.2-rc.1 की ओर इशारा करता है। 4 November 2026 को, next, 0.2.1-rc.5 की ओर, और alpha, 0.2.2-alpha.3 की ओर इशारा कर रहे थे। latest tag अभी भी एक prerelease को चुनता है। versions सूची अधिक दिलचस्प है, क्योंकि इसमें खाली जगहें (holes) हैं। 10 October 2026 को इसमें 31 versions थे, 0.0.1-rc.1 से 0.2.1-alpha.2 तक, और 27 October 2026 तक इसमें 38 versions थे, जिनमें से प्रत्येक अभी भी एक prerelease था। 0.0.1 line -rc.2 से -rc.5 पर कूदती है, 0.1.0 line -rc.3 से -rc.6 पर कूदती है, alpha builds 0.1.2-alpha.2 और 0.1.3-alpha.2 से शुरू होते हैं, और वहाँ कोई 0.1.4 मौजूद ही नहीं है। publish की गई सूची से numbers गायब हैं, और alpha builds तथा release candidates एक ही सूची में आपस में मिले हुए हैं। deploy script में अगले -rc.N का अनुमान लगाना विफल रहेगा, इसलिए ऊपर की ओर गिनती करने के बजाय सूची को पढ़ें।

npx पुराना वर्ज़न क्यों चलाता रहता है?

यह पिछली समस्या के विपरीत है, और पैकेज स्पेक (package spec), लोकल इंस्टॉलेशन और आप कौन सा npm चला रहे हैं, इस आधार पर दोनों ही बातें सच हो सकती हैं।

npx अपनी खुद की पैकेज डायरेक्टरी रखता है, जो tarball कैश से अलग होती है। यह npm कैश के अंदर _npx नामक फोल्डर में होती है। पाथ प्रिंट करें और उसे देखें।

npm config get cache
ls "$(npm config get cache)/_npx"

npm 10.9.3 प्रोजेक्ट इंस्टॉलेशन के बाहर बेयर पैकेज नाम (bare package name) के लिए रजिस्ट्री की जाँच करता है। npm 11.2.0 ने वर्ज़न रेंज के लिए कैश फ्रेशनेस जाँच में बदलाव किया है। जब स्पेक एक बेयर नाम होता है और पैकेज वर्तमान प्रोजेक्ट में पहले से इंस्टॉल नहीं होता, तो npx preferOnline: true के साथ मैनिफेस्ट फेच करता है। यह _npx में मौजूद कैश कॉपी का उपयोग तभी करता है जब रिज़ॉल्व किया गया tarball रजिस्ट्री द्वारा लौटाए गए परिणाम से मेल खाता हो। बेयर नाम अभी भी उस वर्ज़न से मेल खाता है जो वर्तमान प्रोजेक्ट में इंस्टॉल है, जिसमें कोई रजिस्ट्री जाँच नहीं होती। वर्ज़न रेंज के लिए, npm 10.9.3 एक मेल खाने वाले कैश वर्ज़न को स्वीकार करता है; npm 11.2.0 और उसके बाद के वर्ज़न यह जाँचते हैं कि क्या रेंज किसी नए वर्ज़न पर रिज़ॉल्व होती है।

आपको कौन सा व्यवहार मिलेगा, यह इस बात पर निर्भर करता है कि आप वास्तव में कौन सा npm चला रहे हैं। जब तक आपने npm install -g npm के साथ npm को अलग से अपग्रेड नहीं किया है, तब तक वह वही npm है जो आपके Node रिलीज़ के साथ आता है:

  • Node 20.20.2 में npm 10.8.2 शामिल है।
  • Node 22.19.0 में npm 10.9.3 शामिल है।
  • Node 22.23.4, जो 27 अक्टूबर 2026 तक का नवीनतम 22 रिलीज़ है, में npm 10.9.9 शामिल है।
  • Node 24.9.0, जो हार्नेस का वर्तमान न्यूनतम वर्ज़न है, में npm 11.6.0 शामिल है।
  • Node 24.19.0 में npm 11.17.0 शामिल है।
  • Node 24.22.2, जो 29 अक्टूबर 2026 तक का नवीनतम 24 रिलीज़ है, में npm 11.19.1 शामिल है।
  • Node 26.13.0, जो 29 अक्टूबर 2026 तक का नवीनतम 26 रिलीज़ है, में npm 11.20.0 शामिल है।

अतः पूरी Node 22 लाइन में 11.2.0 से पुराना npm है। हार्नेस ने अक्टूबर 2026 के मध्य तक Node 22 का समर्थन किया था और अब नहीं करता, लेकिन जिस सर्वर पर उससे पहले dsh चलता था, वह अभी भी उस पर हो सकता है। Node 22.19.0 का बंडल किया गया npm 10.9.3 प्रोजेक्ट इंस्टॉलेशन के बाहर एक बेयर npx @deepseek-ai/dsh web को रजिस्ट्री के विरुद्ध फिर से जाँचता है, इसलिए केवल एक पुराना _npx एंट्री पुराने रिलीज़ कैंडिडेट का कारण नहीं हो सकती। हार्नेस अब जिन Node रिलीज़ को स्वीकार करता है, 24.9.0 से ऊपर के सभी में npm 11.6.0 या उससे नया वर्ज़न है, जिसमें रेंज-कैश फिक्स भी शामिल है। प्रोजेक्ट इंस्टॉलेशन अभी भी प्राथमिकता ले सकता है। टूल से पूछें कि वह क्या है:

npx @deepseek-ai/dsh --version

npx कैश को क्लियर करना

npm 11.2.0 और उसके बाद के वर्ज़न में समर्पित सब-कमांड्स होते हैं।

npm cache npx ls
npm cache npx rm --force

--force के बिना, npm सब कुछ हटाने से मना कर देता है और Please use --force to remove entire npx cache प्रिंट करता है। जब आप सभी के बजाय केवल एक एंट्री को की (key) के आधार पर हटाना चाहते हैं, तो पहले npm cache npx ls का उपयोग करें।

npm 10 में ये सब-कमांड्स मौजूद नहीं हैं, इसलिए डायरेक्टरी को खुद डिलीट करें।

rm -rf "$(npm config get cache)/_npx"

npm cache clean --force यहाँ मदद नहीं करता। यह _cacache (tarball स्टोर) को क्लियर करता है, और _npx को नहीं छूता। यही अलगाव कारण है कि npm ने बाद में npm cache npx सब-कमांड्स जोड़े। _npx को क्लियर करने से आपका कोई स्थायी नुकसान नहीं होता: इसमें डाउनलोड किए गए पैकेज होते हैं, जबकि आपका हार्नेस स्टेट $DSH_HOME के तहत अलग से रहता है, जिसमें profiles/<name>, sessions, storages, और .credentials.yaml शामिल हैं, और वे सुरक्षित रहते हैं।

मैं किसी सटीक release candidate को कैसे पिन करूँ?

पूरा version string लिखें, जिसमें -rc.N वाला भाग भी शामिल हो।

npx --yes @deepseek-ai/dsh@0.1.0-rc.7 web

इस पृष्ठ पर दिए गए उदाहरण 0.1.0-rc.7 का उपयोग करते हैं। उस build को लिखें जिसका आपने वास्तव में परीक्षण किया है। 27 October 2026 को latest टैग 0.2.1-rc.2 की ओर इशारा कर रहा था।

--yes इंटरैक्टिव प्रॉम्प्ट के बिना npx के package-install कन्फर्मेशन को स्वीकार कर लेता है।

एक सटीक version dsh पैकेज को पिन करता है, लेकिन यह ऑफलाइन स्टार्ट की गारंटी नहीं देता है। npx अपनी कैश डायरेक्टरी को आपके द्वारा टाइप किए गए spec string के आधार पर व्यवस्थित करता है और वहां पहले से इंस्टॉल किए गए सटीक version का पुन: उपयोग कर सकता है। हालाँकि, यदि कोई मेल खाने वाला स्थानीय इंस्टॉलेशन मौजूद नहीं है, तो पिछला local-tree चेक _npx का निरीक्षण करने से पहले preferOnline: true के साथ मैनिफेस्ट को फेच करता है। स्थानीय प्रोजेक्ट में इंस्टॉल किया गया एक सटीक version उस मैनिफेस्ट लुकअप से बचाता है। प्रोजेक्ट के बाहर चलाया गया एक साधारण नाम जो dsh इंस्टॉल करता है, वह भी npm 10.9.3 सहित मैनिफेस्ट लुकअप को ट्रिगर करता है।

एक ग्लोबल इंस्टॉलेशन भी इसी तरह पिन करता है, और आपको एक छोटा कमांड देता है।

npm install -g @deepseek-ai/dsh@0.1.0-rc.7
dsh --version

@deepseek-ai/dsh@^0.1.0 के लिए कोई मेल खाने वाला version नहीं मिला

27 October 2026 तक, इस पैकेज के खिलाफ एक साधारण caret या tilde रेंज विफल रही। npm install -g @deepseek-ai/dsh@^0.1.0 ने एरर कोड ETARGET और लाइन No matching version found for @deepseek-ai/dsh@^0.1.0. के साथ उत्तर दिया। रजिस्ट्री ठीक है। यह एक semver नियम है: एक version रेंज तब तक prerelease version से मेल नहीं खाती जब तक कि रेंज का अपना कोई कंपरेटर समान major, minor और patch नंबर वाले prerelease का नाम न ले। 27 October 2026 तक इस पैकेज का हर प्रकाशित build एक prerelease था, या तो -rc.N या -alpha.N, और ^0.1.0 ने किसी का नाम नहीं लिया, इसलिए यह किसी से मेल नहीं खाया। सटीक version लिखें।

यह नियम दोनों तरफ काम करता है। एक साधारण रेंज कभी भी नए release candidate पर नहीं जाती है, लेकिन एक रेंज जो prerelease का नाम लेती है, वह जा सकती है। ^0.1.0-rc.7 का अर्थ >=0.1.0-rc.7 <0.2.0-0 है, इसलिए यह 0.1.0-rc.8 को स्वीकार करता है और एक अंतिम 0.1.0 को भी स्वीकार करेगा, जबकि 0.1.1-rc.1 बाहर रहता है क्योंकि इसके नंबर अलग हैं। यह एक सटीक version और एक मूविंग टैग के बीच की आधी-पिन की हुई स्थिति है, और यह आपके कुछ भी बदले बिना यह बदल देता है कि क्या रन होगा। यदि आप केवल वही build चाहते हैं जिसका आपने परीक्षण किया है और कुछ और नहीं, तो सटीक version लिखें।

क्या मुझे npx का उपयोग करना चाहिए या dsh को globally install करना चाहिए?

पहली बार देखने के लिए npx का उपयोग करें, क्योंकि package एक cache directory में रहता है जिसे आप अब साफ़ करना जानते हैं। किसी ऐसी चीज़ के लिए pinned global install का उपयोग करें जिसे reboot के बाद भी काम करना है, जैसे कि एक coding agent जिसे आप VPS पर चलाकर रखते हैं।

यदि आपने एक ही मशीन पर दोनों का उपयोग किया है, तो वे आपस में विरोधाभासी हो सकते हैं, इसलिए उनकी तुलना करें।

which dsh
dsh --version
npx @deepseek-ai/dsh --version

which dsh सफल global install के तुरंत बाद कुछ न मिलने का मतलब लगभग हमेशा यह होता है कि npm की global bin directory आपके PATH में मौजूद नहीं है। root directory को print करने के लिए npm prefix -g चलाएँ, और binaries इसके अंतर्गत bin folder में स्थित होती हैं।

एक सुरक्षा संबंधी टिप्पणी। npx हर बार registry से code fetch और execute करता है जब वह कुछ नया resolve करता है, जो एक सर्वर पर सैद्धांतिक के बजाय एक वास्तविक खतरा है। Pinning इस समस्या के समाधान का एक हिस्सा है। बाकी जानकारी npm supply chain attacks सर्वर तक कैसे पहुँचते हैं में दी गई है।

Developer preview का reproducibility के लिए क्या अर्थ है

0.1.0-rc.6 को 13 August 2026 को और 0.1.0-rc.7 को 17 August 2026 को पब्लिश किया गया था। इनमें केवल चार दिनों का अंतर था। तब से गति धीमी नहीं हुई है: 19 August और 9 October 2026 के बीच 24 और वर्ज़न पब्लिश किए गए, जिनमें 28 September को 0.2.0-rc.1 और अगले दिन 0.2.0-rc.2 शामिल हैं, और 14 से 26 October 2026 के बीच सात और वर्ज़न आए, जो 0.2.1-rc.4 तक पहुँच गए। इस गति पर, एक महीने पहले लिखे गए निर्देश ऐसे कमांड लाइन का वर्णन कर सकते हैं जो अब मौजूद नहीं है, और इसमें यह पेज भी शामिल है। अपने द्वारा लिखे गए हर वर्ज़न दावे की तारीख लिखें, जिसमें आपके अपने नोट्स भी शामिल हैं।

दो आदतें preview को प्रबंधनीय बनाती हैं। हर कमांड और हर स्क्रिप्ट में सटीक वर्ज़न को पिन करें, ताकि सर्वर को फिर से बनाने पर वही dsh रिलीज़ चुनी जाए। केवल इतना करने से इसकी dependencies reproduce नहीं होतीं: पब्लिश किया गया 0.2.2-rc.1 पैकेज js-yaml: ^4.3.2 और commander: ^15.0.0 जैसी ranges का उपयोग करता है, और बिना npm shrinkwrap के आता है। बार-बार एक जैसी dependency install करने के लिए, dsh को एक लोकल प्रोजेक्ट में रखें, जिसमें एक committed package-lock.json हो और npm ci के साथ rebuild करें। फिर किसी गाइड के बजाय पिन किए गए बिल्ड से help आउटपुट पढ़ें।

npx @deepseek-ai/dsh@0.1.0-rc.7 --help
npx @deepseek-ai/dsh@0.1.0-rc.7 web --dump-config

Reproducibility का दूसरा हिस्सा प्रोफाइल है। dsh --profile <name>, $DSH_HOME/profiles/<name> पर स्टोर की गई प्रोफाइल को बूट करता है, और web तथा headless प्रोफाइल पहली बार उपयोग करने पर शिप किए गए टेम्प्लेट से खुद को बनाती हैं। प्रोफाइल पैच में model और endpoint सेटिंग्स हो सकती हैं, लेकिन सेव की गई API keys $DSH_HOME/.credentials.yaml में रहती हैं, जबकि सेटिंग्स में क्रेडेंशियल रेफरेंस होते हैं। इसलिए, एक पिन किया गया वर्ज़न और एक वर्किंग कॉन्फ़िगरेशन, दोनों को सही रखना दो अलग-अलग काम हैं। होम-लेवल और कमांड-लाइन पैच प्रोफाइल सेटिंग्स को ओवरराइड कर सकते हैं। इन-बॉक्स बंडल वर्तमान में चल रहे dsh इंस्टॉलेशन से रिज़ॉल्व होते हैं, जिसका अर्थ है कि अपने पिन किए गए वर्ज़न को बदलने से वे बंडल भी बदल जाते हैं। आउट-ऑफ-ट्री प्लगइन्स अलग तरह से व्यवहार करते हैं। वे प्रोफाइल डायरेक्टरी में रहते हैं, और dsh plugin --profile <name> add <package> अपने आर्गुमेंट्स को इंस्टॉल करने के लिए pnpm को फॉरवर्ड करता है। इसलिए pnpm का आपके PATH पर होना आवश्यक है, और जब ऐसा नहीं होता है तो dsh इसे स्पष्ट रूप से बताता है। आपके द्वारा जोड़ा गया प्रत्येक प्लगइन उन्हीं अनुमतियों के साथ चलता है जो आपके एजेंट के पास हैं, इसलिए प्लगइन इंस्टॉल करने से पहले यह जांचना कि वह क्या एक्सेस कर सकता है महत्वपूर्ण है। प्रोफाइल की अपनी package.json उन प्लगइन्स को घोषित करती है; इसकी pnpm-lock.yaml को सुरक्षित रखें और उनकी dependency वर्ज़न को भी reproduce करने के लिए pnpm install --frozen-lockfile का उपयोग करें।

यदि आपने सर्वर पर Python टूल्स को आइसोलेटेड एनवायरनमेंट में रखा है, तो यह विभाजन आपको परिचित लगेगा: टूल और जो चीजें आप इसमें जोड़ते हैं, वे अलग-अलग जगहों पर पिन की जाती हैं। एक बार हार्नेस शुरू हो जाने के बाद, अगला सवाल आमतौर पर वर्ज़न के बजाय नेटवर्किंग का होता है, जहाँ रिमोट VPS पर dsh Web UI तक पहुँचना और VPS पर DeepSeek Harness इंस्टॉल करना में दिया गया विस्तृत वॉकथ्रू काम आता है।

तर्क संबंधी त्रुटियाँ जो आपको वास्तव में दिखाई देंगी

ये त्रुटियाँ CLI के अपने पार्सर से आती हैं, और प्रत्येक त्रुटि सटीक समस्या का नाम बताती है। इनकी शब्दावली अधिकांश बिल्ड्स में स्थिर रही है, लेकिन पूरी तरह से नहीं, इसलिए नीचे दिए गए संदेशों की जाँच 6 अक्टूबर 2026 को 0.2.0-rc.2 के विरुद्ध की गई थी।

error: --profile <name> is required

आपने बिना किसी सब-कमांड और बिना किसी प्रोफाइल के npx @deepseek-ai/dsh चलाया। बेयर कमांड एक प्रोफाइल को बूट करता है, इसलिए इसे एक नाम की आवश्यकता होती है। dsh web बिना --profile के काम करता है क्योंकि पार्सर पहले शब्द को प्रोफाइल नाम के रूप में पढ़ता है, इसलिए यह आपके लिए शिप किया गया web प्रोफाइल बूट कर देता है।

error: --patch needs a path

--patch को बिना किसी मान के पास किया गया था। यह फ्लैग दोहराया जा सकता है, और प्रत्येक उपयोग एक फाइल पाथ लेता है।

error: --dump-config and --dump-default-config are mutually exclusive

इनमें से किसी एक को चुनें। 0.2.0-rc.2 में, जो कि 6 अक्टूबर 2026 को इंगित बिल्ड latest है, संदेश एक तीसरे फ्लैग का नाम लेता है और error: --dump-config, --dump-default-config, and --dump-config-schema are mutually exclusive पढ़ता है, क्योंकि --dump-config-schema, जो प्रोफाइल प्रविष्टियों और पैच के लिए JSON Schema प्रिंट करता है, अन्य दो के साथ जुड़ गया है। --dump-default-config शिप किए गए बंडल लेयर्स को प्रिंट करता है और कोई --patch स्वीकार नहीं करता है। --dump-config एक प्रोफाइल के लिए कंपोज्ड कॉन्फ़िगरेशन को प्रिंट करता है। ये तीनों हार्नेस को शुरू करने से बचते हैं, लेकिन स्कीमा कलेक्शन प्लगइन मॉड्यूल्स को इम्पोर्ट करता है और गेटर्स तथा लेज़ी बिल्डर्स को इनवोक कर सकता है; केवल विश्वसनीय प्लगइन्स का निरीक्षण करें और स्क्रिप्ट्स में बाहरी टाइमआउट लागू करें।

error: plugin needs pnpm arguments to forward (e.g. add <package>)

dsh plugin --profile <name> को आगे भेजने के लिए कुछ भी नहीं दिया गया था। जब प्रोफाइल मौजूद नहीं होता है तो यह सब-कमांड उसे इनिशियलाइज़ करता है, फिर कमांड लाइन के बाकी हिस्से को pnpm को सौंप देता है, इसलिए इसे add @scope/dsh-plugin-example जैसे तर्कों की आवश्यकता होती है।

FAQ

DeepSeek Harness को Node.js के किस version की आवश्यकता है?

Node.js 24.9.0 या उससे नया version। 27 October 2026 को पढ़े गए अनुसार, version 0.2.1-rc.3 वाले repository के root में package.json, >=24.9.0 घोषित करता है। 10 October 2026 को इसने ^22.19.0 || >=24.0.0 घोषित किया था, लेकिन 15 October 2026 के एक project निर्णय नोट ने Node 22 को हटा दिया और न्यूनतम आवश्यकता को 24.0 से ऊपर कर दिया। Node 20 और Node 22 काम नहीं करेंगे, और 24.9.0 से पुराना कोई भी Node 24 release भी काम नहीं करेगा। 27 October 2026 तक किसी भी प्रकाशित npm build में अपना स्वयं का engines field नहीं था, इसलिए npm dsh की अपनी Node आवश्यकता के आधार पर चेतावनी या block नहीं कर सका, और unsupported runtime बाद में विफल हो गया। 6 November 2026 को जाँचे गए प्रकाशित 0.2.2-rc.1 package में अब engines.node में >=24.9.0 घोषित है; npm डिफ़ॉल्ट रूप से चेतावनी देता है और engine-strict सक्षम होने पर incompatible runtime को अस्वीकार कर देता है। सबसे पहले node -v की जाँच करें। Node का हर वह release जो इस न्यूनतम सीमा को पूरा करता है, उसमें npm 11 या उससे नया version शामिल है, जिसमें npm 11.2.0 में पेश किया गया npx range-cache fix भी शामिल है।

मैं npx को cached version के बजाय नवीनतम dsh का उपयोग करने के लिए कैसे बाध्य करूँ?

npm 10.9.3 और वर्तमान npm पहले से ही bare package name के लिए registry की पुनः जाँच करते हैं, जब तक कि वर्तमान directory dsh इंस्टॉल वाला कोई project न हो, जिस स्थिति में npx उस local copy को चलाता है। registry के latest tag का स्पष्ट रूप से अनुरोध करने के लिए npx @deepseek-ai/dsh@latest --version का उपयोग करें। npm 11.2.0 ने version ranges के लिए freshness checks को बदल दिया है, bare names के लिए नहीं। npm 11.2.0 और नए versions पर npm cache npx rm --force के साथ npx cache को साफ़ करें, या npm 10 पर rm -rf "$(npm config get cache)/_npx" के साथ folder को हटा दें। फिर npx @deepseek-ai/dsh --version के साथ पुष्टि करें। ध्यान दें कि npm cache clean --force एक अलग directory को साफ़ करता है और इससे यह समस्या ठीक नहीं होगी।

@deepseek-ai/dsh@^0.1.0 को इंस्टॉल करना विफल क्यों हो जाता है?

27 October 2026 तक, npm ने No matching version found for @deepseek-ai/dsh@^0.1.0. पंक्ति के साथ error code ETARGET लौटाया। उस जाँच के समय हर प्रकाशित build एक prerelease थी जैसे कि 0.2.0-rc.2 या 0.2.1-alpha.2, और एक semver range prerelease versions से मेल नहीं खाती जब तक कि range स्वयं उसी major, minor और patch numbers के साथ prerelease का नाम न ले। suffix सहित सटीक version string इंस्टॉल करें। यह देखने के लिए कि कौन से versions मौजूद हैं, npm view @deepseek-ai/dsh versions --json चलाएँ, क्योंकि sequence में अंतराल हैं।

क्या मुझे dsh को global स्तर पर इंस्टॉल करना चाहिए या npx के माध्यम से चलाना चाहिए?

npx पहली बार देखने के लिए उपयुक्त है, क्योंकि package अपनी cache directory में रहता है; harness persistent profile state भी बनाता है। npm install -g @deepseek-ai/dsh@0.1.0-rc.7 जैसा एक pinned global install किसी भी ऐसी चीज़ के लिए उपयुक्त है जिसे काम करते रहना है, क्योंकि version तभी बदलता है जब आप इसे बदलते हैं। यदि global install के बाद dsh command नहीं मिलती है, तो npm की global bin directory आपके PATH से गायब है, और npm prefix -g उस root को print करता है जिसके अंतर्गत यह स्थित है।

क्या DeepSeek Harness इतना स्थिर है कि उस पर निर्माण किया जा सके?

अभी तक नहीं, इसके स्वयं के विवरण के अनुसार। README में कहा गया है कि project developer preview में है, तेज़ी से विकसित हो रहा है, और इसमें compatibility-breaking बदलाव होंगे। Release candidates 0.1.0-rc.6 और 0.1.0-rc.7 को August 2026 में चार दिनों के अंतराल पर, 0.2.0-rc.1 और 0.2.0-rc.2 को September 2026 में एक दिन के अंतराल पर, और 0.2.1-rc.1 और 0.2.1-rc.2 को October 2026 में एक ही दिन प्रकाशित किया गया था। समर्थित Node range भी October 2026 में बदल गई। एक सटीक version को pin करें और किसी भी guide के बजाय उस pinned build से --help पढ़ें। अपने नोट्स पर तारीख डालें, ताकि आप जान सकें कि वे कितने पुराने हो गए हैं।

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