Android Root Atlas/教程库/Xposed / LSPosed

模块、Hook 与扩展 / Xposed / LSPosed

只 Hook 一个 App:LSPosed、Vector 的最小作用域与安全撤销

在备用机或 AVD 中只对自有 Demo App 启用一个可审计模块,导出日志,并按作用域、模块、框架顺序完整撤销。

本篇完成任务

让一个演示模块只影响一个自有测试 App,取得日志证据并恢复原始行为。

Hook 框架能在运行时改变方法行为,作用域选错会影响系统进程。本教程只在自有备用机或可丢弃 AVD 中,使用来源可审计的演示模块作用于一个自制 Demo App;不碰银行、DRM、游戏、企业 App,也不演示绕过业务限制。

你会完成什么#

  • 分清 framework、module、scope 与目标进程四层责任。
  • 了解 2026 年 LSPosed 主仓库、Vector、LSPatch 与 NPatch 的状态和签名差异。
  • 用“关闭全部 → 开一个模块 → 选一个 App”建立最小复现并导出日志。
  • 依次取消作用域、禁用/卸载模块、禁用框架,确认 Demo 恢复。

先看结论#

路线Root/签名影响2026-08-09 使用边界
原 LSPosed通常依赖 Zygisk;不重签目标 APK主仓库当前未归档,但最新正式版仍是 2023-10-11 的 1.9.2;按旧生态谨慎评估
Vector活跃的独立实现/fork不是“官方 LSPosed 继任者”,按自身 Release 与文档核验
LSPatch / NPatch可重打包目标 APK,签名会改变只用于自有 Demo;更新、数据和服务端签名校验都会受影响
多框架并装变量与冲突倍增不做;先回到无框架基线再迁移

心智模型#

Root/Zygisk → Hook framework → module 规则 → scope → 一个 Demo 进程
                   │                │            │
                加载日志          改什么       影响谁
撤销:取消 scope → 禁用 module → 重启 → 卸载 → 必要时禁用 framework

框架提供 Hook 能力,模块定义方法改动,作用域决定哪些进程加载模块。模块“已启用”但 scope 没选不会产生效果;把 Android System、SystemUI 或权限控制器勾进 scope,则可能把一个 App 实验升级成系统崩溃。

工具清单#

工具角色什么时候用来源与注意
Vector当前活跃 framework 候选核对 Android/ART/Zygisk 后独立项目,不能沿用旧 LSPosed 兼容结论
LSPosed旧生态官方 framework阅读旧模块兼容与迁移背景2026-08-09 API 显示未归档,但正式版和主分支长期未更新;“未归档”不等于维护活跃
LSPatch/NPatchAPK 重打包式 Hook仅自有无敏感数据 Demo改签名,不能假设覆盖官方安装
framework 日志判断加载、模块与 scope每个单变量实验保存版本、时间与目标包名
ADB收集 logcat、恢复/卸载电脑预授权后不在生产账户 App 上采集敏感日志

项目全景:Xposed / LSPosed的 80 个项目,一个不漏#

先区分框架、免 Root 补丁器与普通模块,再按安全隐私、单 App 改造、System UI、自动化/媒体和资源索引组织 80 个项目。每个模块都要回答“Hook 谁、影响什么进程、如何撤销”。

技术路线项目数处理等级在主题任务中的位置
框架、免 Root Patch 与兼容实现16候选路线从 LSPosed/LSPatch、NPatch、Loxposed、TaiChi、SystemEdxposed、OPatch 等说明注入载体差异。归档状态、Android 版本和签名改变都要显式标注,不能把免 Root patch 说成没有风险。
安全检测、隐私与限制兼容21参考/审计覆盖 Root/Xposed/Frida 检测、VPN 隐藏、证书固定、银行兼容与隐私模块。检测器只用于回归;绕过示例仅限授权测试,KYC 和付费解锁等高风险条目要隔离说明而非教学操作。
面向单个 App 的功能改造12候选路线把 Via、Reddit、WhatsApp、Amazon、Google Discover/Dialer、Solid Explorer、Android Auto 与浏览器补丁按目标 App 归档。先锁定版本和作用域,升级目标 App 后重新验证。
System UI、桌面与交互增强14候选路线覆盖桌面、下载进度、系统分享、文件选择器、快捷设置、生物识别、手势、主题与平板 UI。只对必要系统包启用作用域,并在 System UI 循环崩溃时从安全模式禁用模块。
自动化、位置与音视频能力11候选路线连接虚拟定位、系统级 Agent、麦克风/变声、虚拟相机、通知/SMS、歌词和跨应用机器人。重点讲权限边界、敏感数据与明确的测试同意。
模块索引、样板与开发工具2候选路线把 curated list、模块仓库镜像、开发 kit 和综合 AndroidMods 当作发现入口。要求读者继续检查原仓库、目标包版本与 Modern Xposed API,而不是从列表批量安装。
Root 应用与 Xposed 边界项目4边界复核收纳描述只说 Root、明确不用 Xposed、信息不足或借 topics 进入本类的项目。仍逐一解释用途,但不把它们冒充 LSPosed 模块。

1. 框架、免 Root Patch 与兼容实现 · 16#

从 LSPosed/LSPatch、NPatch、Loxposed、TaiChi、SystemEdxposed、OPatch 等说明注入载体差异。归档状态、Android 版本和签名改变都要显式标注,不能把免 Root patch 说成没有风险。

本组共 16 项:11 个源项目、5 个 Fork,其中 2 项已归档。新手应先从“未归档的源项目”核对 README 和 Release,再用 Fork 追溯设备适配或历史差异;分组本身不等于推荐安装。

