SSD Nodes Learn Hosting plans →
নির্দেশিকা Matt Connorদ্বারা Matt Connor

DeepSeek Harness install ও version error ঠিক করুন

DeepSeek Harness-এর latest build এখনও prerelease। নির্দিষ্ট dsh version pin করুন, npx cache পরিষ্কার করুন এবং আসলে কোন npm চালু হচ্ছে তা যাচাই করুন।

DeepSeek Harness install আসলে কী

DeepSeek Harness install একটি command: npx @deepseek-ai/dsh web। কোনো installer নেই এবং configure করার মতো কোনো service-ও নেই। মানুষ যে সমস্যার মুখোমুখি হয়, তার বেশিরভাগই installation-সংক্রান্ত নয়। এগুলো version resolution-সংক্রান্ত সমস্যা: @deepseek-ai/dsh-এর কোন build npx আজ চালানোর জন্য বেছে নিয়েছে এবং আপনার Node.js version সেটি চালাতে পারে কি না। এটি চালু হলে localhost-এ bind করাই default; --host এবং --port listener settings override করে, আর configured থাকলে প্রদর্শিত address-এ --public-url ব্যবহার করা হয়। Default binding এবং কেন Web UI শুধু 127.0.0.1:3080-এ সাড়া দেয়—এই পৃষ্ঠার অন্য সমস্যাগুলো থেকে আলাদা।

নিচের সবকিছুর ভিত্তিতে দুটি বিষয় কাজ করে। প্রথমত, 27 October 2026 পর্যন্ত npm-এ প্রকাশিত @deepseek-ai/dsh-এর প্রতিটি version ছিল prerelease। বেশিরভাগই release candidate (-rc.N), এবং 30 August 2026 থেকে alpha build (-alpha.N)-ও প্রকাশিত হয়েছে। latest tag একটি release candidate-কে নির্দেশ করে। 6 November 2026 অনুযায়ী সেটি হলো 0.2.2-rc.1। দ্বিতীয়ত, project README অনুযায়ী harness এখনো developer preview পর্যায়ে আছে, দ্রুত পরিবর্তিত হচ্ছে এবং compatibility-breaking change থাকবে। গত সপ্তাহে কাজ করা কোনো flag এই সপ্তাহে আর নাও থাকতে পারে। এর ওপর ভিত্তি করে কিছু তৈরি করার আগে একটি version pin করুন।

প্রথমে কয়েকটি term জেনে নিন। dsh হলো DeepSeek Harness command line tool। Node.js হলো এর প্রয়োজনীয় JavaScript runtime। npx হলো npm (node package manager)-এর সঙ্গে সরবরাহ করা package runner। এটি কোনো package স্থায়ীভাবে install না করে প্রয়োজনের সময় fetch করে। ওই বাক্যে harness শব্দটির ব্যবহার অপরিচিত হলে, agent harness হলো model-কে ঘিরে থাকা program। এটি loop, tools, permissions এবং session state নিয়ন্ত্রণ করে। তাই আপনি নিজে বেছে না নেওয়া একটি version number আপনার agent-এর আচরণ পরিবর্তন করতে পারে।

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

10 October 2026-এ, repository-এর version যখন 0.2.1-alpha.2 ছিল, তখন root package.json-এ "engines": {"node": "^22.19.0 || >=24.0.0"} ঘোষণা করা ছিল। এটি আর প্রয়োজনীয়তা নয়। 27 October 2026-এ repository-এর version 0.2.1-rc.3 থাকা অবস্থায় পড়া root package.json-এ "engines": {"node": ">=24.9.0"} ঘোষণা করা আছে, এবং CLI-এর নিজস্ব source package.json-এও এখন একই ঘোষণা রয়েছে। 15 October 2026-এর একটি project decision note-এ বলা হয়েছে যে Node 22 installation আপগ্রেড করতে হবে। Node 24.0-ও যথেষ্ট নয়, কারণ entry point-গুলো import.meta.main-এর ওপর নির্ভর করে, যা 24.0-এ নেই। তাই Node 24.9.0 বা তার নতুন version ব্যবহার করুন। Node 20 এবং Node 22 গ্রহণযোগ্য নয়। 24.9.0-এর আগের যেকোনো Node 24 release-ও গ্রহণযোগ্য নয়। 27 October 2026-এ যাচাই করার সময় 0.2.1-rc.2-এর release tag, এরপর build latest যে version-এ নির্দেশ করেছিল, এবং 0.2.1-rc.3—সবকটিতেই পুরোনো range ছিল। তাই নতুন minimum version পরে যুক্ত হয়েছে। তবু 24.9.0-এর জন্য প্রস্তুতি নিন, কারণ project এখন এই range-ই ঘোষণা করে।

