SSD Nodes Learn Hosting plans →
নির্দেশিকা Matt Connorদ্বারা Matt Connor · আপডেট করা হয়েছে 2026-11-06

dsh-এর API key, model ও endpoint কীভাবে সেট করবেন

Linux-এ dsh configuration কোথায় থাকে, DeepSeek API key বা local Ollama endpoint কীভাবে যুক্ত করবেন, এবং প্রতিটি mode-এ ঠিক কোন data আপনার কম্পিউটার ছাড়ে তা জানুন।

dsh তার কনফিগারেশন যেখানে রাখে

dsh (DeepSeek Harness) তার হারনেস ডেটা $DSH_HOME-এর অধীনে রাখে, যার ডিফল্ট অবস্থান হলো ~/.dsh। এটি একটি আলাদা রুট, $DSH_AGENTS_HOME থেকে শেয়ার্ড এজেন্ট কনফিগারেশন পড়ে, যার ডিফল্ট অবস্থান হলো ~/.agents। আপনি Web UI-তে যা কিছু সেট করেন, তা সেখানে প্লেইন ফাইল হিসেবে লেখা হয়। আপনার কনফিগারেশন অন্য সার্ভারে স্থানান্তর করার সময় হারনেস হোম এবং শেয়ার্ড এজেন্ট রুট থেকে সমস্ত গ্লোবাল ইন্সট্রাকশন ও স্কিল কপি করে নিন।

চারটি পাথ প্রধান হারনেস সেটিংস, সিক্রেট এবং সেশন লগ বহন করে।

  • ~/.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-তে উল্লেখ আছে যে এতে সামঞ্জস্যতা নষ্টকারী পরিবর্তন আসতে পারে। এই গাইডের ফিল্ডের নাম এবং পাথগুলো বর্তমান রিপোজিটরি ডকুমেন্টেশনের সাথে মিলে যায়, যা 5 নভেম্বর 2026 তারিখে যাচাই করা হয়েছে। যেকোনো গাইড (এই গাইডসহ) থেকে কনফিগারেশন কপি করার আগে আপনার ইনস্টল করা ভার্সনের ডকুমেন্টেশনের সাথে সেগুলো মিলিয়ে নিন, কারণ প্রিভিউ ভার্সনে রিলিজের মাঝে নাম পরিবর্তন হতে পারে।

প্রথম আউটপুটের জন্য ন্যূনতম প্রয়োজনীয় বিষয়

dsh চালানোর জন্য Node.js 24.9 বা তার পরবর্তী সংস্করণ প্রয়োজন। 5 নভেম্বর 2026 অনুযায়ী এর package.json-এ >=24.9.0 ঘোষণা করা হয়েছে, তাই 22 সংস্করণটি সমর্থিত নয়। Node 24.0 থেকে 24.8 সংস্করণও যথেষ্ট নয়। প্রথমে সংস্করণটি যাচাই করুন, কারণ সংস্করণের অমিল থাকলে স্টার্টআপের সময় এটি ব্যর্থ হয় এবং ত্রুটিটি এমনভাবে দেখায় যেন প্যাকেজটি নষ্ট হয়ে গেছে।

node -v
npx @deepseek-ai/dsh web

npx কমান্ডটি npm registry থেকে প্যাকেজটি ডাউনলোড করে এবং http://127.0.0.1:3080-এ Web UI চালু করে। এটি loopback ঠিকানায় বাইন্ড হয়, যার অর্থ হলো আপনার ফায়ারওয়াল অনুমতি দিলেও অন্য কোনো মেশিন থেকে এই পোর্টটি অ্যাক্সেস করা যাবে না। VPS-এর ক্ষেত্রে, 3080 পোর্টটি ইন্টারনেটের জন্য উন্মুক্ত না করে SSH-এর মাধ্যমে তা ফরওয়ার্ড করুন। যদি প্রদর্শিত URL-টি বিভ্রান্তিকর মনে হয়, তবে কেন dsh এই ঠিকানায় চালু হয় নিবন্ধটি পড়ুন; সেখানে loopback বাইন্ড কী সুরক্ষা দেয় এবং কী দেয় না তা ব্যাখ্যা করা হয়েছে।

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) টি কপি করে এখানে পেস্ট করুন এবং সেভ করুন। মডেল রুটটি তাৎক্ষণিকভাবে ব্যবহারের উপযোগী হয়ে যায়, কোনো রিস্টার্টের প্রয়োজন হয় না, কারণ চলমান সার্ভারটি ক্রেডেনশিয়াল সংরক্ষণ করে এবং লাইভ রেফারেন্স সমাধান করে। রিমোট সার্ভারে dsh Web UI অ্যাক্সেস করা নিবন্ধে টানেল এবং রিভার্স প্রক্সি ব্যবহারের নিয়ম রয়েছে, এবং VPS-এ DeepSeek Harness ইনস্টল করা নিবন্ধে এই গাইডের জন্য প্রয়োজনীয় সার্ভার প্রস্তুতির বিষয়গুলো আলোচনা করা হয়েছে।

