TgWitness / مستندسازی

آنچه آزمایش شده است ←

منبع / راه‌اندازی

TgWitness: Telegram Export, OSINT & Verification

با یک دستور نصب شود یا در GitHub Actions اجرا گردد. گزینه‌های تحقیق، مقیاس منتشرشده و آنچه یک آرشیو تأیید می‌کند را درک کنید.

TgWitness یک ابزار خروجی‌گیرنده تلگرام متن‌باز و محیط کاری تحقیقاتی است. آن را با یک دستور نصب کنید، یک حساب کاربری را متصل کنید، چت‌ها را انتخاب کرده و یک آرشیو امضا‌شده را صادر کنید. این ابزار همچنین از جمع‌آوری موقت در GitHub Actions و ادامه تحقیقات با ویرایش‌های ذخیره شده، مشاهده‌های حذف‌شده، جستجو و گزارش‌ها پشتیبانی می‌کند.

با کاری که در اختیار دارید شروع کنید#

وظیفه شما کوتاه‌ترین مسیر آنچه دریافت می‌کنید
ذخیره یک گفتگو یا حساب کاربری نصب، اتصال حساب کاربری، انتخاب دامنهٔ خروجی یک آرشیو امضا شده شامل تاریخچهٔ منتخب، نتایج جمع‌آوری و مواد تأیید
روی یک راه‌‌انداز موقت جمع‌آوری کنید از GitHub Actions برای ضبط استفاده کنید، یک جلسهٔ جدید را مجاز کنید و دامنه را انتخاب کنید یک آرشیو رمزگذاری‌شده با سوابق گردش کار گیت‌هاب
تغییرات را در طول زمان دنبال کنید نظارت را برای چت‌های منتخب فعال نگه دارید نسخه‌های ذخیره شده، اعلان‌های حذف، پیوست‌ها و پوشش ثبت‌شده
تحقیق کنید و یافته‌ها را به اشتراک بگذارید در آرشیو جستجو کنید، از Case Board استفاده کنید و یک گزارش یا نسخه اشتراک‌گذاری را پیکربندی کنید یافته‌های مرتبط با منبع و انتقال قابل راستی‌آزمایی مناسب برای دریافت‌کننده

نصب با یک دستور#

نصب‌کننده شامل پایتون و وابستگی‌ها است. خروجی گرفتن از سورس، داکر، یک ارائه‌دهنده هوش مصنوعی و یک شاهد مستقل گزینه‌های اختیاری هستند، نه پیش‌نیازهای راه‌اندازی.

لینوکس / مک‌اواس:

curl -fsSL https://get.destroy.tools/install.sh | bash

ویندوز، در پاورشل یا Command Prompt:

powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "irm https://get.destroy.tools/install.ps1 | iex"

پنل را باز کنید، حساب تلگرام خود را متصل کنید و دامنه جمع‌آوری را انتخاب کنید. نصب به خودی خود جمع‌آوری را آغاز نمی‌کند. راهنمای نصب ، دسترسی محلی، سرورها، به‌روزرسانی‌ها و بررسی نسخه دانلود شده را توضیح می‌دهد.

برای یک اجرای موقت، راهنمای GitHub Actions را دنبال کنید. آن گردش کار به یک فورک گیت‌هاب، احراز هویت و یک رمز عبور بایگانی نیاز دارد. صفحه ضبط این مراحل و بودجه زمانی جلسه را پیش از اجرا توضیح می‌دهد. فایل بایگانی حاصل را دانلود و نگهداری کنید و همچنین مواد تأیید اعتبار آن را نیز نگه دارید.

تنظیمات بیشتر زمانی که وظیفه به آن‌ها نیاز دارد#

خروجی‌گیری یک چت واحد به یک حساب کاربری و یک دامنه انتخابی نیاز دارد. ادامه مشاهده، حساب‌های کاربری متعدد، پروکسی‌ها، سیاست‌های پیوست، طراحی گزارش، دسترسی بازبین، مهرهای زمانی خارجی و ذخیره‌سازی خارج از محل برای نیازهای مختلف تحقیق و تحویل مورد استفاده قرار می‌گیرند. این ویژگی‌ها را در صورت لزوم پیکربندی کنید.

