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

dsh plugin কীভাবে কাজ করে, ইনস্টলের আগে যাচাই করবেন কীভাবে

dsh plugin আপনার agent-এর permission নিয়ে একই process-এ code চালায়। install-এর আগে access যাচাই করুন, pnpm build script অনুমোদন বুঝুন এবং restart-এর নিয়ম দেখুন।

একটি dsh plugin কী এবং এটি কী করতে পারে?

dsh plugin হলো Node package, যা DeepSeek Harness নিজের process-এর মধ্যে load করে। Load হওয়ার পর plugin আপনার agent-এর permission ব্যবহার করে এমন code চালায়, যে machine-এ আপনার agent আগে থেকেই পৌঁছাতে পারে। তবে install করার ধাপটি এর চেয়ে বেশি নিয়ন্ত্রিত। pnpm dependency build script অনুমোদন না করা পর্যন্ত আটকে রাখে। CLI reference-এ বলা আছে, “Bundle যোগ, অপসারণ বা update করার পরে সেই Profile restart করুন।” তাই dsh plugin দিয়ে যোগ করা plugin পরবর্তী restart-এ load হয়। Web Plugins page থেকে install করা plugin সরাসরি কার্যকর হতে পারে। Load হওয়া plugin এবং harness-এর বাকি অংশের মধ্যে কোনো আলাদা isolation থাকে না। তাই কোনো plugin install করার আগে প্রশ্ন করুন, codeটি কোন resource-এ access করতে পারে এবং সেই access কীভাবে সীমিত রাখবেন।

dsh (DeepSeek Harness) হলো DeepSeek AI-এর open-source agent harness, যা Cordis নামের একটি plugin framework-এর ওপর তৈরি। এই মধ্যবর্তী অংশটিই গুরুত্বপূর্ণ। agent harness হলো model-এর চারপাশের program, যা loop, tools এবং permissions নিয়ন্ত্রণ করে। Plugin ঠিক এই স্তরেই যুক্ত হয়। Project-এর নিজের README-তে বলা হয়েছে, সবকিছুই plugin। Model adapter একটি plugin। আপনি যে web interface-এ লিখছেন, সেটিও একটি plugin। Project-এর বাইরে থেকে install করা যেকোনো কিছু একই tree-তে, project-এর সঙ্গে আসা অংশগুলোর সমান trust level-এ যুক্ত হয়। এখনো যদি এটি চালু না করে থাকেন, আগে একটি VPS-এ DeepSeek Harness চালু করুন। এরপর এতে কিছু যোগ করার আগে এখানে ফিরে আসুন।

August 2026-এ repository-এর AGENTS.md এমন extension point-এর তালিকা দিয়েছিল, যেখানে plugin পৌঁছাতে পারে। তালিকায় ছিল:

  • LLM (large language model): আপনার API key যে provider-এর জন্য অর্থ পরিশোধ করে
  • Shell: local এবং pwsh provider-সহ bash capability
  • Filesystem: policy-controlled file access
  • Web: search এবং fetch provider
  • Subprocess: process-tree provider
  • Workflow: worker thread
  • Subagent: আরও agent-এর কাছে delegation
  • Settings এবং credentials: আপনার সংরক্ষিত configuration এবং environment variable

এই তালিকাটি পরে AGENTS.md থেকে সরিয়ে নেওয়া হয়েছে। 17 November 2026 অনুযায়ী project-এর docs/architecture.md এখন extension point-গুলোর অন্য নাম ব্যবহার করে। সেখানে model, tool, shell, filesystem এবং subagent seam-এর সঙ্গে sandbox backend, persistent terminal, background job, human command এবং webhook-triggered session-ও যোগ করা হয়েছে।

একটি plugin ctx.tools-এ tool-ও register করে। Documentation-এ স্পষ্টভাবে বলা আছে, registered tool-এর schema prompt assembly-তে যুক্ত হয়। এই দ্বিতীয় অংশটিই অনেকে উপেক্ষা করেন। Plugin নিজের code-এ অস্বাভাবিক কিছু না করেও আপনার agent কী করার সিদ্ধান্ত নেবে তা বদলাতে পারে। কারণ plugin যে description যোগ করে, model সেই description text হিসেবে পড়ে। সমস্যাটির ধরন coding agent-এর বিরুদ্ধে prompt injection-এর মতো। পার্থক্য হলো, এই text install করার সময় আসে এবং plugin remove না করা পর্যন্ত থেকে যায়।

