PineForge يختبر Pine Script تاريخياً خارج TradingView، دون اتصال وداخل Docker: المدخلات نفسها، الصفقات نفسها.
لماذا بدون اتصال؟
الاختبار التاريخي عبر المتصفّح خيار ممتاز للتجربة والتعديل على الرسم البياني. أمّا الاختبار التاريخي بدون اتصال فهو ما تلجأ إليه حين تكون خطوتك التالية أن تضع أموالك في الاستراتيجية: حين تحتاج إلى مسار تدقيق، وحين يجب أن يجتاز كل إيداع فحوص CI، وحين يلزمك أن تُعيد اليوم إنتاج نتيجةٍ من قبل شهرين، صفقةً بصفقة.
تشغيل الاختبارات التاريخية بدون اتصال يمنحك ما لا تستطيع المختبِرات عبر المتصفّح تقديمه: النتائج حتمية: السكربت نفسه والبيانات نفسها وإصدار الصورة نفسه تعطي الصفقات نفسها. تثبّت إصدار الصورة، وتودع التقارير في مستودع، وتقارن قوائم الصفقات بين الإيداعات، وتُشغّل كل ذلك في CI دون واجهة رسومية. ملف CSV الذي تُدخله ملكك، والمحرّك يعمل محلّياً، والتقرير يسجّل بصمة ما أنتجه.
القائمة العملية: إصدارات صور مثبّتة، فيعطي إيداعٌ من قبل شهرين قائمة الصفقات نفسها اليوم؛ وبياناتك أنت، من شموع منصّات التداول إلى أشرطة تبنيها بنفسك من بيانات التيك، ما دامت بصيغة OHLCV؛ وفحوص CI تُفشل البناء عند أي انتكاس في النتائج؛ واستراتيجية هي ملف، لا ترتبط بمنصّة واحدة.
إن احتجت يوماً إلى مشاركة نتيجة اختبار تاريخي مع زميل، وأدركت أنّ الطريقة الوحيدة «لمشاركتها» هي أخذ لقطة شاشة لرسم بياني، فالتشغيل بدون اتصال هو ما ينقصك.
كيف تختبر Pine Script تاريخياً دون اتصال
يحوّل PineForge شيفرة PineScript v6 إلى C++ أصلية ويُشغّلها على جهازك ضمن صورة Docker واحدة.
ثلاث خطوات. تُسحَب الصورة مرة واحدة، وبعد ذلك يجري كل شيء دون اتصال.
الخطوة 1: اسحب بيئة التشغيل
صورة واحدة: ghcr.io/pineforge-4pass/pineforge-release. بلا pip، وبلا مفتاح، وبلا تسجيل: التحويل والتصريف والاختبار التاريخي كلها تجري داخلها، دون اتصال. المحرّك الذي بداخلها برخصة Apache-2.0؛ والمحوِّل المُضمَّن مجاني للتداول الشخصي.
الخطوة 2: حوّل سكربت Pine الخاص بك إلى C++
شغّل الصورة في وضع التحويل فقط، فتحوّل شيفرة PineScript v6 الخاصة بك إلى ملف مصدري كامل بلغة C++، محلّياً. لا يعمل أي مفسّر Pine وقت الاختبار التاريخي: فالصورة تصرّف شيفرة C++ إلى شيفرة أصلية.
docker run --rm --network=none \
-e PINEFORGE_TRANSPILE_ONLY=1 \
-v "$(pwd)/my_strategy.pine":/in/strategy.pine:ro \
ghcr.io/pineforge-4pass/pineforge-release:1.12.0 > strategy.cppالخطوة 3: أجرِ الاختبار التاريخي
اربط ملف OHLCV بصيغة CSV بجوار شيفرة C++ المُولَّدة وشغّل الصورة. يحتاج ملف CSV إلى سطر الترويسة timestamp,open,high,low,close,volume، مع طوابع زمنية بصيغة UNIX بالملّي ثانية. ينفّذ المحرّك الاستراتيجية شمعةً بشمعة ويكتب تقرير JSON إلى stdout. ويمكنك أيضاً تخطّي الخطوة 2: اربط strategy.pine بدلاً من ذلك، فتحوّلها الصورة أولاً.
docker run --rm --network=none \
-v "$(pwd)/strategy.cpp":/in/strategy.cpp:ro \
-v "$(pwd)/ohlcv.csv":/in/ohlcv.csv:ro \
ghcr.io/pineforge-4pass/pineforge-release:1.12.0 > report.jsonيتضمّن تقرير JSON كتلة ملخّص (إجمالي الصفقات، والصفقات الرابحة والخاسرة، ونسبة الصفقات الرابحة، وصافي الربح والخسارة، وأقصى تراجع)، وقائمة الصفقات الكاملة (أوقات الدخول والخروج، والأسعار، والكمية، والربح والخسارة، وفهارس الشموع)، ومقاييس مثل عامل الربح ونسبتَي Sharpe وSortino، ومنحنى حقوق الملكية، وبصمة للمحرّك والمحوِّل والمدخلات والبيانات التي يقوم عليها التشغيل (null إن تعذّر حسابها).
هذا هو سير العمل بأكمله. بلا واجهة رسومية، بلا إعادة مصادقة حساب، بلا تحميل رسم بياني. إن كنت تستطيع تشغيل Docker، تستطيع تشغيل اختبارات PineForge التاريخية بدون اتصال.
ما يمكنك اختباره تاريخياً
الإجابة القصيرة: أي شيء يمكنك تسلسله إلى OHLCV. PineForge غير متّصل بأي مزوّد بيانات سوق. أنت تُحضر البيانات؛ المحرّك يُشغّل الاستراتيجية.
- العملات الرقمية من بورصتك. اسحب بيانات الصفقات الخام من Binance أو Bybit أو Kraken أو أي بورصة لديها REST أو WebSocket API. جمّعها إلى أي إطار زمني تستخدمه استراتيجيتك. غذِّ CSV مباشرةً. اختبر على نفس تركيبة الزوج-والمكان التي ستتداول عليها.
- شموع مبنيّة من بيانات التيك. إذا كنت تبني الشموع من بيانات التيك أو دفتر الأوامر، فمرّرها بصيغة OHLCV. لا يهمّ المحرّك من أين أتت الشموع.
- سلاسل أخرى. لا يقرأ المحرّك سوى timestamp وopen وhigh وlow وclose وvolume؛ وتُتجاهَل الأعمدة الإضافية. ولا يمكن إجراء اختبار تاريخي على درجة لمعنويات السوق أو مقياس من بيانات البلوكتشين إلا إذا رمّزته في تلك الأعمدة.
الاستراتيجيات الـ312 في المعرض مأخوذة من المجموعة المرجعية المفتوحة، وكلٌّ منها مُقيَّمة مقابل ملف التصدير من TradingView نفسه. وعلى الفرع main للمحرّك، يُثبّت فحص المجموعة المرجعية 311 منها عند تقدير ممتاز: العدد نفسه من الصفقات، وفارق لا يتجاوز 0.01% في الأسعار و1% في الربح والخسارة عند المئين الـ90، مع حدود أوسع لسعر الخروج وللربح والخسارة في الاستراتيجيات الـ7 التي تُقيَّم مخارج trail_* فيها وفق ملف عتبات الإنتاج. والاستراتيجية المتبقّية حالة شاذّة مُعلَنة. للحصول على تقدير ممتاز، عندما يعرض TradingView اثنين أو أكثر من قيم Signals المختلفة للدخول في الوقت نفسه تمامًا وبالسعر والاتجاه نفسيهما، يعرض المحرّك العدد نفسه من عمليات الدخول المختلفة عند هذه النقطة (هوية عمليات الدخول المختلفة).