সেভ করার পর, অ্যাপটি কী তৈরি করেছে তা দেখুন।

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 চালান। গ্রুপ-রিডেবল ক্রেডেনশিয়াল ফাইল আপনার কি (key) ওই গ্রুপের অন্যান্য অ্যাকাউন্টের কাছে উন্মুক্ত করে দেয়; আর ওয়ার্ল্ড-রিডেবল ফাইল তা বক্সের প্রতিটি অ্যাকাউন্টের কাছে উন্মুক্ত করে দেয়।

ব্রাউজার ছাড়া প্রথমবার চালানোর জন্য একটি কমান্ডই যথেষ্ট।

npx @deepseek-ai/dsh --profile headless "summarise the files in this directory"

হেডলেস প্রোফাইলটি একটি একক সেশন চালায় এবং চূড়ান্ত উত্তরটি প্রিন্ট করে।

এনভায়রনমেন্ট ভেরিয়েবল বা কনফিগ ফাইল

dsh সংরক্ষিত ক্রেডেনশিয়াল বা এনভায়রনমেন্ট ফলব্যাক থেকে একটি কি (key) খুঁজে নিতে পারে।

একটি ক্যাটালগ প্রোভাইডার (DeepSeek, Anthropic, OpenAI এবং বিল্ট-ইন তালিকার বাকিগুলো) Models পেজের মাধ্যমে একটি কি গ্রহণ করে, অথবা কোনো সংরক্ষিত ক্রেডেনশিয়াল না থাকলে এটি তার সমর্থিত এনভায়রনমেন্ট ফলব্যাক ব্যবহার করে। মানটি ~/.dsh/.credentials.yaml-এ জমা হয় এবং আপনার সেটিংসে শুধুমাত্র এর একটি রেফারেন্স থাকে। একবার সেভ করার পর Web UI আর কখনোই কি-টি প্রদর্শন করে না।

একটি কাস্টম প্রোভাইডার apiKeyEnv ব্যবহার করে একটি ক্রেডেনশিয়াল রেফারেন্সের নাম দিতে পারে, যা এনভায়রনমেন্ট ফলব্যাকও সমর্থন করে। ডকুমেন্টেশনে প্রোফাইল প্যাচের একটি এন্ট্রির জন্য যে কাঠামো দেওয়া হয়েছে তা হলো ~/.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-এর মাধ্যমে একটি প্রোভাইডার যোগ করুন, তারপর প্রোফাইলের cordis.patch.yml খুলুন এবং এটি যে কাঠামো তৈরি করেছে তা কপি করুন। ডেভেলপার প্রিভিউ চলাকালীন নেস্টিং বা বিন্যাস পরিবর্তনের সম্ভাবনা সবচেয়ে বেশি থাকে, এবং অ্যাপটি যে ফাইলটি তৈরি করেছে তা সর্বদা বর্তমান থাকে।

apiKeyEnv ক্রেডেনশিয়াল স্টোরের মাধ্যমে সমাধান করা হয়: সংরক্ষিত ফাইলটি অগ্রাধিকার পায়, এরপর লঞ্চ এনভায়রনমেন্ট, তারপর ইনভোকিং ডিরেক্টরির .env এবং সবশেষে $DSH_HOME/.env। একটি ইন্টারঅ্যাক্টিভ সেশনে এক্সপোর্ট করা কি (key) একটি systemd ইউনিটের কাছে অদৃশ্য থাকে, তাই অন্য কোনো ক্রেডেনশিয়াল সোর্স না থাকলে যে কনফিগ হাতে dsh web টাইপ করলে কাজ করে, তা সার্ভিসের অধীনে MISSING_CREDENTIAL ত্রুটি দেখাবে। ইউনিটটিকে তার নিজস্ব ফাইল দিন।

