OPlusKey

把一加 / OPPO 的侧键重映射成单击、双击、长按动作的 LSPosed 模块。

下载

LSPosed 模块仓库 和 Releases。

使用

  1. 安装 APK
  2. 在 LSPosed 里启用模块
  3. 重启手机

模块入口为 设置 → 快捷键。

已验证

实测通过:

  • OnePlus PLK110(ColorOS 17 / Android 17)

Releases

1.3.1

Stable

11/1/2026, 3:34:06 PM

自 8-1.3.0 以来的改动:

  • feat: 命令详情全屏编辑与测试命令,弹窗壳统一成三段,熄屏单击与切 tab 修复,发版 1.3.1
  • fix: 极暗改走颜色显示服务,音量亮度那一族撤掉,系统开关补定位服务,复核报告逐条收口
  • feat: 自定义变量收成一个页面与一次弹窗,弹窗统一磨砂壳,页面骨架与行尾图标下沉

versionName = 1.3.1,versionCode = 9,BUILD_ID = 2026-11-01-0001。
由 GitHub Actions 自动构建。

Assets

2

1.3.0

Stable

10/28/2026, 11:56:51 AM

自 7-1.2.0 以来的改动:

  • feat: 长按收掉与性能收口,命令列表独立成页,动作清单与过渡统一
  • feat: 组合按键与系统场景可停用,重复代码块下沉到组件,命令页与配置页收口
  • feat: 多配置与自定义变量,组合键等待可调,内置命令不再走 SU
  • feat: 组合按键成页,条件执行独立,按键清单搬上首页,配置改走多模块文件层

versionName = 1.3.0,versionCode = 8,BUILD_ID = 2026-10-28-0001。
由 GitHub Actions 自动构建。

Assets

2

1.2.0

Stable

10/24/2026, 7:49:34 AM

自 6-1.1.2 以来的改动:

  • feat: 小布助手与组合键接通,条件执行支持一块多条件,死分支判定修正
  • feat: 命令页排序态与条件执行空态收口,抽屉选中即确认,空态统一 Feedback
  • refactor: 代码审计收口,分身小窗与界面清单改走 binder,收集按键加倒计时
  • feat: 条件执行两级菜单与两列命令格式,抽屉补回已保存命令,压感键整族认领

versionName = 1.2.0,versionCode = 7,BUILD_ID = 2026-10-24-0001。
由 GitHub Actions 自动构建。

Assets

2

1.1.2

Stable

10/21/2026, 6:30:34 AM

自 5-1.1.1 以来的改动:

  • feat: 条件执行独立成页与九种条件,系统开关三态含手电筒与免打扰,菜单收拢与文字光学居中

versionName = 1.1.2,versionCode = 6,BUILD_ID = 2026-10-21-0001。
由 GitHub Actions 自动构建。

Assets

2

1.1.1

Stable

10/20/2026, 1:13:26 PM

自 4-1.1.0 以来的改动:

  • feat: 快捷方式小窗起法收成单一出口,全局项收进「通用设置」页,命令保存与展开行判据修正

versionName = 1.1.1,versionCode = 5,BUILD_ID = 2026-10-20-0003。
由 GitHub Actions 自动构建。

Assets

2

1.1.0

Stable

10/20/2026, 11:42:05 AM

自 3-1.0.0 以来的改动:

  • feat: 振动强度三档与连续触发振动,按键状态规则与组合键底层接口,releaseLog 构建档,一批界面与判据收口
  • feat: 禁用态点一下说清原因,提示条统一换 Snackbar
  • feat: 自定义按键全链路接通,配置改用 kotlinx.serialization
  • feat: 系统开关取代控制中心磁贴页,按键收集收进 ⋮ 菜单

versionName = 1.1.0,versionCode = 4,BUILD_ID = 2026-10-20-0002。
由 GitHub Actions 自动构建。

Assets

2

1.0.0

Stable

10/18/2026, 5:52:49 AM

versionName = 1.0.0,versionCode = 3,BUILD_ID = 2026-10-18-0003。
由 GitHub Actions 自动构建。

Assets

1

1.4.1

Stable

11/10/2026, 5:27:17 PM

1.4.1

新增

  • 录音一格三档:切换 / 开始 / 结束。老绑定仍是「切换」;「结束」只停,不在录音时什么都不做。
  • 「打开应用」可套原版启动转场(选择应用 页 ⋮):直接转交回 ColorOS 自己那条链路,不是复刻。
  • 系统场景改成「一块 = 单击 / 双击 / 长按三档」,每块末尾都能加条件,多一条「手电筒」条件。配置自动迁移,升级前后行为不变。
  • 场景里点一行动作进的是「按键绑定」那张网格(同一份界面、同一套手势带),右下角确认才写回这一块。
  • 组合键最多三颗;「按键之间的等待」可以每组单独设(上限 300ms → 1000ms)。

