ColorOS 增强

面向 ColorOS 16 / Android 16、ColorOS 17 / Android 17 的 LSPosed 模块。作者:Howard(Howard-Tse)。当前稳定版本:1.31.1,应用包名:io.github.howard_tse.colorosenhance。

旧包 dev.howard.colorosenhance 的用户应保留旧包和数据,安装并首次打开新版,按提示允许 root 读取以自动迁移设置。检测到旧模块仍启用时会提示在 LSPosed 取消旧版启用;返回后自动继续,最后完整重启并确认新版正常,再卸载旧包。无需先更新旧 APK 或手动导出文件,详见迁移说明。

模块包含系统私有接口适配,不同机型、主题及系统更新后的效果可能不同。本项目不是 OPPO 或 OnePlus 官方产品。

下载与反馈:Release 下载 · LSPosed 模块仓库 · 问题反馈。请先阅读迁移说明与已知验证限制。

功能

  • 状态栏图标:蓝牙显示条件、时钟/电池及系统图标仅下拉显示、锁屏规则、自定义排序和左右区域移动;配合系统自身的图标开关。
  • 控制中心增强:竖屏可将下方分页磁贴纵向展开,滚动整个控制中心;横屏可独立选择保留原生分栏后纵向滚动,或为原来的左右分页增加外侧边缘渐隐。静止时磁贴完整显示,翻页时仅在分页外侧淡出,范围按相邻控件间距限制。各项默认关闭,编辑磁贴时恢复原厂布局。
  • 状态栏电池增强:电量文字字重、位置等参数。
  • 全景息屏增强:日期/组件显示和背景压暗等参数,按系统能力适配。
  • 流体云增强:状态栏解绑、全屏/最近任务/下拉等场景保持显示或动画补全,以及横竖屏分别配置。
  • 胶囊与卡片:尺寸比例、边框、切换箭头、循环切换、当前胶囊卡片优先、摄像头区域展开、圆角和连续曲线、展开背景压暗。
  • 媒体流体云:暂停/未开始播放时显示;六频段实时律动、可拖动频率轴、读取间隔与其他参数、暂停冻结柱高。采集不可用时回退原厂效果。
  • SIM PIN 自动解锁:独立卡槽配置、加密存储、卡片匹配和每卡每次开机一次尝试保护。
  • 安装器替换:选择可处理 APK 的应用;可选跳过针对该安装器的普通打开确认。

提供独立设置应用和「系统设置 → 系统与更新」中的内嵌入口。数值参数支持滑条、手动输入及长按恢复单项默认值;六频段编辑器有独立恢复入口。各功能组首次安装默认关闭,升级保留已有配置。

媒体实时律动只采集经过安全检查的普通 PCM 输出中的私有媒体会话,不使用麦克风或全局混音,不强制关闭硬件卸载。采集路径按接口能力选择,适用于符合条件的扬声器、有线/USB 耳机和蓝牙输出;无法安全采集时保留原厂动画。较新的可视化接口使用最新采样窗口与六柱高度延迟队列,避开系统环形缓冲区跨界时重复返回旧数据的问题,并补偿原有声音输出延迟;不支持该接口时保留旧采集方式。频谱计算沿用六频段、灵敏度及过渡设置,停止采集时释放资源并恢复原有可视化延迟参数。

控制中心纵向展开时,普通区域上下滑动用于滚动;从底部手势条附近上滑,或已经滚到底后重新上滑,交给系统收起面板,底部仍在回弹时也遵循这个规则。亮度/音量滑条保留原生操作。滚动与分区回弹优先复用通知中心的独立引擎,底部回弹幅度单独收敛;面板接近展开终点后即可滚动,不必等待弹簧尾段完全停止。此功能按原生网格与触摸接口检测能力,接口不匹配时保留系统处理;已在部分 ColorOS 17 固件验证,不代表所有固件均已验证。

应用打开进入前台时自动检查一次官方模块仓库的最新正式 Release,有更新才弹窗,网络失败或没有更新时不打扰。进入二级页面、旋转屏幕不重复检查,迁移引导未完成时暂缓提醒。独立应用「管理 → 关于」及内嵌页「关于」也保留手动检查和源码仓库入口。检查按 versionCode-versionName 中的版本码比较,显示版本说明,有更新时可交给浏览器下载 APK。不包含后台定时检查、静默下载或安装。