dsh কীভাবে plugin খুঁজে পায় এবং লোড করে?

কোনো global plugin directory নেই। চালু থাকা dsh হলো ordered layer থেকে boot-এর সময় তৈরি করা একটি plugin tree। আপনার পছন্দগুলো যে unit-এ থাকে, সেটি হলো profile। $DSH_HOME-এর default হলো ~/.dsh, এবং প্রতিটি profile $DSH_HOME/profiles/<name>-এ থাকে। web এবং headless profile প্রথমবার ব্যবহার করার সময় shipped template থেকে নিজেদের তৈরি করে।

একটি profile directory-তে দুটি file থাকে। এগুলোই পুরো composition নির্ধারণ করে:

  • package.json, যাতে out-of-tree plugin dependency এবং ordered bundles list-সহ একটি dsh.profile manifest থাকে
  • cordis.patch.yml, যা ওই bundle-এর ওপর আপনার নিজস্ব patch layer
ls ~/.dsh
ls ~/.dsh/profiles/web

Boot এই ক্রমে layer প্রয়োগ করে। পরে আসা layer আগের layer-কে অগ্রাধিকার দেয়:

  1. একটি খালি root
  2. manifest-এ দেওয়া ক্রম অনুযায়ী profile-এর bundle
  3. profile-এর cordis.patch.yml
  4. $DSH_HOME/cordis.patch.yml
  5. command line-এ দেওয়া যেকোনো --patch <path> overlay

দুটি flag কোনো কিছু start না করেই এই composition-এর ফল দেখায়:

dsh --profile web --dump-default-config
dsh --profile web --dump-config

--dump-default-config শুধু bundle layer দেখায়। --dump-config profile ও home patch layer এবং যেকোনো --patch overlay যোগ করে। তাই পরবর্তী boot-এ কী load হবে, তার সবচেয়ে নির্ভরযোগ্য inventory এটি। উত্তরাধিকারসূত্রে পাওয়া কোনো machine-কে বিশ্বাস করার আগে এটি পড়ুন।

এই patch file-গুলো সম্পর্কে একটি সতর্কতা আছে। এখানে Config নিষ্ক্রিয় data নয়, কারণ format-টি plugin-এর config block-এর অধীনে !!js tagged value অনুমোদন করে। কোনো forum post থেকে কপি করা cordis.patch.yml snippet আসলে code। তাই একই source থেকে পাওয়া shell script যেভাবে বিবেচনা করতেন, এটিকেও সেভাবেই বিবেচনা করুন।

dsh plugin add আসলে কী চালায়?

dsh plugin --profile <name> <args> তার আর্গুমেন্টগুলো ওই profile-এর directory-র ভিতরে pnpm-এ পাঠায়। তাই pnpm-কে PATH-এ থাকতে হবে। ব্যবহৃত verb-গুলো pnpm-এর verb:

dsh plugin --profile web add '<package-or-git-spec>'
dsh plugin --profile web remove '<package-name>'
dsh plugin --profile web why '<package-name>'
dsh plugin --profile web update

তাই dsh plugin ইনস্টল করার security model হলো যেকোনো npm-style dependency ইনস্টল করার security model, এর সঙ্গে আরও একটি ধাপ যুক্ত হয়: ফলাফলটি আপনার agent-এ load করা হয়। Package-টি নিজের dependency tree নিয়ে আসে, এবং ওই tree-র প্রতিটি package একই process-এর মধ্যে চলে। npm supply chain attack কীভাবে server-এ পৌঁছায়-সংক্রান্ত সবকিছু এখানে কোনো পরিবর্তন ছাড়াই প্রযোজ্য।

pnpm 10 এবং পরবর্তী version-গুলোতে dependency-র build script default হিসেবে চালানো হয় না। pnpm approve-builds অথবা allowBuilds setting-এর মাধ্যমে প্রতি package আলাদাভাবে অনুমোদন দিতে হয়। pnpm 11 পুরোনো onlyBuiltDependencies setting-কে allowBuilds দিয়ে প্রতিস্থাপন করেছে। তাই কোনো guide বা পুরোনো config-এ এখনও onlyBuiltDependencies ব্যবহার করা থাকলে বর্তমান pnpm-এ তা কোনো কিছু অনুমোদন করে না। আপনার কাছে কোন pnpm আছে তা পরীক্ষা করুন:

