dsh कॉन्फ़िगरेशन: API keys और Ollama endpoint सेटअप गाइड
Linux पर dsh कॉन्फ़िगरेशन फ़ाइल्स का स्थान और DeepSeek API key या local Ollama endpoint जोड़ने का सही तरीका जानें। समझें कि कौन सा डेटा आपके सिस्टम से बाहर जाता है।
dsh अपनी कॉन्फ़िगरेशन कहाँ रखता है
dsh (DeepSeek Harness) अपना हार्नेस डेटा $DSH_HOME के अंतर्गत रखता है, जो डिफ़ॉल्ट रूप से ~/.dsh होता है, और साझा एजेंट कॉन्फ़िगरेशन को एक अलग रूट, $DSH_AGENTS_HOME से पढ़ता है, जो डिफ़ॉल्ट रूप से ~/.agents होता है। Web UI में आप जो कुछ भी सेट करते हैं, वह वहाँ सादी फ़ाइलों के रूप में लिखा जाता है। अपनी कॉन्फ़िगरेशन को किसी दूसरे सर्वर पर ले जाते समय हार्नेस होम और साझा एजेंट रूट से सभी वैश्विक निर्देश (global instructions) और स्किल्स को कॉपी करें।
चार पाथ मुख्य हार्नेस सेटिंग्स, सीक्रेट्स और सेशन लॉग्स को संभालते हैं।
~/.dsh/profiles/<profile>/cordis.patch.ymlमें वे सेटिंग्स होती हैं जिन्हें Web UI उस प्रोफ़ाइल के लिए लिखता है, जिसमें आपके प्रोवाइडर और मॉडल रूट्स शामिल हैं।dsh web,webप्रोफ़ाइल को चलाता है, इसलिए फ़ाइल~/.dsh/profiles/web/cordis.patch.ymlहै।~/.dsh/.credentials.yamlमें सीक्रेट्स होते हैं। सेटिंग्स केवल क्रेडेंशियल का संदर्भ रखती हैं, इसलिए कुंजी का वास्तविक मान एक ही फ़ाइल में रहता है।~/.dsh/profiles/में नामित प्रोफ़ाइलें होती हैं, और~/.dsh/sessions/में सहेजे गए सेशन लॉग्स होते हैं।~/.dsh/cordis.patch.ymlआपकी अपनी पैच लेयर है। यह हर प्रोफ़ाइल के लिए इन-बिल्ट कॉन्फ़िगरेशन के ऊपर लागू होती है, और यह प्रोफ़ाइल फ़ाइल से अधिक प्राथमिकता रखती है। इसलिए, यदि Web UI में कोई ऐसा बदलाव किया जाता है जिसे यह लेयर ओवरराइड करेगी, तो उसे सेव करने के बजाय अस्वीकार कर दिया जाता है।
साझा एजेंट रूट $DSH_HOME के बाहर रहता है क्योंकि अन्य एजेंट टूल्स इसे साझा करते हैं। dsh उपयोगकर्ता-वैश्विक निर्देशों को ~/.agents/AGENTS.md से पढ़ता है और स्किल्स के लिए ~/.agents/skills/ को स्कैन करता है; उस रूट को बदलने के लिए DSH_AGENTS_HOME सेट करें।
पुराने बिल्ड्स इन सेटिंग्स को ~/.dsh/settings.yaml में रखते थे। वर्तमान बिल्ड्स उस फ़ाइल को एक बार सक्रिय प्रोफ़ाइल में आयात करते हैं और उसका नाम बदलकर settings.yaml.imported कर देते हैं। इसलिए, कोई पुरानी गाइड जो आपको settings.yaml को एडिट करने के लिए कहती है, वह अब ऐसी फ़ाइल की ओर इशारा करती है जिसे dsh अब नहीं पढ़ता है।
DeepSeek इस हार्नेस को MIT-लाइसेंस प्राप्त डेवलपर प्रीव्यू के रूप में प्रकाशित करता है, और README में उल्लेख है कि इसमें संगतता तोड़ने वाले (compatibility-breaking) बदलाव होंगे। इस गाइड में फ़ील्ड के नाम और पाथ वर्तमान रिपॉजिटरी दस्तावेज़ीकरण से मेल खाते हैं, जिसे 5 नवंबर 2026 को जाँचा गया था। किसी भी गाइड से कॉन्फ़िगरेशन कॉपी करने से पहले, अपने द्वारा इंस्टॉल किए गए वर्ज़न के दस्तावेज़ों से उनकी जाँच करें, क्योंकि एक प्रीव्यू वर्ज़न रिलीज़ के बीच में चीज़ों के नाम बदल सकता है।
शुरुआती आउटपुट के लिए न्यूनतम आवश्यकताएं
dsh को Node.js 24.9 या उससे नए वर्ज़न की आवश्यकता है। 5 November 2026 तक इसके package.json में >=24.9.0 घोषित है, इसलिए 22 लाइन समर्थित नहीं है। Node 24.0 से 24.8 भी पर्याप्त नहीं हैं। सबसे पहले वर्ज़न की जाँच करें, क्योंकि वर्ज़न मेल न खाने पर स्टार्टअप विफल हो जाता है और त्रुटि ऐसे दिखाई देती है जैसे पैकेज खराब हो।
node -v
npx @deepseek-ai/dsh webnpx npm registry से पैकेज डाउनलोड करता है और http://127.0.0.1:3080 पर Web UI शुरू करता है। यह loopback address पर bind होता है, जिसका अर्थ है कि यदि आपका firewall इसे अनुमति भी दे, तब भी यह पोर्ट किसी अन्य मशीन से एक्सेस नहीं किया जा सकता। VPS पर, 3080 को इंटरनेट के लिए खोलने के बजाय इसे SSH के माध्यम से forward करें। यदि वह प्रिंट किया गया URL भ्रमित करने वाला है, तो dsh उस पते पर क्यों शुरू होता है यह बताता है कि loopback bind क्या सुरक्षित करता है और क्या नहीं।
ssh -N -L 3080:127.0.0.1:3080 you@your-serverअपने लैपटॉप पर http://127.0.0.1:3080 खोलें, फिर Settings और Models पर जाएं। DeepSeek कार्ड में एक API key फ़ील्ड है। platform.deepseek.com से key पेस्ट करें और उसे save करें। मॉडल रूट तुरंत उपयोग योग्य हो जाता है, बिना किसी रीस्टार्ट के, क्योंकि चल रहा सर्वर क्रेडेंशियल को स्टोर करता है और रेफरेंस को लाइव रिज़ॉल्व करता है। रिमोट सर्वर पर dsh Web UI तक पहुँचना टनल और reverse proxy के मामले को कवर करता है, और VPS पर DeepSeek Harness इंस्टॉल करना उस सर्वर तैयारी को कवर करता है जिसे यह गाइड मानकर चलती है।
save करने के बाद, देखें कि ऐप ने क्या बनाया है।
ls -la ~/.dsh
stat -c '%a %n' ~/.dsh/.credentials.yamlआपको .credentials.yaml और profiles/ दिखाई देने चाहिए, जिसमें Web UI की सेटिंग्स profiles/web/cordis.patch.yml में होंगी। पुराने बिल्ड द्वारा बनाई गई होम डायरेक्टरी में settings.yaml.imported भी हो सकता है। यदि stat, 600 के अलावा कोई अन्य मोड प्रिंट करता है, तो chmod 600 ~/.dsh/.credentials.yaml चलाएं। group-readable क्रेडेंशियल फ़ाइल आपकी key को उस ग्रुप के अकाउंट्स के लिए उजागर करती है; world-readable फ़ाइल इसे बॉक्स पर मौजूद हर दूसरे अकाउंट के लिए उजागर करती है।
बिना ब्राउज़र के पहली बार चलाने के लिए, एक कमांड पर्याप्त है।
npx @deepseek-ai/dsh --profile headless "summarise the files in this directory"headless प्रोफ़ाइल एक सिंगल सेशन चलाती है और अंतिम उत्तर प्रिंट करती है।
Environment variables या config file
dsh saved credentials या environment fallbacks से एक key को resolve कर सकता है।
एक catalog provider (DeepSeek, Anthropic, OpenAI, और बाकी built-in list) Models page के माध्यम से key स्वीकार करता है, या जब कोई saved credential इसे प्रदान नहीं करता है, तो यह अपने समर्थित environment fallback का उपयोग करता है। मान (value) ~/.dsh/.credentials.yaml में जाता है, और आपकी settings केवल इसका एक reference रखती हैं। इसे save करने के बाद Web UI कभी भी key को दोबारा नहीं दिखाता है।
एक custom provider apiKeyEnv के साथ एक credential reference को नाम दे सकता है, जो environment fallbacks का भी समर्थन करता है। यह वह प्रारूप (shape) है जिसे documentation एक profile patch में entry के लिए प्रदान करती है, जैसे कि ~/.dsh/profiles/web/cordis.patch.yml।
- id: llm-pi-ai
config:
providers:
my-gateway:
apiKeyEnv: GATEWAY_API_KEY
api: openai-completions
baseURL: https://gateway.example/v1
models:
- id: legacy-chat
- id: vision-preview
input: [text, image]पहले Web UI के माध्यम से एक provider जोड़ें, फिर profile की cordis.patch.yml खोलें और उसके द्वारा लिखी गई structure को copy करें। Developer preview के दौरान nesting वह हिस्सा है जिसके बदलने की सबसे अधिक संभावना है, और app द्वारा अभी लिखी गई file हमेशा current होती है।
apiKeyEnv credential store के माध्यम से resolve होता है: saved file को प्राथमिकता मिलती है, उसके बाद launch environment, invoking directory की .env, और फिर $DSH_HOME/.env। केवल interactive session में export की गई key एक systemd unit के लिए अदृश्य होती है, इसलिए किसी अन्य credential source के बिना, वही config जो हाथ से dsh web टाइप करने पर काम करती है, service के अंतर्गत MISSING_CREDENTIAL return करती है। Unit को उसकी अपनी file दें।
[Service]
EnvironmentFile=/etc/dsh/dsh.envउस file को mode 600 पर रखें, जिसका owner वही user हो जिसके अंतर्गत service चलती है।
मॉडल का चयन, और वह ID जिसे आप रीनेम नहीं कर सकते
प्रत्येक कॉन्फ़िगर किया गया प्रदाता मॉडल पिकर में दिखाई देता है। किसी मॉडल का चयन करने से वह नए सत्रों (sessions) के लिए डिफ़ॉल्ट बन जाता है। जिन सत्रों में पहले ही अनुरोध भेजा जा चुका है, उनमें मॉडल रिकॉर्ड रहता है, इसलिए स्विच करने से पुरानी बातचीत फिर से नहीं लिखी जाती है।
Provider ID स्थायी होती है। अनुरोध, सहेजे गए सत्र, मॉडल डिफ़ॉल्ट और क्रेडेंशियल संदर्भ सभी इसी की ओर इशारा करते हैं, इसलिए इसमें रीनेम बटन नहीं होता है। इसे बदलने का अर्थ है एक नया प्रदाता बनाना और पुराने को हटाना। ऐसा नाम चुनें जिसके साथ आप काम कर सकें: local-ollama न कि test2।
इनहेरिटेड इमेज क्षमता के बिना कस्टम मॉडल केवल टेक्स्ट-ओनली होते हैं, जब तक कि आप अन्यथा घोषित न करें। इमेज सपोर्ट घोषित करने के लिए मॉडल प्रविष्टि में input: [text, image] जोड़ें, या उन मॉडलों के लिए फॉलबैक के रूप में रूट स्तर पर defaultInput सेट करें जिन्हें कैटलॉग वर्णित नहीं करता है। DeepSeek के अपने रूट पर, बिना घोषित मोडैलिटी वाला मॉडल टेक्स्ट-ओनली माना जाता है, इसलिए इमेज अटैच करने से पहले इमेज-सक्षम कैटलॉग प्रविष्टि (डिफ़ॉल्ट रूप से deepseek-flash) चुनें। किसी ऐसे मॉडल को भेजी गई इमेज जो इमेज सपोर्ट की घोषणा नहीं करता है, उसे कुछ भी भेजने से पहले ही अस्वीकार कर दिया जाता है।
dsh को लोकल एंडपॉइंट पर पॉइंट करें ताकि आपका कोड उसी मशीन पर रहे
Ollama, http://127.0.0.1:11434/v1 पर OpenAI-compatible API सर्व करता है। dsh एक कस्टम प्रोवाइडर के माध्यम से किसी भी OpenAI-compatible बेस URL से बात करता है, इसलिए ये दोनों बिना किसी मध्यस्थ के कनेक्ट हो जाते हैं। पहले मॉडल सर्वर सेटअप करें: Ollama के साथ VPS पर LLM को self-host करना में इंस्टॉलेशन और मॉडल पुल करने की प्रक्रिया दी गई है।
dsh को छूने से पहले सुनिश्चित करें कि एंडपॉइंट रिस्पॉन्स दे रहा है।
ollama list
curl -s http://127.0.0.1:11434/v1/modelsollama list आपके द्वारा पुल किए गए प्रत्येक मॉडल का सटीक टैग प्रिंट करता है। उस स्ट्रिंग को कॉपी करें। curl उन्हीं मॉडल्स को JSON के रूप में रिटर्न करता है। खाली लिस्ट का मतलब है कि Ollama चल रहा है लेकिन कोई मॉडल पुल नहीं किया गया है। Connection refused का मतलब है कि Ollama नहीं चल रहा है, या 11434 पोर्ट पर लिसन नहीं कर रहा है।
ऐसा मॉडल चुनें जो इस मशीन पर चलता हो। एक साइन-इन किया हुआ Ollama सर्वर उसी लोकल एड्रेस के माध्यम से क्लाउड मॉडल्स भी सर्व करता है, और gemma4:cloud जैसा क्लाउड टैग Ollama के सर्वर पर चलता है। इसलिए आपके प्रॉम्प्ट्स मशीन से बाहर चले जाते हैं, भले ही dsh केवल 127.0.0.1 से बात करता हो।
अब प्रोफाइल पैच में प्रोवाइडर जोड़ें। इस कॉन्फ़िगरेशन के लिए एक नॉन-एम्प्टी API की (key) वैल्यू दें; लोकल Ollama सर्वर इसे इग्नोर कर देता है।
- id: llm-pi-ai
config:
providers:
local-ollama:
apiKeyEnv: OLLAMA_API_KEY
api: openai-completions
baseURL: http://127.0.0.1:11434/v1
models:
- id: <the exact tag printed by ollama list>उस वेरिएबल को एक्सपोर्ट करें जहाँ dsh प्रोसेस इसे देख सके।
sudo install -d -m 700 /etc/dsh
printf 'OLLAMA_API_KEY=ollama\n' | sudo tee /etc/dsh/dsh.env
sudo chmod 600 /etc/dsh/dsh.envइस प्रक्रिया में होने वाली लगभग सभी गलतियाँ तीन तरह की होती हैं। MISSING_CREDENTIAL का मतलब है कि apiKeyEnv द्वारा संदर्भित नाम का कोई परिणाम नहीं मिला, इसलिए केवल अपने टर्मिनल को ही नहीं, बल्कि सेव किए गए क्रेडेंशियल्स और लॉन्च एनवायरनमेंट को भी चेक करें। UNKNOWN_MODEL का मतलब है कि id किसी कॉन्फ़िगर किए गए मॉडल से मेल नहीं खाता, इसलिए इसे ollama list के साथ अक्षर-दर-अक्षर मिलाएं, जिसमें कोलन के बाद का टैग भी शामिल है। उपलब्ध मॉडल्स को फेच करते समय 401 एरर मॉडल डिस्कवरी से आता है, जो आपके बेस URL पर GET /models को कॉल करता है; जो एंडपॉइंट्स उस पाथ को सर्व नहीं करते, उनके मॉडल्स को मैन्युअल रूप से टाइप करना पड़ता है।
एक और गलती बेस URL को लेकर होती है। /v1 को हटा देने पर रिक्वेस्ट उन पाथ्स पर चली जाती है जिन्हें Ollama सर्व नहीं करता, जिससे कॉल 404 के रूप में वापस आती है और मॉडल कभी रन नहीं होता। यह सफिक्स OpenAI-compatible इंटरफेस का हिस्सा है, न कि कोई सजावट।
यदि Ollama किसी दूसरी मशीन पर चल रहा है, तो उस मशीन का एड्रेस बेस URL बन जाता है, और आपके प्रॉम्प्ट्स प्लेन HTTP पर नेटवर्क के माध्यम से क्लियरटेक्स्ट में जाते हैं। इसे उसी होस्ट पर रखें, या इसे TLS (transport layer security) और ऑथेंटिकेशन के पीछे रखें: एक्सपोज़्ड Ollama एंडपॉइंट को सुरक्षित करना।
प्रत्येक मोड में मशीन से क्या बाहर जाता है
DeepSeek key और default endpoint के साथ, model requests DeepSeek के API पर जाती हैं। उस request में आपका prompt, उन फाइलों की सामग्री जिन्हें agent ने उत्तर देने के लिए पढ़ा है, उसके द्वारा चलाए गए commands का output, और कोई भी tool results जिन्हें उसने शामिल करने का निर्णय लिया है, शामिल होते हैं। जब भी agent ने कोई फाइल खोली है, आपका source code उस payload के अंदर होता है। एक hosted model इसी तरह काम करता है, और यही कारण है कि आपको यह सोचना चाहिए कि आप किस directory में agent को start करते हैं।
वर्तमान releases, native DeepSeek adapter के माध्यम से requests में session के event log का एक unaccepted suffix भी जोड़ते हैं, जिसमें configured gateways शामिल हैं, जो default रूप से एक अलग dsh_session_log field के रूप में होता है। Model इसे कभी नहीं देखता, लेकिन request destination इसे प्राप्त कर लेता है। इसे Settings, General ("Upload Session Log when using the official model API") में बंद करें, या session-log-deepseek plugin पर enabled: false set करें। नीचे दिए गए telemetry switches इस upload को नियंत्रित नहीं करते हैं।
Shipped profiles, native DeepSeek adapter के माध्यम से active plugin package के नाम और versions भी एक अलग dsh_plugin_packages field में भेजते हैं। उस योगदान को रोकने के लिए plugin-package-inventory-deepseek पर enabled: false set करें।
किसी अन्य catalog provider या company gateway के साथ, वही payload उस vendor के पास जाता है। Base URL आपको ठीक-ठीक बताता है कि कहाँ।
Local endpoint के साथ, model request 127.0.0.1:11434 पर जाती है, लेकिन केवल loopback address इसे मशीन पर ही नहीं रखता। Ollama का documentation कहता है, "इस server के माध्यम से cloud models का उपयोग करने के लिए, Ollama में sign in करें," इसलिए उसी local server के माध्यम से चुना गया cloud model आपके prompts और code को Ollama के cloud पर भेजता है। केवल जब model स्वयं local रूप से चलता है, तभी model request मशीन पर रहती है। तब भी तीन चीजें network से होकर गुजरती हैं। npx npm registry से package download करता है। Agent द्वारा चलाया गया कोई भी tool अपने आप internet तक पहुँच सकता है, जिसमें आपके द्वारा connect किए गए MCP (model context protocol) servers भी शामिल हैं, जिसे running MCP servers on a VPS विस्तार से कवर करता है। एक plugin उसी श्रेणी में आता है, क्योंकि एक को install करने से आपके agent की permissions के साथ किसी अन्य लेखक का code चलता है, इसलिए checking what a plugin can reach before you install it करना उचित है। और telemetry, जिसे वर्तमान releases तब DeepSeek को export करने के लिए authorize करते हैं जब आप feedback submit करते हैं, local model के साथ भी बिल्कुल वैसे ही जैसे hosted model के साथ।
Telemetry default रूप से feedback तक सीमित है। DSH_TELEMETRY_MODE मोड का चयन करता है, और वर्तमान shipped base configuration में एक unset या empty value का परिणाम FEEDBACK_ONLY होता है। उस मोड में, सामान्य गतिविधि किसी telemetry capture को authorize नहीं करती है। जब आप लिखित feedback submit करते हैं, rating बनाते या edit करते हैं, note edit करते हैं, या feedback वापस लेते हैं, तो dsh उस session-log prefix के export को authorize करता है जो अभी तक exporter को नहीं दिया गया है, उस feedback event के माध्यम से और विरासत में मिले context को शामिल करते हुए, https://dsh-otel-collector.deepseeksvc.com/v1/logs पर। पूर्ण delivery की गारंटी नहीं है: एक बहुत बड़ा event बिना truncation के reject कर दिया जाता है, और CLI exit पर बड़े prefixes आंशिक रूप से unsent रह सकते हैं। Authorized batches बिना किसी अन्य interaction या model call के भेजना जारी रख सकते हैं। Telemetry README कहता है कि यह "सभी users और providers के लिए" लागू होता है, इसलिए local रूप से model चलाने से यह बंद नहीं होता है। DISABLED कोई OpenTelemetry (OTel) transport नहीं बनाता है। FULL अब स्वीकार्य नहीं है: उन दो के अलावा कोई भी value unsupported mode के साथ reject कर दी जाती है। एक feedback export में message text, tool arguments और results, तथा workspace paths हो सकते हैं, इसलिए feedback को DeepSeek को भेजे जाने वाले उस session prefix को authorize करने के रूप में मानें।
एक hard stop के लिए जो मोड string को सही करने पर निर्भर नहीं है, DSH_TELEMETRY_DISABLED=1 set करें। कोई भी non-empty value एक आधिकारिक opt-out है, जिसमें 0 और false शामिल हैं, और इसे run शुरू होने से पहले पढ़ा जाता है, इसलिए project code इसे mid-session में वापस चालू नहीं कर सकता है। Default collector address dsh-otel-collector.deepseeksvc.com है; DSH_TELEMETRY_OTLP_URL इसे override करता है।
सेटिंग पर भरोसा करने के बजाय verify करें। Task चलते समय, उन outbound connections की सूची देखें जो process के पास हैं।
sudo ss -tnp | grep -i nodeLocal रूप से चलाए गए model के साथ, model traffic loopback port 11434 का उपयोग करता है, लेकिन public connections अभी भी बिना किसी feedback submission के tools से आ सकते हैं। Shipped profiles में web search और fetch शामिल हैं, और default permission preset network access को सीमित नहीं करता है। इसे telemetry मानने से पहले प्रत्येक public destination की पहचान करें; केवल timing यह स्थापित नहीं करती है कि connection feedback export है। यह snapshot अल्पकालिक connections को भी छोड़ सकता है। यह जाँच केवल dsh process को कवर करती है: cloud model का traffic Ollama server से निकलता है, इसलिए पुष्टि करें कि model id भी cloud tag नहीं है। जारी रखने से पहले किसी भी अन्य चीज़ की पहचान करना उचित है। What a coding agent sends home अन्य harnesses के खिलाफ वही जाँच चलाता है और परिणाम को पढ़ने का तरीका बताता है।
जहाँ secrets नहीं होने चाहिए
- Shell history.
export DEEPSEEK_API_KEY=sk-...को~/.bash_historyमें cleartext के रूप में लिखा जाता है, और key rotate करने के काफी समय बाद भी यह वहीं रहता है। जबHISTCONTROL=ignorespaceसेट हो, तो command के आगे एक space लगाएँ, या shell को छोड़कर सीधे mode 600 वाली file में value लिखें। - Committed dotfiles. यदि आप dotfiles को git में रखते हैं, तो
~/.bashrcया~/.zshrcमें मौजूद key एकgit addकी दूरी पर public repository में जा सकती है। push करने से पहले उस repository मेंgit grep -I -n 'sk-'चलाएँ। - Profile patch files. custom providers के लिए
apiKeyEnvका उपयोग करें ताकिcordis.patch.ymlमें secret के बजाय variable का नाम रहे। Config files को issue reports और support chats में paste किया जाता है। Credentials files को नहीं। envका output और terminal screenshots. जो कुछ भी पूरे environment को print करता है, वह key को भी साथ में print कर देता है।- Backups.
~/.dshका backup लेना जरूरी है, और इसके अंदर मौजूद.credentials.yamlएक live secret है। उस file को exclude करें, या archive को encrypt करें।
ये नियम केवल dsh तक सीमित नहीं हैं, और Compose env files से secrets को बाहर रखना उसी सर्वर के container पक्ष पर भी यही समस्या हल करता है।
Developer preview के साथ काम करना
जिस version का आपने परीक्षण किया है, उसे pin करें। एक preview में patch release के दौरान config key बदल सकती है, जिससे आपका provider load होने में विफल हो सकता है। यदि pinned install start होने से मना कर दे, या npx आपको वह build देता रहे जिसे आपने नहीं मांगा था, तो preview से उत्पन्न होने वाली install और version त्रुटियां npx cache और आपके Node के साथ आने वाले npm को कवर करता है। home cordis.patch.yml और profiles/ के अंतर्गत मौजूद patch files को version control में रखें, और credentials file को बाहर रखें, ताकि आप देख सकें कि upgrade के बाद क्या बदला है।
जब कोई profile ठीक से काम न करे, तो दो flags मदद करते हैं। --dump-default-config बिना boot किए composed default configuration को print करता है, और --dump-config उसी तरह आपकी profile के लिए composed configuration को print करता है। दोनों की तुलना करने से पता चलता है कि आपकी patch layer ने वास्तव में क्या बदला है, जो layers को मैन्युअल रूप से पढ़ने की तुलना में तेज है।
dsh --profile web --dump-configजब upgrade के बाद कुछ खराब हो जाए, तो सबसे पहले इसे चलाएं। releases के बीच बदली गई कोई key dump में missing branch के रूप में दिखाई देती है, और इसका समाधान reinstall करने के बजाय एक लाइन का edit करना है।
FAQ
dsh मेरी DeepSeek API key कहाँ स्टोर करता है?
यह $DSH_HOME/.credentials.yaml में स्टोर होती है, जो कि ~/.dsh/.credentials.yaml होता है, जब तक कि आप स्वयं DSH_HOME सेट न करें। Models पेज key को वहाँ लिखता है, और आपकी सेटिंग्स में केवल उसका एक reference होता है, इसलिए secret एक ही फाइल में रहता है। stat -c '%a %n' ~/.dsh/.credentials.yaml के साथ mode की जाँच करें और यदि यह 600 से अधिक ढीला है, तो इसे 600 पर सेट करें। एक custom provider apiKeyEnv के साथ environment variable का नाम देकर फाइल के उपयोग से पूरी तरह बच सकता है।
मैं dsh को DeepSeek API के बजाय local model का उपयोग करने के लिए कैसे कहूँ?
एक custom provider जोड़ें जिसका base URL आपका local OpenAI-compatible endpoint हो। Ollama के लिए यह http://127.0.0.1:11434/v1 है, जिसमें api: openai-completions और model id का उपयोग करें, जिसे बिल्कुल ollama list से कॉपी किया गया हो। इस configuration के लिए एक non-empty API key मान प्रदान करें; local Ollama server इसे ignore कर देता है। dsh config को edit करने से पहले curl -s http://127.0.0.1:11434/v1/models के साथ पुष्टि करें कि endpoint जवाब दे रहा है, क्योंकि एक dead endpoint और गलत config समान error उत्पन्न करते हैं।
क्या dsh डिफ़ॉल्ट रूप से मेरा कोड कहीं भेजता है?
hosted model के साथ, हाँ। आपका prompt और उन फाइलों की सामग्री जिन्हें agent ने पढ़ा है, उस vendor को भेजे जाने वाले API request के अंदर होते हैं। native DeepSeek adapter के माध्यम से किए गए requests, जिनमें configured gateways भी शामिल हैं, डिफ़ॉल्ट रूप से एक session-log suffix ले जाते हैं, जब तक कि आप Settings, General में उस upload को बंद न कर दें। Ollama द्वारा local स्तर पर चलाए जाने वाले model के साथ, वह request loopback पर जाता है और मशीन पर ही रहता है, लेकिन gemma4:cloud जैसा cloud model इसे उसी loopback address के माध्यम से Ollama के cloud पर भेज देता है। इन-बिल्ट web search और fetch, अन्य tools, और plugins feedback से स्वतंत्र रूप से public services से संपर्क कर सकते हैं। Telemetry एक अलग feed है: वर्तमान releases में DSH_TELEMETRY_MODE, unset होने पर FEEDBACK_ONLY पर resolve होता है, इसलिए feedback उस event के माध्यम से session-log prefix के export को अधिकृत करता है, जिसमें local models सहित प्रत्येक provider के लिए inherited context शामिल है। Delivery की गारंटी नहीं है, और feedback interaction के बाद भी अधिकृत uploads जारी रह सकते हैं। कोई exporter न रखने के लिए इसे DISABLED पर सेट करें, या opt-out के लिए DSH_TELEMETRY_DISABLED=1 सेट करें जिसे run शुरू होने से पहले पढ़ा जाता है।
जब मेरा variable सेट होता है, तो dsh MISSING_CREDENTIAL क्यों रिपोर्ट करता है?
क्योंकि apiKeyEnv द्वारा नामित reference को dsh के credential sources में resolve होना चाहिए। Saved credentials को launch environment पर प्राथमिकता दी जाती है, उसके बाद invoking directory की .env और $DSH_HOME/.env का स्थान आता है। आपके shell में export किया गया variable किसी systemd service, किसी अन्य user के session, या आपके द्वारा export करने से पहले शुरू की गई प्रक्रिया तक नहीं पहुँचता है। मान को unit के लिए 600 mode वाली EnvironmentFile में रखें, या उसी shell में export करें जो dsh को शुरू करता है। sudo tr '\0' '\n' < /proc/$(pgrep -f dsh | head -1)/environ के साथ पुष्टि करें कि चल रही प्रक्रिया में वास्तव में क्या मान है।
dsh को Node.js के किस version की आवश्यकता है?
5 November 2026 तक repository की package.json के अनुसार, Node.js 24.9 या उससे नया version चाहिए। 22 line अब समर्थित नहीं है, और Node 24.0 से 24.8 भी पर्याप्त नहीं हैं। किसी भी अन्य कार्य से पहले node -v चलाएँ, क्योंकि unsupported runtime से startup failure होने पर ऐसा लगता है जैसे install broken है और लोग runtime के बजाय package को reinstall करने लगते हैं।