डीपसीक हार्नेस: स्थापना, क्षमताएं और पहला लॉन्च

डीपसीक हार्नेस, या संक्षेप में डीएसएच, डीपसीक एआई का एक खुला स्रोत एआई एजेंट हार्नेस है। यदि मॉडल प्रश्नों का उत्तर देता है, तो हार्नेस उसे हाथ देता है: फ़ाइलों को पढ़ता है और संपादित करता है, कमांड चलाता है, सत्र आयोजित करता है, निष्पादन प्रक्षेपवक्र दिखाता है और खुद को प्लगइन्स के साथ विस्तारित करने की अनुमति देता है। परियोजना एमआईटी लाइसेंस के तहत वितरित की गई है और सार्वजनिक पूर्वावलोकन में है।

डीपसीक हार्नेस का मुख्य विचार “सब कुछ एक प्लगइन है” के रूप में तैयार किया गया है – शाब्दिक रूप से “सब कुछ एक प्लगइन है”। संपूर्ण उत्पाद इस पर बनाया गया है: मॉडल एडेप्टर, एक टूल रजिस्ट्री, एक सत्र लॉग, एक इंटरफ़ेस और यहां तक ​​कि एजेंट चक्र भी। यह कॉर्डिस फ्रेमवर्क पर आधारित है, इसलिए एक डेवलपर न केवल एक नया कमांड जोड़ सकता है, बल्कि कर्नेल को फोर्क किए बिना एजेंट के संपूर्ण व्यवहार को बदल सकता है।

आप डीएसएच के साथ कई तरीकों से काम कर सकते हैं: स्थानीय वेब इंटरफ़ेस के माध्यम से, डेस्कटॉप एप्लिकेशन के माध्यम से, हेडलेस मोड में कमांड लाइन से, या पायथन एसडीके से। नीचे इंस्टालेशन, पहला लॉन्च और क्षमताओं का अवलोकन दिया गया है।

आपको क्या चाहिए

वेब इंटरफ़ेस और सीएलआई के लिए Node.js की आवश्यकता है। परियोजना की सख्त आवश्यकताएं हैं:

• Node.js 22.19.0 या बाद का संस्करण 22.x लाइन में।
• Node.js 24.0.0 या बाद का संस्करण 24.x लाइन में।
• Node.js 23.x किसी भी पैच में समर्थित नहीं है: यह लाइन LTS नहीं है और पहले ही बंद कर दी गई है।

Node.js के अलावा, आपको DeepSeek API कुंजी की आवश्यकता होगी। यह आपके व्यक्तिगत खाते मेंplatform.depseek.com पर बनाया गया है। डेस्कटॉप एप्लिकेशन को Node.js की आवश्यकता नहीं है – पर्यावरण वहां पहले से ही पैक किया गया है।

आप कमांड से संस्करण की जांच कर सकते हैं:

node -v

एनपीएक्स के माध्यम से स्थापना

प्रोजेक्ट को जानने का सबसे तेज़ तरीका वैश्विक स्तर पर कुछ भी इंस्टॉल नहीं करना है। सिर्फ दौड़ें:

npx @deepseek-ai/dsh web

कमांड npm से @depseek-ai/dsh पैकेज डाउनलोड करेगा, एक स्थानीय वेब सर्वर सेट करेगा और ब्राउज़र में इंटरफ़ेस खोलेगा। डिफ़ॉल्ट रूप से यह पते को सुनता है:

https://127.0.0.1:3080

यदि आपको ब्राउज़र खोलने की आवश्यकता नहीं है, उदाहरण के लिए रिमोट मशीन पर, तो –no-open ध्वज जोड़ें:

npx @deepseek-ai/dsh web --no-open

एसएसएच के माध्यम से लॉन्च होने पर, डीएसएच पता प्रिंट करता है लेकिन ब्राउज़र खोलने का प्रयास नहीं करता है: स्थानीय पता एसएसएच क्लाइंट या संपादक के स्वामित्व में होता है।

वैश्विक स्थापना

यदि आपको लगातार किसी टूल की आवश्यकता होती है, तो इसे विश्व स्तर पर स्थापित करना अधिक सुविधाजनक है। पैकेज dsh बाइनरी प्रदान करता है:

npm install -g @deepseek-ai/dsh
dsh web

