أداة DeepSeek Harness (dsh): التثبيت، التشغيل بدون واجهة رسومية، معيار القياس لثلاثة نماذج

تاريخ النشر
18 أغسطس 2026
تاريخ التحديث
16 سبتمبر 2026
بقلم
جاكوب لويد — كُتب بمساعدة الذكاء الاصطناعي بعد إنجاز المشروع
مدة القراءة
قراءة 3 دقيقة

بعبارة مبسطة: أطلقت شركة DeepSeek وكيل برمجة مجاني ومفتوح المصدر؛ وهو برنامج يقوم بقراءة مشروعك، وتعديل الملفات وتنفيذ الأوامر نيابة عنك، تمامًا مثل Claude Code. يوضح هذا المقال كيف قمت بتثبيته على جهاز الكمبيوتر الخاص بي الذي يعمل بنظام لينكس، وجعله يبدأ التشغيل تلقائيًا، كما قمت بتوجيهه لاستخدام كل من نماذج DeepSeek السحابية ونموذج موجود على جهازي المحلي، ثم اختبرته في 5 مهام برمجية صغيرة. نجحت جميع الاختبارات الـ15؛ وكل عملية تشغيل عبر السحابة كلفت بضعة سنتات فقط، لكن لا يزال هناك بعض العيوب في أداء البرنامج.

ست ثوانٍ فقط: تم إنشاء الملف، وتشغيل البرنامج، وطباعة النتيجة، ثم خروج البرنامج برمز الخروج 0. هذا ما فعله DeepSeek Harness (dsh) مع أول مهمة أوكلتها إليه. أطلقت شركة DeepSeek هذا البرنامج في 13 أغسطس 2026 كأداة برمجة مرخصة بموجب رخصة MIT، وتقوم على فكرة بسيطة وهي: كل شيء هو مكون إضافي، بما في ذلك محول النماذج، والأدوات، والبيئة التجريبية، وحلقة تشغيل البرنامج نفسه. قمت بتثبيته في نفس الأسبوع، ووجهته إلى نماذج DeepSeek السحابية وإلى نموذج موجود على جهازي، ثم جربته عبر مجموعة صغيرة من المهام. فيما يلي تفاصيل ما استغرقه ذلك، وتكلفته، وأي نقاط قد تشكل مشكلة.

خلاصة المعلومات

  • ما هو: أداة برمجة من فئة Claude Code؛ تستطيع قراءة وتعديل الملفات، تشغيل أوامر shell، ووضع خطة عمل، وتوليد وكلاء فرعيين؛ يُوزع البرنامج كحزمة npm. يحتوي على واجهة ويب على العنوان 127.0.0.1:3080، بالإضافة إلى وضع بدون واجهة يطبع النتيجة ثم ينهي العملية، وهو الوضع المخصص للاستخدام في السكربتات.
  • التكلفة: البرنامج مجاني. تكلفة اختبار خمس مهام بلغت حوالي 3 سنتات على V4-Flash وحوالي 7 سنتات على V4-Pro وفقًا لأعلى معدلات الاستخدام، بينما لم تكن هناك أي تكلفة عند استخدام النموذج المحلي.
  • النتيجة: نجاح في جميع الاختبارات (15/15) على كل من V4-Flash وV4-Pro وكذلك على نموذج Gemma-4-26B المحلي، حيث استغرقت المجموعة بأكملها ما بين 43 إلى 56 ثانية. وفي مهمة حقيقية (بناء موقع إلكتروني يتكون من 290 صفحة والتحقق من روابطه)، لاحظ البرنامج دون طلب مني أن دليل التشغيل الخاص بي قد أصبح قديمًا.
  • متطلبات التشغيل: Node.js، بالإضافة إلى مفتاح API من DeepSeek أو أي خادم متوافق مع OpenAI. لقد استخدمت كلا الخيارين.
  • العيوب: البرنامج لا يزال في مرحلة المعاينة للمطورين؛ يحذر ملف README من احتمالية حدوث أخطاء عند الترقية بين الإصدارات، لذا يجب تثبيت إصدار معين وإعادة الاختبار بعد أي تحديث.

