v2.1.0 · 切页动画与 LSP 兼容适配

v2.1.0 · 切页动画与 LSP 兼容适配

重要：包名变更，需要迁移安装

应用包名从 brightnesslock.rongshangs.top 调整为 top.rongshangs.brightnesslock。签名未变，但 Android 将它视为不同应用，不能覆盖旧版（包括此前旧包名的 2.1.0 测试包）。

1. 在旧版关闭两项 LSP 策略并点“恢复系统控制”，确认恢复成功。
2. 在 LSPosed 中停用旧模块，卸载旧包。不要同时启用两个包的模块。
3. 安装新包，重新授予 Root 和悬浮窗权限，重新添加控制中心磁贴。
4. 需要 LSP 时启用新模块，作用域仅选“背屏中心” com.xiaomi.subscreencenter，重启手机后重新设置策略。旧版配置不自动迁移。

更新内容

• 支持控制中心“背屏控制”磁贴，点击太阳图标快捷呼出面板。安装后在控制中心的磁贴编辑界面手动添加；新包名迁移后需移除旧包磁贴、添加新包磁贴，磁贴本身无需 LSP。
• 基础面板与背屏策略页加入 220ms 双向淡入淡出与轻微位移动画；切页不重置背景模糊，系统关闭动画时直接切换。
• 切页期间阻止重复触控，快速返回、关闭和界面销毁会完成并清理旧动画，不留下透明触摸层或回调。
• 从 DozeService 的字段类型解析传感器与定时器实现，不再依赖两个固定混淆短名；保留严格结构校验、独立定时器隔离和失败透传，安装日志记录真实实现类。
• 应用、组件、磁贴动作、自定义控件与 LSP 入口统一使用新包名，为独立模块分发仓库准备资料。原源码仓库继续保留在 RongShangs/bright。
• 使用范围说明扩展至小米 17 / 18 系列 Pro、Pro Max 背屏机型；具体固件仍需验证，并非全设备兼容保证。
• Root 亮度、AOD、永不息屏、C 守护与空闲退出机制保持不变，仅亮度模式仍正常每 4 秒检查，不增加显示查询或唤醒锁。

启用与验证范围

LSP 功能需要支持 libxposed API 101、远程配置的 LSPosed。两个开关仅拦截背屏 AOD 的暗光、遮挡路径，不干涉主屏感应、电源键、双击、热保护或其他超时；Root 永不息屏为独立功能。

42 项 JVM 单元测试、15 项原生解析/边界检查通过；Release 构建、签名校验成功，lint 无错误（74 warnings、2 hints）。新增测试包含辅助类结构变化、包名组件一致性、动画中间帧、快速返回、取消清理与系统禁用动画。

官网 index 已检查 320 / 390 / 768 / 1440 宽度及深浅色：无页面横向溢出、无损坏图片，两个下载入口均指向本次签名 APK。

旧固件的功能验证沿用 2.0.0 用户反馈。新版背屏中心 RELEASE-1.0.2609231642 的适配依据用户提供的结构报告，本轮未独立取得厂商 APK、未连接设备完成新包名及动画真机验收，未实测长期功耗。未知结构保留系统行为，详细证据边界见源码仓库 docs/2.1-hook-compatibility.md。

版本与签名

• versionName 2.1.0，versionCode 25。
• applicationId top.rongshangs.brightnesslock。
• 发布证书 SHA-256：4B041D7BA17FCF2121896E136AC906CDE1CF02C8061792584E7CE961439B38D8（未更换）。
• APK SHA-256：F3503D9DD8FA5DDFF4B6ECB2BD1035441119CA7086B0A9084436347E3CB866B3。

v2.0.0 - 背屏策略与可选 LSP 接入

v2.0.0 · 背屏策略与可选 LSP 接入

更新内容

• 新增两个可选 LSPosed 开关：阻止背屏 AOD 暗光自动息屏、阻止背屏 AOD 遮挡自动息屏，两项独立控制。
• 主面板保持原有短卡片比例；右侧中间按钮改为黄色“背屏策略”入口。永不息屏移至策略页，与 LSP 开关按 Root / LSP 分组，移除左侧旧 LSP 入口。
• 策略页支持深浅色、滚动和返回导航，明确显示连接、保存失败与守护异常。酷安入口改为“酷安@戎Shangs”。
• 修复 Service 主题缺失导致开关测量崩溃的问题，补充界面启动、短卡片高度、三个开关、返回和横屏大字体回归测试。
• LSP 配置通过框架远程配置同步，写入失败不显示成功；恢复系统控制同时尝试关闭两项 LSP 开关，未全部恢复时明确提示。
• 保留面板关闭后主动退出主进程的机制，并覆盖仅配置通道拉起进程时的空闲退出。
• 守护异常时，开关保留系统实际设置以便关闭，磁贴不再把残留的无限超时误报为常亮正常。