دامنه، مجوزها و نسخه‌های اشتراک‌گذاری بهینه‌شده به اپراتورها کمک می‌کنند تا انتخاب کنند چه چیزی را جمع‌آوری و افشا کنند. راهنمایی‌های حوزه قضایی و تنظیمات گزارش، رویه و مراحل آماده‌سازی انتخاب‌شده را ثبت می‌کنند. به بخش‌های خروجی‌گیری حساب، دسترسی و پیکربندی گزارش مراجعه کنید.

این برنامه روی رایانه یا سرور انتخاب‌شده اجرا می‌شود. جمع‌آوری پایه به GPU یا LLM نیاز ندارد. OCR، رونویسی و تحلیل هوش مصنوعی اختیاری، نیازمندی‌های منابعی خاص خود را دارند. اندازه استقرار را بر اساس نرخ پیام، پیوست‌ها، تاریخچه نگهداری‌شده و حساب‌های همزمان تعیین کنید.

سوابق را حفظ کنید، هر کسی را که به نفعش است#

هدف، حفظ مواد مشاهده‌شده، زمینه و تغییرات است، صرف‌نظر از اینکه از موضع چه کسی حمایت می‌کنند. شواهد ممکن است روایت خود گردآورنده از رویدادها را به چالش بکشد. مشاهدات منبع، پوشش ناقص و نتیجه‌گیری‌های تحلیلی را قابل شناسایی نگه دارید تا شخص دیگری بتواند همان مواد را ارزیابی کند.

منطق به این صورت است: مشاهده قابل مشاهده برای حساب کاربری → دفترچه یادداشت امضا شده → خروجی‌گیری → بررسی گیرنده. ویرایش‌های ذخیره شده، نسخه‌ها را اضافه می‌کنند. مشاهده‌های حذف شده، محتوای قبلاً ضبط شده را حفظ می‌کنند. سوابق پوشش، وقفه‌های شناخته‌شده را آشکار می‌سازند. گزارش‌ها و تحلیل‌های هوش مصنوعی به منابع ذخیره شده ارجاع می‌دهند؛ یک تفسیر صرفاً به این دلیل که در یک گزارش امضا شده ظاهر می‌شود، به یک مشاهده منبع تبدیل نمی‌شود.

بررسی اعتبارسنجی آنچه دریافت‌کننده می‌تواند اثبات کند
هش‌های فایل، امضاها و زنجیره ژورنال سوابق و فایل‌های ارائه‌شده با مرزهای کلید و ژورنال مورد انتظار مطابقت دارند
یک نقطهٔ کنترل یا شاهد جداگانهٔ نگهداری‌شده آرشیو با وضعیت ژورنال پیش‌تر نگهداری‌شده مطابقت دارد
یک مهر زمانی خارجی تأییدشده بایت‌های مرجع در زمان‌مهر تحت فرضیات اعتماد بیان‌شده وجود داشتند.
تأیید اسکرین‌شات گیت‌هاب آرشیو باید با گردش کار تأییدشده، بازنگری گردآورنده و هَش ثبت‌شده مطابقت داشته باشد.
تأییدیه Intel TDX نقل قول، وضعیت پلتفرم، اندازه‌گیری‌های مورد انتظار سیستم‌عامل/برنامه، تازگی و هویت گردآورنده، بررسی‌های پیکربندی‌شده خود را پشت سر می‌گذارند.

در اکتساب تصدیق‌شده، اتصال احراز هویت‌شده تلگرام و خروجی گردآورنده تأییدشده به محیط اجرای بررسی‌شده متصل می‌شود. آرشیو، محتوای ضبط‌شده و زمینه را حفظ می‌کند؛ گزارش‌ها و تحلیل‌ها به آن سوابق ارجاع می‌دهند. از مراحل تأیید خاص حالت و ورودی‌های مورد اعتماد در راهنمای اعتماد و قالب مدرک استفاده کنید.

مقیاس منتشرشده و عملکرد اندازه‌گیری‌شده#

