打音游时最容易毁掉一局（甚至一次全连）的不是手速，而是误触：手掌蹭到屏幕边缘触发返回、 拇指托在下沿把桌面滑出来、滑到顶部把通知栏拉下来。 EdgeGestureGuard 用 LSPosed 在 SystemUI / 桌面进程里精确拦掉这些边缘手势， 只在你要打游戏的时候生效，退出即恢复系统原样。
EdgeGestureGuard 是一个 LSPosed 模块（不修改 system 分区、不是 Magisk 模块）， 按「前台应用 + 手势类型」屏蔽三类系统手势：
| 手势 | 拦截位置 | 依赖作用域 |
|---|---|---|
| 左 / 右边缘返回 | SystemUI（返回手势输入通道） | System UI |
| 顶部下拉通知栏 | SystemUI（Shade 触摸链） | System UI |
| 底部上滑（回桌面 / 最近任务） | 桌面进程（Quickstep 手势输入） | System UI + 桌面 |
总开关是「游戏模式」：应用规则只在游戏模式开启时参与判定； 关闭时手势路径只做一次内存判断 —— 没有 Binder、没有磁盘 IO、不读规则表，等于模块没装。
- 按应用配置：为每个应用勾选要屏蔽的手势（左 / 右 / 顶 / 底）。
- 游戏模式：通过常驻通知按钮 / 控制中心磁贴 / 控制器内按钮开启。
- 开启后按当前应用的规则屏蔽手势；
- 锁屏→解锁自动退出（可在「阈值/验证」里改为锁屏后保持）；
- 开启期间隐藏顶部状态栏（连窗口根一起隐藏，不留半透明残留）。
- 音游友好：顶部 / 底部屏蔽区可调（默认各占屏幕高度 12%），避免吃掉判定区。
- 零轮询：用系统推送（TaskStackListener）感知前台变化，空闲时没有定时器。
- 不 Hook 目标游戏进程、不改系统分区、不联网、无广告。
- 不读取窗口内容；前台应用只取包名 / 类名。
- 不承诺屏蔽导航栏「小白条」的临时滑出：那是 system_server 的 DisplayPolicy 在底边滑动时主动显示的 transient bar，属于系统行为；用户态 Hook 只能做到「出现后立刻藏」，会闪。
- 安装 APK（Release 里的
EdgeGestureGuard-*-release.apk，已用正式密钥签名）。 - 打开 LSPosed → 模块 → 启用「边缘手势守卫」。
- 作用域（推荐值已内置，安装后一般会自动勾好）：
- ✅
System UI（com.android.systemui）—— 必须 - ✅ 你的桌面 / Launcher（如
com.android.launcher3）—— 底部上滑屏蔽需要
- ✅
- 重启手机（模块代码运行在 SystemUI / 桌面进程里，不重启不生效）。
只勾 System UI 也能用：左右返回、顶部下拉、状态栏隐藏都正常，只有底部上滑屏蔽不生效。
- 打开「边缘手势守卫」，搜索并点开应用，勾选要屏蔽的手势。
- 需要时开启游戏模式（通知按钮 / 磁贴 / 控制器按钮）。
- 退出：锁屏后解锁（默认）、点通知上的「退出游戏模式」、或磁贴 / 控制器按钮。
- 「阈值/验证」里可调顶部 / 底部屏蔽区比例（2%~30%）， 或打开「验证模式」只记日志不拦截，用来确认坐标是否命中。
状态卡（点「详情」展开）会显示 Hook 挂载情况、前台来源、规则数量、
以及底部手势的实测计数（seen= / blocked=）—— 不猜、不假装生效。
| 环境 | 状态 |
|---|---|
| LineageOS 24 / Android 17 (SDK 37) | 真机验证：左右返回 / 顶部下拉 / 底部上滑 / 游戏模式 |
| Android 11+ (API 30+) | 按公开 API 下限设计，未逐一验证 |
| 3 键导航 | 边缘返回规则无实际意义，其余可用 |
- 导航栏小白条的 transient 滑出无法拦截（见「不做什么」）。
- 顶部 / 底部屏蔽区按屏幕高度百分比计算，横竖屏切换会自动重算；多窗口 / 折叠屏下属近似。
- 通知栏已展开时不会拦截顶部触摸（否则无法点击通知）。
- 前台应用识别依赖系统接口；拿不到前台包名时按设计不屏蔽（安全默认）。
本项目仅供个人设备上的合法定制使用。修改系统手势行为属于高级操作， 请自行承担使用风险；因使用本模块导致的任何问题由使用者负责。