অন্য কিছু করার আগে আপনার বর্তমান version পরীক্ষা করুন।

node -v
npm -v

এখানেই সাধারণত মানুষ অবাক হয়। 27 October 2026 পর্যন্ত প্রকাশিত @deepseek-ai/dsh package-এর 38টি version-এর কোনোটিতেই নিজস্ব engines field ছিল না, যার সর্বশেষটি ছিল 0.2.1-rc.4। Monorepo root-এ একটি field ঘোষণা করা আছে, কিন্তু সেই root file কখনো npm-এ publish করা হয় না। 15 October 2026-এর একটি commit-এ CLI-এর source package.json-এ একটি field যোগ হয়েছিল। তবে 27 October 2026-এ পরীক্ষা করা কোনো published build-এ এটি ছিল না। তাই ওই build-গুলো npm-কে dsh-এর জন্য নির্দিষ্ট কোনো Node requirement যাচাই করার সুযোগ দেয়নি। 6 November 2026 অনুযায়ী, প্রকাশিত 0.2.2-rc.1 package-এ "engines": {"node": ">=24.9.0"} ঘোষণা করা আছে। আপনি engine-strict সেট না করলে npm engines-কে advisory হিসেবে বিবেচনা করে। তাই default setting-এ সর্বোচ্চ একটি warning আশা করুন। Unsupported Node-এ installation সফল হয়েছে বলে মনে হতে পারে। পরে loaded code এমন syntax বা API ব্যবহার করলে failure দেখা দেয়, যা আপনার runtime সমর্থন করে না। খোঁজার মতো একটিমাত্র নির্ভরযোগ্য error string নেই। কোন module আগে load হয় তার ওপর প্রথমে কোন line ব্যর্থ হবে তা নির্ভর করে। 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 দেখানোর কথা। Shell এখনও পুরোনো version দেখালে which node চালান। ~/.nvm-এর বাইরের কোনো path সাধারণত দুটি কারণে দেখা যায়। প্রথমত, nvm shell function load হয়নি। নতুন login shell খুলে আবার চেষ্টা করুন। দ্বিতীয়ত, আপনার shell profile-এর কোনো line nvm source করা line-গুলোর পরে PATH পরিবর্তন করে এবং অন্য একটি Node-কে সামনে রাখে। সেই line-টি nvm line-গুলোর ওপরে সরিয়ে দিন। 10 October 2026-এ Node 24 সক্রিয় LTS (long term support) line ছিল এবং 20 October 2026-এ maintenance পর্যায়ে যায়। 29 October 2026 অনুযায়ী এর নতুনতম release হলো 24.22.2, যা 24.9.0 minimum version-এর চেয়ে অনেক নতুন। >=24.9.0 range-এ অনুমোদিত Node 26, version 26.13.0 নিয়ে 28 October 2026-এ active LTS হয়। দুটিই minimum version পূরণ করে। উভয়ের সঙ্গে নিচে আলোচিত range-cache fix-সহ npm version bundle করা থাকে। Official Node 26 Linux binary-গুলোর জন্য libatomic-ও প্রয়োজন। আপনার distribution-এ এটি আলাদাভাবে install করতে হতে পারে।

npx কেন প্রতিদিন ভিন্ন version চালায়?

