أين تذهب الملفات؟

إلى مجلّد Documents ثم Senzoukria ثم Exports. وإن تعذّر تحديد مجلّد Documents، استُعمل مجلّد exports داخل بيانات التطبيق. وتعرض رسالة الانتهاء المسار كاملًا، ويفتحه زرّ الإظهار في المجلّد.

لماذا تكون بعض حقول المستويات فارغة بدل أن تكون صفرًا؟

الحقل الفارغ يعني أن ذلك الجانب مجهول عند هذا المستوى. والصفر وعدم التوافر يبقيان متمايزين عن قصد.

هل أستطيع تصدير التيكات؟

لا. فالذاكرة المخزَّنة تحفظ مجاميع لكل شمعة ولكل مستوى سعري. وجلسات Replay تحتفظ ببيانات التيك على حدة، لكن هذا الزر لا يصدّر إلا الشموع والمستويات.

تصدير الشموع إلى ملف CSV

يكتب زرّ التصدير في مخطط Senzoukria الشموعَ المحمَّلة حاليًّا ومستوياتها السعرية في ملفَّي CSV مضغوطين بصيغة gzip داخل مجلّد Documents ثم Senzoukria ثم Exports، بطوابع زمنية بتوقيت UTC ومع مصدر كل سطر في الذاكرة المخزَّنة.

Senzoukria · التوثيق · آخر تحديث: سبتمبر 2026

أين تجده

أين: زرّ ⇩ في شريط أدوات المخطط (بصمة Rithmic وبصمة العملات الرقمية)
الوجهة: Documents → Senzoukria → Exports (وعند تعذّر ذلك، مجلّد exports داخل بيانات التطبيق)
الملفات: ملفّان يتكوّن اسم كلٍّ منهما من الرمز ثم الإطار الزمني ثم بداية المدى ونهايته، وينتهي أحدهما بالمقطع bars.csv.gz والآخر بالمقطع levels.csv.gz
المدى: من أول شمعة محمَّلة إلى آخرها، شاملًا الطرفين؛ وبحدّ أقصى سنة واحدة

ما الذي يفعله

يكتب التصدير ما تحتفظ به الذاكرة المخزَّنة للمدى المحمَّل: مجاميع لكل شمعة (الافتتاح والأعلى والأدنى والإغلاق، والحجم، والدلتا، وأعلى الدلتا وأدناها، وعدد الصفقات)، ومجاميع لكل مستوى سعري (حجم الشراء والبيع العدوانيين، وعدد صفقات الشراء والبيع). وليس هذا تصديرًا للتيكات؛ فالذاكرة المخزَّنة لا تحفظ الصفقات الفردية. ويُنتَج ملفّان حتى يمكن ربط الشمعة بمستوياتها عبر الحقول bucket_ts_ns وsymbol وtimeframe.

ويكون الزر معطَّلًا ما دام لا شيء محمَّلًا، مع تلميح يقول إنه لا يوجد بعد ما يُصدَّر. والنقر عليه يفتح تأكيدًا يسأل عن تصدير الشموع المحمَّلة ومستوياتها السعرية في صورة CSV مضغوط إلى مجلّد Exports، يليه زر التصدير الآن. ويقرأ شريط التقدّم عدد الشموع وعدد المستويات الجارية كتابتها، ويمكن إلغاؤه؛ وتعطي الرسالة الختامية الأعدادَ والحجمَ وأول طابع زمني وآخره بتوقيت UTC، وكم شمعة بلا مستويات سعرية (أي بيانات افتتاح وأعلى وأدنى وإغلاق فقط). ويكشف زرّ الإظهار في المجلّد عن ملف الشموع.

الأعمدة

