الصفحاتمقدمة · 1 / 29
مقدمة
QuantCraft منصة تداول يمكن استخدامها أيضًا لإنشاء استراتيجيات التداول الخوارزمي واختبارها وتحسينها باستخدام Python.
وهي توفّر سير عمل واحدًا لكتابة الشيفرة وإعداد الاختبارات وتشغيل الاختبارات الرجعية ومراجعة النتائج دون مغادرة التطبيق.
إذا كنت جديدًا على QuantCraft، فابدأ بـ البدء وركّز على هذه الحلقة الأساسية:
- إنشاء ملف استراتيجية أو فتحه
- كتابة منطق الاستراتيجية ومعاملاتها
- التشغيل أو الاختبار الرجعي بالرموز والنطاق الزمني المحددين
- مراجعة السجلات والرسوم البيانية ومقاييس الصفقات والأداء
- التعديل وإعادة التشغيل
ما يتضمنه QuantCraft (الأساسيات)
مساحة الشيفرة
- تخطيط مساحة العمل: شريط جانبي للملفات والمجلدات لمشاريع الاستراتيجيات
- محرر Python متعدد علامات التبويب
- سير عمل Save وSave As والاستيراد والتصدير لملفات
.py
محرر Python
- كتابة الاستراتيجيات بلغة Python
- أدوات تحرير مثل التراجع/الإعادة والبحث/الاستبدال والتنسيق وخيارات السمة والخط
- التبعيات (واجهة Packages) للمكتبات التي يستخدمها نصّك البرمجي
التشغيل والاختبار الرجعي
- تشغيل الشيفرة: Run سريع للحصول على ملاحظات فورية حول النص البرمجي
- الاختبارات الرجعية: مسار منظّم للتقييم على البيانات التاريخية
- معاملات الإدخال للاستراتيجيات القابلة للضبط
واجهات برمجة التشغيل المدمجة للاستراتيجيات
- دوال استدعاء دورة حياة الاستراتيجية (
on_initوon_barوon_tickوon_timerوon_finish) - نموذج الحساب لسلوك المراكز والأرصدة والربح والخسارة
- بيانات OHLCV والأعمدة لأعمدة السوق والأطر الزمنية الثانوية (
get_barوTimeframe) - البيانات الأساسية (عند توفرها) لبيانات القوائم المالية
- عوامل فاما-فرينش (Premium) لسلاسل عوائد العوامل الشهرية العالمية في الاختبارات الرجعية وعمليات التشغيل الأمامي
- سلاسل المؤشرات لطبقات الرسوم البيانية في النتائج
النتائج والتشخيص
- لوحة المخرجات للسجلات والأخطاء والتقدّم
- نتائج الاختبار للأداء ومنحنى حقوق الملكية/المخططات وسجل الصفقات
- تصدير نتائج الاختبار الرجعي حيثما كان ذلك مدعومًا
QuantCraft AI (اختياري لكنه مفيد)
- مساعد داخل بيئة التطوير لشرح شيفرة الاستراتيجية وتوليدها وتحريرها
- جلسات دردشة مع اختيار النموذج وتفاعلات تراعي الملفات
ما تحتاج إلى معرفته قبل أول استخدام
- استراتيجيات QuantCraft هي نصوص Python تُنفَّذ في سياق التشغيل الخاص بـ QuantCraft.
- تستخدم الاختبارات الرجعية نموذج حساب محاكى (سلوك حساب تجريبي، وليس تنفيذًا فعليًا لدى وسيط).
- دورة حياة الاستراتيجية ووحدات البيانات (OHLCV والبيانات الأساسية وعوامل فاما-فرينش) هي عقد واجهة البرمجة الخاص بك.
- معاملات الإدخال هي الطريقة الموصى بها لضبط القيم دون تعديل الشيفرة في كل تشغيل.
- تحقّق دائمًا بعدة عمليات تشغيل (رموز ونوافذ زمنية مختلفة) قبل الوثوق بالأداء.
الحد الأدنى من سير عمل «النجاح الأول»
1. إنشاء ملف استراتيجية
- افتح QuantCraft (تخطيط مساحة العمل)
- أنشئ ملف استراتيجية
.pyجديدًا (أو استورد ملفًا)
2. إضافة هيكل أساسي للاستراتيجية
- عرّف دوال استدعاء دورة الحياة
- ابدأ بـ
on_init، ثم نفّذ منطق الأعمدة/التيكات، ثم ملخصاتon_finish
3. تعريف معاملات الإدخال
- أضف
paramsحتى يمكن تغيير العتبات والفترات من واجهة الاختبار الرجعي
4. إعداد اختبار رجعي وتشغيله
- اختر الرمز أو الرموز والإطار الزمني والنافذة الزمنية (الاختبارات الرجعية)
- شغّل Test (تشغيل الشيفرة) وراقب لوحة المخرجات والتقدّم
5. فحص النتائج
- تحقق من السجلات بحثًا عن الأخطاء والتحذيرات
- راجع نتائج الاختبار: إحصاءات الأداء والصفقات
- تحقق من طبقات المؤشرات واتساق السلوك
6. التكرار
- حسّن منطق الدخول والخروج والمخاطر
- أعد التشغيل بمدخلات مختلفة ونوافذ اختبار أوسع
المفاهيم الأساسية التي يجب أن تفهمها
دورة حياة الاستراتيجية
راجع دورة حياة الاستراتيجية: on_init وon_bar/on_tick وon_timer الاختياري وon_finish.
حالة الحساب
تستخدم استراتيجيتك نموذج الحساب (محفظة محاكاة). افهم كيف تحدّث الأوامر والمراكز الربح والخسارة أثناء التشغيل.
نطاق البيانات
تقود بيانات OHLCV معظم المنطق الفني. أما البيانات الأساسية فهي اختيارية وقد تختلف حسب الرمز. كن صريحًا بشأن افتراضات البيانات وفترة التهيئة.
المدخلات وقابلية إعادة الإنتاج
استخدم معاملات الإدخال للحصول على تجارب متسقة.
- أبقِ شروط التشغيل ثابتة عند مقارنة إصدارات الاستراتيجية.
قواعد عملية للاستخدام الموثوق
- ابدأ ببساطة؛ ولا تضف التعقيد إلا بعد استقرار المنطق الأساسي.
- سجّل القرارات الرئيسية (أسباب الدخول والخروج) لتسهيل تصحيح الأخطاء.
- لا تقيّم بالاعتماد على رمز واحد أو نطاق زمني قصير.
- تأكد من أن طبقات الرسم البياني تتوافق مع سلوك الصفقات الفعلي.
- تعامل مع نتائج الاختبار الرجعي القوية على نحو غير معتاد بوصفها مشبوهة حتى تخضع لاختبارات الإجهاد.
أخطاء شائعة يجب تجنبها
- كتابة كل المنطق في دالة استدعاء واحدة دون إدارة واضحة للحالة
- تثبيت ثوابت قابلة للضبط داخل الشيفرة بدلًا من استخدام المدخلات
- تجاهل التهيئة وجاهزية البيانات قبل حساب الإشارات
- الإفراط في الملاءمة لنظام سوقي واحد أو نطاق زمني ضيق
- الوثوق بالعائد المعلن دون فحص التراجع (drawdown) وتوزيع الصفقات
متى تستخدم QuantCraft AI
استخدم الذكاء الاصطناعي عندما تحتاج إلى مساعدة في:
- إعادة هيكلة شيفرة استراتيجية غير مرتبة
- إضافة المعاملات وبنية أنظف
- شرح أخطاء تدفق دوال الاستدعاء
- توليد هياكل المؤشرات والدخول والخروج
لا تعتمد على مخرجات الذكاء الاصطناعي دون تدقيق — شغّلها وتحقق منها دائمًا في الاختبارات الرجعية.
النتيجة التي ينبغي أن تتوقعها من هذه الوثائق
بعد قراءة الوثائق بالترتيب (راجع أيضًا المرجع)، ينبغي أن تكون قادرًا على:
- التنقل في مساحة العمل بسرعة
- بناء استراتيجية قابلة للتشغيل من الصفر
- استخدام دوال استدعاء دورة الحياة بشكل صحيح
- إعداد اختبارات رجعية بـمدخلات ذات معنى
- تفسير النتائج والتكرار نحو منطق متين