كيفية تشغيل DeepSeek Harness على VPS بأمان
تعلم كيفية تثبيت DeepSeek Harness على خادم Linux مع تثبيت إصدار npm وتأمين المنفذ 3080 عبر نفق SSH. احمِ وكيلك من الوصول غير المصرح به باتباع خطواتنا التقنية الدقيقة.
ما هو DeepSeek Harness
إن DeepSeek Harness (dsh) هو بيئة تشغيل لوكيل Node.js يمكنك تشغيلها على VPS (خادم افتراضي خاص). والطريقة الآمنة لتشغيله هي ربطه بـ 127.0.0.1، ثم الوصول إليه من المتصفح عبر نفق SSH (صدفة آمنة). يوفّر واجهة ويب (واجهة مستخدم) على المنفذ 3080 بدلاً من العمل داخل الطرفية. في الإصدار 0.1.0-rc.6 الذي يثبّته هذا الدليل، لا يطلب خادم الويب كلمة مرور خاصة به. لذلك، فإن نشر المنفذ 3080 يتيح لأي شخص يعثر عليه استخدام وكيل يقرأ ملفاتك وينفّذ الأوامر بصلاحيات مستخدم Linux الخاص بك. في الإصدارات الأحدث، من 0.2.0-rc.2 إلى 0.2.2-rc.2 من 11 نوفمبر 2026، وهو أحدث إصدار يعرضه GitHub في 12 نوفمبر 2026، يطبع البرنامج عنوان URL عند بدء التشغيل يحمل رمزاً مميزاً جديداً لهذه العملية، ثم يستبدله بملف تعريف ارتباط للجلسة. لكنه يظل يستمع على loopback افتراضياً، ويرفض أيضاً الارتباط بكل الواجهات.
تنشر DeepSeek البرنامج بموجب رخصة MIT، على هيئة حزمة npm باسم @deepseek-ai/dsh. ويصف المشروع نفسه بأنه معاينة للمطورين، ويذكر أن التغييرات التي تكسر التوافق متوقعة. الإصدار المثبّت أدناه هو إصدار أغسطس 2026. في 12 نوفمبر 2026، يحدّد الوسم latest في npm الإصدار 0.2.2-rc.1. ويعرض GitHub الإصدار الأحدث قبل النهائي 0.2.2-rc.2، الذي يحمل الوسم dsh-v0.2.2-rc.2 وصدر في 11 نوفمبر 2026. تحقّق من المستودع قبل نسخ أي جزء منه إلى خادم مهم.
تقوم فكرة واحدة على التصميم كله: كل شيء عبارة عن plugin. فمحوّل النموذج، وسجل الأدوات، وسجل الجلسة، وsandbox، والمجدول، وحلقة الوكيل نفسها، كلها plugins تُحمّل في سياق مشترك واحد، ويمكن استبدال أي منها. لا توجد نواة ذات صلاحيات خاصة تقتصر plugins على تزيينها. هذا ما يجعل تجربة harness مفيدة، وهو أيضاً موضع الخطر الحقيقي الوحيد. ويعتمد ما إذا كانت هذه المقايضة مناسبة على المعيار الذي تقارنها به. يضع مقارنتها مع Claude Code وOmnigent تصميم كل شيء على هيئة plugin إلى جانب إجابتين أخريين عن مدى الارتباط بالنموذج، والرخصة، ومقدار موارد VPS التي يطلبها كل خيار.
الـharness ليس نموذجاً
يشغّل الـharness حلقة الوكيل. يحدث الاستدلال في نموذج موجود في مكان آخر، لذلك لن يعمل شيء قبل تزويده إما بمفتاح API أو بعنوان endpoint لنموذج تستضيفه بنفسك. كل ما يرد في هذا المنشور يتعلق بإعداد الـharness وليس بسلوك النموذج، ومن المفيد فهم الحد الفاصل بينهما قبل أن تقضي فترة بعد الظهر في تصحيح المشكلة لمعرفة أي جانب تسبب بها.
تضبط ذلك في واجهة المستخدم ضمن Settings ثم Models. لدى DeepSeek بطاقة خاصة به، وفي الإصدارات الحالية يفتح زر "Add model provider" الموجود أسفله وضعين. يغطي "Third-party model provider" المزوّدين الذين يوفّر لهم الـharness فهرساً، مثل OpenAI وAnthropic، حيث تلصق مفتاحاً ويتولى الفهرس توفير الـendpoint وقائمة النماذج. أما "Custom model API" فهو الخيار المهم: إذ يتطلب provider ID بأحرف صغيرة، واسم عرض، وbase URL، وبروتوكول API، وبيانات اعتماد، ونموذجاً واحداً على الأقل. يوفّر محدد البروتوكول OpenAI Chat Completions وOpenAI Responses وAnthropic Messages وGemini API، لذا يمكنك إعداد gateway أو خادم محلي يتحدث بأحد هذه البروتوكولات؛ أما الـendpoints التي تختلف في تنسيق الطلبات فتحتاج إلى إعدادات توافق. ويمكن للمزوّدين المخصصين أيضاً الاستعلام عن endpoint المتوافق مع OpenAI GET /models لملء قائمة النماذج نيابة عنك.
بهذه الطريقة توجّه الـharness إلى نموذج موجود على VPS نفسه. يوفّر Ollama واجهة API متوافقة مع OpenAI على http://127.0.0.1:11434/v1/، ويقبل حقل مفتاح API أي سلسلة نصية، وتكون ollama هي القيمة المتعارف عليها، لأن العميل بأسلوب OpenAI يتطلب قيمة ويتجاهلها Ollama. توضّح وثائق Ollama أيضاً ollama launch dsh، الذي يثبّت @deepseek-ai/dsh إذا لم يكن موجوداً ويشغّله باستخدام نموذج Ollama، لذلك تحقّق من الإصدار الذي يثبّته قبل الاعتماد على التثبيت المحدد أدناه. أما السؤال الأصعب فهو ما إذا كان نموذج صغير بما يكفي للعمل على VPS لديك مناسباً لتشغيل وكيل، ويحدد الفرق بين Ollama وvLLM كخادم نموذج محلي مقدار الذاكرة RAM التي ستستهلكها الإجابة.
المفاتيح التي تكتبها في واجهة المستخدم لا يمكن قراءتها منها. يخزّنها الـharness في $DSH_HOME/.credentials.yaml، ولا تحتفظ الإعدادات إلا بمرجع إلى بيانات الاعتماد، وتكتبه الإصدارات الحالية في ملف patch الخاص بالـprofile النشط، $DSH_HOME/profiles/<profile>/cordis.patch.yml (ويكون الـprofile هو web لـ dsh web). وتكون $DSH_HOME هي القيمة الافتراضية لـ ~/.dsh. تعامل مع ملف بيانات الاعتماد باعتباره ملف كلمات مرور، لأنه كذلك: فأي شخص يقرأه يستطيع استهلاك ميزانية API الخاصة بك. إذا أردت تعديل هذه الملفات مباشرة بدلاً من التنقل عبر Settings، يوضح الشرح الخاص بملفات إعدادات dsh والمفاتيح وmodel endpoints وظيفة كل مفتاح وما الذي يغادر خادمك في كل وضع.
ما تحتاج إليه قبل التثبيت
- خادم VPS يعمل بنظام Ubuntu 24.04 أو توزيعة Linux حديثة أخرى، مع إمكانية الوصول عبر SSH
- Node.js 24.9 أو أحدث، لأن الفرع الرئيسي للمشروع و
0.2.2-alpha.2يعلنان الآن>=24.9.0، كما تختبر CI الإصدار Node 24 مع فحص توافق على Node 24.9 وNode 26، من دون مهمة لاختبار Node 22؛ أما الإصدارات الموسومة حتى0.2.1-rc.4فما زالت تدرج Node 22.19 كإصدار مقبول، لكن ذلك لم يعد الحد الأدنى الذي يبني المشروع عليه - حساب مستخدم عادي، وليس
root، لأن الوكيل ينفذ أوامر shell بصلاحيات المستخدم الذي بدأ العملية pnpmضمن PATH إذا كنت تخطط لتثبيت الإضافات، لأن أمر الإضافة يستدعيه لتنفيذ الأوامر- إغلاق المنفذ 3080 في جدارك الناري وفي جدار الشبكة المنفصل لدى مزود الخدمة
حزمة nodejs الخاصة بـUbuntu 24.04 أقدم من الإصدار الذي يحتاج إليه إطار الاختبار، لذلك ثبّت Node من NodeSource أو nvm في هذا الإصدار بدلاً من استخدام apt install nodejs. يسرد المستودع الرسمي لـUbuntu 26.10 الإصدار Node 24.19.0، وهو يتجاوز الحد الأدنى Node 24.9. إذا كان خادم VPS جديداً، فسيستغرق تأمين SSH قبل أي شيء آخر عشر دقائق، لأن النفق الذي ستعتمد عليه لا يكون آمناً إلا بقدر أمان خادم SSH الذي يقف خلفه.
ثبّت DeepSeek Harness على VPS باستخدام إصدار محدد
node --version
npx @deepseek-ai/dsh@0.1.0-rc.6 webينزّل npx الحزمة ويشغّل الملف التنفيذي dsh الخاص بها. web هو اسم مستعار لـ --profile web، الذي يشغّل تطبيق المتصفح، وتطبع العملية العنوان الذي تستمع عليه. القيمة الافتراضية هي http://127.0.0.1:3080. هذه الأرقام قرار ملزم وليست قيمة افتراضية شكلية، ويوضح سبب طباعة dsh لعنوان loopback ما الذي سيستجيب له الـharness وما لن يستجيب له قبل أن تبحث عنه من حاسوبك المحمول.
ثبّت الإصدار. يحل npx @deepseek-ai/dsh web الوسم الذي يشير إليه latest في لحظة تشغيل الأمر، إلا إذا كان المشروع الذي تشغّله منه يحتوي مسبقاً على نسخة مثبتة، ففي هذه الحالة يستخدم npx تلك النسخة بهدوء. في كلتا الحالتين، أنت لا تختار الإصدار، وقد أصدر المشروع عدة إصدارات مرشحة ويذكر أن تغييرات كاسرة للتوافق قادمة. 0.1.0-rc.6 هو إصدار August 2026 المثبت هنا. في 12 November 2026 يشير latest إلى 0.2.2-rc.1، وهو إصدار يطبع عنوان بدء تشغيل يحتوي على token؛ ويسرد GitHub الإصدار الأحدث قبل النهائي 0.2.2-rc.2، لذلك فإن الانتقال إلى إصدار آخر هو بالضبط نوع الترقية التي ينبغي تنفيذها عمداً بعد قراءة المستودع. يعني تثبيت الإصدار أن الخادم الذي تجهزه اليوم سيتصرف بالطريقة نفسها في الشهر المقبل، ولذلك تصبح الترقية قراراً تتخذه بدلاً من أن تكون حادثة تكتشفها. عندما يشغّل أمر مثبت الإصدار build خاطئاً أو يرفض التثبيت تماماً، يوضح أخطاء تثبيت dsh والإصدار المعتادة كيفية مسح ذاكرة npx المؤقتة والتحقق من npm الذي يرفقه Node.
للاستخدام اليومي، ثبّته مرة واحدة بدلاً من إعادة حل الإصدار عند كل تشغيل.
npm install -g @deepseek-ai/dsh@0.1.0-rc.6
dsh --profile web --helpيستحق السطر الثاني تشغيله، لأن launcher وتطبيق الويب يستخدمان مجموعتي flags منفصلتين. يعرض dsh --help الخيارات الخاصة بـlauncher. ويعرض dsh --profile web --help الـflags التي يقبلها تطبيق الويب، ومنها --port و--host و--trusted-host القابل للتكرار.
تحقق الآن من المنفذ الذي يستمع عليه.
ss -tlnp | grep 3080ينبغي أن يقرأ عمود العنوان المحلي 127.0.0.1:3080. إذا قرأ 0.0.0.0:3080، فإن واجهة المستخدم تستمع على جميع الواجهات، ولذلك لا يفصلها عن الإنترنت سوى جدران الحماية لديك. أوقف العملية قبل أن تفعل أي شيء آخر.
لماذا يجب ألا تنشر المنفذ 3080 مطلقاً
لا يحتوي خادم الويب في 0.1.0-rc.6 على طبقة مصادقة. يعرّف إعداده مضيف الاستماع ومنفذ الاستماع، وهذا هو كامل سطح التعرض. أمّا التحكم في الوصول عند النشر على عنوان غير loopback فهو إعداد منفصل للمضيفات الموثوقة، وليس شاشة تسجيل دخول.
تضيف الإصدارات الأحدث طبقة مصادقة. بدءاً من 0.2.0-rc.2، تطبع عملية بدء التشغيل عنوان URL يتضمن رمزاً مميزاً جديداً لهذه العملية. يتلقى المتصفح الذي يفتح العنوان ملف تعريف ارتباط موقّعاً للجلسة، ثم يُعاد توجيهه إلى العنوان نفسه من دون الرمز. ولا تقبل آلية التحقق من Host/Origin أمام مسارات /api إلا loopback، وعنوان الربط الخاص بالمستمع، والمضيفات التي تحددها باستخدام --trusted-host. هذا اعتماد حقيقي، لكن وثائق المشروع نفسها تحذّر من أن عنوان URL المطبوع هو اعتماد لا ينبغي مشاركته إلا مع المستخدمين المقصودين، وأن HTTP العادي يرسله من دون تشفير. وبدءاً من 0.2.1-alpha.2، يمكن لتطبيق الويب أيضاً الربط بعنوان محلي محدد وتقديم HTTPS بنفسه باستخدام --tls-cert و--tls-key. يعالج ذلك مشكلة النص الصريح، لا مشكلة التعرض. ويجعل إساءة استخدام المنفذ المكشوف أصعب. لكنه لا يجعله منفذاً يجوز نشره.
أضف الآن ما يوجد خلف هذا المنفذ. يعدّل الوكيل الملفات في مساحة العمل وينفذ أوامر shell، وتوجد بيانات اعتماد مزود الخدمة على القرص بجواره. لذلك، في الإصدار المثبت، يكون المنفذ 3080 المفتوح بمثابة shell عن بُعد بواجهة محادثة، ويعمل بحساب المستخدم الذي بدأه، مع إرفاق مفتاح API الخاص بك. لا يحتاج المهاجم إلى ثغرة لاستغلال ذلك. يحتاج إلى رقم المنفذ فقط. وفي الإصدار الذي يستخدم رمز بدء التشغيل، يحتاج أيضاً إلى الرمز، وهو متاح بالفعل لأي شخص يستطيع قراءة الطرفية أو سجلات الخدمة أو حركة الشبكة غير المشفرة لديك.
وتتفق CLI (واجهة سطر الأوامر) مع ذلك. واعتباراً من 0.1.0-rc.6، لا تدعم عمداً --host 0.0.0.0، وتخرج بخطأ في الاستخدام بدلاً من البدء، كما يرفض 0.2.2-alpha.2 الأحدث هذا الخيار عند بدء التشغيل. هذا الرفض ميزة، لذلك لا تبحث عن تصحيح يزيله.
يوجد خياران معقولان آخران عند عدم ملاءمة النفق. ضع الخادم على شبكة overlay خاصة، بحيث لا يحصل إلا على عنوان يمكن لأجهزتك أنت توجيه الاتصال إليه. وهذا ما يوفّره خادم تحكم Headscale مستضاف ذاتياً. أو ضع reverse proxy أمامه لمصادقة الطلب قبل وصوله إلى المنفذ 3080، مثل خادم تسجيل الدخول الموحّد Authentik الذي ينفذ forward auth. إن وضع reverse proxy بلا مصادقة أمامه ليس إجراءً أمنياً. إنّه مجرد عنوان URL أطول.
الوصول إلى واجهة الويب عبر نفق SSH
نفّذ هذا الأمر على حاسوبك المحمول، وليس على الخادم.
ssh -N -L 3080:127.0.0.1:3080 you@your-serverيفتح -L المنفذ 3080 على حاسوبك المحمول، ويمرّر كل ما يتصل به عبر جلسة SSH المشفّرة. يُحلّ الجزء 127.0.0.1:3080 على الخادم، لذلك يصل الاتصال إلى harness من loopback، تماماً كما لو كنت تستخدم الجهاز مباشرة. يوضح -N أنه يجب عدم بدء shell بعيد، لأنك تريد إعادة التوجيه فقط.
بعد ذلك، افتح http://127.0.0.1:3080 في المتصفح المحلي. في الإصدار الذي يستخدم launch token، افتح بدلاً من ذلك عنوان URL الكامل لبدء التشغيل الذي طبعه الخادم، مع تضمين token؛ فعندما يبدأ harness عبر SSH، فإنه يطبع سطر بدء التشغيل، لكنه لا يحاول فتح متصفح نيابةً عنك. إذا كان المنفذ 3080 مستخدماً بالفعل على حاسوبك المحمول، فغيّر الرقم الموجود على اليسار: ssh -N -L 3180:127.0.0.1:3080 you@your-server، ثم انتقل إلى http://127.0.0.1:3180، مع تغيير المنفذ في عنوان URL الذي يحتوي على token بالطريقة نفسها. الرقم الموجود على اليسار محلي، أما الرقم الموجود على اليمين فيخص الخادم، لذلك لا تغيّر إلا الرقم الموجود على اليسار.
احفظه في ~/.ssh/config وتوقف عن كتابته.
Host dsh
HostName 203.0.113.10
User deploy
IdentityFile ~/.ssh/id_ed25519
LocalForward 3080 127.0.0.1:3080بعد ذلك، يبدأ ssh -N dsh النفق. تعني رسالة المتصفح التي تفيد برفض الاتصال عادةً أن النفق يعمل، لكن لا يوجد شيء يستمع على الجانب البعيد، لأن SSH يمرّر المنفذ سواء كان harness قيد التشغيل أم لا. تحقّق من الخادم باستخدام الأمر ss أعلاه.
أبقِ harness قيد التشغيل بعد تسجيل الخروج
يتوقف أمر npx مع shell الخاص بك. تبقى خدمة systemd للمستخدم قيد التشغيل، وتعيد تشغيل harness بعد حدوث عطل أو إعادة تشغيل النظام. الوحدة هنا بسيطة عمداً. إذا أردت تشغيل harness ضمن حساب مقيد خاص به، مع تثبيت الإصدار داخل الوحدة وسجلات يمكنك البحث فيها فعلياً، فإن إعداد systemd بدون واجهة لـ dsh يشرح ذلك بالكامل.
loginctl enable-linger $USER
mkdir -p ~/.config/systemd/user
command -v dshيهم enable-linger لأن خدمات المستخدم تتوقف عادةً عند انتهاء جلستك الأخيرة. ومن دونه، يتوقف harness بمجرد إغلاق النفق. استخدم المسار المطلق الذي يطبعه command -v dsh وضعه في الوحدة، لأن systemd لا يبحث في PATH الذي ينشئه shell عند تسجيل الدخول.
[Unit]
Description=DeepSeek Harness web UI
After=network-online.target
[Service]
Type=simple
WorkingDirectory=%h/projects/site
ExecStart=/usr/local/bin/dsh web
Restart=on-failure
RestartSec=5
[Install]
WantedBy=default.targetليس WorkingDirectory إعداداً شكلياً. تستخدم عملية dsh الدليل الذي شُغّلت منه باعتباره الموقع الافتراضي في نظام الملفات. لذلك، إذا بدأت الخدمة من المكان الخطأ، فإنها توجّه الوكيل إلى المجلد الخطأ. لكن هذا الدليل ليس إلا قيمة افتراضية. لا تحتوي Web UI الجديدة على workspace محدد حتى تضيف واحداً ضمن Choose workspace، ويوجّهك دليل المشروع إلى إضافة الدليل الذي بدأت منه dsh. لا يتضمن الدليل علامة إصدار، والنص نفسه موجود بالفعل في 0.1.0-rc.7، لذلك توقّع ظهوره أيضاً في الإصدار المثبّت. اضبط دليل الوحدة على المشروع، ثم اختر ذلك workspace في الواجهة.
systemctl --user daemon-reload
systemctl --user enable --now dsh
systemctl --user status dshتكون الوحدة التي ترفض البدء مرتبطةً في الغالب بمسار ExecStart خاطئ أو بإصدار Node لا يقبله البرنامج الثنائي، ويحدّد journalctl --user -u dsh -n 50 أيّهما السبب. في الإصدار الذي يتضمن launch token، يكون journal أيضاً المكان الذي يظهر فيه عنوان URL لبدء التشغيل المحتوي على token، وتطبع كل عملية إعادة تشغيل عنواناً جديداً. ينطبق النمط نفسه على إبقاء أي coding agent قيد التشغيل على VPS، وتكون حالات الفشل متطابقة.
ما يُسمح للإضافة بفعله
الإضافة هي وحدة برمجية تساهم بخدمات، وأحداث مُنمّطة، وتأثيرات قابلة للعكس في سياق مشترك. نقاط الامتداد هي الجزء الذي يستحق القراءة بتمعن:
- تسجيل مزود نموذج عبر
ctx.llm - إضافة أدوات موجهة للنموذج عبر
ctx.tools - توفير خلفية الصدفة (shell) عبر
ctx.shell - توفير الوصول إلى نظام الملفات أو السياسات عبر
ctx.fs - تسجيل أوامر بشرية عبر
ctx.commands - تشغيل مهام في الخلفية عبر
ctx.jobs - تغليف العمليات المُنشأة بخلفية
ctx.sandbox - اعتراض الطلبات واستدعاءات الأدوات عبر أحداث
agent/*وtools/* - توسيع حالة الجلسة الدائمة
- التحكم في واجهة المستخدم عبر
ctx.agents
اقرأ هذه القائمة بالطريقة التي يقرأها بها المهاجم. يمكن للإضافة توفير طبقة نظام الملفات وطبقة الصدفة، ويمكنها التمركز في منتصف كل استدعاء أداة يقوم به النموذج. لا يوجد مربع حوار أذونات يقف بين الإضافة وبين هذه النقاط، لأن الإضافة هي مجرد كود Node عادي يتم تحميله في نفس العملية التي تعمل فيها بقية المكونات. تثبيت إضافة يعني تشغيل كود غريب بصلاحيات الوكيل الخاص بك، وصلاحيات الوكيل هي صلاحيات مستخدم Unix الخاص بك.
هذا هو نفس قرار الثقة الذي تتخذه عند ربط خادم MCP بوكيل على خادم افتراضي خاص (VPS)، حيث MCP هو بروتوكول سياق النموذج. وهو أيضاً السبب في أن تشغيل وكيل برمجي بأمان على خادم VPS يبدأ بالحساب الذي يعمل تحته بدلاً من النموذج، وسبب أن هجمات سلسلة توريد npm تؤثر بشدة على الخوادم: خطوة التثبيت هي الاختراق، ولا يوجد ما ينبهك.
مصدر الإضافات
توجد الإضافات داخل ملفات التعريف. ملف التعريف هو تكوين مُسمّى مخزّن ضمن $DSH_HOME، وتكون قيمته الافتراضية ~/.dsh، ويحتوي مجلد كل ملف تعريف على الإضافات الخارجية التي يثبتها. تدير واجهة CLI هذه الإضافات بتمرير الوسائط التي تحددها مباشرةً إلى pnpm، مع استخدام مجلد ملف التعريف مجلدَ العمل.
dsh plugin --profile web add github:deepseek-harness/turtle-ui
dsh plugin --profile web remove turtle-uiبما أنّ الوسائط تصل إلى pnpm دون تغيير، فإنّ add وremove وupdate وwhy تعمل بالطريقة نفسها التي تعمل بها في أي مشروع pnpm، ويمكن أن تكون الإضافة حزمة npm أو مرجع GitHub. يجب أن يكون pnpm موجوداً أولاً في PATH. في Node 24، يضعه corepack enable pnpm هناك. توقّف Node 25 عن توزيع Corepack، لذلك ثبّته في Node 25 والإصدارات الأحدث باستخدام npm install -g pnpm بدلاً من ذلك.
يتم الاكتشاف عبر موضوع في GitHub. يضيف مؤلفو الإضافات موضوع dsh-plugin إلى مستودعاتهم، وتستطيع معرفة الإضافات الموجودة من خلال تصفح هذا الموضوع. الموضوع تسمية يضيفها المؤلف إلى مستودعه بنفسه. لا يراجعه أحد ولا يوقّعه أحد، كما ترتّب صفحة الموضوع المستودعات حسب عدد النجوم، الذي يقيس الشعبية لا الأمان.
تتضمن الإصدارات الحالية أيضاً حزمة تجريبية لفهارس الإضافات المخصصة. فعّلها ضمن Plugins، وستتيح لك علامة التبويب Discover إضافة فهرس. الفهرس ملف JSON يُجلب من عنوان URL تحدده. لا يوفّر harness أي فهرس خاص به، ويتحقق من تنسيق الملف، لكنه لا يتحقق من العناوين أو المؤلفين أو المصادر التي يدّعيها market. ويمكن لأي شخص على مسار الشبكة تعديل فهرس يُقدَّم عبر http: غير المشفّر. الـmarket دليل كتبه طرف آخر، وليس مراجعة.
تساعدك أربع ممارسات على إبقاء هذا الأمر تحت السيطرة. اقرأ المصدر قبل التثبيت، لأن معظم الإضافات صغيرة بما يكفي لقراءتها خلال عشر دقائق. ثبّت الإصدار أو commit المحدد بدلاً من تتبع branch. شغّل harness باستخدام مستخدم لا يملك أي شيء آخر، وعلى VPS تكون مستعداً لإعادة بنائه. امنح agent مفتاح API خاصاً به مع حد إنفاق خاص به، منفصلاً عن المفتاح الذي تستخدمه خدمات الإنتاج. عندما تجلس لقراءة إضافة وتريد معرفة الملفات التي تحمل المخاطر، يشرح الدليل الإرشادي لفحص إضافة dsh ملف manifest ونقطة الدخول ونقاط التمديد التي تسجلها الإضافة.
إذا كنت تفضّل مقارنة التصاميم قبل الالتزام بأحدها، فإن harness Omnigent متعدد الوكلاء يعالج المشكلة نفسها ببنية مختلفة، وتصبح المفاضلات واضحة عند استخدام الإضافات. وإذا انتهيت إلى إبقاء إضافتين أو ثلاث منها على الخادم نفسه بدلاً من اختيار واحدة، فإن وضع كل harness خلف API واحد مستضاف ذاتياً يغنيك عن نفق لكل منفذ، مقابل إضافة خدمة أخرى يجب ربطها بـloopback ومنحها كلمة مرور فعلية منذ اليوم الأول.
ما الذي يتعطل أولاً
إصدار Node قديم جداً. يتطلب الفرع الرئيسي للمشروع و0.2.2-alpha.2 إصدار Node 24.9 أو أحدث، كما تختبر CI الإصدار Node 24، وتجري فحص توافق على Node 24.9 وNode 26، من دون أي اختبار على Node 22. كانت الإصدارات الموسومة الأقدم حتى 0.2.1-rc.4 تعتبر Node 22.19 مقبولاً، لكن المشروع لم يعد يُبنى عليه. يفشل وقت التشغيل الأقدم عند بدء التشغيل لأن الشيفرة تستخدم بنية وصالات API غير متوفرة فيه. شغّل node --version قبل أي شيء آخر.
المنفذ 3080 مستخدم بالفعل. قد يكون السبب harness ثانياً، أو عملية متروكة، أو تطبيقاً آخر يستخدم المنفذ 3080 أيضاً. اعثر عليه باستخدام ss -tlnp | grep 3080، ثم أوقفه أو شغّل harness على منفذ آخر باستخدام dsh web --port 3180. يخص --port تطبيق الويب، لذلك يجب تشغيله بعد web.
يتعذر على المتصفح الاتصال عبر النفق. تأكد من أنك فتحت 127.0.0.1، وليس العنوان العام للخادم، لأن المنفذ المُعاد توجيهه موجود على حاسوبك المحمول فقط. ثم تأكد من أن harness يستمع على الخادم، لأن SSH ينشئ إعادة التوجيه سواء استجاب أي شيء في الطرف البعيد أم لا.
يفشل dsh plugin فوراً. الأمر عبارة عن غلاف حول pnpm، لذلك يؤدي غياب الملف التنفيذي pnpm إلى إيقافه قبل بدء أي عمل خاص بالإضافات. في Node 25 والإصدارات الأحدث، هذه هي الحالة الافتراضية لأن Corepack لم يعد مشمولاً مع Node.
لا يستطيع الوكيل رؤية مشروعك. لا تحدد واجهة Web UI الجديدة مساحة عمل حتى تضيف واحدة، وتظل أداة إنشاء الجلسة غير متاحة إلى أن تفعل ذلك. تستخدم العملية الدليل الذي بدأت فيه بوصفه موقع نظام الملفات الافتراضي فقط، لذلك فإن الوحدة التي تكون قيمة WorkingDirectory فيها هي الدليل الرئيسي الخاص بك توجه الوكيل إلى دليلك الرئيسي. اختر مساحة العمل في واجهة المستخدم، أو أصلح الوحدة ثم أعد تحميلها.
FAQ
هل من الآمن إتاحة واجهة الويب الخاصة بـ DeepSeek Harness على المنفذ 3080؟
لا. في 0.1.0-rc.6 المثبّتة، لا يوفّر خادم الويب آلية تسجيل دخول خاصة به، ويعدّل الوكيل الذي يعمل خلفه الملفات وينفّذ أوامر shell بصلاحيات المستخدم الذي بدأ العملية، بينما يكون مفتاح API الخاص بالمزوّد مخزّناً على القرص نفسه. ابتداءً من 0.2.0-rc.2، بما في ذلك 0.2.2-rc.1 وإصدار npm latest في 12 November 2026، وكذلك الإصدار التجريبي الأحدث 0.2.2-rc.2، يحتوي عنوان URL الذي يظهر عند بدء التشغيل على launch token يستبدله المتصفح بملف تعريف ارتباط للجلسة. لكن عنوان URL هذا يُعد بيانات اعتماد، ويرسلها HTTP العادي دون تشفير، لذلك لا تتغير التوصية. أبقِ المستمع على 127.0.0.1، واتصل به عبر نفق SSH. ويمكنك أيضاً استخدام شبكة overlay خاصة، أو reverse proxy يصادق على كل طلب قبل وصوله إلى المنفذ. اعتباراً من الإصدار 0.1.0-rc.6، يرفض CLI الخيار --host 0.0.0.0 ويخرج بخطأ في الاستخدام، كما أن 0.2.2-alpha.2 لا يزال يرفضه. يوضح ذلك موقف المطورين من هذه الفكرة.
هل أحتاج إلى مفتاح DeepSeek API، أم يمكنني استخدام نموذج محلي؟
كلا الخيارين يعمل، لأن harness بيئة تشغيل وليس نموذجاً. ضمن Settings ثم Models، يمكنك لصق مفتاح في بطاقة DeepSeek أو لدى مزود من الكتالوج. ويمكنك أيضاً اختيار "Add model provider" ثم "Custom model API"، وتزويده بعنوان base URL يدعم OpenAI Chat Completions أو OpenAI Responses أو Anthropic Messages أو Gemini API. يستجيب خادم Ollama المحلي على http://127.0.0.1:11434/v1/، ويقبل أي سلسلة نصية في حقل مفتاح API. تُخزَّن المفاتيح في $DSH_HOME/.credentials.yaml، الذي تكون قيمته الافتراضية ~/.dsh/.credentials.yaml.
ماذا يحصل عليه plugin الخاص بـ DeepSeek Harness فعلياً عند تثبيته؟
يحصل على صلاحيات الحساب الذي يشغّل harness. إن plugin عبارة عن شفرة Node تُحمّل في العملية نفسها، وتشمل نقاط التوسعة shell backend وطبقة نظام الملفات وسجل الأدوات والأحداث التي تغلّف كل استدعاء لأداة. لا توجد آلية تعزل plugin عن هذه النقاط، إلا إذا وفّر plugin آلية العزل بنفسه. اقرأ الشفرة المصدرية قبل التثبيت، وشغّل harness بحساب لا يملك أي شيء مهم بالنسبة إليك.
ما الإصدار الذي ينبغي أن أثبّته، وهل سيستمر في العمل؟
ثبّت إصداراً محدداً، مثل npx @deepseek-ai/dsh@0.1.0-rc.6 web. هذا هو إصدار August 2026 المثبّت هنا. في 12 November 2026، يشير وسم npm latest إلى 0.2.2-rc.1. ويسرد GitHub الإصدار التجريبي الأحدث 0.2.2-rc.2، الذي صدر في 11 November، بينما يتطلب CLI الحالي Node 24.9 أو أحدث. يصف المشروع نفسه بأنه developer preview، ويذكر أن التغييرات التي تكسر التوافق متوقعة. لذلك قد يتصرف الأمر غير المقيّد بإصدار بطريقة مختلفة من يوم إلى آخر. تحقّق من المستودع قبل الترقية، وتوقّع تغيّر مفاتيح الإعدادات وواجهات plugin ما دام رقم الإصدار يبدأ بـ 0.