pnpm --version

Git-hosted plugin-এ প্রথমে এই বিষয়টির মুখোমুখি হবেন। CLI reference অনুযায়ী, source-সহ ship করা কোনো git plugin তার prepare script-এর মাধ্যমে install-এর সময় build হয়। তাই প্রথম add pnpm-এর allowBuilds hint-সহ ব্যর্থ হয়। তারপর প্রদর্শিত key-টি profile-এর pnpm-workspace.yaml-এ কপি করে আবার চালান। ওই key অনুমোদন করলে repository-র build আপনার user permissions নিয়ে চলবে। Built tarball এবং local checkout-এর জন্য কোনো অনুমোদন প্রয়োজন হয় না।

এই default থাকা উপযোগী। তবে ecosystem-এ এটিই সবচেয়ে বেশি ভুলভাবে বোঝা safety feature। Blocked build script install-এর সময় code চলা বন্ধ করে। কিন্তু plugin নিজে চলা বন্ধ করে না। কারণ plugin-এর মূল কাজই হলো profile restart হওয়ার পরে harness সেটিকে import করে call করবে, অথবা web Plugins page ব্যবহার করলে install প্রয়োগ হওয়ার সঙ্গে সঙ্গে call করবে। কোনো plugin-এর postinstall hook থাকা প্রয়োজন নেই। আপনি সেটিকে নিজেই অনুমতি দিয়ে যুক্ত করেছেন।

dsh plugin ইনস্টল করার আগে যা পড়বেন

প্রকাশিত tarball ডাউনলোড করে সেটি পড়ুন। কোনো archive unpack করলে কিছুই execute হয় না।

npm pack '<package-name>@<version>'
tar -tzf '<package-name>-<version>.tgz'
tar -xzf '<package-name>-<version>.tgz'
less package/package.json

ওই package.json-এর চারটি field থেকেই প্রয়োজনীয় অধিকাংশ তথ্য পাওয়া যায়। scripts পড়ে preinstall, install এবং postinstall entry দেখুন। যেসব নাম আপনি চেনেন না, অথবা পরিচিত নামের সঙ্গে মাত্র একটি অক্ষরের পার্থক্য আছে, সেগুলোর জন্য dependencies পড়ুন। package আপনার PATH-এ কী রাখতে চায়, তা জানতে bin পড়ুন। entry file-এর জন্য main বা exports পড়ুন। তারপর ওই file খুলে তার অনুসরণ করুন।

এরপর যে code বাস্তবে load হবে, সেটি পড়ুন। notification tool হিসেবে পরিচয় দেওয়া কোনো plugin-এর ~/.ssh পড়ার, আপনার অচেনা কোনো host-এ সংযোগ করার বা shell চালু করার কারণ নেই। package-এ যদি শুধু bundled বা minified JavaScript থাকে এবং public repository-তে মিলে যায় এমন source না থাকে, তাহলে সেটিই আপনার উত্তর। যেসব plugin-এর source আপনি পড়তে পারেন, সেগুলো অগ্রাধিকার দিন। ছোট plugin-ও অগ্রাধিকার দিন।

কিছু ইনস্টল না করেও registry যাচাই করতে পারেন:

pnpm view '<package-name>' dependencies
pnpm view '<package-name>' versions

গত সপ্তাহে প্রকাশিত, মাত্র একটি version থাকা, repository field না থাকা এবং জনপ্রিয় কোনো নামের অনুকরণ করা নামের package যেকোনো registry-র পুরোনো কৌশল। checksum দিয়ে download যাচাই করা পাশের অভ্যাস: কোনো কিছু run করার আগে ঠিক কী fetch করেছেন, তা নিশ্চিতভাবে জানুন।

ভার্সন pin করুন এবং lockfile সংরক্ষণ করুন

একটি floating version range থাকলে আপনার agent process-এর ভেতরের code আপনার সিদ্ধান্ত ছাড়াই যেকোনো install বা update-এর সময় পরিবর্তিত হতে পারে। তাই version pin করুন।