项目上游定位与识别信号状态与采用前检查
LSPosed/LSPatch主题用途:将 LSPosed/LSPatch 纳入「框架、免 Root Patch 与兼容实现」候选路线,根据 Java 核对功能、平台与版本适配。 上游自述(保留原文):LSPatch: A non-root Xposed framework extending from LSPosed已归档源项目 · ★ 9266 · GPL-3.0 · 2023-12-13。已归档:保留作历史、迁移或兼容性参考,不作为默认安装源。
JingMatrix/LSPatch主题用途:将 JingMatrix/LSPatch 纳入「框架、免 Root Patch 与兼容实现」候选路线,根据 Java 核对功能、平台与版本适配。 上游自述(保留原文):A non-root Xposed framework extending from LSPosed未归档 Fork · ★ 3536 · GPL-3.0 · 2026-04-19。Fork:采用前先与上游比较提交、Release 和维护者说明。
7723mod/NPatch主题用途:将 7723mod/NPatch 纳入「框架、免 Root Patch 与兼容实现」候选路线,根据 lspatch · rootless · xposed · Java 核对功能、平台与版本适配。 上游自述(保留原文):NPatch是一个复刻自LSPatch,以LSPosed为基础的免root的Xposed框架未归档源项目 · ★ 1840 · GPL-3.0 · 2026-07-04。活跃候选:先核对 README、最新 Release、目标版本与已知问题。
HSSkyBoy/NPatch主题用途:将 HSSkyBoy/NPatch 纳入「框架、免 Root Patch 与兼容实现」候选路线,根据 Java 核对功能、平台与版本适配。 上游自述(保留原文):NPatch是一个复刻自LSPatch,以LSPosed为基础的免root的Xposed框架已归档 Fork · ★ 989 · GPL-3.0 · 2025-10-01。已归档 Fork:只用于追溯历史差异,不作为默认安装源。
sanfengAndroid/FakeXposed主题用途:将 sanfengAndroid/FakeXposed 纳入「框架、免 Root Patch 与兼容实现」候选路线,根据 Java 核对功能、平台与版本适配。 上游自述(保留原文):Hide xposed, root, file redirection, etc.未归档源项目 · ★ 696 · Apache-2.0 · 2021-03-31。活跃候选:先核对 README、最新 Release、目标版本与已知问题。
Mrack/XposedNHook主题用途:将 Mrack/XposedNHook 纳入「框架、免 Root Patch 与兼容实现」候选路线,根据 android · il2cpp-hacking · il2cppdumper · C++ 核对功能、平台与版本适配。 上游自述(保留原文):Xposed免root注入so方案, 支持android各个版本未归档源项目 · ★ 253 · 协议未声明 · 2024-05-01。活跃候选:先核对 README、最新 Release、目标版本与已知问题。
find-xposed-magisk/LSPatch主题用途:将 find-xposed-magisk/LSPatch 纳入「框架、免 Root Patch 与兼容实现」候选路线,根据 Java 核对功能、平台与版本适配。 上游自述(保留原文):LSPatch: A non-root Xposed framework extending from LSPosed / LSPatch:一款非Root的Xposed框架,是从LSPosed扩展而来的。 / release备份在backup分支未归档源项目 · ★ 219 · GPL-3.0 · 2026-07-20。活跃候选:先核对 README、最新 Release、目标版本与已知问题。
dotcog/Loxposed主题用途:将 dotcog/Loxposed 纳入「框架、免 Root Patch 与兼容实现」候选路线,根据 rootless · xposed 核对功能、平台与版本适配。 上游自述(保留原文):基于LSPosed核心的免Root Xposed框架未归档源项目 · ★ 129 · 协议未声明 · 2025-05-03。活跃候选:先核对 README、最新 Release、目标版本与已知问题。
Hicores/OPatch主题用途:将 Hicores/OPatch 纳入「框架、免 Root Patch 与兼容实现」候选路线,根据 仓库名、README 与发布记录 核对功能、平台与版本适配。 上游自述(保留原文):OPatch: A non-root Genshin Impact Inject Framework from LSPosed/LSPatch未归档 Fork · ★ 125 · GPL-3.0 · 2023-12-13。Fork:采用前先与上游比较提交、Release 和维护者说明。
WindySha/FridaXposedModule主题用途:将 WindySha/FridaXposedModule 纳入「框架、免 Root Patch 与兼容实现」候选路线,根据 Java 核对功能、平台与版本适配。 上游自述(保留原文):This is a Xposed module for using Frida in non-root device.未归档源项目 · ★ 77 · 协议未声明 · 2020-07-27。活跃候选:先核对 README、最新 Release、目标版本与已知问题。
dqzg12300/MikSandHook主题用途:将 dqzg12300/MikSandHook 纳入「框架、免 Root Patch 与兼容实现」候选路线,根据 Java 核对功能、平台与版本适配。 上游自述(保留原文):魔改sandhook特征,MikRom注入dex实现免root的xposed案例未归档源项目 · ★ 42 · 协议未声明 · 2022-03-15。边界命中:先读 README,确认它确实属于当前任务,再决定是否使用。
LuigiVampa92/SystemEdxposed主题用途:将 LuigiVampa92/SystemEdxposed 纳入「框架、免 Root Patch 与兼容实现」候选路线,根据 android · edxposed · edxposed-framework · Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):Builds a TWRP compatible zip that installs EdXposed framework straight to system partition without installing root tools未归档源项目 · ★ 42 · GPL-3.0 · 2021-01-25。活跃候选:先核对 README、最新 Release、目标版本与已知问题。
fzer0x/LSPosedLauncher主题用途:将 fzer0x/LSPosedLauncher 纳入「框架、免 Root Patch 与兼容实现」候选路线,根据 android · lsposed · lsposed-module · Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):(Rootless / Root) LSPosed 2.0 Launcher未归档源项目 · ★ 15 · MIT · 2026-05-10。活跃候选:先核对 README、最新 Release、目标版本与已知问题。
Aphexed/TaiChi主题用途:将 Aphexed/TaiChi 纳入「框架、免 Root Patch 与兼容实现」候选路线,根据 仓库名、README 与发布记录 核对功能、平台与版本适配。 上游自述(保留原文):A framework to use Xposed module with or without Root/Unlock bootloader, supportting Android 5.0 ~ 11.未归档 Fork · ★ 8 · 协议未声明 · 2022-01-01。Fork:采用前先与上游比较提交、Release 和维护者说明。
CYcitizen/TaiChi主题用途:将 CYcitizen/TaiChi 纳入「框架、免 Root Patch 与兼容实现」候选路线,根据 仓库名、README 与发布记录 核对功能、平台与版本适配。 上游自述(保留原文):A framework to use Xposed module with or without Root/Unlock bootloader, supportting Android 5.0 ~ 11.未归档 Fork · ★ 6 · 协议未声明 · 2025-07-02。Fork:采用前先与上游比较提交、Release 和维护者说明。
mabbcoll13/xposed-module-kit主题用途:将 mabbcoll13/xposed-module-kit 纳入「框架、免 Root Patch 与兼容实现」候选路线,根据 android · hook · lsposed · Python 核对功能、平台与版本适配。 上游自述(保留原文):Xposed/LSPosed module development kit: reusable hook templates, Gradle build config, a root-detection bypass example, and offline class-scanning tooling.未归档源项目 · ★ 5 · MIT · 2026-07-15。活跃候选:先核对 README、最新 Release、目标版本与已知问题。

