विशेषताएँ और सीमाएँ

डिज़ाइन संदर्भ: 26 अक्टूबर 2026। इसका प्राथमिक उपयोग निजी टेलीग्राम समूहों और चैनलों के लिए है, जो जुड़े खातों के लिए सुलभ हैं। यह दस्तावेज़ लागू किए गए व्यवहार, प्लेटफ़ॉर्म की सीमाओं और भविष्य के कार्य को अलग करता है। एक लक्षित आर्किटेक्चर आइटम का मतलब यह दावा नहीं है कि वह सुविधा पहले से मौजूद है।

स्वतंत्र एप्लिकेशन#

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

ऑपरेटर अपने खातों को जोड़ता है, प्रत्येक के लिए दिखाई देने वाले स्रोतों को चुनता है, और एक सहेजा गया अवलोकन जर्नल प्राप्त करता है। पैनल सामग्री, सहेजी गई परिवर्तन, अवलोकन उत्पत्ति और ज्ञात अंतरालों को प्रदर्शित करता है। एक अन्य जांचकर्ता निर्यात की गई सामग्री को सत्यापित कर सकता है।

चार विशिष्ट अवस्थाएँ मायने रखती हैं: खाते की प्राधिकृति, किसी स्रोत तक पहुँच, एक कार्यशील कलेक्टर, और जिस हद तक डिलीवरी की पूर्णता स्थापित होती है। पहले तीन में से कोई भी स्वचालित रूप से चौथे को साबित नहीं करता है। एक शांत समूह जरूरी नहीं कि एक असफल कलेक्टर हो।

साझा जांचें#

एक प्रशासक कार्यक्षेत्रों और व्यक्तिगत चैट तक सीमित एक्सेस टोकन जारी कर सकता है, जिसमें सात अनुमतियाँ, आईपी प्रतिबंध, समाप्ति, साइन-इन सीमाएँ और सत्र नियंत्रण शामिल हैं। एक केवल-पढ़ने वाला समीक्षक टेलीग्राम प्राधिकरण या मुख्य पैनल कुंजी प्राप्त किए बिना एक मामले की जाँच कर सकता है। चैट-सीमित पहुँच खाता-व्यापी सेटिंग्स और पूर्ण-जर्नल एक्सपोर्ट से अलग रहती है।

ऑटोमेटिक MTProxy चार सार्वजनिक स्रोतों या एक ऑपरेटर कैटलॉग से Telegram के काम करने वाले राउट्स को बनाए रखता है। आईपी मोड यह निर्धारित करते हैं कि विफलता को किसी अन्य प्रॉक्सी का इंतज़ार करना चाहिए या वह स्पष्ट रूप से अनुमत प्रत्यक्ष राउट का उपयोग कर सकती है। बाहरी HTTP अनुरोधों के लिए एक अलग राउट और ऑफ स्विच होता है।

आर्काइव उपकरण#

वर्तमान main में इतिहास अधिग्रहण, आर्काइव खोज और विश्लेषण, केवल-पठन MCP, स्थानीय OCR/प्रतिलेखन और आउटगोइंग वेबहुक्स जोड़े गए हैं। ये स्रोत-चेकआउट सुविधाएँ हैं, जिन्हें 0.7.0 पोर्टेबल पूर्वावलोकन के बाद जोड़ा गया है। विश्लेषणात्मक रिपोर्ट और पहचाना गया पाठ कैप्चर की गई घटनाओं से अलग रहते हैं।

वैकल्पिक अतिरिक्त#

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

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

प्रोटोकॉल और निजी स्रोत#

MTProto टेलीग्राम का प्रोटोकॉल है; टेलीथॉन वह पाइथन लाइब्रेरी है जिसका उपयोग TgWitness MTProto से संवाद करने के लिए करता है। वे वैकल्पिक कनेक्शन विधियाँ नहीं हैं। कलेक्शन MTProto का उपयोग करता है; वैकल्पिक विटनेस Bot API के माध्यम से हस्ताक्षरित चेक्स प्रकाशित करता है।

प्रत्येक वर्कस्पेस की अपनी अधिकृत क्लाइंट और खाता अपडेट स्ट्रीम होती है। TgWitness कॉन्फ़िगर किए गए स्रोतों से अवलोकन चुनता है और इतिहास स्नैपशॉट और मीडिया डाउनलोड जैसे कार्यों के लिए अलग-अलग स्पष्ट अनुरोध करता है।

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

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

स्रोत की दृश्यता कलेक्टर शुरू होने पर जाँची जाती है। बाउंड किए गए डायलॉग के परिणाम से किसी स्रोत के गायब होने का मतलब है कि पहुँच की पुष्टि नहीं हुई है, न कि हटाए जाने का प्रमाण मिला है। एक अनुपलब्ध स्रोत अन्य सुलभ स्रोतों को देखने से नहीं रोकता। सार्वजनिक स्थानों पर कभी भी निमंत्रण लिंक या वास्तविक सत्र न रखें।

