QuantCloud

يشغّل QuantCloud مهام bulk forward على مشغّلات سحابية (runners) مخصّصة تواصل العمل بينما تكون محطة عملك مطفأة أو QuantCraft مغلقًا. يشغّل كل مشغّل مهمة bulk forward واحدة في كل مرة، لذا تضبط وتراقب دفعة واحدة لكل مشغّل. ولا تشغّل المشغّلات إلا خوارزميات بيئة التطوير — أما الوكلاء (بما فيها عمليات bulk الخاصة بالوكلاء) فتعمل محليًا من AutoTrading. يتصل تطبيق سطح المكتب بالمشغّلات المجهّزة لحسابك بعد تسجيل الدخول — ولا يستخدم خدمة Python المحلية لهذه المهام.

وهو النظير السحابي لـAutoTrading الذي يشغّل النوع نفسه من الدفعات على جهازك المحلي. وتغطي هذه الصفحة ما تفعله داخل التطبيق؛ أما إعداد الخوادم وتشغيلها فخارج نطاق هذه الوثائق.

تظهر صفحة QuantCloud وعنصر التنقل الخاص بها عندما تكون ميزة QuantCloud مفعّلة لإصدارك.

---

شراء مشغّل سحابي

انقر Buy Cloud Runner ثم:

1. اختر فئة الجهاز — تعرض كل بطاقة اسم الفئة والسعر ($X/mo) ونوع النسخة ووصفًا قصيرًا.
2. انقر Continue to payment (أو ← Back لتغيير الفئة). تعرض الخطوة التالية ملخص الطلب وأزرار اشتراك PayPal. الدفع اشتراك PayPal؛ ولا يجمع التطبيق بيانات البطاقة مباشرةً.
3. بعد الموافقة يُجهَّز المشغّل ويظهر على الصفحة خلال بضع دقائق — استخدم Refresh runners للتحقق.

تحتاج إلى اشتراك QuantCraft فعّال يتضمن QuantCloud (راجع خطتك).

---

بطاقات المشغّلات

يعرض كل مشغّل حالة — Warmup أو Running أو Loading… أو Unavailable أو Ready — مع تسميته ونقطة اتصاله. وتعرض المشغّلات المجهّزة حديثًا لافتة warmup (مع الوقت المتبقي) تحجب مؤقتًا عمليات bulk وتثبيت التبعيات والتحديث.

الإجراءات على المشغّل: Dependencies وNew bulk run (أو Edit / Stop / Delete / Resume عند وجود مهمة) وRefresh. ويعرض تذييل قابل للطيّ Packages المثبّتة وأحدث سجل تثبيت.

---

تثبيت التبعيات

انقر Dependencies على مشغّل لتثبيت حزم PyPI (يستخدم المشغّل Python نفسه المستخدم في خوارزميات bulk/forward، وليس .venv الخاص ببيئة التطوير المحلية). إذا كانت خوارزميتك تستورد حزمًا تتجاوز الافتراضية (مثل pandas وnumpy)، فأضفها هنا:

• أدخل أسماء الحزم مفصولة بفواصل، مع الإصدارات اختياريًا (مثل pandas==2.1.0, numpy, scipy>=1.10). وإعادة تثبيت حزمة بإصدار جديد تستبدل التثبيت القديم.
• انقر Install لمتابعة سجل التثبيت المباشر؛ ويُعاد تشغيل المشغّل بعد التثبيت الناجح لتُستورد الحزم الجديدة (وقد يستغرق ذلك حتى دقيقة).
• التثبيتات محجوبة أثناء تشغيل مهمة bulk (أوقفها أولًا) وأثناء warmup.
• تظهر الحزم المثبّتة كشارات ملونة (مثل pandas 2.1.0) في لوحة Packages.
• للحزم التي أضفتها زر × لإزالتها (بعد تأكيد Remove package?). ولا تعيد الإزالة تشغيل المشغّل — بل تسري عند التشغيل التالي — وهي محجوبة أثناء تشغيل مهمة bulk أو تثبيت.

ثبّت المكتبات نفسها التي تستخدمها في بيئة التطوير ضمن Packages (التبعيات) عندما تكون تلك الحزم مطلوبة وقت التشغيل.

---

تشغيل دفعة على مشغّل