dsh plugin --profile web add --save-exact '<package-name>@<version>'

pnpm-এর বিভিন্ন version-এ flag বসানোর নিয়ম আলাদা হতে পারে। তাই command-এর ওপর অন্ধভাবে নির্ভর না করে ফলাফল পরীক্ষা করুন। এরপর profile-এর package.json খুলে নিশ্চিত করুন, dependency-তে শুধু bare version আছে এবং তার আগে কোনো ^ বা ~ নেই। কোন জিনিস install হবে, সেই সিদ্ধান্ত এই file-ই নির্ধারণ করে।

এরপর lockfile সংরক্ষণ করুন। এটি শুধু top-level name নয়, সম্পূর্ণ transitive tree pin করে:

find ~/.dsh -maxdepth 3 -name 'pnpm-lock.yaml'

এটি এমন কোনো backup location-এ copy করুন যেখানে নিয়মিত backup নেওয়া হয়। Profile-এর package.json-ও সঙ্গে রাখুন। নতুন box-এ একই tree পুনর্নির্মাণ করতে এই দুইটি file প্রয়োজন। Version পরিবর্তনের সিদ্ধান্ত নেওয়ার পর dsh plugin --profile web update চালান। নিয়মিত tidying-এর জন্য এটি কখনো চালাবেন না। এরপর lockfile diff পরীক্ষা করুন।

Registry-এর বদলে git থেকে install করা plugin-এর ক্ষেত্রে branch নয়, commit pin করুন। github:owner/repo#<full commit sha>-এর মতো spec ব্যবহার করলে একটি নির্দিষ্ট tree পাওয়া যায়। Branch name ব্যবহার করলে পরেরবার pnpm এটি resolve করার সময় ওই branch-এ থাকা যেকোনো content পাওয়া যাবে। এর অর্থ, version নির্বাচনের সিদ্ধান্ত আপনি অন্য কারও হাতে ছেড়ে দিচ্ছেন। Harness-এর ক্ষেত্রেও একই নিয়ম প্রযোজ্য, কারণ npm latest release একটি release candidate। Pin না করা install-এ যেকোনো দিনে ভিন্ন release resolve হতে পারে। অধিকাংশ dsh install ও version error এর কারণ এটাই।

প্লাগইন মার্কেট, এবং “curated” হওয়ার মূল্য

dsh-এর একটি marketplace আছে, এবং এটি একটি plugin হিসেবে ইনস্টল হয়। এ থেকে architecture সম্পর্কে একটি ধারণা পাওয়া যায়:

dsh plugin --profile web add dshmarket

restart-এর পরে এটি Plugins page-এ Installed-এর পাশে একটি tab হিসেবে দেখা যায়, dsh 0.2.1 এবং পরবর্তী সংস্করণে। পুরোনো host-গুলোতে Settings, তারপর Plugin Market ব্যবহার করতে হয়। এর README সীমাবদ্ধতাগুলো স্পষ্টভাবে উল্লেখ করে। Install কেবল curated registry-তে তালিকাভুক্ত source থেকে করা যায়। অন্য সব source প্রত্যাখ্যাত হয়। Build script ডিফল্টভাবে blocked থাকে। কোনো package-এর জন্য এটি enable করতে হলে আলাদা approval প্রয়োজন। Web profile-এ যোগ করার আগে terminal plugin-গুলো flag করা হয়। সবচেয়ে গুরুত্বপূর্ণ বক্তব্য হলো, তালিকাভুক্ত হওয়া endorsement নয়, কারণ plugin-গুলো third-party code। একই README-তে বলা হয়েছে, এর মাধ্যমে install করা অধিকাংশ plugin page refresh করার পরেই চালু হয়ে যায়, restart লাগে না। তাই one-click install করার কয়েক সেকেন্ডের মধ্যেই সেটি আপনার agent-এর ভিতরে চলতে পারে।