कई खाते#

यह पैनल किसी भी संख्या में वर्कस्पेस का समर्थन करता है, प्रत्येक के साथ अपना:

• अधिकृतकरण, एन्क्रिप्टेड वॉल्ट और कनेक्शन मार्ग।
• SQLite जर्नल और Ed25519 हस्ताक्षर पहचान।
• चयनित स्रोत, मीडिया कतार और कैप्चर सेटिंग्स।
• अवलोकन स्थिति, त्रुटियाँ, चेकपॉइंट्स और निर्यात।

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

कोई निश्चित संख्या नहीं है और कोई मापी गई थ्रूपुट गारंटी नहीं है। वर्कस्पेस एक पाइथन प्रक्रिया और इवेंट लूप साझा करते हैं। अलग खाते के वर्कर्स भविष्य का काम हैं। वर्तमान प्रक्रिया पृथक्करण के लिए, अलग इंस्टॉलेशन, पोर्ट और डेटा डायरेक्टरी का उपयोग करें।

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

कब्ज़ा और श्रेय#

सोर्सेज नए संदेशों, संपादन, हटाने, प्रतिक्रियाओं और सदस्यता के लिए प्रति-खाते स्विच प्रदान करता है। प्रीसेट या तो सभी श्रेणियों को या संदेश/संपादन/हटाने को बनाए रखते हैं। यह नीति कार्यक्षेत्र के चयनित समूहों पर लागू होती है, रीस्टार्ट होने पर भी बनी रहती है, और बदलावों से पहले/बाद के साथ हस्ताक्षरित होती है। डिफ़ॉल्ट सभी श्रेणियों को संरक्षित करते हैं। किसी श्रेणी को बंद करने पर पुराने रिकॉर्ड नहीं मिटते; इसे वापस चालू करने पर छूटी हुई घटनाएं फिर से नहीं बनती हैं। परिचालन रिकॉर्ड, अन्य समूह सेवा घटनाएं और स्पष्ट इतिहास स्नैपशॉट अलग होते हैं। कैप्चर किए गए टेलीग्राम ऑब्जेक्ट्स अलग-अपडेट स्विच की परवाह किए बिना एम्बेडेड मेटाडेटा बनाए रख सकते हैं। अभी तक प्रति-समूह श्रेणी ओवरराइड नहीं हैं।

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

क्षमता और टेलीग्राम सीमाएँ#

निश्चित गुणवत्ता के साथ निगरानी के लिए चैट्स की कोई सार्वभौमिक संख्या नहीं है। क्षमता प्रति सेकंड पीक इवेंट्स, अटैचमेंट की मात्रा और आकार, अतिरिक्त RPCs, सक्रिय खातों, डिस्क लेटेंसी/खाली जगह, नेटवर्क की स्थितियों, टेलीग्राम की सीमाओं, स्वीकार्य लैग और कतार की गहराई पर निर्भर करती है।

टेलीग्राम निष्क्रिय डिलीवरी को सक्रिय शॉर्ट पोलिंग से अलग करता है। इसका अपडेट दस्तावेज़ीकरण ओपन चैनलों/सुपरग्रुप्स के लिए अतिरिक्त updates.getChannelDifference कॉल्स का वर्णन करता है और अधिकतम दस एक साथ शॉर्ट-पोल किए गए स्रोतों की सिफारिश करता है। यह दस चुने हुए समूहों की सीमा या पूर्णता की गारंटी नहीं है।

फ्लडवेट (FloodWait) को अनदेखा करना या अतिरिक्त खातों से रैखिक क्षमता मान लेना, एक मनमाना उच्च-आवृत्ति वाला पोलिंग करना कोई वैध आकार-निर्धारण मॉडल नहीं है। डिफ़ॉल्ट सीमाएँ हैं: सूचीबद्ध पहले 1,000 डायलॉग, प्रति इतिहास स्नैपशॉट 500 संदेश तक, प्रकार के अनुसार प्रति एकत्रित फ़ाइल 1–2,000 MiB, और 4 GiB असंकुचित हस्ताक्षरित ज़िप सामग्री; प्रत्येक को पैरामीटर के तहत प्रति कार्यक्षेत्र बदला जा सकता है। एक्सपोर्ट्स पर कोई निश्चित इवेंट-गिनती सीमा नहीं है। ब्राउज़र फ़ॉलबैक डिफ़ॉल्ट रूप से 128 MiB तक सीमित है; स्ट्रीमिंग CLI की एक कॉन्फ़िगर करने योग्य ट्रांसफर सीमा है, जो डिफ़ॉल्ट रूप से 5 GiB है।