تحديث 16 سبتمبر 2026: الاختبارات المذكورة أُجريت في أغسطس باستخدام الإصدار 0.1.0-rc.7؛ ومنذ ذلك الحين ترقيتُ إلى الإصدار 0.1.5-rc.1، الذي يتضمن أيضًا معلومات حول ملفات SDK وACP. كما أوقفت استخدام Reasonix، وهو أداة برمجة أخرى كنت أقارنها بهذا البرنامج، في 9 سبتمبر 2026؛ ولهذا فإن تلك المقارنة لم تعد سوى ملاحظة تاريخية قصيرة في نهاية المقال.

الطريقة، من البدء إلى المستوى المتقدم

الخطوات من 1 إلى 3 تمنحك وكيلًا يعمل في غضون عشر دقائق تقريبًا. أما الخطوتان 4 و5 فتحولانه إلى شيء يمكن للبرامج الأخرى استدعاؤه.

ما الذي تحصل عليه في النهاية

الوضع الذي أستخدمه فعلاً هو الوضع بدون واجهة رسومية. من داخل مجلد المشروع:

$ cd ~/scratch/dsh-demo
$ dsh --profile headless "Create fizz.py that prints FizzBuzz for 1..15 and run it; reply with the program output only."

1
2
Fizz
4
Buzz
…
FizzBuzz
$ echo $? 0

علامات backtick الثلاثية هي خاصية من خصائص dsh؛ حيث يضع الرد في إطار كود Markdown. لا يقوم بكتابة أي شيء خارج المجلد الذي بدأت التشغيل منه (وضع الصلاحيات الافتراضي هو workspace-write). يعرض فقط الرسالة النهائية على الشاشة، ويحفظ كل عملية تشغيل حتى يمكنك فتحها لاحقًا عبر واجهة الويب ومشاهدة كل استدعاء للأداة وعدد الرموز المستخدمة.

أفضل دليل على ذلك كان مهمة حقيقية وليست مجرد تجربة بسيطة. وجهته إلى مجلد المصدر الخاص بهذا الموقع وطلبت منه قراءة دليل التشغيل الخاص بالمشروع، ثم تشغيل أمر البناء وفحص الروابط، وتقديم تقرير دون أي تعديلات أو نشر للنتائج. في غضون 53 ثانية، قرأ الدليل، نفذ الأمر المطلوب، وأبلغ عن عدد الصفحات (290 صفحة) وعدد الصور (1,752 صورة)، بالإضافة إلى عدم وجود روابط مكسورة، وكذلك زمن البناء. ثم، دون أن يُطلب منه ذلك، لاحظ أن الدليل لا يزال يذكر “288 صفحة”، فأشار إلى هذا الاختلاف. هذه هي الأنواع من المهام البسيطة التي أفوضها الآن دون تردد.

واجهة المستخدم عبر المتصفح تأتي بتصميم عام 2026 المعتاد: الجلسات على اليسار، والدردشة في المنتصف، بالإضافة إلى صفحة إعدادات للنماذج. من العادات الجيدة أن تضع مفتاح API في صفحة الإعدادات تلك وليس في ملف التكوين.

واجهة dsh الويب المدمجة في تطبيق الدردشة: جلسة منتهية بعنوان 'إنشاء وتشغيل hello.py' تُظهر خطوات الحقن والكتابة والتنفيذ، بالإضافة إلى الرد 'hello from dsh' وخط إحصائيات يوضح عدد المرات وزمن الاستجابة ومعدل استخدام الذاكرة المؤقتة؛ أسفله شريط حالة يحتوي على أزرار التشغيل وإعادة التشغيل والتوقف، بالإضافة إلى قائمة اختيار النموذج الذي تم ضبطه على DeepSeek-V4-Flash
واجهة dsh الويب (مُلتقطة في أغسطس، ومدمجة في تطبيق الدردشة الخاص بي). تُظهر الجلسة المنتهية تسلسل الخطوات التي تم تنفيذها، بالإضافة إلى إحصائيات كل مرحلة. شريط الحالة أسفله هو جزء من تطبيقي للتحكم في وحدة systemd والنموذج الافتراضي، ولا يتبع dsh.

