面向 Telegram 官方 Play、官网 Android 客户端及指定 entinyGram、Plus Messenger、Nagram 版本的增强 LSPosed/Xposed 模块
An enhancement LSPosed/Xposed module for the official Telegram Play and website Android clients and selected entinyGram, Plus Messenger and Nagram builds
如果 GramSieve 对你有帮助，欢迎点一个 Star 支持项目 ⭐
If GramSieve helps you, please consider leaving a Star.
当前模块版本为 13.2.0，适配官方 Telegram 13.2.0（Play 版 72801、官网版 72809），保留已有版本适配；需要支持 libxposed API 102 的 LSPosed。
The module version is 13.2.0, supporting official Telegram 13.2.0 (Play build 72801 and website build 72809) while retaining existing version support; an LSPosed version supporting libxposed API 102 is required.
同时适配 entinyGram 插件版 13.1.1-23cc749（2026110200）、Plus Messenger 13.1.1.0（22621）与 Nagram 13.1.1（1257），Nagram 1257 的三次同版本更新包亦已适配，并保留 entinyGram 2026102900/2026102800/2026102600、Plus 22601、Nagram 1255 等已有版本适配；使用时请将相应客户端加入模块作用域。
Compatibility also covers the entinyGram plugin build 13.1.1-23cc749 (2026110200), Plus Messenger 13.1.1.0 (22621) and Nagram 13.1.1 (1257), including all three replacement Nagram 1257 builds with the same version number and retaining existing support such as entinyGram 2026102900/2026102800/2026102600, Plus 22601 and Nagram 1255; add the client you use to the module scope.
entinyGram 已有的等价增强功能、翻译及新消息的防撤回与编辑记录由其原生功能负责；主动加载、旧 GramSieve 历史记录和其他补充功能继续保留，原有模块配置不迁移、不清空。
entinyGram handles equivalent native enhancements, translation, and recall protection and edit recording for new messages. Proactive loading, existing GramSieve history and other complementary features remain available, without migrating or clearing saved module settings.
新版 entinyGram 的受限聊天复制与保存需在其原生设置「服务条款 → 允许从受保护的聊天转发」中开启；Story 保存及阅后即焚媒体使用各自的原生开关。旧照片历史继续使用原生历史页，并修正点击旧版本时大图错误加载最新版的问题。
On the updated entinyGram build, copying and saving protected chat content requires its native “Terms of Service → Allow forwarding from protected chats” setting. Story saving and self-destructing media use their respective native settings. Photo history retains the native archive page, with a correction preventing an older revision from opening the latest photo instead.
Plus 的首条消息、手动标记、翻译，以及 Nagram 的翻译等已确认等价的重复功能使用各自原生实现；Nagram 的手动标记与上次浏览位置仍由模块提供，1257 构建的精确首条消息入口也由模块提供，并保留原生“回到顶部”和原有模块设置。
Confirmed equivalent features use the client's native implementation, including first-message navigation, manual marks and translation in Plus, and translation in Nagram; module marks and last-viewed navigation remain available in Nagram. Nagram build 1257 also keeps the module's precise first-message entry alongside its native beginning action, with saved module settings preserved.
安装模块后，在 LSPosed 中启用 GramSieve，并勾选使用的受支持客户端，然后重新打开该客户端。
After installing the module, enable GramSieve in LSPosed, select the supported client you use, and reopen that client.
模块随 Telegram 运行，无需允许 GramSieve 自启动，也无需为本模块勾选“系统框架”作用域。
The module runs within Telegram; GramSieve autostart and the System Framework scope are not required.
“日志”页面提供性能记录，支持导出或通过系统分享发送日志文件；
The Logs page provides performance records and lets you export files or open the system share sheet.
预览、复制、导出和分享均自动脱敏，分享前仍可检查文件。
Previews, copies, exports, and shared files are automatically redacted; you can still review files before sharing.
在 Telegram 设置 → GramSieve → 使用教程，或当前聊天右上角 ⋮ → 聊天过滤规则 → 使用教程中查看中英文教程。
Open Telegram Settings → GramSieve → Usage guide, or a chat’s ⋮ → Chat filtering rules → Usage guide.
目录包含规则、搜索去杂、防撤回、编辑历史、翻译、媒体保存、空间与流量、消息标记、临时清理、配置迁移等专题；
The bilingual topics cover rules, focused search, anti-recall, edit history, translation, saving media, storage and data use, marks, temporary cleanup and configuration transfer.
界面语言可在“通用与诊断”选择跟随 Telegram、简体中文、English 或 Русский。
Under General & diagnostics, choose Follow Telegram, 简体中文, English or Русский for the module interface.
在“界面与菜单 → 菜单项目 → 消息长按菜单”中可开关“标记此消息”；默认显示，关闭后仍保留已有标记和跳转功能。
Under Interface & menus → Menu entries → Message long-press menu, toggle Mark this message; it is shown by default, and hiding it preserves existing marks and navigation.
先按自己的需要开启独立功能。
Enable the separate features you need.
消息过滤在本机执行；搜索、翻译、主动加载和媒体下载会使用网络。
Message filtering is local; search, translation, proactive loading and media downloads use the network.
防撤回与编辑历史只能保留实际收到并成功缓存的内容，开启设置不会补回所有已消失的记录。
Anti-recall and edit history retain content actually received and cached; enabling them does not recover every record already gone.
-
仅本地过滤 — 所有过滤在设备上完成，无网络请求，数据不离开手机
Local-only filtering — all filtering happens on-device; no network requests, no data leaves your phone -
全局 + 单聊规则 — 全局设置宽泛规则，再针对特定聊天覆盖或排除
Global + per-chat rules — set broad filters globally, then override or exclude specific chats -
丰富的匹配目标 — 消息文字、媒体说明、内联按钮文字/链接、发送者名称/ID、聊天名称/ID
Rich match targets — message text, media captions, inline button labels/URLs, sender names/IDs, chat names/IDs -
白名单优先 — 排除规则始终优先于过滤规则，适合管理员、公告或信任联系人
Whitelist wins first — exclusion rules always override filter rules; use them for admins, notices, or trusted contacts -
一键重置规则 — 可一次清空全局与所有聊天的过滤规则，同时保留防撤回、编辑历史、消息标记、日志和功能设置
One-tap rule reset — clear global and per-chat filter rules at once while preserving anti-recall, edit history, message marks, logs, and feature settings -
三种过滤动作 — 本地隐藏、本地折叠、调试标记（测试用）
Three filter actions — hide locally, collapse locally, or debug-mark (for testing) -
屏蔽消息自动已读 — 新消息到达时，在能确认不会连带读掉正常消息的情况下自动推进已读；有其他正常未读或无法确认范围时保留未读，排除规则和调试标记不触发自动已读
Auto-read filtered messages — advance the read position on incoming filtered messages only when normal unread messages will remain untouched; preserve unread state when other normal unread messages exist or the range cannot be verified, and never auto-read keep-rule or debug-mark matches -
完全宿主化设置 — 不提供独立应用界面；全局配置和聊天配置都在 Telegram 内完成，界面跟随宿主主题，修改后自动保存并立即生效
Fully host-native settings — provides no standalone app UI; global and per-chat settings live inside Telegram, follow the host theme, and save and apply changes automatically -
分类设置与规则列表 — 按功能分类导航，屏蔽规则和保留例外分别管理，支持逐条启停、搜索、编辑和批量添加
Categorized settings and rule lists — navigate by feature and manage block rules and keep exceptions separately, with individual toggles, search, editing and batch input -
消息翻译 — 使用 Telegram 原生翻译服务，优先处理屏幕内消息；支持单条翻译、自动翻译及全局/群组/频道设置，原文在上、译文在下，目标语言可跟随界面或手动指定；翻译会向 Telegram 服务提交待翻译文本
Message translation — uses Telegram's native translation service and prioritizes visible messages; supports single-message and automatic translation with global, group and channel settings, original text above the translation, and an interface-based or manually selected target language; text is submitted to Telegram's translation service -
频道关键词提醒 — 在频道聊天菜单中按账号、频道分别配置，每行一个关键词，任意命中正文或图片说明即可；仅提醒开启后收到的新帖，支持持续振动、静默通知、一键停止、定时结束与连发合并，不播放声音
Channel keyword alerts — configure each account and channel from the channel chat menu, with one keyword per line matching post text or captions; only new posts received after enabling can trigger repeating vibration or silent notifications, with Stop, automatic timeout and burst coalescing, without sound振动提醒需要允许客户端通知与振动，以及本提醒类别的振动；设置页提供两个系统设置入口和测试按钮，系统勿扰及省电策略仍有效。
Vibration alerts require notification and vibration permission for the client and vibration permission for this alert category; the settings panel links to both system controls and provides a test button, while Do Not Disturb and battery policies still apply. -
搜索去杂 — 独立搜索页提供关键词包含/排除和按账号保存的群组/频道黑白名单，合并云端与本地原文结果，支持继续加载、指定聊天历史扫描及消息跳转；界面显示扫描范围，搜索条件不改变聊天屏蔽规则
Search filters — a dedicated page combines cloud and local-text results with keyword include/exclude filters and per-account group/channel allowlists and blocklists; supports paging, scoped history scans and message navigation, shows scan coverage, and leaves chat-blocking rules unchanged -
配置迁移 — 设置页导出/导入 JSON，迁移规则、功能和当前账号策略；不包含登录凭据、缓存消息或媒体文件
Settings migration — export/import JSON from settings to transfer rules, features and current-account policies, excluding login credentials, cached messages and media files -
受限内容保存与复制 — 使用 Telegram 原生媒体保存流程，提供受限内容的保存与文字复制能力
Save and copy restricted content — save media through Telegram’s native media flow and copy restricted text -
发送副本（可选，默认关闭） — 开启后，可从转发入口将受限文字或完整下载的普通视频作为新消息发送；视频会重新上传，不保留原转发来源，不解除服务器的原生转发限制
Send copies (optional, off by default) — when enabled, send protected text or fully downloaded regular videos as new messages from the forward action; videos are re-uploaded without original forwarding attribution, and server-side native forwarding restrictions remain -
消息标记与跳转 — 单击消息可标记位置，从右上角菜单一键跳回，每个聊天独立标记
Mark & jump — tap a message to mark its position, jump back anytime from the menu; marks are per-chat -
浏览位置记忆 — 自动记录滚动位置，可一键跳转到上次浏览处
Browse position memory — automatically tracks scroll position, one-tap jump to last viewed message -
可选下载按钮常驻 — 默认关闭；开启后始终保留 Telegram 原生下载入口，点击、动画和进度仍由客户端处理
Optional persistent download button — off by default; when enabled, Telegram's native download entry stays available while clicks, animation, and progress remain client-controlled -
下载页全选 — Telegram 下载管理页面多选模式下支持一键全选
Download page select all — select all loaded download items at once in Telegram's download manager -
主动加载与防撤回防修改 — 后台和推送到达时主动加载消息，结合删除链路拦截和本地存储标记，尽量保留被撤回或修改的原始内容
Anti-recall & anti-edit — proactively loads messages in the background and when push updates arrive, combining delete-path interception and local-storage marking to preserve recalled or edited content where possible -
多版本编辑历史 — 编辑历史按版本保存，并会从 Telegram 本地历史同步写入中补齐离线期间发生的编辑
Multi-version edit history — stores edit history by version and recovers edits that arrive through Telegram local history-sync writes while the device was offline -
媒体下载与空间预算（63 起） — 主动下载默认开启，副本预算默认不限；可关闭尚未缓存媒体的主动下载，或设置普通媒体副本预算，达到预算后暂停新增副本和模块发起的媒体下载，已有文件保留
Media downloads and storage budget (63+) — automatic downloads are on and the copy budget is unlimited by default; optionally stop downloading media not yet cached or set a budget for ordinary media copies, pausing new copies and module-initiated downloads at the budget while keeping existing files -
回复后已读（可选，默认关闭） — 浏览普通聊天时暂缓上报已读，消息实际发送成功后补报该会话此前的已读；后续新消息继续暂缓，失败、编辑和仅创建定时发送不触发
Read after reply (optional, off by default) — hold ordinary chat read receipts until a message is successfully sent to that conversation; later arrivals remain held, and failures, edits or merely scheduling a send do not release receipts -
保留阅后即焚图片（可选，默认关闭） — 普通私聊中真实打开图片后正常上报查看，发送方按原生流程过期；接收方到期后显示“已销毁”并保留本地图片，不恢复未下载或已销毁的内容，不适用于秘密聊天
Keep self-destruct photos (optional, off by default) — opening an incoming photo in a normal private chat reports viewing and lets it expire normally for the sender, while keeping a local photo marked Expired for the recipient; cannot recover undownloaded or already destroyed content and does not cover secret chats -
编辑历史媒体查看 — 点击消息弹窗可查看编辑前内容，原始图片优先使用 Telegram 官方 PhotoViewer 并支持官方保存入口
Edit-history media viewer — open original pre-edit content from the message popup; original images prefer Telegram's official PhotoViewer and official save flow -
持久化诊断日志 — 运行日志写入 app-specific 外部目录，避免依赖容易溢出的 logcat 缓冲区
Persistent diagnostics — runtime logs are written to app-specific external storage instead of relying on overflow-prone logcat buffers -
多语言界面 — 简体中文、English 和 Русский，支持跟随 Telegram
Multilingual UI — Simplified Chinese, English and Russian, with an option to follow Telegram -
旧版登录验证码流程（可选，默认关闭） — 首次未登录也可通过欢迎页或登录页的 GramSieve 图标开启；重启官方 Telegram 后，以 11.5.5 / API layer 195 初始化未登录账号连接，尝试旧版验证码流程；不影响已登录账号，不保证跳过邮箱或短信付费页面，关闭后重启恢复
Legacy login verification flow (optional, off by default) — use the GramSieve icon on the welcome or login page even before your first sign-in, then restart official Telegram to initialize signed-out accounts with 11.5.5 / API layer 195; signed-in accounts remain unchanged, skipping email or SMS payment pages is not guaranteed, and disabling then restarting restores native initialization
编辑历史可以分别保存实际捕获的文字和图片版本；图片还需成功缓存对应文件。
Edit history can retain distinct captured text and image versions; images also need their corresponding cached files.
未收到的编辑版本、未保存的媒体或记录开启前已丢失的内容无法保证恢复。
Recovery is not guaranteed for edits never received, media never saved or content lost before recording was enabled.
新版各渠道的具体功能仍需按场景验证，适配声明不表示所有功能均已实测。
Features require scenario-specific verification on each client build; adaptation does not mean every feature has been tested.
在 GramSieve 设置首页进入“屏蔽与保留”，分别管理屏蔽规则和保留例外。
Open “Block & keep rules” from GramSieve Settings to manage block rules and keep exceptions separately.
点击“添加规则”选择匹配内容、范围和方式，修改即时保存；
Add a rule with its text, scope and matching method; edits save automatically.
已有规则可以单独启停、编辑或删除，多条内容可使用“批量添加”。
Existing rules can be enabled, edited or deleted individually, and “Add multiple” supports batch input.
保留例外始终优先。
Keep exceptions take priority.
过滤后的隐藏、折叠或调试标记可在“过滤方式与规则管理”中选择。
Choose hide, collapse or debug mark under “Filtering action & rule management”.
GramSieve 会对消息文字、媒体说明、内联按钮文字/链接、发送者名称/ID、聊天名称/ID 进行标准化处理，然后逐行匹配规则。
GramSieve normalizes message text, media captions, inline button labels/URLs, sender names/IDs, and chat names/IDs, then matches rules line by line.
关键词规则
Keyword rules:
t.me/
buy now
sender:promo_bot
chat:airdrops
button:https://
caption:airdrop
正则规则
Regex rules:
https?://
sender:^(promo|deal)_bot$
button:https?://[^ ]+
支持的前缀
Supported prefixes:
| 前缀 Prefix |
检查目标 Checks |
|---|---|
text: |
消息文字 Message text |
caption: |
媒体说明 Media captions |
button: |
按钮文字或链接 Button labels or URLs |
sender: |
发送者名称或 ID Sender name or ID |
chat: |
聊天名称或 ID Chat name or ID |
| (无 none) |
以上所有字段 All fields above |
在当前界面中，每个输入框已固定检查目标，通常不需要写前缀。
In the current UI, each input box is already target-specific, so prefixes are usually unnecessary.
-
Telegram 设置列表 →
GramSieve（唯一全局配置入口）
Telegram settings list →GramSieve(the only global settings entry) -
聊天右上角三点菜单 →
聊天过滤规则·防撤回·主动加载·编辑历史·跳转到上次浏览·跳转到标记位置；启用翻译后提供翻译及自动翻译入口，菜单项可在设置中分别隐藏
Chat top-right overflow menu →Chat filters·Anti-recall·Proactive loading·Edit history·Jump to last viewed·Jump to marked position; translation controls appear when enabled, and individual menu entries can be hidden in settings -
单击某条消息 →
屏蔽此消息·标记此消息·编辑历史；启用翻译后可翻译有文字的消息
Click a message →Block this message·Mark this message·Edit history; messages containing text can also be translated when translation is enabled -
下载页面多选模式 →
全选按钮（一键选中所有已加载的下载项）
Download page action mode →Select Allbutton (select all loaded download items at once)
设置在当前 Telegram 客户端内保存，重启后保留；无需另外打开模块应用确认。
Settings are saved within the current Telegram client and survive restarts; no separate module app confirmation is needed.
换设备或换客户端时，使用“配置迁移”导出和导入；多个账号的专属策略需分别迁移。
Use Configuration transfer to export and import when changing devices or clients, and migrate each account’s dedicated policies separately.
在全局“媒体与下载”中可控制“主动下载尚未缓存的媒体”和普通媒体副本预算（GiB，0 为不限）。
Global Media & downloads provides a switch for downloading media not already cached and an ordinary media-copy budget in GiB (0 means unlimited).
关闭主动下载后仍会复制 Telegram 已下载的媒体；
Turning downloads off still allows copying media Telegram has downloaded.
达到预算后暂停新增普通副本和模块发起的媒体下载，降低预算不会删除旧文件。
At the budget, new ordinary copies and module-initiated downloads pause; lowering it does not delete old files.
此预算不限制 Telegram 自身下载、数据库或另存的阅后即焚图片。
The budget excludes Telegram’s own downloads, databases and separately retained self-destruct photos.
未及时缓存的媒体若被撤回，可能无法恢复。
Media not cached before recall may be unavailable.
到“通用与诊断 → 日志”点击“记录当前资源用量”，稍等后刷新或分享文件。
Under General & diagnostics → Logs, tap Record current resource usage, wait briefly, then refresh or share the file.
ResourceUsage 记录历史请求/返回、媒体下载请求与副本写入字节、文件和数据库占用，以及 Telegram UID 的收发字节。
ResourceUsage records history requests/results, media download requests and copied bytes, file/database sizes and Telegram UID traffic.
UID 流量包含 Telegram 自身活动，不能全部归给模块；请求声明大小也不等于真实网络字节。
UID totals include Telegram’s own activity and cannot all be attributed to the module; declared request sizes are not actual network bytes.
排查增长时，请保留同一客户端两个时点的记录和当时正在使用的功能。
To investigate growth, keep two samples from the same client and note which features were active.
日常使用会自动静默记录广告处理、卡帧与网络加载摘要，无需开启详细诊断；正常请求汇总、异常采样限频，不记录消息正文或凭据。
Ordinary use automatically records silent summaries of ad handling, frame delays and network loading without detailed mode; normal requests are aggregated, anomaly samples are rate limited, and message contents and credentials are excluded.
一般反馈问题可直接使用“通用与诊断 → 日志”：选择最近一小时、今天、自定义时间范围或全部，再点“分享”。
For issue reports, use General & diagnostics → Logs, choose the last hour, today, a custom range or All, then tap Share.
文件保存到 Downloads/GramSieve 并打开系统分享面板；
The file is saved under Downloads/GramSieve and the system share sheet opens.
“全部”分享完整持久日志，“复制”只复制当前预览，可能只是末尾片段。
Sharing All includes the complete persistent log; Copy copies only the preview, which may contain just its tail.
分享前请检查脱敏后的文件。
Review the redacted file before sharing.
调试防撤回、主动加载或媒体缓存时，优先读取持久化日志。
When debugging anti-recall, proactive loading, or media caching, read persistent logs first.
公共 /sdcard/GramSieve 路径已放弃，日志写入 app-specific 外部目录：
The public /sdcard/GramSieve path is no longer used; logs are written to app-specific external storage:
adb -s <device> shell tail -n 300 /sdcard/Android/data/org.telegram.messenger/files/GramSieve/gramsieve.log
adb -s <device> shell tail -n 300 /sdcard/Android/data/com.tianqianguai.gramsieve/files/GramSieve/gramsieve.log
GramSieve 以 GNU General Public License v3.0 or later（GPL-3.0-or-later）发布。
GramSieve is released under the GNU General Public License v3.0 or later (GPL-3.0-or-later).
你可以复制、修改和分发本项目，但分发修改版或二进制版本时，需要遵守 GPL-3.0-or-later 的源码提供、许可证保留和同许可证分发要求。
You may copy, modify, and distribute this project, but modified versions and binary distributions must follow the GPL-3.0-or-later requirements for source availability, license preservation, and same-license distribution.
完整许可证文本见 LICENSE。
See LICENSE for the full license text.
GramSieve 的部分反撤回和编辑历史设计参考了 TeleVip-LSPosed 对 Telegram 本地消息存储、删除标记和编辑历史捕获路径的公开研究。
Parts of GramSieve's anti-recall and edit-history design were informed by the public research in TeleVip-LSPosed around Telegram local message storage, deletion flags, and edit-history capture paths.
GramSieve 没有引入 TeleVip-LSPosed 源码；相关功能基于 GramSieve 自身的 hook、缓存、数据库和 UI 结构独立实现。
GramSieve does not include TeleVip-LSPosed source code; the related functionality is implemented independently using GramSieve's own hooks, cache, database, and UI structure.