HyperHand — 把 iPhone 的手感搬进 HyperOS

给 小米 14 / HyperOS 3(Android 16) 用的系统增强模块。不改系统文件、不替换 APK, OTA 不受影响,停用就恢复原样。

它解决什么问题?

问题一:快捷菜单得「松手再点」,两步太麻烦

HyperOS 长按桌面图标弹出菜单后,必须先松手、再点一下菜单项;手指一滑,图标就被拖着跑, 菜单还会被系统当成「拖过阈值」直接关掉。

装上后:长按图标,手指别松,直接滑到要的那项,抬手就打开。菜单在图标上方或下方都行, 图标不会乱动,滑过的项有浅灰按压 + 震动反馈。

问题二:单手模式太难触发

HyperOS 的单手模式要在屏幕最底部一条 25dp 窄条上下滑,手稍微高一点就没反应,而且没法调。

装上后:触发区扩大到 134dp(可调),覆盖整个 dock;按下落点判定,不跟桌面下拉抢手势。 动画快慢、模糊壁纸背景、下滑开通知/控制中心也都能调。

截图

浅色(默认):

概览 快捷菜单滑选 关于
概览 滑选设置 关于
深色模式
概览 快捷菜单滑选 关于
概览 滑选设置 关于

安装

从 Releases 下载 HyperHand.apk,在 Vector / LSPosed 中启用即可。

  • 作用域:com.android.systemui、com.miui.home
  • 需要 libxposed API 102(Vector 2.x / 新版 LSPosed)
  • 设置页可调触发区、动画、模糊背景,以及滑选开关、角度和容差

源码

https://github.com/zPan2327/HyperHand

License

MIT

Releases

11/20/2026, 9:53:09 AM

HyperHand 3.3.4 差异对比(GitHub v3.3.3 → 本地最新版)

对比基线

项 GitHub 版 本次最新版
版本 3.3.3 3.3.4
versionCode 30303 30304
GitHub tag v3.3.3(commit bd5788a) v3.3.4
LSP 仓库 tag 30303-3.3.3 30304-3.3.4
签名指纹 912FA6BF…6A7A 912FA6BF…6A7A(不变,可直接覆盖安装)

对比方式:导出 GitHub v3.3.3 源码树,与本地工作区逐文件 diff(排除 build / 缓存 / 本地配置)。
结果:18 个已有文件修改,新增 15 个文件(10 个 MIUIX 对话框宿主 + G2 圆角工具 + 5 份 SonyPods 参考源码),
不计文档/截图约 +1,100 / −600 行。


一、设置页交互全面 MIUIX 化(本次最大改动)

目标:设置页与对话框不再手写近似实现,逐字复用 SonyPods / MIUIX 源码,只替换中文文案。

1. 改动即时保存生效,去掉二次保存

  • MainActivity.java / SettingsPage.java:任何开关 / 数值 / 选择改动后立刻全量广播给
    SystemUI 写入 Settings.Global,不再需要点「保存并立即生效」。
  • 移除设置页底部保存按钮与悬浮保存胶囊;顶栏副标题由「改动保存后立即生效」改为
    「改动后立即生效」;第一个 tab 副标题「单手模式增强」删除,只留「概览」。
  • 重启对话框移除「未保存会丢失」提示;重启作用域去掉第二个确认框——第一个对话框点确定后
    直接重启对应进程(/systemui 或桌面)。

2. 选择类交互统一改为 MIUIX Dropdown

  • 新增依赖 top.yukonga.miuix.kmp:miuix-preference-android:0.9.4-rc01(glass/build.gradle.kts)。
  • 原「触发模式 / 缓动曲线 / 拉开哪个」三个手写单选对话框,以及约 23 个数值行的 Slider
    参数子页,全部改为 MIUIX OverlayDropdownPopup(DropdownImpl 选项行 + 勾选态 + 每项说明)。
  • 新增全屏透明 Compose 宿主 MiuixDropdownHost.kt 把 popup 桥接进 Java 设置页:锚点按被点行
    定位、空间不足自动翻到上方、无弹窗时把触摸还给下层;切页 / 返回 / 重启前自动收起。
  • 依赖开关的项(慢滑距离、模糊半径、拉开哪个等)补上 MIUIX 禁用态,值不清零、再打开保留。