الخطوة 1: التثبيت (دقيقتان)

هو عبارة عن حزمة npm واحدة فقط. أنا أستخدم بادئة Node خاصة لتطبيقات الأدوات المساعدة، حتى لا يتم تثبيت أي شيء في هيكل النظام؛ وهو الحل الوحيد المنطقي على نظام Fedora الثابت الذي أستخدمه. أما عملية التثبيت العادية عالمياً فهي بنفس الأمر:

npm install -g @deepseek-ai/dsh
dsh --version          # 0.1.0-rc.7 when I benchmarked it
dsh web                # starts the UI, prints http://127.0.0.1:3080

افتح الرابط، ثم انتقل إلى Settings → Models، والصق مفتاح DeepSeek الخاص بك واحفظه. سيؤدي ذلك إلى إنشاء الملف ~/.dsh/.credentials.yaml (بأذونات 0600)، وبعدها يعمل النموذج فوراً دون الحاجة لإعادة التشغيل. وإذا كنت ترغب في أتمتة العملية، فالملف عبارة عن خريطة بصيغة YAML بسيطة (DEEPSEEK_API_KEY: sk-…). أنا قمت بإنشاء مفتاحي من ملف البيئة الذي تقرأه خدماتي الأخرى، لذا لا يظهر المفتاح أبداً في سجلات الشل أو في ملفات التكوين.

هناك نقطتان يجب معرفتهما قبل المتابعة:

  • خاصية تتبع الأداء معطلة بشكل افتراضي. عند عدم تعيين متغير DSH_TELEMETRY_MODE، يتم إيقاف هذه الخاصية. لقد تحققت من ملفات التكوين الفعلية وليس من النصوص الترويجية؛ فمُصدّر OTLP موجود بالفعل لكنه غير مفعّل.
  • بيئة التنفيذ معزولة لكنها محدودة. الوضع الافتراضي يقصر عمليات الكتابة على المجلد الذي تم تشغيل البرنامج منه فقط؛ أما عمليات القراءة فلا تخضع لأي قيود، وهذا ما توضحه الوثائق بوضوح. لذا لا تقم بتشغيل البرنامج من مجلد “المنزل” الخاص بك إذا كانت المهمة جادة، ولا تشير إلى مجلدات تحتوي على بيانات سرية.

الخطوة الثانية: تشغيله كخدمة

واجهة المستخدم web UI عبارة عن عملية Node تستمر في التشغيل لفترة طويلة. أردت أن تبدأ هذه العملية عند تسجيل الدخول، دون الحاجة إلى استخدام الطرفية، وأن تكون مقيدة فقط بواجهة loopback. وحدة systemd من نوع --user تقوم بذلك:

# ~/.config/systemd/user/dsh-web.service
[Unit]
Description=DeepSeek Harness web UI (dsh web) on 127.0.0.1:3080
After=network.target

[Service]
WorkingDirectory=%h
Environment=DSH_HOME=%h/.dsh
# Use the path from `which dsh`. systemd does not allow comments at the end of a line.
ExecStart=/usr/local/bin/dsh web --host 127.0.0.1 --port 3080
Restart=on-failure
RestartSec=3

[Install]
WantedBy=default.target
systemctl --user daemon-reload
systemctl --user enable --now dsh-web.service
curl -s -o /dev/null -w "%{http_code}\n" http://127.0.0.1:3080/   # 200

WorkingDirectory يحدد مسار مجلد العمل الافتراضي لواجهة المستخدم، لكن الواجهة ما زالت تطلب منك اختيار مجلد العمل قبل أن تتمكن من الكتابة. هذا إعداد افتراضي جيد. كما أن واجهة سطر الأوامر ترفض استخدام الخيار --host 0.0.0.0؛ ويقول المطورون إن ربط الخدمة بجميع واجهات الشبكة “غير مدعوم عمدًا في الوقت الحالي”. واجهة المستخدم لا تحتوي على أي نظام تسجيل دخول، لذا أوافق على ذلك. إذا كنت بحاجة إلى استخدامها من جهاز آخر، فضع بروكسي عكسي يحتوي على نظام مصادقة أمامها، أو استخدم متصفح الجهاز نفسه عبر سطح المكتب البعيد، وهذا ما أفعله أنا.

