أدوات البرمجة

DeepSeek Harness

قم بتهيئة نموذج TokenLab في Harness، والتحقق من الطلب، واختيار MCP، أو Skills، أو حزمة المزود

اختر الاتصال الذي تحتاجه

لاستخدام TokenLab كنموذج رئيسي للوكيل، أضف مزوداً مخصصاً (custom provider) في واجهة ويب Harness. يعمل هذا بشكل مستقل عن حزمة مزود TokenLab الاختيارية. أضف أدوات MCP للوسائط وواجهات برمجة التطبيقات الأخرى، أو Skill لتعليمات واجهة برمجة التطبيقات؛ لا يغير أي منهما النموذج الرئيسي بحد ذاته.

Harness حالياً في مرحلة معاينة المطورين (developer preview). تتبع خطوات واجهة الويب هذه التوثيق الرسمي لـ @deepseek-ai/dsh الإصدار 0.2.0-rc.2، وهو إصدار npm latest الحالي (تم التحقق منه في 12 أكتوبر 2026). تم اختبارها آخر مرة من البداية إلى النهاية على الإصدار 0.1.5-rc.3؛ لم تتم إعادة تشغيل فحوصات الطلبات أدناه مقابل الإصدار 0.2.0-rc.2. لا تزال الحزمة الاختيارية أدناه تستهدف الإصدار 0.1.5-rc.3؛ تحقق من التوافق مع إصدارات Harness الأخرى بشكل منفصل.

امنح هذه المهمة لوكيلك

Read https://tokenlab.sh/docs/ar/integrations/deepseek-harness and check my installed version and operating system.
Confirm whether I need TokenLab as the main model, MCP tools, or API Skills.
Preserve existing accounts, provider configuration, and permissions; explain how to restore changed settings.
Keep API keys local; do not ask me to paste them into chat. I will enter the key locally and perform required UI steps.
Explain the cost of a small verification request. Only after I explicitly choose that test, help run it and match the TokenLab request record.

ابدأ تشغيل Harness

استخدم Node CLI على macOS أو Linux أو Windows مع إصدار Node مدعوم؛ يُعد Node 24 LTS نقطة بداية مناسبة. من دليل مشروعك، قم بتشغيل هذا في Terminal أو PowerShell:

node --version
npx @deepseek-ai/dsh web

بدون تحديد إصدار، يقوم npx بتثبيت إصدار npm latest، والذي قد يكون أحدث من 0.2.0-rc.2، وهو الإصدار الذي تم التحقق من هذه الخطوات مقابله. لا يقوم بتثبيت إصدار alpha.

افتح رابط URL المحلي الذي يطبعه الأمر. في واجهة ويب جديدة، استخدم Choose workspace لإضافة وتحديد دليل مشروعك قبل إرسال رسالة. تستخدم هذه الأوامر ملف تعريف web؛ ملف تعريف desktop الخاص بتطبيق Electron لا تتم إدارته بواسطة سير عمل CLI هذا. راجع دليل البدء الرسمي ودليل واجهة الويب.

تهيئة مزود TokenLab واحد

  1. افتح Settings → Models، واختر Add model provider، ثم قم بتبديل البطاقة إلى Custom model API. (كان Harness 0.1.5-rc.3 يسمي هذا Add a custom provider.) حافظ على أي مزودين وصلاحيات موجودة.
  2. أدخل معرف مزود (Provider ID) بأحرف صغيرة، مثل tokenlab-chat، واختر بروتوكولاً واحداً وعنوان URL الأساسي (Base URL) المطابق له أدناه. يستخدم كل مزود بروتوكولاً واحداً.
  3. أدخل مفتاح TokenLab API الخاص بك في النموذج المحلي. يخزن Harness المفاتيح التي تتم إدارتها عبر واجهة المستخدم في $DSH_HOME/.credentials.yaml؛ تحتفظ الإعدادات فقط بمرجع الاعتماد الخاص به. لا ترسل المفتاح في الدردشة أو تقم برفعه (commit). يتم حفظ المزود وبروتوكوله في $DSH_HOME/profiles/<profile>/cordis.patch.yml، وهو $DSH_HOME/profiles/web/cordis.patch.yml لملف تعريف dsh web القياسي.
  4. أضف معرف نموذج (model ID) حالي واحد من نماذج TokenLab. تحقق من tokenlab.accepted_request_formats الخاص به في API تفاصيل النموذج، بدلاً من تخمين الدعم من اسمه.
  5. احفظ المزود، وحدد نموذجه، وابدأ جلسة جديدة. الجلسة الموجودة التي أرسلت طلباً بالفعل تحتفظ بالنموذج المسجل الخاص بها.
مثال على معرف المزودبروتوكول Harness APIعنوان URL الأساسيتنسيق الطلب العام المطلوب
tokenlab-chatopenai-completionshttps://api.tokenlab.sh/v1openai_chat_completions
tokenlab-responsesopenai-responseshttps://api.tokenlab.sh/v1openai_responses
tokenlab-messagesanthropic-messageshttps://api.tokenlab.shanthropic_messages