npx @deepseek-ai/dsh web কোনো version উল্লেখ করে না। তবে আপনার বর্তমান directory-এর project-এ যদি ইতিমধ্যে @deepseek-ai/dsh installed থাকে, তাহলে npx সেই copy চালায়। অন্যথায় npx registry-কে জিজ্ঞাসা করে latest tag বর্তমানে কোন version-এ নির্দেশ করছে। এই tag পরিবর্তনশীল এবং প্রায়ই পরিবর্তিত হয়। 0.1.0-rc.8 19 August 2026-এ প্রকাশিত হয়, 0.1.0-rc.7-এর দুই দিন পরে। 10 October 2026-এর মধ্যে latest, 0.2.0-rc.2-এ নির্দেশ করছিল এবং 27 October 2026-এর মধ্যে 0.2.1-rc.2-এ নির্দেশ করছিল। প্রতিবার এটি পরিবর্তিত হলে আপনার notes-এ থাকা command-টি কোনো prompt বা changelog ছাড়াই ভিন্ন code চালাতে শুরু করে।

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 কোন version-এ নির্দেশ করছে তা দেখায়। 10 October 2026-এ latest এবং next উভয়ই 0.2.0-rc.2-এ নির্দেশ করছিল। একই সময়ে তৃতীয় একটি tag, alpha, আগের দিন প্রকাশিত 0.2.1-alpha.2-এ নির্দেশ করছিল। 27 October 2026-এ latest, 0.2.1-rc.2-এ; next, আগের দিন প্রকাশিত 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 list আরও গুরুত্বপূর্ণ, কারণ এতে কিছু version অনুপস্থিত। 10 October 2026-এ এতে 0.0.1-rc.1 থেকে 0.2.1-alpha.2 পর্যন্ত 31টি version ছিল। 27 October 2026-এ এতে 38টি version ছিল, এবং প্রতিটিই তখনও prerelease ছিল। 0.0.1 line -rc.2 থেকে -rc.5-এ লাফ দেয়। 0.1.0 line -rc.3 থেকে -rc.6-এ লাফ দেয়। Alpha build শুরু হয় 0.1.2-alpha.2 এবং 0.1.3-alpha.2 থেকে। এছাড়া 0.1.4 একেবারেই নেই। প্রকাশিত list-এ কিছু number অনুপস্থিত। একই list-এ alpha build এবং release candidate পাশাপাশি রয়েছে। Deploy script-এ পরবর্তী -rc.N অনুমান করলে তা ব্যর্থ হবে। তাই ধারাবাহিকভাবে number বাড়ানোর বদলে list পড়ুন।

npx কেন পুরোনো version চালাতে থাকে?

এটি আগের অভিযোগের বিপরীত। তবে package spec, local installation এবং আপনি কোন npm চালাচ্ছেন তার ওপর নির্ভর করে দুটিই সত্য হতে পারে।

npx tarball cache থেকে আলাদা একটি নিজস্ব package directory রাখে। এই directory-টি npm cache-এর ভেতরে _npx নামে থাকে। এর path দেখুন এবং directory-টির বিষয়বস্তু পরীক্ষা করুন।

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

কোনো project installation-এর বাইরে bare package name ব্যবহৃত হলে npm 10.9.3 ইতিমধ্যে registry পরীক্ষা করে। npm 11.2.0 version range-এর cache freshness পরীক্ষা পরিবর্তন করেছে। spec যদি bare name হয় এবং package-টি বর্তমান project-এ আগে থেকে installed না থাকে, npx preferOnline: true দিয়ে manifest fetch করে এবং _npx-এ cached copy পুনরায় ব্যবহার করে, কিন্তু কেবল তখনই যখন resolved tarball registry থেকে পাওয়া tarball-এর সঙ্গে মেলে। bare name ব্যবহার করলে registry পরীক্ষা ছাড়াই বর্তমান project-এ installed যেকোনো version মিলে যায়। Version range-এর ক্ষেত্রে npm 10.9.3 matching cached version গ্রহণ করে। npm 11.2.0 এবং পরবর্তী version পরীক্ষা করে range-টি আরও নতুন কোনো version-এ resolve হচ্ছে কি না।

