TgWitness / التوثيق

ما تم اختباره ←

مرجع / جمع

Telegram · المحادثات السرية: الإعداد والتسجيل

ثبّت إضافة بروتوكول المحادثات السرية، وفعّلها لكل حساب، وسجّل المحادثات التي ينشئها TgWitness أو يقبلها.

TgWitness / التوثيق

يتضمن التطبيق المنشور البنية الخلفية لـ «Secret Chat»، وتكامل أداة التجميع، ومسارات واجهة برمجة التطبيقات (API)، وواجهة Pseudo-secret. وتُعد مكتبة البروتوكول وحدة منفصلة: افتح Pseudo-secret واضغط على تثبيت ثم قم بتشغيلها. ويظل خيار القبول التلقائي للرسائل الواردة معطلاً حتى تقوم بتشغيله.

وحدة البروتوكول#

الوحدة kiaro-telethon-secret-chat 0.2.0
المؤلف KiaroSama
الترخيص GPL-3.0 أو إصدار أحدث؛ و LICENSE و NOTICE تظل داخل الأرشيف المحفوظ
المصدر KiaroSama/Telethon-Secret-Chat في الالتزام d87bf037b90060383c7b704d8a06ebb98c621c6f
تحقق SHA-256 c80feb9b5bc28201677c140d20930fbd730d7efdebb8ca789a19040c3f00ce5c على قائمة ملفات الحزم وقيم SHA-256 الخاصة بها

تتوفر ميزة التثبيت والتشغيل للمسؤول الرئيسي. يقوم TgWitness بتنزيل أرشيف المصدر الخاص بهذا الالتزام من GitHub عبر مسار مساحة العمل المخصص للطلبات خارج Telegram، ويقارن كل ملف في الحزمة بالقيمة المحددة في إصدار TgWitness، ويحفظ الأرشيف في modules/telethon-secret-chat-<commit>.zip في دليل البيانات ويقوم بتحميل الكود من الذاكرة. لا حاجة لإعادة التشغيل. يتم إجراء الفحص مرة أخرى عند كل بدء تشغيل؛ ولا يتم تحميل أي أرشيف يختلف عن الأصل وتظهر الصفحة إشعارًا بذلك. يؤدي أي ملف حزمة تم تغييره أو فقدانه أو إضافته إلى فشل الفحص.

تُعد الوحدة النمطية عملاً مستقلاً يخضع لترخيص خاص به. ولا يقوم TgWitness بتضمينها: حيث يتم تنزيلها في كل عملية تثبيت من مستودع مؤلفها. وتُظهر التفاصيل الموجودة على الصفحة الوحدة النمطية التي تم تحميلها، ومؤلفها، وترخيصها، وآخر تحديث لها، ورمز SHA-256.

يمكن للمضيف الذي لا يملك إمكانية الوصول إلى GitHub تثبيت نفس الالتزام في بيئة Python بدلاً من ذلك؛ ثم تستخدم اللوحة تلك النسخة:

python -m pip install ".[secret-chats]"

يصبح TgWitness نقطة نهاية للمحادثات التي ينشئها أو يقبلها. وهو يسجل الرسائل، والمرفقات المتاحة، وتغييرات المؤقت، وإشعارات الحذف في السجل الموقع. ويظل المحتوى الذي تم حفظه مسبقًا متاحًا بعد صدور إشعار حذف لاحق.

توافر الحزمة#

في 8 نوفمبر 2026 ، تم فحص حزمة التثبيت المنشورة عند المصدر b35f8e18f3d1 ، الإصدار b35f8e18f3d1-1ff85ec98bb2 ، الإصدار 0.9.1 (نسخة تجريبية). اجتازت العجلة الثابتة وقفل تبعياتها التحقق من توقيع الإصدار باستخدام SHA-256 وRSA. تطابقت الخلفية والواجهة المعبأتان مع تلك المراجعة المصدرية بايتًا بايتًا. تحتوي الحزمة أيضًا على تسجيل واجهة برمجة التطبيقات (API) وخطافات المجمع.

لم تحتوِ تلك الحزمة على مكتبة البروتوكول، وهي غير موجودة في قائمة التبعيات المثبتة. كما أن secret-chats الجزء الإضافي في ملف pyproject.toml يربط نفس الالتزام الذي يربطه زر اللوحة.

يحدد فحص الحزمة هذا الملفات وإعلانات التبعية التي يتم تضمينها. يحدد سجل التحقق عمليات الفحص المنفصلة في وقت التشغيل. وصف الدليل السابق الصادر في 6 نوفمبر لقطة تطويرية؛ ولم يعد يصف الحزمة المذكورة أعلاه.

استخدم الواجهة#

افتح Pseudo-secret، وقم بتثبيت الوحدة النمطية إذا كانت الصفحة توفرها، ثم قم بتفعيلها للحساب وربطها. تنتظر الطلبات الواردة الموافقة عليها ما لم يتم تمكين القبول التلقائي. تستخدم عمليات البدء والقبول والإرسال والإغلاق أذونات التفاعل الخاصة بالحساب وحماية «للقراءة فقط».