Root 与 LSP 的区别

• 亮度、AOD 和永不息屏仍只需 Root，不强制安装 LSP。
• Root 永不息屏沿用原有 C 守护，检测息屏后尝试唤醒并保持活跃画面，可能短暂黑屏，耗电较高。
• LSP 两项仅拦截背屏 AOD 的指定传感器与暗光定时策略，不把 AOD 改成活跃画面，不拦截主屏通话感应、电源键、双击、热保护或其他超时。
• LSP 仅注入已有背屏中心，不新增 Service、线程、轮询或 WakeLock。原有 C 程序不变，仅调亮度仍正常每 4 秒检查，不增加显示查询或唤醒锁。
• 提高亮度、减少息屏都会增加屏幕耗电与烧屏风险；没有零功耗或固定内存占用保证。

启用与兼容

1. 安装后授予 Root 和桌面入口所需的悬浮窗权限。
2. 需要 LSP 功能时，使用支持 libxposed API 101、远程配置的 LSPosed，启用“背屏控制”模块，作用域仅选“背屏中心” com.xiaomi.subscreencenter。
3. 首次启用或更新模块后重启手机，让背屏中心加载新代码；覆盖安装 APK 不会替换进程中已加载的模块。仅切换开关不需要重启。
4. 在“背屏策略”页分别开启需要的功能。已息屏时先重新唤醒；卸载前关闭策略并恢复系统控制。

当前 LSP 适配依据：pandora / OS4.0.0.41.XBLCNXM / Android 17，背屏中心 RELEASE-1.0.2608211912，LSPosed 2.2.0 (7854)。已取得暗光与遮挡拦截日志，用户确认功能正常。该固件暗光延迟为 5 分钟，不是固定 3 分钟。其他固件尚未验证；目标结构不匹配时保留系统原行为。

本次自动化检查：25 项 JVM 测试、15 项原生检查、6 项采集脚本路径检查通过，lint 无错误（保留历史警告）。index 在 320 / 390 / 768 / 1440 宽度检查无页面横向溢出。最后的策略页排版改动未再次连接手机验收，不等于全设备或长期功耗验证。

版本与签名

• versionName 2.0.0，versionCode 24，可直接覆盖此前 2.0 测试版。
• 本次没有更换签名，沿用 v1.6 起的发布证书，可覆盖 v1.6 及以上版本。
• v1.5 及更早版本签名不同，请先恢复系统控制，卸载后安装。
• 证书 SHA-256：4B041D7BA17FCF2121896E136AC906CDE1CF02C8061792584E7CE961439B38D8
• APK SHA-256：CA6E52DDCAE6ACA78969D97F9C61459D920D338ACF888DE90466EEE5EA17F451

v1.8.0 - 守护可靠性与低开销优化

2026-09-26

新增主进程空闲退出：面板关闭、操作完成且状态保存后主动退出 App，仅按需保留 C 守护。系统仍绑定磁贴时暂缓退出，重新打开面板会取消旧退出任务。

本次更新

• 永不息屏复用同一个 C 守护进程，检测电源键、双击等造成的背屏息屏后尝试唤醒；可能短暂黑屏。
• 仅调亮度保持正常 4 秒低频检查，不查询屏幕状态、不持有唤醒锁。通过本地 socket 更新目标，避免反复重启守护。
• 修复过期任务重新接管、恢复与写入竞争、Root 超时卡住；恢复系统控制需等待守护确认退出。
• 常亮查询失败时释放唤醒锁并退避重试，保留亮度守护；控制文件迁移到 Root 私有目录，防止重复守护。
• 完善状态显示、面板生命周期和退出清理；同步 README、index 页面、下载附件及校验值。

安装与签名

版本 1.8.0 / versionCode 23，沿用 v1.6 起的发布签名，可覆盖安装 v1.6 及以上版本。v1.5 及更早版本请先恢复系统控制，再卸载安装。

签名证书 SHA-256：
4B041D7BA17FCF2121896E136AC906CDE1CF02C8061792584E7CE961439B38D8