الخطوة 3: تحديد النماذج في ملف YAML واحد، مع إعادة التحميل التلقائي

يحتوي الملف ~/.dsh/settings.yaml على النموذج الافتراضي وأي مزودي خدمات إضافيين. يقوم برنامج dsh بإعادة قراءة هذا الملف قبل الطلب التالي، لذا لا حاجة لإعادة التشغيل أو تسجيل الدخول من جديد. مثال على محتوى الملف:

agent-default-model:
  provider: deepseek-official
  model: deepseek-v4-flash          # or deepseek-v4-pro

llm-deepseek:
  reasoningEffort: high             # off | low | high | max

# A local OpenAI-compatible server (mine is llama.cpp-based on a GPU rig).
llm-pi-ai:
  providers:
    local-rig:
      displayName: Local GPU rig
      apiKeyEnv: LOCAL_RIG_PLACEHOLDER_KEY    # a reference, not a value
      api: openai-completions
      baseURL: http://my-gpu-rig:1234/v1      # your server's address
      defaultContextWindow: 65536
      models:
        - id: unsloth/gemma-4-26B-A4B-it-qat-GGUF/gemma-4-26B-A4B-it-qat-UD-Q4_K_XL
          name: Gemma 4 26B-A4B (rig)

كان هناك تفصيلان كلفاني عشر دقائق من العمل لكل منهما:

  • apiKeyEnv هو مرجع فقط، وليس قيمة حرفية. يقوم برنامج dsh بحل هذه القيمة من ملف .credentials.yaml أو من متغيرات البيئة. حتى الخادم المحلي الذي لا يتطلب مفاتيح أمنية يحتاج إلى وجود قيمة اعتماد ما، لأن العميل المتوافق مع OpenAI يشترط وجود رمز وصول (bearer token). لذا يجب وضع أي قيمة تمثيلية تحت هذا الاسم في ملف .credentials.yaml.
  • معرف المزود (local-rig في المثال) يظل ثابتًا بمجرد أن تبدأ الجلسات بالإشارة إليه. ولتغيير اسمه، يجب إضافة مزود جديد.

وبما أن هذا الملف هو واجهة التحكم بأكملها، فإن “تحويل dsh لاستخدام النموذج المحلي” يتطلب تعديلًا من سطرين فقط، يمكن لأي برنامج نصي أو وكيل آخر تنفيذه. أستخدم ذلك لإرسال المهام البسيطة إلى النموذج المحلي المجاني، بينما أرسل المشكلات الصعبة إلى نموذج V4-Pro دون تغيير أي شيء آخر.

الخطوة الرابعة: استدعاءه من برنامجك الخاص

الحزمة الرسمية لا تحتوي على واجهة مستخدم طرفية (TUI). كان هناك بعض الإضافات الطرفية من جهات خارجية على npm، لكن في شهر أغسطس كانت تلك الإضافات حديثة الإصدار للغاية وتحتوي على تبعيات workspace:* معطلة؛ ولن أقوم بتشغيل أي حزمة غير مفحوصة تمنح صلاحيات shell على خادمي العائلي. لذلك، عندما قمت بدمج dsh في تطبيقي الخاص للدردشة، استخدمت ما توفره الحزمة الرسمية فعلاً:

  • تشغيل المهام بدون واجهة مستخدم بقائمة ثابتة من الوسائط. يقوم خادمي بتشغيل الأمر dsh --profile headless "…" حيث تُمرر المهمة كعنصر واحد فقط في قائمة الوسائط دون استخدام shell؛ وبالتالي فإن أي مهمة تحتوي على ; rm -rf / تظل مجرد نص عادي. يقوم البرنامج بتشغيل مهمة واحدة في كل مرة ويحتفظ بسجل قصير للإجابات النهائية.
  • تبديل النماذج عن طريق تعديل قيمة agent-default-model في ملف settings.yaml. لا يتطلب ذلك إعادة تشغيل البرنامج.
  • تضمين واجهة المستخدم الويب داخل عنصر iframe إذا رغبت في ذلك؛ حيث لا ترسل هذه الواجهة أي رؤوس تحظر عرض الإطار.