[Service]
EnvironmentFile=/etc/dsh/dsh.env

ফাইলটির মোড 600 রাখুন এবং যে ব্যবহারকারীর অধীনে সার্ভিসটি চলে, তাকেই এর মালিক করুন।

মডেল নির্বাচন এবং এমন আইডি যা আপনি রিনেম করতে পারবেন না

প্রতিটি কনফিগার করা প্রোভাইডার মডেল পিকার-এ প্রদর্শিত হয়। একটি মডেল নির্বাচন করলে সেটি নতুন সেশনের জন্য ডিফল্ট হিসেবে সেট হয়ে যায়। যেসব সেশনে ইতিমধ্যে রিকোয়েস্ট পাঠানো হয়েছে, সেগুলোতে মডেলটি সংরক্ষিত থাকে, তাই মডেল পরিবর্তন করলে পুরনো কথোপকথন নতুন করে লেখা হয় না।

প্রোভাইডার আইডি স্থায়ী। রিকোয়েস্ট, সংরক্ষিত সেশন, মডেল ডিফল্ট এবং ক্রেডেনশিয়াল রেফারেন্স—সবই এই আইডির দিকে নির্দেশ করে, তাই এখানে রিনেম করার কোনো বাটন নেই। এটি পরিবর্তন করার অর্থ হলো একটি নতুন প্রোভাইডার তৈরি করা এবং পুরনোটি মুছে ফেলা। এমন একটি নাম বেছে নিন যা আপনি দীর্ঘমেয়াদে ব্যবহার করতে পারবেন: test2 এর পরিবর্তে local-ollama ব্যবহার করুন।

কাস্টম মডেলগুলোতে যদি ইমেজ ক্যাপাবিলিটি ইনহেরিট করা না থাকে, তবে সেগুলো শুধুমাত্র টেক্সট-ভিত্তিক হিসেবে কাজ করে, যদি না আপনি অন্য কিছু ঘোষণা করেন। ইমেজ সাপোর্ট ঘোষণা করতে একটি মডেল এন্ট্রিতে input: [text, image] যোগ করুন, অথবা ক্যাটালগে বর্ণনা করা নেই এমন মডেলের জন্য ফলব্যাক হিসেবে রুট লেভেলে defaultInput সেট করুন। DeepSeek-এর নিজস্ব রুটে, কোনো ঘোষিত মডালিটি নেই এমন মডেলকে শুধুমাত্র টেক্সট-ভিত্তিক হিসেবে গণ্য করা হয়, তাই ইমেজ সংযুক্ত করার আগে ইমেজ-সক্ষম ক্যাটালগ এন্ট্রি (ডিফল্টভাবে deepseek-flash) বেছে নিন। কোনো মডেল যদি ইমেজ সাপোর্ট ঘোষণা না করে, তবে সেখানে ইমেজ পাঠানো হলে তা পাঠানোর আগেই প্রত্যাখ্যান করা হবে।

dsh-কে একটি লোকাল এন্ডপয়েন্টের দিকে নির্দেশ করুন যাতে আপনার কোড সার্ভারেই থাকে

Ollama একটি OpenAI-সামঞ্জস্যপূর্ণ API http://127.0.0.1:11434/v1-এ পরিবেশন করে। dsh একটি কাস্টম প্রোভাইডারের মাধ্যমে যেকোনো OpenAI-সামঞ্জস্যপূর্ণ base URL-এর সাথে যোগাযোগ করতে পারে, তাই এদের মাঝে অন্য কিছুর প্রয়োজন হয় না। প্রথমে মডেল সার্ভার সেট আপ করুন: Ollama ব্যবহার করে VPS-এ LLM self-hosting নির্দেশিকায় ইনস্টলেশন এবং মডেল পুল করার প্রক্রিয়াটি দেখুন।

dsh-এর সাথে কাজ শুরু করার আগে নিশ্চিত করুন যে এন্ডপয়েন্টটি সাড়া দিচ্ছে।

ollama list
curl -s http://127.0.0.1:11434/v1/models

