مرجع / الإعداد
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 | يتوافق الأرشيف مع سير العمل المعتمد، ومراجعة المجمع، والملخص المسجل |
تدعم هذه الفحوصات مراجعة السلامة والمصدر. وهي لا تحول محتوى الرسالة إلى بيان صحيح ولا تعيد بناء الرسائل المحذوفة التي لم تُشاهد من قبل. استخدم بصمة مفتاح تم الحصول عليها بشكل مستقل وخطوات التحقق الواردة في دليل الثقة و تنسيق الأدلة .
المقياس المنشور والأداء المقاس#
تصف النتائج التالية أحمال عمل وتواريخ مختلفة. الأعداد ليست قابلة للتبادل: فالحدث المسجل في السجل ليس بالضرورة رسالة Telegram فريدة.
| التاريخ | حجم العمل | النتيجة المنشورة | ما تم قياسه |
|---|---|---|---|
| 1 نوفمبر 2026 | خادم قيد التشغيل، وعشر قواعد بيانات لمساحات العمل | 1,610,818: سجلات اليومية؛ 900,232: أحداث الرسائل الجديدة؛ 80,683: أحداث التحرير؛ 400,536: أحداث الحذف | قائمة جرد للقراءة فقط؛ وليست اختبارًا للإنتاجية أو عملية تحقق جديدة للسلسلة بأكملها |
| 5 نوفمبر 2026 | البحث في الرسائل المركبة من النوع 1,000,000 في محادثات 200 | تم إنشاء الفهرس في 71 ثانية؛ ويبلغ متوسط زمن البحث لكل استعلام ما بين 9 و190 مللي ثانية | معيار قياس البحث المحلي؛ وليس التسليم المباشر عبر Telegram |
| 6 نوفمبر 2026 | عمليتا تصدير حديثتان حقيقيتان من Telegram | رسائل 27,030 و29,299؛ و56,329 في كلا الدورتين | حسابان لكل عملية عبر WARP، نص وبيانات وصفية، دون تنزيل مرفقات |
| 6 نوفمبر 2026 | نفس عمليتي التصدير، بما في ذلك التحضير والتعبئة | 127.713 و141.781 رسالة في الثانية | تم قياس معدلات التصدير الكاملة؛ وتم التحقق من صحة كلا الأرشيفين باستخدام المفاتيح المثبتة |
يقدم سجل التحقق قائمة جرد الخادم، و عمليات التحقق المباشرة من التجميع، وقياسات البحث. ينشر أداء التصدير التشغيلين الفعليين، والأجهزة، والمدد الزمنية، وتجزئات الأرشيف، و ملفات القياس الموقعة. وهي تحدد النتائج الخاصة بالمراجعات والظروف المسجلة، وليس معدلًا عامًا أو سقفًا للسعة.
سجل الاختبارات ومدتها#
أفاد المسؤول عن الصيانة بإجراء اختبارات لأكثر من ستة أشهر اعتبارًا من 6 نوفمبر 2026. يصف هذا تاريخ اختبارات المشروع. القياسات العامة المؤرخة المذكورة أعلاه توثق عمليات تشغيل فردية؛ وهي لا تشكل عملية جمع مستمرة لمدة ستة أشهر تم التحقق منها بشكل مستقل. كما أن عمر الرسائل المصدرة يختلف عن المدة التي ظل فيها المجمع قيد التشغيل.
قراءة حالة القدرة بدقة#
تقييم كل مسار عمل مقارنةً بتنفيذه، والإصدار المنشور، والاختبارات المسجلة. يُصنف المصدر حاليًا على أنه معاينة. ويتعايش تصنيف الإصدار هذا مع مجموعة العمل، وعمليات التصدير، والتحقق المستقل، وقياسات النطاق المنشورة. يمكن أن تتواجد ميزة المعاينة ومسار عمل مُثبت في نفس التطبيق؛ وصف الميزة المحددة والأدلة الكامنة وراء التقييم.
استخدم القدرات الحالية, الميزات والقيود, التحقق و سجل التغييرات معًا. سجل الإصدار الذي تم اختباره عند الاستشهاد بنتيجة ما. 6 تحتفظ لقطة القياس لشهر نوفمبر أيضًا بالاختبارات الفاشلة والمتخطاة؛ فهذه ليست اختبارات ناجحة.
قابلة للقراءة من قبل البشر وأدوات الذكاء الاصطناعي#
يوفر الموقع نسخة موجزة من llms.txt، ودليلًا كاملاً باللغة الإنجليزية في
llms-full.txt وllms-full.md، بالإضافة إلى إصدارات Markdown لصفحاته. هذه هي
تنسيقات التوثيق، وليست متطلبات الذكاء الاصطناعي لتشغيل TgWitness.
يتيح الوصول الاختياري عبر سطر الأوامر MCP و للأدوات المصرح لها قراءة السجلات المحفوظة المحددة. ويظل محتوى الرسائل مدخلات غير موثوق بها. ويجب أن تستشهد الملخصات بالمصادر، وتميّز بين الحقائق الملاحظة والاستدلالات، وتحافظ على عدم اليقين. ولا يؤدي البحث عن النص الكامل، والتعرف الضوئي على الحروف (OCR)، ومخرجات الذكاء الاصطناعي إلى تغيير الملاحظات الأصلية الموقعة.