SSD Nodes Learn Hosting plans →
الأدلة Matt Connorبقلم Matt Connor

إضافات dsh: كيف تعمل وكيف تفحصها قبل التثبيت

إضافة dsh تشغّل كود طرف آخر داخل وكيلك وبصلاحياته. تعرّف إلى ما يمكنها الوصول إليه، ولماذا يُحمّل بعضها بعد إعادة تشغيل Profile، وكيف تفحصها قبل التثبيت.

ما هو مكوّن dsh الإضافي، وما الذي يمكنه فعله؟

مكوّنات dsh الإضافية هي حزم Node يحمّلها DeepSeek Harness داخل عمليته الخاصة. بعد تحميل المكوّن، يشغّل كوداً كتبه طرف آخر باستخدام صلاحيات وكيلك، وعلى الجهاز الذي يستطيع وكيلك الوصول إليه أصلاً. لكن خطوة التثبيت نفسها تخضع لقيود أكبر. يمنع pnpm تشغيل نصوص بناء التبعيات إلى أن توافق عليها، ويذكر مرجع CLI: «أعد تشغيل Profile بعد إضافة Bundle أو إزالته أو تحديثه»، لذلك يُحمّل المكوّن الذي أُضيف باستخدام dsh plugin عند إعادة التشغيل التالية. أما المكوّن المثبّت من صفحة Plugins على الويب، فقد يصبح نشطاً فوراً. لا يوجد ما يفصل المكوّن المحمّل عن بقية harness. لذلك، قبل تثبيته، اسأل عمّا يستطيع هذا الكود الوصول إليه وكيف تحافظ على نطاق ذلك الوصول محدوداً.

dsh (DeepSeek Harness) هو harness مفتوح المصدر للوكلاء من DeepSeek AI، ومبني على إطار إضافات يسمى Cordis. تكمن الأهمية في هذه الكلمة الوسطى، لأن harness الوكيل هو البرنامج المحيط بالنموذج، ويتولى الحلقة والأدوات والصلاحيات، وينضم المكوّن الإضافي إليه على هذا المستوى تحديداً. يذكر README الخاص بالمشروع أن كل شيء عبارة عن مكوّن إضافي. فمحوّل النموذج مكوّن إضافي. وواجهة الويب التي تكتب فيها مكوّن إضافي. وكل ما تثبّته من خارج المشروع يصل إلى الشجرة نفسها، وعلى مستوى الثقة نفسه الذي تتمتع به المكوّنات التي تأتي مع المشروع. إذا لم تكن قد شغّلت واحداً بعد، فابدأ بـDeepSeek Harness على VPS، ثم عد قبل أن تضيف إليه أي شيء.

في أغسطس 2026، أدرج AGENTS.md في المستودع نقاط التوسعة التي يمكن للمكوّن الإضافي الوصول إليها، وشملت ما يلي:

  • LLM (نموذج اللغة الكبير): المزوّد الذي تدفع له رسوم API
  • Shell: قدرة bash، مع المزوّدين المحلي وpwsh
  • Filesystem: وصول إلى الملفات يخضع للسياسات
  • Web: مزيّدا البحث والجلب
  • Subprocess: مزوّد لشجرة العمليات
  • Workflow: خيوط العاملين
  • Subagent: تفويض المهام إلى وكلاء إضافيين
  • Settings and credentials: إعداداتك المحفوظة ومتغيرات البيئة

غادرت تلك القائمة AGENTS.md منذ ذلك الحين. واعتباراً من 17 نوفمبر 2026، يسمّي docs/architecture.md في المشروع نقاط التوسعة بدلاً من ذلك، ويضيف واجهات sandbox الخلفية، والطرفيات المستمرة، والمهام التي تعمل في الخلفية، وأوامر المستخدم، والجلسات التي تُشغّلها webhooks إلى واجهات النموذج والأدوات وShell وFilesystem وSubagent.

