TgWitness / เอกสาร

สิ่งที่ได้รับการทดสอบแล้ว →

อ้างอิง / Collect

Telegram · การสนทนาลับ: การตั้งค่าและการบันทึก

ติดตั้งส่วนเสริมโปรโตคอลการสนทนาลับ เปิดใช้สำหรับแต่ละบัญชี และบันทึกการสนทนาที่ TgWitness สร้างหรือยอมรับ

TgWitness / เอกสารประกอบ

แอปพลิเคชันที่เผยแพร่แล้วนี้รวมถึงระบบหลังบ้านของ Secret Chat, การผสานรวมกับ collector, เส้นทาง API และอินเทอร์เฟซ Pseudo-secret ส่วนไลบรารีโปรโตคอลเป็นโมดูลแยกต่างหาก: เปิด Pseudo-secret แล้วกด Install และเปิดใช้งาน การรับข้อความเข้าอัตโนมัติ จะยังคงปิดอยู่จนกว่าคุณจะเปิดใช้งาน

โมดูลโปรโตคอล#

โมดูล kiaro-telethon-secret-chat 0.2.0
ผู้เขียน KiaroSama
ใบอนุญาต GPL-3.0 หรือเวอร์ชันที่ใหม่กว่า; ส่วน LICENSE และ NOTICE ยังคงอยู่ในไฟล์เก็บถาวรที่บันทึกไว้
แหล่งที่มา KiaroSama/Telethon-Secret-Chat ที่ commit d87bf037b90060383c7b704d8a06ebb98c621c6f
ตรวจสอบ SHA-256 c80feb9b5bc28201677c140d20930fbd730d7efdebb8ca789a19040c3f00ce5c บนรายการไฟล์แพ็กเกจและค่า SHA-256 ของแต่ละไฟล์

การติดตั้งและเปิดใช้งานเป็นสิทธิ์ของผู้ดูแลระบบหลัก TgWitness จะดาวน์โหลด ไฟล์อาร์ไคฟ์ต้นฉบับของคอมมิตนั้นจาก GitHub ผ่านเส้นทางของพื้นที่ทำงานสำหรับคำขอ จากภายนอก Telegram เปรียบเทียบทุกไฟล์ในแพ็กเกจกับค่าที่กำหนดไว้ใน เวอร์ชัน TgWitness ที่ปล่อยออกมา แล้วบันทึกไฟล์อาร์ไคฟ์เป็น modules/telethon-secret-chat-<commit>.zip ใน ไดเรกทอรีข้อมูล และโหลดโค้ดจากหน่วยความจำ ไม่จำเป็นต้องรีสตาร์ท ระบบจะตรวจสอบ อีกครั้งทุกครั้งที่เริ่มต้นระบบ; หากไฟล์อาร์ไคฟ์มีความแตกต่าง จะไม่ถูกโหลด และหน้าเว็บจะแจ้งให้ทราบ ไฟล์แพ็กเกจที่เปลี่ยนแปลง ขาดหายไป หรือถูกเพิ่มเข้ามา จะทำให้การตรวจสอบล้มเหลว

โมดูลนี้เป็นผลงานที่แยกต่างหากภายใต้ใบอนุญาตของตัวเอง TgWitness ไม่รวมโมดูลนี้มาด้วย: ในแต่ละ การติดตั้ง จะต้องดาวน์โหลดโมดูลนี้จากคลังของผู้พัฒนา รายละเอียด บนหน้านี้แสดง โมดูลที่โหลดมา ผู้สร้าง ใบอนุญาต การ commit และ SHA-256

ผู้ดูแลระบบที่ไม่มีสิทธิ์เข้าถึง GitHub สามารถติดตั้ง commit เดียวกันนั้นลงในสภาพแวดล้อม Python แทนได้; หลังจากนั้น แผงควบคุมจะใช้สำเนานั้น:

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

TgWitness กลายเป็นจุดปลายทาง (endpoint) สำหรับการสนทนาที่มันสร้างหรือรับมา มันบันทึก ข้อความ ไฟล์แนบที่มีอยู่ การเปลี่ยนแปลงของตัวจับเวลา และประกาศการลบลงใน บันทึกที่ลงนามแล้ว เนื้อหาที่บันทึกไว้ก่อนหน้านี้ยังคงสามารถเข้าถึงได้แม้หลังจากมีประกาศการลบในภายหลัง

ความพร้อมใช้งานของแพ็กเกจ#

