كيفية تثبيت مؤشرات مخصصة في NinjaTrader 8 (استيراد ملف ZIP)

أهم النقاط

• يُستورد أرشيف NinjaScript بصيغة ZIP من Control Center عبر Tools › Import › NinjaScript Add-On، دون فك ضغطه مسبقًا.
• يُنسخ الملف المصدري المنفرد ‎.cs إلى Documents\NinjaTrader 8\bin\Custom\Indicators ثم يُترجَم (compile) بمفتاح F5 في NinjaScript Editor.
• بعد استيراد حزم Trading Evolution، أعد تشغيل NinjaTrader وفعّل المفتاح المجاني في Control Center › New › Trading Evolution License.
• يترجم NinjaTrader كل السكربتات المخصصة معًا، لذا قد يكفي ملف واحد معطوب لتعطيل كل المؤشرات الأخرى.
• لا تستورد إلا من مصادر تثق بها: NinjaScript شيفرة مُترجَمة تعمل داخل المنصة.

كيفية تثبيت مؤشرات NinjaTrader 8: الجواب المختصر

لتثبيت مؤشرات في NinjaTrader 8، انظر أولًا إلى الملف الذي نزّلته. إذا كان أرشيف ZIP، فافتح Control Center واختر Tools › Import › NinjaScript Add-On، وحدد الملف وأكّد، ثم أعد تشغيل NinjaTrader إذا طلب المطوّر ذلك. وإذا كان ملفًا منفردًا بامتداد ‎.cs، فانسخه إلى المجلد Documents\NinjaTrader 8\bin\Custom\Indicators وترجمه بمفتاح F5 في NinjaScript Editor. في الحالتين يظهر المؤشر بعد ذلك في نافذة Indicators لكل رسم بياني.

الصيغتان غير قابلتين للتبادل: قائمة الاستيراد تنتظر أرشيف NinjaScript، والمجلد Custom ينتظر ملفات مصدرية. ومعظم حالات التثبيت الفاشلة سببها استخدام الملف الصحيح بالطريقة الخاطئة، أو مشكلة في سكربت آخر توقف الترجمة كلها. وإذا لم يكن NinjaTrader نفسه مثبتًا ومتصلًا بعد، فابدأ بقراءة دليل إعداد NinjaTrader 8.

أرشيف ZIP أم ملف ‎.cs: تعرّف على ما نزّلته

يستطيع NinjaTrader تصدير المؤشرات والاستراتيجيات وغيرها من السكربتات في صورة أرشيف NinjaScript، وهو ملف ZIP مصمم لوظيفة الاستيراد الخاصة به. وعادة ما يوزّع المطوّرون أدواتهم بهذه الطريقة، وأحيانًا مع عدة مؤشرات وملفات مساعدة في أرشيف واحد. أما ملف ‎.cs فهو شيفرة مصدرية بلغة C# مكتوبة كنص عادي: سكربت واحد يمكنك فتحه في محرر نصوص وقراءته قبل تثبيته.

• أبقِ الأرشيف مضغوطًا. نافذة الاستيراد تقرأ ملف ZIP نفسه، وفك ضغطه يترك لك ملفات متفرقة لا تستطيع وظيفة الاستيراد استخدامها.
• السكربتات والأرشيفات المكتوبة لـ NinjaTrader 7 غير متوافقة مع NinjaTrader 8. تحقق من الإصدار الذي يستهدفه الملف قبل تثبيته.
• بعض التنزيلات تضع أرشيف NinjaScript داخل ملف ZIP ثانٍ مع ملف readme. إذا رُفض الاستيراد، فافتح الملف الخارجي وابحث عن الأرشيف بداخله.

استيراد أرشيف ZIP عبر Tools › Import

هذه هي طريقة تثبيت حزمتي Trading Evolution، حزمة Order Flow وحزمة ICT، وكل منهما تجمع عدة مؤشرات في ملف ZIP واحد. وهي الطريقة نفسها لأي أرشيف NinjaScript.

• نزّل الأرشيف واتركه بصيغة ZIP، في مجلد التنزيلات مثلًا.
• افتح NinjaTrader 8 وسجّل الدخول: الاستيراد يتم من Control Center.
• افتح Tools › Import › NinjaScript Add-On. ويصف Help Guide البند نفسه باسم Tools › Import › NinjaScript.
• اختر ملف ZIP وأكّد الاستيراد. يخبرك NinjaTrader بعدها هل نجحت العملية أم ما الذي تعطّل.
• أعد تشغيل NinjaTrader، كما تطلب ملاحظة التثبيت من Trading Evolution، حتى يُحمَّل كل ما في الحزمة.

تثبيت ملف مصدري ‎.cs عبر NinjaScript Editor

يوضع الملف المصدري في المجلد الذي يحفظ فيه NinjaTrader المؤشرات المخصصة: Documents\NinjaTrader 8\bin\Custom\Indicators. انسخه إليه، ثم افتح New › NinjaScript Editor من Control Center واضغط F5 للترجمة. إذا نجحت الترجمة، يصبح المؤشر متاحًا على كل الرسوم البيانية.

يترجم NinjaTrader كل السكربتات المخصصة معًا. فإذا احتوى أي ملف في المجلد Custom على خطأ، تفشل الترجمة ولا يظهر المؤشر الجديد، حتى لو كانت شيفرته هو سليمة. يعرض المحرر كل خطأ مع الملف الذي جاء منه: أصلح ذلك الملف أو احذفه، ثم أعد الترجمة.