2. 安全检测、隐私与限制兼容 · 21#

覆盖 Root/Xposed/Frida 检测、VPN 隐藏、证书固定、银行兼容与隐私模块。检测器只用于回归;绕过示例仅限授权测试,KYC 和付费解锁等高风险条目要隔离说明而非教学操作。

本组共 21 项:20 个源项目、1 个 Fork,其中 1 项已归档。它们用于对照、诊断或审计,不组成可批量安装的推荐清单。

项目上游定位与识别信号状态与采用前检查
rushiranpise/detection主题用途:将 rushiranpise/detection 放在「安全检测、隐私与限制兼容」中作对照或审计参考,使用 android · checker · detection 判断它与当前任务的边界。 上游自述(保留原文):Collection of Various Root Detection Apps for Android未归档源项目 · ★ 700 · 协议未声明 · 2026-06-06。参考条目:用于防御性观测、概念对照或实验室审计;不是可直接照搬的安装方案。
okhsunrog/vpnhide主题用途:将 okhsunrog/vpnhide 放在「安全检测、隐私与限制兼容」中作对照或审计参考,使用 android · gki · kernel-module · Kotlin 判断它与当前任务的边界。 上游自述(保留原文):Hide active VPN from selected Android apps (kernel module + LSPosed + Zygisk)未归档源项目 · ★ 479 · NOASSERTION · 2026-07-13。参考条目:用于防御性观测、概念对照或实验室审计;不是可直接照搬的安装方案。
gauravssnl/BypassRootCheckPro主题用途:将 gauravssnl/BypassRootCheckPro 放在「安全检测、隐私与限制兼容」中作对照或审计参考,使用 android · lsposed · root · Kotlin 判断它与当前任务的边界。 上游自述(保留原文):Bypass Root Check Pro Modern Xposed API Module (with Java & Native C/C++ Hooks)未归档源项目 · ★ 367 · MIT · 2024-11-11。参考条目:用于防御性观测、概念对照或实验室审计;不是可直接照搬的安装方案。
mubashardev/WaEnhancer主题用途:将 mubashardev/WaEnhancer 放在「安全检测、隐私与限制兼容」中作对照或审计参考,使用 android · lsposed · lsposed-module · Java 判断它与当前任务的边界。 上游自述(保留原文):WhatsApp tools for Android未归档源项目 · ★ 291 · GPL-3.0 · 2026-07-18。参考条目:用于防御性观测、概念对照或实验室审计;不是可直接照搬的安装方案。
WINGS-N/WINGSV主题用途:将 WINGS-N/WINGSV 放在「安全检测、隐私与限制兼容」中作对照或审计参考,使用 Java 判断它与当前任务的边界。 上游自述(保留原文):VPN клиент под Xray и vk-turn-proxy с дизайном Samsung One UI, root раздачей VPN, bypass'ом приложений, встроенным WG (+ root mode), ByeDPI, автопереключением, Xposed модулем для скрытия VPN, и многим другим未归档源项目 · ★ 216 · GPL-3.0 · 2026-07-19。参考条目:用于防御性观测、概念对照或实验室审计;不是可直接照搬的安装方案。
hxreborn/biometric-bypass主题用途:将 hxreborn/biometric-bypass 放在「安全检测、隐私与限制兼容」中作对照或审计参考,使用 android · biometric-authentication · biometricprompt · Kotlin 判断它与当前任务的边界。 上游自述(保留原文):A simple Xposed module based on LSPosed's Modern Xposed API, that fast-forwards face unlock by skipping the biometric confirmation step in System UI on Android 10+.未归档源项目 · ★ 129 · MIT · 2026-07-01。参考条目:用于防御性观测、概念对照或实验室审计;不是可直接照搬的安装方案。
Crazyphil/digitales-amt-liberator主题用途:将 Crazyphil/digitales-amt-liberator 放在「安全检测、隐私与限制兼容」中作对照或审计参考,使用 android · android-application · xposed-module · Kotlin 判断它与当前任务的边界。 上游自述(保留原文):Removes root and bootloader checks from e-government apps未归档源项目 · ★ 109 · GPL-3.0 · 2025-01-12。参考条目:用于防御性观测、概念对照或实验室审计;不是可直接照搬的安装方案。
hxreborn/cleanshare主题用途:将 hxreborn/cleanshare 放在「安全检测、隐私与限制兼容」中作对照或审计参考,使用 android · direct-share · jetpack-compose · Kotlin 判断它与当前任务的边界。 上游自述(保留原文):Xposed module that removes Direct Share's suggested contact/conversation shortcuts from Android's Share Sheet.未归档源项目 · ★ 92 · GPL-3.0 · 2026-07-01。参考条目:用于防御性观测、概念对照或实验室审计;不是可直接照搬的安装方案。
mobile46/TrustMeAlready主题用途:将 mobile46/TrustMeAlready 放在「安全检测、隐私与限制兼容」中作对照或审计参考,使用 android · bypass · hook · Java 判断它与当前任务的边界。 上游自述(保留原文):A Xposed Module to bypass SSL pinning.未归档源项目 · ★ 83 · MIT · 2024-02-22。参考条目:用于防御性观测、概念对照或实验室审计;不是可直接照搬的安装方案。
fzer0x/SentryRadio主题用途:将 fzer0x/SentryRadio 放在「安全检测、隐私与限制兼容」中作对照或审计参考,使用 android · android-root · android-security · Kotlin 判断它与当前任务的边界。 上游自述(保留原文):(XPOSED / MAGISK / KSU) A Android forensic tool designed to detect, analyze, and map cellular network anomalies, including potential IMSI Catchers (Stingrays), cell site simulators, and suspicious network downgrades and Silent SMS.未归档源项目 · ★ 72 · GPL-3.0 · 2026-03-29。参考条目:用于防御性观测、概念对照或实验室审计;不是可直接照搬的安装方案。
Xposed-Modules-Repo/com.wowsoftware.hidemyandroid主题用途:将 Xposed-Modules-Repo/com.wowsoftware.hidemyandroid 放在「安全检测、隐私与限制兼容」中作对照或审计参考,使用 android · android-security · anti-tracking 判断它与当前任务的边界。 上游自述(保留原文):Android anti-detect module with profile isolation and spoofing未归档源项目 · ★ 71 · 协议未声明 · 2026-07-17。参考条目:用于防御性观测、概念对照或实验室审计;不是可直接照搬的安装方案。
hxreborn/amznkiller主题用途:将 hxreborn/amznkiller 放在「安全检测、隐私与限制兼容」中作对照或审计参考,使用 adblock · amazon · android · Kotlin 判断它与当前任务的边界。 上游自述(保留原文):Xposed module that hides sponsored content and ads in the Amazon Shopping app.未归档源项目 · ★ 68 · GPL-3.0 · 2026-07-13。参考条目:用于防御性观测、概念对照或实验室审计;不是可直接照搬的安装方案。
Xposed-Modules-Repo/com.gauravssnl.bypassrootcheck.pro主题用途:将 Xposed-Modules-Repo/com.gauravssnl.bypassrootcheck.pro 放在「安全检测、隐私与限制兼容」中作对照或审计参考,使用 lsposed · root · xposed-module 判断它与当前任务的边界。 上游自述(保留原文):Bypass Root Check Pro with Java & Native C/C++ Hooks未归档源项目 · ★ 36 · 协议未声明 · 2024-02-07。参考条目:用于防御性观测、概念对照或实验室审计;不是可直接照搬的安装方案。
timschneeb/XTimeMachine主题用途:将 timschneeb/XTimeMachine 放在「安全检测、隐私与限制兼容」中作对照或审计参考,使用 Kotlin 判断它与当前任务的边界。 上游自述(保留原文):Let apps travel back in time to circumvent timed app trials. Requires LSPatch (no root) or Xposed.已归档源项目 · ★ 34 · GPL-3.0 · 2023-03-28。参考条目:用于防御性观测、概念对照或实验室审计;不是可直接照搬的安装方案。
kycbypass/Android-Phone-Bypass-KYC-verification---No-root-required主题用途:将 kycbypass/Android-Phone-Bypass-KYC-verification---No-root-required 放在「安全检测、隐私与限制兼容」中作对照或审计参考,使用 仓库名、README 与发布记录 判断它与当前任务的边界。 上游自述(保留原文):Need to verify your account online through browser or phone app? Bypass KYC verifications with Vol Cam tool. Here we show you how you can browse online with your phone to verify you identity.未归档源项目 · ★ 25 · 协议未声明 · 2026-03-05。参考条目:用于防御性观测、概念对照或实验室审计;不是可直接照搬的安装方案。
Rikj000/Belfius-Root主题用途:将 Rikj000/Belfius-Root 放在「安全检测、隐私与限制兼容」中作对照或审计参考,使用 android · bank · banking · Java 判断它与当前任务的边界。 上游自述(保留原文):Simple Xposed module to support the Belfius app on Rooted devices!未归档源项目 · ★ 12 · GPL-3.0 · 2026-04-04。参考条目:用于防御性观测、概念对照或实验室审计;不是可直接照搬的安装方案。
hxreborn/io.github.tehcneko.clipboardwhitelist主题用途:将 hxreborn/io.github.tehcneko.clipboardwhitelist 放在「安全检测、隐私与限制兼容」中作对照或审计参考,使用 android · clipboard · libxposed · Java 判断它与当前任务的边界。 上游自述(保留原文):Clipboard Whitelist (API 101 fork)未归档 Fork · ★ 8 · GPL-3.0 · 2026-03-20。参考条目:用于防御性观测、概念对照或实验室审计;不是可直接照搬的安装方案。
OutrageousStorm/android-xposed-modules主题用途:将 OutrageousStorm/android-xposed-modules 放在「安全检测、隐私与限制兼容」中作对照或审计参考,使用 android · android-modding · lsposed · Python 判断它与当前任务的边界。 上游自述(保留原文):🧩 Curated Xposed / LSPosed module list — system tweaks, privacy, UI, app mods. Updated for Android 12-15.未归档源项目 · ★ 7 · 协议未声明 · 2026-05-23。参考条目:用于防御性观测、概念对照或实验室审计;不是可直接照搬的安装方案。
im-whoami/snitchtt主题用途:将 im-whoami/snitchtt 放在「安全检测、隐私与限制兼容」中作对照或审计参考,使用 android · android-security · frida-detection · C 判断它与当前任务的边界。 上游自述(保留原文):Android runtime security detection library — Frida, root, LSPosed, Magisk, hook framework detection with hardened native layer未归档源项目 · ★ 5 · NOASSERTION · 2026-04-25。参考条目:用于防御性观测、概念对照或实验室审计;不是可直接照搬的安装方案。
raise-isayan/OverrideSysPropModule主题用途:将 raise-isayan/OverrideSysPropModule 放在「安全检测、隐私与限制兼容」中作对照或审计参考,使用 android14 · bypass · certificate · C++ 判断它与当前任务的边界。 上游自述(保留原文):Android 14 Root Certificate Bypass未归档源项目 · ★ 5 · MIT · 2025-10-13。参考条目:用于防御性观测、概念对照或实验室审计;不是可直接照搬的安装方案。
cnfatal/Catched主题用途:将 cnfatal/Catched 放在「安全检测、隐私与限制兼容」中作对照或审计参考,使用 android · android-security · frida · C 判断它与当前任务的边界。 上游自述(保留原文):Android security detection toolkit — identifies Root, Xposed, Frida, and LSPatch/NPatch environments through Java reflection and raw SVC syscalls.未归档源项目 · ★ 4 · 协议未声明 · 2026-04-26。参考条目:用于防御性观测、概念对照或实验室审计;不是可直接照搬的安装方案。