يسجّل المكوّن الإضافي أيضاً أدوات في ctx.tools، وتوضح الوثائق أن مخطط الأداة المسجّلة ينضم إلى تجميع prompt. هذا هو الجزء الذي يغفل عنه كثيرون. يمكن للمكوّن الإضافي تغيير ما يقرر وكيلك فعله من دون أن ينفّذ كوده أي سلوك غير معتاد، لأن الوصف الذي يضيفه يصبح نصاً يقرأه النموذج. وهذه المشكلة مماثلة في بنيتها لـحقن prompt ضد وكلاء البرمجة، مع اختلاف واحد: يصل هذا النص عند تثبيت المكوّن، ويبقى إلى أن تزيله.

كيف يعثر dsh على الإضافات ويحمّلها؟

لا يوجد دليل عام للإضافات. يتكوّن dsh قيد التشغيل عند الإقلاع من شجرة إضافات تُركَّب عبر طبقات مرتبة، والوحدة التي تحفظ اختياراتك هي profile. تكون القيمة الافتراضية لـ $DSH_HOME هي ~/.dsh، ويقع كل profile في $DSH_HOME/profiles/<name>. ينشئ profile الخاص بـ web وprofile الخاص بـ headless نفسيهما عند أول استخدام، اعتماداً على القوالب المضمّنة مع البرنامج.

يحتوي دليل profile على ملفين يحددان كل شيء:

  • package.json، ويحتوي على تبعيات الإضافات الخارجية، بالإضافة إلى بيان dsh.profile الذي يحمل قائمة bundles المرتبة
  • cordis.patch.yml، وهي طبقة التصحيحات الخاصة بك فوق تلك الحزم
ls ~/.dsh
ls ~/.dsh/profiles/web

يطبّق الإقلاع الطبقات بهذا الترتيب، وتغلب الطبقات اللاحقة الطبقات السابقة:

  1. جذر فارغ
  2. حزم profile، بالترتيب الذي تسرده قائمة البيان
  3. cordis.patch.yml الخاص بـprofile
  4. $DSH_HOME/cordis.patch.yml
  5. أي طبقات --patch <path> إضافية تمررها في سطر الأوامر

تعرض رايتان نتيجة هذا التركيب من دون بدء أي شيء:

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

تعرض --dump-default-config طبقات الحزم فقط. وتضيف --dump-config طبقتي profile وhome للتصحيحات، وأي طبقات --patch إضافية، ولذلك فهي أقرب طريقة إلى جرد موثوق لما سيحمّله إقلاعك التالي. اقرأها قبل أن تثق بجهاز ورثته.

تنبيه بشأن ملفات التصحيحات هذه. لا تُعدّ الإعدادات بيانات خاملة هنا، لأن التنسيق يسمح بقيم !!js الموسومة ضمن كتلة config الخاصة بإضافة. مقطع cordis.patch.yml منسوخ من منشور في منتدى هو كود، لذلك تعامل معه كما تتعامل مع shell script من المصدر نفسه.

ماذا ينفّذ dsh plugin add فعلياً؟

يمرّر dsh plugin --profile <name> <args> وسيطاته إلى 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

نموذج أمان تثبيت إضافة dsh هو نموذج أمان تثبيت أي تبعية بأسلوب npm، مع خطوة إضافية تُحمَّل فيها النتيجة إلى وكيلك. تحضر الحزمة شجرة تبعياتها الخاصة، وتنتهي كل حزمة في هذه الشجرة داخل العملية نفسها. ينطبق كل ما يرد في كيفية وصول هجمات سلسلة توريد npm إلى خادم هنا من دون تعديل.

لا يشغّل pnpm 10 والإصدارات الأحدث نصوص إنشاء التبعية افتراضياً، وتكون الموافقة لكل حزمة عبر pnpm approve-builds أو إعداد allowBuilds. استبدل pnpm 11 إعداد onlyBuiltDependencies الأقدم بـ allowBuilds، لذلك فإن الدليل أو ملف الإعداد القديم الذي ما زال يستخدم onlyBuiltDependencies لا يمنح أي موافقة في إصدار pnpm الحالي. تحقّق من إصدار pnpm لديك:

pnpm --version

تظهر هذه الحالة أولاً مع الإضافات المستضافة على Git. يوضح مرجع CLI أن إضافة Git التي تتضمن مصدرها تنشئه أثناء التثبيت عبر نص prepare، لذلك يفشل أول add مع التلميح allowBuilds من pnpm، ثم تنسخ المفتاح المطبوع إلى pnpm-workspace.yaml في ملف التعريف وتعيد التشغيل. تسمح الموافقة على هذا المفتاح بتشغيل إنشاء المستودع باستخدام صلاحيات المستخدم لديك. لا تحتاج الحزم المضغوطة المنشأة ونسخ المستودعات المحلية إلى أي سماح.

هذا الإعداد الافتراضي مفيد، لكنه أيضاً أكثر ميزة أمان يُساء فهمها في هذا النظام البيئي. تمنع نصوص الإنشاء المحظورة تشغيل التعليمات البرمجية أثناء التثبيت. لكنها لا تفعل شيئاً بشأن الإضافة نفسها، لأن الغرض من الإضافة هو أن يستوردها إطار التشغيل ويستدعيها عند إعادة تشغيل ملف التعريف، أو فور تطبيق التثبيت عند استخدام صفحة Plugins على الويب. لا تحتاج الإضافة إلى hook باسم postinstall. لقد مُنحت الإضافة إذناً بالدخول.

ما الذي يجب أن تقرأه قبل تثبيت إضافة 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 على أربعة حقول توفّر لك معظم المعلومات التي تحتاج إليها. اقرأ scripts بحثاً عن إدخالات preinstall وinstall وpostinstall. اقرأ dependencies بحثاً عن الأسماء التي لا تتعرّف إليها، أو الأسماء التي تختلف بحرف واحد فقط عن أسماء تعرفها. اقرأ bin بحثاً عن أي شيء تريد الحزمة إضافته إلى PATH لديك. اقرأ main أو exports لمعرفة ملف الإدخال، ثم افتح ذلك الملف واتّبعه.

ثم اقرأ الشيفرة التي سيجري تحميلها فعلياً. لا يوجد سبب يجعل إضافة تعلن عن أداة للإشعارات تقرأ ~/.ssh أو تتصل بمضيف لم تسمع به من قبل أو تنشئ shell. إذا كانت الحزمة لا تتضمن إلا JavaScript مضمّنة أو مصغّرة، ولم يكن المصدر المطابق متاحاً في مستودع عام، فهذه هي الإجابة. فضّل الإضافات التي يمكنك قراءة مصدرها، وفضّل الإضافات الصغيرة.

يمكنك أيضاً فحص السجل من دون تثبيت أي شيء:

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

الحزمة المنشورة في الأسبوع الماضي، والتي تملك إصداراً واحداً فقط، ولا تتضمن حقل مستودع، ويحاكي اسمها اسم شيء شائع، هي أقدم حيلة في أي سجل. التحقق من التنزيلات باستخدام checksums عادة ملاصقة لذلك: اعرف بالضبط ما الذي جلبته قبل أن تسمح بتشغيله.

ثبّت الإصدار واحتفظ بملف القفل

يعني نطاق الإصدار العائم أن الشيفرة داخل عملية agent قد تتغير عند أي عملية تثبيت أو تحديث من دون أن تقرر ذلك. ثبّت الإصدار.

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

يختلف موضع الرايات بين إصدارات pnpm، لذلك تحقّق من النتيجة بدلاً من الوثوق بالأمر. افتح package.json الخاص بالملف التعريفي بعد ذلك، وتأكد من أن التبعية تظهر كإصدار مجرد، من دون ^ أو ~ قبلها. يحدد هذا الملف ما سيتم تثبيته.

ثم احتفظ بملف القفل، فهو يثبّت شجرة التبعيات الانتقالية بأكملها، وليس الاسم في المستوى الأعلى فقط:

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