ollama 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 এরর আসার কারণ হলো মডেল ডিসকভারি, যা আপনার base URL-এ GET /models কল করে; যে এন্ডপয়েন্টগুলো এই পাথটি পরিবেশন করে না, সেগুলোর মডেল হাতে টাইপ করে দিতে হয়।

আরেকটি সাধারণ ভুল হলো base URL। এর শেষে /v1 না দিলে রিকোয়েস্টগুলো এমন পাথে চলে যায় যা Ollama পরিবেশন করে না, ফলে 404 এরর আসে এবং মডেলটি কখনোই রান করে না। এই সাফিক্সটি OpenAI-সামঞ্জস্যপূর্ণ ইন্টারফেসের অংশ, কোনো বাড়তি অংশ নয়।

যদি Ollama অন্য কোনো মেশিনে চলে, তবে সেই মেশিনের ঠিকানাই হবে base URL, এবং সেক্ষেত্রে আপনার প্রম্পটগুলো plain HTTP-এর মাধ্যমে নেটওয়ার্ক দিয়ে যাবে। এটিকে একই হোস্টে রাখুন, অথবা TLS (transport layer security) এবং অথেন্টিকেশনের পেছনে রাখুন: একটি exposed Ollama এন্ডপয়েন্ট সুরক্ষিত করা।

প্রতিটি মোডে যা মেশিন থেকে বাইরে যায়

একটি DeepSeek key এবং ডিফল্ট endpoint ব্যবহার করলে, মডেলের অনুরোধগুলো DeepSeek-এর API-তে যায়। এই অনুরোধের সাথে আপনার প্রম্পট, এজেন্ট যে ফাইলগুলো পড়েছে তার বিষয়বস্তু, এজেন্টের চালানো কমান্ডের আউটপুট এবং এজেন্টের বেছে নেওয়া যেকোনো টুলের ফলাফল যুক্ত থাকে। এজেন্ট যখনই কোনো ফাইল খোলে, আপনার সোর্স কোড সেই পেলোডের অংশ হয়ে যায়। একটি hosted মডেল এভাবেই কাজ করে, এবং এই কারণেই এজেন্ট কোন ডিরেক্টরি থেকে শুরু করছেন তা ভেবে দেখা জরুরি।

বর্তমান রিলিজগুলোতে ডিফল্টভাবে native DeepSeek adapter-এর মাধ্যমে (কনফিগার করা gateway-সহ) অনুরোধের সাথে সেশন ইভেন্ট লগের একটি unaccepted সাফিক্স আলাদা একটি dsh_session_log ফিল্ড হিসেবে পাঠানো হয়। মডেল এটি দেখতে পায় না, তবে অনুরোধের গন্তব্য এটি গ্রহণ করে। Settings-এর General সেকশনে ("Upload Session Log when using the official model API") এটি বন্ধ করুন, অথবা session-log-deepseek প্লাগিনে enabled: false সেট করুন। নিচের টেলিমেট্রি সুইচগুলো এই আপলোড নিয়ন্ত্রণ করে না।

Shipped প্রোফাইলগুলো native DeepSeek adapter-এর মাধ্যমে আলাদা একটি dsh_plugin_packages ফিল্ডে সক্রিয় প্লাগিনের নাম ও ভার্সন পাঠিয়ে থাকে। এই অবদান বন্ধ করতে plugin-package-inventory-deepseek-এ enabled: false সেট করুন।

অন্য কোনো ক্যাটালগ প্রোভাইডার বা কোম্পানির gateway ব্যবহার করলে, একই পেলোড সেই ভেন্ডরের কাছে যায়। base URL দেখে আপনি নিশ্চিত হতে পারবেন সেটি কোথায় যাচ্ছে।