3. 面向单个 App 的功能改造 · 12#

把 Via、Reddit、WhatsApp、Amazon、Google Discover/Dialer、Solid Explorer、Android Auto 与浏览器补丁按目标 App 归档。先锁定版本和作用域,升级目标 App 后重新验证。

本组共 12 项:11 个源项目、1 个 Fork,其中 0 项已归档。新手应先从“未归档的源项目”核对 README 和 Release,再用 Fork 追溯设备适配或历史差异;分组本身不等于推荐安装。

项目上游定位与识别信号状态与采用前检查
JiGuroLGC/BetterVia主题用途:将 JiGuroLGC/BetterVia 纳入「面向单个 App 的功能改造」候选路线,根据 aide · android · browser · JavaScript 核对功能、平台与版本适配。 上游自述(保留原文):让Via变得更好 / Make Via Better未归档源项目 · ★ 1150 · 协议未声明 · 2026-07-11。活跃候选:先核对 README、最新 Release、目标版本与已知问题。
Rikj000/Android-Auto-XLauncher-Unlocked主题用途:将 Rikj000/Android-Auto-XLauncher-Unlocked 纳入「面向单个 App 的功能改造」候选路线,根据 aa · android · android-auto · Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):Custom Android Auto launcher, unleash your AA app, unlock more features!未归档源项目 · ★ 304 · GPL-3.0 · 2026-04-04。边界命中:先读 README,确认它确实属于当前任务,再决定是否使用。
Xposed-Modules-Repo/com.wizpizz.reddidnt主题用途:将 Xposed-Modules-Repo/com.wizpizz.reddidnt 纳入「面向单个 App 的功能改造」候选路线,根据 android · android-app · android-application 核对功能、平台与版本适配。 上游自述(保留原文):1. LSPosed Reddit Ad Blocker / Reddidn't未归档源项目 · ★ 217 · 协议未声明 · 2026-07-18。活跃候选:先核对 README、最新 Release、目标版本与已知问题。
Xposed-Modules-Repo/com.niki914.nexus.agentic主题用途:将 Xposed-Modules-Repo/com.niki914.nexus.agentic 纳入「面向单个 App 的功能改造」候选路线,根据 agent · android · automation 核对功能、平台与版本适配。 上游自述(保留原文):Nexus / Take over your Android voice assistant with a custom AI agent — connect any LLM (Claude, GPT, Gemini), use MCP tools, Shell/SSH, and Root/Shizuku automation未归档源项目 · ★ 150 · 协议未声明 · 2026-07-18。活跃候选:先核对 README、最新 Release、目标版本与已知问题。
Xposed-Modules-Repo/com.jiguro.bettervia主题用途:将 Xposed-Modules-Repo/com.jiguro.bettervia 纳入「面向单个 App 的功能改造」候选路线,根据 android · lspatch · lsposed 核对功能、平台与版本适配。 上游自述(保留原文):BetterVia未归档源项目 · ★ 49 · 协议未声明 · 2026-07-11。活跃候选:先核对 README、最新 Release、目标版本与已知问题。
fzer0x/fucksolidexplorer主题用途:将 fzer0x/fucksolidexplorer 纳入「面向单个 App 的功能改造」候选路线,根据 android · lsposed · lsposed-module · Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):(XPOSED) Unlock premium in Solid Explorer.未归档源项目 · ★ 35 · GPL-3.0 · 2026-01-23。活跃候选:先核对 README、最新 Release、目标版本与已知问题。
hxreborn/discover-ads-filter主题用途:将 hxreborn/discover-ads-filter 纳入「面向单个 App 的功能改造」候选路线,根据 adblock · android · dexkit · Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):Filters ads and sponsored content from Google Discover.未归档源项目 · ★ 34 · GPL-3.0 · 2026-07-13。活跃候选:先核对 README、最新 Release、目标版本与已知问题。
D4vRAM369/WhatsMicFix-LSPosed主题用途:将 D4vRAM369/WhatsMicFix-LSPosed 纳入「面向单个 App 的功能改造」候选路线,根据 android · audio-boost · audio-fix · Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):🔊 LSPosed module: Fixes low microphone volume in WhatsApp voice notes on affected Pixel devices (tested on Pixel 8, Android 15/16). Configurable gain boost (-6 to +12 dB), AGC, noise suppression & compressor. Root required.未归档源项目 · ★ 20 · NOASSERTION · 2026-03-15。活跃候选:先核对 README、最新 Release、目标版本与已知问题。
fzer0x/flatequalizerhook主题用途:将 fzer0x/flatequalizerhook 纳入「面向单个 App 的功能改造」候选路线,根据 android · hooking · lsposed · Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):(XPOSED) Unlock premium in Flat Equalizer未归档源项目 · ★ 14 · 协议未声明 · 2026-02-23。活跃候选:先核对 README、最新 Release、目标版本与已知问题。
hxreborn/InstallerPlus主题用途:将 hxreborn/InstallerPlus 纳入「面向单个 App 的功能改造」候选路线,根据 android · lsposed · lsposed-module · Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):A Xposed Module that add more feature for Package Installer未归档 Fork · ★ 12 · AGPL-3.0 · 2026-01-03。Fork:采用前先与上游比较提交、Release 和维护者说明。
warren-bank/Android-browsers-LSPatch-ChromeXt主题用途:将 warren-bank/Android-browsers-LSPatch-ChromeXt 纳入「面向单个 App 的功能改造」候选路线,根据 Shell 核对功能、平台与版本适配。 上游自述(保留原文):Collection of Android web browsers patched by LSPatch to embed ChromeXt without requiring root.未归档源项目 · ★ 5 · 协议未声明 · 2024-11-30。活跃候选:先核对 README、最新 Release、目标版本与已知问题。
hxreborn/gdialer-dechip主题用途:将 hxreborn/gdialer-dechip 纳入「面向单个 App 的功能改造」候选路线,根据 android · dexkit · google-dialer · Java 核对功能、平台与版本适配。 上游自述(保留原文):Xposed module that removes the "Help us improve" feedback chip from the Google Dialer call log.未归档源项目 · ★ 5 · GPL-3.0 · 2026-06-28。活跃候选:先核对 README、最新 Release、目标版本与已知问题。

