دليل وكلاء Flaq AI

دليل عملي لاستخدام DeepSeek Harness مع واجهة Flaq AI API المتوافقة مع OpenAI

شغّل واجهة الويب مفتوحة المصدر لـ DeepSeek Harness باستخدام نقطة نهاية Flaq AI المتوافقة مع OpenAI، ثم صِل نموذج DeepSeek v4 مدعومًا لتحليل المستودعات وسير عمل البرمجة. يتبع DeepSeek Harness بنية «كل شيء مكوّن إضافي»، إذ يمكن تركيب محولات النماذج والأدوات وحلقة الوكيل وتخزين الجلسات والأذونات وبيئات الحماية والقياس عن بُعد وواجهة الويب أو استبدالها من خلال المكونات الإضافية والإعدادات.

أدلة الوكلاء

Claude Code/cc-apiOpenAI Codex/codex-api/v1Hermes Agent/api/v1DeepSeek Harness/api/v1ZCode/api/v1

التثبيت

تشغيل DeepSeek Harness

يتطلب DeepSeek Harness الإصدار Node.js 22.19+ أو إصدارًا من السلسلة 24+. شغّله من دليل المشروع الذي تريد استخدامه موقعًا افتراضيًا لنظام الملفات؛ ويشغّل أمر npm الرسمي واجهة الويب على http://127.0.0.1:3080 افتراضيًا.

1

تشغيل واجهة الويب لـ DeepSeek Harness

استخدم حزمة npm الرسمية لتشغيل واجهة الويب. أبقِ نافذة الطرفية هذه قيد التشغيل أثناء استخدام DeepSeek Harness.

يُنزّل التشغيل الأول حزمة @deepseek-ai/dsh الحالية ويهيّئ ملف تعريف واجهة الويب.

أمر npm الرسمي

npx @deepseek-ai/dsh web

المستودع: راجع أحدث إرشادات التثبيت والإصدارات وملاحظات التوافق والشيفرة المصدرية في مستودع DeepSeek Harness الرسمي على GitHub.

الإعداد

توصيل DeepSeek Harness بـ Flaq AI

افتح Settings → Models في DeepSeek Harness، وأضف Flaq AI بصفته مزودًا مخصصًا، ثم أدخل مفتاح Flaq API الخاص بك. يصبح Provider ID دائمًا بعد الحفظ، لذا استخدم flaq ما لم تكن بحاجة عمدًا إلى اسم مسار مختلف. بعد حفظ المزود، اختر مساحة عمل قبل بدء جلسة.

نموذج DeepSeek v4 Pro الموصى به لتحليل المستودعات ومهام البرمجة ومهام سير العمل التي تستفيد من قدرات استدلال أقوى.

في Settings → Models، اختر Add provider → Add a custom provider. أدخل القيم أدناه وأضف معرّف النموذج المحدد يدويًا بدلًا من استخدام Fetch available models. احفظ المزود، ثم حدد ذلك النموذج لجلسة جديدة. يتعامل DeepSeek Harness مع النماذج المدخلة يدويًا على أنها نصية فقط ما لم تُعرّف أنماط إضافية.

  • استخدم عنوان URL الأساسي لـ Flaq وبروتوكول openai-completions كما هما تمامًا.
  • استبدل النص النائب بمفتاح Flaq API الخاص بك، وأبقِ معرّف النموذج مطابقًا تمامًا لما هو معروض.

مزود Flaq AI المخصص

Provider ID: flaqDisplay name: Flaq AIBase URL: https://api.flaq.ai/api/v1API protocol: openai-completionsCredential / API key: Your_Flaq_Api_KeyModel ID: deepseek-v4-pro-text-to-text

التحقق

التحقق من Flaq في DeepSeek Harness

افتح واجهة الويب، واختر دليل المشروع الذي شغّلت منه DeepSeek Harness، وحدد نموذج Flaq الذي أعددته، ثم أنشئ جلسة جديدة. يظل محرر الرسائل غير متاح إلى أن تُحدد مساحة عمل.

  • يعرض DeepSeek Harness عنوان URL النشط في نافذة الطرفية.
  • ويظهر العنوان المحلي الافتراضي أدناه.

فتح واجهة الويب

http://127.0.0.1:3080
  • أرسل أولًا مهمة للقراءة فقط.
  • تؤكد الإجابة المعتادة التي تعكس مساحة العمل المحددة أن DeepSeek Harness يستطيع الوصول إلى نقطة نهاية Flaq واستخدام النموذج الذي أعددته.

اختبار الوصول إلى المستودع

Summarize this repository and identify its main packages. Do not modify any files.