একটি লোকাল endpoint ব্যবহার করলে, মডেলের অনুরোধ 127.0.0.1:11434-এ যায়, কিন্তু শুধুমাত্র loopback address ব্যবহার করলেই তা মেশিনের ভেতরে সীমাবদ্ধ থাকে না। Ollama-এর ডকুমেন্টেশনে বলা হয়েছে, "To use cloud models through this server, sign in to Ollama," তাই সেই একই লোকাল সার্ভারের মাধ্যমে কোনো ক্লাউড মডেল নির্বাচন করলে তা আপনার প্রম্পট এবং কোড Ollama-এর ক্লাউডে পাঠিয়ে দেয়। শুধুমাত্র যখন মডেলটি নিজে লোকালি চলে, তখনই মডেলের অনুরোধ মেশিনের ভেতরে থাকে। তবুও তিনটি বিষয় নেটওয়ার্কের বাইরে যায়। npx npm রেজিস্ট্রি থেকে প্যাকেজ ডাউনলোড করে। এজেন্টের চালানো যেকোনো টুল নিজে থেকেই ইন্টারনেটে যোগাযোগ করতে পারে, যার মধ্যে আপনার কানেক্ট করা MCP (model context protocol) সার্ভারগুলোও অন্তর্ভুক্ত, যা running MCP servers on a VPS-এ বিস্তারিত আলোচনা করা হয়েছে। একটি প্লাগিনও একই ক্যাটাগরিতে পড়ে, কারণ একটি প্লাগিন ইনস্টল করা মানেই আপনার এজেন্টের অনুমতি নিয়ে অন্য কোনো লেখকের কোড চালানো, তাই checking what a plugin can reach before you install it করে নেওয়া বুদ্ধিমানের কাজ। এছাড়া টেলিমেট্রি, যা বর্তমান রিলিজগুলোতে DeepSeek-এর কাছে পাঠানোর অনুমতি দেওয়া থাকে যখনই আপনি ফিডব্যাক জমা দেন, তা লোকাল মডেলের ক্ষেত্রেও hosted মডেলের মতোই কাজ করে।

টেলিমেট্রি ডিফল্টভাবে শুধুমাত্র ফিডব্যাকের মধ্যে সীমাবদ্ধ। DSH_TELEMETRY_MODE মোড নির্বাচন করে, এবং বর্তমান shipped বেস কনফিগারেশনে কোনো মান সেট করা না থাকলে বা খালি থাকলে তা FEEDBACK_ONLY হিসেবে গণ্য হয়। সেই মোডে, সাধারণ কার্যকলাপে কোনো টেলিমেট্রি ক্যাপচার করার অনুমতি থাকে না। আপনি যখন লিখিত ফিডব্যাক জমা দেন, রেটিং তৈরি বা এডিট করেন, নোট এডিট করেন বা ফিডব্যাক প্রত্যাহার করেন, তখন dsh সেশন-লগের সেই অংশটি (যা আগে পাঠানো হয়নি) ফিডব্যাক ইভেন্টের মাধ্যমে এবং উত্তরাধিকারসূত্রে প্রাপ্ত কনটেক্সটসহ https://dsh-otel-collector.deepseeksvc.com/v1/logs-এ পাঠানোর অনুমতি দেয়। সম্পূর্ণ ডেলিভারি নিশ্চিত নয়: একটি বড় ইভেন্ট ট্রাঙ্কেশন ছাড়াই প্রত্যাখ্যাত হতে পারে এবং CLI থেকে বের হওয়ার সময় বড় প্রিফিক্সগুলো আংশিকভাবে না পাঠানো অবস্থায় থেকে যেতে পারে। অনুমোদিত ব্যাচগুলো কোনো নতুন ইন্টারঅ্যাকশন বা মডেল কল ছাড়াই পাঠানো অব্যাহত থাকতে পারে। টেলিমেট্রি README অনুযায়ী এটি "সকল ব্যবহারকারী এবং প্রোভাইডারের জন্য" প্রযোজ্য, তাই লোকালি মডেল চালালেও এটি বন্ধ হয় না। DISABLED কোনো OpenTelemetry (OTel) ট্রান্সপোর্ট তৈরি করে না। FULL এখন আর গৃহীত হয় না: এই দুটি ছাড়া অন্য যেকোনো মান unsupported mode দিয়ে প্রত্যাখ্যাত হয়। একটি ফিডব্যাক এক্সপোর্টে মেসেজ টেক্সট, টুলের আর্গুমেন্ট ও ফলাফল এবং ওয়ার্কস্পেস পাথ থাকতে পারে, তাই ফিডব্যাক জমা দেওয়াকে সেই সেশন প্রিফিক্স DeepSeek-এর কাছে পাঠানোর অনুমতি হিসেবে বিবেচনা করুন।