इसके बाद dsh कमांड किसी भी डायरेक्टरी से उपलब्ध होता है। अद्यतन सामान्य तरीके से किया जाता है:

npm install -g @deepseek-ai/dsh@latest

डेस्कटॉप एप्लिकेशन

उन लोगों के लिए जो टर्मिनल और Node.js को होल्ड नहीं करना चाहते, डीपसीक डेस्कटॉप बिल्ड जारी करता है। वे आधिकारिक डाउनलोड पृष्ठ पर उपलब्ध हैं:

• macOS – Apple सिलिकॉन, macOS 13 या बाद का संस्करण, DMG प्रारूप।
• विंडोज़ – 64-बिट असेंबली, EXE प्रारूप।

एप्लिकेशन उन्हीं स्थानीय फ़ाइलों के साथ काम करता है, पृष्ठभूमि में कार्य कर सकता है और वेब संस्करण की तरह ही सत्रों को संग्रहीत करता है। यह रोजमर्रा के काम के लिए एक सुविधाजनक विकल्प है, जब आप हर बार सर्वर को मैन्युअल रूप से बढ़ाना नहीं चाहते हैं।

स्रोतों से निर्माण

यदि आपको कोड, अपने स्वयं के पैच या प्लगइन विकास पर पूर्ण नियंत्रण की आवश्यकता है, तो प्रोजेक्ट रिपॉजिटरी से एकत्र किया जाता है। आपको पीएनपीएम की आवश्यकता होगी, और रिपॉजिटरी एक विशिष्ट संस्करण को ठीक करता है, इसलिए आपको पहले कोरपैक को सक्षम करना चाहिए:

corepack enable
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

pnpm run build कमांड पैकेज और फ्रंटएंड आर्टिफैक्ट तैयार करता है, और pnpm dsh वेब पुनर्निर्माण के बिना पहले से निर्मित संस्करण चलाता है। विकास के लिए, एक मोड pnpm run dev:web है: यह सर्वर बनाता है, शुरू करता है और स्रोत बदलने पर क्लाइंट बंडलों का पुनर्निर्माण करता है।

पहला लॉन्च

वेब इंटरफ़ेस प्रारंभ करने के बाद प्रक्रिया इस प्रकार है.

सबसे पहले, सेटिंग्स → मॉडल खोलें और डीपसीक एपीआई कुंजी दर्ज करें। कुंजी फ़ाइल $DSH_HOME/.credentials.yaml में सहेजी गई है, और इसका केवल एक लिंक सेटिंग्स में रहता है। सेटिंग्स पृष्ठ को रहस्य का पहले से ही छिपा हुआ विवरण प्राप्त होता है, इसलिए इंटरफ़ेस से कुंजी को वापस पढ़ना असंभव है। मॉडल परिवर्तन अगले अनुरोध से लागू होते हैं; सर्वर को पुनरारंभ करने की कोई आवश्यकता नहीं है.

फिर कार्यस्थान चुनें के माध्यम से अपना कार्य फ़ोल्डर चुनें। जबकि कार्यक्षेत्र चयनित नहीं है, कार्य इनपुट फ़ील्ड धूसर बनी रहती है। यह जानबूझकर किया जाता है: एजेंट को उन सीमाओं को समझना चाहिए जिनके भीतर उसे फ़ाइलों को पढ़ने और बदलने की अनुमति है।

इसके बाद आप पहला टास्क सबमिट कर सकते हैं. उदाहरण के लिए:

Summarize this repository and identify its main packages.

एजेंट परियोजना को पढ़ेगा, एक योजना तैयार करेगा, आवश्यक उपकरण बुलाएगा और परिणाम दिखाएगा। उन परिचालनों के लिए जिन्हें वर्तमान पहुंच नीति के आधार पर पुष्टि की आवश्यकता होती है, डीएसएच निष्पादित करने से पहले पूछेगा।

मॉडल और प्रदाता

डीपसीक एक चरण में कनेक्ट होता है: सेटिंग्स में प्रदाता कार्ड में एपीआई कुंजी के लिए केवल एक फ़ील्ड होता है। इसके अतिरिक्त, आप तृतीय-पक्ष सेवाएँ जोड़ सकते हैं। अंतर्निहित निर्देशिका किमी के लिए एंथ्रोपिक, openai, moonshotai और GLM के लिए zai जैसे पहचानकर्ताओं को जानती है।

