# EdgeX

> 向 Xposed Edge 致敬。EdgeX 是一个面向 Android 15+ 的 LSPosed/Xposed 边缘手势增强模块，通过 `system_server` 中的系统输入 Hook，把屏幕边缘手势、硬件按键和常用 Android 动作集中到一个可配置模块中。



## 简介

EdgeX 不是普通的悬浮窗工具，而是一个需要在 LSPosed/Xposed 中启用的系统增强模块。应用本体负责配置，实际的手势识别、按键拦截、动作执行和系统侧浮层都运行在被注入的 `system_server` 进程中：

- `android`（system_server）：处理边缘触摸、硬件按键、动作分发、冰箱抽屉、剪贴板历史浮层、全局复制选择层等系统侧能力。
- `com.fan.edgex`：提供配置界面和跨进程设置存储。

适合希望在现代 Android 上复刻 Xposed Edge 式快捷操作的 Root / LSPosed 用户：返回、主页、最近任务、截屏、启动应用、执行 Shell 命令、打开冰箱抽屉、查看剪贴板历史、全局复制等都可以绑定到手势或按键。

## 非 Root 版本

如果你想使用不需要 Root 或 LSPosed 的边缘手势应用，可以尝试本项目的非 Root 版本 EdgeY：

[Google Play 上的 EdgeY](https://play.google.com/store/apps/details?id=com.fan.EdgeY)

## 功能

- **边缘手势**：支持左、右、上、下四条屏幕边缘的分段区域和全边缘低优先级区域。
- **手势类型**：支持单击、双击、长按和与边缘方向匹配的滑动动作。
- **硬件按键**：支持音量加、音量减、电源键的单击、双击、长按动作配置。
- **系统动作**：返回、主页、最近任务、展开通知栏、锁屏、截屏、音量、亮度等。
- **应用与快捷方式**：启动指定应用，触发应用快捷方式，支持受限场景下通过 Root 读取快捷方式。
- **Pie 与自定义面板**：通过手势或按键打开径向 Pie 菜单和自定义面板。
- **动作流程**：保存多个动作组合，并支持按条件执行不同动作。
- **应用切换**：直接切换到上一个或下一个最近应用。
- **冰箱抽屉**：在侧边抽屉中管理冻结应用，快速解冻并启动，之后可重新冻结。
- **剪贴板历史**：在底部浮层中展示最近 50 条剪贴板记录，点击任意条目即可将文本注入当前输入框，也可逐条删除。
- **全局复制**：从当前界面提取可访问文本，弹出选择层后复制需要的内容。
- **Shell 命令**：为手势或按键绑定自定义 Shell 命令，可选择普通执行或通过 `su` 执行。
- **音乐控制**：播放/暂停、停止、上一曲、下一曲等媒体按键动作。
- **调试与主题**：提供手势区域调试显示、SystemUI 重启入口、动作触发震动反馈和主题色配置。

## 环境要求

- Android 15 及以上。
- LSPosed / Xposed 环境，Xposed API 82 及以上。
- 当前构建配置：`minSdk 35`、`targetSdk 36`、`compileSdk 36`。
- LSPosed 作用域勾选：
  - `android` / System Framework（system_server）

### Root 相关说明

- 冰箱冻结/解冻通常需要 Root。EdgeX 会优先使用系统接口，并在需要时回退到 `su` 流程。
- 应用快捷方式优先通过 Android API 读取；如果系统限制访问，会尝试通过 `dumpsys shortcut` 读取，这通常也需要 Root。
- Shell 命令是否需要 Root 取决于你绑定的命令本身，以及该动作是否配置为通过 `su` 执行。
- 不同 ROM、SELinux 策略和 LSPosed 版本可能影响部分动作的可用性。

## 安装与启用

1. 安装 EdgeX APK。
2. 打开 LSPosed，启用 EdgeX 模块。
3. 在作用域中勾选 `android`（System Framework）。
4. 重启设备。首次启用或修改作用域后，建议完整重启。
5. 打开 EdgeX，开启手势或按键总开关并配置动作。

## 使用建议

- 第一次配置时，可以先在主页面打开调试模式，确认边缘触发区域是否符合预期。
- 手势无效时，优先检查 LSPosed 作用域、模块是否已启用、设备是否已重启。
- 冰箱和 Root 快捷方式异常时，检查 `su` 授权以及 Root 管理器日志。
- 如果系统侧浮层或动作状态异常，可以使用应用内的「重启 SystemUI」入口快速刷新。

## 已验证环境

| 设备                     | Android | Xposed 环境                                                      | Root 方案                                       |
|------------------------|---------|----------------------------------------------------------------|-----------------------------------------------|
| Pixel 9                | 16      | [`LSPosed 1.9.2-it(7455)`](https://github.com/LSPosed/Lsposed) | [KernelSU](https://github.com/tiann/KernelSU) |
| Android Virtual Device | 16      | [`Vector 2.0(3021)`](https://github.com/JingMatrix/Vector)     | [Magisk](https://github.com/topjohnwu/Magisk) |

以上只是当前开发验证环境，不代表唯一支持组合。其他设备和 ROM 可能需要额外适配。

## 反馈

提交 Issue 时建议附上：

- 设备型号、Android 版本、ROM 名称。
- LSPosed / Xposed 版本。
- 已勾选的作用域。
- 触发方式，例如「右侧中部，左划」。
- Xposed 日志或复现步骤。

## 支持

如果 EdgeX 对你有帮助，欢迎通过 [Ko-fi](https://ko-fi.com/fantasy1999) 支持项目开发。

## 致谢

EdgeX 的功能参考了 Xposed Edge / Xposed Edge Pro 的交互模式，并针对 Android 15+ 和当前 LSPosed 环境重新实现。

## License

本项目基于 [GNU General Public License v3.0](LICENSE) 开源。