من الرسائل المتكررة رسالة تقول إن مساحة أسماء (namespace) تحتوي بالفعل على تعريف لاسم ما. معناها أن هناك نسختين من المؤشر نفسه، غالبًا نسخة قديمة محفوظة باسم ملف آخر. احذف النسخة الأقدم ثم أعد الترجمة.

تفعيل ترخيص Trading Evolution

تحتاج حزم Trading Evolution إلى مفتاح ترخيص مجاني قبل أن تعمل المؤشرات. بعد الاستيراد وإعادة التشغيل، افتح Control Center › New › Trading Evolution License، والصق مفتاحك وانقر Save and verify. ستجد المفتاح في قسم الترخيص بمساحة الأعضاء في Trading Evolution، ومفتاح واحد يفعّل الحزمتين.

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

إضافة المؤشر إلى الرسم البياني

افتح رسمًا بيانيًا ثم نافذة Indicators: انقر بزر الفأرة الأيمن على خلفية الرسم واختر Indicators، أو انقر أيقونة Indicators في شريط أدوات الرسم، أو اضغط Ctrl + I. ابحث عن المؤشر في قائمة Available، حيث يصفّي مربع البحث حسب الاسم والوصف، ثم انقر عليه نقرًا مزدوجًا أو اضغط add، واضبط خصائصه، ثم انقر OK.

لكل مؤشر على الرسم خاصية Calculate. الخيار On Bar Close يحسب مرة واحدة لكل شمعة مكتملة، وOn Each Tick يحسب مع كل تيك يصل ويستهلك أكبر قدر من المعالجة، وOn Price Change يحسب كلما تغيّر السعر. احتفظ بالقيمة الافتراضية التي اختارها المطوّر ما لم يذكر التوثيق خلاف ذلك.

مؤشرات تدفق الأوامر مثل TEVO Footprint تقرأ كل صفقة مع سعر الطلب (Bid) وسعر العرض (Ask) الخاصين بها. في الوقت الحقيقي يعمل ذلك دون أي إعداد خاص، لكن التاريخ الدقيق يحتاج إلى Tick Replay: تحديد Show Tick Replay في إعدادات Market data، ثم تحديد Tick Replay في نافذة Data Series للرسم. ويشرح دليل Tick Replay متى يستحق وقت التحميل الإضافي.

معالجة فشل التثبيت

حين لا يظهر مؤشر أو لا يرسم شيئًا، يكون السبب عادة واحدًا مما يلي.

• المؤشر غير موجود في القائمة: لملف ‎.cs، تحقق من المجلد وأعد الترجمة بمفتاح F5؛ ولملف ZIP، تحقق من أن الاستيراد أعلن نجاحه، ثم أعد تشغيل NinjaTrader.
• الاستيراد مرفوض: ربما لا يكون الملف أرشيفًا لـ NinjaTrader 8، كأن يكون ملفًا مصدَّرًا من NinjaTrader 7، أو مجلدًا مفكوك الضغط، أو ملف ZIP داخل ملف ZIP آخر.
• أخطاء الترجمة تشير إلى ملف آخر: أصلح ذلك السكربت أو احذفه، لأن خطأً واحدًا يعطّل كل السكربتات المخصصة.
• المؤشر يُحمَّل لكنه لا يرسم شيئًا: تحقق من اتصال البيانات ومن شهر الاستحقاق، ثم مما إذا كانت الأداة تحتاج إلى عمق السوق أو إلى Tick Replay.
• البند Trading Evolution License غير موجود في قائمة New: لم يكتمل الاستيراد، أو لم يُعَد تشغيل NinjaTrader منذ ذلك الحين.

لا تستورد إلا ما تثق به

دليل المساعدة NinjaTrader Help Guide واضح في هذا: استورد أرشيفات NinjaScript من مصادر موثوقة فقط. المؤشرات شيفرة C# مُترجَمة تعمل داخل المنصة، ولها صلاحيات الوصول نفسها إلى حاسوبك التي يملكها NinjaTrader ذاته. نزّل من موقع المطوّر نفسه، واحتفظ بنسخة من الأرشيف الذي ثبّته، وتجنب النسخ المعاد تغليفها المتداولة في المنتديات.

قبل الاعتماد على ما يرسمه مؤشر، اقرأ توثيقه: ما الذي يحسبه، وما البيانات التي يحتاج إليها، وما الذي لا يستطيع رؤيته. لكل مؤشر من مؤشرات NinjaTrader 8 المجانية من Trading Evolution صفحة تسرد إعداداته ومتطلباته وحدوده. لا يوجد مؤشر يزيل مخاطر تداول العقود الآجلة، فاختبر أي أداة جديدة على حساب محاكاة أولًا.

طبّق ما تعلمته

• مؤشرات NinjaTrader 8 مجانية15 مؤشرًا: 5 أدوات لتدفق الأوامر و10 نماذج ICT، لكل منها توثيقه.
• فيديو شرح التثبيتالخطوات الاثنتا عشرة، من تنزيل الحزم إلى إضافة مؤشر على رسم NinjaTrader 8.

الأسئلة الشائعة

المصادر

1. NinjaScript Distribution: Import — NinjaTrader 8 Help Guide
2. Working with Indicators — NinjaTrader 8 Help Guide
3. Tick Replay — NinjaTrader 8 Help Guide

اقرأ أيضًا

كل مقالات هذا القسم : NinjaTrader 8 →