LSPosed 是运行在 Zygisk 之上的新一代 Xposed 框架，面向 Android ART 运行时设计。它通过模块化的 Hook 机制，在不改动 APK 的前提下拦截并修改系统或应用行为，兼顾兼容性与稳定性，适合用于 Android 深度定制和功能扩展。
框架定位与工作原理
· 基于 Android 运行时环境运作，借助钩子技术拦截应用与系统的函数调用，不用改动原始安装包就能调整行为。
· 依托 Magisk 与 Zygisk 机制完成注入，在进程启动阶段加载自定义逻辑，实现方法级别的动态干预。
· 所有功能以独立模块形式组织，每个模块针对特定修改目标，可以按需启用或停用，彼此互不影响。
· 开发者通过公开接口编写模块代码，并利用内置日志系统追踪执行状态，便于定位异常调用链。
激活流程说明
1. 确认设备上已经安装 Magisk。
2. 使用 Zygisk 版本时，在 Magisk 应用内开启 Zygisk；使用 Riru 版本时，安装 Riru 26.1.7 或更高版本。
3. 下载 LSPosed。
4. 进入 Magisk 的「模块」标签页，安装 LSPosed。
5. 重启设备，稍等片刻后会看到 LSPosed 状态通知。
6. 点击通知启动 LSPosed，检查激活状态。
模块安装与启用方法
1. LSPosed 本身是框架，需要配合模块才能工作。可以在应用内或网页上浏览模块。
2. 下载并安装模块，安装方式与普通应用相同。
3. 安装完成后进入 LSPosed 的模块页面，点击已安装的模块，打开启用开关。
4. 选择模块需要作用的应用程序。多数新模块支持显示推荐范围，LSPosed 会自动完成选择。
5. 部分老旧模块需要注入到每个应用中，这种方式风险较高。LSPosed 不支持「全选」，需要用户手动逐个勾选应用，策略与 MagiskHide 相同。
未安装状态的排查步骤
1. 下载 LSPosed 模块（Zygisk 版）。
2. 打开 Magisk，进入设置，开启 Zygisk。
3. 打开 Magisk，进入模块页面，选择从本地安装。
4. 重启设备，从通知栏点开 LSPosed。如果通知没有显示，可以在拨号键输入 *#*#5776733#*#* 进入。
5. 创建快捷方式，关闭状态通知。
6. LSPosed 显示「已激活」即表示刷入成功。
核心功能一览
· 动态运行时 Hook：基于 ART 实现方法级实时拦截，无需重打包 APK 即可修改参数、返回值及执行逻辑。
· 模块化扩展体系：插件按需加载卸载，多模块并行运行互不干扰，支持社区资源分发与自由功能扩展。
· 系统级深度拦截：支持跨应用及系统 API Hook，提供完整调用链控制，实现底层行为修改与增强。
· 广泛兼容稳定：适配多个 Android 版本与主流架构，模块运行隔离以降低冲突，内置日志调试保障稳定性。
· 开发者友好生态：提供完善的 Hook API 与调试支持，降低开发门槛，依托活跃社区实现高度定制化。
功能特性说明
· 运行时拦截支持对目标方法的参数进行重写或替换返回值，从而改变程序原有的判断分支与输出结果。
· 模块仓库提供多种社区贡献的功能扩展，涵盖界面调整与系统优化，下载后直接加载即可生效。
· 多版本 Android 系统适配持续跟进，新发布系统版本通常会在短期内完成兼容性测试与修正。
无法启动的常见原因
· Root 环境配置不匹配：Magisk 未开启 Zygisk，或 KernelSU 缺少 ZygiskNext 依赖。
· 系统版本与框架不兼容：旧版 LSPosed 无法适配 Android 14 及以上新系统。
· SELinux 权限校验失败：强制模式下核心目录文件访问权限被系统拦截。
· 模块冲突或数量过载：多模块 Hook 重叠引发注入链路崩溃，导致无法启动。
· 框架核心文件损坏：缓存与配置数据异常导致管理器闪退、无法加载。
· 厂商省电策略拦截：后台进程被系统电池优化机制强制终止运行。
框架亮点
· 调用链控制能力允许开发者精确指定拦截时机，可以在方法执行前、执行后或替换整段逻辑。
· 模块间采用隔离运行策略，各自占用独立内存空间，避免单个模块异常导致全局崩溃。
· 调试辅助工具包括实时堆栈查看与变量监视，帮助开发者在开发周期内快速验证钩子效果。
更新日志
新增
· 实现 libxposed API 102。
· 适配 Android 17 QPR1 Beta 4。
维护
· 原计划 2.1.0 废弃 NewXSharedPreferences 推迟到 2.2.0，强烈建议 legacy 模块尽快迁移到 libxposed。
改进
· 大幅提升被 Hook 方法的性能。
· 优化还原内联钩子逻辑。
· 优化 dex 优化器包装的挂载逻辑。
· 优化一系列 UI 体验。
修复
· 修复 XposedBridge.unhookMethod 行为异常。
· 修复了一个全局检测点。
· 修复 TalkBack 重复朗读、未朗读勾选状态等无障碍问题。
