Please scroll down for English / 英语请向下滚动
面向联想 ZUXOS / ZUI 平板与二合一设备的 LSPosed 键盘快捷键覆写模块。
ZUXOS 内置大量 Win/Ctrl/Alt 组合键与物理快捷键，但许多无法真正禁用，关闭系统开关后按键仍会被系统吞掉。BetterZUIKey 在系统键盘处理链中插入拦截点，让你对每条快捷键独立选择行为，并支持按前台应用切换配置。
当前版本：1.3.0-beta2
包名：moe.lovefirefly.betterzuikey
| 项目 | 要求 |
|---|---|
| 系统 | 联想 ZUXOS（已在 Android 16 / ZUXOS 1.5.04 测试） |
| Root | 可选挂载。当没有挂载 Root 时使用 system_server 权限代理执行命令，会稍有延迟 |
| 框架 | LSPosed（libxposed API）；自 v1.1.0-beta1 后已经不支持 XPosed |
| 作用域 | 系统框架（system_server，必须）；输入法 hook 策略需额外勾选目标 IME |
低版本 Android 15 未经测试，欢迎在 Issues 反馈。
- 50+ 条 Win/Ctrl/Alt/Shift 组合键与 AOSP 辅助功能键（Win+Alt+3~6 等）
- 每条支持最多 五种覆写模式：保持默认 / 启用 ZUX / 启用 AOSP / 关闭（透传给应用）/ 忽略
- 支持搜索、筛选；修改覆写时自动打开对应系统开关以完全接管事件
特别地：
Win 长按：
| 模式 | 说明 |
|---|---|
| 保持默认 | 透传，由系统决定（含语音助手等，需要特殊的键盘方有效） |
| 启用 ZUX 实现 | 模块接管：短按 Win → 开始菜单，长按 → 语音助手（国行=小天） |
| 忽略 | 无动作 |
| 执行命令… | 长按运行脚本；长按卡片打开命令编辑器 |
智能键 507和508：
| 模式 | 短按 | 长按 |
|---|---|---|
| 跟随系统 | 系统决定 | 系统决定 |
| 忽略 | 无动作 | 无动作 |
| 执行命令… | 运行脚本 | 打开系统智能键设置页 |
长按卡片可跳转系统「键盘应用功能」设置页。
v1.3.0 起，附录中的多数 ZUI 物理键（静音、触控板、分屏、Print Screen 等）不再提供模块覆写，交由 ZUI / 系统原生处理；507和508 仍可在本 Tab 配置。
- 为指定前台 App 单独定义快捷键覆写，覆盖全局「快捷键」Tab 的对应项
- 未在模板中列出的键继续继承全局设置
- 支持多 App 绑定、复制、排序；同一 App 匹配多个模板时，列表中第一个启用的生效
输入法增强（独立子页）
- 「切换输入法」「切换语言」各绑定一个物理组合键（Ctrl+Shift、Alt+Shift、Ctrl+Space、右 Alt、Win 长按等）
- JSON IME Profile 预设（
framework/hook/keyremap三种策略） - 当 Win 长按被多重占用时，根据是否在输入状态决定 IME 切换 / Win 长按卡片的功能
虚拟 Fn 键
- Win 模拟 Fn → F1~F12；FnLock（Win+`）与临时 Fn 模式
- 键盘 Profile 导入/导出；配合键盘检测页录制 scanCode 映射
Termux 集成
- 一键授予
RUN_COMMAND等权限，供「执行命令…」运行 shell 脚本 - 脚本模板支持 root / 超时 / 单例运行
其它：模块总开关、外观、日志级别、应用内中英文与完整帮助文档
- 在 Releases 下载最新 APK 并安装
- 打开 LSPosed Manager → 模块 → 启用 BetterZUIKey
- 作用域勾选 系统框架（必须）；若使用输入法 hook 策略，按需勾选目标 IME
- 软重启 system_server（或重启设备）
- 打开应用，主页状态为 已激活 即成功
详细说明与快捷键参考见应用内 帮助 页面。
- 源码：CommandPrompt-Wang/BetterZUIKey
- 问题反馈：Issues
- 许可证：GPL-3.0
本模块直接 Hook 系统键盘输入处理链。使用前请阅读应用内帮助并理解各选项含义。不当配置可能导致部分快捷键行为异常；开发者不承担因使用本模块造成的系统故障、数据丢失或设备异常的责任。
部分代码由 AI 辅助生成，如有问题欢迎提交 Issue 或 Pull Request。
An LSPosed module for overriding keyboard shortcuts on Lenovo ZUXOS / ZUI tablets and convertibles.
ZUXOS ships with many Win/Ctrl/Alt combos and physical shortcut keys, but many cannot be truly disabled — the system may still swallow key events even when toggles are off. BetterZUIKey hooks the keyboard shortcut pipeline so you can choose behavior per shortcut and apply per-app templates.
Version: 1.3.0-beta2
Package: moe.lovefirefly.betterzuikey
| Item | Requirement |
|---|---|
| OS | Lenovo ZUXOS (tested on Android 16 / ZUXOS 1.5.04) |
| Root | Optional. Without root, custom commands run via a system_server privilege proxy and may feel slightly delayed |
| Framework | LSPosed (libxposed API). Not compatible with legacy Xposed since v1.1.0-beta1 |
| Scope | System Framework (system_server, required). IME hook profiles also need the target IME scoped |
Android 15 and below are untested. Feedback welcome via Issues.
- 50+ Win/Ctrl/Alt/Shift combos and AOSP accessibility keys (Win+Alt+3~6, etc.)
- Up to five override modes per shortcut: Keep default / Use ZUX / Use AOSP / Off (pass through to app) / Block
- Search and filter; changing an override auto-enables the matching system toggle so the module fully owns the event
In particular:
Win long-press
| Mode | Description |
|---|---|
| Keep default | Pass-through; system decides (voice assistant, etc.; needs specific keyboard firmware) |
| Use ZUX | Module takes over: short Win → Start Menu, long Win → voice assistant (PRC = XiaoTian) |
| Block | No action |
| Run command… | Long press runs script; long-press card opens command editor |
Smart keys 507 and 508
| Mode | Short press | Long press |
|---|---|---|
| Follow system | System decides | System decides |
| Block | No action | No action |
| Run command… | Run script | Open system smart-key settings |
Long-press the card to jump to the system Keyboard App Functions page.
Since v1.3.0, most ZUI physical keys in the appendix (mute, touchpad, split-screen, Print Screen, etc.) are no longer overridable by the module and are handled by ZUI / the system natively. 507 and 508 remain configurable on this tab.
- Define per-app shortcut overrides for a foreground app, superseding the matching entries on the global Shortcuts tab
- Keys not listed in a template keep inheriting global settings
- Multi-app binding, copy, and reorder supported; if one app matches several templates, the first enabled one in the list wins
IME Enhancement (separate page)
- Bind a physical combo each for “Switch IME” and “Switch language” (Ctrl+Shift, Alt+Shift, Ctrl+Space, Right Alt, Win long-press, etc.)
- JSON IME Profile presets (
framework/hook/keyremapstrategies) - When Win long-press has multiple roles, input-state decides whether IME switching or the Win long-press card behavior applies
Virtual Fn key
- Win simulates Fn → F1–F12; FnLock (Win+`) and temporary Fn mode
- Keyboard profile import/export; use the keyboard detect page to record scanCode mappings
Termux integration
- One-tap grant of
RUN_COMMANDand related permissions for Run command… shell scripts - Script templates support root / timeout / singleton run
Other: master switch, appearance, log level, in-app EN/ZH and full help docs
- Download the latest APK from Releases and install
- LSPosed Manager → Modules → enable BetterZUIKey
- Scope System Framework (required); if using IME
hookprofiles, scope the target IME(s) as needed - Soft-reboot system_server (or reboot the device)
- Open the app — home status should show active
See in-app Help for details and the full shortcut reference.
- Source: CommandPrompt-Wang/BetterZUIKey
- Issues: GitHub Issues
- License: GPL-3.0
This module hooks the system keyboard input pipeline directly. Read in-app help and understand each option before changing settings. Misconfiguration may cause unexpected shortcut behavior; the developer is not liable for system failures, data loss, or device issues caused by use of this module.
Portions of the code were AI-assisted. Issues and pull requests are welcome.