dsh plugin چیست و پیش از نصب چگونه بررسیاش کنیم؟
dsh plugin کد شخص دیگری را با مجوزهای agent شما اجرا میکند. ببینید پس از بارگذاری به چه فایلها و ابزارهایی دسترسی دارد و پیش از نصب چگونه بررسیاش کنید.
یک dsh plugin چیست و چه کاری میتواند انجام دهد؟
dsh pluginها، پکیجهای Node هستند که DeepSeek Harness آنها را در فرایند خودش بارگذاری میکند. پس از بارگذاری، یک plugin کد شخص دیگری را با مجوزهای agent شما و روی ماشینی اجرا میکند که agent شما از قبل میتواند به آن دسترسی داشته باشد. خود مرحله نصب کنترلشدهتر از این است. pnpm اسکریپتهای build وابستگیها را تا زمانی که آنها را تأیید نکنید متوقف میکند و مرجع CLI میگوید: «پس از افزودن، حذف یا بهروزرسانی یک Bundle، آن Profile را restart کنید»؛ بنابراین pluginای که با dsh plugin اضافه شده است، در restart بعدی بارگذاری میشود. pluginای که از صفحه Plugins در وب نصب شود، ممکن است بلافاصله اعمال شود. پس از بارگذاری plugin، هیچ مانعی میان آن و بخشهای دیگر harness وجود ندارد. بنابراین پیش از نصب باید بپرسید این کد به چه چیزهایی میتواند دسترسی داشته باشد و چگونه این دسترسی را محدود نگه میدارید.
dsh (DeepSeek Harness)، harness متنباز agent متعلق به DeepSeek AI است که بر یک framework مربوط به pluginها به نام Cordis ساخته شده است. واژه میانی در این تعریف اهمیت دارد، زیرا harness یک agent همان برنامهای است که پیرامون model قرار میگیرد و loop، ابزارها و مجوزها را در اختیار دارد؛ plugin نیز دقیقاً در همین سطح به آن متصل میشود. README خود پروژه میگوید همهچیز یک plugin است. adapter مربوط به model یک plugin است. رابط وبی که در آن تایپ میکنید نیز یک plugin است. هر چیزی که خارج از پروژه نصب کنید، در همان درخت و با همان سطح اعتماد بخشهایی قرار میگیرد که همراه پروژه عرضه شدهاند. اگر هنوز آن را راهاندازی نکردهاید، با DeepSeek Harness روی یک VPS شروع کنید و پیش از افزودن هر چیزی به آن، به این بخش برگردید.
در August 2026، AGENTS.md مخزن، نقاط گسترشی را که یک plugin میتوانست به آنها دسترسی داشته باشد فهرست میکرد. این نقاط شامل موارد زیر بودند:
- LLM (large language model): ارائهدهندهای که هزینه آن را با API key خود پرداخت میکنید
- Shell: قابلیت bash، با providerهای محلی و pwsh
- Filesystem: دسترسی به فایل تحت کنترل policy
- Web: providerهای search و fetch
- Subprocess: provider مربوط به درخت فرایند
- Workflow: threadهای worker
- Subagent: واگذاری کار به agentهای بیشتر
- Settings and credentials: پیکربندی ذخیرهشده و environment variableهای شما
این فهرست از آن زمان در AGENTS.md قرار ندارد. در 17 November 2026، docs/architecture.md پروژه بهجای آن نقاط گسترش را نام میبرد و backendهای sandbox، terminalهای پایدار، jobهای پسزمینه، commandهای انسانی و sessionهای فعالشده با webhook را نیز به بخشهای model، tool، shell، filesystem و subagent اضافه میکند.
یک plugin همچنین toolهایی را روی ctx.tools ثبت میکند و مستندات صراحتاً میگویند schema مربوط به یک tool ثبتشده به prompt assembly اضافه میشود. بخش دوم همان چیزی است که معمولاً نادیده گرفته میشود. یک plugin میتواند بر تصمیم agent شما درباره کاری که باید انجام دهد اثر بگذارد، بدون آنکه کد خودش رفتار غیرعادی داشته باشد؛ زیرا توضیحی که plugin اضافه میکند به متنی تبدیل میشود که model آن را میخواند. این مسئله همان ساختار prompt injection علیه coding agentها را دارد، با یک تفاوت: این متن هنگام نصب وارد میشود و تا زمان حذف plugin باقی میماند.
dsh چگونه pluginها را پیدا و بارگذاری میکند؟
هیچ دایرکتوری سراسری برای pluginها وجود ندارد. یک dsh در حال اجرا، در زمان boot از لایههای مرتبشده تشکیل میشود و واحدی که انتخابهای شما را نگه میدارد، profile است. $DSH_HOME بهصورت پیشفرض روی ~/.dsh قرار دارد و هر profile در $DSH_HOME/profiles/<name> قرار میگیرد. profileهای web و headless در نخستین استفاده، خودشان را از templateهای ارائهشده ایجاد میکنند.
یک دایرکتوری profile شامل 2 فایل است که همهچیز را تعیین میکنند:
package.json، شامل dependencyهای pluginهای خارج از درخت، بههمراه manifestِdsh.profileکه فهرست مرتبشدهٔbundlesرا نگه میداردcordis.patch.yml، لایهٔ patch اختصاصی شما روی آن bundleها
ls ~/.dsh
ls ~/.dsh/profiles/webدر زمان boot، لایهها به ترتیب زیر اعمال میشوند و لایههای بعدی اولویت دارند:
- یک root خالی
- bundleهای profile، به ترتیبی که manifest آنها را فهرست کرده است
cordis.patch.ymlمربوط به profile$DSH_HOME/cordis.patch.yml- هر overlay از نوع
--patch <path>که در خط فرمان ارسال شده باشد
2 flag نتیجهٔ این ترکیب را بدون شروع هیچ چیزی نمایش میدهند:
dsh --profile web --dump-default-config
dsh --profile web --dump-config--dump-default-config فقط لایههای bundle را نمایش میدهد. --dump-config لایههای patch مربوط به profile و home و همچنین هر overlay از نوع --patch را اضافه میکند؛ بنابراین نزدیکترین گزینه به inventory واقعی از چیزهایی است که boot بعدی شما بارگذاری خواهد کرد. پیش از اعتماد به ماشینی که تحویل گرفتهاید، آن را بخوانید.
دربارهٔ این فایلهای patch یک هشدار مهم وجود دارد. در اینجا config دادهای غیرفعال نیست، زیرا این قالب اجازه میدهد مقادیر tagشدهٔ !!js زیر block مربوط به config یک plugin قرار بگیرند. یک قطعهٔ cordis.patch.yml که از یک پست forum کپی شده باشد، code است؛ بنابراین با آن همانطور رفتار کنید که با یک shell script از همان منبع رفتار میکنید.
چه چیزی واقعاً توسط dsh plugin add اجرا میشود؟
dsh plugin --profile <name> <args> آرگومانهای خود را در دایرکتوری همان profile به pnpm ارسال میکند؛ بنابراین pnpm باید در PATH قرار داشته باشد. این فعلها همان فعلهای pnpm هستند:
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بنابراین، مدل امنیتی نصب یک plugin برای dsh همان مدل امنیتی نصب هر dependency به سبک npm است، با یک مرحله اضافی که طی آن نتیجه در agent شما load میشود. این package درخت dependency خود را به همراه دارد و هر package موجود در آن درخت در همان process اجرا میشود. تمام موارد مطرحشده در نحوه رسیدن حملههای زنجیره تأمین npm به یک سرور بدون هیچ تغییری در اینجا نیز صدق میکند.
در pnpm 10 و نسخههای بعدی، اسکریپتهای build وابستگیها بهطور پیشفرض اجرا نمیشوند و تأیید برای هر package از طریق pnpm approve-builds یا تنظیم allowBuilds انجام میشود. در pnpm 11، تنظیم قدیمی onlyBuiltDependencies با allowBuilds جایگزین شد؛ بنابراین guide یا config قدیمی که هنوز از onlyBuiltDependencies استفاده میکند، در نسخه فعلی pnpm هیچ packageای را تأیید نمیکند. نسخه pnpm نصبشده را بررسی کنید:
pnpm --versionاین مسئله را نخست در pluginهای میزبانیشده روی Git مشاهده میکنید. مرجع CLI میگوید pluginی که source آن را منتشر میکند، هنگام نصب و از طریق اسکریپت prepare ساخته میشود؛ بنابراین نخستین add با راهنمای allowBuilds در pnpm شکست میخورد. سپس key چاپشده را در pnpm-workspace.yaml مربوط به profile کپی میکنید و دوباره دستور را اجرا میکنید. تأیید این key اجازه میدهد build مخزن با مجوزهای کاربر شما اجرا شود. tarballهای ازپیشساخته و checkoutهای محلی به این اجازه نیاز ندارند.
این مقدار پیشفرض ارزش حفظکردن دارد و در عین حال، بیشازحد بهعنوان یک قابلیت ایمنی در این اکوسیستم تفسیر میشود. اسکریپتهای build مسدودشده مانع اجرای کد در زمان نصب میشوند. اما درباره خود plugin کاری انجام نمیدهند، چون اساساً plugin برای این است که harness پس از restart شدن profile، آن را import کند و فراخوانی کند؛ یا اگر از صفحه Plugins در وب استفاده کرده باشید، بهمحض اعمال نصب این کار را انجام دهد. یک plugin به hook از نوع postinstall نیاز ندارد. این plugin از ابتدا مجاز به ورود بوده است.
پیش از نصب یک افزونه dsh چه چیزی را باید مطالعه کرد
فایل tarball منتشرشده را دانلود کرده و آن را مطالعه کنید. با استخراج یک آرشیو، هیچ کدی اجرا نمیشود.
npm pack '<package-name>@<version>'
tar -tzf '<package-name>-<version>.tgz'
tar -xzf '<package-name>-<version>.tgz'
less package/package.jsonچهار فیلد در آن package.json، بیشتر اطلاعات مورد نیاز شما را در اختیارتان میگذارد. برای ورودیهای preinstall، install و postinstall، فایل scripts را مطالعه کنید. برای نامهایی که نمیشناسید یا نامهایی که تنها یک کاراکتر با نامهای آشنا تفاوت دارند، dependencies را بخوانید. برای هر چیزی که بسته در مسیر PATH شما نیاز دارد، bin را بررسی کنید. برای یافتن فایل ورودی، main یا exports را بخوانید، سپس آن فایل را باز کرده و محتوای آن را دنبال کنید.
سپس کدی که قرار است بارگذاری شود را مطالعه کنید. افزونهای که ابزار اعلان (notification) تبلیغ میکند، دلیلی ندارد که ~/.ssh را بخواند، با میزبانی که هرگز نامش را نشنیدهاید تماس بگیرد یا یک shell ایجاد کند. اگر بسته فقط شامل JavaScript باندلشده یا minified باشد و هیچ سورسکد مشابهی در مخزن عمومی وجود نداشته باشد، این خود پاسخ شماست. افزونههایی را ترجیح دهید که سورسکد آنها قابل خواندن است و افزونههای کوچکتر را در اولویت قرار دهید.
شما همچنین میتوانید بدون نصب هیچ چیزی، از registry پرسوجو کنید:
pnpm view '<package-name>' dependencies
pnpm view '<package-name>' versionsبستهای که هفته گذشته منتشر شده، تنها یک نسخه دارد، فیلد repository در آن خالی است و نامی دارد که مشابه یک ابزار محبوب است، قدیمیترین ترفند در هر registry محسوب میشود. تأیید دانلودها با استفاده از checksum عادتی است که باید در کنار این کار داشته باشید: پیش از آنکه اجازه دهید چیزی اجرا شود، دقیقاً بدانید چه چیزی دریافت کردهاید.
نسخه را ثابت (Pin) کنید و lockfile را نگه دارید
محدودهٔ نسخهٔ شناور (floating version range) به این معناست که کد داخل پردازش agent شما میتواند در هر نصب یا بهروزرسانی، بدون تصمیمگیری شما تغییر کند. آن را ثابت (Pin) کنید.
dsh plugin --profile web add --save-exact '<package-name>@<version>'محل قرارگیری flagها در نسخههای مختلف pnpm متفاوت است، بنابراین بهجای اعتماد به دستور، نتیجه را بررسی کنید. پس از آن package.json پروفایل را باز کنید و تأیید کنید که dependency بهصورت یک نسخهٔ خالص و بدون هیچ ^ یا ~ در ابتدای آن درج شده باشد. آن فایل تعیین میکند که چه چیزی نصب شود.
سپس lockfile را نگه دارید، که کل درخت transitive را به جای فقط نام سطح بالا، ثابت میکند:
find ~/.dsh -maxdepth 3 -name 'pnpm-lock.yaml'آن را به همراه package.json پروفایل در جایی که از آن نسخه پشتیبان تهیه میکنید، کپی کنید. این دو فایل، همان درخت را روی یک سیستم جدید بازسازی میکنند. زمانی که تصمیم به تغییر نسخهها گرفتید dsh plugin --profile web update را اجرا کنید، نه بهعنوان یک نظافت روتین، و پس از آن تفاوتهای lockfile را مطالعه کنید.
برای پلاگینی که بهجای registry از git نصب شده است، بهجای branch، commit را ثابت کنید. یک spec به فرم github:owner/repo#<full commit sha> به شما یک درخت ثابت میدهد. نام branch هر چیزی که آن branch در زمان resolve بعدی pnpm در خود داشته باشد را به شما میدهد، که تصمیمی است که آن را به شخص دیگری واگذار کردهاید. خودِ harness نیز به همین انضباط نیاز دارد، زیرا نسخهٔ latest در npm یک release candidate است و یک نصبِ ثابتنشده (unpinned) میتواند در هر روز به نسخهٔ متفاوتی resolve شود، که این همان منشأ اکثر خطاهای نصب و نسخه dsh است.
بازار plugin و ارزش «curated»
dsh یک marketplace دارد و این قابلیت بهصورت plugin نصب میشود؛ همین موضوع اطلاعاتی درباره معماری آن به شما میدهد:
dsh plugin --profile web add dshmarketپس از restart، این قابلیت در dsh 0.2.1 و نسخههای جدیدتر، در صفحه Plugins و در کنار Installed بهصورت یک tab نمایش داده میشود؛ در hostهای قدیمیتر باید به Settings و سپس Plugin Market بروید. README آن درباره محدودیتها صریح است. نصبها فقط به sourceهایی محدود میشوند که در یک registry curated فهرست شدهاند و هر مورد دیگری رد میشود. build scriptها بهطور پیشفرض مسدود هستند و فعالکردن هرکدام به تأیید جداگانه برای همان package نیاز دارد. pluginهای terminal پیش از ورود به یک web profile علامتگذاری میشوند. مهمترین جمله این است که قرارگرفتن در فهرست بهمعنای تأیید نیست، زیرا pluginها کد third-party هستند. همان README میگوید بیشتر pluginهایی که از این طریق نصب میشوند، پس از refresh صفحه و بدون restart فعال میشوند؛ بنابراین یک نصب one-click میتواند چند ثانیه بعد داخل agent شما در حال اجرا باشد.
یک فهرست curated حداقل سطح امنیت را بالاتر میبرد. اما کد را بهجای شما بررسی نمیکند و نمیتواند بگوید نسخه بعدی یک plugin، پس از تغییر مالکیت حساب maintainer، چه رفتاری خواهد داشت. با یک نصب one-click همانطور برخورد کنید که با curl | bash از همان author برخورد میکنید. تکرار یک خط دیگر از آن README نیز ارزش دارد: یک backup صادرشده ممکن است credentialهای موجود در profile config شما را شامل شود؛ بنابراین هرگز آن را به یک issue عمومی یا سایت paste پیوست نکنید. اگر بهجای روش، یک فهرست اولیه میخواهید، pluginهای dsh که ارزش نصب دارند پست مکمل این مطلب است.
harness اکنون route جداگانهای نیز دارد. یک Custom plugin آزمایشی که از bundleها index میگیرد و از صفحه Plugins فعال میشود، یک tab با نام Discover اضافه میکند که دادههای آن از index fileهایی تأمین میشود که خودتان اضافه میکنید. dsh هیچ index sourceای ارائه نمیکند و مستندات آن میگویند indexها محتوای third-party هستند و dsh قالب file را بررسی میکند، اما بررسی نمیکند که یک index درباره title، author یا source یک plugin چه ادعایی دارد.
اجرای dsh با کاربر اختصاصی، نه به عنوان root
بررسی دقیق (Vetting) احتمال نفوذ را کاهش میدهد. اصل حداقل دسترسی (Least privilege) تعیین میکند که در صورت نفوذ، چه چیزی در دسترس مهاجم قرار میگیرد. در یک VPS، پیادهسازی بخش دوم بسیار کمهزینه است.
برای این ابزار یک حساب کاربری یونیکس اختصاصی با دایرکتوری home مخصوص خودش ایجاد کنید و هرگز آن را با کاربر root اجرا نکنید:
sudo adduser --disabled-password --gecos "" dshrun
sudo -iu dshrunدر داخل آن نشست (session)، ابزار را طوری اجرا کنید که فایلهای خود را در دایرکتوری home همان کاربر بنویسد:
npx @deepseek-ai/dsh webرابط کاربری وب بهصورت پیشفرض روی http://127.0.0.1:3080 سرویسدهی میکند. آن را در همان وضعیت باقی بگذارید. اگر تا به حال روی آن لینک چاپشده از دستگاه دیگری کلیک کردهاید و پاسخی دریافت نکردهاید، معنای آدرسی که dsh چاپ میکند دلیل آن را توضیح میدهد. ساختار وب ارائهشده، هدرهای Host و Origin را بررسی میکند و برای هر متد Host RPC و استریم WebSocket به یک مرورگر احراز هویتشده یا API Peer نیاز دارد، و dsh web درخواستهای --host 0.0.0.0 را رد میکند. فراخوانهای API از طریق /connect احراز هویت میشوند و یک کوکی API امضاشده دریافت میکنند. به این ورود (login) به چشم یک قفل دوم نگاه کنید، نه دلیلی برای عمومی کردن پورت 3080. پشت این رابط، عاملی (agent) قرار دارد که به shell دسترسی دارد؛ بنابراین یک توکن نشست لو رفته یا یک باگ در ورود به سیستم روی یک پورت عمومی، یک shell از راه دور بدون دسترسی root اما با رابط کاربری کاربرپسند را به دست یک غریبه میسپارد. از طریق یک تونل SSH از لپتاپ خود به آن متصل شوید:
ssh -L 3080:127.0.0.1:3080 you@your-vpsسپس تأیید کنید که هیچ چیزی روی آدرس عمومی گوش نمیدهد:
ss -lnt | grep 3080آدرس محلی باید 127.0.0.1:3080 باشد. اگر 0.0.0.0:3080 را نشان میدهد، چیزی غیر از تنظیمات پیشفرض dsh web آن را در آنجا قرار داده است، مانند یک ترکیب (composition) متفاوت یا تغییر در پیکربندی، و آن ترکیب مسئولیت احراز هویت خود را بر عهده دارد. مستندات پروژه بیان میکنند که وبسرور زیرساختی هیچ احراز هویت یا سیاست Origin داخلی ندارد؛ بنابراین تا زمانی که نمیدانید چه چیزی از آن پورت محافظت میکند، فرض کنید فایروال تنها مانع بین یک غریبه و عامل شماست و آن را به loopback برگردانید. استدلالهای مربوط به اجرای ایمن Claude Code روی VPS بدون تغییر برای dsh نیز صدق میکند. به عامل یک دایرکتوری کاری بدهید که اجازه دارد آن را تخریب کند و هر چیزی را که نمیتوانید دوباره بسازید، از آن ماشین دور نگه دارید. حتی بهتر است با آن ماشین مانند یک VM یکبارمصرف برای عاملهای برنامهنویسی رفتار کنید، زیرا بازسازی یک VPS یک ساعت زمان میبرد، در حالی که حسابرسی آن یک هفته طول میکشد.
محل نگهداری کلیدها و محدودیتهای مجوز فایل
dsh کلیدهای API را در $DSH_HOME/.credentials.yaml و مقادیر محیطی را در $DSH_HOME/.env نگه میدارد و تنظیمات مدل نیز در cordis.patch.yml مربوط به profile فعال قرار دارد. هنگام بازبینی اولیه این راهنما در October 2026، $DSH_HOME/settings.yaml مربوط به یک release قدیمیتر یکبار import و سپس به settings.yaml.imported تغییر نام داده شد. اینکه کدام کلید باید در کدامیک از این فایلها قرار بگیرد و در هر mode چه چیزی واقعاً از سیستم خارج میشود، موضوع پیکربندی کلیدهای API، مدلها و endpointهای dsh است. بهتر است این موضوع را پیش از افزودن plugin مشخص کنید، زیرا هر کلیدی که در اختیار plugin قرار میدهید، مورد دیگری است که plugin میتواند بخواند. دو مورد حساس را محدود کنید:
chmod 600 ~/.dsh/.credentials.yaml ~/.dsh/.env
ls -l ~/.dshMode 600 به owner اجازه read و write میدهد و برای سایر کاربران هیچ مجوزی باقی نمیگذارد. دانستن این موضوع در هر دو نمایش نیز مفید است (modeهای عددی و نمادین chmod). درباره مزیتی که این کار ایجاد میکند، واقعبین باشید. File modeها از این فایلها در برابر accountهای دیگر روی سیستم محافظت میکنند. در برابر plugin هیچ محافظتی ایجاد نمیکنند، زیرا plugin با همان user مالک فایلها و داخل همان process که فایلها را میخواند اجرا میشود. به همین دلیل، دور نگهداشتن secretها از دسترس agent هوش مصنوعی یعنی اصلاً آنها را روی این machine قرار ندهید. یک box دارای dsh باید فقط همان model key موردنیاز خود را نگه دارد. credentialهای cloud و signing keyهای شما باید در محل دیگری قرار داشته باشند.
چرا افزونهای که وب را میخواند، مدل تهدید را تغییر میدهد
اتصال به وب، قابلیت جستجو و دریافت داده را برای افزونهها فراهم میکند. افزونهای که یک صفحه را به نشست شما وارد میکند، در واقع متنی را میخواند که یک مهاجم میتواند آن را بنویسد. مدلهای زبانی، دستورالعملها را از دادهها تفکیک نمیکنند؛ بنابراین یک صفحهٔ دریافتشده میتواند حاوی خطی خطاب به عامل (agent) شما باشد و ابزاری که قابلیت دسترسی به shell را دارد، تنها با یک گام مطیعانه آن را اجرا میکند.
کنترلهای لازم از قبل در harness وجود دارند. dsh-base، که اولین بستهٔ مشترک از پروفایلهای web، headless، sdk و acp است، sandbox و سیاست تأیید (approval policy) را ارائه میدهد (پروفایل sdk-minimal عمداً این مورد را حذف کرده است). از آن استفاده کنید. نشستی که میتواند صفحات غیرقابلاعتماد را دریافت کند، باید برای هر عملیاتی که منجر به نوشتن یا اجرا میشود، تأییدیه بخواهد تا یک دستورالعملِ دریافتشده نتواند بهتنهایی به یک اقدام تبدیل شود. محدود کردن اقدامات عامل با تأییدیهها توضیح میدهد که چگونه باید در مورد تعیین این مرز فکر کرد. این رابطه دوطرفه است؛ زیرا سرور خود شما نیز صفحهای است که عاملِ شخص دیگری آن را دریافت میکند، که این موضوع در مسدود کردن خزندههای هوش مصنوعی روی سرور شما بررسی شده است.
چگونه بررسی کنم یک plugin چه تغییراتی ایجاد کرده است؟
پیش از نصب snapshot بگیرید، plugin را نصب کنید، پس از نصب یک 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.txtdiff نشان میدهد نصب، کدام ورودیهای plugin را به درخت ترکیبشده اضافه کرده است. فقط packageای که یک bundle patch اعلام میکند به درخت میپیوندد؛ یک dependency معمولی چیزی به آن اضافه نمیکند و dsh یکبار درباره آن هشدار میدهد. اگر pluginای را برای یک قابلیت کوچک نصب کردهاید اما چندین ورودی اضافه میکند که نمیتوانید آنها را توضیح دهید، پیش از boot کردن آن باید متوقف شوید و source را بخوانید. dsh plugin --profile web why <package-name> به پرسش دیگر پاسخ میدهد: کدام dependency مستقیم شما یک package مشخص را وارد کرده است.
packageهای نصبشده در node_modules اختصاصی profile، در $DSH_HOME/profiles/<name>/node_modules قرار میگیرند؛ بنابراین میتوانید درخت را روی دیسک نیز بررسی کنید:
ls ~/.dsh/profiles/web/node_modulesیک profile دوم داشته باشید که هرگز در آن آزمایش نمیکنید. اگر یک install، harness را خراب کرد، boot کردن dsh --profile <clean-name> ظرف چند ثانیه مشخص میکند که آیا plugin باعث آن شده است یا نه.
چگونه یک افزونه dsh را حذف کنم؟
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) همیشه به معنای حذف پیکربندی نیست. ورودیهایی که در cordis.patch.yml پروفایل نوشته شدهاند، در جای خود باقی میمانند؛ زیرا آن فایل متعلق به شماست و ابزار مدیریت (harness) آن را برای شما بازنویسی نمیکند. فایل را باز کرده و هر بلوکی که نام بسته حذفشده را دارد، پاک کنید.
less ~/.dsh/profiles/web/cordis.patch.ymlسپس با بخشی مواجه شوید که هیچ دستور حذف (uninstall) نمیتواند آن را اصلاح کند. اگر افزونهای را به دلیل سلب اعتماد حذف کردهاید، هر آنچه که آن افزونه میتوانست بخواند، قبلاً خوانده شده است. کلید API مربوط به DeepSeek را در کنسول ارائهدهنده تغییر دهید (rotate) و هر چیز دیگری که در $DSH_HOME قرار داشت را نیز تغییر دهید. سپس بررسی کنید که حساب کاربری unix که افزونه با آن اجرا میشد، به چه بخشهایی از شبکه شما دسترسی داشته است.
نسخه کوتاه
- پیش از نصب، tarball منتشرشده را مطالعه کنید؛ از
scriptsو فایل ورودی شروع کنید. - نسخه دقیق یا commit دقیق برای مشخصات git را ثابت (pin) کنید و فایل lockfile را نگه دارید.
- نصب را در یک profile انجام دهید و همیشه یک profile تمیز داشته باشید تا در صورت بروز مشکل، بتوانید آن را بوت کنید.
- پیش و پس از هر نصب،
--dump-configرا با استفاده از diff مقایسه کنید. - harness را به عنوان یک کاربر unix مجزا، روی loopback و از طریق SSH اجرا کنید.
- تنها یک API key روی سیستم نگه دارید و در روزی که افزونهای را که دیگر به آن اعتماد ندارید حذف میکنید، آن را تغییر دهید (rotate).
هیچکدام از این موارد دلیلی برای اجتناب از افزونهها نیست. مدل افزونه همان چیزی است که dsh را مفید میکند و harnessای که نتوان آن را توسعه داد، harnessای است که در نهایت جایگزینش خواهید کرد. این موارد دلایلی هستند برای اینکه بدانید چه چیزی نصب کردهاید، از چه کسی، با چه نسخهای، و اینکه کل مجموعه را در جایی اجرا کنید که امکان بازسازی (rebuild) آن وجود داشته باشد.
FAQ
آیا dsh افزونهها را از یکدیگر sandbox میکند؟
خیر. یک افزونه از طریق Cordis در فرایند harness بارگذاری میشود و میتواند به نقاط دسترسی مستندشده، از جمله shell، filesystem، web، subprocess، subagent و credentials، دسترسی پیدا کند. dsh-base، یعنی bundle مشترک و اولیهٔ پروفایلهای web، headless، sdk و acp، sandbox و سیاست approval را که بر قابلیتهای ابزارهای agent حاکم است ارائه میکند و محافظت شما از همان سیاست ناشی میشود. هیچ مرز مجوز جداگانهای برای هر افزونه وجود ندارد؛ بنابراین مدل صادقانه این است که با نصب یک افزونه، به نویسندهٔ آن و همهٔ packageهای موجود در درخت وابستگی آن اعتماد میکنید.
آیا میتوانم یک افزونهٔ dsh را بدون اجرای install scriptهای آن نصب کنم؟
pnpm 10 و نسخههای بعدی بهطور پیشفرض build scriptهای dependencyها را مسدود میکنند و dsh plugin ... add درخواستها را به pnpm ارسال میکند؛ بنابراین در یک pnpm بهروز، install، scriptهای package را اجرا نمیکند مگر آنکه آن package را تأیید کنید. نسخهٔ خود را با pnpm --version بررسی کنید. این کار افزونهای را که source آن را نخواندهاید ایمن نمیکند. کد خود افزونه پس از بارگذاری harness اجرا میشود؛ این اتفاق پس از یک dsh plugin install، در restart بعدی profile رخ میدهد یا اغلب پس از نصب از صفحهٔ web Plugins بلافاصله آغاز میشود. هیچ محدودیت زمان نصب بر این مرحله تأثیری ندارد.
افزونهها و configuration مربوط به dsh واقعاً کجا قرار دارند؟
$DSH_HOME بهطور پیشفرض روی ~/.dsh تنظیم است. Profileها در $DSH_HOME/profiles/<name> قرار دارند. هر profile یک package.json دارد که dependencyهای افزونهٔ آن و همچنین manifest مربوط به bundleهای مرتبشدهٔ dsh.profile را نگه میدارد، بهعلاوهٔ یک لایهٔ patch در cordis.patch.yml. Packageهای نصبشده در node_modules اختصاصی هر profile و در مسیر $DSH_HOME/profiles/<name>/node_modules قرار میگیرند. Keyها در $DSH_HOME/.credentials.yaml، مقادیر environment در $DSH_HOME/.env و یک $DSH_HOME/cordis.patch.yml در سطح home قرار دارد که روی همهٔ profileها اعمال میشود. برای مشاهدهٔ نتیجهٔ ترکیبشده، بدون boot کردن، dsh --profile web --dump-config را اجرا کنید.
آیا نصب از بازار افزونهٔ dsh ایمن است؟
این بازار نصب را به sourceهای موجود در یک registry پالایششده محدود میکند و build scriptها را تا زمان تأیید جداگانهٔ هر package مسدود میسازد؛ این نسبت به چسباندن نام یک package از پنجرهٔ chat، بهبود واقعی محسوب میشود. بااینحال، README خود بازار همچنان تصریح میکند که فهرستشدن بهمعنای تأیید نیست، زیرا افزونهها codeهای third-party متعلق به افراد دیگر هستند. source را بخوانید و version را pin کنید. harness را روی یک user account و ترجیحاً یک machine اجرا کنید که توان از دست دادن آن را داشته باشید.