مثال على إضافة

تثبيت مكوّن إضافي لـ DeepSeek Harness

استخدم DSH OpenPencil مثالًا عمليًا على بنية «كل شيء مكوّن إضافي» في DeepSeek Harness. أكمل إعداد مزود Flaq والتحقق منه كما هو موضح أعلاه، وأوقف واجهة الويب قيد التشغيل، ثم أضف المكوّن الإضافي إلى ملف التعريف web وأعد تشغيل إصدار DeepSeek Harness نفسه. يضيف DSH OpenPencil أدوات لإنشاء مستندات التصميم .op ومعاينتها وفحصها وتحريرها داخل المحادثة.

1

تثبيت DSH OpenPencil

أضف حزمة OpenPencil العامة إلى ملف التعريف web باستخدام إصدار DeepSeek Harness الذي اختُبر معه المكوّن الإضافي حاليًا. شغّل هذا الأمر من دليل المشروع نفسه الذي تستخدمه مع DeepSeek Harness.

تثبيت DSH OpenPencil

npx --yes -p @deepseek-ai/[email protected] dsh plugin --profile web add @zseven-w/dsh-openpencil@latest

المستودع: راجع الشيفرة المصدرية ومتطلبات الإعداد والإصدارات وملاحظات التوافق في مستودع DSH OpenPencil على GitHub.

2

إعادة تشغيل واجهة الويب

شغّل إصدار DeepSeek Harness الذي جرى اختباره مرة أخرى كي يحمّل ملف التعريف web المكوّن DSH OpenPencil. أبقِ نافذة الطرفية هذه قيد التشغيل أثناء إعادة فتح واجهة الويب.

إعادة تشغيل واجهة الويب

npx --yes -p @deepseek-ai/[email protected] dsh web
3

اختبار DSH OpenPencil مع Flaq AI

حدد نموذج Flaq ومساحة العمل اللذين أعددتهما، وابدأ جلسة جديدة، ثم أرسل الطلب أدناه. عندما يكون ملف OpenPencil التنفيذي متاحًا، ينبغي للمكوّن الإضافي إنشاء مستند .op وعرض معاينة قابلة للتحرير داخل المحادثة.

اختبار DSH OpenPencil مع Flaq AI

Create a simple editable OpenPencil document with a title, a subtitle, and two feature cards. Save it as openpencil-demo.op, then render an editable preview.

مفتوح المصدر

استكشاف مستودع DeepSeek Harness الرسمي

DeepSeek Harness هو إطار وكلاء مفتوح المصدر طورته DeepSeek AI. زُر المستودع الرسمي لمراجعة الشيفرة المصدرية ومتابعة الإصدارات وتغييرات التوافق وقراءة أحدث الوثائق والإبلاغ عن المشكلات خلال مرحلة المعاينة للمطورين.

DeepSeek Harness على GitHub

افتح مستودع DeepSeek Harness الرسمي للاطلاع على الشيفرة المصدرية ووثائق الإعداد وملاحظات التطوير والمناقشات وتحديثات المشروع.

دليل مفتوح المصدر

استكشاف دليل Flaq AI مفتوح المصدر لـ DeepSeek Harness

تجاوز الإعداد الأولي من خلال دليل Flaq AI المستقل لـ DeepSeek Harness الذي يديره المجتمع. تعرّف على كيفية دعم شجرة المكونات الإضافية وملفات التعريف والحزم وطبقات التصحيحات وحلقة الوكيل القابلة للاستبدال ومحولات النماذج والأدوات وخدمات الجلسات وسياسات الأذونات وبيئات الحماية وملحقات واجهة الويب لسير عمل الوكلاء المخصص.

دليل DeepSeek Harness على GitHub

استكشف ملاحظات عملية حول البنية ودليل استخدام ووصفات لتطوير المكونات الإضافية ووثائق متعددة اللغات ومهارات وكلاء قابلة لإعادة الاستخدام لفهم DeepSeek Harness وتوسيعه والبناء عليه.

استكشاف الأخطاء وإصلاحها

الأسئلة الشائعة حول DeepSeek Harness

قد يؤدي استخدام هذا الإعداد في هذا الدليل إلى زيادة استخدام الرموز بشكل ملحوظ.

مناقشات DeepSeek Harness على X (Twitter)

استكشف مناقشات المطورين والمشاركين الأوائل حول DeepSeek Harness (DSH)، وهو إطار وكلاء مفتوح المصدر، بما يشمل بنية «كل شيء مكوّن إضافي» وبيئة التشغيل القابلة للتركيب ومنظومة المكونات الإضافية والتجارب العملية.