القاعدة الوحيدة التي تستحق الالتزام بها هي: وضع كل هذا خلف نظام تسجيل الدخول الخاص بالمشرف في تطبيقك. فتشغيل مهمة بدون واجهة مستخدم يعني تنفيذ أكواد بشكل تعسفي، لذا يجب التعامل مع خيار "تشغيل مهمة" بنفس الطريقة التي تتعامل بها مع shell.

المعيار المستخدم: 5 مهام، 3 نماذج، النتيجة 15/15

هذا ليس اختبارًا علميًا؛ بل هي خمس مهام بسيطة أود أن أوكلها فعلاً إلى أي وكيل برمجي. كل مهمة تُنفذ في مجلد منفصل، ثم يتم التحقق منها عبر سكريبت: هل الملف موجود ويعمل؟ هل الاختبارات تمر دون تغيير أي شيء في ملفات الاختبار؟ وهل عملية إعادة التسمية لم تترك أي إشارات إلى الاسم القديم؟ الزمن الإجمالي يشمل كل هذه الخطوات، بالإضافة إلى رسالة نظامية تحتوي على حوالي 7,500 رمز. أما عدد الرموز فهو مستخلص من سجل الجلسة الخاص بأداة dsh.

المهمةV4-FlashV4-ProGemma-4-26B (محلي، على جهاز قوي)
الرد بكلمة "PONG" (بعد التشغيل واستدعاء واحد)✅ 2.1 ثانية✅ 2.8 ثانية✅ 13.2 ثانية*
كتابة وتشغيل برنامج FizzBuzz✅ 5.3 ثانية · باستخدام أداتين✅ 8.4 ثانية · باستخدام أداتين✅ 4.9 ثانية · باستخدام أداتين
إصلاح خطأين لكي تمر الاختبارات (دون تغيير ملفات الاختبار)✅ 11.7 ثانية · باستخدام 8 أدوات✅ 15.8 ثانية · باستخدام 7 أدوات✅ 10.4 ثانية · باستخدام 8 أدوات
تلخيص كود برمجي مكون من 6 وحدات (أقل من 150 كلمة)✅ 8.9 ثانية · باستخدام 9 أدوات✅ 10.9 ثانية · باستخدام 7 أدوات✅ 12.1 ثانية · باستخدام 7 أدوات
إعادة تسمية دالة في 3 ملفات بالإضافة إلى ملفات الاختبار، والتأكد من نجاح العملية✅ 15.1 ثانية · باستخدام 14 أداة✅ 18.2 ثانية · باستخدام 12 أداة✅ 12.2 ثانية · باستخدام 11 أداة
الزمن الإجمالي43 ثانية56 ثانية53 ثانية
عدد الرموز (مدخلات / من الذاكرة المؤقتة / مخرجات)42.6 ألف / 136 ألف / 4.5 ألف41.4 ألف / 107 آلاف / 3.2 ألف40.5 ألف / 237 ألف / 5.6 ألف
التكلفة بأسعار الذروة (في غير أوقات الذروة تكون التكلفة نصف ذلك)≈ 0.027 دولار≈ 0.072 دولار0 دولار (فقط تكلفة الكهرباء)