改进

  • 顶栏副标题挪到大标题下面,不再把标题挤成省略号;除首页外每页都能折叠、都有副标题。
  • 首页大标题换成模块名,副标题写模块的作用,版本号不再挂在副标题上。
  • 「按键功能」页拆成「默认按键」与「自定义按键」两张卡,额度挂在后者。
  • 选应用 / 选组件都改成「读全了再显示」:进页先转圈,清单一次铺出来。选应用还让有启动图标的那批先上屏,其余在后台接着算。
  • 独立设置显示的是生效值(跟随公共时显示公共那份),只在你第一次打开时抄一次公共值,之后改一项只写那一项。
  • 文案与术语收口:组合按键 / 命令步骤 / 自定义命令;「场景」与「条件」分层;指 Activity 的地方不再写「界面」。
  • 命令抽屉去掉搜索框;自定义命令的步骤行去掉「第 N 步」。
  • 配置能自愈:主文件写坏自动用上一版恢复,页面照常可写。「重置模块」把模块落过的盘全部回出厂。

修复

  • 修复桌面上钉住的快捷方式列不出来 —— 改由系统侧读快捷方式服务的活数据。
  • 修复组合键抢跑:小的那一档不再抢在大的那一档前面派发。
  • 修复命令正文多行粘贴后框里看不见字;两个 tab 的表单不再互相清空。
  • 修复一批失败被写成成功:按键注入被拒却报成功、状态栏与截图断言「已执行」、更新检查在无网时永久不再查。
  • 修复一批数据被盖或页面崩掉的路径:配置版本没跟着抬、导入覆盖把读不懂的原库永久盖掉、新建配置丢掉自定义键、两条命令重名、多条命令切进编辑态。
  • 修复设置写了却不生效:按键独立设置与三档同事件的字段只写了一半点。

移除

  • 撤掉「开机提前拉起宿主服务」:它每次开机都会自己弹一次模块页。取舍是回到「开机后约 15 秒内侧键动作不执行」。

下载

  • -release 是正式包,管理器更新到的就是它。
  • -releaseLog 与正式包完全相同,只是打开了详细日志,排查问题时用。
  • -debug 是调试包,只用于复现。

versionName = 1.4.1,versionCode = 15,BUILD_ID = 2026-11-11-0001。
由 GitHub Actions 自动构建。

Assets

2

1.4.0

Stable

11/7/2026, 3:28:50 PM

1.4.0

新增

  • 独立设置:每颗键、每一组组合键都能自己决定「接口 / 振动(含强度)/ 执行提示 / 提示文案」。顶上那颗总开关默认关 = 跟随公共设置,打开时先把公共那份抄过来再改 —— 不会出现「开了却看到一堆出厂默认」。
  • 长按的两档时序:「松手才触发」(到点即执行 / 等抬手才执行)与「松手执行额外动作」,单键与组合键都有。两族互不连坐 —— 开着「松手才触发」不影响你还想再补一个动作。
  • 滑杆手动输入:所有滑杆行点一下就能打字输入精确值(延迟 1250ms 这种,拖是拖不准的),打进来的数自动吸到刻度上。
  • 组合键编辑页的「自定义命令」:与「按键绑定」页同一颗悬浮键、同一个落点。
  • 系统场景的取值改成选择器弹窗,一条规则拆成两张卡片(场景 / 命令),分行更清楚。
  • 开机提前拉起宿主服务:原先要等开机后约 15 秒才响应侧键,现在注入侧一起来就主动去拉,这段时间里也能用。
  • 按键功能页的全选:编辑态下顶栏一次勾满按键与组合两列。

改进

  • 文案统一成一条范式:父动作名: 子动作名 - 状态,应用目标写成 微信(小窗 扫一扫)。网格小字、菜单子标题、选择应用页页头、场景动作格、执行提示五处说的是同一句话。
  • 网格与抽屉完全同源:同一格动作在网格里和在抽屉里,清单、文案、图标、小字、二层菜单全都一样。
  • 灵感语音拆成「开始 / 结束」两个平级动作,录屏收成一个动作 + 弹窗选三态(开始 / 结束 / 切换),行尾不再挂一颗小选择器。
  • 首页「模块状态」卡:判据改成与整页总闸同源 —— 只要链路任一段不对,大字就是红的「未激活」,下面直接写清是哪一段、该做什么,不再固定说「系统侧未接管按键」。
  • 长按延迟上限 1000ms → 2000ms。
  • **「以小窗口打开」**从 ⋮ 菜单里摘出来,做成顶栏右侧第二颗键。
  • 所有滑杆行灰着被点一下都会说清原因(「先打开使用独立设置」这类),不再一律回落到整页那句。
  • 按键执行移出宿主主线程:命令跑起来时界面不再跟着顿一下。