4. System UI、桌面与交互增强 · 14#

覆盖桌面、下载进度、系统分享、文件选择器、快捷设置、生物识别、手势、主题与平板 UI。只对必要系统包启用作用域,并在 System UI 循环崩溃时从安全模式禁用模块。

本组共 14 项:13 个源项目、1 个 Fork,其中 0 项已归档。新手应先从“未归档的源项目”核对 README 和 Release,再用 Fork 追溯设备适配或历史差异;分组本身不等于推荐安装。

项目上游定位与识别信号状态与采用前检查
KieronQuinn/PixelLauncherMods主题用途:将 KieronQuinn/PixelLauncherMods 纳入「System UI、桌面与交互增强」候选路线,根据 Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):A root app that enables you to add a number of features to the stock Pixel Launcher, without needing Xposed未归档源项目 · ★ 1295 · GPL-3.0 · 2025-10-30。活跃候选:先核对 README、最新 Release、目标版本与已知问题。
hxreborn/punch-hole-download-progress主题用途:将 hxreborn/punch-hole-download-progress 纳入「System UI、桌面与交互增强」候选路线,根据 android · jetpack-compose · kotlin · Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):Xposed module that shows download progress as a ring around the camera cutout.未归档源项目 · ★ 215 · GPL-3.0 · 2026-07-18。活跃候选:先核对 README、最新 Release、目标版本与已知问题。
hxreborn/remember-my-sort主题用途:将 hxreborn/remember-my-sort 纳入「System UI、桌面与交互增强」候选路线,根据 android · file-picker · kotlin · Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):An Xposed module that forces the native Android file picker to remember your sorting preferences.未归档源项目 · ★ 93 · GPL-3.0 · 2026-07-01。活跃候选:先核对 README、最新 Release、目标版本与已知问题。
oenderg/OnePlusPlusLauncher主题用途:将 oenderg/OnePlusPlusLauncher 纳入「System UI、桌面与交互增强」候选路线,根据 android · android-app · android-application · Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):OnePlusPlusLauncher / ⚡ An XPosed module for the System Launcher on OnePlus' OxygenOS, providing extra useful features未归档源项目 · ★ 53 · AGPL-3.0 · 2026-07-16。活跃候选:先核对 README、最新 Release、目标版本与已知问题。
KaeruShi/Monetify主题用途:将 KaeruShi/Monetify 纳入「System UI、桌面与交互增强」候选路线,根据 android · customization · material · Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):Customize third-party apps seamlessly to match your device style.未归档源项目 · ★ 35 · GPL-3.0 · 2026-06-22。活跃候选:先核对 README、最新 Release、目标版本与已知问题。
hxreborn/qs-boundless-tiles主题用途:将 hxreborn/qs-boundless-tiles 纳入「System UI、桌面与交互增强」候选路线,根据 android · jetpack-compose · kotlin · Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):Xposed module that raises the stock concurrent binding cap for third-party Quick Settings tiles on Android 13+未归档源项目 · ★ 32 · GPL-3.0 · 2026-07-01。活跃候选:先核对 README、最新 Release、目标版本与已知问题。
Dev97633/FLAG_SECURE-next主题用途:将 Dev97633/FLAG_SECURE-next 纳入「System UI、桌面与交互增强」候选路线,根据 enable-screenrecording · flag-secure · lspatch · Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):Xposed / LSPosed Module that Disables FLAG_SECURE globally未归档源项目 · ★ 31 · 协议未声明 · 2026-01-15。活跃候选:先核对 README、最新 Release、目标版本与已知问题。
hxreborn/biometric-app-lock主题用途:将 hxreborn/biometric-app-lock 纳入「System UI、桌面与交互增强」候选路线,根据 android · app-lock · biometric · Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):An Xposed module to lock apps behind biometric authentication未归档源项目 · ★ 31 · GPL-3.0 · 2026-07-10。活跃候选:先核对 README、最新 Release、目标版本与已知问题。
hxreborn/three-finger-swipe主题用途:将 hxreborn/three-finger-swipe 纳入「System UI、桌面与交互增强」候选路线,根据 android · gesture · jetpack-compose · Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):Standalone LSPosed API 101 implementation of three-finger swipe未归档源项目 · ★ 31 · GPL-3.0 · 2026-06-24。活跃候选:先核对 README、最新 Release、目标版本与已知问题。
KaeruShi/Weeabooify主题用途:将 KaeruShi/Weeabooify 纳入「System UI、桌面与交互增强」候选路线,根据 aesthetic · android · anime 核对功能、平台与版本适配。 上游自述(保留原文):🌸 Weeabooify is a beautiful and aesthetic theme engine for Android.未归档源项目 · ★ 27 · 协议未声明 · 2026-06-18。活跃候选:先核对 README、最新 Release、目标版本与已知问题。
Xposed-Modules-Repo/eu.hxreborn.phdp主题用途:将 Xposed-Modules-Repo/eu.hxreborn.phdp 纳入「System UI、桌面与交互增强」候选路线,根据 android · compose · jetpack-compose 核对功能、平台与版本适配。 上游自述(保留原文):Punch-hole Download Progress未归档源项目 · ★ 14 · 协议未声明 · 2026-07-16。活跃候选:先核对 README、最新 Release、目标版本与已知问题。
AToha4521/TabletKatRevival主题用途:将 AToha4521/TabletKatRevival 纳入「System UI、桌面与交互增强」候选路线,根据 android · android-app · android-application · Java 核对功能、平台与版本适配。 上游自述(保留原文):True tablet UI for KitKat, Time To make it alive now未归档 Fork · ★ 6 · 协议未声明 · 2026-05-28。Fork:采用前先与上游比较提交、Release 和维护者说明。
Laviesss/InputBlocker主题用途:将 Laviesss/InputBlocker 纳入「System UI、桌面与交互增强」候选路线,根据 android · apatch · ghost-touch · Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):未提供仓库简介未归档源项目 · ★ 6 · MIT · 2026-07-15。活跃候选:先核对 README、最新 Release、目标版本与已知问题。
Fieldtrans/EdgeGesture主题用途:将 Fieldtrans/EdgeGesture 纳入「System UI、桌面与交互增强」候选路线,根据 accessibility · accessibility-service · android · Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):One-handed edge gestures for LSPosed/Xposed on Android. 单手操作手机,单手模式未归档源项目 · ★ 5 · NOASSERTION · 2026-06-24。活跃候选:先核对 README、最新 Release、目标版本与已知问题。

