كيفية تثبيت DeepSeek Harness (dsh): أمر npx في سطر واحد، البناء من المصدر، الوضع بدون واجهة رسومية، والإضافات

To install Deep​Seek Harness (dsh), the open-source agent runtime Deep​Seek shipped on August 13, 2026, run npx @deepseek-ai/dsh web on a machine with Node.js 22.19 or newer. That one command downloads the 0.1.0-rc.6 preview, starts a local web UI at http://127.0.0.1:3080, and walks you through adding a model API key and a workspace on first launch. Two things to know before you start: dsh is not a model — it's the harness layer that connects a model to tools, files, and a terminal — and it's a developer preview, so expect breaking changes between releases. This guide covers both official install methods, headless mode, plugins, MCP, and the honest rough edges.

ما هو Deep​Seek Harness — وما ليس هو

الصيغة الداخلية لـ Deep​Seek، والتي أكدها الباحث الكبير تشن ديلي، هي Model + Harness = Agent. النموذج هو الدماغ؛ الحزام هو كل ما يحوّله إلى شيء ينجز العمل: إدارة السياق والذاكرة، استدعاء الأدوات، تخطيط المهام، قراءة وكتابة الملفات، تنفيذ أوامر الطرفية، التغذية الراجعة للأخطاء، وتحديد متى تكتمل المهمة. Deep​Seek Harness هي تلك الطبقة، مفتوحة المصدر بموجب رخصة MIT في 13 أغسطس 2026 — في نفس اليوم الذي وصل فيه إصدار DeepSeek V4 Pro 0813 إلى Deep​Seek API.

حقيقتان تحددان تجربة التثبيت. أولاً، البنية هي «كل شيء عبارة عن إضافة»، مبنية على Cordis، وهي حاوية إضافات TypeScript — لذا ما تثبته هو نواة صغيرة بالإضافة إلى مجموعة إضافات توفر محولات النماذج والأدوات والجلسات وواجهة المستخدم. ثانيًا، الإصدار على npm اليوم هو 0.1.0-rc.6، وهو إصدار مرشح (RC) يصفه المشروع نفسه بأنه معاينة للمطورين: يحذّر ملف README، بأحرف كبيرة، من أن تغييرات تكسر التوافق قادمة. الشعبية حقيقية — 50,000 نجمة على GitHub خلال أول 12 ساعة، و100,000 خلال حوالي 42 ساعة، وتجاوزت 120,000 بحلول 16 أغسطس وفقًا للصحافة التقنية الصينية — لكن النجوم تقيس الاهتمام، لا الاستقرار. خطط لتثبيتك كما تخطط لمعاينة: سريعة للتجربة، ورخيصة للتخلص منها.

قبل أن تبدأ: متطلبات النظام الفعلية

الشرط الصارم الوحيد هو Node.js. يستهدف المشروع نطاق إصدارات المحرك ^22.19.0 || >=24.0.0 — بعبارة واضحة، Node 22.19 أو أحدث، أو أي Node 24.x. تحقق من إصدارك باستخدام node --version. إذا كنت على إصدار أقدم من Node، فسيفشل تثبيت npx أو يتصرف بشكل سيئ، ولن يتدهور بشكل سلس.

كل شيء آخر أخف مما يفترضه جمهور النموذج أولًا:

• مفتاح API للنموذج. dsh يشغّل نموذجًا حقيقيًا؛ يحتاج إلى مفتاح لواجهة برمجة تطبيقات Deep​Seek أو أي موفّر متوافق مع Open​AI تقوم بإعداده. يمكنك إضافة مفتاح في واجهة الويب بعد أول تشغيل.

• pnpm — فقط للبناء من المصدر. ثبّته مرة واحدة باستخدام npm install -g pnpm.

• حوالي 1 غيغابايت من مساحة القرص الحرة لحزمة npm، ومساحة العمل، وسجلات الجلسة، بالإضافة إلى ما قد تحتاجه أي نموذج محلي (dsh نفسه لا يشغّل الأوزان).

• نظام التشغيل: تعمل طريقة npm على أنظمة Windows وmacOS وLinux. أما Python SDK فنطاقه أضيق (Linux x64/arm64 وmacOS 14+ arm64 — لا يوجد دعم أصلي لـ Windows)، وسيتم تناوله أدناه.

أنت لا تحتاج إلى وحدة معالجة رسومية. الإطار ينسق فقط؛ النموذج يعمل عن بُعد عبر واجهة برمجة التطبيقات.

الطريقة 1 — أمر npx في سطر واحد (موصى به لمعظم المستخدمين)

البدء السريع الرسمي هو أمر واحد، وهو بالفعل أمر واحد:

npx @deepseek-ai/dsh web

