EdgeX_change/README_CN.md

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

功能

• 边缘手势：支持左、右、上、下四条屏幕边缘的分段区域和全边缘低优先级区域。
• 手势类型：支持单击、双击、长按和与边缘方向匹配的滑动动作。
• 硬件按键：支持音量加、音量减、电源键的单击、双击、长按动作配置。
• 系统动作：返回、主页、最近任务、展开通知栏、锁屏、截屏、音量、亮度等。
• 应用与快捷方式：启动指定应用，触发应用快捷方式，支持受限场景下通过 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)	KernelSU
Android Virtual Device	16	Vector 2.0(3021)	Magisk

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

反馈

提交 Issue 时建议附上：

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

支持

如果 EdgeX 对你有帮助，欢迎通过 Ko-fi 支持项目开发。

致谢

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

License

本项目基于 GNU General Public License v3.0 开源。