মোড স্ট্রিং সঠিকভাবে সেট করার ওপর নির্ভর না করে একটি চূড়ান্ত স্টপ নিশ্চিত করতে, DSH_TELEMETRY_DISABLED=1 সেট করুন। যেকোনো খালি নয় এমন মান একটি কার্যকর অপ্ট-আউট হিসেবে কাজ করে, যার মধ্যে 0 এবং false অন্তর্ভুক্ত, এবং এটি রান শুরু হওয়ার আগেই পড়া হয়, তাই সেশন চলাকালীন প্রজেক্ট কোড এটি পুনরায় চালু করতে পারে না। ডিফল্ট কালেক্টর অ্যাড্রেস হলো dsh-otel-collector.deepseeksvc.com; DSH_TELEMETRY_OTLP_URL এটি ওভাররাইড করে।

সেটিংয়ের ওপর ভরসা না করে যাচাই করুন। একটি টাস্ক চলাকালীন, প্রসেসটি যে আউটবাউন্ড কানেকশনগুলো ধরে রেখেছে তার তালিকা দেখুন।

sudo ss -tnp | grep -i node

লোকালি চালানো মডেলের ক্ষেত্রে, মডেল ট্রাফিক loopback port 11434 ব্যবহার করে, কিন্তু কোনো ফিডব্যাক জমা না দিলেও টুলগুলো থেকে পাবলিক কানেকশন আসতে পারে। Shipped প্রোফাইলগুলোতে ওয়েব সার্চ এবং ফেচ অন্তর্ভুক্ত থাকে এবং ডিফল্ট পারমিশন প্রিসেট নেটওয়ার্ক অ্যাক্সেস সীমাবদ্ধ করে না। টেলিমেট্রির সাথে যুক্ত করার আগে প্রতিটি পাবলিক গন্তব্য শনাক্ত করুন; শুধুমাত্র টাইমিং দেখে এটি নিশ্চিত হওয়া যায় না যে কানেকশনটি ফিডব্যাক এক্সপোর্ট। এই স্ন্যাপশটটি স্বল্পস্থায়ী কানেকশনগুলো মিস করতে পারে। এই পরীক্ষাটি শুধুমাত্র dsh প্রসেস কভার করে: একটি ক্লাউড মডেলের ট্রাফিক Ollama সার্ভার থেকে বের হয়, তাই নিশ্চিত করুন যে মডেল id কোনো ক্লাউড ট্যাগ নয়। অন্য যেকোনো কিছু চালিয়ে যাওয়ার আগে শনাক্ত করা উচিত। What a coding agent sends home অন্যান্য হার্নেসের বিপরীতে একই পরীক্ষা চালায় এবং ফলাফল কীভাবে পড়তে হয় তা ব্যাখ্যা করে।

যেখানে secret রাখা উচিত নয়

  • Shell history। export DEEPSEEK_API_KEY=sk-... cleartext আকারে ~/.bash_history-এ লেখা হয়, এবং key rotate করার অনেক পরেও সেখানে থেকে যায়। HISTCONTROL=ignorespace সেট করা থাকলে command-এর শুরুতে একটি space দিন, অথবা shell এড়িয়ে value সরাসরি mode 600-সহ একটি file-এ লিখুন।
  • Commit করা dotfile। dotfile git-এ রাখলে ~/.bashrc বা ~/.zshrc-এর একটি key একটি git add দূরেই public repository-তে চলে যেতে পারে। push করার আগে ওই repository-তে git grep -I -n 'sk-' চালান।
  • Profile patch file। Custom provider-এর জন্য apiKeyEnv ব্যবহার করুন, যাতে cordis.patch.yml-এ secret-এর বদলে একটি variable name থাকে। Config file issue report এবং support chat-এ paste হয়ে যায়। Credentials file হয় না।
  • env-এর output এবং terminal screenshot। যে কোনো command পুরো environment print করলে key-টিও তার সঙ্গে print হয়।
  • Backup। ~/.dsh backup করা গুরুত্বপূর্ণ, কিন্তু এর ভেতরের .credentials.yaml একটি সক্রিয় secret। ওই file বাদ দিন, অথবা archive encrypt করুন।

এই নিয়মগুলো শুধু dsh-এর জন্য নয়। একই server-এর container side-এ Compose env file-এ secret না রাখার পদ্ধতি একই সমস্যাটি ব্যাখ্যা করে।

