إصلاح أخطاء تثبيت وإصدارات DeepSeek Harness
هل يظهر لك خطأ إصدار DeepSeek Harness؟ تعرّف على مشكلة prerelease، وثبّت إصدار dsh محدداً، وامسح ذاكرة npx، وتحقق من npm الذي يشغّله جهازك.
ما هي عملية تثبيت DeepSeek Harness فعلياً
تتكون عملية تثبيت DeepSeek Harness من أمر واحد: npx @deepseek-ai/dsh web. لا يوجد مثبّت، ولا توجد خدمة تحتاج إلى إعداد. معظم المشكلات التي يواجهها المستخدمون لا تتعلق بالتثبيت أصلاً. بل تتعلق بتحديد الإصدار: ما الإصدار من @deepseek-ai/dsh الذي قرر npx تشغيله اليوم، وما إذا كان إصدار Node.js لديك يستطيع تشغيله. عند بدء التشغيل، يكون الربط الافتراضي على localhost؛ وتستبدل --host و--port إعدادات المستمع، ويستخدم العنوان المطبوع --public-url عند إعداده. الربط الافتراضي وسبب استجابة واجهة الويب على 127.0.0.1:3080 فقط مشكلة منفصلة عن المشكلات الموضحة في هذه الصفحة.
هناك حقيقتان تحددان كل ما يلي. أولاً، كان كل إصدار من @deepseek-ai/dsh منشوراً على npm حتى 27 October 2026 إصداراً ما قبل الإطلاق. معظمها إصدارات مرشحة للإصدار (-rc.N)، ومنذ 30 August 2026 توفرت أيضاً إصدارات alpha (-alpha.N). يشير الوسم latest إلى إصدار مرشح للإصدار. وفي 6 November 2026 كان ذلك الإصدار 0.2.2-rc.1. ثانياً، يذكر README الخاص بالمشروع أن harness في معاينة للمطورين، وأنه يتطور بسرعة، وأنه سيشهد تغييرات تكسر التوافق. قد يختفي هذا الأسبوع خيار كان يعمل الأسبوع الماضي. ثبّت إصداراً قبل أن تبني أي شيء فوقه.
لنعرّف بعض المصطلحات أولاً. dsh هي أداة سطر الأوامر الخاصة بـDeepSeek Harness. Node.js هي بيئة تشغيل JavaScript التي تحتاج إليها الأداة. أما npx فهي أداة تشغيل الحزم التي تأتي مع npm (node package manager)، وتجلب الحزمة عند الطلب بدلاً من تثبيتها بشكل دائم. إذا كان استخدام كلمة harness في هذه الجملة غير مألوف، فإن agent harness هو البرنامج المحيط بالنموذج، ويتولى الحلقة والأدوات والصلاحيات وحالة الجلسة. لذلك يمكن لرقم إصدار لم تختره أن يغيّر سلوك وكيلك.
ما إصدار Node.js الذي يحتاج إليه dsh؟
في 10 October 2026، عندما كان المستودع عند الإصدار 0.2.1-alpha.2، أعلن الملف الجذري package.json عن "engines": {"node": "^22.19.0 || >=24.0.0"}. لم يعد هذا هو المتطلب. عند القراءة في 27 October 2026، وكان المستودع عند الإصدار 0.2.1-rc.3، أعلن الملف الجذري package.json عن "engines": {"node": ">=24.9.0"}، كما يعلن المصدر الخاص بواجهة CLI في package.json النطاق نفسه الآن. توضح مذكرة قرار المشروع المؤرخة في 15 October 2026 أن عمليات تثبيت Node 22 يجب أن تُرقّى، وأن Node 24.0 غير كافٍ أيضاً، لأن نقاط الدخول تعتمد على import.meta.main، وهو غير متوفر في 24.0. لذلك يجب استخدام Node 24.9.0 أو إصدار أحدث. لا يصلح Node 20 ولا Node 22، وكذلك لا يصلح أي إصدار من Node 24 يسبق 24.9.0. عند التحقق في 27 October 2026، كانت وسوم الإصدار الخاصة بـ0.2.1-rc.2، ثم البناء الذي أشار إليه latest، و0.2.1-rc.3 لا تزال تحمل النطاق القديم، لذلك جاء الحد الأدنى الجديد بعدها. خطط لاستخدام 24.9.0 على أي حال، لأن هذا هو النطاق الذي يعلنه المشروع الآن.
تحقق مما لديك قبل أي خطوة أخرى.
node -v
npm -vإليك الجزء الذي يفاجئ المستخدمين. حتى 27 October 2026، لم تكن حزمة @deepseek-ai/dsh المنشورة تحتوي على حقل engines خاص بها، وذلك في أي من إصداراتها البالغ عددها 38 إصداراً حتى 0.2.1-rc.4. يعلن جذر المستودع الأحادي عن هذا الحقل، لكن ملف الجذر لا يُنشر إلى npm مطلقاً. أضاف مصدر واجهة CLI في package.json هذا الحقل في commit مؤرخ في 15 October 2026، لكن أياً من الإصدارات المنشورة التي فُحصت في 27 October لم يكن يحتوي عليه. لذلك لم تحصل npm من تلك الإصدارات على متطلب Node خاص بـdsh للتحقق منه. حتى 6 November 2026، كانت الحزمة المنشورة 0.2.2-rc.1 تعلن "engines": {"node": ">=24.9.0"}. تتعامل npm مع engines باعتباره إرشادياً ما لم تضبط engine-strict، لذلك توقّع تحذيراً على الأكثر مع الإعداد الافتراضي. عند استخدام إصدار Node غير مدعوم، يبدو التثبيت ناجحاً، ويظهر الفشل لاحقاً عندما تصل الشيفرة المحمّلة إلى صياغة أو API غير متوفر في بيئة التشغيل لديك. لا توجد رسالة خطأ واحدة ثابتة يمكن البحث عنها، لأن السطر الذي يفشل أولاً يعتمد على الوحدة التي تُحمّل أولاً. اقرأ node -v بدلاً من الاكتفاء بقراءة الانهيار.
إذا كان إصدار Node لديك قديماً جداً، فإن nvm (مدير إصدارات Node) هو أقل الحلول تدخلاً على VPS، لأنه يُثبَّت ضمن مجلد home الخاص بك ويترك 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.. إذا استمرت shell في الإبلاغ عن الإصدار القديم، فنفّذ which node. يعود ظهور مسار خارج ~/.nvm عادةً إلى أحد سببين. إما أن دالة shell الخاصة بـnvm لم تُحمّل، ولذلك افتح shell جديدة لتسجيل الدخول وحاول مرة أخرى، أو أن سطراً في ملف تعريف shell يغيّر PATH بعد الأسطر التي تُحمّل nvm ويضع Node آخر في المقدمة، ولذلك انقل ذلك السطر إلى ما قبل أسطر nvm. كان Node 24 إصدار LTS النشط (الدعم طويل الأمد) في 10 October 2026، وانتقل إلى مرحلة الصيانة في 20 October 2026. أحدث إصدار منه في 29 October 2026 هو 24.22.2، وهو أعلى بكثير من الحد الأدنى 24.9.0. أما Node 26، الذي يسمح به أيضاً نطاق >=24.9.0، فقد دخل مرحلة LTS النشطة في 28 October 2026 بالإصدار 26.13.0. يفي أي منهما بالحد الأدنى، وكلاهما يضم إصدارات npm التي تحتوي على إصلاح range-cache الموضح أدناه. تتطلب ملفات Linux الثنائية الرسمية لـNode 26 أيضاً libatomic، وقد تحتاج توزيعتك إلى تثبيته بشكل منفصل.
لماذا يشغّل npx إصداراً مختلفاً كل يوم؟
لا تحدد npx @deepseek-ai/dsh web أي إصدار. ما لم يكن المشروع في الدليل الحالي يحتوي مسبقاً على @deepseek-ai/dsh مثبتاً، يشغّل npx تلك النسخة. وإلا، يطلب npx من السجل الإصدار الذي يشير إليه الوسم latest. يتغير هذا الوسم كثيراً. صدر 0.1.0-rc.8 في 19 August 2026، بعد يومين من 0.1.0-rc.7. وفي 10 October 2026، كان latest يشير إلى 0.2.0-rc.2، ثم أصبح يشير إلى 0.2.1-rc.2 في 27 October 2026. في كل مرة يتغير فيها، يبدأ الأمر المحفوظ في ملاحظاتك بتشغيل شيفرة مختلفة، من دون مطالبة ومن دون سجل تغييرات ظاهر أمامك.
يمكنك فحص كل جزء متغير من سطر الأوامر.
npm view @deepseek-ai/dsh dist-tags
npm view @deepseek-ai/dsh versions --json
npm view @deepseek-ai/dsh time --jsonيعرض dist-tags الوجهة الحالية التي يشير إليها latest. في 10 October 2026، كان كل من latest وnext يشير إلى 0.2.0-rc.2، بينما كان وسم ثالث هو 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 يختار إصداراً تمهيدياً. وتُعد قائمة versions أكثر إثارة للاهتمام، لأنها تحتوي على فجوات. في 10 October 2026، كانت تضم 31 إصداراً، من 0.0.1-rc.1 إلى 0.2.1-alpha.2، وبحلول 27 October 2026 أصبحت تضم 38 إصداراً، ولا يزال كل واحد منها إصداراً تمهيدياً. يقفز خط 0.0.1 من -rc.2 إلى -rc.5، ويقفز خط 0.1.0 من -rc.3 إلى -rc.6، وتبدأ إصدارات alpha عند 0.1.2-alpha.2 و0.1.3-alpha.2، ولا يوجد 0.1.4 إطلاقاً. بعض الأرقام مفقودة من القائمة المنشورة، كما تتداخل إصدارات alpha والإصدارات المرشحة للإطلاق في القائمة نفسها. سيؤدي تخمين -rc.N التالي في نص نشر إلى الفشل، لذلك اقرأ القائمة بدلاً من الزيادة العددية المتتابعة.
لماذا يستمر npx في تشغيل إصدار قديم؟
هذه شكوى معاكسة، وكلتا الشكويين صحيحتان، وفقاً لمواصفة الحزمة، والتثبيت المحلي، وإصدار npm الذي تشغّله.
يحتفظ npx بدليل حزم خاص به، منفصل عن ذاكرة التخزين المؤقت لملفات tarball، داخل مجلد اسمه _npx ضمن ذاكرة npm المؤقتة. اطبع المسار وافحصه.
npm config get cache
ls "$(npm config get cache)/_npx"يتحقق npm 10.9.3 مسبقاً من السجل عند استخدام اسم حزمة مجرد خارج تثبيت المشروع. غيّر npm 11.2.0 آلية التحقق من حداثة ذاكرة التخزين المؤقت لنطاقات الإصدارات. عندما تكون المواصفة اسماً مجرداً ولا تكون الحزمة مثبتة مسبقاً في المشروع الحالي، يجلب npx البيان باستخدام preferOnline: true ويعيد استخدام النسخة المخزنة مؤقتاً في _npx فقط عندما يطابق ملف tarball المحسوم ما أعاده السجل. يظل الاسم المجرد يطابق أي إصدار مثبّت في المشروع الحالي، من دون التحقق من السجل. بالنسبة إلى نطاق إصدار، يقبل npm 10.9.3 إصداراً مخزناً مؤقتاً يطابق النطاق، بينما يتحقق npm 11.2.0 والإصدارات الأحدث مما إذا كان النطاق يُحسم إلى إصدار أحدث.
يحدد npm الذي تشغّله فعلياً السلوك الذي تحصل عليه. ما لم تكن قد حدّثت npm بشكل منفصل باستخدام npm install -g npm، فسيكون هو الإصدار الذي يأتي مع إصدار Node لديك:
- يأتي Node 20.20.2 مع npm 10.8.2.
- يأتي Node 22.19.0 مع npm 10.9.3.
- يأتي Node 22.23.4، وهو أحدث إصدار من السلسلة 22 في 27 October 2026، مع npm 10.9.9.
- يأتي Node 24.9.0، وهو الحد الأدنى الحالي في harness، مع npm 11.6.0.
- يأتي Node 24.19.0 مع npm 11.17.0.
- يأتي Node 24.22.2، وهو أحدث إصدار من السلسلة 24 في 29 October 2026، مع npm 11.19.1.
- يأتي Node 26.13.0، وهو أحدث إصدار من السلسلة 26 في 29 October 2026، مع npm 11.20.0.
لذلك تأتي السلسلة Node 22 بأكملها مع إصدار npm أقدم من 11.2.0. كان harness يدعم Node 22 حتى منتصف October 2026 ولم يعد يدعمه، لكن الخادم الذي شغّل dsh قبل ذلك قد يظل يستخدمه. يعيد npm 10.9.3 المضمّن في Node 22.19.0 التحقق من npx @deepseek-ai/dsh web المجرد مقابل السجل خارج تثبيت المشروع، لذلك لا تفسّر إدخالة _npx قديمة وحدها وجود مرشح إصدار قديم. كل إصدارات Node التي يقبلها harness حالياً، بدءاً من 24.9.0، تأتي مع npm 11.6.0 أو إصدار أحدث، ويتضمن ذلك أيضاً إصلاح ذاكرة التخزين المؤقت للنطاقات. قد يظل لتثبيت المشروع أولوية. اطلب من الأداة تحديد ما تستخدمه:
npx @deepseek-ai/dsh --versionمسح ذاكرة npx المؤقتة
في npm 11.2.0 والإصدارات الأحدث، توجد أوامر فرعية مخصصة.
npm cache npx ls
npm cache npx rm --forceمن دون --force، يرفض npm مسح كل شيء ويطبع Please use --force to remove entire npx cache. استخدم npm cache npx ls أولاً عندما تريد إزالة إدخال واحد حسب المفتاح بدلاً من إزالة جميع الإدخالات.
في npm 10، لا توجد هذه الأوامر الفرعية، لذا احذف الدليل بنفسك.
rm -rf "$(npm config get cache)/_npx"لا يساعد npm cache clean --force في هذه الحالة. فهو يمسح _cacache، أي مخزن ملفات tarball، ويترك _npx من دون تغيير. وهذا الفصل هو السبب تحديداً في أن npm أضاف لاحقاً أوامر npm cache npx الفرعية. كما أن مسح _npx لا يسبب خسارة دائمة: فهو يحتوي على الحزم التي جرى تنزيلها، بينما توجد حالة harness بشكل منفصل ضمن $DSH_HOME، بما في ذلك profiles/<name> وsessions وstorages و.credentials.yaml، ولا تتأثر.
كيف أثبّت إصداراً مرشحاً محدداً بدقة؟
اذكر سلسلة الإصدار الكاملة، بما في ذلك الجزء -rc.N.
npx --yes @deepseek-ai/dsh@0.1.0-rc.7 webتستخدم الأمثلة في هذه الصفحة 0.1.0-rc.7. استبدل ذلك بالبنية التي اختبرتها فعلياً. في 27 October 2026، كانت العلامة latest تشير إلى 0.2.1-rc.2.
يقبل --yes تأكيد تثبيت الحزمة من npx من دون مطالبة تفاعلية.
يثبّت الإصدار المحدد بدقة حزمة dsh، لكنه لا يضمن بدء التشغيل دون اتصال. يعتمد npx في تسمية مجلد ذاكرة التخزين المؤقت على سلسلة المواصفة التي أدخلتها، ويمكنه إعادة استخدام إصدار محدد مثبت مسبقاً هناك. ولكن إذا لم توجد عملية تثبيت محلية مطابقة، فإن فحص شجرة الملفات المحلية السابق يجلب البيان باستخدام preferOnline: true قبل فحص _npx. ويؤدي تثبيت إصدار محدد مطابق في المشروع المحلي إلى تجنّب جلب ذلك البيان. كما يؤدي تشغيل اسم مجرد خارج مشروع يثبت dsh إلى جلب البيان، بما في ذلك عند استخدام npm 10.9.3.
ويثبّت التثبيت العام الإصدار بالطريقة نفسها، كما يمنحك أمراً مختصراً.
npm install -g @deepseek-ai/dsh@0.1.0-rc.7
dsh --versionلم يُعثر على إصدار مطابق لـ @deepseek-ai/dsh@^0.1.0
اعتباراً من 27 October 2026، فشل استخدام نطاق caret أو tilde عادي مع هذه الحزمة. أجاب npm install -g @deepseek-ai/dsh@^0.1.0 برمز الخطأ ETARGET والسطر No matching version found for @deepseek-ai/dsh@^0.1.0.. المستودع يعمل بشكل سليم. هذه قاعدة في semver: لا يطابق نطاق الإصدار إصداراً تمهيدياً ما لم يسمِّ أحد مقارنات النطاق إصداراً تمهيدياً يحمل أرقام major وminor وpatch نفسها. كانت كل بنية منشورة لهذه الحزمة حتى 27 October 2026 إصداراً تمهيدياً، إما -rc.N أو -alpha.N، ولم يسمِّ ^0.1.0 أي إصدار، لذلك لم يطابق شيئاً. اكتب الإصدار المحدد بدقة.
تنطبق هذه القاعدة في الاتجاهين. لا ينتقل النطاق العادي تلقائياً إلى إصدار مرشح جديد، لكن يمكن لنطاق يسمّي إصداراً تمهيدياً أن يفعل ذلك. يعني ^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 لأن أرقامه مختلفة. هذه حالة تثبيت جزئي بين إصدار محدد بدقة وعلامة متغيرة، وتغيّر ما يُشغَّل من دون أن تغيّر شيئاً بنفسك. إذا أردت البنية التي اختبرتها دون غيرها، فاكتب الإصدار المحدد بدقة.
هل أستخدم npx أم أثبّت dsh على مستوى النظام؟
استخدم npx لإلقاء نظرة أولية، لأن الحزمة تبقى في دليل تخزين مؤقت تعرف الآن كيفية مسحه. استخدم تثبيتاً عاماً محدداً بإصدار لأي شيء يجب أن يظل يعمل بعد إعادة التشغيل، مثل وكيل برمجي تتركه قيد التشغيل على VPS.
قد تختلف النتيجتان على خادم استخدمت عليه الطريقتين، لذلك قارنهما.
which dsh
dsh --version
npx @deepseek-ai/dsh --versionwhich dsh العثور على لا شيء مباشرة بعد نجاح التثبيت العام يعني غالباً أن دليل الملفات التنفيذية العام لـnpm مفقود من PATH. شغّل npm prefix -g لطباعة المسار الجذر، وستجد الملفات التنفيذية في مجلد bin تحته.
ملاحظة أمنية. يجلب npx الشيفرة من السجل وينفّذها كلما حلّ تبعية جديدة، وهذا يمثّل على الخادم تعرّضاً حقيقياً، وليس احتمالاً نظرياً. يُعد تثبيت الإصدار جزءاً من الحل. أما الجزء المتبقي فتجده في كيفية وصول هجمات سلسلة توريد npm إلى الخادم.
ما الذي يعنيه الإصدار التجريبي للمطورين لقابلية إعادة الإنتاج
نُشر 0.1.0-rc.6 في 13 August 2026، ونُشر 0.1.0-rc.7 في 17 August 2026. يفصل بينهما أربعة أيام. ولم يتباطأ الإيقاع منذ ذلك الحين: نُشرت 24 نسخة أخرى بين 19 August و9 October 2026، منها 0.2.0-rc.1 في 28 September و0.2.0-rc.2 في اليوم التالي، ثم نُشرت سبع نسخ أخرى بين 14 و26 October 2026، وصولاً إلى 0.2.1-rc.4. وفق هذا الإيقاع، قد تصف تعليمات كُتبت قبل شهر سطر أوامر لم يعد موجوداً، وينطبق ذلك على هذه الصفحة أيضاً. أضف تاريخاً إلى كل ادعاء يتعلق بإصدار تكتبه، بما في ذلك ملاحظاتك الخاصة.
تجعل عادتان التعامل مع الإصدار التجريبي ممكناً. ثبّت الإصدار الدقيق في كل أمر وكل script، حتى يختار إنشاء الخادم من جديد إصدار dsh نفسه. لكن ذلك لا يعيد إنتاج تبعياته وحده: تستخدم حزمة 0.2.2-rc.1 المنشورة نطاقات مثل js-yaml: ^4.3.2 وcommander: ^15.0.0، وتُشحن من دون npm shrinkwrap. للحصول على عمليات تثبيت تبعيات قابلة للتكرار، احتفظ بـdsh في مشروع محلي مع package-lock.json محفوظ في المستودع، وأعد الإنشاء باستخدام npm ci. ثم اقرأ ناتج المساعدة من البنية المثبّتة بدلاً من قراءته من أي دليل.
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> الـprofile المخزّن في $DSH_HOME/profiles/<name>، وينشئ profile الخاص بـweb وheadless نفسه من القوالب المشحونة عند أول استخدام. يمكن أن يحتوي تصحيح profile على إعدادات النموذج ونقطة النهاية، لكن مفاتيح API المحفوظة توجد في $DSH_HOME/.credentials.yaml، بينما تحتفظ الإعدادات بمراجع بيانات الاعتماد؛ لذلك فإن تثبيت إصدار محدد وامتلاك إعداد صالح أمران منفصلان يجب ضبطهما. يمكن لتصحيحات مستوى home وسطر الأوامر تجاوز إعدادات profile. تُحل الحزم المضمّنة من تثبيت dsh الذي يعمل حالياً، ما يعني أن تغيير الإصدار المثبّت يغيّر تلك الحزم أيضاً. تعمل الإضافات الخارجية بطريقة مختلفة. فهي توجد في دليل profile، ويمرّر dsh plugin --profile <name> add <package> وسائطه إلى pnpm لتثبيتها. لذلك يجب أن يكون pnpm موجوداً في PATH، ويذكر dsh ذلك بوضوح عندما لا يكون موجوداً. تعمل كل إضافة تضيفها بالصلاحيات نفسها التي يملكها agent، ولذلك يجدر بك التحقق مما يمكن لإضافة الوصول إليه قبل تثبيتها. يعلن package.json الخاص بـprofile عن تلك الإضافات؛ حافظ على pnpm-lock.yaml واستخدم pnpm install --frozen-lockfile لإعادة إنتاج إصدارات تبعياتها أيضاً.
سيبدو هذا الفصل مألوفاً إذا كنت قد أبقيت أدوات Python في بيئات معزولة على خادم: تُثبّت الأداة وما تضيفه إليها في موضعين منفصلين. بعد بدء harness، يكون السؤال التالي عادةً متعلقاً بالشبكات لا بالإصدارات. وهنا يأتي دور الوصول إلى واجهة Web لـdsh على VPS بعيد والشرح الأطول في تثبيت DeepSeek Harness على VPS.
أخطاء الوسائط التي ستراها فعلياً
تصدر هذه الأخطاء من محلّل الوسائط الخاص بواجهة CLI، ويذكر كل خطأ المشكلة المحددة. ظلّت الصياغة ثابتة في معظم الإصدارات، لكن ليس كلها، لذلك جرى التحقق من الرسائل أدناه مقابل 0.2.0-rc.2 في 6 October 2026.
error: --profile <name> is required
شغّلت npx @deepseek-ai/dsh من دون أمر فرعي ومن دون profile. يشغّل الأمر المجرّد profile، لذلك يحتاج إلى اسم. يعمل dsh web من دون --profile لأن المحلّل يقرأ الكلمة الأولى المجرّدة باعتبارها اسم profile، ثم يشغّل profile web المضمّن نيابةً عنك.
error: --patch needs a path
مرّرت --patch من دون قيمة تليه. يمكن تكرار هذا الخيار، ويحتاج كل ظهور له إلى مسار ملف واحد.
error: --dump-config and --dump-default-config are mutually exclusive
اختر أحدهما. في 0.2.0-rc.2، كان الإصدار latest المشار إليه في 6 October 2026 يعرض رسالة تذكر خياراً ثالثاً، وتكون صياغتها error: --dump-config, --dump-default-config, and --dump-config-schema are mutually exclusive، لأن --dump-config-schema، الذي يطبع JSON Schema لإدخالات profiles وpatches، انضم إلى الخيارين الآخرين. يطبع --dump-default-config طبقات الحزمة المضمّنة ولا يقبل أي --patch. يطبع --dump-config الإعدادات المركّبة لـprofile. تتجنب الخيارات الثلاثة بدء harness، لكن جمع schema يستورد وحدات الإضافات وقد يستدعي getters وlazy builders؛ لذلك افحص الإضافات الموثوقة فقط، وفرض مهلة زمنية خارجية في السكربتات.
error: plugin needs pnpm arguments to forward (e.g. add <package>)
لم يتلقَّ dsh plugin --profile <name> أي شيء لتمريره. يهيّئ الأمر الفرعي profile إذا لم يكن موجوداً، ثم يمرّر بقية سطر الأوامر إلى pnpm، لذلك يحتاج إلى وسائط مثل add @scope/dsh-plugin-example.
FAQ
ما إصدار Node.js الذي يحتاج إليه DeepSeek Harness؟
يحتاج إلى Node.js 24.9.0 أو إصدار أحدث. عند التحقق في 27 October 2026، ومع كون المستودع في الإصدار 0.2.1-rc.3، يعلن الجذر package.json عن >=24.9.0. وفي 10 October 2026 كان يعلن ^22.19.0 || >=24.0.0، لكن مذكرة قرار للمشروع مؤرخة في 15 October 2026 أسقطت Node 22 ورفعت الحد الأدنى إلى ما بعد 24.0. لن يعمل Node 20 ولا Node 22، كما لن يعمل أي إصدار من Node 24 أقدم من 24.9.0. وحتى 27 October 2026، لم يكن لأي إصدار منشور من npm حقل engines خاص به، لذلك لم يكن npm يستطيع التحذير أو المنع استناداً إلى متطلب dsh الخاص بإصدار Node، وكان وقت التشغيل غير المدعوم يفشل لاحقاً بدلاً من ذلك. أما حزمة 0.2.2-rc.1 المنشورة، التي جرى التحقق منها في 6 November 2026، فتعلن الآن >=24.9.0 في engines.node؛ ويصدر npm تحذيراً افتراضياً ويرفض وقت التشغيل غير المتوافق عند تفعيل engine-strict. تحقّق أولاً من node -v. كل إصدار من Node يحقق الحد الأدنى يضم npm 11 أو إصداراً أحدث، بما في ذلك إصلاح range-cache في npx الذي أُدخل في npm 11.2.0.
كيف أجبر npx على استخدام أحدث إصدار من dsh بدلاً من إصدار مخزّن مؤقتاً؟
يعيد npm 10.9.3 وإصدارات npm الحالية التحقق من السجل عند استخدام اسم حزمة مجرد، إلا إذا كان الدليل الحالي مشروعاً مثبّتاً فيه dsh؛ ففي هذه الحالة يشغّل npx النسخة المحلية. استخدم npx @deepseek-ai/dsh@latest --version لطلب وسم latest من السجل صراحةً. غيّر npm 11.2.0 فحوصات حداثة نطاقات الإصدارات، وليس الأسماء المجردة. امسح ذاكرة npx المؤقتة باستخدام npm cache npx rm --force في npm 11.2.0 والإصدارات الأحدث، أو احذف المجلد باستخدام rm -rf "$(npm config get cache)/_npx" في npm 10. ثم تحقّق باستخدام npx @deepseek-ai/dsh --version. لاحظ أن npm cache clean --force يمسح دليلاً مختلفاً، ولن يحل هذه المشكلة.
لماذا يفشل تثبيت @deepseek-ai/dsh@^0.1.0؟
في 27 October 2026، أعاد npm رمز الخطأ ETARGET مع السطر No matching version found for @deepseek-ai/dsh@^0.1.0.. كان كل إصدار منشور عند إجراء ذلك التحقق إصداراً تمهيدياً، مثل 0.2.0-rc.2 أو 0.2.1-alpha.2، ولا يطابق نطاق semver الإصدارات التمهيدية إلا إذا سمّى النطاق نفسه إصداراً تمهيدياً يحمل أرقام major وminor وpatch نفسها. ثبّت سلسلة الإصدار الدقيقة، بما في ذلك اللاحقة. شغّل npm view @deepseek-ai/dsh versions --json لمعرفة الإصدارات الموجودة، لأن التسلسل يتضمن فجوات.
هل ينبغي أن أثبّت dsh عالمياً أم أشغّله عبر npx؟
يناسب npx التجربة الأولى، لأن الحزمة تبقى في دليل ذاكرة التخزين المؤقت الخاص به؛ كما ينشئ harness حالة ملف تعريف دائمة. ويناسب التثبيت العالمي المثبّت على إصدار محدد، مثل npm install -g @deepseek-ai/dsh@0.1.0-rc.7، أي شيء يجب أن يواصل العمل، لأن الإصدار لا يتغير إلا عند تغييره يدوياً. إذا لم يُعثر على الأمر dsh بعد التثبيت العالمي، فهذا يعني أن دليل bin العالمي الخاص بـ npm غير موجود في PATH لديك، ويطبع npm prefix -g الجذر الذي يوجد تحته.
هل أصبح DeepSeek Harness مستقراً بما يكفي للبناء عليه؟
ليس بعد، وفقاً لوصفه نفسه. يذكر README أن المشروع في مرحلة معاينة للمطورين، وأنه يتطور بسرعة، وأنه سيشهد تغييرات تكسر التوافق. نُشرت إصدارات release candidate 0.1.0-rc.6 و0.1.0-rc.7 بفاصل أربعة أيام في August 2026، ونُشر الإصداران 0.2.0-rc.1 و0.2.0-rc.2 بفاصل يوم واحد في September 2026، كما نُشر الإصداران 0.2.1-rc.1 و0.2.1-rc.2 في اليوم نفسه خلال October 2026. وتغير نطاق Node المدعوم في October 2026 أيضاً. ثبّت إصداراً دقيقاً، واقرأ --help من تلك الحزمة المثبّتة بدلاً من قراءته من أي دليل. أضف تاريخاً إلى ملاحظاتك، حتى تتمكن من معرفة مدى تقادمها.