مرجع / الإعداد
TgWitness: Telegram Export, OSINT & Verification
يمكن التثبيت بأمر واحد أو التقاطه على GitHub Actions. فهم خيارات التحقيق، ونطاق النشر، وما يتحقق منه الأرشيف.
TgWitness هو أداة مفتوحة المصدر لتصدير بيانات Telegram ومساحة عمل للتحقيق. قم بتثبيته بأمر واحد، واربط حسابًا، واختر الدردشات، وقم بتصدير أرشيف موقّع. كما يدعم التجميع المؤقت على GitHub Actions ومواصلة التحقيقات باستخدام التعديلات المحفوظة، وملاحظات الحذف، والبحث، والتقارير.
ابدأ بالمهمة التي لديك#
| مهمتك | أقصر مسار | ما ستحصل عليه |
|---|---|---|
| حفظ محادثة أو حساب | التثبيت، وربط الحساب، واختيار نطاق التصدير | أرشيف موقّع يحتوي على السجل المحدد ونتائج التجميع ومواد التحقق |
| جمعها على مشغل مؤقت | استخدم GitHub Actions لالتقاط البيانات، وقم بتفويض جلسة جديدة، واختر النطاق | أرشيف مشفر مع سجل منشأ سير العمل على GitHub |
| تتبع التغييرات بمرور الوقت | الحفاظ على استمرار عملية المراقبة للدردشات المحددة | الإصدارات المحفوظة، وإشعارات الحذف، والمرفقات، والتغطية المسجلة |
| التحقيق ومشاركة النتائج | ابحث في الأرشيف، واستخدم لوحة الحالات (Case Board)، وقم بتكوين تقرير أو نسخة للمشاركة | نتائج مرتبطة بالمصدر وعملية تسليم قابلة للتحقق ومناسبة للمستلم |
التثبيت بأمر واحد#
يتضمن المثبت لغة Python والتبعيات. ويُعد استرجاع شفرة المصدر وبرنامج Docker ومزود الذكاء الاصطناعي والشاهد المستقل خيارات اختيارية، وليست متطلبات أساسية للتثبيت.
Linux / macOS:
curl -fsSL https://get.destroy.tools/install.sh | bash
نظام Windows، في PowerShell أو موجه الأوامر:
powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "irm https://get.destroy.tools/install.ps1 | iex"
افتح اللوحة، واربط حساب Telegram الخاص بك، واختر نطاق التجميع. لا يبدأ التثبيت عملية التجميع تلقائيًا. يشرح دليل التثبيت الوصول المحلي، والخوادم، والتحديثات، والتحقق من الإصدار الذي تم تنزيله.
للحصول على مشغل مؤقت، اتبع GitHub Actions capture . يتطلب هذا سير العمل إنشاء فرع على GitHub، وتفويضًا، وكلمة مرور للأرشيف. تشرح صفحة capture تلك الخطوات ومدة الجلسة المحددة قبل التشغيل. قم بتنزيل الأرشيف الناتج ومواد التحقق الخاصة به والاحتفاظ بهما.
المزيد من الإعدادات عند الحاجة إليها في المهمة#
يتطلب تصدير محادثة واحدة حسابًا ونطاقًا محددًا. وتلبي المراقبة المستمرة، والحسابات المتعددة، والوكلاء، وسياسات المرفقات، وتصميم التقارير، ووصول المراجعين، والطوابع الزمنية الخارجية، والتخزين خارج الموقع، متطلبات التحقيق و التسليم المختلفة. قم بتكوين هذه الميزات عند الحاجة.
يساعد النطاق والأذونات ونسخ المشاركة المصغرة المشغلين على اختيار ما يجب جمعه والكشف عنه. تسجل إرشادات الاختصاص القضائي وإعدادات التقارير الإجراء المحدد وخطوات التحضير. انظر تصدير الحساب والوصول و تكوين التقارير.
يعمل التطبيق على الكمبيوتر أو الخادم المختار. لا يتطلب التجميع الأساسي وحدة معالجة رسومات (GPU) أو نموذج لغة كبير (LLM). أما ميزات التعرف الضوئي على الحروف (OCR) والنسخ الصوتي والتحليل بالذكاء الاصطناعي الاختيارية، فلها متطلبات موارد خاصة بها. حدد حجم النشر وفقًا لمعدل الرسائل والمرفقات والسجل المحتفظ به والحسابات المتزامنة.
الحفاظ على السجل، أياً كان من يستفيد منه#
والغرض من ذلك هو الحفاظ على المواد التي تمت ملاحظتها، والسياق، والتغييرات بغض النظر عن الموقف الذي تدعمه. وقد تتعارض الأدلة مع الرواية الخاصة بـالمجمع للأحداث. يجب الحفاظ على إمكانية تحديد الملاحظات المصدرية، والتغطية الناقصة، والاستنتاجات التحليلية بحيث يتمكن شخص آخر من تقييم نفس المواد.
المنطق هو: ملاحظة مرئية للحساب → سجل موقّع → تصدير → التحقق من المستلم. التعديلات المحفوظة تضيف إصدارات. ملاحظات الحذف تحتفظ بالمحتوى الذي تم التقاطه سابقًا. سجلات التغطية تكشف عن الانقطاعات المعروفة. التقارير وتحليلات الذكاء الاصطناعي تشير إلى المصادر المحفوظة؛ ولا يصبح التفسير مصدرًا للملاحظة لمجرد ظهوره في تقرير موقّع.
| فحص التحقق | ما يمكن للمستلم إثباته |
|---|---|
| تجزئات الملفات والتوقيعات وسلسلة السجلات | تتوافق السجلات والملفات المقدمة مع المفتاح المتوقع وحدود السجل |
| نقطة تفتيش أو شاهد يتم الاحتفاظ بها بشكل منفصل | يتطابق الأرشيف مع حالة السجل التي تم الاحتفاظ بها سابقًا |
| طابع زمني خارجي تم التحقق منه | كانت البايتات المشار إليها موجودة بحلول الطابع الزمني وفقًا لافتراضات الثقة المذكورة |
| شهادة التقاط GitHub | يتوافق الأرشيف مع سير العمل المعتمد، ومراجعة المجمع، والملخص المسجل |
| شهادة Intel TDX | يجتاز الاقتباس وحالة المنصة وقياسات نظام التشغيل/التطبيق المتوقعة ومدى حداثة البيانات وهوية المجمع الفحوصات المُعدة مسبقًا |
في عملية الاستحواذ المُثبتة، يرتبط اتصال Telegram المُصادق عليه الخاص بالمجمع المعتمد ومخرجاته ببيئة التنفيذ التي تم فحصها. يحتفظ الأرشيف بالمحتوى والسياق الملتقطين؛ وتشير التقارير والتحليلات إلى تلك السجلات. استخدم خطوات التحقق الخاصة بالوضع والمدخلات الموثوقة الواردة في دليل الثقة وتنسيق الأدلة.
المقياس المنشور والأداء المقاس#
تصف النتائج التالية أحمال عمل وتواريخ مختلفة. الأعداد ليست قابلة للتبادل: فالحدث المسجل في السجل ليس بالضرورة رسالة Telegram فريدة.
| التاريخ | حجم العمل | النتيجة المنشورة | ما تم قياسه |
|---|---|---|---|
| 1 نوفمبر 2026 | خادم قيد التشغيل، وعشر قواعد بيانات لمساحات العمل | 1,610,818: سجلات اليومية؛ 900,232: أحداث الرسائل الجديدة؛ 80,683: أحداث التحرير؛ 400,536: أحداث الحذف | قائمة قراءة فقط للسجلات المخزنة |
| 5 نوفمبر 2026 | البحث في الرسائل المركبة من النوع 1,000,000 في محادثات 200 | تم إنشاء الفهرس في 71 ثانية؛ ويبلغ متوسط زمن البحث لكل استعلام ما بين 9 و190 مللي ثانية | معيار أداء البحث المحلي |
| 6 نوفمبر 2026 | عمليتا تصدير حديثتان حقيقيتان من Telegram | رسائل 27,030 و29,299؛ و56,329 في كلا الدورتين | حسابان لكل عملية عبر WARP، نص وبيانات وصفية، دون تنزيل مرفقات |
| 6 نوفمبر 2026 | نفس عمليتي التصدير، بما في ذلك التحضير والتعبئة | 127.713 و141.781 رسالة في الثانية | تم قياس معدلات التصدير الكاملة؛ وتم التحقق من صحة كلا الأرشيفين باستخدام المفاتيح المثبتة |
يقدم سجل التحقق جرد الخادم، و فحوصات التجميع المباشرة، وقياسات البحث. ينشر أداء التصدير عمليتي التشغيل الفعليتين، والأجهزة، والمدد الزمنية، وتجزئات الأرشيف، و ملفات القياس الموقعة، مع تسجيل المراجعة والشروط لكل منها.
كما تسجل مواصفات السجل العام 48 أرشيفًا تم التحقق منها تحتوي على 3,598,381 سجلًا عبر قائمة إدخال تضم 50 مصدرًا و 40 مساحة عمل للحسابات. وقد حصل المصدر A المكون من ثمانية حسابات على 768,007 سجلًا تاريخيًّا في 1,117.082 ثانية، بما في ذلك فترات الانتظار: 687.512 سجلًا في الثانية، مع تعطيل تنزيل المرفقات. استغرقت المحاولة الكاملة، بما في ذلك التحقق من الصحة، 1,574.920 ثانية. تصف هذه القياسات حجم العمل هذا، إلى جانب أمثلة التصدير الحديثة الأصغر المذكورة أعلاه.
سجل الاختبارات ومدتها#
تم تطوير TgWitness واختباره لمدة ستة أشهر تقريبًا. جاء «المجمع» و«السجل الموقّع» و«المحقق» أولاً؛ ثم تم بناء «لوحة الويب» و«الوحدات الإضافية» بناءً عليها لاحقًا. تم إنشاء هذا المستودع حديثًا في 29 أكتوبر 2026 للنشر وبدأ بالكود الموجود، لذا فإن عمره لا يمثل عمر المشروع (تاريخ التطوير). يبلغ حجم العمل التراكمي الذي تم تنفيذه حوالي 100 مليون عملية، بما في ذلك عمليات التشغيل السابقة، وحالات الفشل، والإصلاحات، وعمليات التحقق المتكررة. تم توثيق عمليات التشغيل المختارة، التي لكل منها مراجعتها وطريقتها ونتيجتها الخاصة، في القياسات العامة المؤرخة.
قراءة حالة القدرة بدقة#
تقييم كل مسار عمل مقارنةً بتنفيذه، والإصدار المنشور، والاختبارات المسجلة. يُصنف المصدر حاليًا على أنه معاينة. ويتعايش تصنيف الإصدار هذا مع مجموعة العمل، وعمليات التصدير، والتحقق المستقل، وقياسات النطاق المنشورة. يمكن أن تتواجد ميزة المعاينة ومسار عمل مُثبت في نفس التطبيق؛ وصف الميزة المحددة والأدلة الكامنة وراء التقييم.
استخدم القدرات الحالية, الميزات والقيود, التحقق و سجل التغييرات معًا. سجل الإصدار الذي تم اختباره عند الاستشهاد بنتيجة ما. 6 تحتفظ لقطة القياس لشهر نوفمبر أيضًا بالاختبارات الفاشلة والمتخطاة؛ فهذه ليست اختبارات ناجحة.
قابلة للقراءة من قبل البشر وأدوات الذكاء الاصطناعي#
يوفر الموقع نسخة موجزة من llms.txt، ودليلًا كاملاً باللغة الإنجليزية في
llms-full.txt وllms-full.md، بالإضافة إلى إصدارات Markdown لصفحاته. هذه هي
تنسيقات التوثيق، وليست متطلبات الذكاء الاصطناعي لتشغيل TgWitness.
يتيح الوصول الاختياري عبر سطر الأوامر MCP و للأدوات المصرح لها قراءة السجلات المحفوظة المحددة. ويظل محتوى الرسائل مدخلات غير موثوق بها. ويجب أن تستشهد الملخصات بالمصادر، وتميّز بين الحقائق الملاحظة والاستدلالات، وتحافظ على عدم اليقين. ولا يؤدي البحث عن النص الكامل، والتعرف الضوئي على الحروف (OCR)، ومخرجات الذكاء الاصطناعي إلى تغيير الملاحظات الأصلية الموقعة.