5. 自动化、位置与音视频能力 · 11#

连接虚拟定位、系统级 Agent、麦克风/变声、虚拟相机、通知/SMS、歌词和跨应用机器人。重点讲权限边界、敏感数据与明确的测试同意。

本组共 11 项:11 个源项目、0 个 Fork,其中 0 项已归档。新手应先从“未归档的源项目”核对 README 和 Release,再用 Fork 追溯设备适配或历史差异;分组本身不等于推荐安装。

项目上游定位与识别信号状态与采用前检查
HuangZhuoRui/LocationSpoofer主题用途:将 HuangZhuoRui/LocationSpoofer 纳入「自动化、位置与音视频能力」候选路线,根据 Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):一款虚拟定位软件,功能单一,纯定位,需要root以及Lsposed。未归档源项目 · ★ 582 · NOASSERTION · 2026-07-18。活跃候选:先核对 README、最新 Release、目标版本与已知问题。
cxOrz/AnyWhere主题用途:将 cxOrz/AnyWhere 纳入「自动化、位置与音视频能力」候选路线,根据 android · fakelocation · java · Java 核对功能、平台与版本适配。 上游自述(保留原文):安卓虚拟定位,基于位置模拟无须 root;可在 lsposed 中启用模块防检测(需 root)未归档源项目 · ★ 492 · GPL-3.0 · 2026-06-25。活跃候选:先核对 README、最新 Release、目标版本与已知问题。
Mangi-11/Eta主题用途:将 Mangi-11/Eta 纳入「自动化、位置与音视频能力」候选路线,根据 circle-to-search · coloros · gemini · Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):在 ColorOS 上实现类似豆包手机的系统级 GUI Agent,凭借 Root 终端能力覆盖 Android 世界中更广泛的任务,并解锁 Gemini 与一圈即搜未归档源项目 · ★ 332 · 协议未声明 · 2026-07-18。活跃候选:先核对 README、最新 Release、目标版本与已知问题。
lm060719/io.mo.glassmic主题用途:将 lm060719/io.mo.glassmic 纳入「自动化、位置与音视频能力」候选路线,根据 android · lsposed · xposed · Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):开源 LSPosed 虚拟麦克风与 Android 音频链路测试模块,面向 Root 设备。未归档源项目 · ★ 36 · GPL-3.0 · 2026-07-20。活跃候选:先核对 README、最新 Release、目标版本与已知问题。
supermarsx/echidna主题用途:将 supermarsx/echidna 纳入「自动化、位置与音视频能力」候选路线,根据 android · audio · audio-capture · C++ 核对功能、平台与版本适配。 上游自述(保留原文):Real‑Time Voice Changer for Android Advanced Users未归档源项目 · ★ 21 · NOASSERTION · 2026-07-19。活跃候选:先核对 README、最新 Release、目标版本与已知问题。
lozn00/robot主题用途:将 lozn00/robot 纳入「自动化、位置与音视频能力」候选路线,根据 Java 核对功能、平台与版本适配。 上游自述(保留原文):android robot,一个基于夸应用通讯交互的机器人,可以运行在root环境执行shell命令, 本机器人是纯控制端,,具体执行发送消息的逻辑由绑定此到此机器人的对应软件进行实现.目前已经在运行的是qq机器人,接入其他的请在tg频道中查看相关接入即时通讯进程通讯示例未归档源项目 · ★ 20 · NOASSERTION · 2023-08-17。边界命中:先读 README,确认它确实属于当前任务,再决定是否使用。
zahidoverflow/shadowcam主题用途:将 zahidoverflow/shadowcam 纳入「自动化、位置与音视频能力」候选路线,根据 android · android-app · camera · Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):Android virtual camera controller with root Camera1 sync and Compose UI未归档源项目 · ★ 16 · 协议未声明 · 2026-02-21。活跃候选:先核对 README、最新 Release、目标版本与已知问题。
elhizazi1/DrawixPRO主题用途:将 elhizazi1/DrawixPRO 纳入「自动化、位置与音视频能力」候选路线,根据 android · drawing-app · kotlin · Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):Drawix Pro is a powerful, floating screen drawing and annotation platform for Android. Designed for professionals, educators, and content creators.未归档源项目 · ★ 9 · GPL-3.0 · 2026-06-07。活跃候选:先核对 README、最新 Release、目标版本与已知问题。
n00byara/NotificationCode主题用途:将 n00byara/NotificationCode 纳入「自动化、位置与音视频能力」候选路线,根据 android · android-application · android-root 核对功能、平台与版本适配。 上游自述(保留原文):Application for automatically copy auth codes from notification未归档源项目 · ★ 9 · 协议未声明 · 2025-08-12。活跃候选:先核对 README、最新 Release、目标版本与已知问题。
XZOWO/ZHITool主题用途:将 XZOWO/ZHITool 纳入「自动化、位置与音视频能力」候选路线,根据 android · hyperos · jetpack-compose · Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):小米 17 系列背屏实时歌词工具(LSPosed 模块 + root 投屏):逐字歌词、封面取色、息屏继续滚动。lyricon/词幕生态订阅端。未归档源项目 · ★ 7 · GPL-3.0 · 2026-07-13。活跃候选:先核对 README、最新 Release、目标版本与已知问题。
oftx/SmsForwarder主题用途:将 oftx/SmsForwarder 纳入「自动化、位置与音视频能力」候选路线,根据 android · bark · forward · Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):未提供仓库简介未归档源项目 · ★ 5 · 协议未声明 · 2025-11-27。边界命中:先读 README,确认它确实属于当前任务,再决定是否使用。

