開源 · MIT 授權 · v0.10.0

Your Telegram
Spam Firewall

不是 Bot,直接以你的身份登入。多維評分引擎、群組行為分析、私訊封鎖、圖片 OCR、HTML 報告——一個指令,全面守護你的 Telegram。

🧠
30+
分級廣告模式
高危 / 中危 / 低危 · 繁簡雙收
🎯
6 維
垃圾訊號評分
正則 / 連結 / @提及 / 帳號 / 頻率
🛡️
0
誤封
弱信號需組合才判定
✦ 純本地運行 · 資料絕不外傳 · Session 自動 600 權限 ✦

全方位的防護能力

從私訊到群組、從文字到圖片,TeleShield 守護你 Telegram 的每一個角落。

🔍

私訊掃描封鎖

掃描所有非聯絡人對話,多維評分即時判定,一秒封鎖。

🧠

垃圾訊號評分引擎

分級正則 + 連結密度 + @提及 + 弱帳號特徵 + 頻率,六維信號加權,自動區分封鎖 / 標記 / 放行。

👥

群組自動踢除

管理員身份的群組中自動監測,廣告出現即刻踢除 + 封鎖,不再復返。

🔍

群組行為分析

進群秒發連結、刷屏廣告、大量 @ 轟炸——行為特徵自動識別,短網址圖片廣告也逃不掉。

📸

圖片 OCR 辨識

純圖片廣告無所遁形。Tesseract 本地 OCR 辨識文字,資料絕不外傳。

📊

HTML 可視化報告

每日 / 每週封鎖摘要,含類型統計、來源分析、趨勢圖表,一鍵生成 HTML 報告。

🧠

自動學習模式

遇到新模式廣告?手動標記一次,自動提取關鍵詞、生成正則,舉一反三。

白名單 / 黑名單

精準控制。白名單永不封鎖,黑名單見一個封一個。community 名單 JSON 交換共享。

簡潔而強大

所有功能濃縮在幾個直觀的指令中,學習成本趨近於零。

--listen即時監聽 + 行為分析
--scan掃描並封鎖
--group-scan群組掃描踢除
--report-htmlHTML 可視化報告
--learn手動標記學習
--status系統狀態一覽
--whitelist白名單管理
--blacklist黑名單 + JSON 交換
--dry-run安全試運行

兩分鐘搞定

只需要 Python 3.9+ 和 Telegram API 憑證,一行指令部署。

# 1. pip 安裝(含 OCR 依賴)
pip install "teleshield[ocr]"

# 2. 安裝 OCR 系統依賴(選用,強烈建議)
apt install tesseract-ocr tesseract-ocr-chi-sim

# 3. 首次設定(憑證走環境變數或交互輸入)
teleshield --setup

# 4. 啟動防護
teleshield --listen
1

取得 API 憑證

前往 my.telegram.org/apps 申請 API ID 和 API Hash

2

首次登入

執行 --setup 輸入憑證,Telegram 會發送驗證碼到你的手機

3

開始保護

執行 --listen 即時監聽,TeleShield 會在後台默默守護你

開放原始碼,自由使用

MIT 授權 · 可直接下載安裝

當前版本 v0.10.0 · 評分引擎 + 行為分析 + HTML 報告 · 最後更新 2026-08-21