البدء

QuantCraft تطبيق متكامل لسطح المكتب لتطوير استراتيجيات التداول بلغة Python واختبارها وتحسينها.
يغطي هذا الدليل ما تحتاج إليه فقط لتبدأ بسرعة وبشكل صحيح. وللاطلاع على الصورة الكاملة اقرأ المقدمة؛ ولمعرفة مناطق بيئة التطوير ولوحاتها راجع تخطيط مساحة العمل.

المتطلبات المسبقة

ثبّت ما يلي قبل استخدام ميزات الاستراتيجيات:

• تطبيق QuantCraft لسطح المكتب (أحدث إصدار مستقر)
• Python 3.10+ (يُوصى بالإصدار 3.11)
• pip (مضمّن مع معظم تثبيتات Python)
• الاتصال بالإنترنت (لتثبيت الحزم وللبيانات والخدمات المتصلة)
• مساحة قرص كافية للمشاريع والسجلات ومخرجات الاختبارات الرجعية

---

1. تثبيت Python

نزّل Python وثبّته من python.org.

أثناء التثبيت:

• فعّل Add Python to PATH

تحقق:

إذا لم يُتعرَّف على python في Windows، فجرّب:

---

2. تثبيت QuantCraft وفتحه

نزّل برنامج التثبيت المناسب لمعمارية Windows لديك (الإصدار v1.3.0) وشغّله:

Windows (متجر Microsoft، موصى به)

macOS (Apple Silicon، الإصدار v1.3.0)

• QuantCraft_1.3.0_aarch64.dmg.zip — صورة قرص (مضغوطة)
• QuantCraft.app.tar.gz — حزمة التطبيق (tar.gz)

ثم:

• شغّل QuantCraft
• افتح منطقة بيئة تطوير الاستراتيجيات / مساحة العمل

---

3. إنشاء أول استراتيجية لك

1. أنشئ ملف استراتيجية .py أو استورده
2. أضف دوال استدعاء دورة الحياة الأساسية:
   • on_init
   • on_bar وon_tick
   • on_finish
   • on_timer اختياري (في عمليات التشغيل الأمامي فقط — وليس في الاختبار الرجعي داخل بيئة التطوير)
3. عرّف params قابلة للضبط للقيم التي تريد تعديلها

---

4. تشغيل اختبار رجعي

اضبط الإعدادات في Run backtest (حتى ثلاث علامات تبويب):

• Symbol & data — مصدر الأسعار، الرمز أو الرموز، الإطار الزمني، Additional timeframes اختيارية (لـ rt.get_bar)، بيانات أساسية / عوامل اختيارية
• Simulation — النطاق الزمني، فترة التهيئة، الرصيد الابتدائي، العمولة / الانزلاق السعري
• Script — معاملات الإدخال (params) عندما يعلنها ملفك

استخدم Test (تشغيل الشيفرة)، ثم راجع:

• سجلات وأخطاء لوحة المخرجات
• نتائج الاختبار: المقاييس والصفقات/السجل والمخططات

راجع الاختبارات الرجعية لمعرفة كيف يشغّل المحرك استراتيجيتك.

---

5. التأكد من سلامة الإعداد

يكون إعدادك صحيحًا عندما:

• تُنفَّذ نصوص Python دون أخطاء استيراد أو تشغيل
• تكتمل الاختبارات الرجعية وتُنتج لوحات النتائج
• تتوافق سجلات الاستراتيجية ومخططاتها مع السلوك المتوقع

---

مشكلات الإعداد الشائعة

• عدم العثور على python: أعد تثبيت Python وفعّل PATH
• أخطاء استيراد الوحدات: ثبّت التبعيات في البيئة النشطة
• نتائج غير متسقة: تحقق من الرمز والنطاق الزمني والإطار الزمني والمعاملات
• عدم توليد أي صفقات: افحص شروط الدخول والخروج وفترة التهيئة وتوافر البيانات

---

أفضل الممارسات للمستخدمين الجدد

• ابدأ برمز واحد واستراتيجية بسيطة
• حوّل الثوابت إلى معاملات (لا تثبّت كل شيء داخل الشيفرة)
• سجّل القرارات الرئيسية لتسهيل تصحيح الأخطاء
• تحقق على عدة نطاقات زمنية وأنظمة سوقية قبل الوثوق بالنتائج