انسخه إلى مكان تُجري له نسخاً احتياطية، مع package.json الخاص بالملف التعريفي. يعيد هذان الملفان إنشاء الشجرة نفسها على خادم جديد. شغّل dsh plugin --profile web update عندما تقرر تغيير الإصدارات، وليس كإجراء تنظيف روتيني، واقرأ الفروقات في ملف القفل بعد ذلك.

بالنسبة إلى plugin المثبّت من git بدلاً من registry، ثبّت commit بدلاً من الفرع. تمنحك مواصفة بالشكل github:owner/repo#<full commit sha> شجرة ثابتة. أما اسم الفرع فيمنحك كل ما يحتويه ذلك الفرع في المرة التالية التي يحلّ فيها pnpm التبعيات، وبذلك تكون قد سلّمت هذا القرار إلى شخص آخر. يحتاج harness نفسه إلى الانضباط ذاته، لأن إصدار npm latest هو إصدار مرشح، ويمكن لتثبيت غير مثبت أن يحلّ إلى إصدار مختلف في أي يوم، وهذا هو مصدر معظم أخطاء تثبيت dsh وإصداره.

قيمة سوق الإضافات، وما الذي يعنيه «التنسيق»

لدى dsh سوق، ويتم تثبيته كإضافة، وهذا يوضح جانباً من بنية البرنامج:

dsh plugin --profile web add dshmarket

بعد إعادة التشغيل، يظهر السوق كعلامة تبويب في صفحة Plugins، بجوار Installed، في dsh 0.2.1 والإصدارات الأحدث؛ أما المضيفون الأقدم فيستخدمون Settings، ثم Plugin Market. يوضح README الخاص به القيود بوضوح. تقتصر عمليات التثبيت على المصادر المدرجة في سجل منسّق، ويُرفض أي مصدر آخر. تكون نصوص البناء محظورة افتراضياً، ويتطلب تفعيل أي منها موافقة لكل حزمة. تُعلَّم إضافات الطرفية قبل إدراجها في ملف تعريف ويب. والجملة الأهم هي أن الإدراج لا يعني التزكية، لأن الإضافات عبارة عن شيفرة من جهات خارجية. ويذكر README نفسه أن معظم الإضافات المثبتة من خلاله تصبح فعالة بعد تحديث الصفحة من دون إعادة تشغيل، لذلك قد تعمل الإضافة المثبتة بنقرة واحدة داخل وكيلك بعد ثوانٍ قليلة.

ترفع القائمة المنسّقة الحد الأدنى من مستوى الأمان. لكنها لا تقرأ الشيفرة نيابةً عنك، ولا يمكنها إخبارك بما سيفعله الإصدار التالي من الإضافة بعد انتقال حساب المشرف إلى مالك آخر. تعامل مع التثبيت بنقرة واحدة كما تتعامل مع curl | bash من المؤلف نفسه. وهناك سطر آخر من README يستحق التكرار: قد تحتوي النسخة الاحتياطية المصدَّرة على بيانات اعتماد من ملف إعدادات ملف تعريفك، لذلك لا ترفقها أبداً بتذكرة عامة أو بموقع للصق النصوص. إذا كنت تريد قائمة بداية بدلاً من منهج، فمقالة إضافات dsh التي تستحق التثبيت هي المقالة المرافقة لهذه المقالة.

أصبح لدى harness مسار خاص به أيضاً. وتضيف إضافة Custom التجريبية، التي تفهرس bundle ويُفعّلها المستخدم من صفحة Plugins، علامة تبويب Discover تعتمد على ملفات فهرس تضيفها بنفسك. لا يوفّر dsh أي مصدر للفهرس، وتوضح وثائقه أن الفهارس محتوى من جهات خارجية، وأن dsh يتحقق من تنسيق الملف، لكنه لا يتحقق مما يدّعيه الفهرس بشأن عنوان الإضافة أو مؤلفها أو مصدرها.

شغّل dsh بحسابه الخاص، وليس بحساب root

يقلل التدقيق من احتمال دخول شيء ضار. وتحدد أقل الصلاحيات ما يمكنه الوصول إليه عند دخوله. على VPS، إعداد هذا الجزء بسيط.