Developer preview ব্যবহারের বাস্তবতা

আপনি যে version পরীক্ষা করেছেন, সেটিই নির্দিষ্ট করে রাখুন। কারণ preview একটি patch release-এ config key পরিবর্তন করতে পারে, ফলে আপনার provider আর load হতে নাও পারে। নির্দিষ্ট version দিয়ে install করার পর সেটি start না হলে, অথবা npx বারবার আপনার চাওয়া নয় এমন build সরবরাহ করলে, preview থেকে তৈরি install ও version সংক্রান্ত error-এ npx cache এবং আপনার Node-এর সঙ্গে সরবরাহ করা npm সম্পর্কে নির্দেশনা আছে। credentials file বাদ রেখে home cordis.patch.yml এবং profiles/-এর patch file version control-এ রাখুন। এতে upgrade-এর পরে কী পরিবর্তিত হয়েছে তা দেখা যাবে।

কোনো profile প্রত্যাশামতো কাজ না করলে দুটি flag সহায়ক। --dump-default-config boot না করেই একত্রিত default configuration দেখায়, আর --dump-config একইভাবে আপনার profile-এর জন্য একত্রিত configuration দেখায়। দুটি output তুলনা করলে patch layer বাস্তবে কী পরিবর্তন করেছে তা বোঝা যায়। প্রতিটি layer হাতে পড়ার চেয়ে এটি দ্রুত।

dsh --profile web --dump-config

Upgrade-এর পরে কিছু নষ্ট হলে প্রথমে এটি চালান। Release-এর মধ্যে কোনো key-এর অবস্থান বদলালে dump-এ তা missing branch হিসেবে দেখা যায়। তখন reinstall না করে এক লাইনের edit-এই সমস্যাটি ঠিক করা যায়।

FAQ

dsh আমার DeepSeek API key কোথায় সংরক্ষণ করে?

এটি $DSH_HOME/.credentials.yaml-এ থাকে, যা ~/.dsh/.credentials.yaml-এর ডিফল্ট লোকেশন, যদি না আপনি নিজে DSH_HOME সেট করেন। Models পেজটি সেখানে key লিখে রাখে এবং আপনার সেটিংস শুধুমাত্র সেটির একটি রেফারেন্স ধরে রাখে, তাই গোপন তথ্যটি একটি মাত্র ফাইলে থাকে। stat -c '%a %n' ~/.dsh/.credentials.yaml দিয়ে ফাইলের মোড চেক করুন এবং যদি এটি 600-এর বেশি শিথিল হয়, তবে তা 600-তে সেট করুন। একটি কাস্টম প্রোভাইডার ব্যবহার করলে apiKeyEnv দিয়ে এনভায়রনমেন্ট ভেরিয়েবলের নাম উল্লেখ করে ফাইলটি পুরোপুরি এড়িয়ে যাওয়া সম্ভব।

আমি কীভাবে dsh-কে DeepSeek API-এর পরিবর্তে লোকাল মডেল ব্যবহার করতে বলব?

একটি কাস্টম প্রোভাইডার যোগ করুন যার base URL হবে আপনার লোকাল OpenAI-compatible এন্ডপয়েন্ট। Ollama-এর ক্ষেত্রে এটি হলো http://127.0.0.1:11434/v1, সাথে api: openai-completions এবং একটি মডেল id যা হুবহু ollama list থেকে কপি করা। এই কনফিগারেশনের জন্য একটি নন-এম্পটি API key প্রদান করুন; লোকাল Ollama সার্ভার এটি উপেক্ষা করে। dsh কনফিগারেশন এডিট করার আগে curl -s http://127.0.0.1:11434/v1/models দিয়ে নিশ্চিত করুন যে এন্ডপয়েন্টটি সাড়া দিচ্ছে, কারণ একটি অকার্যকর এন্ডপয়েন্ট এবং ভুল কনফিগারেশন একই ধরনের ত্রুটি তৈরি করে।

dsh কি ডিফল্টভাবে আমার কোড কোথাও পাঠায়?

