يعمل DeepSeek Harness مع Novita AI عن طريق تشغيل واجهة الويب الخاصة بـ Harness محليًا وإضافة Novita AI كمزود نماذج مخصص متوافق مع OpenAI. قم بتثبيت Node.js، وشغّل npx @deepseek-ai/dsh web، وافتح http://127.0.0.1:3080، ثم استخدم https://api.novita.ai/openai كعنوان URL الأساسي للمزود، ومفتاح API من Novita AI كبيانات اعتماد، ومعرف النموذج من مكتبة نماذج Novita AI. يستغرق الإعداد بضع دقائق؛ العمل الحقيقي هو اختيار النموذج المناسب للبرمجة، وتحليل المستودعات، والبحث، أو المهام ذات الحجم الكبير.
ما هو DeepSeek Harness
DeepSeek Harness هو إطار عمل وكيل مفتوح المصدر من DeepSeek AI مبني حول بنية “كل شيء عبارة عن إضافة”. تصف الوثائق الرسمية المشروع بأنه في مرحلة المعاينة للمطورين وتحذر من أن التغييرات التي تكسر التوافق محتملة، لذا فإن أفضل وضعية للإنتاج هي تثبيت إصدار يعمل، ومراجعة التغييرات قبل الترقية، والتحقق من صحة التكامل بعد كل ترقية.
الفرق بين النموذج والإطار يصبح أوضح عند تشغيلهما. LLM يقرأ المطالبة ويقرر ما يجب فعله بعد ذلك. الإطار يعطي لهذا القرار مسار تنفيذ: مساحة عمل، أدوات، شِل، متصفح، جلسات، تخزين، وطريقة لملاحظة ما حدث قبل اختيار الإجراء التالي. DeepSeek Harness يجمّع هذه الحلقة في واجهة ويب تقوم بتشغيلها على جهازك الخاص، بينما يمكن لنموذج الاستدلال أن يبقى خدمة API.
هذا التصميم يناسب عدة أنواع من العمل:
- تغييرات قاعدة الكود. دع الوكيل يفحص الملفات، ويقترح تصحيحًا، ويشغل الاختبارات، ويراجع بعد الفشل.
- فرز المستودعات. استكشف تبعية غير مألوفة، وحدد مسارات الاستدعاء، ولخّص مناطق الخطر، واكتب تذاكر متابعة.
- البحث والتقارير. ادمج التصفح، وإخراج الملفات، والملخصات المنظمة عندما تكون الإجابة موزعة على عدة صفحات.
- تجارب العمليات. اكتب نصوصًا برمجية، وشغّلها محليًا مع الموافقة، وسجّل ما تغير قبل توسيع نطاق سير العمل.
إنه أقل ملاءمة عندما تحتاج إلى استدعاء API صغير وقابل للتدقيق دون الوصول إلى الملفات أو التنفيذ المحلي. إطار عمل الوكيل هو بيئة تطوير، وليس مجرد نقطة نهاية للاستدلال. إذا كنت تحتاج فقط إلى completions الدردشة، فإن واجهة برمجة التطبيقات LLM من Novita AI المباشرة أبسط.
ما تحتاجه قبل الإعداد
تحتاج إلى أربعة أشياء:
- جهاز مثبت عليه Node.js.
- حساب Novita AI.
- مفتاح API من Novita AI.
- دليل عمل يمكن للوكيل قراءته، وتحريره عند الاقتضاء.
لتأكيد تثبيت Node.js، قم بتشغيل:
node --version
يعلن مستودع DeepSeek Harness الرسمي حاليًا عن دعم Node.js ^22.19.0 || >=24.0.0. إذا كان الأمر يطبع إصدارًا أقدم أو فشل، قم بتثبيت Node.js من nodejs.org، ثم أعد تشغيل الفحص. تجنب تشغيل الأوامر كمسؤول النظام إذا استطعت؛ إذا فشل npx لأنه لا يمكنه الكتابة إلى ذاكرة التخزين المؤقت العامة، أصلح صلاحيات Node.js/npm بدلاً من فتح شِل كجذر.
قبل مغادرة الإعداد، أنشئ مجلد مشروع مخصص وضعه تحت التحكم بالمصادر إذا كانت المحتويات مهمة. الإطار مع الوصول إلى الأدوات يمكن أن يكون مفيدًا للغاية، ولكن “انظر إلى هذا الكود” هو مستوى خطر مختلف عن “انشر إلى الإنتاج”. راجع الإجراءات المقترحة من الوكيل وتجنب توصيله ببيانات اعتماد لا يحتاجها.
كيفية توصيل نماذج Novita AI
الخطوة 1: الحصول على مفتاح API من Novita AI
سجّل الدخول إلى Novita AI، وافتح إدارة المفاتيح، وأنشئ مفتاحًا جديدًا، وانسخه فورًا. إذا أظهرت لوحة التحكم المفتاح مرة واحدة فقط، فضعه في مدير كلمات المرور أو المخزن السري المحلي الذي يستخدمه فريقك بالفعل. لا تقم بلصقه في وثائق، أو لقطة شاشة، أو مستودع مصدر، أو محادثة مشتركة.
لهذا الدليل، قم بتصديره في الشِل الذي سيشغل Harness:
export NOVITA_API_KEY="your-key"
المتغير يسهّل الإعداد فقط؛ تكوين المزود في واجهة المستخدم في القسم التالي هو ما يستخدمه Harness لإجراء استدعاءات النموذج.
الخطوة 2: تشغيل واجهة الويب الخاصة بـ DeepSeek Harness
يقدم ملف README الرسمي مسار تشغيل npm هذا:
npx @deepseek-ai/dsh web
التشغيل الأول يقوم بتنزيل الحزمة وتبعياتها، لذا قد يستغرق وقتًا أطول من التشغيلات اللاحقة. يقوم DeepSeek Harness بعد ذلك بفتح واجهة الويب على http://127.0.0.1:3080 افتراضيًا ويطلقها في متصفحك الافتراضي. إذا كنت تعمل عبر SSH أو لا تريد تشغيل المتصفح، فإن ملف README الرسمي يوثق العلم --no-open:
npx @deepseek-ai/dsh web --no-open
يمكن أيضًا تشغيل DeepSeek Harness من المصدر باستخدام pnpm install و pnpm run build و pnpm dsh web، ولكن مسار npm هو أسرع طريق لواجهة مستخدم عاملة وهو الذي يستخدمه هذا الدليل.
الخطوة 3: إضافة Novita AI كمزود مخصص
قد تتغير التسميات الدقيقة مع تطور DeepSeek Harness، لكن الهدف هو نفسه في واجهة الويب الحالية: افتح إعدادات النموذج/المزود وأضف مزودًا مخصصًا متوافقًا مع OpenAI.
| الحقل | القيمة المراد استخدامها |
|---|---|
| اسم العرض | Novita AI |
| معرف المزود | novita أو معرف محلي مستقر آخر |
| عنوان URL الأساسي | https://api.novita.ai/openai |
| مفتاح API | مفتاح API الخاص بك من Novita AI |
| كتالوج النماذج | قم بالتحديث أو أضف معرفات نماذج Novita AI المحددة التي تريدها |
استخدم https://api.novita.ai/openai، وليس مسارًا إلى نموذج محدد. حافظ على ثبات معرف المزود؛ إذا قمت بإعادة تسميته لاحقًا، فقد تشير إعدادات الجلسة الحالية إلى مزود لم يعد موجودًا. بعد حفظ المزود، قم بتحديث كتالوج النماذك واجعل النموذج مرئيًا في منتقي الجلسة.
بروتوكول API الذي يجب اختياره هو openai-completions. يوثق DeepSeek Harness هذا البروتوكول لـ OpenAI Chat Completions ويقدم openai-responses و anthropic-messages للبوابات التي تستخدم أشكال الطلب هذه بدلاً من ذلك.
الخطوة 4: اختيار النموذج ومساحة العمل
افتح مساحة عمل في واجهة مستخدم DeepSeek Harness واختر أحد نماذج Novita AI التي أضفتها للتو. إذا كانت واجهة المستخدم تحتوي على إجراء “الحصول على النماذج”، فاستخدمه بدلاً من كتابة معرف النموذج من الذاكرة. معرفات النماذج هي عقد التكامل: معرف خاطئ يمكن أن يبدو كمشكلة شبكة، أو مشكلة صلاحيات، أو كتالوج فارغ.
ثم قم بتشغيل مهمة صغيرة قبل استخدام قاعدة كود مهمة:
قم بإدراج الملفات في مساحة العمل هذه، وحدد نقطة الدخول الرئيسية، واقترح تحسينًا واحدًا منخفض المخاطر للتوثيق.
تأكد من أن الوكيل يمكنه قراءة مساحة العمل، واستدعاء النموذج، والتوقف قبل إجراء لم توافق عليه. بمجرد أن تعمل هذه الحلقة، انتقل إلى مهمة حقيقية.
إذا لم يقم اكتشاف النموذج بتعبئة القائمة، أضف معرف النموذج يدويًا. يوثق DeepSeek Harness الاكتشاف كوسيلة راحة لأنه ليس كل بوابة تعيد نفس تنسيق القائمة.
ما يمكنك تشغيله بعد الإعداد
يمنحك DeepSeek Harness مكانًا لتحديد وتشغيل جلسات الوكيل، وليس فقط طرح أسئلة متابعة. بعض نقاط البداية العملية:
شرح وإعادة هيكلة مسار كود موجود
وجّه مساحة العمل نحو خدمة أو حزمة واطلب من الوكيل تتبع ميزة واحدة من البداية إلى النهاية. المخرجات المفيدة ليست فقط نثرًا؛ يمكن أن تتضمن خطة تغيير، والملفات التي سيتعامل معها، والاختبارات التي سيضيفها، والإشارات التي ستثبت نجاح إعادة الهيكلة.
تتبع كيف يصل طلب وارد إلى طبقة قاعدة البيانات. أنتج تدفقًا مرقّمًا، واذكر نقاط الفشل المحتملة، واقترح اختبارات للمسارين الأعلى خطرًا.
راجع الخطة قبل السماح بالتعديلات. يمكن للنموذج اختيار مسار متماسك ظاهريًا عبر قاعدة كود يعتمد على مُهيئ ضمني، أو مسار تكوين قديم، أو API قديم لا يزال لديه مستخدمون في الإنتاج.
التحضير للترحيل أو التنظيف
Harness مفيد لمهام “تحضير العمل”. اطلب جردًا للتبعيات، أو قائمة استخدام API، أو قائمة تحقق التوافق، أو خطة ترحيل مرحلية. هذه القطع الأثرية أسهل في المراجعة من تصحيح كبير لمرة واحدة، وهي تحافظ على الحكم الذي تحتاجه إذا كان الترحيل يؤثر على فرق أخرى.
تشغيل سير عمل من البحث إلى الملف
للمسوحات السوقية أو المقارنات التقنية، اطلب من الوكيل جمع المصادر، والتوفيق بين التواريخ، وملاحظة الخلافات، وكتابة مسودة تقرير إلى ملف محلي. حافظ على ضيق نطاق التسليم: “أنتج جدولاً للمرشحين مع عناوين URL وتواريخ” أسهل في التحقق من “أخبرني ما يحدث في هذا السوق”.
بناء سير عمل محلي قابل للتكرار
بمجرد أن تنجح المطالبة، احفظها كمطالبة مشروع أو إضافة إذا كان إصدار Harness يدعم ذلك. يجب أن تذكر المطالبة القابلة لإعادة الاستخدام مساحة العمل، والمدخلات المطلوبة، وتنسيق الإخراج، وحدود الأمان. هذا الجزء الأخير مهم عندما يقوم سير العمل بتشغيل أوامر أو تحرير ملفات.
كيفية اختيار نموذج للمهمة
تدعم Novita AI DeepSeek وعائلات نماذج أخرى، لذا فإن السؤال ليس “أي مزود لديه نموذج واحد؟” بل “أي نموذج يجب أن تستخدمه هذه المرحلة من سير العمل؟” ابدأ بالقوائم الحالية في مكتبة نماذج Novita AI وتأكد من معرف النموذج الدقيق على صفحة النموذج قبل حفظه في Harness. تتغير معرفات النماذج والحدود مع تحديث الكتالوجات.
استخدم أنماط التوجيه هذه كنقطة بداية:
- DeepSeek V4.1 Flash مفيد عندما تريد استدلالًا عامًا قويًا لتحليل الكود، أو المهام الرياضية الثقيلة، أو التفسيرات متعددة الخطوات دون ملف تكلفة النموذج الرائد.
- GLM 5.3 هو النموذج الرائد GLM في القائمة وقت الكتابة، بينما GLM 5.3 Flash هو الخيار متعدد الوسائط الأصلي الموجه للكفاءة. تحقق من حدود نافذة السياق والإخراج قبل حشو مستودع كامل في طلب واحد.
- Qwen3.8 Flash و Qwen3.8 Max يغطيان طرفي الكفاءة والريادة في تشكيلة Qwen3.8 الحالية. قم بتشغيل نفس مهمة التصحيح مقابل النموذج الافتراضي لترى ما إذا كان الإخراج أسهل في المراجعة.
- Kimi K3 هو النموذج الرائد لـ Moonshot في كتالوج Novita ويمكنه استيعاب سير العمل الطويلة السياق والبحث والثقيلة بالأدوات. تأكد من سلوك API الدقيق لاستدعاءات الأدوات قبل الاعتماد عليه في الإنتاج.
- MiniMax M3 هو أحدث إصدار من MiniMax وهو مرشح للعمل التفاعلي الفعال ومتعدد الوسائط. قم بقياس زمن الاستجابة وجودة المراجعة على المطالبات الخاصة بك بدلاً من افتراض أن نتيجة معيارية واحدة ستنتقل.
بالنسبة لعمل الوكيل الإنتاجي، ثلاثة قياسات تهم أكثر من لوحة الصدارة:
- نجاح المهمة. هل يجتاز التصحيح الاختبارات؟ هل يحتوي التقرير على الأقسام المطلوبة؟ هل يقوم استدعاء الأداة بالإجراء المقصود؟
- التكلفة لكل نتيجة مقبولة. احسب إعادة المحاولات، والمخرجات المهدرة، والوقت البشري المستغرق في مراجعة الخطط السيئة.
- نمط الفشل. هل يرفض النموذج بأدب، أم يهلوس استدعاء أداة، أم يتخذ إجراءً خاطئًا بثقة؟ الأخير يحتاج إلى إعدادات موافقة أكثر صرامة.
إذا كنت تريد مقارنة نموذجين دون تحرير المزود في كل مرة، أضف كلاهما إلى نفس مزود Novita AI، واحفظ معرفات النماذج الدقيقة الخاصة بهما، وقم بتشغيل نفس مجموعة المطالبات التمثيلية. ثم افحص القطع الأثرية النهائية، وليس فقط مخرجات الدردشة.
استكشاف مشكلات الإعداد الشائعة وإصلاحها
قائمة النماذج فارغة
تحقق من أن عنوان URL الأساسي هو بالضبط https://api.novita.ai/openai، وأن مفتاح API حالي، وأن حسابك لديه حق الوصول إلى النموذج. إذا كانت واجهة المستخدم تحتوي على إجراء تحديث، فقم بتحديث الكتالوج بعد حفظ المزود. ثم اختبر المفتاح خارج Harness باستدعاء API مباشر.
إذا أعاد جلب النماذج خطأ في المصادقة، تحقق من المفتاح أولاً. يستدعي اكتشاف Harness نقطة نهاية قائمة النماذج المتوافقة مع OpenAI ويمكن أن يفشل هناك بينما تفشل استدعاءات الإكمال العادية لسبب مختلف.
يتم حفظ المزود، لكن الطلبات تفشل
تأكد من أن معرف النموذج يطابق صفحة نموذج Novita AI. تحقق أيضًا مما إذا كان النموذج المحدد يدعم نوع الطلب الذي يقوم به الإطار؛ فقد لا يدعم النموذج النصي فقط طلب صورة، وقد يفشل النموذج بدون دعم الأدوات في خطوة وكيل تتوقع استدعاءات أدوات.
npx يتعطل أو يفشل في التشغيل الأول
التشغيل الأول يقوم بتنزيل التبعيات وقد يستغرق بعض الوقت. إذا فشل، تحقق من شبكتك، وذاكرة التخزين المؤقت npm، وإصدار Node.js. إعادة المحاولة النظيفة معقولة؛ إذا ذكر الخطأ الصلاحيات، ففضل تثبيت Node.js على مستوى المستخدم أو ذاكرة التخزين المؤقت لمدير الحزم على تشغيل الأمر بصلاحيات مرتفعة.
المتصفح لا يفتح
قد يكون الخادم لا يزال قيد التشغيل. افتح http://127.0.0.1:3080 يدويًا، أو أعد التشغيل باستخدام npx @deepseek-ai/dsh web --no-open وقم بزيارة عنوان URL من متصفح على نفس الجهاز. عبر SSH، قد لا يكون المضيف المعاد توجيهه 127.0.0.1، لذا استخدم العنوان الذي يطبعه الأمر.
قام الوكيل بتغيير غير متوقع
أوقف التشغيل، وافحص فرق التحكم بالمصادر الخاص بك، وتراجع عما لا تريده. ثم قلل نطاق الأداة أو قم بتشغيل المهمة في مساحة عمل يمكن التخلص منها. إذا كان فريقك يستخدم فروعًا محمية وبيانات اعتماد نشر، فاحتفظ بها بعيدًا عن متناول الوكيل حتى تثق في سير العمل.
الأسئلة الشائعة
هل يدعم DeepSeek Harness نماذج Novita AI؟
يدعم DeepSeek Harness المزودين المخصصين المتوافقين مع OpenAI، وتوفر Novita AI واجهة برمجة تطبيقات متوافقة مع OpenAI. يستخدم هذا الدليل مسار المزود المخصص: https://api.novita.ai/openai كعنوان URL الأساسي، ومفتاح API من Novita AI، ومعرف النموذج الدقيق من صفحة نموذج Novita AI.
هل أحتاج إلى نشر خادم النموذج الخاص بي؟
لا. تستضيف Novita AI واجهة برمجة تطبيقات النموذج؛ يعمل DeepSeek Harness محليًا ويستدعي تلك الواجهة. لا تحتاج إلى إدارة وحدات معالجة رسومية لهذا الإعداد. لا تزال بحاجة إلى موارد محلية كافية لعملية Node.js وأي أدوات يشغلها الوكيل.
هل DeepSeek Harness جاهز للإنتاج؟
يصف المستودع الرسمي DeepSeek Harness بأنه معاينة مطور ويحذر من التغييرات التي تكسر التوافق. يمكن أن يكون مفيدًا اليوم، ولكن قم بتثبيت الإصدارات، وراجع ملاحظات الإصدار، واحتفظ بالعمل المهم تحت التحكم بالمصادر، واختبر الترقيات في مساحة عمل غير حرجة قبل تغيير سير عمل إنتاجي.
هل يمكنني استخدام أكثر من نموذج في نفس المشروع؟
نعم، إذا كانت واجهة المستخدم تدعم تبديل النماذج في جلستك. النمط المفيد هو نموذج واحد للصياغة أو الكود الأولي، وآخر للمراجعة أو التحليل الأعمق، ونموذج أقل تكلفة للتلخيص أو التصنيف أو الاستخراج المتكرر.
أين يجب أن أخزن مفتاح API الخاص بي من Novita AI؟
ضعه في تكوين المزود فقط عند الحاجة، وبخلاف ذلك احتفظ به في مدير أسرار محلي أو مخزن بيئة مشفر. لا تقم أبدًا بإيداعه، أو مشاركته في لقطات شاشة، أو منحه صلاحيات أوسع مما تحتاجه المهمة.
ما الذي يجب أن أفعله قبل توصيل قاعدة كود حقيقية؟
ضع مساحة العمل تحت التحكم بالمصادر، وأكد إعدادات الموافقة للوكيل، وأزل بيانات الاعتماد غير المطلوبة. ابدأ بمهمة للقراءة فقط أو منخفضة المخاطر، ثم وسّع مجموعة الأدوات بعد أن تفهم كيف يتصرف الوكيل مع مشروعك.
مقالات موصى بها
- ما هي وكلاء البرمجة؟ كيف يعملون وكيف تبني واحدًا
- GLM 5.2 على Novita AI: إطلاق السياق الطويل، التسعير، وملاءمة المطور
- DeepSeek V4 Pro مقابل Flash على Novita AI: التسعير، معرف النموذج، واختيار API
المصادر
- المستودع الرسمي لـ DeepSeek Harness، تم التحقق منه في 10 سبتمبر 2026: حالة المعاينة للمطورين، أمر تشغيل npm، منفذ واجهة الويب، العلم
--no-open، ومسار التشغيل من المصدر. - دليل تكوين نموذج DeepSeek Harness، تم التحقق منه في 10 سبتمبر 2026: حقول المزود المخصص، بروتوكول
openai-completions، معرفات المزود الدائمة، اكتشاف النموذج، واستكشاف الأخطاء وإصلاحها. - ملف
package.jsonلـ DeepSeek Harness، تم التحقق منه في 10 سبتمبر 2026: نطاق محرك Node.js. - مكتبة نماذج Novita AI، تم التحقق منه في 10 سبتمبر 2026: كتالوج النماذج المستضافة وصفحات النماذج.
- إدارة مفاتيح Novita AI، تم التحقق منه في 10 سبتمبر 2026: مسار إنشاء مفتاح API وإدارته.
- واجهة برمجة تطبيقات LLM من Novita AI، تم التحقق منه في 10 سبتمبر 2026: عنوان URL الأساسي المتوافق مع OpenAI وتحديد موقع API.