3. 数值设置改为 MIUIX 单列 NumberPicker

  • 新增 MiuixNumberPickerHost.kt + LocalNumberPicker.kt:带数字的设置项由 Dropdown 改为
    SonyPods「临时电量岛显示时长」同款 MIUIX NumberPicker 单列滚轮对话框。沿用「索引 = 值」
    数据流,min/max/step 生成的有限选项 + 回写链路完全不变。
  • LocalNumberPicker.kt 从 MIUIX 0.9.4-rc01 源码复制并修复测量时序:itemHeightPx 直接由
    itemHeight × density 取整派生,移除 onSizeChanged 二次测量——修复首次打开时偶发只显示
    一个数字、第二次打开才正常的问题。

4. 选择行箭头改为 MIUIX 上下双箭头

  • Icons.java 新增 ArrowUpDownView:逐字复制 miuix-ui 的 10×16dp ArrowUpDown 矢量路径。
    触发模式 / 缓动曲线 / 拉开哪个及所有数值行右侧的 > 换成该双箭头;只有真正跳转新页面的行
    (关于页链接)保留 >。

5. 复选框形状对齐 MIUIX

  • MiuixCheckbox.java:26dp 圆形 CircleShape、未选中 secondary 实心(非描边)、勾路径取
    miuix viewport(23f) 三点坐标 (5,9.4)→(10.3,14.9)→(17.9,5.1) 按比例换算,描边宽
    size×0.09,按物理弹簧(987/0.6)在 secondary/primary 间过渡。Theme.java 新增 secondary
    色(light #E6E6E6 / dark #505050)。

6. 关于页 / 对话框 / 许可

  • 新增 7 个对话框宿主:InfoDialogHost.kt、SonyPodsDialogHost.kt、SimpleDialogs.kt、
    RestartScopeDialog.kt、IslandDurationDialog.kt 及 DialogStrings.kt——信息类 / 重启 /
    时长等对话框统一由 MIUIX OverlayDialog 渲染,与宿主同处一个 window。
  • MIT 许可改为中文翻译在前、英文原文在后,保留 HyperHand · MIT License 字标。
  • 字标字重改为 800(Theme.wordmark(),不识别数值字重的 ROM 回退 Bold);Logo 用
    G2RoundedRect.java 的 G2 连续曲率圆角(Kyant0/Shapes 算法逐行移植)。

二、概览页

  • 新增 StatusCardHost.kt:状态卡从 Java 手写 FrameLayout 换成真正的 MIUIX Card
    (pressFeedbackType = PressFeedbackType.Tilt、showIndication = true),倾斜 / 高亮 / 回正
    全由 MIUIX 原生实现——按住边角持续形变、松手回正,手感与 SonyPods 一致;不再用 Java 手写
    rotationX/Y + cameraDistance 复刻(大卡上会透视爆炸)。module 侧 Canvas 图标 View 经
    AndroidView 原样嵌入,零视觉差异;颜色与右下角图标位置按原版逐像素还原。
  • 两张小卡文案改为「单手模式增强 / 快捷菜单滑选(已启用 / 已禁用)」;状态值字重加粗。
  • 副标题「单手模式增强」删除,只留「概览」。

三、功能修复

1. 底栏液态玻璃「上下冒黑块」

  • ViewBackdrop.kt:原先采样区被 wanted.intersect(source) 裁到 source 边界,底栏贴底时
    折射 padding 越出 source,位图铺不满 layer,透明缝被 lens/色散按 half4(0) 采样成纯黑。
    改为保留完整 layer 区域(仅整体不相交才放弃该帧),并新增 fallbackColor:capture 用页面
    底色铺底(PorterDuff.SRC)、drawImage 前先 drawRect 铺满,任何未覆盖缝隙都是不透明
    页面底色。DampedDragAnimation.kt:pressProgress 加 coerceIn(0f,1f),避免连点 / 快拖时
    spring 越界叠加出错配中间态。

2. 菜单开着时点背景图标误开其它 App

  • ShortcutSlide.java:新增 hostAnchorX/Y——菜单弹出瞬间记下长按宿主图标 A 的按下锚点。
    菜单开着时只有点在 A 上才「关菜单 + 打开 A 的 App」;点背景模糊的其它图标 B 走
    isHostIcon()(图标矩形是否含锚点,外扩 8dp 容差)判定为 false 后只关菜单、不打开 B。
    不受图标重排 / View 复用影响。

3. 滑选交互其它一致性

  • PagePager.java / Ui.java:底栏弹性、横滑边界阻尼、切页速度等手势曲线对齐 MIUIX
    MiuixOverscrollEffect,修正快速来回拖动时的越界回弹与指示器反馈。

四、文档

  • README.md:调参流程由「改数值 → 保存 → 生效」改为「自动保存、立即生效」;新增维护者
    签名一致性警告(hyperhand.keystore 与 Secret ANDROID_KEYSTORE_B64 必须同一把,当前指纹
    912FA6BF…6A7A),发版只走 CI 打 tag 一条路,避免竞态覆盖导致用户无法覆盖安装。
  • docs/发布到模块仓库.md:新增「必须保持一致的『三处密钥』」小节,列明本地 / Secret / CI
    恢复三处位置与当前指纹。
  • docs/sonypods-dialogs-reference/:新增 5 份 SonyPods 原版对话框源码作为逐字复刻的参考底稿。
  • CHANGELOG.md:3.3.4 正式版条目,完整记录上述改动。

五、变更文件清单

修改(18):CHANGELOG.md、README.md、docs/发布到模块仓库.md、glass/build.gradle.kts、
HyperGlassBarView.kt、ViewBackdrop.kt、DampedDragAnimation.kt、AboutPage.java、Icons.java、
MainActivity.java、MiuixCheckbox.java、MiuixDialog.java、OverviewPage.java、PagePager.java、
SettingsPage.java、ShortcutSlide.java、Theme.java、Ui.java

新增(15):

  • glass/.../glass/dialogs/:DialogStrings.kt、InfoDialogHost.kt、IslandDurationDialog.kt、
    LocalNumberPicker.kt、MiuixDropdownHost.kt、MiuixNumberPickerHost.kt、RestartScopeDialog.kt、
    SimpleDialogs.kt、SonyPodsDialogHost.kt、StatusCardHost.kt
  • module/.../hyperhand/G2RoundedRect.java
  • docs/sonypods-dialogs-reference/:AppPickerDialog.kt、LeAudioAlertDialog.kt、
    LeAudioPairingHelpDialog.kt、PodImageConfigDialog.kt、README.md

六、发布与安装

  • GitHub:zPan2327/HyperHand tag v3.3.4,CI 自动构建并把签名 APK 挂到 Release。
  • LSP 仓库:Xposed-Modules-Repo/io.github.zpan2327.hyperhand tag 30304-3.3.4,同步 Release + APK。
  • 签名指纹不变(912FA6BF…6A7A),可直接覆盖安装 3.3.3,无需卸载;需支持 libxposed API 102 的框架。

Assets

1

11/18/2026, 3:53:09 PM

HyperHand 3.3.3(versionCode 30303)

单手模式增强:扩大底部触发区、按速度判定下滑、与下拉通知/控制中心互斥,
缩小动画 / 布局 / 触摸映射 / 退出方式全部沿用 HyperOS 原生实现。

需要支持 libxposed API 102 的框架(Vector / 新版 LSPosed)。

Assets

1

11/18/2026, 11:59:37 AM

HyperHand 3.3.2(versionCode 30302)

单手模式增强:扩大底部触发区、按速度判定下滑、与下拉通知/控制中心互斥,
缩小动画 / 布局 / 触摸映射 / 退出方式全部沿用 HyperOS 原生实现。

需要支持 libxposed API 102 的框架(Vector / 新版 LSPosed)。

Assets

1

11/18/2026, 11:38:40 AM

HyperHand 3.3.1(versionCode 30301)

单手模式增强:扩大底部触发区、按速度判定下滑、与下拉通知/控制中心互斥,
缩小动画 / 布局 / 触摸映射 / 退出方式全部沿用 HyperOS 原生实现。

需要支持 libxposed API 102 的框架(Vector / 新版 LSPosed)。

Assets

1

11/18/2026, 10:32:55 AM

HyperHand 3.3.0(versionCode 30300)

本次新增:与 iPhone 类似的桌面快捷菜单滑选。

  • 长按图标弹出快捷菜单后手指不松,直接滑到目标项抬手即选中(原生需「松手再点」两步)。
  • 菜单在图标上方或下方都可用,不写死方向。
  • 滑选时本图标和周围图标都不重排、不漂移;命中项是浅灰按压态 + 系统「设置」边界反弹同款震动。
  • 菜单开着点图标可直接打开 App(静默、无多余震动);点菜单项不会误触底下压着的图标。
  • 设置页可调滑选开关、夹角、命中容差与起判位移。

单手模式增强(历史功能)保持不变:扩大底部触发区、按速度判定下滑、与下拉通知/控制中心互斥,
缩小动画 / 布局 / 触摸映射 / 退出方式全部沿用 HyperOS 原生实现。

环境

  • 需要支持 libxposed API 102 的框架(Vector 2.x / 新版 LSPosed)。
  • 作用域:com.android.systemui、com.miui.home。
  • 实测:小米 14 / HyperOS 3(Android 16)。

完整更新日志见 CHANGELOG.md。

Assets

1

11/13/2026, 11:15:52 AM

HyperHand 3.1.0(versionCode 30100)

单手模式增强:扩大底部触发区、按速度判定下滑、与下拉通知/控制中心互斥,
缩小动画 / 布局 / 触摸映射 / 退出方式全部沿用 HyperOS 原生实现。

需要支持 libxposed API 102 的框架(Vector / 新版 LSPosed)。

Assets

1

3.0.3-beta.2

Pre-release

11/13/2026, 9:38:25 AM

HyperHand 3.0.3-beta.2 (versionCode 29906)

横滑边界橡皮筋按 miuix MiuixOverscrollEffect 重做:rawOffset 1:1 跟手、DefaultParabolaScrollEasing 一次性阻尼、越界松手软弹簧 190/0.9;并修复底栏弹性、概览状态卡、关于页滚动边界、横向切页速度。

详见 https://assets.lsposed.org/raw/zPan2327/HyperHand/main/CHANGELOG.md?sign=9fa89f535b077066bf7d9375185a9f44&t=6a03bf00

Assets

1

11/11/2026, 10:59:31 AM

3.0.3-beta.1

  • miuix UI 一致性改造:顶栏渐进式模糊、Rubber Band、设置页 Slider 下沉、弹窗统一 Dialog、液态玻璃底栏、关于页按 miuix 示例版式复刻
  • 修复液态底栏滚到底出现紫色雾团与残影
  • 优化关于页渐变动画的帧率(60fps 节流、alpha 为 0 时停动画)

Assets

1

11/6/2026, 9:22:20 AM

2.9.10(versionCode 20910)

本次只改两件事:

  • 模块显示名改为 HyperHand-媲美iPhone的单手模式增强(取自 android:label,LSPosed 模块库与管理器同步生效)
  • 统一发布签名:与本地构建同一把密钥,从模块仓库更新可直接覆盖安装,不再需要卸载重装

功能概览

  • 底部比例触发区(默认 15% 屏高,约 dock 上方),按手指落点判定
  • 缩小动画 5 档缓动曲线 + 0.60~2.00 倍时长,设置页即时生效
  • 上半屏模糊区任意位置下滑拉出通知中心 / 控制中心,真拉出后自动退出单手模式
  • 任意入口拉出面板统一退出;没真拉出则保持单手
  • 桌面底部屏蔽区,dock 以上下滑不误触面板

环境:Android 12+,实测小米 14 / HyperOS 3(Android 16);需要 libxposed API 102 框架;
作用域 com.android.systemui、com.miui.home。

完整变更见 CHANGELOG。

Assets

1

2.1.0

Stable

10/30/2026, 8:40:54 AM

HyperHand 2.1.0(versionCode 20100)

单手模式增强:扩大底部触发区(25dp → 56dp)、按向下峰值速度判定,
并与桌面下拉通知/控制中心手势互斥;缩小动画 / 布局 / 触摸映射 / 退出方式
全部沿用 HyperOS 原生实现。

  • 包名:io.github.zpan2327.hyperhand
  • 需要支持 libxposed API 102 的框架(Vector 2.x / 新版 LSPosed)
  • 静态作用域:com.android.systemui + com.miui.home

Assets

1