npx fetches the @deepseek-ai/dsh package (current version 0.1.0-rc.6), installs it into npm's cache, and starts the Web UI profile. Watch the output for the line that tells you it's listening — by default that is http://127.0.0.1:3080. Open it in your browser. Note the 127.0.0.1 loopback address: the UI binds to localhost only, which is the right default for a tool that can read and write files in your workspace — it also means you won't casually expose it on your network.

يتضمن أول تشغيل خطوتين فقط للإعداد:

• أضف مفتاح نموذج. الإعدادات → النماذج → أدخل مفتاح API الخاص بك. يتم تخزينه في $DSH_HOME/.credentials.yaml ولا يظهر كنص صريح بعد ذلك. في التثبيت الافتراضي، DSH_HOME يكون افتراضيًا إلى ~/.dsh.

• اختر مساحة عمل.أضف دليل المشروع الذي يُسمح لـ dsh بالعمل فيه. يبقى الإدخال مقفلاً حتى اكتمال الخطوتين.

ثم أرسل مهمة أولى — اختبار دخان جيد هو "لخّص هذا المستودع وحدد حزمه الرئيسية." إذا عاد الملخص وظهرت استدعاءات الأدوات في أثر التشغيل، فالتثبيت يعمل.

الطريقة 2 — البناء من المصدر

هل تفضل التشغيل من المستودع؟ المسار الرسمي هو:

git clone https://github.com/deepseek-ai/deepseek-harness.git

cd deepseek-harness

pnpm install

pnpm run build

pnpm dsh web

تحتاج إلى pnpm لهذا الغرض (يثبّت المساهمون pnpm 11.7.0). اختر البناء من المصدر إذا أردت تشغيل أحدث نسخة main بدلاً من الإصدار المرشح المنشور، عندما تخطط لقراءة أو تعديل منظومة البناء، أو عندما تريد بناء إعداد مخصص من مجلد المستودع apps/cli/config/agent-presets/. بالنسبة للآخرين، فإن مسار npx هو نفسه البرنامج لكن بإجراءات أقل — فالبناء من المصدر لا يضيف ميزات تفتقر إليها حزمة npm.

الملفات الشخصية الثلاثة: web وheadless وtui

dsh يأتي بثلاثة أنماط تشغيل، ويعتمد النمط الذي تستخدمه على مكان حدوث العمل:

• web (الافتراضي) — واجهة المتصفح الكاملة على المنفذ 3080. هذا ما npx @deepseek-ai/dsh web يبدأه، وهو الملف الشخصي الذي سيثبّته معظم الأشخاص أولاً.

• headless — مهمة واحدة، ثم الخروج. dsh --profile headless "run the test suite and report failures" يبدأ جلسة، وينفّذ المهمة، ويكتب نتائجها، ثم ينهيها. بيئة التشغيل headless هي عملية لمهمة واحدة فقط بشكل صريح: لا يمكنك إدراج متابعات أثناء التشغيل، والتصحيحات هي تشغيل جديد على نفس مساحة العمل. هذا هو الوضع الذي يجب ربطه بالبرامج النصية وCI.

• tui — واجهة طرفية للجلسات التي تُدار بلوحة المفاتيح: dsh --profile tui.

الثلاثة جميعًا تشترك في نفس الإعداد (~/.dsh/profiles/<name>/) وبنفس نظام الإضافات، لذا نقل مهمة من واجهة الويب إلى وضع بدون واجهة (headless) هو مجرد تبديل أمر، وليس إعادة تثبيت.

إضافة الإضافات

إدارة الإضافات هي أمر CLI من الدرجة الأولى، وليست مسألة تحرير في موضعها:

npx @deepseek-ai/dsh plugin --profile web add <source>

يمكن أن يكون المصدر اسم حزمة npm، أو مستودع GitHub (github:user/repo)، أو ملف tarball، أو مجلد محلي. أول تثبيت مفيد هو سوق الإضافات الرسمي، الذي يحوّل اكتشاف الإضافات إلى واجهة مستخدم:

npx @deepseek-ai/dsh plugin --profile web add dshmarket

ثم أعد تشغيل خدمة الويب وافتح الإعدادات ← سوق الإضافات لتصفح الكتالوج وتثبيت الإضافات بنقرة واحدة. وهناك قاعدتان يخطئ فيهما الناس كثيرًا: حزم الإضافات تُحمَّل عند بدء تشغيل الملف الشخصي، لذا تحتاج الإضافة المضافة حديثًا إلى إعادة تشغيل dsh web؛ ومجرد npm installلا يسجّل إضافة في ملف شخصي — يجب عليك استخدام dsh plugin. النظام البيئي جديد لكنه ليس فارغًا: قائمة awesome-dsh-plugin التي يحافظ عليها المجتمع تضم بالفعل مئات الإضافات عبر فئات مثل واجهة المستخدم، والمهارات، والأدوات، والموفّرين، والإشعارات.