একটি curated তালিকা ন্যূনতম নিরাপত্তার মান বাড়ায়। তবে এটি আপনার হয়ে code পড়ে না। Maintainer account-এর মালিকানা বদলানোর পর plugin-এর পরবর্তী version কী করবে, সেটিও এটি জানাতে পারে না। One-click install-কে একই author-এর curl | bash-এর মতো সতর্কতার সঙ্গে বিবেচনা করুন। ওই README-এর আরেকটি বক্তব্য পুনরায় উল্লেখ করা দরকার: exported backup-এ আপনার profile config-এর credentials থাকতে পারে। তাই এটি কখনো public issue বা paste site-এ attach করবেন না। পদ্ধতির বদলে শুরু করার জন্য একটি তালিকা চাইলে, ইনস্টল করার মতো dsh plugin এই লেখার companion post।

Harness-এ এখন নিজস্ব একটি route-ও আছে। Plugins page থেকে চালু করা experimental Custom plugin indexes bundle নিজে যোগ করা index file-গুলো থেকে একটি Discover tab তৈরি করে। dsh কোনো index source সরবরাহ করে না। এর documentation-এ বলা হয়েছে, index-গুলো third-party content। dsh file format যাচাই করে, কিন্তু কোনো index plugin-এর title, author বা source সম্পর্কে যে দাবি করে তা যাচাই করে না।

dsh-কে root হিসেবে নয়, নিজস্ব user হিসেবে চালান

যাচাই-বাছাই করলে ক্ষতিকর কিছু ঢোকার সম্ভাবনা কমে। ঢুকে পড়লে সেটি কী পর্যন্ত পৌঁছাতে পারবে, তা নির্ধারণ করে least privilege। VPS-এ এই দ্বিতীয় সুরক্ষা ব্যবস্থা তৈরি করা সহজ।

harness-এর জন্য আলাদা Unix account এবং আলাদা home তৈরি করুন। এটি কখনো root হিসেবে চালাবেন না:

sudo adduser --disabled-password --gecos "" dshrun
sudo -iu dshrun

সেই session-এর ভিতরে harness চালান, যাতে এটি ওই account-এর home directory ব্যবহার করে:

npx @deepseek-ai/dsh web

ডিফল্টভাবে web UI http://127.0.0.1:3080-এ চালু হয়। এটিই রাখুন। অন্য কোনো machine থেকে কখনো মুদ্রিত link-এ click করে কোনো response না পেয়ে থাকলে, dsh ওই address দেখালে তার অর্থ কী তা ব্যাখ্যা করে। সরবরাহ করা web composition Host এবং Origin header যাচাই করে। প্রতিটি Host RPC method এবং WebSocket stream-এর জন্য authenticated browser অথবা API Peer আবশ্যক। এছাড়া dsh web, --host 0.0.0.0 প্রত্যাখ্যান করে। API caller-রা /connect-এর মাধ্যমে authenticate করে এবং signed API cookie পায়। ওই login-কে দ্বিতীয় lock হিসেবে বিবেচনা করুন; 3080 public করার কারণ হিসেবে নয়। এর পেছনে shell-সহ একটি agent থাকে। তাই public port-এ session token ফাঁস হলে বা login-এর bug থাকলে, একজন অপরিচিত ব্যক্তি friendly interface ব্যবহার করে root ছাড়া remote shell পেয়ে যেতে পারে। এর পরিবর্তে SSH tunnel ব্যবহার করে laptop থেকে এতে পৌঁছান:

ssh -L 3080:127.0.0.1:3080 you@your-vps

এরপর নিশ্চিত করুন যে কোনো public address-এ কিছু listening করছে না:

ss -lnt | grep 3080

স্থানীয় address-টি 127.0.0.1:3080 হওয়া উচিত। যদি এটি 0.0.0.0:3080 দেখায়, তবে সরবরাহ করা dsh web default ছাড়া অন্য কিছু সেটি নির্ধারণ করেছে। উদাহরণ হিসেবে, অন্য কোনো composition অথবা configuration পরিবর্তন এর কারণ হতে পারে। সেই composition-এর নিজস্ব authentication ব্যবস্থা থাকে। প্রকল্পের documentation অনুযায়ী, অন্তর্নিহিত web server নিজস্ব authentication বা Origin policy দেয় না। তাই ওই port কীভাবে সুরক্ষিত তা জানা না পর্যন্ত ধরে নিন, আপনার firewall-ই একজন অপরিচিত ব্যক্তি এবং agent-এর মধ্যে একমাত্র বাধা। port-টি loopback-এ ফিরিয়ে নিন। VPS-এ Claude Code নিরাপদে চালানোর পেছনের যুক্তি dsh-এর ক্ষেত্রেও একইভাবে প্রযোজ্য। agent-কে নষ্ট করার অনুমতি আছে এমন একটি workspace directory দিন। যা পুনর্নির্মাণ করা যায় না, তা ওই machine-এ রাখবেন না। আরও ভালো হলো, machine-টিকে coding agent-এর জন্য disposable VM হিসেবে বিবেচনা করা। কারণ VPS পুনর্নির্মাণ করতে এক ঘণ্টা লাগে, কিন্তু সেটি audit করতে এক সপ্তাহ লাগে।