使用要求

  • 对应 ColorOS 的 Android 16 或 Android 17;最低 Android API 36。
  • 支持现代 libxposed API 102 的 LSPosed 实现。只支持旧 API 的框架不能加载本模块。
  • 已安装可用的 root/LSPosed 环境。管理页重启进程功能另需授予模块应用 root 权限。

建议只勾选模块声明的作用域:系统界面、设置、电话、系统框架,以及 ColorOS 17 背景压暗所需的多彩引擎。包名分别为 com.android.systemui、com.android.settings、com.android.phone、system、com.heytap.colorfulengine;系统框架应选择管理器中的对应项目。

安装后启用模块及所需作用域,并首次打开应用完成初始化或旧包迁移,再完整重启一次。系统框架/多彩引擎中的更新需要完整重启;管理页的「重启系统界面」或「一键重启作用域」不能替代。应用转场胶囊保持功能首次使用也需要完整重启。

SIM PIN 与安装器

真实 PIN 只在手机设置页输入,不放进源码、截图、Issue 或日志。首次使用需要配置各卡槽;本产品更换包名时保留电话端已确认凭据,未确认暂存 PIN 不导出,独立旧 SIM 模块的凭据不迁移。关闭总开关保留已保存凭据;换卡或修改 PIN 后应重新配置。失败或不匹配时恢复手动输入。停用模块并完整重启,可恢复原厂流程。

安装器替换需要自行安装并配置目标应用。没有选择目标、目标不可用或请求不符合条件时走原系统流程;本功能不会替代安装器的权限和安装后端,也不会确认安装。

构建

工具版本以工程为准:JDK 21、Android SDK 37、Build Tools 37.0.0、Gradle Wrapper 9.5.1、AGP 9.2.1。使用仓库中的 Wrapper;不包含 SDK、JDK 或私有签名。

Windows PowerShell:

# 预先配置 JAVA_HOME,以及 ANDROID_HOME 或 ANDROID_SDK_ROOT。
# 使用共享环境时,也可设置 CODEX_ANDROID_ROOT 指向其目录。
.\scripts\build.ps1

脚本优先离线构建,执行单元测试、Lint 和 Debug 构建;首次使用的机器应先准备工程声明的 SDK/依赖。Debug 签名首次生成在已忽略的 .local/。

Release 构建:

. .\scripts\Enter-AndroidEnvironment.ps1
# 仅首次创建自己的发布签名时运行;已有正式密钥时不要重建。
.\scripts\Initialize-ReleaseSigning.ps1
.\scripts\build.ps1 -Release

Debug 与正式 Release 签名不同。自行构建的 APK 不能用来直接覆盖另一签名的安装。正式发布方应安全备份 .signing/,后续版本沿用同一签名;密钥和密码文件永不提交。

适配与验证

当前实现保留 ColorOS 16 及较早 ColorOS 17 路径,并适配过 ColorOS 17 的新插件接口。自动化用例不能代替具体机型、主题或完整开机流程的真机验证。

1.31.1 已通过 1227 项测试,Debug/Release Lint 无错误。媒体实时律动已在扬声器、蓝牙耳机及两者切换、暂停恢复和卡片开合后复测;本轮没有有线/USB 耳机实机验证。控制中心长按胶囊进入应用,以及低电量即现卡片在所有流体云退出后的首次展开、底部完整性和轮廓光位置均已验收;普通媒体与秒表卡片已作对照。旧接口路径保留,本轮未重新实测旧固件。升级保留设置,安装后重启系统界面或手机以加载修正。

1.31.0 已通过 1200 项测试,Debug/Release Lint 无错误。控制中心纵向滚动、快速交替分区回弹、横屏分页外侧渐隐,以及图标在屏幕内/离屏后的收起衔接已完成真机复测;独立应用底栏、页面切换、两处更新入口、内嵌页返回和计时卡片退场也已验收。控制中心新功能默认关闭,已验证的 ColorOS 17 固件不代表所有机型与固件。

1.30.0 的同签名旧包迁移、启用状态交接及完整重启已通过真机验证。暂存 PIN 不迁移,未以本轮验证代替 SIM PIN 自动解锁验证。