APK SHA-256：
6A19E6C4605DC101ECEB4E9ED8A105D4E9A2B9DAC1789ED9CF44AFD8ABEC510D

注意事项与验证范围

• 常亮模式需要续期唤醒锁，会明显增加耗电与烧屏风险，不能沿用仅亮度守护的资源占用数据。
• 依赖目标设备的显示状态与内核唤醒锁支持；重启后请重新打开面板恢复守护，卸载前请恢复系统控制。
• 已通过 10 项单元测试、15 项原生解析/边界检查、Release 构建与签名验证；Lint 无错误，仍有警告。
• index 已检查手机深浅色与桌面布局。本次无目标真机连接，尚未完成真机回归和功耗实测，不保证所有系统状态下持续亮屏。

v1.7.0 - 永不息屏与面板交互优化

更新内容

• 新增“永不息屏”：将背屏自动息屏时间设为无限；双击背屏或按电源键仍可息屏。开启后可能增加耗电与烧屏风险，不新增常驻后台。
• 亮度滑块手动最低值限制为 10，避免误滑至完全不可见。
• 面板与背景模糊同步淡入淡出；横屏面板避开挖孔，深色/浅色界面与按钮颜色优化。
• 控制中心磁贴在“永不息屏”开启时显示激活状态。

安装与签名

沿用 v1.6 起的发布证书，可覆盖安装 v1.6 及以上版本。v1.5 及更早版本使用旧签名，无法直接覆盖；请先在旧版中恢复系统控制，再卸载旧版并安装本版。

APK SHA-256：ECF52990EF4CCA5EB91C3AF2E6ACA226539A26EAD84A845E295A21A0BA383328

v1.6.5 - 控制中心稳定性与背景模糊

v1.6.5

本版修复控制中心入口在抖音等应用前台时偶发无响应的问题，并恢复弹窗背景模糊。

• Android 14 及以上由系统控制中心直接启动面板，减少磁贴点击回调延迟或丢失的影响；旧系统保留官方 startActivityAndCollapse 路径。
• 控制中心面板显示在应用自身的透明 Activity 窗口中，避免其他应用隐藏普通悬浮窗。
• 点击面板外空白区域会关闭且拦截触摸，不再点穿后方应用；横屏保持紧凑宽度。
• 恢复系统跨窗口背景模糊，并随系统开关或省电模式自动回退。
• index 网站只保留首页、404 页、必要图片和当前 APK，旧版本请从 GitHub Releases 获取。

控制中心面板显示期间，后方应用会暂时暂停，关闭后恢复。桌面图标入口仍使用悬浮窗。

升级与校验

• v1.6 及以上版本可以直接覆盖安装。
• v1.5 及更早版本使用不同签名，需先恢复系统控制，再卸载旧版安装。
• APK SHA-256：BE617A551F477DB816567CF953CE227875812E51D900DCBCB1317BA70FECA470
• 签名证书 SHA-256：4B041D7BA17FCF2121896E136AC906CDE1CF02C8061792584E7CE961439B38D8

v1.6.1 - 控制中心入口修复

v1.6.1 — 控制中心入口可靠性修复

• 已有悬浮窗权限时，控制中心磁贴直接启动悬浮服务，绕过 HyperOS 对后台启动 Activity 的短时限制，修复切换应用后一段时间打不开、偶发打不开。
• 点击后执行一次性控制中心收起命令，不增加持续轮询或后台功耗。
• 磁贴状态改为由应用持久化维护，不再因临时 Root 查询失败变灰且无法点击。
• 恢复系统控制后状态同步为未接管，并停止守护、Root Shell、悬浮服务及刷新线程。

安装说明

• 已安装 v1.6：签名相同，可以直接覆盖升级。
• v1.5 及更早版本：因 v1.6 起发布签名已变更，必须先卸载旧版再安装；卸载前建议先恢复系统控制。

校验

• APK SHA-256：66E87574D4B212C27DED0A0AA4C2677D8BDA623FCFB9B70813C7B53D4A210475
• 签名证书 SHA-256：4B041D7BA17FCF2121896E136AC906CDE1CF02C8061792584E7CE961439B38D8

v1.6 - 悬浮控制与界面重构

⚠️ 安装前必读

v1.6 更换了 APK 发布签名，无法覆盖安装 v1.5 及更早版本。

建议先在旧版中点击「恢复系统控制」，然后卸载旧版，再安装 bright_1.6.apk。

