تفريغ تاريخ التليغرام

هذه الأداة هي خليفة telegram-json-backup، وقد كتبت من الصفر بلغة روبي. يمكنها إنشاء نسخ احتياطية لمحادثات المستخدم والمجموعات (العادية والمميزة) في تليغرام باستخدام ميزة التحكم عن بُعد لواجهة telegram-cli.

بالمقارنة مع المشروع القديم، فإن telegram-history-dump:

• يوفر دعمًا أفضل لتنزيل الوسائط
• يدعم تنسيقات إخراج غير JSON وهو قابل للتوسع بتنسيقات مخصصة
• يدعم النسخ الاحتياطي التزايدي (يتم تنزيل الرسائل الجديدة فقط)
• لا يعتمد على ارتباطات Python/Lua غير المستقرة داخل telegram-cli
• يحتوي على ملف تكوين منفصل بتنسيق YAML

التكوين الافتراضي سيعمل على نسخ جميع المحادثات إلى مجلد باسم output، بتنسيق JSON، دون تنزيل أي وسائط.

الاستخدام

الإعداد الأولي

1. قم بتجميع telegram-cli، وابدأ تشغيله مرة واحدة لربط حساب تليغرام الخاص بك
2. تأكد من تثبيت Ruby 2+ على نظامك: ruby --version
3. اختياريًا، قم بتكوين روتين النسخ الاحتياطي الخاص بك عن طريق تعديل config.yaml

إجراء نسخ احتياطي

1. ابدأ تشغيل telegram-cli مع الخيارات التالية على الأقل: telegram-cli --json -P 9009
2. بينما يعمل telegram-cli، قم بتنفيذ النص البرمجي: ruby telegram-history-dump.rb

المنسقات

سيتم تخزين السجل دائمًا في ملفات متوافقة مع JSON Lines. ومع ذلك، يمكن إنتاج تنسيقات إخراج إضافية عن طريق إلغاء تعليق بضعة أسطر في ملف التكوين.

يمكنك تفعيل وحدة أو أكثر من وحدات المنسقات التالية:

html ينشئ سجلات محادثات منسقة ومقسمة إلى صفحات يمكن عرضها عبر متصفح ويب.

plaintext ينشئ ملفات نصية قابلة للقراءة البشرية، منظمة كملف واحد لكل يوم.

bare يخرج فقط نصوص الرسائل الفعلية دون أي سياق. وهو مخصص للتحليل اللغوي / الإحصائي.

pisg ينشئ سجلات يومية متوافقة مع تنسيق تسجيل IRC الخاص بـ EnergyMech كمدخل لمولد إحصائيات الدردشة PISG. انظر أيضًا telegram-pisg.

يمكنك أيضًا تنفيذ منسق مخصص؛ راجع formatters/lib/formatter_base.rb للحصول على التفاصيل.

خيارات سطر الأوامر

معظم تكوين النسخ الاحتياطي يتم من خلال ملف التكوين، ولكن بعض الخيارات المحددة متاحة كخيارات CLI. لا شيء منها إلزامي.

Usage: telegram-history-dump.rb [options]
    -c, --config=cfg.yaml            المسار إلى ملف تكوين YAML
    -k, --kill-tg                    إنهاء telegram-cli بعد النسخ الاحتياطي
    -h, --help                       إظهار المساعدة
    -d, --dir=DIR                    دليل فرعي لملفات الإخراج
                                     (بالنسبة إلى backup_dir في تكوين YAML)
    -l, --limit=LIMIT                الحد الأقصى لعدد الرسائل المراد نسخها
                                     لكل هدف (يتجاوز تكوين YAML)

ملاحظات

ملاحظات الاستخدام:

• من الممكن تشغيل telegram-cli على جهاز مختلف، على سبيل المثال كخدمة خلفية على خادم. في هذه الحالة، يجب تمرير --accept-any-tcp إلى telegram-cli واستخدام جدار حماية للمنفذ بشكل مناسب لمنع التعرض غير المرغوب فيه. ضع في اعتبارك أن بعض الخيارات المتعلقة بملفات الوسائط لن تعمل في إعداد بعيد.
• كن حذرًا عند تقليل chunk_delay أو زيادة chunk_size. يبدو أن تليغرام يحد من عدد طلبات السجل. قد يؤدي السرعة الزائدة إلى انتهاء مهلة العملية وإجبار النص البرمجي على تخطي جزء من التفريغ.

مشكلات telegram-cli المعروفة التي تؤثر على telegram-history-dump:

• vysheng/tg#947 يمكن أن يتسبب في تعطل عند تفريغ القنوات التي تحتوي على أكثر من 100 رسالة.
• vysheng/tg#904 يمكن أن يتسبب في تعطل عندما تحتوي المحادثات على ملفات وسائط معينة. إذا واجهت هذا، أعد تجميع telegram-cli مع الحل البديل المقترح.