6. 模块索引、样板与开发工具 · 2#

把 curated list、模块仓库镜像、开发 kit 和综合 AndroidMods 当作发现入口。要求读者继续检查原仓库、目标包版本与 Modern Xposed API,而不是从列表批量安装。

本组共 2 项:2 个源项目、0 个 Fork,其中 0 项已归档。新手应先从“未归档的源项目”核对 README 和 Release,再用 Fork 追溯设备适配或历史差异;分组本身不等于推荐安装。

项目上游定位与识别信号状态与采用前检查
Xposed-Modules-Repo/Cleaner.Royall主题用途:将 Xposed-Modules-Repo/Cleaner.Royall 纳入「模块索引、样板与开发工具」候选路线,根据 android · cleaner · cleaning-data 核对功能、平台与版本适配。 上游自述(保留原文):𝗖𝗹𝗲𝗮𝗻𝗲𝗿 𝗥𝗼𝘆𝗮𝗹𝗹 🚀未归档源项目 · ★ 15 · 协议未声明 · 2026-05-17。活跃候选:先核对 README、最新 Release、目标版本与已知问题。
NagatoYuki0943/AndroidMods主题用途:将 NagatoYuki0943/AndroidMods 纳入「模块索引、样板与开发工具」候选路线,根据 仓库名、README 与发布记录 核对功能、平台与版本适配。 上游自述(保留原文):andorid root, xposed, rom, etc.未归档源项目 · ★ 14 · 协议未声明 · 2026-06-24。边界命中:先读 README,确认它确实属于当前任务,再决定是否使用。