• على مشغّل خامل، انقر New bulk run. يفتح ذلك نافذة New Run نفسها في AutoTrading — راجع AutoTrading لعلامات التبويب Algorithm / Targets / Schedule & data — مرتبطة بذلك المشغّل. ويتوفر نطاق الهدف Screener، فيمكن لمهمة سحابية أن تتداول ما يطابقه مرشّح محفوظ وأن تعيد الفرز وفق جدولها الخاص (Refresh interval (days) / Refresh time (ET)) دون أن تكون محطة عملك قيد التشغيل. تنزّل أول عملية تشغيل للماسح على مشغّل جديد كامل عالم البيانات الأساسية (بطيئة)؛ وبعد ذلك تتحدّث مرة واحدة في كل يوم UTC. ينزّل المشغّل بتسجيل دخولك إلى QuantCraft ولا يستطيع تجديده، لذا في تشغيل يمتد أيامًا عديدة تستمر عمليات إعادة الفرز في استخدام آخر البيانات بعد انتهاء صلاحية تسجيل الدخول. راجع الماسح (Screener).
• اختر الخوارزمية المترجمة (.qcraft.json) والرموز أو النطاق الهدف والفترة/الإطار الزمني ومعاملات النص اختياريًا. اضبط timerIntervalMs إن كانت استراتيجيتك تعرّف on_timer (دورة حياة الاستراتيجية).
• مهمة واحدة لكل مشغّل: بمجرد وجود مهمة سترى Edit run وStop bulk run وDelete run وResume bulk run بدلًا من New. وResume bulk run للمهام في حالة pending resume ويتطلب حساب تداول نشطًا.
• يعرض قسم bulk في المشغّل Details وLogs (التخطيط نفسه لبطاقة bulk المحلية)، مع Pause / Resume (يوقف مؤقتًا أو يستأنف تتبّع السجل المباشر فقط — ولا يوقف المهمة)، وRefresh وDownload logs (CSV) وClear logs.

يمكنك استخدام Load / Save أعلى النافذة لإعادة استخدام إعداد تشغيل مسبق (.qcs). وعند تحرير تشغيل bulk موجود، تكون الخوارزمية (algoId) ثابتة — إذ يحدّث Load الأهداف والمؤقّت ووضع التيك والمعاملات لكنه لا يبدّل ملف الخوارزمية.

---

السجلات

يبثّ كل تشغيل bulk forward stdout وstderr وأحداث الحالة إلى علامة تبويب Logs الخاصة بالمشغّل في QuantCloud:

قد تُسقَط الأسطر الأقدم عند ارتفاع حجم السجلات. استخدم Refresh إذا ظننت أنك ترى ذيل السجل الكامل فقط. وحذف تشغيل bulk يزيل ملف السجل المخزّن لتلك المهمة على المشغّل، وقد تُحذف سجلات مهمة متروكة بعد نحو 7 أيام.

---

المراقبة والإيقاف

• تُستطلع حالة bulk كل 5 ثوانٍ تقريبًا بينما تكون صفحة QuantCloud نشطة، وكل 30 ثانية تقريبًا في غير ذلك.
• يطلب كل من Stop bulk run وDelete bulk forward run تأكيدًا؛ ويمسح الحذف الحالة المحفوظة على المشغّل ويزيل المهمة من القائمة.

---

نصائح

• طابِق حزم بيئة التطوير والمشغّل — إذا نجح Test محليًا لكن فشل التشغيل السحابي بـ ImportError، فأضف الحزمة الناقصة عبر Dependencies.
• on_timer لعمليات التشغيل الأمامي — لا يضبط مربع حوار الاختبار الرجعي في بيئة التطوير المؤقّتات؛ اضبط timerIntervalMs في نافذة bulk forward بدلًا من ذلك.
• on_tick في التشغيل الأمامي — يُستدعى عند كل تحديث سعر من الوسيط الذي تتصل به أثناء تشغيل الخوارزمية؛ راجع دورة حياة الاستراتيجية.
• بيانات اعتماد الوسيط — قد تتطلب مهام bulk التي تتداول بحساب حقيقي أو تجريبي بيانات اعتماد وسيط تُقدَّم في كل تشغيل؛ اتبع إرشادات النافذة بحسب نوع حسابك.
• مجلد مساحة العمل — يتطلب حفظ إعدادات .qcs المسبقة مجلد مساحة عمل مرتبطًا.

---

انظر أيضًا

• AutoTrading — عمليات التشغيل الأمامي المحلية ونافذة New Run المشتركة
• الماسح (Screener) — أنشئ المرشّحات التي يستخدمها نطاق الهدف Screener
• إعدادات التشغيل المسبقة (.qcs) — احفظ إعدادات التشغيل وحمّلها