امنح بيئة التشغيل حساب Unix خاصاً بها ومجلد home خاصاً بها، ولا تشغّلها بحساب root مطلقاً:

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

داخل تلك الجلسة، شغّل بيئة التشغيل كي تنشئ home الخاص بها تحت ذلك الحساب:

npx @deepseek-ai/dsh web

تعمل واجهة الويب على http://127.0.0.1:3080 افتراضياً. اتركها كذلك. إذا نقرت سابقاً على ذلك الرابط المطبوع من جهاز آخر ولم تحصل على استجابة، يشرح ما يعنيه dsh عندما يطبع ذلك العنوان السبب. يفحص إعداد الويب المرفق رأسي Host وOrigin، ويتطلب متصفحاً موثَّقاً أو Peer لواجهة API لكل أسلوب Host RPC ولكل دفق WebSocket، كما يرفض dsh web القيمة --host 0.0.0.0. تصادق طلبات API عبر /connect، وتتلقى cookie موقعة لواجهة API. تعامل مع تسجيل الدخول هذا باعتباره قفلاً ثانياً، لا سبباً لنشر المنفذ 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 مختلفة أو تغيير في الإعدادات، وتكون تلك composition مسؤولة عن المصادقة الخاصة بها. توضح وثائق المشروع أن خادم الويب الأساسي لا يوفّر مصادقة أو سياسة Origin خاصة به، ولذلك، إلى أن تعرف ما الذي يحمي ذلك المنفذ، افترض أن جدارك الناري هو الحاجز الوحيد بين غريب وagent الخاص بك، وأعده إلى loopback. ينطبق المنطق وراء تشغيل Claude Code بأمان على VPS على dsh دون تغيير. امنح agent مجلداً واحداً لمساحة عمله، واسمح له بإتلافه، وأبقِ كل ما لا يمكنك إعادة بنائه خارج ذلك الجهاز. والأفضل أن تتعامل مع الخادم على أنه VM مؤقتة لوكلاء البرمجة، لأن إعادة بناء VPS تستغرق ساعة، بينما تدقيقه يستغرق أسبوعاً.

مكان حفظ مفاتيحك، ولماذا لا تكفي أذونات الملفات وحدها

يحتفظ dsh بمفاتيح API في $DSH_HOME/.credentials.yaml، وبقيم البيئة في $DSH_HOME/.env، وبإعدادات النموذج في cordis.patch.yml ضمن ملف التعريف النشط. عندما راجعنا هذا الدليل أول مرة في أكتوبر 2026، استورد إصدار أقدم $DSH_HOME/settings.yaml مرة واحدة وأعاد تسميته إلى settings.yaml.imported. يوضّح إعداد مفاتيح API والنماذج ونقاط النهاية في dsh أي مفتاح ينتمي إلى كل ملف من هذه الملفات، وما الذي يغادر الجهاز فعلياً في كل وضع. من الأفضل حسم ذلك قبل إضافة plugin، لأن كل مفتاح تضيفه يصبح شيئاً آخر يمكن لـplugin قراءته. قيّد أذونات الملفين الحساسين:

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

يمنح الوضع 600 المالك صلاحية القراءة والكتابة، ولا يمنح أي صلاحية للآخرين. ومن المفيد معرفة ذلك بالصيغة الرقمية والصيغة الرمزية معاً (أوضاع chmod الرقمية مقابل الرمزية). كن دقيقاً بشأن ما توفره هذه الأذونات. تحمي أوضاع الملفات هذه الملفات من الحسابات الأخرى على الجهاز. لكنها لا تحميها من plugin، لأن plugin يعمل بصفة المستخدم الذي يملك الملفات، وضمن العملية التي تقرأها. لذلك يعني إبعاد الأسرار عن متناول وكيل الذكاء الاصطناعي عدم وضعها على الجهاز أصلاً. يجب أن يحتوي جهاز dsh على مفتاح النموذج الذي يحتاج إليه فقط. أما بيانات اعتمادك السحابية ومفاتيح التوقيع، فيجب حفظها في مكان آخر.

