TgWitness / दस्तावेज़ीकरण

क्या परीक्षण किया गया है →

संदर्भ / एकत्र करें

Telegram · गुप्त चैट्स: सेटअप और रिकॉर्डिंग

गुप्त चैट प्रोटोकॉल एक्स्ट्रा इंस्टॉल करें, प्रत्येक खाते के लिए इसे सक्षम करें और उन चैट्स को रिकॉर्ड करें जिन्हें TgWitness बनाता या स्वीकार करता है।

टीजीविटनेस / दस्तावेज़ीकरण

प्रकाशित एप्लिकेशन में सीक्रेट चैट बैकएंड, कलेक्टर इंटीग्रेशन, एपीआई रूट्स और छद्म-गुप्त इंटरफ़ेस। प्रोटोकॉल लाइब्रेरी एक अलग मॉड्यूल है: ओपन छद्म-गुप्त और दबाएँ इंस्टॉल करें और चालू करें. स्वचालित इनकमिंग स्वीकृति तब तक बंद रहती है जब तक आप इसे चालू न करें।

प्रोटोकॉल मॉड्यूल#

मॉड्यूल kiaro-telethon-secret-chat 0.2.0
लेखक कियारोसामा
लाइसेंस GPL-3.0-या-बाद; इसका LICENSE और NOTICE बचाए गए आर्काइव के अंदर ही रहे
स्रोत KiaroSama/Telethon-Secret-Chat commit पर d87bf037b90060383c7b704d8a06ebb98c621c6f
जाँचें SHA-256 c80feb9b5bc28201677c140d20930fbd730d7efdebb8ca789a19040c3f00ce5c पैकेज फ़ाइलों की सूची और उनके अपने SHA-256 मानों पर

इंस्टॉल और चालू करना मुख्य प्रशासक के लिए उपलब्ध है। TgWitness टेलीग्राम के बाहर के अनुरोधों के लिए वर्कस्पेस के मार्ग के माध्यम से उस कमिट का स्रोत आर्काइव GitHub से डाउनलोड करता है, पैकेज की हर फ़ाइल की तुलना TgWitness रिलीज़ में तय किए गए मान से करता है, आर्काइव को के रूप में सहेजता है modules/telethon-secret-chat-<commit>.zip डेटा निर्देशिका में सहेजता है और मेमोरी से कोड लोड करता है। किसी रीस्टार्ट की आवश्यकता नहीं है। यह जाँच हर बार शुरू होने पर फिर से चलती है; कोई भिन्न आर्काइव लोड नहीं होता है और पेज पर इसकी सूचना दी जाती है। एक बदली हुई, अनुपस्थित या जोड़ी गई पैकेज फ़ाइल जाँच को विफल कर देती है।

मॉड्यूल अपने स्वयं के लाइसेंस के तहत एक अलग कार्य है। TgWitness इसे शिप नहीं करता है: प्रत्येक इंस्टॉलेशन इसे इसके लेखक की रिपॉजिटरी से डाउनलोड करता है। पेज पर दिए गए विवरण में लोडेड मॉड्यूल, इसके लेखक, लाइसेंस, कमिट और SHA-256 दिखाए जाते हैं।

GitHub तक पहुँच न होने वाला एक होस्ट, इसके बजाय पाइथन वातावरण में वही कमिट इंस्टॉल कर सकता है; फिर पैनल उस कॉपी का उपयोग करता है:

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

TgWitness उन चैट्स के लिए एक एंडपॉइंट बन जाता है जिन्हें यह बनाता है या स्वीकार करता है। यह हस्ताक्षरित जर्नल में संदेशों, उपलब्ध अटैचमेंट्स, टाइमर परिवर्तनों और हटाने की सूचनाओं को रिकॉर्ड करता है। बाद में हटाने की सूचना के बाद भी पहले से सहेजी गई सामग्री उपलब्ध रहती है।

पैकेज उपलब्धता#

