نتائج الاختبار

بعد كل اختبار رجعي (Test في تشغيل الشيفرة)، تفتح بيئة التطوير Test Results للملف الذي شغّلته. وهي العرض الثاني في مبدّل Code Editor / Test Results بالمحرر (تخطيط مساحة العمل)، وتعرض كل ما أنتجه المحرك في ذلك التشغيل: المخططات وإحصاءات الأداء والصفقات وتصديرًا بصيغة HTML. وتُبَثّ السجلات والمخططات أثناء التشغيل إلى لوحة المخرجات.

لكل ملف مفتوح Test Results خاصة به — وتبديل الملفات يعرض آخر نتيجة لذلك الملف.

---

أين تظهر

• بعد نقر Test في شريط الأدوات، يتحول العرض تلقائيًا إلى Test Results عند جاهزية النتائج.
• يمكنك التبديل بين Code Editor وTest Results في أي وقت بشريط علامات التبويب الصغير فوق منطقة المحرر.
• تخبرك لافتات الحالة أعلى اللوحة بحالة التشغيل:
  • Running backtest — <file> أثناء عمل المحرك.
  • Backtest failed — <file> مع تتبّع الخطأ إذا حدث خلل.
  • Backtest result — <file> عند انتهاء تشغيل منفرد بنجاح.
  • Optimization — <file> مع شريط علامات تبويب عند تشغيل تحسين للمعاملات (راجع عمليات تشغيل التحسين في النهاية).

إذا لم يُختبر ملف قط، فسترى حالة فارغة ودودة تعيدك إلى زر Test.

---

بنية تشغيل ناجح

تنقسم نتيجة الاختبار الرجعي الناجح من الأعلى إلى الأسفل إلى ثلاث مناطق قابلة لتغيير الحجم والطيّ:

1. لوحة المخطط — مخطط الأسعار مع العلامات (وعلامات تبويب لكل رمز في عمليات التشغيل متعددة الرموز).
2. Performance — مخطط حقوق الملكية والرصيد مع شبكة المقاييس.
3. Trades — الصفقات المغلقة و(عند الاقتضاء) المراكز المفتوحة في نهاية التشغيل.

1. لوحة المخطط

تعرض المنطقة العليا أعمدة OHLC المستخدمة في التشغيل مع طبقات استراتيجيتك:

• تُرسم علامات الصفقات عند نقاط الدخول والخروج.
• تظهر طبقات المؤشرات هنا عندما تضيفها شيفرتك عبر chart_indicators (راجع وثائق سلاسل المؤشرات). وتُعرض الخطوط والمدرّجات التكرارية في اللوحة الرئيسية أو في لوحة فرعية منفصلة أسفل الشموع تمامًا كما ضبطتها.
• تحصل عمليات التشغيل متعددة الرموز على شريط علامات تبويب فوق المخطط — علامة لكل رمز. انقر علامة لتبديل مخطط الرمز الذي تشاهده. وتتضمن حمولة النتيجة clock_symbol (الرمز الذي يقود الجدول الزمني) و**ohlcv.bars_by_symbol** (قوائم الأعمدة لكل رمز) وإدخالات chart_indicator_series مصفّاة بحسب symbol لكل علامة تبويب.
• يستضيف شريط أدوات المخطط الصغير فوق المخطط زر Export HTML (انظر أدناه) وفي عروض التحسين تسمية معاملات التشغيل.

إذا لم يكن في النتيجة ohlcv.bars للرسم، يُستبدل منطقة المخطط بملاحظة قصيرة وشريط أدوات التصدير لتتمكن مع ذلك من حفظ تقرير HTML.

2. Performance

انقر Performance لتوسيع اللوحة. وهي تحتوي جزأين:

مخطط حقوق الملكية والرصيد

مخطط خطي لحسابك على امتداد التشغيل:

• Equity — قيمة الحساب بالتقييم السوقي في كل خطوة.
• Balance — رصيد النقد المسوّى على الخط الزمني نفسه.

يُخفَّض أخذ العينات في المخطط تلقائيًا في عمليات التشغيل الطويلة جدًا ويستخدم تسميات محور زمنية لتقرأ الخط الزمني بنظرة سريعة.

شبكة المقاييس

شبكة من الإحصاءات الملخّصة تنتجها account.refresh_metrics(...) في نهاية التشغيل. وتبرز شارات ملونة القيم ذات الإشارة (الأرباح بالأخضر والخسائر بالأحمر).

تعرض الخلايا — عندما لا يتوفر مقياس للتشغيل (مثلًا انعدام الصفقات المغلقة يعني انعدام عامل الربح).