لماذا يغيّر المكوّن الإضافي الذي يقرأ الويب نموذج التهديد

توفّر وصلة Web للمكوّنات الإضافية مزوّدي البحث والجلب. عندما يجلب المكوّن الإضافي صفحة إلى جلستك، فهو يجلب نصاً يستطيع مهاجم كتابته. لا يميّز prompt النموذج بين التعليمات والبيانات، لذلك يمكن للصفحة التي جرى جلبها أن تتضمن سطراً موجهاً إلى agent الخاص بك، ويصبح harness الذي يملك صلاحية shell على بُعد خطوة تنفيذ واحدة مطيعة.

توجد آلية التحكم هذه بالفعل في harness. dsh-base، وهي الحزمة الأولى المشتركة لملفات التعريف web وheadless وsdk وacp، تُضمّن sandbox وسياسة الموافقة، بينما يستبعدها ملف التعريف sdk-minimal عمداً. استخدمها. يجب أن تتطلب الجلسة التي يمكنها جلب صفحات غير موثوقة موافقة على أي إجراء يكتب أو ينفّذ، حتى لا تتحول التعليمات التي جرى جلبها إلى إجراء بمفردها. يشرح وضع إجراءات agent خلف الموافقات كيفية تحديد موضع هذا الحد. وتسري العلاقة في الاتجاهين أيضاً، لأن خادمك نفسه صفحة سيجلبها agent تابع لشخص آخر، وهذا هو موضوع حظر زواحف AI على خادمك.

كيف أتحقق مما غيّره 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.txt

يوضح diff إدخالات plugin التي أضافها التثبيت إلى الشجرة المركبة. لا ينضم إلى الشجرة إلا package يعلن عن bundle patch؛ أما dependency عادية فلا تضيف شيئاً إليها، ويصدر dsh تحذيراً بشأنها مرة واحدة. إذا ثبّتَّ plugin لميزة صغيرة واحدة، لكنه أضاف عدة إدخالات لا تستطيع تفسيرها، فتوقّف واقرأ source قبل تشغيله. يجيب dsh plugin --profile web why <package-name> عن السؤال الآخر: أي من direct dependencies لديك أدخل package معيّناً.

تُوضَع installed packages في node_modules الخاص بـprofile، ضمن $DSH_HOME/profiles/<name>/node_modules، لذلك يمكنك أيضاً فحص الشجرة على القرص:

ls ~/.dsh/profiles/web/node_modules

احتفظ بـprofile ثانٍ لا تجري فيه أي تجارب. عندما يتسبب التثبيت في تعطل harness، يخبرك تشغيل 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

لا تؤدي إزالة التبعية دائماً إلى إزالة الإعدادات. تبقى الإدخالات المكتوبة في cordis.patch.yml الخاص بالملف الشخصي في مكانها، لأن هذا الملف يخصك ولن يعيد الـharness كتابته نيابةً عنك. افتح الملف واحذف أي كتلة تذكر الحزمة التي أزلتها.

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

ثم عالج الجزء الذي لا يمكن لأي أمر إزالة تثبيت إصلاحه. إذا أزلت إضافة لأنك لم تعد تثق بها، فقد قرأت بالفعل كل ما كان بإمكانها قراءته. بدّل مفتاح DeepSeek API في وحدة تحكم موفر الخدمة، وبدّل أي شيء آخر كان موجوداً في $DSH_HOME. ثم حدّد الموارد التي كان بإمكان حساب unix الذي شغّل الإضافة الوصول إليها في بقية شبكتك.

الخلاصة

  • اقرأ أرشيف tarball المنشور قبل التثبيت، وابدأ من scripts ومن ملف الإدخال
  • ثبّت الإصدار الدقيق، أو commit الدقيق عند استخدام مواصفة git، واحتفظ بملف القفل
  • ثبّت البرامج في profile واحد، واحتفظ بـprofile نظيف يمكنك الإقلاع به عند حدوث مشكلة
  • اعرض الفروقات في --dump-config قبل كل تثبيت وبعده
  • شغّل harness باستخدام مستخدم unix مستقل، على loopback، مع الوصول إليه عبر SSH
  • احتفظ بمفتاح API واحد على الخادم، وبدّله في اليوم الذي تزيل فيه plugin لم تعد تثق به