আপনি কোন আচরণ পাবেন তা নির্ধারিত হয় আপনি বাস্তবে যে npm চালাচ্ছেন সেটি দিয়ে। npm install -g npm ব্যবহার করে আলাদাভাবে npm upgrade না করলে, আপনার Node release যে npm bundle করে সেটিই ব্যবহৃত হবে:

  • Node 20.20.2-এর সঙ্গে npm 10.8.2 bundle করা থাকে।
  • Node 22.19.0-এর সঙ্গে npm 10.9.3 bundle করা থাকে।
  • Node 22.23.4, যা 27 October 2026 অনুযায়ী সর্বশেষ 22 release, তার সঙ্গে npm 10.9.9 bundle করা থাকে।
  • Node 24.9.0, যা harness-এর বর্তমান সর্বনিম্ন supported version, তার সঙ্গে npm 11.6.0 bundle করা থাকে।
  • Node 24.19.0-এর সঙ্গে npm 11.17.0 bundle করা থাকে।
  • Node 24.22.2, যা 29 October 2026 অনুযায়ী সর্বশেষ 24 release, তার সঙ্গে npm 11.19.1 bundle করা থাকে।
  • Node 26.13.0, যা 29 October 2026 অনুযায়ী সর্বশেষ 26 release, তার সঙ্গে npm 11.20.0 bundle করা থাকে।

অতএব, সম্পূর্ণ Node 22 line-এ 11.2.0-এর চেয়ে পুরোনো npm release থাকে। harness 2026 সালের October-এর মাঝামাঝি পর্যন্ত Node 22 support করত, এখন আর করে না। তবে তার আগে dsh চালানো কোনো server এখনও এতে থাকতে পারে। Node 22.19.0-এর bundled npm 10.9.3 project installation-এর বাইরে একটি bare npx @deepseek-ai/dsh web-কে registry-এর সঙ্গে পুনরায় পরীক্ষা করে। তাই শুধু একটি পুরোনো _npx entry থাকলে পুরোনো release candidate-এর কারণ ব্যাখ্যা হয় না। harness এখন যে সব Node release গ্রহণ করে, 24.9.0 থেকে শুরু করে, সেগুলোর সঙ্গে npm 11.6.0 বা তার পরবর্তী version bundle করা থাকে। এতে range-cache fix-ও অন্তর্ভুক্ত। তবে project installation এখনও অগ্রাধিকার পেতে পারে। Tool-টিকে তার version জানাতে বলুন:

npx @deepseek-ai/dsh --version

npx cache পরিষ্কার করা

npm 11.2.0 এবং পরবর্তী version-এ এ কাজের জন্য নির্দিষ্ট subcommand আছে।

npm cache npx ls
npm cache npx rm --force

--force ছাড়া npm সবকিছু মুছে ফেলতে অস্বীকার করে এবং Please use --force to remove entire npx cache প্রদর্শন করে। সব entry মুছে না ফেলে key দিয়ে একটি entry সরাতে চাইলে আগে npm cache npx ls ব্যবহার করুন।

npm 10-এ এই subcommand-গুলো নেই। তাই directory-টি নিজে মুছে ফেলুন।

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

npm cache clean --force এখানে কাজে আসে না। এটি _cacache, অর্থাৎ tarball store পরিষ্কার করে, কিন্তু _npx অপরিবর্তিত রাখে। এই পৃথকীকরণের কারণেই npm পরে npm cache npx subcommand যোগ করেছে। _npx পরিষ্কার করলেও স্থায়ী কোনো ক্ষতি হয় না। এতে downloaded package থাকে, আর আপনার harness state $DSH_HOME-এর অধীনে আলাদাভাবে থাকে। এর মধ্যে profiles/<name>, sessions, storages এবং .credentials.yaml অন্তর্ভুক্ত, এবং এগুলো অপরিবর্তিত থাকে।

কীভাবে নির্দিষ্ট release candidate pin করব?

-rc.N অংশসহ সম্পূর্ণ version string লিখুন।

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

এই পৃষ্ঠার উদাহরণগুলোতে 0.1.0-rc.7 ব্যবহার করা হয়েছে। আপনি যে build বাস্তবে পরীক্ষা করেছেন, সেটি দিয়ে এটি প্রতিস্থাপন করুন। 27 October 2026 তারিখে latest tag-টি 0.2.1-rc.2-এর দিকে নির্দেশ করছিল।