1.29.2 针对摄像头区域展开时自动弹出卡片的顶部定位增加补正,1.31.1 进一步修正首次尺寸准备和轮廓材质。耳机、低电量等即现卡片在原厂状态机稳定前可能不响应收起手势,目前保留这项系统限制。版本变更见 CHANGELOG.md。

隐私与公开发布

公开作者名为 Howard,GitHub 身份为 Howard-Tse;设备标识、诊断截图/录像、历史操作记录、个人路径和签名材料不属于公开源码。1.30.0 无联网权限;1.31.0 为启动时及手动更新检查新增联网权限,仅查询 GitHub 公开发布信息,不上传模块配置或设备标识。迁移读取的配置保存在应用私有空间,不作为可公开的日志或导出包。运行时数据的处理与反馈要求见隐私说明。

提交前运行 scripts/Audit-Publish.ps1,仅提交经检查的 Git 文件;不要将整个工作目录压缩上传。准备源码仓库及 LSPosed 模块仓库的步骤见 发布准备。

许可证与第三方声明

本项目原创代码使用 MIT License,Copyright (c) 2026 Howard。第三方依赖保留各自的许可证与署名,不因本项目采用 MIT 而改变;已核对本版 110 个运行时依赖坐标,详见第三方许可清单。APK 内也附带项目 MIT、MaterialKolor MIT 和 Apache License 2.0 全文,可从管理页查看。

Releases

1.31.1

Stable

11/16/2026, 2:38:37 PM

  • 修复媒体实时律动偶发有规律地“动一下、停一下”的问题。对支持的私有 PCM 可视化接口使用最新采样窗口,在原有采集工作线程计算频谱,以有界六柱高度队列补偿可视化延迟,避开环形采样窗口跨界时重复返回旧数据;不改变声音输出延迟、音质或硬件卸载设置。
  • 采集能力按实际接口检测,不支持新接口时保留既有 Visualizer 路径;暂停、展开卡片及结束会话时释放采集资源并恢复原有可视化延迟,恢复时继续使用原有六频段、参数和柱高过渡。采集不可用或路由不安全时仍回退原厂动画。
  • 修复在控制中心长按流体云胶囊直接进入应用时,转场位于面板下方且面板不收起的问题。复用展开卡片进入应用的原生转场交接,动画覆盖面板,结束后面板正常收起。
  • 修复开启「从摄像头区域展开」时,低电量等即现卡片首次自动弹出底部被短暂裁切的问题;在原厂动画记录目标高度前准备完整尺寸,接口检测不可用时保留原处理。
  • 即现卡片的原有轮廓材质随当前展开形状绘制,修复轮廓光结束时才突然出现、顶部轮廓短暂落在摄像头与正文交界处的问题。独立绘制层在原生布局后保持正确原点,保留正文布局和触摸目标;所有流体云退出后的首次弹出也已复测。
  • 保留旧系统接口路径,以及原厂即现卡片在动画/状态机稳定前不响应收起手势的限制;不绕过稳定性检查。

本版通过 1227 项测试,Debug/Release Lint 无错误。已在 ColorOS 17 验证扬声器、蓝牙耳机与输出切换、暂停恢复、卡片开合、控制中心长按进入应用,以及真实低电量首弹;普通媒体和秒表卡片已作对照。有线/USB 耳机和旧固件未在本轮实机复测。升级保留原设置,沿用正式签名;安装后重启系统界面或手机加载修正。设备配置、私钥、原始日志及截图/录像不随发布上传。

Assets

2

1.31.0

Stable

11/15/2026, 4:48:43 PM

1.31.0

  • 新增控制中心增强:竖屏磁贴纵向展开、整页上下滚动;横屏可独立启用纵向展开,或使用原生分页外侧边缘渐隐。新选项默认关闭,编辑磁贴时恢复原厂布局。
  • 滚动与分区回弹优先复用通知中心独立引擎,优化快速反向接手、交替上下边界回弹及底部再次上滑收起。亮度、音量、磁贴点击和长按保留原生操作。
  • 修正控制中心重复图标、首排磁贴被裁剪、展开与回弹重叠时的位置跳动。图标仍在屏幕内时保留无缝衔接;完全离屏时改用普通状态栏原生显隐,避免回弹尚未结束时跳变。
  • 重做液态玻璃底栏,加入按压膨胀、拖动拉伸、联动高光、边缘折射和弹性恢复。按住不移动也能预览选中位置;三个主页面增加方向对应的切换动画,保留滚动状态。
  • 修正内嵌系统设置逐级返回时的列表位移,以及计时/秒表结束后已展开的流体云卡片直接消失的问题。
  • 新增应用启动时检查更新、有新版时弹窗提醒,以及独立/内嵌设置中的手动检查与 GitHub 仓库入口。新增联网权限,仅查询 GitHub 公开发布信息,不上传配置或设备标识,无后台定时检查、静默下载或自动安装。
  • 调整浅色、深色、主题单色图标的前景比例;首页常用入口中,全景息屏排列在状态栏电池之前。