لا يعني أي من ذلك تجنّب plugins. فنموذج plugin هو سبب فائدة dsh، كما أن harness الذي لا يمكنك توسيعه هو harness ستستبدله. المقصود هو أن تعرف ما الذي ثبّتَّه، ومن أي جهة، وبأي إصدار، وأن تشغّل كل ذلك في مكان يمكنك إعادة بنائه.

FAQ

هل يعزل dsh الإضافات عن بعضها؟

لا. تُحمَّل الإضافة في عملية harness عبر Cordis، ويمكنها الوصول إلى واجهات القدرات الموثقة، بما في ذلك shell وfilesystem وweb وsubprocess وsubagent وcredentials. dsh-base، وهي الحزمة الأولى المشتركة لملفات التعريف web وheadless وsdk وacp، تتضمن سياسة العزل والموافقة التي تحكم ما يمكن لأدوات الوكيل تنفيذه. وهذه السياسة هي مصدر الحماية لديك. لا توجد حدود صلاحيات منفصلة لكل إضافة، لذلك فإن النموذج الواقعي هو أن تثبيت إضافة يوسّع نطاق الثقة ليشمل مؤلفها وكل حزمة في شجرة تبعياتها.

هل يمكنني تثبيت إضافة dsh دون تشغيل نصوص التثبيت الخاصة بها؟

يحظر pnpm 10 والإصدارات الأحدث نصوص بناء التبعيات افتراضياً، وdsh plugin ... add يمرر التنفيذ إلى pnpm. لذلك، في إصدار pnpm حديث، لا يشغّل التثبيت نصوص الحزم ما لم توافق على تلك الحزمة. تحقّق من إصدارك باستخدام pnpm --version. لكن هذا لا يجعل الإضافة غير المقروءة آمنة. تُشغَّل شيفرة الإضافة نفسها عندما يحمّلها harness، عند إعادة تشغيل ملف التعريف التالية بعد تثبيت dsh plugin، أو غالباً مباشرةً بعد التثبيت من صفحة Plugins على الويب. ولا يؤثر أي تقييد وقت التثبيت في ذلك.

أين توجد إضافات dsh وإعداداتها فعلياً؟

يستخدم $DSH_HOME القيمة الافتراضية ~/.dsh. توجد ملفات التعريف في $DSH_HOME/profiles/<name>، ويحتوي كل منها على package.json مع تبعيات الإضافات الخاصة به، وعلى بيان dsh.profile للحزم المرتبة، وطبقة تصحيحات cordis.patch.yml. تُثبَّت الحزم في node_modules الخاص بكل ملف تعريف، وتحديداً في $DSH_HOME/profiles/<name>/node_modules. توجد المفاتيح في $DSH_HOME/.credentials.yaml، وقيم البيئة في $DSH_HOME/.env، ويُطبَّق $DSH_HOME/cordis.patch.yml على مستوى home فوق كل ملفات التعريف. شغّل dsh --profile web --dump-config لعرض النتيجة المركبة دون تشغيل النظام.

هل التثبيت من سوق إضافات dsh آمن؟

يقصر السوق عمليات التثبيت على المصادر الموجودة في سجل منسّق، ويحظر نصوص البناء ما لم توافق عليها لكل حزمة. وهذا تحسّن فعلي مقارنةً بلصق اسم حزمة من نافذة محادثة. مع ذلك، يذكر README الخاص بالسوق أن الإدراج لا يعني التزكية، لأن الإضافات شيفرة من جهات خارجية. اقرأ الشيفرة وثبّت الإصدار. شغّل harness تحت حساب مستخدم، ويفضل على جهاز، يمكنك تحمّل فقدانه.

هل كان هذا المقال مفيدًا؟