MCP، والإعدادات المسبقة الأربعة، وإعادة تشغيل المسار

ثلاث ميزات تصبح مهمة بمجرد تجاوز التثبيت الأساسي:

MCP.يتواصل dsh عبر بروتوكول سياق النموذج من خلال إضافة مدمجة @deepseek-ai/dsh-mcp-client، وهي الإضافة. حاليًا يتم تكوين ذلك في ملفات، وليس في واجهة المستخدم: تعدّل ~/.dsh/profiles/web/cordis.patch.yml (أو رقعة محلية للمشروع) وتصرّح بآلية نقل كل خادم — stdio للأوامر المحلية مثل npx @playwright/mcp@latest، streamable-http لروابط الويب البعيدة. إنه يعمل، لكنه السطح الأقل صقلًا في المعاينة؛ توقع عدم استقرار بين الحين والآخر وغياب واجهة رسومية لتبديل الخوادم.

الإعدادات المسبقة.يقوم dsh بتحميل واحد من أربعة إعدادات مسبقة للوكيل في كل جلسة، وكل منها يمثل مفاضلة مختلفة:

• القياسي — مجموعة الأدوات الكاملة: تحرير الملفات، الطرفية، استرجاع الملفات والويب، المهارات، التخطيط، الوكلاء الفرعيون، سير العمل. الخيار الافتراضي اليومي.

• PTC (استدعاء الأدوات برمجيًا) — الإصدار القياسي بالإضافة إلى Code Mode SDK الذي يتيح للنموذج كتابة برامج TypeScript لتنسيق استدعاءات أدوات متعددة الجولات. أكثر قوةً، وتأثيرات جانبية أكبر.

• الحد الأدنى — فقط bash ومحرر ملفات، لا شيء آخر. مبني لقياس أداء النماذج وإعادة الإنتاج بأقل قدر ممكن؛ وهو الوضع الذي أشارت إليه وثائق DeepSeek V4 Flash API عندما كشفت عن نتائج وكلائها، حيث كان يعمل على "Deep​Seek Harness minimal mode."

• الإنشاء — منصة تجارب تشغيلية: افحص إضافات Cordis وحمّلها في الذاكرة، وجرّب، ثم ثبّت تركيبة ناجحة في إعداد مسبق جديد.

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

خيار Python SDK

إذا كنت تفضل قيادة المحرك من بايثون بدلاً من المتصفح، فهناك SDK رسمي: pip install deepseek-harness-sdk. فهو يضمّ وقت تشغيل dsh (عجلة pip تحمل وقت تشغيل Node، لذلك لا حاجة لتثبيت Node منفصل)، والاستخدام عبر مدير سياق: أنشئ Deep​SeekHarness مثيلًا، ثم استدعِ run("task"). وهو يرث متغيرات البيئة المعيارية مثل DEEPSEEK_API_KEY و DEEPSEEK_BASE_URL، لذا تغيير المزوّد هو مجرد تغيير إعدادات. المشكلة: يتطلب Python 3.10+ ويدعم Linux x64/arm64 و macOS 14+ arm64 فقط — لا توجد حزمة Windows أصلية، وهي فجوة حقيقية إذا كان نظامك Windows. على Windows، التزم بمسار npm.

توجيه dsh نحو النماذج التي تدفع مقابلها

يحتاج dsh إلى مفتاح API للنموذج، وهو غير مرتبط عمدًا بمزوّد معيّن: الإعدادات ← النماذج تقبل مزوّدًا مخصصًا بعنوان URL أساسي متوافق مع Open​AI (في settings.yaml أي api: openai-completions، baseURL، و models كقائمة). الافتراضي هو واجهة برمجة تطبيقات Deep​Seek الخاصة؛ والمزوّد المخصص هو حيث تصبح بوابة التوجيه مفيدة.

OrcaRouter is an Open​AI-compatible endpoint that passes Deep​Seek's list price through with zero markup — https://api.orcarouter.ai/v1. That gives you DeepSeek V4 Flash (deepseek/deepseek-v4-flash-0731, about $0.15 per million input tokens and $0.29 per million output) and DeepSeek V4 Pro (about $0.44/$0.88), both at provider list price with no token markup, plus automatic failover if a provider wobbles. For dsh, the practical win is that you can run the cheap V4 Flash for the bulk of everyday agent tasks and switch the same harness to V4 Pro for the hard passes — one key, one base URL, and the swap is a model name in the settings, not a reinstall.

لتوضيح الحدود: يستضيف OrcaRouter النماذج استدعاءات dsh؛ فهو لا يستضيف dsh نفسه. dsh هو بيئة تشغيل محلية للوكلاء، وتقوم بتشغيله على جهازك الخاص.