沿用正式签名,现有同包用户可直接覆盖更新并保留设置。旧包用户请按迁移说明操作。安装后建议完整重启,以加载各作用域的新代码;控制中心新选项请在「控制中心增强」中自行开启。

1200 项测试通过,Debug/Release lint 无错误。控制中心增强已在部分 ColorOS 17 固件完成真机验收,保留旧系统适配路径,其他机型/固件仍需确认;低电量等自动首弹卡片的自然触发验证限制见仓库说明。

APK 与 SHA-256 校验文件见附件。私钥、个人配置、设备标识和诊断截图/录像不随发布上传。

Assets

2

1.30.0

Stable

11/15/2026, 9:17:48 AM

首次公开正式版本,面向 ColorOS 16 / Android 16 和 ColorOS 17 / Android 17。

功能

  • 流体云增强:与状态栏解绑、按场景保持显示或补全动画、横竖屏配置、摄像头区域展开、圆角、胶囊尺寸、卡片排序及背景压暗。
  • 媒体增强:暂停/未开始播放时保留胶囊,六频段实时律动及频率轴、采样间隔等参数。
  • 状态栏图标:蓝牙规则、仅下拉显示、锁屏规则、左右跨区拖动排序;另有电池增强和全景息屏增强。
  • SIM PIN 自动解锁、安装器选择与替换;独立应用和系统设置内嵌页。

旧包用户迁移

新应用 ID 为 io.github.howard_tse.colorosenhance,旧包为 dev.howard.colorosenhance。两者可以共存,正式签名沿用原签名。

  1. 保留旧包及数据,安装新版;在 LSPosed 中启用新版,并首次打开新版应用。
  2. 为新版包名允许 root 读取。新版自动复制普通设置;旧模块仍启用时,新版保持增强未激活。
  3. 在 LSPosed 停用旧包,为新版勾选系统界面、设置、电话、系统框架、多彩引擎等所需作用域,然后返回新版完成交接。
  4. 完整重启一次。确认新版正常后再卸载旧包;不需要手动导出或先更新旧 APK。

已确认的电话端 SIM 凭据继续保留;暂存 PIN 不导出,检测到旧暂存记录时 SIM 增强暂时关闭,请在新版重新保存、核对卡槽后启用。迁移页返回会退出应用,重新打开继续迁移。

详细步骤和限制:迁移说明。

环境与验证

  • 需要 root,以及支持现代 libxposed API 102 的 LSPosed 实现;最低 Android API 36。
  • 1129 项本地测试通过,Debug/Release Lint 无错误。真机已验证自动迁移、完整重启、两处设置入口、媒体卡片、下拉面板及最近任务手势。
  • 保留旧系统兼容路径;不同固件和机型仍可能需要适配。本次迁移因旧暂存记录关闭 SIM 增强,不宣称 SIM PIN 自动解锁已在本轮验证。
  • 低电量等自动首弹卡片的位置补正、新桌面图标随系统深浅切换的刷新行为尚待扩大真机验证;上述少见场景仍需持续收集真机反馈。

许可与反馈

原创代码采用 MIT;第三方许可证与署名随 APK 和源码保留。

反馈请附系统/模块版本、开关和复现步骤。请勿上传 PIN、完整 ICCID、设备序列号、原始配置、账号信息或签名材料。

APK 校验

SHA-256:7346cab2dc6c4ce21052909882dd82365e83e430a603aa46d3db6a558ec4a562

签名 SHA-256:0cfa00ce6a525ffffe05fc78fc08333cb24d055a7677e516c364abc694cc0c10

Assets

2