আপনার key কোথায় থাকে এবং file permission কেন সীমিত সুরক্ষা দেয়

dsh API key রাখে $DSH_HOME/.credentials.yaml-এ এবং environment value রাখে $DSH_HOME/.env-এ। সক্রিয় profile-এর model setting থাকে cordis.patch.yml-এ। এই guide-টি October 2026-এ প্রথম যাচাই করার সময়, আগের release-এর $DSH_HOME/settings.yaml একবার import করে settings.yaml.imported নামে রাখা হয়েছিল। এই file-গুলোর কোনটিতে কোন key থাকবে এবং প্রতিটি mode-এ আসলে কোন তথ্য machine-এর বাইরে যায়, তা dsh-এর API key, model এবং endpoint configure করা-এ ব্যাখ্যা করা হয়েছে। Plugin যোগ করার আগে বিষয়টি নির্ধারণ করা উচিত, কারণ আপনি যে প্রতিটি key configure করবেন, plugin সেটি পড়তে পারবে। সংবেদনশীল দুইটি file-এর permission সীমিত করুন:

chmod 600 ~/.dsh/.credentials.yaml ~/.dsh/.env
ls -l ~/.dsh

Mode 600 owner-কে read ও write করার অনুমতি দেয় এবং অন্য সবাইকে কোনো অনুমতি দেয় না। দুই ধরনের notation-এই এটি জানা দরকার (numeric ও symbolic chmod mode-এর তুলনা)। তবে এটি কী সুরক্ষা দেয়, সে বিষয়ে বাস্তবসম্মত থাকুন। File mode ওই machine-এর অন্য account থেকে file-গুলোকে সুরক্ষিত রাখে। Plugin-এর বিরুদ্ধে এটি কোনো সুরক্ষা দেয় না, কারণ plugin file-গুলোর owner user হিসেবেই এবং সেগুলো read করা process-এর ভেতরেই চলে। তাই AI agent-এর নাগালের বাইরে secret রাখা বলতে secret machine-এ না রাখাকে বোঝায়। dsh machine-এ তার প্রয়োজনীয় একটিমাত্র model key থাকা উচিত। আপনার cloud credential এবং signing key অন্য কোথাও রাখা উচিত।

ওয়েব পড়ে এমন একটি plugin কেন threat model পরিবর্তন করে

Web seam plugin-কে search ও fetch provider দেয়। কোনো plugin আপনার session-এ একটি page আনলে, সেটি এমন text-ও আনতে পারে যা attacker লিখতে পারে। Model prompt instruction ও data আলাদা করে না। তাই fetch করা page-এ আপনার agent-কে উদ্দেশ্য করে লেখা কোনো line থাকতে পারে। আর shell capability থাকা harness সেটি মেনে নিয়ে চালানোর মাত্র এক ধাপ দূরে থাকে।

এই control harness-এই আগে থেকে আছে। dsh-base, অর্থাৎ web, headless, sdk এবং acp profile-এর shared first bundle, sandbox ও approval policy সরবরাহ করে; sdk-minimal profile ইচ্ছাকৃতভাবে এটি বাদ দেয়। এটি ব্যবহার করুন। যে session untrusted page fetch করতে পারে, সেখানে write বা execute করে এমন যেকোনো কাজের জন্য approval আবশ্যক করা উচিত। এতে fetch করা instruction নিজে থেকে action-এ পরিণত হতে পারে না। agent action-এর পেছনে approval বসানো অংশে এই সীমারেখা কোথায় টানবেন, তা ব্যাখ্যা করা হয়েছে। সম্পর্কটি উভয় দিকেই প্রযোজ্য। কারণ আপনার নিজের server-ও এমন একটি page, যা অন্য কারও agent fetch করবে। এটাই আপনার server-এ AI crawler block করা-র প্রাসঙ্গিকতা।