*الاستدعاء الأول بعد تحميل النموذج على الجهاز؛ أما المهام اللاحقة فقد أظهرت سرعة أفضل نظرًا لوجود النموذج في الذاكرة المؤقتة. الإصدار المستخدم هو 0.1.0-rc.7 بتاريخ 18 أغسطس 2026. الأسعار مستقاة من صفحة التسعير الخاصة بـ DeepSeek في ذلك اليوم: سعر V4-Flash هو 0.014 دولار للرموز المسترجعة من الذاكرة المؤقتة، و0.44 دولار للرموز الجديدة، و1.32 دولار للمخرجات لكل مليون رمز؛ أما V4-Pro فأسعاره هي 0.044 دولار، و1.32 دولار، و3.96 دولار على التوالي. سكريبت الاختبار كان مؤقتًا ولم يعد موجودًا، لذا لا يمكنني التأكد مما إذا كان يتم حساب عدد الكلمات في الملخص أم لا.

ما يوضحه الجدول:

  • استخدام الذاكرة المؤقتة يقلل التكلفة بشكل كبير. كل مهمة تتطلب استخدام حوالي 7,500 رمز من رسالة النظام، لكن بعد الخطوة الأولى تصبح معظم هذه الرموز مسترجعة من الذاكرة المؤقتة بتكلفة تعادل 3% فقط من تكلفة الرموز الجديدة. ولهذا السبب تظل المهام متعددة الخطوات رخيصة.
  • استخدم V4-Pro عددًا أقل من الاستدعاءات للحصول على نفس النتيجة (12 مقابل 14 في مهمة إعادة التسمية). وفي هذه المجموعة من المهام، كان V4-Flash أسرع وأرخص بنسبة الثلث تقريبًا، لذا ظل خياري الافتراضي.
  • النموذج المحلي أدى أداءً جيدًا أيضًا. نموذج Gemma-4-26B، وهو نموذج من نوع mixture-of-experts يحتوي على 4 مليارات معلمة نشطة، تم تكميمه إلى مستوى Q4 وتم تشغيله عبر llama.cpp على جهازين من نوع RTX 5090. نجح النموذج في تنفيذ جميع المهام؛ استخدم كمية أكبر من الذاكرة المؤقتة (237 ألف رمز مقابل 136 ألف لـ V4-Flash)، لكن زمن تنفيذه كان منافسًا. هذه هي المرة الأولى التي يصبح فيها النموذج المحلي خيارًا واقعيًا للقيام بمثل هذه المهام بدلاً من كونه مجرد تجربة نظرية. لكن خمس مهام بسيطة لا تكفي للحكم على قدرة النموذج على التعامل مع مشروع برمجي يتكون من 40 ملفًا.

القاعدة التي اتبعتها في النهاية: استخدام V4-Flash للمهام البسيطة والآلية، وV4-Pro عندما تحتاج المهمة إلى خطوات أقل وأكثر كفاءة، أما النموذج المحلي فأستخدمه فقط في المهام التي لا تكلف الكثير لإعادة تنفيذها ولا تتطلب نقل البيانات إلى خارج الجهاز.

الاختبار الممتع: صمم لي لعبة

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

مرر الماوس فوقه، ثم انقر عليه. تتحرك البكسلات بعيدًا عن مؤشر الماوس ثم تعود إلى مكانها. النقر يقسم الصورة إلى بكسلات تتحرك في كل الاتجاهات قبل أن تعود إلى مكانها. اللمس أيضًا يعمل، وهو يحترم إعداد prefers-reduced-motion.
أربعة مشاهد لشعار البكسلات: الحالة العادية، بكسلات تنفصل حول المؤشر مع توهج أزرق، سحابة من البكسلات باللون السماوي ترتد من الحواف بعد النقر، وأخيراً عودة البكسلات إلى شكل الحلقة والحرفين L
الحالة العادية ← انفصال البكسلات عند التحويم ← تفتت البكسلات ← عودتها إلى شكلها الأصلي، تم التقاط هذه المشاهد باستخدام متصفح Chromium بدون واجهة مستخدم. معدل الإطارات: 61 إطاراً في الثانية، ولا توجد أخطاء في وحدة التحكم؛ والبكسلات تعود فعلاً إلى شكلها الأصلي.

