العودة إلى المدونة

الوكلاء والأتمتةدليل

شغّل dsh-superagent على نموذج رخيص: من مشكلة GitHub إلى طلب سحب

اضبط dsh-superagent من DeepSeek بحيث تصبح المشكلة التي تذكر حساب الوكيل طلب سحب، وقدّر تكلفة تذكرة واحدة بالرموز.

بواسطة CheapTokens Teamنُشر في 5 دقيقة قراءة

طرفية تعرض تشغيل dsh-superagent بجانب علامتي DeepSeek Harness وdsh-superagent
في هذه الصفحة
  1. ما الذي يفعله فعليًا
  2. قبل أن تبدأ
  3. التثبيت والتشغيل
  4. امنح الوكيل حساب GitHub خاصًا به
  5. أول مشكلة اختبارية لديك
  6. كم تكلف تذكرة واحدة
  7. أبقِه تحت رقابة مشددة
  8. المصادر

تذكر وكيلًا في مشكلة GitHub جديدة، وتذهب لإعداد الشاي، وتعود لتجد طلب سحب. هذا ما يفعله dsh-superagent من DeepSeek، ويمكنك تشغيله على نموذج CheapTokens عبر DeepSeek Harness (DSH). فيما يلي: التثبيت، وحساب GitHub الخاص بالوكيل، وأول مشكلة اختبارية، وميزانية لتذكرة واحدة.

تحذير من المستودع نفسه. يصفه ملف README (تم التحقق منه في 2 نوفمبر 2026) بأنه نموذج أولي بحثي للرجوع فقط، وليس منتجًا رسميًا من DeepSeek، ويقول إنه قد يحتوي على أخطاء. إنه مرخّص بموجب MIT، وله التزام واحد على main ولا إصدارات. شغّله على مستودع يمكنك تحمّل التجربة عليه.

ما الذي يفعله فعليًا#

dsh-superagent وكيل برمجي استباقي لمستودع GitHub واحد، معبّأ كحزمة لـ DeepSeek Harness. يستمع إلى GitHub. عندما يطلب شخص من قائمتك المسموح بها، يفتح عنصر عمل (تسميه الوثائق Ticket)، ويعمل في جلسة وكيل خاصة به ودليل خاص به، ويرد في المحادثة الأصلية، مثلًا بطلب سحب. تعرض لوحة ويب العناصر التي تحتاج إلى شخص.

إذن مشكلة واحدة هي جلسة واحدة، والجلسة الواحدة حلقة من استدعاءات النموذج. في هذه الحلقة تُستهلك الرموز؛ إن لم تكن قد رأيت السبب، فإن لماذا تستخدم وكلاء الذكاء الاصطناعي هذا العدد الكبير من الرموز يشرح مثالًا من 20 خطوة.

من المشكلة إلى طلب السحب: يُذكر حساب الوكيل، تُفتح تذكرة، تعمل جلسة، يعود طلب سحب
مسار تذكرة واحدة في dsh-superagent

قبل أن تبدأ#

تحتاج، وفقًا لوثيقة النشر:

  • Node.js 22.19+ أو 24+، وpnpm، وgit 2.32+، وtmux، وPython 3.8+
  • GitHub CLI 2.48+ (يُستخدم عبر غلاف صغير، انظر أدناه)
  • مستودعًا على github.com (GitHub Enterprise Server غير مدعوم)
  • DSH في نطاق الإصدار من engines.dsh في package.json الخاص بالمستودع
  • مزوّد نموذج DSH

العنصر الأخير هو ما يتركه المستودع لك: يسمي دليل الإعداد المزوّد خطوة مشغّل. بالنسبة إلى CheapTokens، اربط DeepSeek Harness بـ CheapTokens أولًا ثم عد. معرّف النموذج الذي يجب استخدامه هو deepseek-ai/DeepSeek-V4-Flash-0731 (المعرّف الكامل، فالاسم المختصر من جداول الأسعار لا تقبله واجهة API)، وقاعدة API هي https://api.cheaptokens.dev/v1. التفاصيل في صفحة وثائق CheapTokens.