เมื่อวันที่ 8 พฤศจิกายน 2026 แพ็กเกจติดตั้งที่เผยแพร่ได้รับการตรวจสอบจากแหล่งที่มา b35f8e18f3d1 , เวอร์ชัน b35f8e18f3d1-1ff85ec98bb2 , เวอร์ชัน 0.9.1 preview. Wheel ที่ไม่สามารถเปลี่ยนแปลงได้และ ล็อกการพึ่งพาของมันผ่านการตรวจสอบลายเซ็น SHA-256 และ RSA ของเวอร์ชัน ส่วนหลังและส่วนหน้าของแพ็กเกจตรงกับแหล่งที่มาดังกล่าวทุกไบต์ แพ็กเกจนี้ยังรวมถึงการลงทะเบียน API และ hook ของ collector ด้วย

แพ็กเกจนั้นไม่รวมไลบรารีโปรโตคอล และมันก็ไม่อยู่ใน lock ของ dependency. ส่วน secret-chats ส่วน extra ใน pyproject.toml กำหนดให้ใช้ commit เดียวกัน กับปุ่มบนแผงควบคุม

การตรวจสอบแพ็กเกจนี้กำหนดว่าไฟล์และคำประกาศการพึ่งพาใดจะถูกส่งไป บันทึกการตรวจสอบความถูกต้องระบุการตรวจสอบระหว่างการทำงานที่แยกต่างหาก คู่มือเมื่อวันที่6 พฤศจิกายนที่ผ่านมาได้อธิบายถึงสแนปช็อตการพัฒนา; คู่มือนั้นไม่ อธิบายถึงแพ็กเกจข้างต้นอีกต่อไป

ใช้ส่วนติดต่อผู้ใช้#

เปิด Pseudo-secret, ติดตั้งโมดูลหากหน้าเว็บมีให้, เปิดใช้งานสำหรับบัญชี และเชื่อมต่อ คำขอที่เข้ามาจะรอการยอมรับจนกว่าจะเปิดใช้งานการยอมรับอัตโนมัติ การเริ่มต้น การยอมรับ การส่ง และการปิด จะใช้สิทธิ์การโต้ตอบของบัญชี และระบบป้องกันแบบอ่านอย่างเดียว

การดำเนินการ ผลลัพธ์ที่รักษาไว้
เริ่มการสนทนาโดยใช้ชื่อผู้ใช้หรือ ID ผู้ใช้ คำขอส่งออกไป; ฝ่ายคู่รับคำขอนี้บนอุปกรณ์ของพวกเขา
รับคำขอ TgWitness จะกลายเป็นจุดปลายทางที่รับข้อมูล
ส่งหรือรับข้อความ secret_chat.message พร้อมด้วยทิศทาง เนื้อหา และตัวจับเวลาที่กำหนด
รับไฟล์ ไบต์ที่ถอดรหัสแล้วซึ่งถูกเก็บไว้โดยใช้ SHA-256 และใบเสร็จรับเงิน secret_chat.file; รวมอยู่ในการส่งออกหลักฐาน
รับการแจ้งเตือนเกี่ยวกับตัวจับเวลาหรือการลบข้อมูล บันทึกการดำเนินการแยกต่างหากพร้อมกับข้อความและไฟล์ที่เก็บรักษาไว้
ตรวจสอบการสนทนา การสนทนา, ใบรับไฟล์, การแจ้งเตือน และการแสดงผลกุญแจ

การสนทนาลับที่มีอยู่บนอุปกรณ์อื่นจะรักษาคีย์เฉพาะอุปกรณ์ไว้ เซสชันคลาวด์ที่ นำเข้าจะไม่ถ่ายโอนคีย์เหล่านั้น วัสดุคีย์การสนทนาลับและ ตัวนับใช้ vault ของพื้นที่ทำงาน ส่วนข้อความที่เก็บรักษาไว้และไฟล์ที่ถอดรหัสแล้วใช้ การป้องกันพื้นที่ทำงานปกติ

ค้นหาข้อความที่บันทึกไว้#

ใช้ฟังก์ชันค้นหาข้อความในแชทที่เปิดอยู่เพื่อค้นหาวลีที่ตรงกัน โดยไม่คำนึงถึง ตัวพิมพ์ใหญ่หรือตัวพิมพ์เล็ก กดปุ่ม Previous และ Next หรือ Enter และ Shift+Enter ในช่องค้นหา เพื่อย้ายไปมาระหว่างข้อความที่ตรงกัน ตัวนับจะนับจำนวนข้อความ; วลีที่ตรงกัน แรกในแต่ละข้อความจะถูกเน้นสี กด Escape เพื่อล้างการค้นหา