आपके अपने गेटवे, कॉर्पोरेट प्रॉक्सी या स्थानीय सर्वर के लिए, एक कस्टम मॉडल एपीआई मोड है। यह पूछता है:

• स्थायी प्रदाता पहचानकर्ता;
• प्रदर्शन नाम;
• एपीआई आधार पता;
• प्रोटोकॉल: OpenAI चैट पूर्णताएं, OpenAI प्रतिक्रियाएं या मानवीय संदेश;
• कुंजी और मॉडलों की सूची।

प्रोटोकॉल महत्वपूर्ण है: एक प्रदाता एक प्रोटोकॉल बोलता है। यदि कोई गेटवे ओपनएआई और एंथ्रोपिक दोनों का समर्थन करता है, तो इसे दो प्रदाताओं द्वारा वर्णित करना होगा। मॉडलों के लिए, आप संदर्भ विंडो का आकार, आउटपुट टोकन की अधिकतम संख्या और छवियों सहित समर्थित इनपुट डेटा प्रकार निर्दिष्ट कर सकते हैं।

डीपसीक मॉडल में बंद, कम, उच्च और अधिकतम तर्क स्तर होते हैं। मॉडल के आगे प्रयास मेनू में स्तर का चयन किया गया है। रिपॉजिटरी में नियमित कार्यों के लिए, एक तेज़ मॉडल पर्याप्त है, लेकिन जटिल वास्तुशिल्प कार्यों के लिए प्रयास बढ़ाना या उच्च श्रेणी का मॉडल लेना समझ में आता है।

प्लगइन्स और क्रिएटर मोड

प्लगइन्स डीपसीक हार्नेस की मुख्य विशेषता हैं। इनके माध्यम से उपकरण, कौशल, इंटरफ़ेस तत्व और संपूर्ण एप्लिकेशन जोड़े जाते हैं। इंटरफ़ेस में आधिकारिक और प्रयोगात्मक सेट के साथ एक प्लगइन प्रबंधक है: एजेंट कमांड, ऑटो-पुष्टि, निर्धारित कार्य, वॉयस इनपुट, टर्मिनल, सबएजेंट।

क्रिएटर मोड अलग से दिखता है। इस मोड में, आप एजेंट से सीधे चैट में एक प्लगइन लिखने के लिए कह सकते हैं। यह कॉर्डिस प्लगइन विकास कौशल डाउनलोड करेगा, एक पैकेज संरचना बनाएगा, कोड लिखेगा, प्लगइन इंस्टॉल करेगा और उसकी स्थिति की जांच करेगा। आधिकारिक प्रोजेक्ट पेज पर एक उदाहरण है जहां एक फ्लोटिंग पोमोडोरो टाइमर को इस तरह से इकट्ठा किया जाता है।

प्लगइन्स को कमांड लाइन से भी इंस्टॉल किया जा सकता है। वेब प्रोफ़ाइल के लिए, कमांड इस तरह दिखता है:

dsh plugin --profile web add some-dsh-plugin

एनपीएम पैकेज, जीथब:ओनर/रेपो, स्थानीय निर्देशिकाएं और टीजीजेड अभिलेखागार जैसे लिंक समर्थित हैं। इंस्टॉलेशन के बाद, यह जांचना उपयोगी है कि प्लगइन परत वास्तव में कॉन्फ़िगरेशन में शामिल है:

dsh --profile web --dump-config

कमांड सर्वर शुरू किए बिना असेंबल किए गए प्लगइन ट्री को प्रिंट करता है। यदि कोई नई परत नहीं है, तो बंडल ने संभवतः dsh.bundle मेनिफ़ेस्ट घोषित नहीं किया और एक सम्मिलित प्लगइन के बजाय एक नियमित लाइब्रेरी के रूप में स्थापित किया।

