LSPatch 免 Root Xposed 框架使用指南
关于本站：第三方整理的中文文档站，非官方页面；内容来自公开资料整理，功能与界面以官方最新版为准。
LSPatch 是什么
LSPatch 是一款面向 Android 的免 Root Xposed 框架，由 LSPosed 核心团队推出。它不走传统的 Zygisk/Riru 注入链路，而是直接把 LSPosed 运行时组件（dex + native so）嵌入目标应用的 APK，让被修补的应用在自己进程里加载并执行 Xposed 模块。
这条路线的最大优势是——不需要解锁 Bootloader、不需要 Root、不需要刷 Magisk，只要手上有 APK 文件或者已安装的应用，就能在几分钟内产出一个带模块的定制包。对于手头有锁 BL、不敢动系统分区、或者只是想给某几个 App 加点私货的用户来说，这是目前最务实的方案。
产品档案速览
| 项目 | 说明 |
|---|---|
| 定位 | 免 Root 的 APK 补丁式 Xposed 框架 |
| 最低系统 | Android 9（API 28） |
| 最高系统 | 理论与 LSPosed 同步，实际以社区魔改版为准 |
| 两种入口 | Manager App（Android 端）/ lspatch.jar（电脑端） |
| 两种修补模式 | 本地模式（管理器后台）/ 便携模式（模块嵌入 APK） |
| 依赖 | Shizuku（管理器快速安装用，非强制） |
| 开源协议 | GPL-3 |
| 项目状态 | 原版 2023.12 归档停更，opatch/onpatch 等第三方分支仍在维护 |
| 来源 | fork 自 Xpatch，核心来自 LSPosed 框架 |
本站导览
下面是几条主线的入口，按需跳转。
① 先搞清楚再动手：框架认知
免 Root Xposed 框架家族图谱 从太极、Xposed、LSPosed 到 LSPatch，一张图看懂谁是什么、各自的注入链路、优缺点分别在哪。如果之前没接触过免 Root 框架，建议先看这组。
② 准备环境：依赖与安装
设备兼容性检查 先确认自己的手机 Android 版本够不够、BL 锁状态、厂商系统有没有已知坑。然后是 Shizuku 部署与授权——Manager App 的快速安装功能依赖它，不装也能跑但每次补丁完得手动去文件管理器找 APK。
③ 修补实战：选模式、调参数、跑流程
完整操作流程分散在 Manager 修补实战 和 CLI 修补 两组里。本地 vs 便携这个选择直接决定了后续维护成本，建议先读 两种修补模式的取舍 再动手。
④ 模块配置与兼容性
模块作用域勾选 是新手最容易踩的坑——模块装了、启用了、就是不生效，十有八九是作用域没勾对。模块兼容性清单 汇总了哪些模块天然不适配补丁式框架（比如作用域是系统级的、运行时依赖 LSPosed Provider 的）。
⑤ 故障排查与进阶
修补失败、闪退、签名冲突、Shizuku 连不上——最常见的五件事集中在 故障排查分组。玩熟了之后可以看 opatch/onpatch 等魔改版本 和 便携包二次分发。
几条重要提醒
- LSPatch 原版已于 2023 年 12 月归档停更，Android 14/15 的适配工作主要在 opatch、onpatch 等第三方分支上。下载时注意区分。
- 修补后签名会变。对签名校验严格的应用（微信、支付类、游戏）大概率会触发校验失败，这是补丁方案的天生缺陷，无 Root 情况下无解。
- 只能用作用域是应用本身的模块。作用域是系统 Framework 的模块（比如修改状态栏、系统设置）无法通过补丁生效。
- 每次应用或模块更新后，需要重新修补（便携模式）或至少重启应用（本地模式）。
本站内容为社区资料整理，功能与参数可能随版本变化，以官方最新版为准。