3. Trades

تحتوي المنطقة السفلى على جدولين كحد أقصى:

الصفقات المغلقة

كل ذهاب وإياب نفّذته account.open_trade(...) + account.close_trade(...). وتتضمن الأعمدة side وquantity وentry price وexit price وentry time وexit time وrealized P/L (بترميز لوني).

عند تفعيل بيانات التقويم، تظهر صفوف Split وDividend بين صفوف الصفقات — صف لكل إجراء مؤسسي طُبّق خلال التشغيل — وتحمل البطاقة عنوان Closed trades & events. يعرض صف Split التاريخ والنسبة (مثل 4:1) والتغير في عدد الأسهم؛ ويعرض صف Dividend التاريخ والمبلغ للسهم وإجمالي النقد المُضاف (أو المخصوم للمركز القصير). ويُوسَم تاريخ الاستحقاق التقديري بـ est. ولا تحمل هذه الصفوف علامة # على المخطط وتُستثنى من تصدير CSV الذي يبقى سجلًا نظيفًا للصفقات.

• انقر Closed trades لطيّ الجدول أو توسيعه.
• انقر وقت الدخول/الخروج في أي صف للانتقال إلى ذلك الحدث على المخطط.
• استخدم Export CSV أعلى هذا القسم لحفظ الصفقات المغلقة في ملف .csv (مع مربع حوار Save As من النظام عند الدعم).

المراكز المفتوحة (نهاية التشغيل)

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

نصيحة: تتغير أبعاد لوحة الصفقات تلقائيًا عند طيّها — اطوِها لمنح المخطط وPerformance مساحة رأسية أكبر.

---

تصدير HTML

استخدم Export HTML (في شريط أدوات المخطط) لحفظ ملف .html واحد مستقل يضم كل ما تراه على الشاشة:

• كل لوحة مخطط (صورة لكل رمز في عمليات التشغيل متعددة الرموز).
• مخطط حقوق الملكية والرصيد.
• مقاييس Performance.
• جدول الصفقات المغلقة.
• عنوان التقرير (المأخوذ من اسم الملف) ووقت إنشائه.

كيف يعمل:

1. توسّع بيئة التطوير لوحة Performance لحظيًا ليمكن التقاط مخطط حقوق الملكية.
2. تدور على كل علامة تبويب مخطط وتلتقط المخطط بصيغة PNG.
3. يُجمع الناتج في ملف HTML واحد ويُعرض عبر مربع حوار حفظ (اسم ملف مثل backtest-report-<timestamp>.html).

افتح الملف في أي متصفح لمشاركة التشغيل مع شخص لا يملك بيئة التطوير — دون الحاجة إلى اتصال بالإنترنت.

يعرض الزر Exporting… أثناء العمل. لا تبدّل علامات التبويب ولا تغلق بيئة التطوير أثناء التصدير، وإلا فقد تغيب بعض اللوحات عن الملف المحفوظ.

---

حالات التشغيل (مرجع سريع)

---

عمليات تشغيل التحسين

عندما تختبر مع تفعيل Optimize script parameters، تعرض Test Results شريط علامات تبويب — علامة لكل تركيبة معاملات — وأي معلومات ملخّصة مثل إجمالي عدد عمليات التشغيل ومقياس اللياقة لعمليات التشغيل الجينية والتقدّم بينما ما زالت عمليات التشغيل تنتهي.

• انقر علامة تبويب لتحميل مخطط ذلك التشغيل وPerformance وصفقاته بالطريقة نفسها كما في تشغيل منفرد.
• تُعرض تسمية معاملات التشغيل المحدد بجانب شريط أدوات المخطط لتعرف دائمًا أي تركيبة تشاهد.
• يستخدم Export HTML بيانات التشغيل النشط، مع تسمية التشغيل كعنوان للتقرير.
• إذا أُوقف التحسين مبكرًا، تبرز لافتة ذلك ولا تُعرض إلا عمليات التشغيل المكتملة.

---

نصائح

• اطوِ اللوحات التي لا تحتاج إليها (المخطط أو Performance أو Trades) لتركّز على الباقي.
• تبديل الملفات يعرض آخر نتائج اختبار ذلك الملف — ولا تُفقد علامات التبويب الأخرى.
• في الاختبارات الرجعية الطويلة جدًا، يُخفَّض أخذ العينات في مخطط حقوق الملكية لانسيابية أفضل؛ ولا تتأثر الأرقام الأساسية في شبكة المقاييس.
• CSV للصفقات المغلقة؛ وHTML لكل شيء. استخدم ما يناسب طريقة مشاركتك للتشغيل أو تحليلك له.