هذه الوثيقة مناسبة لـdeepseek-harness-sdk==0.1.0rc6وdeepseek-harness-runtime-bin==0.1.0rc6. بعد ترقية العميل، يرجى إعادة إكمال اختبار الملفات للقراءة فقط أدناه.
نطاق الدعم
ستتغير قائمة النماذج. قبل التشغيل، استخدم مفتاح خاص بخطة البرمجة للاستعلام عن القائمة الحية:
deepseek-v4-pro. لا تعتبر deepseek-v4-flash بديلاً مكافئًا لوضع الأدوات في هذه الوثيقة؛ في اختبار الإصدار الثابت هذا، لم تنجح تاريخ الاستدلال المتعدد والدعوة للأدوات.
1. إعداد مفتاح خاص
افتح تطبيق خطة البرمجة، انتقل إلى تطبيق البرمجة الذي تم شراؤه، أنشئ أو انسخ مفتاح API الخاص بهذا التطبيق. لا تستخدم خطة البرمجة رصيدًا عامًا، ولا يمكن لمفاتيح التطبيقات الأخرى تمثيل صلاحيات الحزمة. ضع المفتاح فقط في shell الحالي:2. إنشاء مساحة عمل معزولة
تحتوي حزمة التشغيل المدمجة لـ Harness على أدوات Bash محلية. في أول تحقق، لا توجه إلى مشروع حقيقي أو الدليل الرئيسي؛ أنشئ دليلًا لمرة واحدة بدون أسرار:deepseek-harness-runtime-bin في الصورة. لا تستخدم danger-full-access لتوسيع نطاق الوصول إلى الملفات؛ مثال هذه الوثيقة يمرر فقط الدليل لمرة واحدة إلى cwd.
3. تشغيل SDK Python الرسمي
احفظ المحتوى أدناه كـ/tmp/deepseek-harness-demo/run.py:
/v1/chat/completions، SSE، محتوى الاستدلال، استدعاء الأدوات وإرجاع نتائج الأدوات. بعد الانتهاء، يمكنك حذف /tmp/deepseek-harness-demo؛ إذا كانت مجلدات الجلسة تحتوي على سياق المشروع، يجب أيضًا الاحتفاظ بها بمستوى حساسية مماثل لمستودع الشيفرة.
الأسئلة الشائعة
- 401: تحقق مما إذا كان
ACEDATACLOUD_API_KEYقد تم تصديره إلى نفس shell الذي يتم فيه تشغيل Python. - 403 أو إشعار الحصة: تأكد من أن المفتاح ينتمي إلى تطبيق البرمجة الحالي، وأن الحزمة لا تزال سارية ولديها رصيد متبقي.
- النموذج غير متاح: أعد الاستعلام عن
/v1/models، ولا تخمن اسم النموذج بناءً على لقطات قديمة. - خطأ في
reasoning_content/ استرجاع الأدوات: تأكد من أن SDK / runtime هما الإصدار الثابت في هذه الوثيقة، واستخدمdeepseek-v4-pro. - عدد تنفيذ الأدوات غير طبيعي: أوقف تشغيل المهام التي قد تسبب آثارًا جانبية، واستخدم أولاً fixture للقراءة فقط للتحقق من إصدار الخدمة الحالي.
- فشل التثبيت: تأكد من أن Python 3.10+، وهندسة نظام التشغيل مدعومة من قبل العجلة الحالية، وتحقق من توافق إصدار SDK / runtime.
حدود القدرات
تتحقق هذه الوثيقة فقط من نص SDK Python المحلي إلى Chat Completions ودورة الأدوات. الصور، واجهة API للملفات،/v1/responses، /v1/messages، مساحة العمل البعيدة وsandbox المستضاف ليست ضمن نطاق هذا الدليل؛ صلاحيات مساحة العمل ومخاطر الأوامر المحلية تقع على عاتق الجهاز والتكوين الذي يقوم بتشغيل Harness.

