لوحة المخرجات

توجد لوحة المخرجات أسفل مساحة عمل QuantCraft، وهي المكان الذي يظهر فيه كل ما تقوله شيفرتك أو ترسمه — عبارات print() ورسائل الأخطاء والمخططات وتقدّم الاختبارات الرجعية الطويلة.

وهي مشتركة بين Run وTest: فكل تشغيل يمسحها ويكتب مخرجات جديدة أثناء تقدّمه. أما المقاييس والمخططات المنظّمة فتظهر في نتائج الاختبار.

---

الفتح والطيّ وتغيير الحجم

• تُفتح اللوحة تلقائيًا بمجرد تسجيل أو رسم أي شيء جديد، حتى لا تفوتك أي مخرجات.
• انقر عنوان Output (أو السهم المجاور له) لطيّ اللوحة أو توسيعها.
• يمكن سحب الفاصل الأفقي فوق اللوحة لأعلى أو لأسفل لمنحها مساحة أكبر أو أقل على الشاشة. ويمكنك أيضًا تركيز الفاصل واستخدام مفتاحي السهم لأعلى / لأسفل لتحريكه.
• يُحفظ ارتفاع لوحة المخرجات (وتقسيم المحرر) بين الجلسات.

---

السجلات (stdout ورسائل التشغيل)

كل ما يكتبه نصّك إلى الخرج القياسي يظهر كسطر سجل بطابع زمني في اللوحة:

أمور مفيدة:

• يحمل كل إدخال طابعًا زمنيًا بحسب ساعتك المحلية.
• يستخدم نص السجل خطًا أحادي المسافة ويلتف بحيث تظل الأسطر الطويلة مقروءة دون تمرير أفقي.
• تتمرّر اللوحة تلقائيًا إلى أحدث رسالة كلما وصلت مخرجات جديدة، أثناء التشغيل وبعد انتهائه مباشرةً.
• يظهر عنصر نائب قصير (no output) إذا انتهى نصّك دون شيء لطباعته.
• عند تفعيل بيانات التقويم، يكتب المحرك سطر [calendar] واحدًا لكل إجراء مؤسسي مطبَّق (تجزئة أو توزيع أرباح)، بالإضافة إلى ملخص في النهاية، مثل:
  [calendar] 2024-01-10 AAPL — SPLIT 4:1 applied to 1 position(s): 100 -> 400 shares (cost basis unchanged; bars stay unadjusted) [calendar] 2024-02-09 AAPL — DIVIDEND $0.2400/share on 400 share(s): +$96.00 cash … [calendar] corporate actions — 1 split(s) applied; 1 dividend(s) applied (0 exact ex-date, 1 estimated +/-7d)
  إذا لم تظهر أي أسطر [calendar] إطلاقًا، فتحقق من أن Include calendar data مفعّل في نافذة التشغيل — راجع بيانات التقويم.
• في اختبار رجعي مع Screener، تظهر علامة تبويب Screener Output بجانب Logs، تسرد كل تاريخ لإعادة التوازن والرموز التي جرى تداولها في تلك النافذة — راجع الماسح (Screener).

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

---

الأخطاء (stderr)

كل ما يُكتب إلى خرج الأخطاء القياسي — تتبّعات الاستثناءات أو التحذيرات التي توجّهها شيفرتك عبر stderr أو رسائل الإطار — يُميَّز بالأحمر ويُحتسب في ترويسة اللوحة:

• تظهر شارة N error / N errors صغيرة بجانب عنوان Output توضح عدد أسطر الأخطاء المسجّلة.
• تحتفظ الأخطاء بطابعها الزمني مثل أسطر السجل العادية، لتتمكن من مطابقتها مع الأحداث المحيطة.
• إذا انتهى تشغيل برمز خروج غير صفري دون أن يكتب إلى stderr بنفسه، فسترى سطر خطأ واحدًا (exit code N) لتعرف أن التشغيل فشل.

عدد الأخطاء عدّاد حي — فمسح المخرجات (الذي يحدث عند بداية كل Run / Test) يعيد ضبطه، وإذا ثبّت التشغيل الجديد حزمة أو تعافى من فشل سابق، فإن العدد يُزال.

---

المخططات

تعرض لوحة المخرجات أشكالًا مضمّنة من شيفرتك فلا تحتاج إلى عارض خارجي.

Matplotlib

أي شكل Matplotlib تعرضه شيفرتك أثناء التشغيل يظهر كـصورة PNG بعرض اللوحة. وهي رائعة للمخططات الاستكشافية السريعة.

Plotly

تُعرض أشكال Plotly كمخططات تفاعلية بالكامل داخل اللوحة:

• مرّر المؤشر فوق سلسلة لرؤية القيم الدقيقة.
• قرّب وحرّك بالفأرة / اللمس.
• استخدم شريط أدوات Plotly للتنزيل والقياس التلقائي وغيرها من الإجراءات.
• يتغيّر حجم المخطط مع اللوحة.

يظهر كل مخطط — Matplotlib أو Plotly — في كتلة مؤطّرة خاصة به ضمن الخط الزمني للوحة بجانب أسطر السجل، فترى بالضبط أين أُنتج بالنسبة إلى مخرجات print() لديك.

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

---

تقدّم عمليات التشغيل الطويلة

عندما يكون اختبار رجعي قيد التشغيل، تحصل ترويسة اللوحة على عنصرين إضافيين لتتابع التقدّم دون التحديق في سجلات متمرّرة:

• شريط تقدّم بتسمية مثل:
  • Bar 1234 / 5000 — عدد الأعمدة المحاكاة التي عُولجت.
  • Run 3 / 10 — في تحسين جارٍ، التشغيل الحالي من الإجمالي.
  • Gen 2/5 · 7/16 — في التحسين الجيني، الجيل/الفرد الحالي.
  • Backtest running ما دام المحرك قد بدأ ولا يتوفر بعد تقدّم دقيق.
• يطول الشريط كلما أبلغ المحرك عن التقدّم ويختفي فور انتهاء التشغيل.

يمكنك طيّ اللوحة ويبقى شريط التقدّم ظاهرًا في الترويسة، فتكون حالة التشغيل دائمًا على بُعد نظرة — حتى لو كنت منشغلًا بالمحرر.

---

زر Disclaimer

تحتوي الترويسة على زر Disclaimer يفتح إشعارًا قصيرًا حول كيفية تنفيذ QuantCraft لـ Python على جهازك. وهو الشرح نفسه الذي تراه قبل أول Run، متاح في أي وقت إذا أردت إعادة قراءته. وإغلاق هذا المربع لا يغيّر إعداداتك.

---

نصائح

• print() صديقك لتصحيح الأخطاء السريع. أبقِ الرسائل قصيرة ووسّمها (f"[ENTRY] {symbol} {qty} @ {price}") ليسهل تصفّحها.
• أرسل التفاصيل الطويلة إلى ملف من شيفرتك بدلًا من طباعة آلاف الأسطر — إذ تبقى آخر ~200 إدخال فقط مرئية.
• الأخطاء حمراء وتُحتسب في الشارة — فإذا رأيت العدد يزداد، فمرّر إلى الأسفل؛ وغالبًا ما يكون آخر خطأ هو ما أوقف التشغيل.
• في Plotly، استخدم فاصل تغيير الحجم في اللوحة لمنح المخطط ارتفاعًا أكبر؛ فهو يتدرّج تلقائيًا.
• اللوحة مشتركة بين الملفات: فإذا بدّلت علامات التبويب في منتصف تشغيل، فالمخرجات التي تراها تخص آخر تنفيذ / التنفيذ النشط.