হোস্টেড মডেলের ক্ষেত্রে, হ্যাঁ। আপনার প্রম্পট এবং এজেন্ট যে ফাইলগুলো পড়েছে তার বিষয়বস্তু সেই ভেন্ডরের কাছে API রিকোয়েস্টের মাধ্যমে চলে যায়। নেটিভ DeepSeek অ্যাডাপ্টারের মাধ্যমে করা রিকোয়েস্টগুলো, কনফিগার করা গেটওয়েসহ, ডিফল্টভাবে একটি session-log সাফিক্স বহন করে যতক্ষণ না আপনি Settings, General থেকে সেই আপলোড বন্ধ করছেন। Ollama-এর মাধ্যমে লোকালি চালানো মডেলের ক্ষেত্রে, রিকোয়েস্টটি loopback-এ যায় এবং মেশিনের ভেতরেই থাকে, কিন্তু gemma4:cloud-এর মতো ক্লাউড মডেলগুলো একই loopback অ্যাড্রেসের মাধ্যমে Ollama-এর ক্লাউডে তথ্য পাঠায়। বিল্ট-ইন ওয়েব সার্চ, ফেচ, অন্যান্য টুল এবং প্লাগিনগুলো ফিডব্যাকের বাইরেও স্বাধীনভাবে পাবলিক সার্ভিসের সাথে যোগাযোগ করতে পারে। টেলিমেট্রি একটি আলাদা ফিড: বর্তমান রিলিজগুলোতে DSH_TELEMETRY_MODE আনসেট থাকলে তা FEEDBACK_ONLY হিসেবে রেজলভ হয়, তাই ফিডব্যাক অনুমোদনের মাধ্যমে লোকাল মডেলসহ প্রতিটি প্রোভাইডারের জন্য session-log প্রিফিক্স এবং ইনহেরিটেড কনটেক্সট এক্সপোর্ট করা হয়। ডেলিভারি নিশ্চিত নয়, এবং ফিডব্যাক ইন্টারঅ্যাকশনের পরেও অনুমোদিত আপলোড চলতে পারে। কোনো এক্সপোর্টার না চাইলে এটি DISABLED-এ সেট করুন, অথবা রান শুরু হওয়ার আগে পড়া হয় এমন একটি অপ্ট-আউটের জন্য DSH_TELEMETRY_DISABLED=1 সেট করুন।

আমার ভেরিয়েবল সেট করা থাকা সত্ত্বেও dsh কেন MISSING_CREDENTIAL রিপোর্ট করে?

কারণ apiKeyEnv দ্বারা নির্দেশিত রেফারেন্সটিকে dsh-এর ক্রেডেনশিয়াল সোর্সে অবশ্যই রেজলভ হতে হবে। সেভ করা ক্রেডেনশিয়ালগুলো লঞ্চ এনভায়রনমেন্টের চেয়ে বেশি প্রাধান্য পায়, এরপর আসে ইনভোকিং ডিরেক্টরির .env এবং $DSH_HOME/.env। আপনার শেলে এক্সপোর্ট করা কোনো ভেরিয়েবল systemd সার্ভিস, অন্য কোনো ইউজারের সেশন বা আপনার এক্সপোর্ট করার আগে শুরু হওয়া কোনো প্রসেসে পৌঁছায় না। ইউনিটের জন্য 600 মোডসহ একটি EnvironmentFile-এ ভ্যালুটি রাখুন, অথবা যে শেল থেকে dsh শুরু করছেন সেখানে এটি এক্সপোর্ট করুন। চলমান প্রসেসটি আসলে কী ধারণ করছে তা sudo tr '\0' '\n' < /proc/$(pgrep -f dsh | head -1)/environ দিয়ে নিশ্চিত করুন।

dsh-এর জন্য কোন Node.js ভার্সন প্রয়োজন?

5 নভেম্বর 2026 অনুযায়ী রিপোজিটরির package.json অনুযায়ী Node.js 24.9 বা তার পরবর্তী ভার্সন প্রয়োজন। 22 লাইনটি আর সমর্থিত নয় এবং Node 24.0 থেকে 24.8-ও যথেষ্ট নয়। অন্য কিছু করার আগে node -v চালান, কারণ অসমর্থিত রানটাইমের কারণে স্টার্টআপ ফেইল করলে মনে হতে পারে ইন্সটলেশন ভেঙে গেছে এবং মানুষ রানটাইম আপডেট না করে প্যাকেজটি পুনরায় ইন্সটল করতে শুরু করে।

এই লেখাটি কি কাজে লেগেছে?