نتایج زیر بارهای کاری و تاریخ‌های مختلف را توصیف می‌کنند. شمارش‌ها قابل تعویض نیستند: یک رویداد دفترچه خاطرات لزوماً یک پیام منحصربه‌فرد تلگرام نیست.

تاریخ بار کاری نتیجهٔ منتشرشده آنچه اندازه‌گیری شد
1 نوامبر 2026 اجرای سرور، ده پایگاه‌داده فضای کاری 1,610,818 رکورد دفترچه یادداشت؛ 900,232 رویداد پیام جدید، 80,683 رویداد ویرایش و 400,536 رویداد حذف فهرست قابل‌خواندن‌تنها از ژورنال‌های ذخیره‌شده
5 نوامبر 2026 جستجو در بیش از 1,000,000 پیام مصنوعی در 200 چت فهرست در 71ثانیه ساخته شد؛ زمان جستجوی میانه برای هر پرس‌وجو بین 9تا 190میلی‌ثانیه معیار سنجش جستجوی محلی
6 نوامبر 2026 دو خروجی جدید واقعی تلگرام پیام‌های 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 به مدت حدود شش ماه توسعه و آزمایش شده است. جمع‌آورنده، دفترچه یادداشت امضا شده و اعتبارسنج ابتدا ساخته شدند؛ پنل وب و ماژول‌های افزایشی بعداً بر اساس آن‌ها ساخته شدند. این مخزن در تاریخ ۲۹ اکتبر ۲۰۲۶ برای انتشار ایجاد شد و با کد موجود آغاز به کار کرد، بنابراین سن آن معادل سن پروژه (تاریخچه توسعه) نیست. حجم کاری انباشته اجرا شده در حدود ۱۰۰ میلیون است که شامل اجراهای قبلی، خطاها، اصلاحات و اعتبارسنجی‌های مکرر می‌شود. اجراهای منتخب، که هر کدام دارای بازنگری، روش و نتیجه خاص خود هستند، در اندازه‌گیری‌های عمومی تاریخ‌دار مستندسازی شده‌اند.

وضعیت قابلیت را دقیقاً بخوانید#

هر گردش کار را بر اساس پیاده‌سازی، نسخه منتشر شده و تست‌های ضبط‌شده آن ارزیابی کنید. سورس در حال حاضر برچسب پیش‌نمایش (preview) دارد. این برچسب نسخه در کنار مجموعه کاری، خروجی‌ها، تأیید مستقل و اندازه‌گیری‌های مقیاس منتشر شده وجود دارد. یک ویژگی پیش‌نمایش و یک گردش کار معتبر می‌توانند در یک برنامه واحد وجود داشته باشند؛ ویژگی خاص و شواهد پشت یک ارزیابی را توصیف کنید.

استفاده کنید توانایی‌های فعلی, ویژگی‌ها و محدودیت‌ها, تأیید و فهرست تغییرات با هم. هنگام استناد به یک نتیجه، نسخهٔ آزمایش‌شده را ثبت کنید. 6 اسکرین‌شات اندازه‌گیری نوامبر همچنین تست‌های ناموفق و ردشده را نیز حفظ می‌کند؛ این‌ها موفقیت محسوب نمی‌شوند.

قابل خواندن توسط انسان‌ها و ابزارهای هوش مصنوعی#

این وب‌سایت یک فایل مختصر llms.txt، یک کتاب راهنمای کامل انگلیسی در llms-full.txt و llms-full.md، و نسخه‌های مارک‌داون صفحات آن را ارائه می‌دهد. این‌ها فرمت‌های مستندسازی هستند، نه یک الزام هوش مصنوعی برای اجرای TgWitness.

اختیاری MCP و دسترسی خط فرمان ابزارهای مجاز را قادر به خواندن سوابق منتخب ذخیره‌شده می‌سازد. محتوای پیام همچنان ورودی غیرقابل اعتماد باقی می‌ماند. خلاصه‌ها باید به منابع ارجاع دهند، حقایق مشاهده‌شده را از استنتاج متمایز کنند و عدم قطعیت را حفظ نمایند. جستجوی تمام متن، OCR و خروجی هوش مصنوعی مشاهدات اصلی امضا‌شده را تغییر نمی‌دهند.