أين يكون هذا الدليل خاطئًا بالنسبة لك — مشاكل صريحة في المعاينة

دليل التثبيت الذي يخبرك فقط بما يجب كتابته يؤدي نصف المهمة. إليك ما تُخطئ فيه المعاينة اليوم، حتى لا تكتشف ذلك في الثانية فجرًا:

• التغييرات الجذرية هي وعد، وليست تحذيرًا. أنت على إصدار 0.1.0-rc.6. مفاتيح الإعداد، وواجهة برمجة تطبيقات الإضافات، وصيغ الإعدادات المسبقة قد تتغير دون إشعار. عامل ~/.dsh كحالة يمكن التخلص منها — فتكلفة التحديث السيئ هي إعادة تثبيت، وهذا مقبول في هذه المرحلة فقط لأن التثبيت هو أمر واحد.

• لا تحتاج إلى dsh لاستخدام نماذج Deep​Seek كوكيل.إذا كان هدفك الوحيد هو استخدام DeepSeek V4 Flash أو DeepSeek V4 Pro داخل وكيل اليوم، فإن نقطة نهاية Deep​Seek المتوافقة مع Anthro​pic تعمل بالفعل في Claude Code وأدوات الوكلاء الأخرى دون أي برنامج جديد. dsh خيار من الطرف الأول، وليس شرطًا مسبقًا. تخطَّ هذا التثبيت حتى ترغب تحديدًا في الإطار الأصلي.

• MCP يتم تكوينه عبر الملفات وغير مستقر أحيانًا. لا توجد واجهة رسومية، ولا يوجد مفتاح تشغيل/إيقاف لكل خادم، وتصف التقارير العملية أعطالًا متقطعة. خصص وقتًا لتصحيح أخطاء YAML إذا كانت سير عملك تعتمد على خوادم MCP.

• الثقة في الإضافات قرار أمني. تعمل إضافات الطرف الثالث داخل العملية الأساسية للمنصة، ولا يوجد تحقق من التوقيع الرقمي أو المصدر عند التثبيت. ثبّت فقط الإضافات التي قرأتها أو التي تأتي من مصدر تثق به، واختبرها في مساحة عمل مؤقتة قبل توجيهها إلى عمل حقيقي. يمكن لملف تعريف وضع الحماية danger-full-access تعديل أي ملف مرئي — اقتصر استخدامه على نسخ العمل المؤقتة.

• توجد أخطاء معروفة في المعاينة. حلقة bash المعلّقة هي نمط فشل موثّق (قم بالمقاطعة وإعادة المحاولة)، ولا يزال سلوك الجلسات طويلة الأمد قيد الاستقرار.

• الإصدارات المكتبية غير الرسمية فخ. تقوم عدة أغلفة من المجتمع بتغليف dsh كتطبيق مكتبي قابل للتثبيت بنقرة واحدة مع وقت تشغيل Node مدمج. إنها تعمل، لكنها غير موقعة وغير مدعومة من Deep​Seek؛ إذا استخدمت أحدها، فأنت تأتمن طرفًا ثالثًا على أداة ستمتلك صلاحيات نظام الملفات لديك.

• إذا كنت بحاجة إلى استقرار الإنتاج، فانتظر إصدارًا غير rc. الإطار قوي لكنه غير ناضج. بالنسبة لحزمة وكيل إنتاجية، فإن إطارًا ناضجًا ومُختبَرًا في المعارك — أو مسار نقطة النهاية المتوافق مع Anthro​pic — هو الخيار المنطقي حتى يصل dsh إلى وسم مستقر.

خلاصة القول

تثبيت Deep​Seek Harness هو في الحقيقة مهمة أمر واحد على أي جهاز يعمل بـ Node 22.19+: npx @deepseek-ai/dsh web، وأضف مفتاح نموذج ومساحة عمل، وأرسل مهمة اختبار. اختر البناء من المصدر فقط إذا أردت تعديل أو تتبع main؛ استخدم headless للنصوص البرمجية؛ وأضف سوق الإضافات مبكرًا؛ وتعامل مع MCP باعتباره عملًا قيد التطوير. التحذير الصادق هو نفسه الذي يذكره المشروع في ملف README الخاص به: هذه نسخة معاينة 0.1.0-rc وستكسر بعض الأمور في الطريق إلى الاستقرار. إنها مقايضة مناسبة إذا أردت أن ترى إلى أين يتجه Deep​Seek بطبقة الوكلاء — والنماذج التي يشغّلها، DeepSeek V4 Flash وDeepSeek V4 Pro، متوفرة اليوم بسعر القائمة عبر OrcaRouter، جاهزة لتشغيل Harness على الجانب الآخر من التثبيت.