修复

  • 修复停用侧键之后,按其它自定义键会把模块页面反复拉起来的问题。
  • 修复组合按键列表行尾的启停态显示反了(停用的画着箭头、启用的反而没有标记)。
  • 修复一批「设置写了却没生效」:按键独立设置与三档同一事件的字段只写了一半点,落盘有值、执行照旧。
  • 修复改名 / 删命令 / 删变量之后漏掉的引用位置(松手动作里留着指向不存在命令的 cmd:)。
  • 修复几条会让设置页崩或数据被盖的路径:两条命令重名、建页偶发读盘失败、填名字的弹窗被刷新抹掉输入、删除按键写盘失败的判定、导入覆盖时读不懂的原命令库被永久盖掉。
  • 修复组合键挂住之后整块键盘不再响应,以及被取消的按键被误判成一次动作。
  • 修复「显示失效应用」会顺带放出没有启动图标的系统应用、「显示系统应用」在结束应用那一趟拨了没反应。
  • 修复只给双击配了场景时双击永远不执行。
  • 修复从组合键进来挑应用,重进这一页选中的那一行不亮。
  • 修复从「应用组件」页不选直接返回、抽屉还会弹出来。
  • 修复多条命令切进编辑态必崩、行尾三颗按钮叠在一起。

移除

  • 「三个内置手势同事件时立即执行」整个拿掉:它把三档的时序改了,而三档本来就该各按自己的时序判(单击等双击窗口、长按过阈值)。配置版本抬到 33,老配置里残留的那两个键按未知键忽略,其余设置不受影响。

下载

  • -release 是正式包,管理器更新到的就是它。
  • -releaseLog 与正式包完全相同,只是打开了详细日志,排查问题时用。
  • -debug 是调试包,只用于复现。

versionName = 1.4.0,versionCode = 14,BUILD_ID = 2026-11-07-0001。
由 GitHub Actions 自动构建。

Assets

2

1.3.4

Stable

11/4/2026, 8:43:55 AM

1.3.4

新增

  • 屏幕亮度与音量:「系统操作」里多了两格,各三档 —— 增加 / 减少 / 设置为,选好百分比再确认。亮度动作会让控制中心的亮度条当场跟过去;自动亮度开着时这一档需要 root。
  • 检查更新:打开设置页自动查一次(GitHub 与 Gitee 两路并行,最多等 10 秒),有新版才出声;「版本」那一行改成一层菜单(检查更新 / 项目仓库)。更新说明按 Markdown 显示,长了在框内滚动。
  • 首页更新提示:查到新版后首页顶部会出现一条提示,右侧「查看」打开说明;同一条信息不再在别处重复出现。
  • 按键功能编辑态:顶栏「编辑 / 完成」,两张清单都能勾,勾中后右下角滑出「删除」;编辑态下按返回是退出编辑,不会把你带回上一页。
  • 浮层菜单滚动条:菜单装不下时右侧常显一条,滑到两端不压圆角,按住时有触觉反馈。

改进

  • 改名与入口:「组合按键」→「按键功能」,「通用设置」→「模块设置」;「添加按键」搬到按键页末行。
  • 组合按键列表:键名装进圆角框、两列竖着对齐,长名字不再被省略号截断;键名的括注改成半角方括号。
  • 配色:Monet 档整套交给系统色板(底子与强调色一起跟随),修好 Monet 下滑杆刻度点看不见的问题。
  • 一致的手感:顶栏按钮、卡片行、「选择应用」与「选择界面」两页的行都用同一份行高与按压反馈;弹窗里的滑杆、开关、滚动条统一走系统触觉反馈。
  • 其他:「灵感语音」只在长按档出现;卡片行的状态切换带过渡,不再突跳。

下载

  • -release 是正式包,管理器更新到的就是它。
  • -releaseLog 与正式包完全相同,只是打开了详细日志,排查问题时用。
  • -debug 是调试包,只用于复现。

versionName = 1.3.4,versionCode = 12,BUILD_ID = 2026-11-04-0001。
由 GitHub Actions 自动构建。

Assets

2

1.3.3

Stable

11/2/2026, 10:30:40 AM

自 10-1.3.2 以来的改动:

  • feat: 熄屏也判双击,界面颜色加 Monet 与系统取色,系统场景换三页横滑,发版 1.3.3

versionName = 1.3.3,versionCode = 11,BUILD_ID = 2026-11-02-0002。
由 GitHub Actions 自动构建。

Assets

2

1.3.2

Stable

11/2/2026, 5:30:19 AM

自 9-1.3.1 以来的改动:

  • feat: 以 root 执行成每条命令的开关,随机图标配色与提示限流,弹窗与图标收口,发版 1.3.2

versionName = 1.3.2,versionCode = 10,BUILD_ID = 2026-11-02-0001。
由 GitHub Actions 自动构建。

Assets

2