XBlocker 是一个 Android 原生 X 客户端的 LSPosed 过滤模块。它在本地匹配规则，隐藏垃圾回复、推广内容和指定分类。
- 精细过滤：默认过滤回复，也支持首页和搜索时间线；昵称、用户名、推广内容和分类均可独立开关。
- 自定义规则：关键词、
/正则/flags、@用户名白名单、导入导出和规则测试。 - 云端词库：同步 x-comment-blocker，内置离线快照，支持手动同步和定时更新。
- 多版本适配：按宿主接口自动选择过滤入口，不依赖单一版本号；未知结构原样透传。
- 应用内更新：启动自动检查 GitHub 正式版，可手动检查；下载时可选择 GitHub 原站或
gh.dpik.top镜像，然后请求系统安装。 - 诊断记录：查看模块连接、数据入口、拦截计数和最近 200 条记录，可导出诊断 ZIP。
- 实时拦截状态：原生通道使用 Android 16 实时通知接口，由系统决定展示为小米超级岛或 O 系流体云，不写入焦点通知参数；焦点通知转换另有独立开关。详见小米超级岛适配和流体云适配。
- 无需常驻监控：实时状态由 X 进程直接回报和发布，系统自动超时清理，无需保留 XBlocker 后台卡片。OPPO / 一加的当前接入范围与解锁模块说明见流体云适配。
- Miuix 界面：支持浅色、深色、Monet、模糊、液态玻璃、预测性返回和全局缩放。
| 项目 | 支持情况 |
|---|---|
| Android | 9（API 28）及以上 |
| 框架 | LSPosed，需保留 legacy 模块支持 |
| 已验证 X | 12.16.3-release.0、12.23.1-prod.01 |
XBlocker 优先检测 OkHttp GraphQL 入口，必要时回退 Jackson / LoganSquare。更多验证过程见多版本适配说明。
- 从 Releases 下载并安装 APK。
- 在 LSPosed 中启用 XBlocker，勾选 X（
com.twitter.android）。只有启用“焦点通知转换”或小米焦点解锁 Hook 时才需要额外勾选 系统界面（com.android.systemui）；原生超级岛/流体云通道不依赖焦点通知。 - 强行停止 X，再重新打开。
- 打开 XBlocker，在“运行诊断”确认模块连接和时间线计数。
从 0.2.4 起，LSPosed 模块包名为 io.github.bileizhen.xblocker，以符合模块仓库的包名规则。0.2.3 及更早版本使用旧包名，升级时需要先安装新包并在 LSPosed 中重新启用作用域；两个包可以暂时并存，确认新包工作后再卸载旧包。
设置中的“启动时自动检查更新”默认开启，也可以随时手动检查。发现新版本后，在弹窗中点击“下载源”选择服务器；下载完成点击“请求安装”。Android 8 及以上首次安装时，需要允许 XBlocker 安装未知应用。
- 规则匹配在设备本地完成，不上传推文正文、账号凭据、自定义规则或白名单。
- 网络只用于公开词库、GitHub 版本检查和用户主动选择的更新下载。
- 诊断 ZIP 不包含自定义词库、白名单或拦截记录。
需要 JDK 21、Android SDK 37 和 Build Tools 36.0.0。创建本地 local.properties 后执行：
.\gradlew.bat :core:test :app:assembleDebug :app:lintDebug真机测试：
.\gradlew.bat :app:connectedDebugAndroidTestWindows 遇到 Unable to establish loopback connection 时，使用 scripts/build-local.ps1。正式发布请使用自己的签名密钥。
XBlocker 原有代码采用 MIT；界面和部分组件移植自 SukiSU-Ultra v4.1.3，完整应用按 GPL-3.0 分发，详见 COPYING。词库、Miuix、Xposed API 及其他依赖的来源和许可证见 THIRD_PARTY_NOTICES.md。
XBlocker 与 X、LSPosed 及词库维护者没有隶属关系。