بالنسبة لطلب نصي أول، يمكن لمدخل gpt-5.6-luna المتاح حالياً استخدام صف Chat. يمكن أن يساعد Fetch available models → Add selected في ملء مزود مخصص، لكن نجاح الإدراج لا يتحقق من دعم البروتوكول أو الطلب القابل للفوترة؛ احفظ المزود بعد ذلك. أدخل المعرف يدوياً إذا كان الاكتشاف غير متاح.

لا يوفر Harness بروتوكول مزود مخصص أصلي لـ Gemini هنا. استخدم Chat فقط عندما تدرج تفاصيل ذلك النموذج Chat Completions كتنسيق طلب مقبول. قد تحتاج مدخلات الصور وعناصر التحكم في الاستدلال إلى حقول إضافية في $DSH_HOME/profiles/web/cordis.patch.yml؛ اتبع تهيئة مزود Harness والحقول المدعومة للنموذج المحدد قبل تمكينها. (لم تتم إعادة الاختبار على 0.2.0-rc.2 بعد.)

التحقق من طلب صغير واحد

في الجلسة الجديدة، أرسل:

Reply only with TOKENLAB_CONNECTION_OK. Do not use tools or modify files.

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

اختياري: حزمة TokenLab

تستهدف @tokenlabai/dsh-provider@0.1.6 إصدار Harness 0.1.5-rc.3: لا تزال تبعياتها المقابلة هي @deepseek-ai/dsh-tools و @deepseek-ai/dsh-mcp-client 0.1.5-rc.3. لم يتم اختبارها مع Harness 0.2. لاستخدام الحزمة، قم بتشغيل الإصدار المطابق: npx @deepseek-ai/dsh@0.1.5-rc.3 web. استخدم خطوات المزود المخصص الأصلية أعلاه لتهيئة نموذج واحد، أو قم بتثبيت الحزمة للحصول على مسارات النماذج والأدوات المحددة مسبقاً.

تحتوي الحزمة على لقطة ثابتة لـ 145 نموذج دردشة عام تم التحقق منها في 3 أكتوبر 2026: 28 Responses، و11 Messages، و106 Chat. يظهر كل نموذج في مسار واحد فقط. وهي تثبت @tokenlabai/mcp-server@0.6.25 وتتضمن أداة tokenlab_wait_task المنفصلة. لا يؤدي تثبيت هذا الإصدار إلى تحديث كتالوج النماذج. تحقق من المعرفات مقابل الكتالوج المباشر وأضف نماذج أحدث من خلال مزود مخصص عند الحاجة.

بالنسبة لتثبيت Harness متوافق موجود، تأكد أولاً من وجود pnpm في PATH. استخدم نفس ملف تنفيذ/إصدار dsh وملف التعريف للتثبيت والبدء؛ إذا قمت بالتشغيل من خلال npx، فاستبدل dsh أدناه بنفس المشغل ذي الإصدار:

dsh --version
pnpm --version
dsh plugin --profile web add --workspace-root @tokenlabai/dsh-provider@0.1.6

قبل بدء ملف التعريف هذا، قم بتعيين المفتاح في بيئة التشغيل أو ملف .env الخاص به:

TOKENLAB_API_KEY=sk-your-tokenlab-key

يقرأ Harness ملف .env في الدليل الذي تقوم بتشغيله منه وفي $DSH_HOME (عادةً ~/.dsh)؛ متغير البيئة الموروث له الأولوية. اختيار مساحة عمل لاحقاً لا يختار ملف .env مختلفاً. احتفظ بهذا الملف خارج git وأعد التشغيل بعد تغييره. المفتاح المحفوظ لمزود مخصص في واجهة المستخدم لا يوفر تلقائياً TOKENLAB_API_KEY لهذه الحزمة.

أعد تشغيل نفس ملف التعريف، ثم افحص قوائم النماذج والأدوات الخاصة به. بالنسبة لـ headless، قم بالتثبيت في headless وتشغيله بدلاً من web؛ التثبيت في ملف تعريف واحد لا يقوم بتهيئة الآخر.

في Harness 0.1.5-rc.3 (هدف الحزمة)، يقوم Harness بدمج llm-pi-ai.providers المحفوظة حسب مفتاح المزود. يتعايش المزودون ذوو المفاتيح المختلفة. تتجاوز إدخالات tokenlab-responses أو tokenlab-messages أو tokenlab-chat المحفوظة المسار المجمع المقابل؛ راجع تلك الإدخالات عند ترقية كتالوج قديم. حافظ على المزودين والنماذج الأخرى في $DSH_HOME/settings.yaml؛ لا تستبدل مستند الإعدادات بالكامل بـ Cordis patch.