पर 8 नवंबर 2026, प्रकाशित इंस्टॉलर पैकेज को स्रोत पर जांचा गया था b35f8e18f3d1, रिलीज़ b35f8e18f3d1-1ff85ec98bb2, संस्करण 0.9.1 प्रीव्यू। द अपरिवर्तनीय पहिया और इसकी डिपेंडेंसी लॉक SHA-256 और RSA रिलीज़-हस्ताक्षर सत्यापन। पैकेज्ड बैकएंड और इंटरफ़ेस उस स्रोत संशोधन से बाइट-दर-बाइट मेल खाता था। पैकेज में एपीआई पंजीकरण और कलेक्टर हुक्स भी शामिल हैं।

उस पैकेज में प्रोटोकॉल लाइब्रेरी शामिल नहीं थी, और यह डिपेंडेंसी लॉक में नहीं है। The secret-chats pyproject.toml में extra उसी commit को पिन करता है जो panel button में है।

यह पैकेज निरीक्षण यह स्थापित करता है कि कौन सी फाइलें और निर्भरता घोषणाएँ शामिल की जाती हैं। सत्यापन रिकॉर्ड अलग-अलग रनटाइम जाँचों की पहचान करता है। पहले की 6 नवंबर की गाइड एक विकास स्नैपशॉट का वर्णन करती थी; यह अब ऊपर दिए गए पैकेज का वर्णन नहीं करती है।

इंटरफ़ेस का उपयोग करें#

ओपन स्यूडो-सीक्रेट, यदि पेज यह सुविधा प्रदान करता है तो मॉड्यूल इंस्टॉल करें, इसे खाते के लिए चालू करें और कनेक्ट करें। आउटगोइंग रिक्वेस्ट्स की स्वीकृति तब तक लंबित रहती है जब तक कि स्वचालित स्वीकृति सक्षम न हो। शुरू करना, स्वीकार करना, भेजना और बंद करना खाते की इंटरैक्शन परमिशन और रीड-ओनली सुरक्षा का उपयोग करते हैं।

कार्रवाई संरक्षित परिणाम
उपयोगकर्ता नाम या उपयोगकर्ता आईडी से चैट शुरू करें बाहर जाने वाला अनुरोध; पीयर इसे अपने डिवाइस पर स्वीकार करता है।
अनुरोध स्वीकार करें TgWitness प्राप्त करने वाला एंडपॉइंट बन जाता है।
संदेश भेजें या प्राप्त करें secret_chat.message अपनी दिशा, सामग्री और प्रदान किए गए टाइमर के साथ।
एक फ़ाइल प्राप्त करें SHA-256 और एक secret_chat.file रसीद द्वारा संग्रहीत डिक्रिप्ट किए गए बाइट्स; साक्ष्य निर्यात में शामिल।
टाइमर या हटाने की सूचना प्राप्त करें रखे गए संदेशों और फ़ाइलों के साथ एक अलग कार्रवाई रिकॉर्ड।
चैट की समीक्षा करें संवाद, फ़ाइल रसीदें, सूचनाएं और कुंजी दृश्यांकन।

किसी अन्य डिवाइस पर मौजूदा सीक्रेट चैट्स अपनी डिवाइस-विशिष्ट कुंजियाँ बनाए रखते हैं। एक इम्पोर्टेड क्लाउड सेशन उन कुंजियों को स्थानांतरित नहीं करता है। सीक्रेट-चैट कुंजी सामग्री और काउंटर वर्कस्पेस वॉल्ट का उपयोग करते हैं; संरक्षित संदेश और डिक्रिप्ट की गई फ़ाइलें सामान्य वर्कस्पेस स्टोरेज सुरक्षा का उपयोग करती हैं।

सहेजे गए संदेश खोजें#

उपयोग करें संदेश खोजें एक खुली चैट के अंदर एक शाब्दिक वाक्यांश खोजें, बड़े-छोटे अक्षरों की अनदेखी करते हुए। पिछला और अगला, या खोज क्षेत्र में एंटर और शिफ्ट+एंटर दबाकर मिलते-जुलते संदेशों के बीच जाएँ। काउंटर संदेशों को गिनाता है; प्रत्येक संदेश में पहला मिलते-जुलता वाक्यांश हाइलाइट होता है। एस्केप खोज को साफ़ कर देता है।