新功能

• 使用系统悬浮层承载控制面板，不再暂停后方应用
• Android 12+ 在系统支持时启用跨窗口背景模糊
• 自动跟随系统深色 / 浅色模式
• 横屏面板限制最大宽度，避免界面被拉伸
• 恢复系统控制后停止守护进程、Root Shell、Service 与刷新线程

修复与优化

• 修复控制中心磁贴偶发无法打开的问题
• 控制中心入口会自动收起通知栏，并始终执行「显示面板」
• 移除冗余顶部栏，将接管状态合并到亮度状态区
• Root Shell 支持真实退出码、错误输出与 30 秒超时
• 修复同步失败后界面可能一直显示「正在同步」的问题
• 修复测试依赖和 Kotlin 构建 classpath 冲突

兼容环境

• 小米 17 Pro / 17 Pro Max
• HyperOS 3 / 4
• Android 8.0+
• Magisk / KernelSU Root
• 需要「显示在其他应用上层」权限

校验信息

• APK SHA-256：347C43C0FE72F5C8C3489DA78A0AC4382B6DE0A7DD9D9B10CE65CEAE850C7641
• v1.6 证书 SHA-256：4B041D7BA17FCF2121896E136AC906CDE1CF02C8061792584E7CE961439B38D8
• 旧版证书 SHA-256：A40DA80A59D170CAA950CF15C18C454D47A39B26989D8B640ECD745BA71BF5DC

v1.5 - 适配 Hyper OS 4

【适配澎湃OS4】
适配澎湃OS4背光控制链路变更（SurfaceControl）
解决OS4遮盖息屏后背屏无法亮起的问题
背屏遮盖后系统写0，拿出时自动恢复目标亮度

【新增功能】
C二进制轮询守护进程：独立运行、自适应轮询
正常状态4秒低频轮询，检测异常后1秒快速恢复
守护进程资源占用极低：内存128KB，CPU占用≈0%

【性能优化】
亮度写入合并为单次命令执行
守护进程轮询改为自适应间隔（4s+1s）
二进制释放逻辑优化，避免重复写入

v1.4 - 重构升级

新增功能
背屏AOD控制：支持一键开关背屏息屏显示
背屏唤醒：开启AOD时自动唤醒背屏
背屏状态显示：实时显示AOD开关状态
滑动实时预览：拖动滑块时实时显示目标亮度值

Bug修复
修复亮度调整偶发失效：采用合并命令+双重验证机制，确保写入成功
修复快速拖动导致的循环冲突：新操作会自动停止之前的调整循环

性能优化
亮度写入优化：3次独立命令合并为1次执行，提升响应速度
su进程复用：避免每次命令都重新创建进程，减少资源消耗
超时自动回收：su进程30秒无操作自动释放
渐进式重试：等待时间从固定300ms改为100/200/300ms递增

稳定性改进
5秒超时保护：避免无限循环占用资源
线程中断支持：关闭窗口或恢复系统控制时立即停止循环
双重验证机制：写入后等待50ms再次验证，确保值稳定

其他优化
优化状态显示逻辑，更准确反映"未修改/修改中/已修改"状态
优化内存管理，Activity销毁时正确清理所有资源
优化错误提示，Root未授权时显示明确提示

v1.3 - AOD开关与完善

1. 核心底层优化
   Su 进程复用：实现了 SuManager 机制，su 进程在 App 运行期间按需创建并持久保持，大幅提升了频繁操作时的响应速度，并支持 30 秒超时自动回收。
   亮度写入验证+重试：实现了更严谨的写入逻辑。每次写入后会自动校验（Verify），若校验失败会自动触发最多 3 次的重试循环，并伴有毫秒级延迟等待，确保亮度锁定 100% 生效。
   AOD 深度控制：新增了背屏 AOD 开关功能，支持修改系统 secure 设置并自动发送 KEYCODE_WAKEUP 唤醒指令，确保 AOD 设置后背屏能立即响应。
2. 界面重构与新功能
   新增 AOD 开关：在还原按钮上方新增了一个 “AOD 开关”。文字会实时显示“AOD 已开/已关”，并以颜色（绿/黑）区分状态。
   标题更名：左侧面板标题已由“背屏亮度控制”正式更名为 “背屏控制”。
   布局平衡：将右侧区域划分为上下两个功能块（AOD 开关与还原控制），保持了与左侧面板 50:50 的黄金分割比例，视觉依然和谐。