أمر يجب الانتباه إليه. وفقًا لوثيقة النشر، يزيل الإعداد متغيرات البيئة التي تحتوي أسماؤها على KEY أو PASSWORD أو SECRET أو TOKEN، ويحذف GH_TOKEN وGITHUB_TOKEN من بيئة العامل. لذا لن يصل مفتاح المزوّد المصدَّر في الصدفة إلى العامل؛ اضبطه كما هو موضح في مقال الربط.

التثبيت والتشغيل#

خطوة بخطوة

ثبّت الحزمة

ثبّت DSH والمستودع

تثبّت الوثيقة (docs/006-deployment.md، تم التحقق منها في 2 نوفمبر 2026) مرشح إصدار:

bash
npm install -g @deepseek-ai/dsh@0.2.1-rc.3
git clone https://github.com/deepseek-ai/dsh-superagent-prototype dsh-superagent
cd dsh-superagent
pnpm install && pnpm build

أنشئ الملف الشخصي (للتثبيت الجديد فقط)

bash
dsh superagent --from-default-profile web --dump-config > /dev/null
dsh plugin --profile superagent add "link:$PWD"

شغّل السطر الأول مرة واحدة فقط. على ملف شخصي superagent موجود، يستبدل الملف الشخصي ويحذف cordis.patch.yml الخاص به.

أضف الإعداد

انسخ examples/profile.cordis.patch.yml إلى ~/.dsh/profiles/superagent/cordis.patch.yml. المفتاح الوحيد المطلوب هو stateDir، مسار مطلق تعيش فيه قاعدة البيانات والأقفال وملفات العامل. يضبط مدخل webserver المنفذ (3082 افتراضيًا).

شغّله

bash
scripts/dsh-superagent start
scripts/dsh-superagent status

يعمل start داخل جلسة tmux تسمى dsh-superagent.

أوامر التثبيت والتشغيل لـ dsh-superagent في طرفية
الأوامر الأربعة المهمة، من docs/006-deployment.md

يجيب أمر الحالة برمز خروج: 0 طبيعي، و1 يعني أن إعادة التشغيل قد تساعد، و2 يعني أن جزءًا فشل ولن تصلحه إعادة التشغيل، و3 يعني أن الإعداد لا يزال مطلوبًا. ابدأ بالإعدادات الافتراضية: الملف الشخصي superagent، وبادئة الفرع agent/، ووضع القبول observe، الذي يسجل العمل الاستباقي دون تنفيذه.

امنح الوكيل حساب GitHub خاصًا به#

هذه هي الخطوة التي يتخطاها الناس ثم يتساءلون لماذا لا يحدث شيء. يحتاج الوكيل إلى مستخدم GitHub عادي لديه صلاحية كتابة على مستودعك؛ ولا يمكن لتطبيق GitHub أن يؤدي هذا الدور.

  1. أنشئ المستخدم وأضفه كمتعاون بصلاحية كتابة.
  2. أنشئ غلافًا ~/.local/bin/gh-agent: GH_CONFIG_DIR="$HOME/.config/gh-agent" exec gh "$@". هذا يفصل تسجيل دخول الوكيل عن gh الخاص بك.
  3. شغّل gh-agent auth login بصفتك ذلك المستخدم.
  4. في لوحة الويب، افتح Sources، واضبط المستودع (owner/name) ومسار CLI إلى الغلاف.
  5. ضمن Policy، أضف عمليات تسجيل الدخول التي يجوز لها إعطاء الوكيل عملًا إلى policy.sources.github.allowed. لا يصبح شيء تذكرة حتى يكون شخص ما في تلك القائمة.

قائمة التحقق

قبل أول مشكلة

أول مشكلة اختبارية لديك#

افتح مشكلة جديدة في المستودع واكتب شيئًا صغيرًا لا لبس فيه، مع تسجيل دخول الوكيل بتنسيق الكود، مثلًا: @<agent login> fix the typo in README.md: "recieve" should be "receive".