--yes কোনো interactive prompt ছাড়াই npx-এর package-install confirmation গ্রহণ করে।

নির্দিষ্ট version dsh package-কে pin করে, কিন্তু offline start নিশ্চিত করে না। npx আপনার লেখা spec string-এর ভিত্তিতে cache directory নির্ধারণ করে এবং সেখানে আগে থেকেই ইনস্টল থাকা নির্দিষ্ট version পুনরায় ব্যবহার করতে পারে। তবে কোনো matching local installation না থাকলে, আগের local-tree check preferOnline: true দিয়ে manifest fetch করে, তারপর _npx পরীক্ষা করে। Local project-এ matching exact version ইনস্টল করা থাকলে এই manifest lookup এড়ানো যায়। Project-এর বাইরে dsh ইনস্টল করা bare name চালালেও manifest lookup হয়, npm 10.9.3-এও।

Global install একইভাবে pin করা যায় এবং এতে একটি সংক্ষিপ্ত command পাওয়া যায়।

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

@deepseek-ai/dsh@^0.1.0-এর জন্য matching version পাওয়া যায়নি

27 October 2026 তারিখ পর্যন্ত, এই package-এর ক্ষেত্রে সরাসরি caret বা tilde range ব্যর্থ হয়েছে। npm install -g @deepseek-ai/dsh@^0.1.0 error code ETARGET এবং No matching version found for @deepseek-ai/dsh@^0.1.0. লাইনসহ উত্তর দিয়েছে। Registry ঠিক আছে। এটি semver-এর একটি নিয়ম: কোনো version range prerelease version-এর সঙ্গে match করে না, যতক্ষণ না range-এর নিজস্ব কোনো comparator একই major, minor এবং patch number-সহ একটি prerelease উল্লেখ করে। 27 October 2026 পর্যন্ত এই package-এর প্রকাশিত প্রতিটি build ছিল prerelease—হয় -rc.N, নয় -alpha.N—এবং ^0.1.0 কোনো prerelease উল্লেখ করেনি। তাই কোনো কিছুর সঙ্গেই match হয়নি। নির্দিষ্ট version লিখুন।

এই নিয়ম দুই দিকেই প্রযোজ্য। সাধারণ range নতুন release candidate-এ নিজে থেকে সরে যায় না, কিন্তু prerelease উল্লেখ করা range সরে যেতে পারে। ^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 গ্রহণ করবে না। এটি exact version এবং পরিবর্তনশীল tag-এর মাঝামাঝি একটি আংশিকভাবে pinned অবস্থা। আপনি কিছু পরিবর্তন না করলেও এতে চালু হওয়া version বদলে যেতে পারে। আপনি যে build পরীক্ষা করেছেন এবং অন্য কিছু নয়, সেটিই চাইলে exact version লিখুন।

npx ব্যবহার করব, নাকি dsh globalভাবে install করব?

প্রথমবার পরীক্ষা করার জন্য npx ব্যবহার করুন, কারণ packageটি এমন একটি cache directory-তে থাকে, যা এখন আপনি কীভাবে পরিষ্কার করবেন তা জানেন। Reboot-এর পরেও কাজ করতে হবে এমন কিছুর জন্য pinned global install ব্যবহার করুন, যেমন VPS-এ চালু রাখা একটি coding agent।

একই box-এ দুটিরই ব্যবহার থাকলে তাদের ফল আলাদা হতে পারে। তাই তুলনা করে দেখুন।

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

which dsh সফল global install-এর পরপরই কিছু না পাওয়ার অর্থ প্রায় সব সময় npm-এর global bin directory আপনার PATH-এ অনুপস্থিত। root দেখাতে npm prefix -g চালান। Binary-গুলো এর অধীনের bin folder-এ থাকে।

একটি security বিষয় মনে রাখুন। npx নতুন কোনো কিছু resolve করার সময় registry থেকে code fetch করে এবং execute করে। Server-এ এটি তাত্ত্বিক নয়, বাস্তব security exposure। Pinning এর একটি অংশের সমাধান। বাকি বিষয়টি npm supply chain attack কীভাবে server-এ পৌঁছায়-এ ব্যাখ্যা করা হয়েছে।