تحدد تفاصيل النموذج العام قدرة الاستدلال ولكنها لا تعدّد قيم الجهد المدعومة لكل نموذج. لذلك تترك الحزمة reasoningEfforts غير معلنة. لا يقدم Harness مستويات جهد لهذه المسارات المخصصة؛ هذا لا يعطل الاستدلال من جانب الخادم. إذا قمت بتهيئة reasoningEfforts بنفسك، فاستخدم فقط القيم التي تم التحقق منها بشكل منفصل في إدخال النموذج في قائمة models الخاصة بالمزود وحافظ على النماذج الأخرى. قدرة الاستدلال وحدها لا تثبت الدعم لـ xhigh أو max.

تستخدم الحزمة افتراضياً TOKENLAB_MCP_TOOL_PROFILE=core مع 32 أداة MCP و TOKENLAB_MCP_SCHEMA_MODE=portable. اختر catalog للاكتشاف فقط (6 أدوات)، أو full لجميع الأدوات الـ 89، بما في ذلك دورة حياة الاستجابة الإضافية، والعمليات المجمعة، وعمليات أصول/مجموعات Seedance، وعمليات العوالم. تظل أداة tokenlab_wait_task المنفصلة متاحة في كل ملف تعريف وغير مدرجة في أعداد MCP هذه. TOKENLAB_API_BASE و TOKENLAB_ANTHROPIC_BASE_URL افتراضياً https://api.tokenlab.sh؛ و TOKENLAB_OPENAI_BASE_URL افتراضياً https://api.tokenlab.sh/v1.

بالنسبة لأدوات وسائط الحزمة، افحص delivery.mode: استهلك مخرجات complete مباشرة؛ مرر delivery.task_id الخاص بنتيجة async إلى tokenlab_wait_task واقرأ status و response و result_urls النهائية الخاصة به. مهلة الانتظار ليست مهمة مكتملة. احتفظ بالموافقات للأدوات القابلة للفوترة أو المدمرة. راجع المهام غير المتزامنة.

لإزالة الحزمة، استخدم نفس المشغل وملف التعريف، ثم أعد التشغيل:

dsh plugin --profile web remove --workspace-root @tokenlabai/dsh-provider

إذا فشل الأمر

  • المؤلف (composer) معطل: حدد كلاً من مساحة العمل والنموذج.
  • MISSING_CREDENTIAL أو 401: تحقق من اعتماد المزود المحدد. بالنسبة لأدوات الحزمة، تحقق من TOKENLAB_API_KEY في بيئة التشغيل؛ مفتاح النموذج المحفوظ في واجهة المستخدم هو إعداد منفصل.
  • UNKNOWN_MODEL أو معرف متقاعد: تحقق من الكتالوج المباشر، وقم بتهيئة المعرف الدقيق الحالي، ثم أنشئ جلسة جديدة. إعادة تثبيت الحزمة 0.1.6 لا تحدث لقطتها.
  • عنوان URL قابل للوصول ولكن التوليد يفشل: قارن البروتوكول، وعنوان URL الأساسي، وتنسيقات النموذج المقبولة. لا تحذف السجل أو الأدوات أو مدخلات الصور لمجرد تحويل خطأ إلى فحص ناجح.
  • dsh أو pnpm مفقود: استخدم npx @deepseek-ai/dsh web (أو @0.1.5-rc.3 للحزمة)؛ قم بتثبيت pnpm قبل استخدام أوامر المكونات الإضافية. فشل تثبيت المكون الإضافي ليس فشلاً في مفتاح API.

MCP و Skills خيارات منفصلة

المزود المخصص اليدوي لا يقوم بتثبيت الأدوات. اتبع دليل TokenLab MCP إذا كنت بحاجة إلى أدوات API قابلة للاستدعاء بدون الحزمة، وتحقق من الاكتشاف قبل أي توليد.

بالنسبة لـ TokenLab Skills، احتفظ بمجلد المهارة الكامل في .dsh/skills/tokenlab-api-integration/ تحت جذر المشروع، بما في ذلك SKILL.md والملفات المشار إليها. يكتشف Harness أيضاً .agents/skills/. هذه التعليمات لا تقوم بتثبيت مزود أو خادم MCP أو مفتاح. يحدد مرجع مهارات نظام الملفات الرسمي المواقع المدعومة.

Jev / System One و Webhooks

استخدم mcp__tokenlab__evaluate_decisions في core أو full لـ Jev (POST /v1/systemone). اكتشف category=decision وافحص النموذج أولاً. هذه قرارات متزامنة، وليست نماذج دردشة أو مهام غير متزامنة؛ لا تستخدم منتقي النماذج أو tokenlab_wait_task.

تتطلب إدارة Webhook إصدار full و TOKENLAB_MANAGEMENT_TOKEN=mt-... منفصل في بيئة التشغيل، يتم تمريره صراحةً إلى MCP بواسطة الحزمة. لا يمكن لمفتاح الاستدلال أن يحل محله. تتمتع رموز الإدارة بصلاحية على مستوى مساحة العمل تتجاوز Webhooks؛ تسجيل Webhook لا يجعل Harness مستقبلاً.

في هذه الصفحة