الإجراء النتيجة المحفوظة
بدء محادثة باستخدام اسم المستخدم أو معرّف المستخدم طلب صادر؛ يقبله النظير على جهازه.
قبول الطلب يصبح TgWitness نقطة النهاية المستقبلة.
إرسال أو استلام رسالة secret_chat.message مع اتجاهها ومحتواها والمؤقت المرفق.
استلام ملف بايتات مفكوك تشفيرها مخزنة بواسطة SHA-256 وإيصال secret_chat.file؛ مضمنة في تصدير الأدلة.
تلقي إشعارًا بموعد انتهاء الصلاحية أو الحذف سجل إجراءات منفصل إلى جانب الرسائل والملفات المحتفظ بها.
مراجعة الدردشة المحادثات، وإيصالات الملفات، والإشعارات، وتصور المفاتيح.

تحتفظ الدردشات السرية الموجودة على جهاز آخر بمفاتيحها الخاصة بالجهاز. ولا تقوم الجلسة السحابية المستوردة بنقل تلك المفاتيح. تستخدم مواد مفاتيح الدردشات السرية و العدادات خزنة مساحة العمل؛ بينما تستخدم الرسائل المحفوظة والملفات التي تم فك تشفيرها إجراءات الحماية العادية لتخزين مساحة العمل.

البحث عن الرسائل المحفوظة#

استخدم ميزة البحث عن الرسائل داخل محادثة مفتوحة للعثور على عبارة حرفية، مع تجاهل حالة الأحرف. استخدم زري السابق والتالي، أو مفتاحي «Enter» و«Shift+Enter» في حقل البحث، للتنقل بين الرسائل المطابقة. يقوم العداد بحساب عدد الرسائل؛ ويتم تمييز أول عبارة مطابقة في كل رسالة. يؤدي الضغط على مفتاح «Escape» إلى مسح البحث.

تُظهر ميزة «البحث» المحادثة المحيطة والملفات المحفوظة وإشعارات الحذف بشكل واضح. وتقوم هذه الميزة بالبحث في السجلات التي تم تحميلها مسبقًا في اللوحة. وعندما تتواجد سجلات أقدم، تُشير اللوحة إلى ذلك؛ ويؤدي خيار تحميل السجلات الأقدم إلى توسيع نطاق السجل و تحديث نتائج البحث مع الإبقاء على الرسالة الحالية في مكانها.

تحتفظ كل محادثة بعمليات البحث الخاصة بها أثناء التنقل داخل نفس مساحة العمل. ويؤدي قفل اللوحة أو تغيير مساحات العمل إلى مسح عمليات البحث تلك. وتبقى مصطلحات البحث في ذاكرة الصفحة ولا يتم تخزينها في ذاكرة المتصفح أو إرسالها كاستعلامات API. ولا يؤدي البحث إلى إرسال رسائل Telegram أو إشعارات الكتابة/القراءة. ولا تزال إعدادات الرؤية الحالية تحكم فتح المحادثة والإجراءات الأخرى.

يحتفظ تقرير البناء بنطاق التقرير الخاص بالدردشة المحددة؛ أما البحث في شاشة العرض فلا يقيد السجلات التي يتم تصديرها دون إشعار. قم بمعاينة اختيار التقرير قبل تنزيله.

ضوابط الاستمرارية والتفاعل#

يستخدم التنفيذ المتكامل البحث الدائم في السجل لاكتشاف التكرارات، ويبقي مهام المرفقات معلقة بعد فشل التنزيل، ويوجه عمليات الإغلاق عبر نفس حارس التفاعل مثل الإجراءات البعيدة الأخرى. وتحل هذه المسارات محل المسارات الثلاثة المذكورة في التدقيق التاريخي للقطعة اللحظية للتطوير بتاريخ 6 نوفمبر.

يتم الاحتفاظ بالرسائل التي تم فك تشفيرها والتي فشلت عملية تسجيلها في السجل داخل الخزينة لإعادة المحاولة. تؤدي عمليات التحقق من حجم المرفقات ومساحة القرص المتوفرة إلى تأجيل التنزيلات مع الاحتفاظ بالمهام الخاصة بها. تعيد الوحدة النمطية استخدام الاتصال الحالي للحساب. يتم إرسال إشعارات القراءة والكتابة فقط وفقًا للإعدادات المحددة في ما يراه الطرف الآخر؛ ولا يتم إرسال إشعارات لقطات الشاشة أبدًا. انظر secret_chats.py ومسارات واجهة برمجة التطبيقات (API) و سياسة الوصول.

يحتفظ التدقيق التاريخي بنتائج اللقطات الأصلية. يجب الاطلاع على التوافر الحالي والتنفيذ من مراجعة الحزمة أعلاه والقدرات الحالية.

عرض توضيحي للواجهة#

يستخدم سيناريو الموقع الإلكتروني طلبات ورسائل وملفات خيالية لتوضيح سير عمل اللوحة. إنه مثال على واجهة؛ أما فحوصات البروتوكول والاستحواذ فلها نتائجها المؤرخة في سجل التحقق من الصحة.