प्रयोगात्मक सेटिंग्स में कस्टम प्लगइन बाज़ार शामिल हैं। यह एक इंडेक्स JSON फ़ाइल है जिसमें प्लगइन्स, उनके संस्करण, आइकन और स्रोतों की सूची है। सेट को सक्षम करने से, आपको प्लगइन्स पेज पर एक डिस्कवर टैब और तीसरे पक्ष के बाजारों को जोड़ने की क्षमता मिलती है। किसी भी तीसरे पक्ष के स्रोत की तरह, ऐसे बाज़ार को केवल तभी जोड़ा जाना चाहिए जब आपको इसके लेखकों पर भरोसा हो।

प्रक्षेपवक्र और लेखापरीक्षा

प्रत्येक सत्र के लिए, डीएसएच एक परिशिष्ट-केवल ईवेंट लॉग लिखता है – प्रक्षेपवक्र। यह सिस्टम प्रॉम्प्ट, तर्क, टूल कॉल और उनके परिणाम, सबएजेंट शेड्यूलिंग और संदर्भ सम्मिलन को संग्रहीत करता है। इस लॉग पर सत्र पुनः आरंभ, फ़ोर्क, खोज और रीप्ले बनाए जाते हैं।

व्यावहारिक लाभ यह है कि बातचीत ब्लैक बॉक्स बनकर रह जाती है। इंटरफ़ेस में, आप प्रक्षेप पथ खोल सकते हैं और देख सकते हैं कि कौन से टूल बुलाए गए थे, प्रत्येक चरण में कितना समय लगा, कौन सी फ़ाइलें बदली गईं, और अनुरोध पर कितने टोकन खर्च किए गए। यदि कोई एजेंट अजीब व्यवहार करता है, तो इसका कारण आमतौर पर यहां दिखाई देता है, न कि चैट में संक्षिप्त उत्तर में।

सत्र JSONL लॉग के रूप में ~/.dsh/sessions में स्थित हैं। आप उन्हें पढ़ सकते हैं, खोज सकते हैं और अपना स्वयं का विश्लेषण बना सकते हैं। इससे उन खर्चों और कैश हिट्स की सटीक गणना करना भी संभव हो जाता है जो नियमित एपीआई बिल में दिखाई नहीं देते हैं।

पृष्ठभूमि कार्य और शेड्यूल

डीपसीक हार्नेस न केवल “पूछें और उत्तर प्राप्त करें” मोड में काम कर सकता है। कार्यों को पृष्ठभूमि में लॉन्च और शेड्यूल किया जा सकता है। उदाहरण के लिए, एजेंट से प्रत्येक शुक्रवार को 17:00 बजे प्रोजेक्ट नोट्स से साप्ताहिक रिपोर्ट एकत्र करने के लिए कहें। इंटरफ़ेस में, ऐसे कार्य अलग से दिखाई देते हैं: आप स्थिति की जांच कर सकते हैं, इतिहास देख सकते हैं और निष्पादन विवरण खोल सकते हैं।

स्वचालन के लिए एक हेडलेस प्रोफ़ाइल है। यह एक सत्र शुरू करता है, अंतिम प्रतिक्रिया प्रिंट करता है, और बाहर निकलता है:

dsh --profile headless "run the tests"

यह मोड सीआई, क्रॉन और स्क्रिप्ट के लिए सुविधाजनक है जहां वेब इंटरफ़ेस की आवश्यकता नहीं है। हेडलेस के अलावा, sdk और acp प्रोफाइल उपलब्ध हैं: पहला JSON-RPC के माध्यम से SDK क्लाइंट को सेवा प्रदान करता है, दूसरा ACP stdio के माध्यम से ऑटोमेशन क्लाइंट को सेवा प्रदान करता है।

सबएजेंट, एमसीपी और कौशल

एक जटिल कार्य को उप-एजेंटों के बीच विघटित किया जा सकता है। मुख्य एजेंट कार्य की योजना बनाता है, और व्यक्तिगत उप-एजेंट अपने क्षेत्रों पर काम करते हैं। यह संदर्भ को संक्षिप्त रखने में मदद करता है और प्रत्येक अनुरोध में संपूर्ण इतिहास को नहीं खींचता है।

बाहरी उपकरण और डेटा स्रोत एमसीपी के माध्यम से जुड़े हुए हैं। दस्तावेज़ में मेमोरी एमसीपी के लिए एक अलग गाइड, साथ ही GitHub समीक्षा सत्र जैसे एकीकरण शामिल हैं। कौशल दोहराने योग्य प्रक्रियाओं का वर्णन करते हैं जिन्हें एजेंट सिस्टम प्रॉम्प्ट में सभी निर्देशों को हर समय रखने के बजाय आवश्यकतानुसार लोड करता है।

