# Telegram · گفتگوهای مخفی: راه‌اندازی و ثبت

Canonical page: https://phishdestroy.io/tgwitness/fa/docs/reference/secret-chats/

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

[Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/)

[Documentation index](https://phishdestroy.io/tgwitness/fa/llms.txt)

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

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [مستندسازی](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md)

برنامه منتشر شده شامل بک‌اند چت مخفی، یکپارچه‌سازی کالکتور، مسیرهای API و **شبه‌مخفی** رابط. کتابخانه پروتکل یک ماژول جداگانه است: open **شبه‌مخفی** و فشار دهید **نصب و روشن کردن**پذیرش خودکار ورودی تا زمانی که آن را فعال نکنید، غیرفعال است.

## ماژول پروتکل

|  |  |
| --- | --- |
| ماژول | `kiaro-telethon-secret-chat` 0.2.0 |
| نویسنده | کیاروساما |
| مجوز | GPL-3.0-یا-بعدی؛ آن `LICENSE` و `NOTICE` در داخل آرشیو ذخیره شده باقی بمانید |
| منبع | [کیاروساما/تله‌تون-گفتگوی-مخفی](https://github.com/KiaroSama/Telethon-Secret-Chat) در commit `d87bf037b90060383c7b704d8a06ebb98c621c6f` |
| بررسی | SHA-256 `c80feb9b5bc28201677c140d20930fbd730d7efdebb8ca789a19040c3f00ce5c` بر روی فهرست فایل‌های بسته و مقادیر SHA-256 خودشان |

**نصب و فعال‌سازی** برای ادمین اصلی در دسترس است. TgWitness آرشیو سورس آن کامیت را از طریق مسیر workspace برای درخواست‌های خارج از تلگرام از گیت‌هاب دانلود می‌کند، هر فایل بسته را با مقدار تثبیت‌شده در نسخه TgWitness مقایسه می‌کند و آرشیو را به عنوان `modules/telethon-secret-chat-<commit>.zip` در زیرپوشه data ذخیره می‌کند و کد را از حافظه بارگذاری می‌کند. نیازی به راه‌اندازی مجدد نیست. این بررسی در هر بار راه‌اندازی مجدد دوباره اجرا می‌شود؛ آرشیوی که متفاوت باشد بارگذاری نمی‌شود و صفحه این موضوع را اعلام می‌کند. یک فایل پکیج تغییر یافته، گم‌شده یا اضافه شده، بررسی را ناموفق می‌کند.

این ماژول یک اثر مستقل تحت مجوز خود است. TgWitness آن را توزیع نمی‌کند: هر نصب آن را از مخزن نویسنده‌اش دانلود می‌کند. **جزئیات** در صفحه، ماژول بارگذاری‌شده، نویسنده، مجوز، کامیت و SHA-256 آن را نشان می‌دهد.

یک میزبان که به گیت‌هاب دسترسی ندارد، می‌تواند همان کامیت را در محیط پایتون نصب کند؛ سپس پنل از آن نسخهٔ کپی‌شده استفاده می‌کند:

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

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

## دسترسی بسته

رو 8 نوامبر 2026، بسته نصبی منتشر شده در منبع بررسی شد. [`b35f8e18f3d1`](https://github.com/phishdestroy/TgWitness/commit/b35f8e18f3d13c329af12e0036f50e0c8f340a2c)، انتشار `b35f8e18f3d1-1ff85ec98bb2`، نسخه 0.9.1 پیش‌نمایش. The [چرخ ثابت](https://get.destroy.tools/releases/b35f8e18f3d1-1ff85ec98bb2/tgwitness-0.9.1-py3-none-any.whl) و قفل وابستگی آن از SHA-256 و تأیید امضای نسخه‌ی RSA. پشت‌زمینه و رابط بسته‌بندی‌شده با آن بازنگری منبع بایت به بایت مطابقت داشت. این بسته همچنین شامل ثبت API و قلاب‌های گردآورنده است.

آن بسته شامل کتابخانه پروتکل نبود و در قفل وابستگی نیز وجود ندارد. `secret-chats` extra در [فایل pyproject.toml](https://github.com/phishdestroy/TgWitness/blob/main/pyproject.toml) همان commit مربوط به دکمه پنل را پین می‌کند.

بازرسی این بسته مشخص می‌کند که کدام فایل‌ها و اعلان‌های وابستگی همراه آن ارسال می‌شوند. [سوابق اعتبارسنجی](https://phishdestroy.io/tgwitness/fa/docs/reference/verification/)، بررسی‌های جداگانه زمان اجرا را شناسایی می‌کنند. راهنمای قبلی مورخ 6 نوامبر، یک اسنپ‌شات توسعه را توصیف می‌کرد؛ این راهنما دیگر بسته فوق را توصیف نمی‌کند.

## از رابط کاربری استفاده کنید

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

| اقدام | نتیجهٔ حفظ‌شده |
| --- | --- |
| شروع گفتگو با نام کاربری یا شناسهٔ کاربر | درخواست خروجی؛ همتا آن را روی دستگاه خود می‌پذیرد. |
| قبول درخواست | TgWitness به نقطه پایانی دریافت‌کننده تبدیل می‌شود. |
| ارسال یا دریافت یک پیام | `secret_chat.message` با جهت، محتوا و تایمر ارائه‌شده آن. |
| دریافت یک فایل | بایت‌های رمزگشایی‌شده که توسط SHA-256 و رسید `secret_chat.file` ذخیره شده‌اند؛ در خروجی شواهد گنجانده شده‌اند. |
| دریافت اعلان تایمر یا حذف | یک رکورد اقدام جداگانه در کنار پیام‌ها و فایل‌های نگهداری‌شده. |
| چت را بازبینی کنید | گفتگو، رسیدهای فایل، اعلان‌ها و نمایش بصری کلید. |

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

## پیام‌های ذخیره‌شده را پیدا کنید

برای یافتن یک عبارت دقیق، به صورت حروف بزرگ و کوچک یکسان، از **جستجوی پیام‌ها** در یک چت باز استفاده کنید. **دکمه‌های قبلی** و **بعدی**، یا دکمه‌های Enter و Shift+Enter در کادر جستجو، شما را بین پیام‌های مطابقت‌دهنده جابجا می‌کنند. شمارشگر، پیام‌ها را می‌شمارد؛ اولین عبارت مطابقت‌دهنده در هر پیام برجسته می‌شود. کلید Esc جستجو را پاک می‌کند.

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

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

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

## کنترل‌های پایداری و تعامل

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

پیام‌های رمزگشایی‌شده‌ای که نوشتن ژورنالشان با شکست مواجه می‌شود، برای تلاش مجدد در گاوصندوق نگهداری می‌شوند. دانلودها با بررسی اندازه پیوست و فضای آزاد دیسک به تعویق می‌افتند، در حالی که کارهای مربوط به آنها حفظ می‌شوند. این ماژول از اتصال موجود حساب کاربری دوباره استفاده می‌کند. اعلان‌های خواندن و تایپ فقط طبق تنظیمات بخش [آنچه طرف مقابل می‌بیند](https://github.com/phishdestroy/TgWitness/blob/main/docs/INVESTIGATION-MODE.md#what-the-other-side-sees) ارسال می‌شوند؛ اعلان‌های اسکرین‌شات هرگز ارسال نمی‌شوند. به [secret_chats.py](https://github.com/phishdestroy/TgWitness/blob/main/tgwitness/secret_chats.py)، [مسیرهای API](https://github.com/phishdestroy/TgWitness/blob/main/tgwitness/api/secret_chats.py) و [سیاست دسترسی](https://github.com/phishdestroy/TgWitness/blob/main/tgwitness/access.py) مراجعه کنید.

[بازرسی تاریخی](https://github.com/phishdestroy/TgWitness/blob/main/website/validation/audit/REPORT.md) یافته‌های اسنپ‌شات اصلی خود را حفظ می‌کند. در دسترس بودن و پیاده‌سازی فعلی باید از روی بازنگری بسته فوق و [قابلیت‌های فعلی](https://github.com/phishdestroy/TgWitness/blob/main/docs/STATUS.md) خوانده شود.

## نمایش رابط کاربری

سناریوی وب‌سایت از درخواست‌ها، پیام‌ها و فایل‌های فرضی برای نمایش گردش کار پنل استفاده می‌کند. این یک مثال از رابط کاربری است؛ بررسی‌های پروتکل و اکتساب، نتایج تاریخ‌دار خود را در رکورد اعتبارسنجی دارند.