7. Root 应用与 Xposed 边界项目 · 4#

收纳描述只说 Root、明确不用 Xposed、信息不足或借 topics 进入本类的项目。仍逐一解释用途,但不把它们冒充 LSPosed 模块。

本组共 4 项:4 个源项目、0 个 Fork,其中 1 项已归档。它们的平台、用途或分类存在边界,只作逐项核验,不当作默认安装候选。

项目上游定位与识别信号状态与采用前检查
liuran001/GJZS主题用途:将 liuran001/GJZS 作为「Root 应用与 Xposed 边界项目」边界条目,通过 android · edxposed · gjzs · Shell 核对它实际是否属于本教程。 上游自述(保留原文):搞机助手·R(原「搞机助手重制版」)已归档源项目 · ★ 289 · GPL-3.0 · 2024-04-03。边界条目:先核对实际平台、用途和分类理由,不作为默认安装源。
AraafRoyall/Cleaner-Royall主题用途:将 AraafRoyall/Cleaner-Royall 作为「Root 应用与 Xposed 边界项目」边界条目,通过 cache · cache-cleaner · cache-control · Shell 核对它实际是否属于本教程。 上游自述(保留原文):🚀 𝗔 𝗠𝗼𝘀𝘁 𝗔𝗱𝘃𝗮𝗻𝗰𝗲 𝗖𝗹𝗲𝗮𝗻𝗲𝗿 𝗙𝗼𝗿 𝗔𝗻𝗱𝗿𝗼𝗶𝗱 (Root)未归档源项目 · ★ 238 · NOASSERTION · 2026-07-17。边界条目:先核对实际平台、用途和分类理由,不作为默认安装源。
Modify24x7/BlueStacks5RT主题用途:将 Modify24x7/BlueStacks5RT 作为「Root 应用与 Xposed 边界项目」边界条目,通过 bluestacks · root · xposed 核对它实际是否属于本教程。 上游自述(保留原文):BlueStacks 5 Root Tool未归档源项目 · ★ 66 · 协议未声明 · 2022-12-01。边界条目:先核对实际平台、用途和分类理由,不作为默认安装源。
Easyllls/AppList主题用途:将 Easyllls/AppList 作为「Root 应用与 Xposed 边界项目」边界条目,通过 android · lsposed · magisk 核对它实际是否属于本教程。 上游自述(保留原文):收集整理各种好用的软件,Android、Android TV、Windows未归档源项目 · ★ 11 · GPL-3.0 · 2026-07-20。边界条目:先核对实际平台、用途和分类理由,不作为默认安装源。

开始前#

准备自己能重编译的 Demo App,包名例如 com.example.hooklab,只显示一段本地文本,不含登录、支付或个人数据。保存 Android 版本、ART/build、Root 与 Zygisk 实现、框架版本、演示模块 commit/hash 和空作用域截图。确认 ADB、Safe Mode 与 stock boot 救援可用。

LSPosed/LSPatch 也已归档且最后维护较早;JingMatrix 的 LSPatch 和 Vector 是独立发布链。任何迁移都应先禁用旧框架并重启到无模块基线,不能在同一个 Zygote 中叠加“试试看”。

操作步骤#

1. 固定框架与 Demo 基线#

从选定项目的上游 Release 获取框架,核对 hash、版本说明、Android/ART 与 Root 实现。框架加载后保持所有模块关闭,重启并打开 Demo 三次,记录原始文本、启动时间和 framework 日志。若无模块时已经有 crash,先卸载框架,不进入模块实验。

2. 审计并安装一个演示模块#

只选择开源、无网络和敏感权限、明确支持目标 API 的模块。阅读它 Hook 的包名/类/方法及 native 依赖,记录源码 commit 与 APK hash。安装后先保持 scope 为空,确认 Demo 行为没有变化;这一步证明模块不会在未选范围时全局加载。

3. 只选择一个包并采集日志#

在模块作用域中只勾 com.example.hooklab,不勾 System Framework、系统 UI、Launcher、Play services 或其他 App。按框架要求重启目标进程或设备,执行固定动作,保存变化前后截图及 framework/logcat 中“模块已加载到该包”的记录。不要以第三方 App 能否打开作为测试。

4. 按层撤销并证明恢复#

先取消 Demo scope 并强制停止/重启 Demo,确认原始文本恢复;再禁用模块并重启,随后卸载模块。最后如本次仅为实验,禁用/卸载框架并重启。每一步保存日志,确保没有第二个 framework、patch 后 APK 或后台模块残留。

验证#

验证点成功证据失败定位
无模块基线Demo 三次行为一致、日志无模块加载框架/ART 本身不兼容
空 scope模块安装但 Demo 不变化模块可能全局加载,立即撤销
单一 scope只有 Demo 改变,日志包名准确检查 scope、API 与目标 App 版本
完整撤销取消 scope 后恢复,卸载后再重启仍恢复查 patched APK、缓存或第二框架

验证还要包含系统层:SystemUI 不崩、Launcher/设置可打开、无线和锁屏正常。日志应删去设备标识后再分享;若包含 token、账号或其他 App 内容,不上传公开 issue。

排错#

现象常见原因安全处理
框架未加载Zygisk/Root 实现或 ART 版本不兼容禁用框架回基线,按一个项目文档重查
模块加载但无效果scope、方法签名或 Demo 版本变化用日志确认包/类,不扩大为全局 scope
Demo 启动崩溃Hook 参数/返回类型错误取消 scope、禁用模块,保存最小 crash 日志
SystemUI 循环崩溃错把系统包加入 scope安全模式禁用模块/框架,必要时用 stock boot
patched APK 无法覆盖重签后证书与官方版本不同只在 Demo 卸载重装;不迁移生产数据

完成清单#

  • 已注明框架、模块、Android/ART、Root/Zygisk 版本和 2026 项目状态。
  • 目标是自有 Demo,未使用真实账户、金融、DRM、反作弊或企业 App。
  • 模块源码、commit、hash、Hook 方法和权限均已审计。
  • 空 scope 不改变行为,单一 scope 只影响一个 Demo 包。
  • 已导出脱敏的框架与 logcat 证据。
  • 已按 scope、module、framework 顺序撤销并重启验证恢复。

一手资料#