ฟังก์ชันการค้นหารักษาให้บทสนทนาโดยรอบ ไฟล์ที่บันทึกไว้ และคำเตือนการลบ ยังคงปรากฏอยู่ มันจะค้นหาข้อมูลที่โหลดไว้ในแผงแล้ว หากยังมี ข้อมูลเก่าเหลืออยู่ แผงจะแจ้งให้ทราบ; การโหลดข้อมูลเก่าจะขยายประวัติและ อัปเดตผลการค้นหา โดยยังคงแสดงข้อความปัจจุบันไว้ตามเดิม

การค้นหาในแต่ละแชทจะยังคงอยู่เมื่อคุณเปลี่ยนไปมาภายในพื้นที่ทำงานเดียวกัน การล็อก แผงหรือเปลี่ยนพื้นที่ทำงานจะทำให้การค้นหาเหล่านั้นถูกล้าง คำค้นหาจะเก็บไว้ใน หน่วยความจำของหน้า และไม่ถูกเก็บไว้ในพื้นที่จัดเก็บของเบราว์เซอร์ หรือส่งไปเป็นคำขอ API การค้นหาจะไม่ส่งข้อความ Telegram หรือการแจ้งเตือนการพิมพ์/อ่าน การตั้งค่า การมองเห็นที่มีอยู่ยังคงควบคุมการเปิดแชทและกิจกรรมอื่นๆ

รายงานการสร้างจะรักษาขอบเขตการเลือกของแชทที่เลือกไว้; การค้นหาเพื่อแสดงผล จะไม่จำกัดข้อมูลที่ส่งออกโดยอัตโนมัติ โปรดดูตัวอย่างการเลือกในรายงาน ก่อนดาวน์โหลด

การควบคุมความคงอยู่และการโต้ตอบ#

การดำเนินการแบบบูรณาการนี้ใช้การค้นหาบันทึกแบบทนทาน (durable journal lookup) เพื่อตรวจหาการซ้ำซ้อน, เก็บงานแนบไฟล์ไว้เป็นงานที่รอการดำเนินการหลังการดาวน์โหลดล้มเหลว, และส่งการปิดผ่าน ตัวป้องกันการโต้ตอบ (interaction guard) เดียวกันกับปฏิบัติการระยะไกลอื่น ๆ สิ่งเหล่านี้แทนที่เส้นทางทั้งสาม ที่รายงานในผลการตรวจสอบภาพสแนปช็อตการพัฒนาเมื่อวันที่6 พฤศจิกายนที่ผ่านมา

ข้อความที่ถอดรหัสแล้วแต่การเขียนลงในบันทึกไม่สำเร็จจะถูกเก็บไว้ใน vault เพื่อลองใหม่ การตรวจสอบขนาดไฟล์แนบและพื้นที่ว่างบนดิสก์จะเลื่อนการดาวน์โหลดออกไป แต่ยังคงรักษางานไว้ โมดูลนี้จะใช้การเชื่อมต่อที่มีอยู่ของบัญชีนั้นซ้ำ การแจ้งเตือนการอ่านและการพิมพ์จะถูกส่ง เฉพาะตามที่เลือกไว้ในส่วน What the other side sees; การแจ้งเตือน ด้วยภาพหน้าจอจะไม่ถูกส่งไปเลย ดู secret_chats.py, API routes และ นโยบายการเข้าถึง

การตรวจสอบประวัติยังคงรักษา ผลการสแนปช็อตเดิมไว้ ความพร้อมใช้งานและการนำไปใช้ในปัจจุบันควรอ่านจาก การปรับปรุงแพ็กเกจข้างต้นและคุณสมบัติปัจจุบัน

การสาธิตอินเทอร์เฟซ#

สถานการณ์บนเว็บไซต์ใช้คำขอ ข้อความ และไฟล์สมมติเพื่อสาธิต กระบวนการทำงานของแผงควบคุม นี่เป็นตัวอย่างของอินเทอร์เฟซ; การตรวจสอบโปรโตคอลและการรับข้อมูล มีผลลัพธ์ที่มีวันที่ระบุไว้ในบันทึกการตรวจสอบความถูกต้อง