tools/check_capacity.py स्थानीय सिंथेटिक इनजेस्टन और एक्सपोर्ट को मापता है। इसके परिणाम टेलीग्राम डिलीवरी माप या एक गारंटीकृत वास्तविक-चैट काउंट नहीं हैं। मापे गए संस्करण और वर्कलोड के लिए VERIFICATION.md देखें।

विश्वसनीयता और पुनर्प्राप्ति#

लागू किए गए व्यवहार में SQLite WAL/समकालिक लेनदेन; परमाणु संदेश और मीडिया-जॉब राइट्स; स्थायी जॉब और पुनः प्रयास विलंब; मूल-संस्करण डिस्क्रिप्टर; सीमित पुनः प्रयास; संग्रहीत मीडिया फ्लडवेट; टेक्स्ट इवेंट के नेटवर्क वेट के बाहर मीडिया डाउनलोड; बाद में लिखने का काम जारी रहते हुए स्थिर-पूर्वसंधान एक्सपोर्ट; परमाण्विक सेटिंग्स और ऑडिट रिकॉर्ड; असफल प्रतिस्थापन लॉगिन के बाद काम कर रहे प्राधिकरण का संरक्षण; एक क्षतिग्रस्त अतिरिक्त कार्यक्षेत्र का पृथक्करण; स्पष्ट पुनः-कनेक्ट प्रयास; अलग अधिकृतता-हानि रिपोर्टिंग; और एक मोनोटोनिक घड़ी का उपयोग करके वॉल-क्लॉक परिवर्तन का पता लगाना।

खाता और चैनल pts/qts/seq पुनरारंभ के बाद सहेजे और फिर से शुरू किए जाते हैं, और देखी गई चैट्स की समय-समय पर पुनः जाँच की जाती है; प्रमाण प्रारूप देखें। समय-समय पर स्थिति सहेजना जर्नल स्वीकृति की एक परमाणु, बिना-हानि वाली पावती नहीं है।

प्रत्येक प्रक्रिया की शुरुआत में पिछले हेडर और ऑफ़लाइन सीमा को रिकॉर्ड किया जाता है। वर्तमान इतिहास को गैप मरम्मत के रूप में नहीं माना जाता है। टेलीग्राम का अंतर प्रतिधारण सीमित है; differenceTooLong सभी गायब सामग्री का पुनर्निर्माण नहीं कर सकता। अपूरणीय अंतराल स्पष्ट रूप से बने रहना चाहिए, भले ही बाद का इतिहास स्नैपशॉट सफल हो जाए।

साक्ष्य मॉडल#

प्रत्येक इवेंट एक अनुक्रम, स्थानीय UTC अवलोकन समय, स्रोत समय (यदि प्रदान किया गया हो), प्रकार, स्रोत, कर्ता (यदि प्रदान किया गया हो), मूल पेलोड, पिछला हैश और हस्ताक्षर को रिकॉर्ड करता है। संदेश अवलोकन में कलेक्टर खाता/रन संदर्भ भी बनाए रखा जाता है।

हस्ताक्षरित प्रक्रिया रसीद में एक यादृच्छिक रन आईडी; TgWitness/Python/OS/निर्भरता संस्करण; स्रोत-फ़ाइल SHA-256 मान और समग्र फिंगरप्रिंट; प्रारंभिक खाता, दायरा और सेटिंग्स; UTC/मोनोटोनिक रीडिंग्स; और पिछला जर्नल हेड शामिल होता है। सेटिंग्स में बदलाव, स्टार्ट/स्टॉप और त्रुटियाँ एक ही जर्नल में दर्ज होती हैं। चेकपॉइंट्स स्टार्टअप पर, ऑब्ज़र्व करते समय हर पांच मिनट पर (बदलने योग्य), और व्यवस्थित रूप से बंद करने पर बनाए रखे जाते हैं। एक बनाए रखा गया स्थानीय चेकपॉइंट पहले के जर्नल प्रीफ़िक्स पर रोलबैक का पता लगा सकता है।

RFC 3161 अनुरोध तैयारी और OpenSSL प्रतिक्रिया सत्यापन लागू किए गए हैं। स्वचालित सबमिशन लागू नहीं है। मशीन के समय को वहन करने वाला कोई अनुरोध या स्थानीय हस्ताक्षर एक स्वतंत्र टाइमस्टैम्प नहीं है। TIMESTAMP.md देखें।

एक ऑपरेटर जो कलेक्टर और साइनिंग कुंजी को नियंत्रित कर रहा है, नए हस्ताक्षरित अवलोकन तैयार कर सकता है। हस्ताक्षर टेलीग्राम की उत्पत्ति, सत्य या स्वचालित कानूनी स्वीकार्यता स्थापित नहीं करते हैं। मजबूत हिरासत के लिए स्वतंत्र जांच चौकी/समय भंडारण, कुंजी पहुँच नियंत्रण, हस्तांतरण रिकॉर्ड और विश्वसनीय सॉफ़्टवेयर से सत्यापन की आवश्यकता होती है।