পুনরুৎপাদনযোগ্যতার ক্ষেত্রে developer preview-এর অর্থ

0.1.0-rc.6 13 August 2026-এ প্রকাশিত হয়েছিল এবং 0.1.0-rc.7 17 August 2026-এ প্রকাশিত হয়েছিল। ব্যবধান ছিল 4 দিন। এরপরও প্রকাশের গতি কমেনি: 19 August থেকে 9 October 2026-এর মধ্যে আরও 24টি version প্রকাশিত হয়েছে। এর মধ্যে 28 September-এ 0.2.0-rc.1 এবং পরের দিন 0.2.0-rc.2 প্রকাশিত হয়। এরপর 14 থেকে 26 October 2026-এর মধ্যে আরও 7টি version প্রকাশিত হয়েছে, যার সর্বশেষটি 0.2.1-rc.4। এই গতিতে এক মাস আগে লেখা নির্দেশনা এমন command line বর্ণনা করতে পারে, যা এখন আর নেই; এই পৃষ্ঠাটিও এর ব্যতিক্রম নয়। আপনি যে version-এর দাবি লিখবেন, নিজের নোটসহ প্রতিটির তারিখ উল্লেখ করুন।

দুটি অভ্যাস preview ব্যবহারযোগ্য রাখে। প্রতিটি command এবং script-এ সঠিক version pin করুন, যাতে server পুনর্নির্মাণের সময় একই dsh release নির্বাচন হয়। তবে এতে একাই dependency পুনরুৎপাদন হয় না: প্রকাশিত 0.2.2-rc.1 package-এ js-yaml: ^4.3.2 এবং commander: ^15.0.0-এর মতো range ব্যবহার করা হয়েছে এবং এটি npm shrinkwrap ছাড়াই প্রকাশিত হয়েছে। পুনরাবৃত্তিযোগ্য dependency install-এর জন্য dsh-কে committed package-lock.json-সহ একটি local project-এ রাখুন এবং npm ci দিয়ে rebuild করুন। এরপর যেকোনো guide-এর পরিবর্তে pinned build-এর help output পড়ুন।

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

পুনরুৎপাদনযোগ্যতার দ্বিতীয় অংশ হলো profile। dsh --profile <name> $DSH_HOME/profiles/<name>-এ সংরক্ষিত profile boot করে। web এবং headless profile প্রথমবার ব্যবহারের সময় প্রকাশিত template থেকে নিজে তৈরি হয়। Profile patch-এ model ও endpoint-এর settings রাখা যায়। তবে সংরক্ষিত API key $DSH_HOME/.credentials.yaml-এ থাকে, আর settings-এ credential reference সংরক্ষিত থাকে। তাই pinned version এবং কার্যকর configuration—দুটি আলাদা বিষয় সঠিকভাবে নির্ধারণ করতে হয়। Home-level এবং command-line patch profile settings-কে override করতে পারে। In-box bundle বর্তমানে চলমান dsh installation থেকে resolve হয়। তাই pinned version পরিবর্তন করলে ওই bundle-গুলোও পরিবর্তিত হয়। Out-of-tree plugin আলাদাভাবে কাজ করে। এগুলো profile directory-তে থাকে এবং dsh plugin --profile <name> add <package> এগুলো install করার জন্য নিজের argument pnpm-এ পাঠায়। তাই আপনার PATH-এ pnpm থাকতে হবে। না থাকলে dsh বিষয়টি স্পষ্টভাবে জানায়। আপনি যে প্রতিটি plugin যোগ করেন, তা আপনার agent-এর সমান permission নিয়ে চলে। তাই install করার আগে কোনো plugin কোন resource-এ পৌঁছাতে পারে তা যাচাই করা গুরুত্বপূর্ণ। Profile-এর নিজস্ব package.json ওই plugin-গুলো ঘোষণা করে। সেগুলোর pnpm-lock.yaml সংরক্ষণ করুন এবং dependency version পুনরুৎপাদনের জন্য pnpm install --frozen-lockfile ব্যবহার করুন।