खोज आसपास की बातचीत, सहेजी गई फ़ाइलों और हटाने की सूचनाओं को दिखाई देती रखती है। यह पैनल में पहले से लोड किए गए रिकॉर्ड्स को खोजती है। जब पुराने रिकॉर्ड्स मौजूद रहते हैं, तो पैनल यह बताता है; पुराने रिकॉर्ड लोड करने से इतिहास बढ़ जाता है और वर्तमान संदेश को वहीं रखकर खोज परिणामों को अपडेट करता है।

जब आप एक ही वर्कस्पेस के भीतर स्विच करते हैं तो प्रत्येक चैट अपनी खोज बनाए रखता है। पैनल को लॉक करने या वर्कस्पेस बदलने पर वे खोजें साफ़ हो जाती हैं। खोज शब्द पेज की मेमोरी में रहते हैं और ब्राउज़र स्टोरेज में संग्रहीत नहीं होते हैं या API क्वेरीज़ के रूप में नहीं भेजे जाते हैं। खोजने से टेलीग्राम संदेश नहीं भेजे जाते हैं या टाइपिंग/पढ़ने के नोटिस नहीं भेजे जाते हैं। मौजूदा दृश्यता सेटिंग्स अभी भी एक चैट खोलने और अन्य क्रियाओं को नियंत्रित करती हैं।

बिल्ड रिपोर्ट, चयनित चैट का रिपोर्ट स्कोप बनाए रखती है; एक डिस्प्ले सर्च निर्यात किए गए रिकॉर्ड्स को चुपचाप प्रतिबंधित नहीं करता है। रिपोर्ट को डाउनलोड करने से पहले उसकी चयनित सामग्री का पूर्वावलोकन करें।

स्थायित्व और इंटरैक्शन नियंत्रण#

एकीकृत कार्यान्वयन डुप्लिकेट का पता लगाने के लिए टिकाऊ जर्नल लुकअप का उपयोग करता है, असफल डाउनलोड के बाद अटैचमेंट जॉब्स को लंबित रखता है, और अन्य रिमोट एक्शन की तरह ही इंटरैक्शन गार्ड के माध्यम से क्लोजिंग को राउट करता है। ये ऐतिहासिक 6 नवंबर विकास-स्नैपशॉट ऑडिट में रिपोर्ट किए गए तीन पथों को प्रतिस्थापित करते हैं।

जिन डीक्रिप्ट किए गए संदेशों का जर्नल लिखने का प्रयास विफल हो जाता है, उन्हें दोबारा प्रयास के लिए वॉल्ट में रखा जाता है। अटैचमेंट का आकार और फ्री-डिस्क की जाँच, उनके जॉब्स को बनाए रखते हुए डाउनलोड को टाल देती हैं। यह मॉड्यूल खाते के मौजूदा कनेक्शन का पुन: उपयोग करता है। पढ़ने और टाइप करने की सूचनाएँ केवल 'दूसरी तरफ क्या दिखता है' के तहत चुने अनुसार भेजी जाती हैं; स्क्रीनशॉट सूचनाएँ कभी नहीं भेजी जाती हैं। secret_chats.py, API रूट्स और एक्सेस पॉलिसी देखें।

ऐतिहासिक ऑडिट अपने मूल स्नैपशॉट निष्कर्षों को बरकरार रखता है। वर्तमान उपलब्धता और कार्यान्वयन को ऊपर दिए गए पैकेज संशोधन और वर्तमान क्षमताओं से पढ़ा जाना चाहिए।

इंटरफ़ेस प्रदर्शन#

वेबसाइट परिदृश्य पैनल वर्कफ़्लो को प्रदर्शित करने के लिए काल्पनिक अनुरोधों, संदेशों और फ़ाइलों का उपयोग करता है। यह एक इंटरफ़ेस का उदाहरण है; प्रोटोकॉल और अधिग्रहण जाँचों के अपने तिथित परिणाम सत्यापन रिकॉर्ड में होते हैं।