كيف سارت الأمور:

  • المحاولة الأولى (V4-Flash): حلقة تكرارية استمرت 10 دقائق ولم يتم إنشاء أي ملفات. السؤال المطلوب كان يسمح برسم يدوي أو إنشاء صورة نقطية باستخدام خوارزميات. فاختار النموذج أن يرسم يدويًا صورة نقطية بحجم 40×40، لكنه وقع في حلقة تكرارية؛ حيث كان سجل الجلسة مليئًا بمئات الأسطر التي تحتوي على ################ و.... حتى انتهت الجلسة بسبب انقضاء الوقت المسموح. هذا أدى إلى هدر حوالي 2 سنتات من التكاليف. الدرس المستفاد: لا تسمح أبدًا للنموذج برسم البكسلات يدويًا في ذاكرته.
  • المحاولة الثانية (V4-Flash؛ تم تغيير الوصف إلى “تحويل الهندسة إلى صورة راسترية دون استخدام ملفات بت): استغرقت 25 دقيقة، وتم إنجاز كل شيء. استغرق الأمر 100 خطوة معالجة للنموذج، و201 استدعاء لأدوات المعالجة، بالإضافة إلى 172 ألف رمز ناتج (منها 123 ألف رمز متعلق بالتفكير المنطقي)، و16.3 مليون رمز تم استرجاعه من الذاكرة المؤقتة؛ التكلفة الإجمالية كانت حوالي 49 سنتًا وفقًا لأعلى أسعار الخدمة. كتب البرنامج ملف `ll-pixel-logo.js` مكون من 399 سطرًا، يحتوي على واجهة برمجية عالمية واحدة وخيارات `data-`؛ كما أعد صفحة تجريبية، وملف README، واختبار وحدة Node للأداة المستخدمة في تحويل الهندسة إلى صورة راسترية؛ وبشكل غير مطلوب أيضًا، كتب سكريبت Playwright يلتقط لقطة شاشة للصفحة التجريبية بثلاثة أحجام مختلفة. استنفد البرنامج الوقت المحدد بـ 25 دقيقة أثناء تحسين محتوى ملف README، لذا أظهر رمز الخروج أن هناك انتهاءً للوقت رغم إتمام العمل بالفعل؛ فرموز الخروج قد تكون خاطئة في كلا الاتجاهين.
  • التصميم: الخاتم والحرفان “L” المائلان يبدوان كالشعار من النظرة الأولى، لكنهما أكثر سمكًا وأشبه بحرف “Z” مقارنة بالشعار الحقيقي. كنت سأقضي عشر دقائق في ضبط ثوابت التحويل قبل الاستخدام الفعلي؛ لكنني لم أفعل ذلك، وما ترونه هو النسخة غير المعدلة.
  • لقد استغرق تضمينه هنا سطرًا واحدًا فقط، وذلك لأن سياسة الأمان للموقع هي script-src 'self' والويجت لا يقوم بأي طلبات شبكة. كان ذلك ما طُلب في التعليمات، وقد تم الالتزام بها.
  • تكلفة متابعة واحدة: كتب برنامج dsh ملفات الإخراج باستخدام صلاحيات الوصول 0600. قام نظام النشر الخاص بي بنسخ هذه الصلاحيات إلى خادم الويب، مما أدى إلى ظهور خطأ 403 في الموقع الحي حتى قمت بتنفيذ الأمر chmod 644. يجب تصحيح صلاحيات الوصول لأي ملفات يتم نسخها من مساحة عمل dsh.