निर्यात, परिनियोजन और हस्तांतरण#

एक हस्ताक्षरित ज़िप में मूल JSONL, CSV, HTML, संरक्षित अटैचमेंट, हैश, एक हस्ताक्षरित मैनिफेस्ट और एक सुविधा सत्यापनकर्ता शामिल होता है। यह एक वर्कस्पेस और एक निश्चित पूर्ण जर्नल उपसर्ग को कवर करता है। पैनल खोज फ़िल्टर चुपचाप रिकॉर्ड नहीं हटाते हैं। गुप्त कुंजियाँ, टोकन और टेलीग्राम सत्र बाहर रखे जाते हैं; मूल अवलोकनों में अभी भी व्यक्तिगत जानकारी और टेलीग्राम मेटाडेटा हो सकता है।

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

ब्राउज़र इंटरफ़ेस स्थानीय रूप से Node.js, CDN या बाहरी फ़ॉन्ट के बिना आता है। एक ऑपरेटर टोकन इंस्टॉलेशन को नियंत्रित करता है। रिमोट एक्सेस के लिए HTTPS या एक SSH टनल की आवश्यकता होती है। नेटिव पाइथन और कंटेनर परिभाषाएँ प्रदान की जाती हैं, साथ ही deploy/ के तहत सेवा उदाहरण दिए गए हैं; निष्पादित प्लेटफ़ॉर्म जाँचें अलग से सूचीबद्ध हैं।

डिफ़ॉल्ट वर्कस्पेस डेटा रूट का उपयोग करता है; अतिरिक्त वर्कस्पेस profiles/<id>/ का उपयोग करते हैं। बैकअप के लिए एक रोकी गई प्रक्रिया और संपूर्ण डेटा/की सेट की आवश्यकता होती है। एविडेंस ज़िप्स एप्लिकेशन बैकअप नहीं हैं। सीक्रेट्स एक नई डेटा डायरेक्टरी के लिए एक बाहरी मास्टर की का उपयोग कर सकते हैं; जर्नल/मीडिया एन्क्रिप्शन ऑपरेटर की डिस्क/वॉल्यूम द्वारा प्रदान किया जाता है। CONNECTION-SECURITY.md और OPERATIONS.md देखें।

स्थिर रिलीज़ मानदंड#

स्थिर रिलीज़ से पहले, यह स्पष्ट करें:

1. वास्तविक निजी समूह, सुपरग्रुप्स, फोरम और चैनल जिनमें सदस्य/प्रशासक भूमिकाएँ और छिपी/दिखाई देने वाली इतिहास-सूचनाएँ होती हैं, जिसमें लॉगिन/2FA, रद्दीकरण और पहुँच हानि शामिल हैं।
2. ज्ञात कार्रवाइयों के विरुद्ध नियंत्रित संपादन, हटाव, प्रतिक्रियाएँ, सदस्यता और मीडिया।
3. प्रोसेस/होस्ट क्रैश, डिस्क विफलता/डिस्क पूर्ण, समाप्त हो चुके फ़ाइल संदर्भ, फ्लडवेट, नेटवर्क वियोग, दूषित फ़ाइलें और डेटाबेस रोलबैक।
4. मापे गए विलंब, कतारों, मेमोरी और डिस्क के साथ निरंतर बहु-खाता उपयोग, जिसमें शांत और शोरगुल वाले स्रोत दोनों शामिल हैं।
5. MTProto राज्य उन्नयन और जर्नल स्वीकृति के बीच रुकावट।
6. लक्षित OS/कंटेनर मैट्रिक्स पर स्वच्छ इंस्टॉलेशन और सत्यापित बैकअप पुनर्स्थापना।
7. सुरक्षा, हस्ताक्षरों और श्रेय/साक्ष्य दावों की स्वतंत्र समीक्षा।

एडमिन-लॉग पोलिंग, अतिरिक्त रिएक्टर सूचियाँ, प्राथमिकता पोलिंग, अलग वर्कर्स, एप्लिकेशन-व्यापी एन्क्रिप्शन भविष्य के कार्य बने हुए हैं। स्कोप्ड पैनल एक्सेस का वर्णन 'एक्सेस और परमिशन' में किया गया है। संस्करण 0.6, 'ACCOUNTS.md' में वर्णित बाउंडेड सिंगल-अकाउंट TData और अकाउंट-फ़ाइल आयात का समर्थन करता है। प्रकाशन से पहले टेलीग्राम एपीआई की शर्तों की समीक्षा करें। शोध संदर्भ और प्लेटफ़ॉर्म निष्कर्ष RESEARCH.md में हैं।