আপনি যদি server-এ Python tool-গুলো isolated environment-এ রেখে থাকেন, এই বিভাজনটি পরিচিত মনে হবে: tool এবং এতে যোগ করা উপাদানগুলো আলাদা জায়গায় pin করা থাকে। Harness চালু হলে পরের প্রশ্নটি সাধারণত version নয়, networking নিয়ে হয়। তখন remote VPS থেকে dsh Web UI-তে পৌঁছানো এবং VPS-এ DeepSeek Harness install করা-র দীর্ঘ walkthrough প্রাসঙ্গিক হয়।

আপনি বাস্তবে যে argument error-গুলো দেখবেন

এই error-গুলো CLI-এর নিজস্ব parser থেকে আসে এবং প্রতিটিতে সঠিক সমস্যাটি উল্লেখ থাকে। বিভিন্ন build-এ wording বেশিরভাগ সময় একই থাকলেও পুরোপুরি অপরিবর্তিত নয়। তাই নিচের message-গুলো 6 October 2026 তারিখে 0.2.0-rc.2-এর সঙ্গে যাচাই করা হয়েছে।

error: --profile <name> is required

আপনি কোনো subcommand বা profile ছাড়াই npx @deepseek-ai/dsh চালিয়েছেন। সরাসরি এই command চালালে একটি profile boot হয়, তাই একটি name প্রয়োজন। dsh web-এর সঙ্গে --profile ছাড়াও কাজ করে, কারণ parser প্রথম bare word-কে profile name হিসেবে পড়ে। তাই এটি আপনার হয়ে shipped web profile boot করে।

error: --patch needs a path

--patch-এর পরে কোনো path দেওয়া হয়নি। এই flag একাধিকবার ব্যবহার করা যায় এবং প্রতিবার একটি file path দিতে হয়।

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

একটি বেছে নিন। 6 October 2026 তারিখে 0.2.0-rc.2 যে build latest-এর দিকে নির্দেশ করছিল, তাতে message-এ তৃতীয় একটি flag-ও উল্লেখ থাকে এবং message-টি error: --dump-config, --dump-default-config, and --dump-config-schema are mutually exclusive হিসেবে দেখা যায়। কারণ profile entry ও patch-এর JSON Schema প্রিন্ট করা --dump-config-schema এখন অন্য দুটির সঙ্গে যুক্ত হয়েছে। --dump-default-config shipped bundle layer-গুলো প্রিন্ট করে এবং কোনো --patch গ্রহণ করে না। --dump-config একটি profile-এর composed configuration প্রিন্ট করে। তিনটিই harness start না করেই কাজ করে। তবে schema collection plugin module import করতে পারে এবং getter ও lazy builder চালু করতে পারে। তাই শুধু trusted plugin পরীক্ষা করুন এবং script-এ external timeout প্রয়োগ করুন।

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

dsh plugin --profile <name>-এর কাছে forward করার মতো কোনো argument দেওয়া হয়নি। এই subcommand profile অনুপস্থিত থাকলে তা initialise করে। এরপর command line-এর বাকি অংশ pnpm-এর কাছে পাঠায়। তাই add @scope/dsh-plugin-example-এর মতো argument দিতে হয়।

FAQ

DeepSeek Harness-এর জন্য কোন Node.js version প্রয়োজন?

Node.js 24.9.0 বা নতুন version প্রয়োজন। 27 October 2026-এ, repository-এর version 0.2.1-rc.3 থাকা অবস্থায়, এর root package.json-এ >=24.9.0 ঘোষণা করা ছিল। 10 October 2026-এ সেখানে ^22.19.0 || >=24.0.0 ঘোষণা করা হয়েছিল, কিন্তু 15 October 2026 তারিখের একটি project decision note-এ Node 22 বাদ দিয়ে minimum version 24.0-এর ওপরে নির্ধারণ করা হয়। Node 20 এবং Node 22 কাজ করবে না। 24.9.0-এর চেয়ে পুরোনো কোনো Node 24 release-ও কাজ করবে না। 27 October 2026 পর্যন্ত কোনো published npm build-এর নিজস্ব engines field ছিল না। তাই dsh-এর নিজস্ব Node requirement-এর ভিত্তিতে npm সতর্ক বা block করতে পারত না, এবং unsupported runtime পরে গিয়ে ব্যর্থ হতো। 6 November 2026-এ পরীক্ষা করা published 0.2.2-rc.1 package এখন engines.node-এ >=24.9.0 ঘোষণা করে। npm defaultভাবে সতর্ক করে এবং engine-strict enabled থাকলে incompatible runtime প্রত্যাখ্যান করে। প্রথমে node -v পরীক্ষা করুন। এই minimum version পূরণ করে এমন প্রতিটি Node release-এর সঙ্গে npm 11 বা নতুন version থাকে। এতে npm 11.2.0-এ যোগ হওয়া npx range-cache fix অন্তর্ভুক্ত থাকে।