ملاحظات مهمة

  • هذه نسخة تجريبية للمطورين، وهذا ما يذكره ملف README. لقد قمت بتثبيت الإصدار 0.1.0-rc.7 بعد ثلاثة أيام من صدور الإصدار rc.6. قد تتغير ملفات الإعدادات وتخطيط الإضافات؛ لذا يجب تثبيت إصدار معين في أي سكربتات أتمتة تستخدمها، وإجراء اختبارات بسيطة بعد كل تحديث.
  • وضع التشغيل بدون واجهة رسومية لا يعرض أي مخرجات حتى ينتهي التنفيذ. لا يتم إرسال أي بيانات إلى stdout، لذا قد يبدو أن المهمة عالقة. يمكنك قراءة سجل الجلسة (~/.dsh/sessions/…/session.jsonl.zstd) الذي يكون مضغوطًا باستخدام برنامج zstd، أو مراقبة التقدم عبر واجهة الويب. قيمة الخروج 0 تعني “انتهى التنفيذ” وليس بالضرورة “نجحت المهمة”؛ لذا يجب التحقق من نتيجة التنفيذ.
  • لا يوجد خيار --model في وضع التشغيل بدون واجهة رسومية. يتم تحديد النموذج الافتراضي من ملف settings.yaml؛ يمكنك تغييره هناك (يتم تطبيق التغييرات فورًا) أو عبر واجهة الويب.
  • الخوادم المحلية التي لا تتطلب مفاتيح تشفير تحتاج إلى بيانات اعتماد مؤقتة، كما أن معرفات مزودي الخدمة ثابتة ولا يمكن تغييرها. راجع الخطوة 3 لمزيد من التفاصيل.
  • واجهة الويب تستخدم مسارات مطلقة مثل /assets/… و /api، لذا لا يمكن تركيبها تحت مسار فرعي عبر بروكسي عكسي دون إعادة كتابة المسارات. الحل الأفضل هو تضمينها في موقعك أو استخدام اسم نطاق منفصل لها.
  • لغة واجهة المستخدم تتطابق مع لغة متصفحك. يشير ملف index.html إلى lang="zh-CN"، وتظهر رسالة “إشعار اختبار داخلي” عند بدء التشغيل؛ انقر على “متابعة”، وبعد ذلك كانت اللغة الإنجليزية هي المستخدمة في واجهة المستخدم.
  • عملية التثبيت تقوم بتنفيذ سكربتات postinstall مثل node-pty و koffi و protobufjs، ويصدر برنامج npm تحذيرات بخصوص ذلك. لم ألاحظ أي محتوى ضار، لكن هذه عمليات تجميع للكود الأصلي في بيئة التثبيت؛ لهذا السبب يُفضل استخدام مسار تثبيت خاص بدلاً من المسار الافتراضي للنظام.
  • إصدار Node المطلوب: يتطلب الإصدار rc.7 وجود Node بإصدار 22.19 أو أحدث، أو إصدار 24؛ بينما ترفض الإصدارات الأقدم من LTS التشغيل. يُرجى مراجعة ملف README الخاص بالإصدار الذي تقوم بتثبيته.

ملاحظة تاريخية: dsh بجانب Reasonix

في شهر أغسطس، استخدمت برنامج dsh إلى جانب Reasonix، وهو وكيل طرفي من تطوير طرف ثالث. كان التقسيم بسيطًا: فـ Reasonix هو واجهة TUI كنت أفتحها عندما أريد التفاعل مع الوكيل، بينما dsh هو البرنامج الذي تتصل به باقي برامجي. توقفت عن استخدام Reasonix في إعداداتي في تاريخ 2026-09-09، وأصبح dsh الآن وكيلي البرمجي الرئيسي. إذا كنت تحاول الاختيار بينهما، فالفرق الجوهري هو أن dsh يدعم وضعًا بدون واجهة مستخدم يمكن التحكم فيه عبر أوامر واحدة فقط، مما يسهل كتابة السكربتات له؛ بينما تفترض واجهات TUI وجود إنسان أمام لوحة المفاتيح.

ماذا يعني ذلك بالنسبة لي؟

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

مرتبط بما يلي: DeepSeek Everywhere (دمج DeepSeek مع Claude Code ومجموعة الأدوات البرمجية)، Kimi K3 كوكيل برمجي (تنفيذ نفس المهام الخمس باستخدام dsh في شهر سبتمبر)، bench-llm وخليفته CrucibleForge (أداة لقياس أداء النماذج المحلية بشكل أكثر جدية مما فعلت هنا)، وReasonix (وكيل سطر الأوامر الذي استخدمته قبل dsh، والآن تم إيقاف استخدامه).


← المزيد من الذكاء الاصطناعي والنماذج المحلية