كلمة "جديدة" مهمة. تحرير مشكلة قديمة لإضافة الإشارة لا يُلتقط؛ المشكلة الجديدة أو التعليق الجديد يُلتقط. إذا عرضت اللوحة تذكرة ثم ظهر فرع يبدأ بـ agent/، فالسلسلة تعمل.

جرّب بنفسكجرّب: لا يحدث شيء بعد إشارتك. ما أول ما تتحقق منه؟إظهار الإجابة

قائمة السماح. حتى يكون تسجيل دخولك في policy.sources.github.allowed، لا يصبح شيء تذكرة. بعد ذلك، تحقق من أن الإشارة كانت في مشكلة أو تعليق جديد، لا في عنصر محرَّر.

كم تكلف تذكرة واحدة#

لا ينشر المستودع استخدام الرموز لكل تذكرة، لذا هذا تقدير مبني على افتراضات معلنة. لنقل إن تذكرة صغيرة تستغرق 25 استدعاء نموذج. يحمل كل استدعاء المحادثة المتنامية: نحو 30,000 رمز إدخال في المتوسط، ونحو 800 رمز إجابة (أمر، أو رقعة، أو ملاحظة قصيرة).

لكل تذكرة ذلك يعني 30,000 × 25 = 750,000 رمز إدخال و800 × 25 = 20,000 رمز إخراج. على DeepSeek-V4-Flash بأسعار CheapTokens اليوم (إدخال $0.015 وإخراج $0.10 لكل مليون رمز)، تبلغ هذه التذكرة $0.0133.

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

النموذج التكلفة OpenRouter
GLM-5.3-Flash $0.0158 $0.0268
DeepSeek-V4-Flash $0.0133 $0.0553
MiniMax-M2.7 $0.0405 $0.486

750,000 رمز إدخال و20,000 رمز إخراج إجمالًا. الأسعار لكل مليون رمز حالية وتتغير مع تعريفاتنا؛ يعرض عمود OpenRouter أسعارًا مرجعية لنفس حجم العمل.

يسرد الجدول أيضًا GLM-5.3-Flash (سياق 390K، وحتى 8,192 رمز إخراج لكل إجابة) إذا كانت تذاكرك قصيرة والإجابات صغيرة. لحلقات الأدوات الطويلة، يمنحك DeepSeek-V4-Flash سياقًا 380K، وحتى 32,768 رمزًا لكل إجابة، وسعرًا واحدًا في أي ساعة. ستختلف أرقامك، لذا حرّك المنزلقات:

حاسبة التكلفة

يوم بخمس تذاكر (25 استدعاءً لكل منها)

رموز الإدخال لكل طلب: 30,000 · رموز الإخراج لكل طلب: 800 · الطلبات يوميًا: 125

النموذجيوميًاشهريًا
GLM-5.3-Flash$0.079$2.37
DeepSeek-V4-Flash$0.0663$1.99
MiniMax-M2.7$0.203$6.08

إذا أردت تقليص جانب الإدخال، فإن كيفية تقدير تكلفة وكيل ذكاء اصطناعي تغطي العادات الأهم.

أبقِه تحت رقابة مشددة#

ابقَ على وضع observe ليوم واحد: يسجل ما سيفعله الوكيل من تلقاء نفسه، فترى النمط قبل أن يتصرف. اسمح بتسجيل دخولك فقط في البداية. راجع أول ثلاثة طلبات سحب سطرًا بسطر، وتحقق من استخدام النموذج على رصيدك بعد اليوم الأول، ثم اضرب في عدد تذاكرك الفعلي.

يقول المستودع أيضًا إن بعض التصاميم من مقال DeepSeek المرافق لم تُنفَّذ بعد، لذا تعامل مع الميزات الناقصة على أنها غير مكتملة، لا على أنها خطؤك.

المصادر#

كل حقائق المستودع تأتي من deepseek-ai/dsh-superagent-prototype (README، وSETUP.md، وdocs/006-deployment.md)، تم التحقق منها في 2 نوفمبر 2026. لا تعرض صفحة المستودع تاريخ التزام، وإصدار DSH 0.2.1-rc.3 مرشح إصدار، لذا أعد التحقق من الوثيقة قبل التثبيت.