কোনো plugin কী পরিবর্তন করেছে তা কীভাবে পরীক্ষা করব?

ইনস্টলের আগে snapshot নিন, তারপর plugin ইনস্টল করুন, আবার snapshot নিন। এরপর দুই snapshot-এর পার্থক্য দেখুন।

dsh --profile web --dump-config > /tmp/dsh-before.txt
dsh plugin --profile web add '<package-name>@<version>'
dsh --profile web --dump-config > /tmp/dsh-after.txt
diff -u /tmp/dsh-before.txt /tmp/dsh-after.txt

diff দেখায়, install-এর সময় কোন plugin entry composed tree-তে যোগ হয়েছে। শুধু যে package bundle patch ঘোষণা করে, সেটিই tree-তে যুক্ত হয়; সাধারণ dependency সেখানে কিছু যোগ করে না, এবং dsh এ বিষয়ে একবার সতর্ক করে। একটি ছোট feature-এর জন্য ইনস্টল করা plugin যদি এমন একাধিক entry যোগ করে যার কারণ আপনি ব্যাখ্যা করতে না পারেন, তাহলে সেটি চালু করার আগে থেমে source পড়ুন। dsh plugin --profile web why <package-name> অন্য প্রশ্নটির উত্তর দেয়: আপনার সরাসরি dependency-গুলোর কোনটি নির্দিষ্ট একটি package টেনে এনেছে।

ইনস্টল করা package profile-এর নিজস্ব node_modules-এ, $DSH_HOME/profiles/<name>/node_modules-এ সংরক্ষিত হয়। তাই disk-এ থাকা tree-ও দেখতে পারেন:

ls ~/.dsh/profiles/web/node_modules

এমন একটি দ্বিতীয় profile রাখুন, যেখানে কখনো পরীক্ষা চালাবেন না। কোনো install harness নষ্ট করলে dsh --profile <clean-name> boot করলেই কয়েক সেকেন্ডের মধ্যে বোঝা যাবে plugin-টি এর কারণ কি না।

কীভাবে একটি dsh plugin সরাব?

dsh plugin --profile web remove '<package-name>'
dsh --profile web --dump-config > /tmp/dsh-after-removal.txt
diff -u /tmp/dsh-before.txt /tmp/dsh-after-removal.txt

Dependency সরালেই configuration সব সময় সরানো হয় না। Profile-এর cordis.patch.yml-এ লেখা entry-গুলো সেখানেই থাকে, কারণ ওই file আপনার এবং harness এটি আপনার হয়ে rewrite করবে না। File-টি খুলে যে package সরিয়েছেন, তার নাম থাকা যেকোনো block মুছে দিন।

less ~/.dsh/profiles/web/cordis.patch.yml

এরপর সেই অংশটি সামলান, যা কোনো uninstall command ঠিক করতে পারে না। কোনো plugin-কে আর বিশ্বাস না করার কারণে সরিয়ে থাকলে, সেটি যা পড়তে পারত তার সবই ইতিমধ্যে পড়ে থাকতে পারে। Provider console-এ DeepSeek API key rotate করুন। $DSH_HOME-এ থাকা অন্য সব credential-ও rotate করুন। এরপর plugin-টি যে unix account হিসেবে চলত, সেটি আপনার network-এর বাকি অংশে কোন কোন resource-এ পৌঁছাতে পারত তা নির্ধারণ করুন।

সংক্ষেপে

  • ইনস্টলের আগে প্রকাশিত tarball পড়ুন। scripts এবং entry file থেকে শুরু করুন।
  • নির্দিষ্ট version pin করুন। git spec হলে নির্দিষ্ট commit pin করুন এবং lockfile সংরক্ষণ করুন।
  • একটি profile-এ ইনস্টল করুন। কিছু নষ্ট হলে boot করতে পারবেন এমন একটি পরিষ্কার profile রাখুন।
  • প্রতিটি ইনস্টলের আগে ও পরে --dump-config-এর diff দেখুন।
  • harness-টি নিজস্ব unix user হিসেবে loopback-এ চালান এবং SSH-এর মাধ্যমে এতে সংযোগ করুন।
  • সার্ভারে একটি API key রাখুন। আর যে plugin-এর ওপর আর আস্থা নেই, সেটি সরানোর দিন key rotate করুন।