प्रोफ़ाइल, बंडल और पैच

Dsh कॉन्फ़िगरेशन को तीन परतों से इकट्ठा किया गया है। बंडल कॉन्फ़िगरेशन लाइनों और प्लगइन कोड का एक सेट है, यानी, कार्यक्षमता का एक तैयार टुकड़ा। प्रोफ़ाइल बंडलों की एक नामित संरचना है, जो $DSH_HOME/profiles/ में संग्रहीत है। पैच एक YAML फ़ाइल है जो पहचानकर्ता द्वारा पहले से लोड की गई लाइनों को बदलती है, उन्हें अक्षम करती है, या नई जोड़ती है।

आवेदन का क्रम इस प्रकार है: पहले प्रोफ़ाइल क्रम में बंडल, फिर प्रोफ़ाइल पैच, फिर सामान्य पैच $DSH_HOME/cordis.patch.yml और अंत में ओवरले –patch के माध्यम से प्रसारित होते हैं। इसका मतलब यह है कि बंडल स्रोतों को छुए बिना लगभग किसी भी सेटिंग को ओवरराइड किया जा सकता है। आप परिणामी पेड़ को कमांड से देख सकते हैं:

dsh --profile web --dump-config

एक मानक वेब प्रोफ़ाइल को वेब कहा जाता है, सर्वर रहित प्रोफ़ाइल को हेडलेस कहा जाता है। उनकी सेटिंग फ़ाइलें $DSH_HOME/profiles/web/cordis.patch.yml और $DSH_HOME/profiles/headless/cordis.patch.yml में रहती हैं। यह वह जगह है जहां डीएसएच सेटिंग्स इंटरफ़ेस के माध्यम से किए गए परिवर्तनों को लिखता है।

पायथन एसडीके

पायथन परियोजनाओं के लिए एक आधिकारिक एसडीके है। यह एक आभासी वातावरण में स्थापित है और अपने साथ एक मूल रनटाइम लाता है, इसलिए सामान्य कार्य के लिए सिस्टम Node.js की आवश्यकता नहीं है:

python -m venv .venv
.venv\Scripts\Activate.ps1
python -m pip install deepseek-harness-sdk

एक न्यूनतम स्टार्टअप उदाहरण इस तरह दिखता है:

from pathlib import Path

from deepseek_harness import DeepSeekHarness

workspace = Path("C:/work/disposable-workspace").resolve()
dsh_home = Path("C:/work/example-dsh-home").resolve()

with DeepSeekHarness(
    provider="deepseek-official",
    model="deepseek-v4-flash",
    max_tokens=49_152,
    cwd=str(workspace),
    dsh_home=str(dsh_home),
    profile="sdk-minimal",
) as harness:
    result = harness.run(
        "Inspect the repository and fix the failing tests.",
        session_id="example-001",
    )

print(result.final_response)

एसडीके एसडीके-न्यूनतम प्रोफ़ाइल के साथ बंडल डीएसएच प्रक्रिया शुरू करता है और संदर्भ प्रबंधक से बाहर निकलने से पहले इसका पुन: उपयोग करता है। न्यूनतम प्रोफ़ाइल जानबूझकर सीमित है: इसमें बैश या pwsh, इमेज रीडिंग और एक कार्यशील निर्देशिका है, लेकिन कोई वेब टूल, सबएजेंट या कुछ फ़ाइल टूल नहीं हैं। एक बार के कार्यों के लिए, यह एक प्लस है: नियंत्रण के लिए कम सतह होती है।

किस बात पर ध्यान दें

डीपसीक हार्नेस एक डेवलपर पूर्वावलोकन संस्करण 0.1.0-rc.x है। README स्पष्ट रूप से चेतावनी देता है कि अनुकूलता टूट जाएगी। प्रयोगों, व्यक्तिगत परियोजनाओं और स्वचालन के लिए, यह ठीक है, लेकिन ऐसी प्रक्रिया के लिए जो अभी पैसा कमाती है, जोखिम को तौलना और बैकअप योजना रखना उचित है।

