君ノ声ヲ 私ガ届ケル
你的声音，我会为你送达。
声明：本仓库中部分代码由 ClaudeAI 生成，可能存在不准确、不完整甚至有缺陷的地方，如果发现任何问题欢迎提交 Issues 或 Pull Request。
应用图标来源未知，如有侵权请联系删除
联想平板的 ZUXOS 中有大量内置键盘快捷键——Win+D 回桌面、Win+Tab 最近任务、Win+P 切换 PC 模式……极大方便了键盘用户的操作习惯，甚至在没有鼠标的情况下也能高效使用平板。
但、不少快捷键根本没有方法被禁用，即使禁用了，系统依旧会吞掉它们。有些快捷键你根本不想用，有些你想换成 AOSP 原生的、没有埋点检测的行为，有些你只是想彻底禁用。
最扯的是，ZUXOS 的快捷键提示也是自相矛盾的，一边在“系统”快捷键里面写着 Ctrl+Shift+T 禁用触摸板，一边在 Edge 快捷键里又写着同样的 Ctrl+Shift+T 是撤销关闭标签页——它做了 Edge 的适配，但不多 :D
更别提它还将快捷键提示窗在 AOSP 的 Meta+/ 基础上又加了 Ctrl+/ 敲代码的应该知道这个快捷键被占的意义
以及不少私有键无法被市面上的按键映射工具正确识别和映射
BetterZUIKey 是一个 LSPosed 模块，通过接管 ZUXOS 的键盘快捷键处理链，允许你在每条快捷键 的屎山分支 上独立选择行为。
- 50+ 快捷键独立控制 — Win+字母、Win+功能键、Ctrl/Alt/Shift 组合、ZUXOS 物理键、AOSP 辅助键
- 5 种覆写模式 — 保持默认 / 启用 ZUX 实现 / 启用 AOSP 实现 / 关闭（清洗并透传前台 app） / 忽略（彻底吞掉）
- 部分快捷键使用独立选项标签（如 Ctrl+Enter 四档：跟随系统 / 插入换行 / 透传 / 忽略）
- 内置更新检查 — 启动时自动检查 / 长按卡片立即检查，四通道可选（自动 / GitHub / GitHub 镜像 / 个人镜像）
- 应用模板 — 不同 app 前台时自动切换快捷键配置
- 虚拟 Fn 键 — 用顶部多媒体键模拟 F1~F12，支持键盘 profile 自动编辑、导入导出
- 内置 scanCode 探测器，帮你映射物理键盘的 Fn 区
- 隐藏功能启用 — 无视 ROW/CN/KR 区域差异行为，强制启用 Meta 长按→语音助手 等功能
- 更强的智能键 — 增加「执行命令」功能，内置脚本模板；可与 Termux 集成
- 输入法增强 — 自定义输入法切换/输入法语言切换快捷键
- Ctrl+Shift / Ctrl+Space / Alt+Shift / 右Alt / 长按Meta 可供选择
- JSON 输入法适配器按需切换输入法内部语言状态
- 国际化 — 应用内语言切换，配置变更即时生效
ZUXOS 的键盘快捷键分发有五层（L0~L4），BetterZUIKey 在其中 4 层都插入了拦截点：
| Layer | Hook Point | Scope |
|---|---|---|
| L0 | KeyboardShortcutController.interceptKeyBeforeQueueing() |
Win+Tab, Win+L, Win+P, Win+Back, Ctrl+Space, Ctrl+Enter, Ctrl+/, Ctrl+Shift+T, FnLock, Win+Alt+3~6 |
| L1 | KeyboardShortcutController.interceptKeyBeforeDispatching() |
Win+字母 (S/A/D/I/E/N/M/W/1~8/↑↓), Ctrl+Shift, Alt+Shift |
| L2 | (ZUI internal delegate — not hooked) | Win+I → launchSettings, Meta 单按 → triggerShowAllApps 等。ZUI 内部将部分快捷键委托给 AOSP L3，BetterZUIKey 在 L1 处 strip Meta 后放行即可 |
| L3 | PhoneWindowManager.interceptKeyGestureEvent() |
AOSP 原生 gesture（type=1/7/8/12/52/53/201） |
| L4 | KeyboardShortcutController.handleKeyGestureEvent() |
ZUI 专属 gesture（type=300/302/305/306/307/308/309/310/311/312） |
如果没有特殊说明，这些挂钩在用户界面的表现是，左侧开关等价于系统开关（如果有），右侧下拉框控制实际触发行为。
-
为了保证挂钩触发，建议保持系统开关打开，而在软件内修改触发行为
- 当修改触发行为时，会自动切换系统开关
-
ZUXOS 的部分系统开关关闭后，等效于软件的“忽略”，也就是按键会被吞掉
- 这也是本插件存在的意义
App (Config.json)
↕ ContentProvider IPC (ConfigSyncProvider)
system_server (MainHook)
├── L0 ⟶ L1 ⟶ L4 (KeyboardShortcutController)
│ ⬂
│ L3 (PhoneWindowManager, AOSP native)
├── MetaKeyRouter (Win 短按/长按路由)
├── FnKeyManager (虚拟 Fn + FnLock)
└── IMEDispatcher (InputConnection commitText / 按键注入)
- 前置条件：
已 root +安装 LSPosed、ZUXOS- 已实现不给 BetterZUIKey 挂载 Root 也能修改系统设置的功能
- 当前仅测试 1.5.04 (Android 16)，不确定基于 Android 15 的低版本是否生效
- 欢迎提交 Issue 和 Pull Request
- 在 Releases 下载最新 APK
- 安装后在 LSPosed Manager 中激活模块（勾选
system_server和android） - 重启 system_server（您的 Root 管理器内提供软重启，无需重启设备）
- 打开应用，主页显示
✅ 已激活即成功- 你可以忽略缺少 Root 权限的提示
- 更新后如果遇到作用域错误的提示，除了真的选错了外有可能是 IPC 错误，但强烈建议再重启一次。如果仍不可用，请 提出issue
git clone https://github.com/CommandPrompt-Wang/BetterZUIKey.git
cd BetterZUIKey
./gradlew assembleDebug
# APK at: app/build/outputs/apk/debug/app-debug.apk需要 Android Studio + JDK 17 + Android SDK 34+。
模块通过反射调用 Xposed 框架因此本身不依赖任何特定版本的 Xposed API- 需要 libxposed 101 以上的 API
致开发者：
dev分支提交信息以[Nightly]开头时，CI 会自动触发 Debug 构建并上传 artifact。
- 快捷键 — 每条快捷键有一张卡片
- 左侧开关：系统开关的投射（如果有）
- 右侧下拉框：覆写模式
- 点击展开下拉菜单
- 模板 — 创建针对特定应用的快捷键模板
- 设置 — 总开关、虚拟 Fn、输入法增强、Termux、外观、日志级别、语言
其余请阅读内置帮助文档，它位于主页的“帮助”卡片中。
对于一般的按键：
| 模式 | 效果 |
|---|---|
| 保持默认 | 跟随 ZUXOS 系统开关（开→ZUI，关→透传） |
| 启用 ZUX 实现 | 强制执行 ZUXOS 快捷键行为 |
| 启用 AOSP 实现 | 拦截 ZUXOS，交由 AOSP 原生实现 |
| 关闭 | 不拦截，按键直达前台 app |
| 忽略 | 吞掉按键，系统和 app 都收不到 |
对于两个「智能键」（507/508）：
| 模式 | 短按 | 长按 |
|---|---|---|
| 跟随系统 | 透传 ZUI | 透传 ZUI（系统快捷键设置） |
| 忽略 | 无动作 | 无动作 |
| 执行命令… | 运行脚本 | 打开命令编辑器 |
长按卡片可跳转系统快捷键设置。
- 「Meta 长按」也增加了「执行命令」的功能
对于「Ctrl + Enter」：
| 模式 | 效果 |
|---|---|
| 跟随系统 | 透传，由 ZUI 系统决定 |
| 插入换行 | 拦截 Ctrl+Enter，向应用提交 \n 换行符 |
| 透传 | 无条件放行给前台应用 |
| 忽略 | 消费事件，系统和应用都收不到 |
这是一个 LSPosed 模块，直接 hook 系统键盘输入处理链。使用前请：
- 完整阅读 Help 文档
- 理解每个选项的含义再操作
- 不当配置可能导致部分快捷键行为异常
开发者不承担因使用本模块造成的系统故障、数据丢失或设备异常的任何责任。
app/src/main/java/moe/lovefirefly/betterzuikey/
├── Hook/ # Xposed 拦截层 (system_server)
│ ├── MainHook.java # 入口 + L0~L4 安装 + IME hook 分发
│ ├── L0Interceptor.java # interceptKeyBeforeQueueing
│ ├── L1Interceptor.java # interceptKeyBeforeDispatching
│ ├── L3Interceptor.java # AOSP gesture (PhoneWindowManager)
│ ├── L4Interceptor.java # ZUI gesture (handleKeyGestureEvent)
│ ├── MetaKeyRouter.java # Win 短按/长按路由 + 组合键误触修复
│ ├── ZUIKeyHook.java # 507/508 智能键
│ ├── FnKeyManager.java # 虚拟 Fn + FnLock
│ ├── HookContext.java # 共享状态 + 配置热重载 + 智能键命令
│ ├── KeyInjector.java # 按键注入 + 修饰键匹配
│ ├── ConfigIPCManager.java # Hook ↔ App IPC
│ ├── ForegroundTracker.java # 前台 App 跟踪（模板匹配）
│ └── HookCompat.java # libxposed API 兼容封装
├── Config/
│ ├── Config.java # 主配置 + Gson 持久化
│ ├── ConfigResolver.java # 全局/模板覆写解析
│ ├── KeyTemplate.java # 应用模板
│ └── PerKeyOverride.java
├── Region/
│ ├── FeatureHook.java # AI 代理 / 文件管理器跳转
│ └── RegionProfile.java # 区域枚举（Config 遗留字段）
├── ime/
│ ├── IMEDispatcher.kt # IME 切换策略分发
│ ├── IMEProfile.kt # Profile 数据结构
│ └── IMEProfileManager.kt # JSON Profile 加载/匹配
├── TabsFragments.kt # 主页 / 快捷键 / 模板 / 设置
├── ShortcutMeta.kt # 快捷键卡片元数据 DSL
├── UpdateChecker.kt # 更新检查（GitHub / 个人镜像）
├── ConfigSyncProvider.kt # ContentProvider IPC（App 侧）
├── AppKeyCommand*.kt # 507/508 / Win 长按 命令执行与编辑
├── TermuxPermission*.kt # Termux 权限授予
├── ModuleStatus.kt # 模块自检探针
└── ... # Activities、LocaleHelper、Utils 等
GPL-3.0 © 2025–2026 CommandPrompt-Wang