এগুলোর কোনোটিই plugin এড়িয়ে চলার কারণ নয়। plugin model-এর কারণেই dsh কার্যকর, আর যে harness প্রসারিত করা যায় না, সেটি আপনি বদলে ফেলবেন। আসল বিষয় হলো আপনি কী ইনস্টল করেছেন, কার কাছ থেকে নিয়েছেন এবং কোন version ব্যবহার করছেন তা জানা। পুরো ব্যবস্থা এমন জায়গায় চালান, যেখানে প্রয়োজনে পুনর্নির্মাণ করতে পারবেন।

FAQ

dsh কি প্লাগইনগুলোকে একে অপরের থেকে sandbox করে?

না। Cordis-এর মাধ্যমে একটি প্লাগইন harness process-এ লোড হয় এবং shell, filesystem, web, subprocess, subagent ও credentials-সহ নথিভুক্ত capability seam-এ পৌঁছাতে পারে। dsh-base হলো web, headless, sdk এবং acp profile-এর অভিন্ন প্রথম bundle। এটি agent-এর tool-গুলো কী করতে পারবে তা নিয়ন্ত্রণকারী sandbox ও approval policy সরবরাহ করে। আপনার সুরক্ষা এই policy থেকেই আসে। প্রতি প্লাগইনের জন্য আলাদা permission boundary নেই। তাই বাস্তবসম্মত মডেল হলো, একটি প্লাগইন ইনস্টল করলে আপনি তার লেখক এবং dependency tree-এর প্রতিটি package-এর ওপরও আস্থা রাখছেন।

install script না চালিয়ে কি dsh প্লাগইন ইনস্টল করা যায়?

pnpm 10 এবং পরবর্তী সংস্করণগুলো ডিফল্টভাবে dependency build script ব্লক করে। dsh plugin ... add pnpm-এ forward করে। তাই বর্তমান pnpm-এ কোনো package অনুমোদন না করা পর্যন্ত install package script চালায় না। pnpm --version দিয়ে আপনার version নিশ্চিত করুন। এতে unread plugin নিরাপদ হয়ে যায় না। harness প্লাগইনটি লোড করার পর তার নিজস্ব code চলে। dsh plugin install-এর পরে পরবর্তী profile restart-এ এটি ঘটে, অথবা web Plugins page থেকে install করার পরে অনেক সময় সরাসরি ঘটে। install-time কোনো restriction এই execution-কে প্রভাবিত করে না।

dsh প্লাগইন এবং তাদের config আসলে কোথায় থাকে?

$DSH_HOME-এর ডিফল্ট মান হলো ~/.dsh। Profile-গুলো $DSH_HOME/profiles/<name>-এ থাকে। প্রতিটিতে plugin dependency-সহ একটি package.json, ক্রমানুসারে সাজানো bundle-এর dsh.profile manifest এবং একটি cordis.patch.yml patch layer থাকে। Installed package প্রতিটি profile-এর নিজস্ব node_modules-এ, $DSH_HOME/profiles/<name>/node_modules-এ থাকে। Key থাকে $DSH_HOME/.credentials.yaml-এ। Environment value থাকে $DSH_HOME/.env-এ। Home-level $DSH_HOME/cordis.patch.yml প্রতিটি profile-এর ওপর প্রয়োগ হয়। boot না করে composed result দেখতে dsh --profile web --dump-config চালান।

dsh plugin market থেকে ইনস্টল করা কি নিরাপদ?

Market curated registry-তে থাকা source-এ install সীমাবদ্ধ রাখে এবং package-ভিত্তিক অনুমোদন না দেওয়া পর্যন্ত build script ব্লক করে। এটি chat window থেকে কোনো package name কপি করে install করার তুলনায় বাস্তব উন্নতি। তবে market-এর নিজস্ব README-তেও বলা আছে যে listing endorsement নয়। কারণ প্লাগইনগুলো অন্য ব্যক্তিদের লেখা third-party code। Source পড়ুন এবং version pin করুন। এমন user account এবং সম্ভব হলে এমন machine-এ harness চালান, যেগুলো হারালেও আপনি সামলাতে পারবেন।

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