Cached version-এর বদলে newest dsh ব্যবহার করতে npx-কে কীভাবে বাধ্য করব?

npm 10.9.3 এবং বর্তমান npm bare package name-এর জন্য registry পুনরায় পরীক্ষা করে। তবে current directory-টি dsh installed থাকা কোনো project হলে npx সেই local copy চালায়। Registry-এর latest tag স্পষ্টভাবে অনুরোধ করতে npx @deepseek-ai/dsh@latest --version ব্যবহার করুন। npm 11.2.0 version range-এর freshness check পরিবর্তন করেছে, bare name-এর নয়। npm 11.2.0 বা নতুন version-এ 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 install করতে ব্যর্থ হয় কেন?

27 October 2026-এ npm ETARGET error code এবং No matching version found for @deepseek-ai/dsh@^0.1.0. line ফেরত দিয়েছিল। সেই পরীক্ষায় প্রকাশিত প্রতিটি build ছিল 0.2.0-rc.2 বা 0.2.1-alpha.2-এর মতো prerelease। কোনো semver range-এর মধ্যে একই major, minor এবং patch number-সহ prerelease উল্লেখ না থাকলে সেই range prerelease version-এর সঙ্গে মেলে না। Suffix-সহ exact version string install করুন। কোন কোন version বিদ্যমান তা দেখতে npm view @deepseek-ai/dsh versions --json চালান, কারণ sequence-এ gap আছে।

dsh কি globally install করব, নাকি npx-এর মাধ্যমে চালাব?

প্রথমবার পরীক্ষা করার জন্য npx উপযোগী, কারণ package-টি তার cache directory-তে থাকে। Harness persistent profile state-ও তৈরি করে। যে কাজ সবসময় চালু থাকা প্রয়োজন, তার জন্য npm install -g @deepseek-ai/dsh@0.1.0-rc.7-এর মতো pinned global install উপযোগী। কারণ আপনি version পরিবর্তন না করা পর্যন্ত version পরিবর্তিত হবে না। Global install-এর পরে dsh command পাওয়া না গেলে npm-এর global bin directory আপনার PATH-এ নেই। npm prefix -g সেই directory যে root-এর অধীনে থাকে, তা দেখায়।

DeepSeek Harness কি এর ওপর ভিত্তি করে build করার মতো যথেষ্ট stable?

নিজের বর্ণনা অনুযায়ী, এখনও নয়। README-তে বলা হয়েছে, project-টি developer preview পর্যায়ে আছে, দ্রুত পরিবর্তন করা হচ্ছে এবং compatibility-breaking change হবে। 0.1.0-rc.6 এবং 0.1.0-rc.7 release candidate 2026 সালের August-এ 4 দিনের ব্যবধানে প্রকাশিত হয়েছিল। 0.2.0-rc.1 এবং 0.2.0-rc.2 2026 সালের September-এ 1 দিনের ব্যবধানে প্রকাশিত হয়েছিল। 0.2.1-rc.1 এবং 0.2.1-rc.2 2026 সালের October-এ একই দিনে প্রকাশিত হয়েছিল। 2026 সালের October-এ supported Node range-ও পরিবর্তিত হয়েছিল। Exact version pin করুন এবং কোনো guide-এর বদলে সেই pinned build-এর --help পড়ুন। নিজের notes-এ তারিখ লিখুন, যাতে সেগুলো কত পুরোনো হয়ে গেছে তা বুঝতে পারেন।

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