दूसरा बिंदु Node.js है। यदि आपके पास 22.18 या 23.x है, तो इंस्टॉलेशन क्रैश हो जाएगा या अप्रत्याशित रूप से व्यवहार करेगा। संस्करण को पहले से जांचें: प्रोजेक्ट नोड: एसक्लाइट और टाइपस्क्रिप्ट के अंतर्निहित प्रकारों का उपयोग करता है जिन्हें एक नई शाखा की आवश्यकता होती है।

तीसरा बिंदु सैंडबॉक्स और अधिकार है। डिफ़ॉल्ट रूप से, एजेंट वर्कस्पेस-राइट के करीब एक नीति में काम करता है: यह चयनित फ़ोल्डर में फ़ाइलों को बदल सकता है, और संभावित खतरनाक संचालन के लिए पुष्टि की आवश्यकता होती है। ख़तरा-पूर्ण-पहुँच मोड अधिक स्वतंत्रता देता है, लेकिन जोखिम अधिक हो जाता है। वास्तविक भंडार के साथ प्रयोग करने से पहले, एक प्रतिबद्धता या बैकअप बनाना उपयोगी होता है।

चौथा बिंदु लागत है। डीएसएच स्वयं मुफ़्त है, लेकिन अनुमान के लिए आप प्रदाता को टोकन के रूप में भुगतान करते हैं। लंबे सत्रों के लिए, उपसर्ग कैशिंग महत्वपूर्ण है: डीएसएच अनुरोधों की रचना करता है ताकि इतिहास और टूल स्कीमा यथासंभव लंबे समय तक अपरिवर्तित रहें। यदि स्कोर अपेक्षा से अधिक हो जाता है, तो न केवल प्रति टोकन कीमत को देखें, बल्कि प्रक्षेपवक्र में नकद हिट की हिस्सेदारी को भी देखें।

क्या यह प्रयास करने लायक है

डीपसीक हार्नेस मुख्य रूप से उन लोगों के लिए रुचिकर है जो न केवल “एक मॉडल के साथ एक और चैट” चाहते हैं, बल्कि एजेंटों के लिए एक नियंत्रित वातावरण चाहते हैं। इसमें एक पारदर्शी प्रक्षेपवक्र, फ़ाइलों और कमांडों के साथ सामान्य कार्य, पृष्ठभूमि कार्य, उप-एजेंट और प्लगइन्स के माध्यम से वास्तव में गहरा विस्तार है। किसी एजेंट लूप को अपने स्वयं के लूप से बदलने की क्षमता दुर्लभ है और संभावित रूप से अनुसंधान और कस्टम ऑर्केस्ट्रेशन के लिए बहुत उपयोगी है।

यदि आपको दैनिक भुगतान वाले काम के लिए एक स्थिर उपकरण की आवश्यकता है, तो अब डीएसएच को मुख्य एजेंट के बाद दूसरे एजेंट के रूप में मानना ​​​​समझदारी है: इसे एक व्यक्तिगत प्रोजेक्ट पर आज़माएं, अपने कार्यों की लागत और गुणवत्ता की तुलना करें, और उसके बाद ही इसे वर्कफ़्लो में स्थानांतरित करें।

लिंक

https://www.deepseek.com/harness/
https://www.deepseek.com/download/
https://github.com/deepseek-ai/deepseek-harness
https://deepseek-harness.github.io/deepseek-harness/en/guide/quickstart
https://deepseek-harness.github.io/deepseek-harness/en/guide/providers
https://deepseek-harness.github.io/deepseek-harness/en/guide/python-sdk
https://platform.deepseek.com/

स्रोत

https://github.com/deepseek-ai/deepseek-harness/blob/master/README.md
https://github.com/deepseek-ai/deepseek-harness/blob/master/apps/cli/README.md
https://deepseek-harness.github.io/deepseek-harness/en/guide/quickstart
https://deepseek-harness.github.io/deepseek-harness/en/guide/providers
https://deepseek-harness.github.io/deepseek-harness/en/guide/python-sdk
https://deepseek-harness.github.io/deepseek-harness/en/guide/plugin-market
https://dshdocs.com/getting-started/installation/
https://dshdocs.com/concepts/profiles-bundles-patches/
https://dshdocs.com/guides/dsh-vs-claude-code/