HyperTweaks 是一个面向 HyperOS 的个人 LSPosed 模块，用于实现一些系统行为微调和个人使用场景优化。
当前功能主要包括：
- AOSP IME 导航栏行为优化
- 输入法导航栏按钮自定义
- Android 16 输入法切换按钮行为调整
- 应用后台保活保护
- Google Photos 中国大陆地图坐标显示修正
- Miuix UI 动态取色设置页
- 中英文界面支持
本项目主要用于个人设备和个人需求，不保证适配所有 HyperOS / Android 版本。
测试设备：Xiaomi 15u，HyperOS 3.0.303.0
HyperTweaks 默认不会安装功能 Hook。需要在设置页中分别启用：
- 输入法微调
- 应用保活
- Google Photos 地点坐标修正
修改开关后，Hook 安装状态通常需要重启目标进程或重启设备后完全生效。
在 Android 16 / API 36 中，系统输入法切换按钮的短按行为变为直接切换到下一个输入法，长按才会弹出输入法选择器。 HyperTweaks 增加了一个额外选项，可以将短按行为改为直接弹出“选择输入法”列表。
当前 system_server 侧 IME Hook 的版本策略：
- Android 13 / API 33 到 Android 15 / API 35：使用
InputMethodManagerServiceHook - Android 16 / API 36 及以上：使用
InputMethodManagerServiceImplHook - Android 12 / API 32 及以下：不支持当前 system_server 侧 IME Hook
说明：
InputMethodManagerServiceHook依赖 AOSP 的InputMethodManagerServiceIME 导航栏结构， 同时还会尝试调用 HyperOS 私有的InputMethodManagerServiceStub。 因此 Android 版本满足条件不代表所有 ROM 都一定可用。
HyperTweaks 支持通过包名列表保护指定应用，减少 HyperOS 后台清理导致的应用重载问题。
主要用于解决类似 Firefox / Fenix 在后台一段时间后返回前台页面重载的问题。
保活功能会尝试：
- 拦截部分系统后台清理路径
- 拦截部分 package cleanup / process kill 行为
- 保护目标应用主进程和子进程
- 调整目标进程的
oom_score_adj
示例包名：
org.mozilla.fenix
org.mozilla.firefox
org.mozilla.firefox_beta
org.mozilla.focus
保活功能不能保证阻止所有系统级或内核级进程回收。它主要用于减少 HyperOS 主动后台清理导致的问题。
该功能仅作用于 com.google.android.apps.photos 主进程中的地图展示链路，将中国大陆范围内用于渲染的 WGS-84 坐标转换为 GCJ-02。
当前核心覆盖：
- 地图 Marker 与 Marker 动画目标；
S2Index.BuilderImpl热力图批次；- 地图相机和当前位置显示的已识别链路；
- 单张照片地图预览的已识别链路。
实现保留精确包名、主进程、功能开关、合法坐标、中国大陆边界、重复转换和失败放行保护。转换只修改传给地图的对象或临时数组，不写入照片 EXIF、Google Photos 数据库、上传数据或地点编辑数据。
已验证环境：
| 设备 | 系统 | Google Photos | 已验证路径 |
|---|---|---|---|
| Xiaomi 15 Ultra | HyperOS 3.0.303.0 | 7.83 | Marker、S2 热力图；Home 与合集入口在无活动地图会话时也能转换 |
已知限制：
- Google Photos 混淆类和方法会随版本变化；升级后必须重新检查目标解析和安装日志。
- 7.83 中可选 Maps 内部
MapView类不可由当前 ClassLoader 解析，不计入核心覆盖。 - 当前定位仍依赖已识别 controller、请求时序与调用来源约束；非地图
Location读取必须在真机回归中确认不受影响。 - Marker 对象或热力图数组被复制后，基于对象/内容的重复保护仍需在目标版本上回归。
- 上传照片、编辑地点和非地图场景由实现边界保证不主动修改，正式发布前仍需完成验收清单中的真机检查。
设置页使用 Kotlin、Jetpack Compose 和 Miuix UI 实现，并保留 Material 3 主题兼容层，支持：
- 系统 Monet 动态取色
- 深色模式
- 英文 / 简体中文
- 输入法导航栏配置
- 应用保活包名列表配置
当前固定使用 Miuix 0.9.3。Miuix 仍属于实验性依赖，API 可能发生不兼容变更；
升级前必须查看 release notes 并验证项目适配层，不允许使用动态版本号。
建议使用：
- Android Studio 最新稳定版
- JDK 17 或更高版本
- Android SDK 36 / 37
- 已配置 Android SDK Build Tools
- 一台已安装 LSPosed 的 Android / HyperOS 设备
克隆项目后，在项目根目录执行：
./gradlew :app:assembleDebugWindows PowerShell：
.\gradlew.bat :app:assembleDebug构建产物位于：
app/build/outputs/apk/debug/app-debug.apk
adb install -r app/build/outputs/apk/debug/app-debug.apkWindows PowerShell：
adb install -r app\build\outputs\apk\debug\app-debug.apk安装后：
- 打开 LSPosed
- 启用 HyperTweaks 模块
- 勾选需要作用的范围
- 重启手机
建议作用域至少包含：
system
如果使用输入法相关功能，请勾选对应输入法包名，例如：
com.google.android.inputmethod.latin
com.baidu.input_mi
com.sohu.inputmethod.sogou.xiaomi
com.iflytek.inputmethod.miui
com.tencent.wetype
如果使用保活功能，可以根据需要勾选：
system
com.miui.powerkeeper
com.miui.securitycenter
com.miui.securitycenter.remote
com.lbe.security.miui
目标应用包名
例如 Firefox Nightly / Fenix：
org.mozilla.fenix
如果使用 Google Photos 地图坐标修正，请勾选：
com.google.android.apps.photos
CI 会执行 JVM 单元测试、Lint、Xposed 迁移校验、Debug/Release 构建，并在 API 35、API 36 模拟器中安装和启动设置页。模拟器只验证模块未注入时的 APK 安装与启动安全，不能证明 LSPosed Hook 可用。
正式发布仍必须人工确认：
- 模块关闭、模块开启但全部功能关闭时，系统和目标应用正常；
system_server、SystemUI 和输入法进程没有 crash loop；- IME、KeepAlive、Google Photos 各至少完成一条真机功能回归；
- 日志中没有假
Installed、重复安装或未解释的终止失败。
查看模块日志：
adb logcat | grep HyperTweaksWindows PowerShell：
adb logcat | rg HyperTweaks保活功能常见关键日志：
keep-alive packages updated
tracked protected process
write oom_score_adj
blocked package cleanup
查看目标应用进程的 oom_score_adj：
adb shell 'ps -A | grep "[f]enix" | while read u p rest; do adj=$(cat "/proc/$p/oom_score_adj" 2>/dev/null); echo "$p $adj $rest"; done'- 本项目依赖 LSPosed / libxposed，仅适用于已安装并启用 LSPosed 的设备。
- Hook 系统和厂商私有 API 存在版本兼容风险。
- HyperOS 不同版本的后台管理实现可能不同，保活效果可能因设备和系统版本而异。
- 不建议把保活功能用于大量应用，可能增加内存占用和耗电。
- 本项目主要用于个人学习和个人设备，不建议在不了解风险的情况下用于主力机。
感谢以下项目和社区：
特别感谢 Mi_AOSP_IME 项目提供的思路参考。本项目在其功能方向基础上重新设计为 Kotlin + Compose 的个人 HyperOS 微调模块。
Copyright (c) 2026 togls. All rights reserved.
本项目公开发布仅用于个人学习、研究和参考目的。未经作者明确许可，不授权复制、修改、分发、再授权或商业使用。
第三方项目、构建工具和依赖的来源关系见 NOTICE.md。各第三方组件继续适用其自身许可证；本项目许可证不会覆盖或替代这些条款。