Repository navigation
Releases
v2.9.156 — 快捷方式全链路修复 + 负一屏时序闸
本次发布范围:v2.9.146 → v2.9.156(versionCode 162 → 172)
快捷方式(本版重点)
桌面上的「快捷方式」指第三方应用通过 pin 创建、指向文件/联系人/功能的图标。
- 重复条目:抽屉里同一条快捷方式出现两个 —— 表里只写不清理。现在按系统 pinned 集合权威对账(DB v24 新增
dismissed列),历史残留行自动清掉。 - 图标不对:此前一律用"创建快捷方式的应用"的图标。现在取快捷方式自身图标,并套 MIUI
IconCustomizer.generateIconStyleDrawable裁成与桌面一致的形状/内容占比。 - 删不掉:抽屉长按快捷方式项 → 确认移除;同时取消系统 pin,原生桌面上的那个图标一起消失。移除的记录不会被下一次同步"自愈"回来。
- 实时刷新:
LauncherApps.Callback.onShortcutsChanged主动推送 + 回桌面 / 开抽屉兜底对账,在别处删掉的快捷方式不会残留。 - 图标设计器:快捷方式进入设计器列表(含缩略图,由桌面进程回带),设计即时生效;删除快捷方式时一并清理它的图标设计数据。
负一屏
- PA 侧
startListening时序闸:provider 未就绪时挂起重试(上限 45s),修"开机后立刻滑负一屏,微件显示无法添加微件"。 - 僵尸 appWidgetId 条件放行(provider 为空才允许清理),移除就绪自杀重载(避免连杀把 PA 拖死)。
assets/scope.list补com.miui.personalassistant,覆盖安装不再冲掉 PA 作用域。
抽屉图标
- 装载回归单段 + 图标按块解码独立超时,修"重启手机后抽屉图标整批变字母占位"。
安装
- 需要 LSPosed,作用域:
com.miui.home、com.miui.personalassistant; - 模块首页确认权限齐备后再开启第四桌面;
- 覆盖安装后建议重启桌面(切换一次模式即会触发)。
数据库升级到 v24(自动迁移,不丢数据)。
v2.9.123-blur-restart
v2.9.123-blur-restart(versionCode 139)
汇总 v2.9.98 → v2.9.123(versionCode 114 → 139)的全部装机批次,均已真机回归。
上游同步与功能(v2.9.98 – v2.9.121)
- 上游同步 v1.2.0:调色板风格(PaletteStyle)、图标圆点/隐藏(S4)、搜索过滤(S3)、字体库全局接管(S5)、主页区块顺序(S6)、弹层滑动灵敏度(Lab)
- 应用堆(App Stack):文件夹横向堆渲染 + 独立管理页(1.2.0 S4c/S6d)
- 弹层小组件:文件夹弹层内添加/调整尺寸/全宽回写(hotfix folders2/3)
- 负一屏:WidgetScreen 动作接 MIUI 原生 personalassistant(FEED_STATE 状态机 + showOverlay 兜底)
- 字母条双击:可配置动作(默认锁屏);主页区块拖拽排序;日历区块;图标快照缓存(性能)
装机修复(v2.9.122 search-shortcut-fix)
- 抽屉启动搜索背景错乱:搜索浮层打开时抽屉页未让位,应用列表从搜索页底下透出 → 抽屉可见性与首页同构
- 设置·隐藏应用页缺应用:设置页(模块进程)枚举可见集少于宿主 → 新增宿主应用清单跨桥(Snapshot.appCatalog)按 key 补差集
- 应用列表不显示桌面快捷方式:
saved_shortcuts.showInAppList从未被消费 → 并入主列表(appsWithShortcuts),启动走startShortcut - 右滑面板「编辑收藏」点了没反应:附加行
onClick(); onDismiss()顺序清掉刚设的 overlay →dismissFirst先关弹层再导航
本版重点(v2.9.123 blur-restart)
- pin 快捷方式真修:
saved_shortcuts恒 0 行 —— MIUI 添加流程不走旁听 hook;且框架层PinItemRequest类型常量与 compat 不同(SHORTCUT=1)。三重修复:框架 accept hook 正确常量 +FLAG_MATCH_PINNED公开查询面自愈同步(挂载/回桌面触发,幂等)+ 落库行无 activity 容错(startShortcut不依赖 activity) - 切模式后状态栏露壁纸(blur-gap):原生桌面 ↔ 第四模式来回切后,会话内 Compose 根被量矮一个状态栏高度(2296/2400),模糊壁纸/遮罩盖不住状态栏条带。按实测结论落地:切进第四模式(状态沿 关→开)自动重启宿主桌面(600ms 延迟、3s 冷却、进程冷启不触发无循环)。附带加固:窗口 decorFitsSystemWindows 强制 + View padding 硬闸门 +
blurLayer ANOMALY长期看门狗日志
安装
- LSPosed 勾选作用域
com.miui.home(OS2/OS3 家族自动判别),重启桌面生效 - 前置:媒体/通知访问权限;更新后请重启一次桌面
Full Changelog: v2.9.97-wallpaper-follow...v2.9.123-blur-restart
v2.9.96 — GraceLauncher v1.1.9 全量同步 + 装机回归修复
上游 GraceLauncher v1.1.9 全量同步(S1S6b,v2.9.8894)
- Grace Button 可移动:设置 → Grace Button → 右上角外观 → 「位置和大小」,支持 1:1 预览拖动 + 对齐/边距/大小精调
- 分区可见性:位置和大小页「显示范围」——仅首页 / 仅应用列表 / 两者
- 图标设计师大更新:图标可显示为圆点或隐藏;支持用应用自身图标主色重着色(HSB 微调)
- 主题调色板 9 风格:设置 → 主题 → 调色板风格(TonalSpot/Vibrant/Expressive 等,动态取色同样生效)
- 文件夹自动隐藏:文件夹编辑页开关,成员从应用列表隐藏(手动 ∪ 派生集合贯通列表/搜索/工作资料)
- 收藏编辑直达:应用弹层新增「编辑收藏」,打开即自动选中该应用
- DB v21→v22(paletteStyle / folders.autoHideApps),40 条新界面文案含官方中文
装机回归修复
- v2.9.87:「写了但没实现」全量审计整改(时钟自定义应用/设为默认启动器/私密空间入口等 13 项断链)
- v2.9.96:文件夹「自动隐藏内部的应用」开关点不动 —— 设置桥快照线格式漏 autoHideApps,已修
安装:LSPosed 模块,勾选作用域 com.miui.home(小米桌面),重启桌面生效。详见 README。
Full Changelog: v2.9.86-os4b-jb9...v2.9.96-autohide-fix
v2.9.55-sync-reveal — 天气链路重构 + 审计整改 + 结构性重构 + 实机修复批(vc 69→88)
自 v2.9.35-graceicon1 以来 22 个版本合并发布(v2.9.36 ~ v2.9.55,versionCode 68 → 88)。
新特性 / 架构
- 天气数据源重构(v2.9.36-miuiweather):移除外部 Breezy Weather 依赖,改直读小米天气 Provider。装机实锤 provider 存在调用方白名单(hasAccessProvider 仅放行 com.miui.home),天气读取上移宿主进程(GraceWeatherHostEngine)——桌面进程内直推,设置页随设置快照回带
- 本地化(v2.9.46~48):模块页退出多任务行为修正 + 硬编码文本全量资源化、B6.x 桌面文案中文翻译补齐、设置页残留英文收尾
稳定性 / 性能
- v2.9.37-auditfix:全仓代码审计(177 文件 ~18k 行)P0 级修复批
- v2.9.38-colorlaw:P1 铁律整改(语义化颜色全覆盖)
- v2.9.39-cleanup:P2 死代码清理 + 主线程编码治理
- v2.9.41-perf:热路径反射缓存(GestureIsolator / HomeController / MainHook)+ 时钟节拍统一
- v2.9.53-icon-perf:重启桌面后字母索引滑动卡顿修复
结构性重构
- v2.9.43-refactor1:壁纸效果层抽离
- v2.9.44-refactor2:WidgetController 抽离
- v2.9.45-refactor3:GraceButton 过渡状态机抽离
实机修复批
- v2.9.40-setbk:设置页返回堆叠修复
- v2.9.42-minusoff:负一屏预留线整体清除
- v2.9.49-settings-home:设置页退出直达桌面
- v2.9.50-folder-icon:文件夹自定义图标主页生效
- v2.9.51-icon-snapshot:单个图标设计保存不生效
- v2.9.52-refresh-keep:安装/卸载刷新期列表不再整列消失
- v2.9.54-favorites-first:重启桌面后应用区延迟 1-2 秒
- v2.9.55-sync-reveal:首页内容等收藏区就绪后整体出现(消除分步揭示闪烁)
说明
- MIUI 内置部件(gadget:时钟/一键清理/全局搜索)尝试(v2.9.56/57)已回退,挂起待后续,不在本版
- 逐版本细节见 docs/PORTING.md
安装
- 安装 APK → LSPosed 启用模块,作用域勾选 系统桌面(com.miui.home)
- 重启系统桌面
- 打开模块 App 完成前置闸自检(hook 生效 / 通知监听 / root 保活)
- 开启第四桌面
SHA-256:95447077385ce5d9ba0dfa44cf24089dea46743edcf1c072394342e5441f68a7
v2.9.35-graceicon1 — 上游 v1.1.8 全量对齐 + 图标装饰链落地
v2.9.35-graceicon1 — 上游 v1.1.8 全量对齐 + 图标装饰链落地
自 v2.9.20 之后的第 15 个版本(v2.9.21 → v2.9.35),一次补发。
版本信息
| 项目 | 值 |
|---|---|
| versionName | 2.9.35-graceicon1 |
| versionCode | 68 |
| 包名 | com.homemode4miui |
| APK SHA-256 | 791d46ab0d202963f620b16aacbbbdc770bc82492fc256edce355422f2096d1f |
| 签名 | 与 v2.9.20 同一 keystore(SHA-256 88a95369…afd0),可直接覆盖安装 |
| 许可证 | GPL-3.0 |
主要更新
宿主适配
- OS2 / OS3 双版本自动判别:
hook/HostCompat按 versionCode 分家族路由(OS3 =RELEASE-6.01.03.1927,Launcher 重构后方法整体上移BaseLauncher),同一份模块两族通吃
GraceLauncher 上游同步(v1.1.4 → v1.1.8,全量对齐完毕)
- S1+S2:Room schema v21 + A-Z 列表 / 列表外观
- S3:桌面手势 + Lab + 搜索下拉关闭
- S4:Grace Button 挂载与过渡状态机
- S5:字体管理器(assets 架构定制)
- S7:dimWallpaper 自定义遮罩色 + 文件夹左滑开首项
- S8:Work Profile 数据面 + 抽屉渲染 + 工作资料设置页与应用编辑器(严格 managed 过滤,双开语义零影响)
- appwidget pin 补齐 —— 上游 v1.1.8 功能面全量对齐完毕
性能与根因修复
- 功耗 + 冷启动专项五项根因修复(perf1–perf5)
- 自托管 Recomposer 帧时序根修(scrubfix)
- 无障碍三动作降级为第三层兜底 —— MIUI 原生路径逆向实锤(锁屏 =
ExtraStatusBarManager广播、通知栏/快捷设置 = statusbar 服务反射) - 搜索 FAB 移除(与 GraceButton 重叠遮挡手势);搜索打开时 GraceButton 禁用+隐藏门控
- 日志导出补内容级 tag 过滤(此前 1 分钟可导出 6MB)
图标与细节(本版新增)
- 应用图标设计生效:上游
LauncherViewModel.decorate / applyDesign装饰链补移植,自定义图标 / 图标包保存即生效 - GraceButton 图标修复:宿主进程模块资源解析根修(
Resources$NotFoundException→ createPackageContext 模块资源表) - 字母索引左边缘触摸修复(
leftTouchEnabled补传) - 设置页「添加自定义小组件」修复(ADD_WIDGET 跨进程桥,对齐桌面端 picker 语义)
- 时钟面板移除私密空间入口行(上游对齐)
- 应用名统一为 HomeMode4Miui
社区
- QQ 群「桌面第四模式」(群号
578966891)开通,扫码入口见 README
安装步骤
- 下载下方
HomeMode4Miui-v2.9.35-graceicon1.apk并安装 - 在 LSPosed 中启用模块,作用域勾选「系统桌面(com.miui.home)」
- 重启系统桌面(或重启手机)
- 系统设置 → 桌面 → 切换到第四种桌面模式
环境要求
- 小米 / Redmi 设备,HyperOS 或 MIUI,已 root 并安装 LSPosed
- minSdk 33(Android 13+)
- 开发基准宿主:OS2 =
RELEASE-5.39.40.10843、OS3 =RELEASE-6.01.03.1927。其它桌面版本可能存在 hook 签名漂移,详见仓库文档《移植到其它小米桌面版本》
已知限制
- MIUI 原生「全部小组件」中的特色卡片(私有原子组件框架)不经标准
AppWidgetProvider注册,标准 widget picker 枚举不到,属框架边界 - widget 本体点击在部分机型可能无效(
SecurityException,不崩桌面,修复跟进中) - 天气数据依赖 Breezy Weather Provider
完整设计文档与移植指南见 README。
v2.9.20-grace-dualapp
HomeMode4Miui 首个公开发布 🎉
一个 LSPosed 模块,为小米桌面 com.miui.home(HyperOS)以原生同款方式新增「第四种桌面模式」——不是换皮、不是借壳,而是真的 class CustomLauncherMode extends LauncherMode,与原生经典 / 抽屉 / 极简三种模式平级注册进宿主 LauncherModeController。
底座之上已全量移植 GraceLauncher(Kotlin + Jetpack Compose,GPL-3.0)桌面 UI,运行在宿主 com.miui.home 进程内;设置全家桶与通知/媒体/天气数据源运行在模块 App 进程,两进程经显式广播桥通信。
版本信息
| 项目 | 值 |
|---|---|
| versionName | 2.9.20-grace-dualapp |
| versionCode | 53 |
| 包名 | com.homemode4miui |
| 签名 SHA-256 | 88a9536994a63fcb590b78f5d83b0119c114fa30bab3f7482e50306be367afd0 |
| 许可证 | GPL-3.0 |
功能亮点
- 第四桌面模式:与原生三模式平级注册,原生设置页内即可切换
- GraceLauncher UI 全量移植:Compose 渲染的桌面主屏(时钟、日期、favorites 列表)
- 双进程架构:宿主进程负责 UI 渲染与手势隔离,模块进程负责设置/监听/天气,广播桥互通
- 手势隔离:手势只属于其自身 View,不与系统手势冲突
- 收藏增删即时刷新、时钟字体/样式切换
- 零崩溃铁律:全部 hook 点逐一隔离降级,异常带 stack trace 记录,桌面永不崩
安装步骤
- 下载下方
HomeMode4Miui-v2.9.20-grace-dualapp.apk并安装 - 在 LSPosed 中启用模块,作用域勾选「系统桌面(com.miui.home)」
- 重启系统桌面(或重启手机)
- 系统设置 → 桌面 → 切换到第四种桌面模式
环境要求
- 小米 / Redmi 设备,HyperOS 或 MIUI,已 root 并安装 LSPosed
- minSdk 33(Android 13+)
- 开发基准宿主:
com.miui.homeRELEASE-5.39.40.10843(HyperOS)。其它桌面版本可能存在 hook 签名漂移,详见仓库文档《移植到其它小米桌面版本》
已知限制
- 模块按 hook 签名匹配宿主版本,非基准版本的 MIUI Home 需自行适配(欢迎提 issue 附日志)
- 天气数据依赖 Breezy Weather Provider
完整设计文档与移植指南见 README。