مخطط الحقول في الملفّين
الملف	الأعمدة	ملاحظات
الشموع	bucket_ts_ns, bucket_utc, symbol, timeframe, source, open, high, low, close, volume, delta, delta_high, delta_low, trades, levels	الحقل bucket_ts_ns هو زمن افتتاح الشمعة بالنانوثانية منذ حقبة يونكس؛ وbucket_utc هو الزمن نفسه بصيغة ISO 8601 بتوقيت UTC. أما source فهو مصدر السطر في الذاكرة المخزَّنة: live أو ohlcv أو aggtrades أو tick أو اسم جسر.
المستويات	bucket_ts_ns, symbol, timeframe, price, buy_volume, sell_volume, buy_trades, sell_trades	سطر واحد لكل مستوى سعري جرى فيه تداول. والجانب المجهول حقل فارغ، لا صفر أبدًا.

السلوك

القواعد التي يطبّقها أمر التصدير
القاعدة	القيمة	الأثر
الضغط	gzip مفعَّل	تنتهي أسماء الملفات بالامتداد csv.gz.
لا كتابة فوق القديم أبدًا	لاحقة رقمية	يُحتفظ بالتصدير السابق الذي يحمل الاسم نفسه؛ ويأخذ الجديد اسمًا برقم (2 ثم 3 وهكذا).
الكتابة المتدفّقة	صفحات من 2000 شمعة	تُكتب صفحةً صفحة؛ ويُؤخذ قفل الذاكرة المخزَّنة لكل صفحة على حدة، فيبقى المخطط قادرًا على القراءة أثناء التصدير.
حدث التقدّم	كل خمس صفحات	يحدّث عدّادَي الشموع والمستويات.
الإلغاء	بين الصفحات	تُحذف الملفات الجزئية؛ وتُبلَّغ النتيجة على أنها ملغاة، لا على أنها نجاح.
أقصى نافذة	366 يومًا	تُرفض المدد الأطول من ذلك.
مستويات غير مقروءة	تُعدّ	الشمعة التي يتعذّر قراءة بنية JSON لمستوياتها تُصدَّر بعمود مستويات فارغ، وتُحسب على حدة عن الشموع التي لا مستويات لها.

الحدود والمزالق

قبل فتح الملفات في برنامج آخر:

الوحدات هي وحدات المصدر: عقود في العقود الآجلة، ووحدات العملة الأساس في العملات الرقمية. والملف لا يحوّلها.
الحقول النصية محميّة من حقن صيغ جداول البيانات (يُسبَق أي حرف افتتاحي من علامات التساوي أو الجمع أو الطرح أو أت بعلامة اقتباس مفردة)، وتُحاط بعلامات اقتباس وفق المعيار RFC 4180 عند اللزوم.
يغطّي التصدير المدى المحمَّل، لا الذاكرة المخزَّنة كلها. فحمّل نافذة سجل أوسع أولًا إن احتجت إلى المزيد.
الشموع الموسومة بالمصدر ohlcv بلا مستويات: فهي جاءت من بديل الافتتاح والأعلى والأدنى والإغلاق، لا من إعادة تشغيل التيكات.

هذه الصفحة بلغات أخرى

أسئلة شائعة

أين تذهب الملفات؟: إلى مجلّد Documents ثم Senzoukria ثم Exports. وإن تعذّر تحديد مجلّد Documents، استُعمل مجلّد exports داخل بيانات التطبيق. وتعرض رسالة الانتهاء المسار كاملًا، ويفتحه زرّ الإظهار في المجلّد.
لماذا تكون بعض حقول المستويات فارغة بدل أن تكون صفرًا؟: الحقل الفارغ يعني أن ذلك الجانب مجهول عند هذا المستوى. والصفر وعدم التوافر يبقيان متمايزين عن قصد.
هل أستطيع تصدير التيكات؟: لا. فالذاكرة المخزَّنة تحفظ مجاميع لكل شمعة ولكل مستوى سعري. وجلسات Replay تحتفظ ببيانات التيك على حدة، لكن هذا الزر لا يصدّر إلا الشموع والمستويات.