Repository navigation
Releases
1.15.1
发布于 2026-11-08
修复
- 音量 / 亮度百分比 · 字重改为无级调节(目标
com.android.systemui):原来只能从细体、常规、粗体等固定档位中选择,且界面默认值与实际生效值不一致。现在改为 100–900 的无级滑块,旧档位名称会在升级时自动换算为对应数值,未设置过的用户保持原来的常规字重。 - 侧边音量条 · 三个点按钮改为三态(目标
com.android.systemui):原开关只有“显示”和“隐藏并长按展开”两种状态。现在改为下拉选择:正常显示、仅隐藏按钮、隐藏并长按展开;前两种都保留点击按钮展开面板,仅最后一种改用长按。旧开关为开启的用户会自动迁移到“隐藏并长按展开”。 - 音量面板 · 隐藏静音 / 勿扰后二级内容消失(目标
com.android.systemui):之前隐藏按钮时直接隐藏整个dnd_layout/ringer_layout根布局,连同内部的计时器等二级内容一起被移除;一级和二级又复用同一组按钮,展开二级面板后两个按钮也会一起消失。现在只隐藏按钮本体,并只在收起的一级面板生效;展开二级面板时恢复按钮与官方分隔,不改动容器高度,避免把静音 / 勿扰按钮压到一起;优先按资源 id 定位勿扰按钮,找不到按钮本体时也不会再隐藏整个根布局。 - 状态栏图标 · 锁屏单色图标颜色偏灰(目标
com.android.systemui):蓝牙等图标被重复写入onDarkChanged的原始颜色,覆盖了原生按区域和深色强度算出的 tint,锁屏上会比同组图标浅。现在useTint=true的图标完全保留原生结果,只对useTint=false的蓝牙单色图标补不透明颜色,且不替换 drawable。 - 权限提示 · 锁屏指示不跟随显示模式(目标
com.android.systemui):锁屏使用独立的MiuiKeyguardStatusBarView,其隐私指示是MiuiHomePrivacyView/home_privacy_container,不在普通状态栏 Host 的挂载路径里。现在锁屏 root 只注册隐私宿主,并与普通状态栏共用同一套隐私宿主判定:跟随系统 / 始终显示 / 隐藏 / 仅控制中心显示 / 仅控制中心隐藏五种模式全部生效;不把时钟、电池、通知或图标顺序等状态栏定制带到锁屏,原生onPromptInfoChanged等回调后也会重新套用。 - 音量面板 · 关闭时偶发系统界面崩溃(目标
com.android.systemui):收起动画期间不再从官方音量对话框移除应用音量入口与分隔线,改为仅隐藏并在下次显示时恢复,避免在Dialog.dismiss/detach阶段修改原生子 View 触发空指针。崩溃栈位于系统原生收起流程,崩溃进程日志中未出现模块记录,此项为防御性规避。
1.15.0
发布于 2026-10-30
新增
- 网速 · 单行显示(目标
com.android.systemui):网速指示器新增「单行显示」样式,把数值与单位放在同一行;未手动设置字号时约为普通数值字号的两倍,兼顾可读性与状态栏高度,不再沿用原生小字号。选择该样式后可在「状态栏图标 → 网速」中照常调整单位写法、慢速隐藏、刷新间隔与对齐。 - 定时深色模式 · 到点立即生效(目标
system_server):新增开关。HyperOS 默认会在定时深色/浅色时间到达后先挂起配置,等用户第一次息屏才应用;开启后改为到点直接切换,不再等待息屏。入口:系统界面 → 深色模式;开关变更需重启设备。 - 壁纸 · 桌面与锁屏分别压暗(目标
com.android.systemui/system_server):深色模式自动压暗壁纸原先只有一个压暗程度,现在拆成「桌面压暗程度」与「锁屏压暗程度」两个滑块(0–100%,默认均 30%)。系统公开接口会把同一个值同时写给桌面和锁屏,因此在system_server的DisplayConnector.applyDimming下发前按桌面 / 锁屏连接器分别替换数值;同时在 SystemUI 侧按锁屏状态切换公开接口写入值,system_server hook 尚未注入时锁屏滑条也生效。系统仍负责临时压暗与恢复。旧安装没有锁屏值时自动沿用当前桌面值,滑条调整即时生效。入口:系统界面 → 壁纸。 - 息屏玻璃 · 模糊背景跟随壁纸压暗(目标
com.android.systemui):AOD 时钟、锁屏时钟和锁屏通知的玻璃模糊在系统压暗壁纸之前取色,导致玻璃偏亮。现在统一在android.view.View的玻璃混色入口追加一层与锁屏压暗值同 alpha 的黑色,并跟随 MIUI 的混色重建;只在深色模式、已锁屏且壁纸压暗开启时生效,解锁后自动移除。「系统界面 → 息屏」页提供「息屏玻璃跟随压暗」开关,关闭后只压暗壁纸。 - 状态栏时钟 · 中文时段显示为 AM/PM(目标
com.android.systemui):新增独立开关。12 小时制下系统会把时段显示为“上午/下午”,该开关把“上午/下午/早上/晚上”等中文时段替换为 AM/PM;系统格式与自定义格式都生效,24 小时制不受影响。入口:状态栏图标 → 时间。 - 侧边音量条 · 多应用音量入口三档显示(目标
com.android.systemui):入口显示方式由「自动显示 / 始终显示 / 始终隐藏」三选一控制;选择「始终隐藏」时不再插入模块入口,也不会改变官方按钮间距。「自动显示面板」是独立开关:即使入口始终隐藏,打开侧边音量条时仍会自动展开面板。入口:侧边音量条 → 交互。 - 侧边音量条 · 独立隐藏按钮(目标
com.android.systemui):新增「隐藏静音/铃声按钮」「隐藏勿扰按钮」两个开关。隐藏后按钮与对应分隔一起从布局中移除,剩余按钮自动靠拢,不留空槽位。入口:侧边音量条 → 交互。 - 超级小爱输入法 · 材质不透明度(目标
com.xiaomi.type):在「全局高级材质」下新增 0–100% 滑条。官方没有单独的透明度 API,材质遮罩的浓淡实际由混色列表的 ARGB alpha 决定;现在按比例缩放mf.j材质层每个混色项的 alpha,0 只保留背景模糊,100 为官方默认,不改变模糊半径、圆角或输入法内容。滑条变更后重新打开输入法生效。
变更
- 网速 · 显示条件与单位样式整理(目标
com.android.systemui):网速图标不再声明“有流量 / 无流量”两个显示条件,显示与否统一由网速开关控制;指示器样式移除“仅显示数字”,改由单位样式的“不显示单位”承担,并移除与它重复的“显示单位”开关;单位名称统一为KB/s、K、KB、Kb、Kb/s,不再附带括号内的自动换挡说明。 - 输入法 · 功能入口合并:原来「超级小爱输入法」「搜狗输入法」是两个独立入口,搜狗入口还未出现在功能首页。现在先合并为一个「输入法」卡片,二级页内用「超级小爱输入法」小标题归纳材质与不透明度选项;搜狗适配暂时移到「实验性功能」,待验证后再恢复正式入口。顶栏重启按钮与作用域申请当前只覆盖超级小爱输入法。
- 重启应用 · 普通应用只结束进程:批量重启中的普通应用现在只执行结束进程,不再自动拉起启动 Activity,避免一次重启后前台弹出一堆应用;系统界面仍由系统自动恢复,系统进程仍走重启确认。
- 状态栏时钟 · 自定义格式改为开关控制(目标
com.android.systemui):状态栏时间、通知中心大/小标题、控制中心、横屏、平板日期各自的格式项前新增「自定义格式」开关,关闭时完全跟随系统;开启后格式卡片的默认值改为当前系统格式,并移除「留空跟随系统」的默认值说明。旧版本已写入的非空格式会自动补开对应开关。 - 横屏时钟默认格式:默认值改为“系统时间 + 月日星期”,并在日期与星期之间补一个空格,避免生成“M月d日周四”这类粘连样式。
- 脚手架 · 引用版本更新至 0.7.0:关于页的 MiuixGuiTemplate 版本改为 0.7.0。该模板版本纳入了 Hook 四色状态徽标、
evaluated_keys/failed_keys上报协议与状态组件,后续移植功能以 0.7.0 为基线。
实验性
- 搜狗输入法 · 键盘玻璃材质(暂停开发)(目标
com.sohu.inputmethod.sogou.xiaomi):新增「键盘玻璃材质」开关、模糊半径与圆角半径滑条,默认关闭;入口暂放在「实验性功能」,不再出现在正式「输入法」页。已在框架InputMethodService.setInputView(View)边界尝试给键盘根视图加 MIUI 背景模糊与圆角,但真机上未达到可见效果,功能暂停开发,等待后续重新定位渲染层。当前版本不保证生效,排查与验证前请保持关闭。
修复
- 权限提示 · 控制中心单独组件不跟随显示模式(目标
com.android.systemui):控制中心的权限提示由独立的MiuiPrivacyContainerView/MiuiFakePrivacyContainerView承载,不在状态栏privacy_area的层级里,原来的privacy_area路径和“仅控制中心”排除规则都碰不到它。现在运行时会额外发现这两个宿主,统一按电池相同的“状态栏 / 控制中心宿主”判断套用五种显示模式;并在原生onPromptInfoChanged、setPrivacyIcons、onAttachedToWindow之后重新套用,避免切换隐私状态或展开控制中心后被原生重新设为可见 / 隐藏。控制中心宿主只由模块执行“隐藏”,不再强制点亮,过渡动画继续交给原生ControlCenterHeaderController的 alpha 编排,修复展开 / 收起时控制中心圆点与过渡圆点同时出现。 - 双排堆叠信号 · 默认位置与间距(目标
com.android.systemui):旧图形以宿主底部为基线,默认整体比相邻图标低约 3.6dp,上下两排之间也只留约 1.1dp;现在整组在 16×20 视口内垂直居中,两排间距约 2dp,同时保留原有高度、缩放与左右间距配置。 - 通知组 · 子通知侧滑被裁切(目标
com.android.systemui):通知组展开时,子通知横向滑动仍受父级摘要行clipBounds的[0, width]限制,滑出组边缘的部分被直接裁掉;普通通知整行平移,所以没有这个问题。现在滑动期间只临时关闭父级摘要行与直接容器的clipChildren/clipToPadding并清空clipBounds,不再构造超屏裁剪矩形,避免悬浮通知的窗口触摸区域被异常放大;松手、复位或 detach 时恢复原状态,悬浮通知本身直接跳过。该修复默认关闭,可在「功能 → 系统界面 → 通知」中开启。 - 侧边音量条 · 展开状态下同时隐藏静音与勿扰后入口贴住音量条(目标
com.android.systemui):实时切换两个隐藏开关时,旧逻辑会把官方容器的外层topMargin改为 0,但展开态不会重跑官方 motion 布局,导致入口与音量条之间的间距立即消失,重新打开面板才恢复。现在不再改写官方上边距;旧版本遗留的 0 margin 会在下次同步时恢复原值,实时切换与重新打开面板表现一致。 - 导入设置 · 成功提示:导入成功后不再误报“即将重启应用”,改为提示本次实际更新的配置项数量;数值未变化的选项不计入,全部未变化时提示没有配置项变化。
- Hook 生效状态 · 不支持设备误报:设备形态不在功能白名单内或开关已关闭时,卡片不再显示历史“已生效”证据,避免在不支持的手机上出现“选项关闭却显示已生效”。
- 状态栏图标 · 展开控制中心时图标消失(目标
com.android.systemui):旧逻辑在通知面板展开时把「始终显示」以及所有condition:条件图标当作「仅控制中心显示」处理,面板拖动过程中展开状态反复切换,真实状态栏这一份被收掉,而过渡用的临时 CC 容器尚未就绪,图标就会整段消失。现在「始终显示」和条件显示图标都不再受控制中心 / 通知面板展开状态影响,展开、收起和过渡期间都保持可见;「仅控制中心显示 / 隐藏」仍按原语义切换。 - 状态栏图标 · 降低绘制与刷新开销(目标
com.android.systemui):通知圆点绘制不再每帧读取偏好、重复反射父类字段或分配Paint;图标查找复用id缓存;阴影展开期间新增图标触发的全量刷新合并为一次,避免每次通知图标增删都重载全部组件并重启原生图标动画。该优化不改变图标排序、显示条件与动画表现。 - 状态栏图标 · 蓝牙设备电量切到始终显示后过渡消失(目标
com.android.systemui):控制中心过渡播放的是独立的临时图标组件,它沿用RIGHT_BLOCK_LIST;蓝牙设备电量在这个IconManager的 block list 里,过渡组件里根本没有创建对应 View,只改ignoredSlots或 View 可见性不会生效。现在在IconManager.setBlockList下发时对“始终显示”的 slot 过滤,配置变化时重新下发原生列表,切回系统模式时恢复原生 block;补入任意IconManager的图标都会直接重放当前明暗回调,由各 View 自己的mExParams.useTint决定补色或保留主题图像,锁屏与控制中心临时组新增图标不再保留默认白色。 - 侧边音量条 · 隐藏任意数量按钮后自动平衡高度失准(目标
com.android.systemui):此前自动平衡只加「入口高度 + 分隔线」,隐藏一个官方按钮时入口增高正好被抵消,隐藏两个时面板反而变矮,平移方向和幅度都会错。现在以原生「两个官方按钮 + 分隔线 + 上边距」为基准,按当前可见按钮与入口的净高度差取半平移:隐藏一个时不再上移,隐藏两个时向下补,入口自身隐藏时也按剩余按钮回正;入口前的分隔线随入口 / 官方按钮状态一起收起。 - 侧边音量条 · 首次打开控制中心二级音量面板时误出现入口(目标
com.android.systemui):VolumePanelDelegate会在initController之前把MiuiVolumeDialogView.isControlCenterPanel置为 true,旧逻辑没有判断宿主就立即注入。现在注入前直接读取该 View 自身的控制中心标记,并在原生setControlCenterPanel(true)下发后移除已注入的入口;侧边音量条仍保持立即注入,不再依赖延迟 post。 - 状态栏图标 · 右侧左右间距把图标移到错误位置(目标
com.android.systemui):原生MiuiStatusIconContainer.onLayout按“子 View 宽度 + 左右 padding”推进排布,并自己写入每个子 View 的横向 translation。旧实现同时改minimumWidth和translationX,原生排布与模块位移相互叠加,除电池外的右侧图标都会跳到错误位置。现在只保留最小宽度占位,用scrollX移动 View 内部内容,不再改写translationX;原生布局、图标动画与电池容器均不受影响。
1.14.0
2026-10-25
新增
- 状态栏 · 图标自定义(目标
com.android.systemui):在「系统界面 → 状态栏」新增图标框架,支持按原生顺序管理左侧与右侧图标。- 主页面使用 Miuix 分组卡片展示图标预览、名称与当前条件;右侧 slot 拖动即时生效。
- 通知图标归入左侧宿主;平板日期作为独立左侧行,可单独显示/隐藏与设置格式,并在平板与折叠屏上开放。
- 图标清单补齐为 47 个,严格对齐本机
config_statusBarIcons,加入micphone、mikey、privacy_mode、gps、missed_call、managed_profile、second_space、cast、ethernet、tty、volume等原生 slot;不再把gps合并进location。 - 右侧排序使用完整 slot 映射,未暴露的 slot 也参与,避免 VPN/静音/勿扰等顺序与设置不一致;动态图标出现后由刷新统一重排。
- 二级页使用单一“显示条件”下拉菜单;布局支持偏移、间距、缩放、透明度、字重与字号,字重滑条步长 10。仅右侧图标提供“仅控制中心显示/隐藏”,左侧时钟、运营商、通知不再出现这两个选项。
- 电池在状态栏与 CC 头是两套独立宿主,“仅控制中心显示/隐藏”按所在宿主分别生效,不再同时隐藏两套电池。
- 控制中心过渡 fake 组跟随普通状态栏的图标状态,只有正常 CC 头使用控制中心语义。
- 隐藏图标时同步维护对应容器的
ignoredSlots,onLayout会真正跳过该 slot,不再留下一个图标宽度的空白占位;切回默认/其它模式时只撤销模块自己加入的 ignored,图标暂时消失时也会清理残留。 - 始终显示只对原生已有内容的图标强制可见;默认跟随系统,VPN 等关闭时不占空位、不伪造图标。
- 右侧图标左右间距改为独立的“最小宽度占位 + 内容位移”,修复左边距同时撑大左右两侧、右边距只撑大右侧的问题;并在
MiuiStatusIconContainer.onLayout前后还原/叠加位移,避免原生动画把间距当起始位置。 - 时间支持状态栏、通知中心大/小标题、控制中心、横屏与平板日期;含秒格式自动 1s 刷新。横屏时钟格式仅对手机开放,折叠屏/平板使用系统默认格式。
- 时间格式通过弹窗编辑,右上角提供官方日期格式说明入口;时钟宽度 20..240dp。
- 闹钟只保留“响铃前显示”条件与 0..72 小时阈值;阈值滑条只在选中该条件时启用,其他条件灰显,并增加 15s 低频重算避免系统广播丢失后条件不生效;移除“仅无闹钟时显示”。
- 网速支持独立字号、显示单位、单位写法、慢速隐藏与 0..1024KB/s 阈值、1..10s 无级更新间隔、系统双行 / 仅数字 / 上下行双排、对齐与字重;更新间隔直接改写控制器采样延时。
- 网速双排复用原生两个 TextView 显示上行 / 下行,两行统一同字号、同格式,默认上行在上;方向标记可选箭头、三角或不显示,并可放在数值左侧或右侧,箭头与数值间距收紧为 thin space;可调整双排行间距。单位写法支持 KB/s、K、KB、Kb、Kb/s,数值与 K/M/G 前缀同步缩放;系统双行样式也按当前 K/M/G 量级应用所选单位,只改单位标签,不改原生数字、字号和采样。移除单行样式、单位换算和“仅显示单位”样式。
- 通知图标支持“按隐藏图标数量显示圆点”:每多隐藏一个图标增加一个点,最多三个;通知增删后主动重绘并兜底刷新溢出索引;修改最多图标数时重算
mFirstOverflowIndex并重绘,圆点数量实时变化。关闭保持系统固定三点。最多图标数在通知容器构造、onLayout前和setMaxIconsAmount时立即重放,修复从通知中心返回时短暂回退系统三图标、约 1 秒后才恢复的问题。 - 预览主体使用 MIUI 风格图标资源;隐私指示与电池改为按状态自绘,避免错误底板和静态电池图标。
- 双排移动网络的垂直偏移合并到移动网络布局页,不再重复设置。
- 详见 状态栏图标自定义。
- 超级小爱 · 长按小白条打开灵感球(目标
com.miui.voiceassist):新增「长按小白条」设置项。开启后,长按底部手势导航条会打开超级小爱灵感球,并跳过官方默认的长按识屏;关闭则保持系统原本的长按识屏。实现不复制灵感球窗口,直接调用官方IntentionalBallManager.operate("home_intentional_ball", session),复用其悬浮球、录音与识屏链路。官方窗口首帧会向桌面com.miui.home.gesture.enableState查询xiaoai_ball_ready坐标;长按没有侧滑手势会话时该查询返回 null,窗口会立刻releaseScene,所以同时补充长按触发点(底部中间)坐标,让官方onEdgeEnterReady从触发位置启动 ASR。 - 超级小爱 · 双击小白条聊天满血光效(目标
com.miui.voiceassist,适配 8.3.30):双击底部手势条打开聊天时,复用官方电源键长按的PowerWake全屏光效(ms1.j.c→os1.k#r()/os1.p#h()),效果与长按电源键进入聊天时一致;默认开启,可在「超级小爱 → 长按小白条」中关闭。 - 超级小爱输入法 · 全局高级材质(目标
com.xiaomi.type,适配 0.2.1246):在「功能 → 超级小爱输入法」新增开关。开启后把当前输入框包名加入官方 HyperMaterial 允许表,所有应用都使用输入法顶部的 24dp 圆角与背景模糊,而不再只限于部分官方应用;同时覆盖输入法设置里的「高级材质」总开关。实现不复制材质层,直接复用官方jb.f0的k()状态计算与e0圆角 OutlineProvider;关闭时完全不干预官方白名单。
修复
- 状态栏图标语义映射(目标
com.android.systemui):mute实际是通话麦克风静音,volume才是声音模式(静音/振动),设置页名称简化为“静音”;mikey是米键而不是键盘;同步修正设置页名称与预览图。 - 状态栏/控制中心显示条件(目标
com.android.systemui):仅控制中心显示/隐藏改为按容器维护ignoredSlots,隐藏后不再留下图标宽度的空白占位;电池按状态栏 / CC 两套宿主分别生效;过渡 fake 组跟随普通状态栏;左侧图标不再提供仅控制中心选项;横屏时钟格式仅手机可用,平板日期与平板专属功能对折叠屏开放;“仅无闹钟时显示”已移除。 - 多应用音量 · 面板残留屏幕最左侧(目标
com.android.systemui):侧边音量条隐藏时通常只改 dialog 可见性而不 detach,旧面板容器仍挂在 DecorView 上;其逐帧定位读到隐藏 dialog 的(0,0),把面板marginEnd推到屏幕外,看起来像在左侧出现一个错位面板。现在面板显示期间逐帧检查 dialog 的 attach /isShown,隐藏即清理,并在 dialog 隐藏、未布局或宽度为 0 时拒绝重新计算位置;自动展开也增加 dialog 可见性检查,避免在已收回的音量条上创建面板。
1.13.0
发布于 2026-10-18
新增
- 状态栏 · 网络图标(目标
com.android.systemui):新增「系统界面 → 状态栏」页,提供「隐藏 Wi-Fi 活动指示器」「完全隐藏网络类型」与「显示双排堆叠信号」开关,默认关闭。双卡固定为上排 SIM 1、下排 SIM 2,使用普通宽度四格图形;移除加粗样式,统一图形比例并在绘制前完成更新,避免过渡中切回原生形状。下拉面板和返回桌面时的双排过渡已通过真机验证。 - 负一屏 · 过渡动画优化(目标
com.miui.personalassistant/ system_server):新增「负一屏」功能页。过渡闪黑修复消除打开 / 返回快速切换时的纯色闪黑;上滑合并强制反向修正返回动画被系统合并时先反向播一半的问题;放行远程动画权限(系统服务侧,需重启设备)让负一屏的远程过渡动画完整生效。思路参考 HyperAssistant(非开源,独立实现)。 - 负一屏 · 打开应用动画与过渡遮罩重绘(目标
com.miui.personalassistant):应用打开动画让负一屏点开的应用从图标位置缩放展开(options 逐级剥离重试,失败回退框架动画);过渡遮罩重绘修复过渡中遮罩显示异常内容。 - 负一屏 · 返回缩回动画(目标
com.miui.personalassistant):关闭应用回到负一屏时,部件快照从全屏缩回原位,接近末尾渐隐;需先开启「应用打开动画」。 - 通知(目标
com.android.systemui/com.android.settings/system):新增「系统界面 → 通知」页与七项开关(锁屏保留、锁屏显示、悬浮资格、受保护通知修改、重要程度、历史折叠、每应用 10 条限制),默认关闭;涉及系统框架的修改需完整重启。说明见 通知功能说明。 - 应用包管理组件净化(实验性)(目标
com.miui.packageinstaller):在「功能 → 实验性功能」中新增推广、风险检测、云配置、安全守护提示、频繁安装检查与安装信息上传六项独立开关,默认关闭。提供挂载状态及可刷新、复制、清除的诊断;保留 Android 签名与安装授权校验,新增说明同步提供中英文。功能使用现有基础接口独立接入,未新增运行依赖、权限或原生库,可整体撤回。
变更
- 顶栏渐变模糊 · 多模糊行为可选(目标 MIUIX 应用):新增「同时显示多个模糊」开关与「其余顶栏显示」下拉项。默认只保留一个真实模糊节点,被让位的顶栏恢复 hook 前的透明度渐变遮罩(不再变为空白);可切换为「无渐变」;也可手动开启「同时显示多个模糊」验证全部真实模糊,但该模式在平板双栏/三栏会触发图形驱动崩溃,仅用于测试。
- 基于脚手架更新至 MiuixGuiTemplate 0.5.5(
about_based_on/ 文档同步):并入英文文案与专有名词规范、公开仓库隐私保护规范、逆向产物存放与构建日志约定。 - 基于脚手架更新至 MiuixGuiTemplate 0.6.0(
about_based_on同步):液态玻璃底栏按 SukiSU-Ultra 重做——按压即定位、内容宽度自适应(28dp 边距居中、标签至少 76dp)、折射采样 padding 修正圆角硬边、AGSL 交互高光与重力高光量化。
修复
-
壁纸 · 模糊背景未跟随深色压暗(目标
com.android.systemui/com.miui.personalassistant):控制中心、负一屏取壁纸做模糊的背景此前停在压暗前的亮度(压暗改的是壁纸图层的 alpha,模糊读的是壁纸纹理);现在给这类模糊容器补上同浓度的压暗层,背后是应用而不是壁纸时自动不加。重启系统界面生效。 -
安全模式 · 快速重启被误判为崩溃循环:系统界面等进程短时间内被重启两次就会被计为崩溃循环、自动跳过全部 Hook(表现为多应用音量入口消失、系统界面侧功能全部无效,真机日志已确认该链路)。现在阈值提高到连续 3 次,应用内主动发起的重启后 30 秒内的启动与子进程上报均不计入;误触发后可在「设置 → 安全模式」一键恢复。
-
顶栏渐变模糊 · 平板双栏崩溃 / 模糊不恢复(目标
com.miui.notes/com.android.fileexplorer):平板笔记和文件管理会在同一进程里同时挂多个ActionBarContainer(双栏 + 导航转场 ghost 快照)。此前每个顶栏都创建 blur 节点并互相让位,滚动时每帧反复切换厂商 blur 模式,Adreno Vulkan 驱动在 RenderThread 提交阶段空指针崩溃;崩溃前还会互相隐藏,表现为模糊消失且不再恢复。现改为进程级唯一 blur owner:只保留当前栏的节点,用户滚动另一栏时转移 owner,不再同时恢复第二个节点;让位释放延迟到下一帧,避免在onDraw调用栈内销毁正在提交的 blur 资源。 -
顶栏渐变模糊 · 文件管理文件夹顶部间距(目标
com.android.fileexplorer):文件夹页的路径栏是ActionBarContainer的 sticky view,ActionBar 高度已包含路径栏,但文件管理的NestedHeaderLayout没有开启enableStickyViewContentInset,SpringBackLayout仍从标题栏底部开始布局,首个文件被路径栏盖住。现按「ActionBar sticky view 是否为路径栏」做结构判定,覆盖手机普通布局、平板双栏与第三方文件选择器,不依赖具体 Fragment 类;路径栏出现/高度变化后自动修正,离开文件夹页恢复。 -
顶栏渐变模糊 · AI 通话详情页(目标
com.xiaomi.phone):为com.xiaomi.phone.settings.AiCallDetailActivity接入顶栏渐变模糊,仅接管该 Activity 的ActionBarContainer,不影响拨号、通话中等其它页面;需在 LSPosed 作用域中勾选「电话」。 -
侧边音量条 · 多应用入口出现后整条发虚(目标
com.android.systemui):官方形变动画播放期间不再改变窗口高度,自动平衡平移取整到物理像素。 -
通话时系统界面 ANR(多应用音量探测阻塞主线程)(目标
com.android.systemui):正在播放应用的探测移出主线程、改后台快照,通话时不再因音频服务阻塞导致输入超时 ANR。 -
多应用音量 · 正在播放的应用识别与官方不一致(目标
com.android.systemui):改为逐条对齐官方判定(uid ≥ 10000、剔除壁纸、STARTED、USAGE_MEDIA或STREAM_MUSIC、按 uid 去重)。 -
多应用音量 · 音量条展开后才出现的播放应用不会自动展开面板(目标
com.android.systemui):入口出现时同样按「自动显示」展开,并在展开 300ms 后按最新列表重试一次。 -
多应用音量 · 入口按钮出现 / 消失时被截断(目标
com.android.systemui):出现时先参与布局再播动画,消失时先播动画再收起。 -
多应用音量 · 共享 UID 应用的控制修复(目标
com.android.systemui/com.miui.misound):播放身份按 UID + 真实包名解析,两条写入路径统一并对该 UID 的全部播放器生效。 -
Hook 生效状态 · 多 Load 目标进程上报被顶掉:改为全部 Load 完成后统一上报(每进程一次广播不变);并修复通知悬浮资格、重要度图标抑制在本机 ROM 的兼容。
1.12.0
发布于 2026-10-12
新增
- 柔光玻璃 · 覆盖融合设备中心(目标
com.android.systemui):控制中心「融合设备中心」里的每个圆形设备组件(含末尾「设备中心」入口)此前只有一层纯色底(官方deviceControlItemToken的 bionics 分支为纯色),现统一套用与一级界面同款的柔光玻璃并保留圆形轮廓;跟随总开关生效,总开关同时改名为「更多场景启用柔光玻璃」。入口:系统界面 → 控制中心 → 柔光玻璃,重启系统界面生效。 - 壁纸 · 深色模式自动压暗(目标
com.android.systemui):新增开关 + 压暗程度滑块(0–100%,默认 30%)。深色模式下自动把壁纸整体压暗,切回浅色模式自动恢复,深浅色切换实时跟随;调整滑块后即时生效。入口:系统界面 → 壁纸,重启系统界面生效。
优化
- 控制中心 / 侧边音量条百分比数值颜色:灰色数值改为与控制中心播放器组件「暂无播放」完全一致的颜色与不透明度(
#80ffffff,即 50% 白)。 - Root 权限申请频率:去掉主页的定时轮询与每次回到前台都检测的逻辑,改为只在应用打开时检测一次、点按主页状态卡片手动检测一次,避免无权限时反复弹出授权窗口、有权限时反复弹出权限使用提示(模板仓库已同步)。
- 顶栏渐变模糊 · 性能优化(目标 MIUIX 应用):新增打开页面后的首帧预热——先以几乎不可见的透明度渲染一次模糊,把首次模糊管线 / 着色器程序的创建从「第一次滚动」提前完成,避免打开应用立刻下滑时卡顿;滚动交互期间让位侧的模糊暂时释放(系统实时模糊无法「暂停」,两侧同时渲染会卡死),恢复由顶栏的嵌套滚动信号精确驱动:滚动(含惯性)一结束就立即恢复被让位的一侧(无该信号的页面按约 1 秒无绘制帧兜底),静止时两侧可同时保持模糊;透明度按 1/64 量化、模糊几何按 8dp 步长量化,滚动期间不再逐帧更新合成与重设参数;配置读取改为 1 秒节流快照;回到顶部静止 8 秒后自动释放模糊管线;并补充系统 UI 实时表面同源的模糊缩放参数(
setMiBackgroundBlurScaleRatio,0.075)。强度与透明度设置、模糊观感均保持不变。
修复
- 功能页滑条拖不动(App 侧):主页采用 Cross-Axis 翻页拦截(父级在
PointerEventPass.Initial阶段先消费横向拖拽),页面内的滑条默认收不到手势、无法拖动。现改用项目内的pagerSwipeOverride(改编自 miuixPagerGestureUtils,Apache-2.0):滑条按下时同步「认领」本次手势、翻页对其放行;非拖拽区域的左右滑动切页、惯性与触控板翻页、无障碍翻页均不受影响。 - 窗口管理 · 进入单应用分屏仍被重置为系统预设比例(目标
com.android.systemui,平板):开启「解除单应用分屏比例限制」或「分屏比例无级调节」后,关闭另一个应用、拖拽把手收起一侧或重新进入分屏时,系统仍会沿三条路径把分割线先重置回 1:1——关闭手势预测(setDivideRatioOnGestureEnd)、分屏模式切换收尾(startPendingSplitModeChange)、进入分屏布局(SplitLayout#resetDividerPosition/SplitLayout#setDivideRatio(1))。现已抑制前两条路径的强制回中,并在第三条路径上于官方重置后立即恢复调用前的位置(越界时收敛到合法档位范围):进入(单应用或双应用)分屏时保留上次比例,不再自动跳到系统预设档位;进入后的无级调节照常可用。另外,应用退到后台、回到桌面且处于半屏时,桌面会主动调用setSplitRatio(1)把比例重置回 1:1(桌面LauncherSoscController的_resetSplitRatio: resetting to 1:1),现已在该接口的系统界面服务端按调用方进程精确识别并忽略这类重置(用户自己在系统界面内的操作不受影响),回到桌面后再进入分屏不再回到预设比例。入口:系统界面 → 分屏与窗口 → 窗口管理,重启系统界面生效。
变更
- 基于脚手架更新至 MiuixGuiTemplate 0.5.4(
about_based_on/ README 同步):并入「主页 Pager 手势放行」(ui/util/PagerSwipeOverride.kt,滑条等横向拖拽子组件按下时认领手势)、HookOptionsPage顶部提示区topContent、Hook 侧偏好变化监听HookPrefs.registerListener(改配置即时生效,用于深浅色壁纸压暗的滑条)、多级依赖链与「Root 检测时机」规范;docs/API.md(3.6 / 4.1 / 5.3 / 5.4 / 新增 5.8)与docs/CUSTOMIZE.md(新增 7.7)同步。
1.11.0
未发布
修复
- 「···」把手菜单分屏按钮点哪个都进上一次的方向(目标
com.android.systemui):进入分屏真正使用SplitLayout缓存的mIsLeftRightSplit,而此前只翻转了「动态方向标志」,加上方向兼容层改写后两者不再同步,官方预校正也随之失效;现改为调用官方SplitLayout#updateDynamicLeftRightSplit()对齐布局方向,四个按钮各自进入对应方向。顺带修复补出的按钮从 wmshell 线程removeView/addView的隐患。 - 「解除单应用分屏比例限制」拖拽后仍回弹(目标
com.android.systemui):官方DividerSnapAlgorithm#snap在单应用分屏下只吸附固定档位(1:1 / 1:3 / 1:9),松手即回到固定比例;现按官方「自由吸附」语义返回自由目标(snapPosition 10),并让SoScUtilsImpl#findSnapTarget不再钳制该目标,比例可任意停留。 - 已分屏时点「···」切不到另一种分屏方向(目标
com.android.systemui):补出的分屏按钮此前在分屏中只沿用官方「同侧聚焦 / 异侧换位」语义;现在点到另一方向的按钮会调用官方switchSplitDirection()旋转分屏方向(未开「解除分屏方向限制」时横屏不支持上下分屏,保持官方语义)。 - 「···」按钮超过 5 个时收回动画收向第三个按钮(目标
com.android.systemui):菜单窗口加宽并左移后,缩放动画的枢轴(窗口左上角到圆点中心的水平偏移)没有同步补偿,收回时偏出一个按钮位;现在窗口宽度、位置与枢轴一起补偿,收回动画收向圆点中心。 - 解除单应用分屏比例限制完全失效(目标
com.android.systemui,平板):自由吸附目标DividerSnapAlgorithm$SnapTarget是静态嵌套类,构造器只有(position, snapPosition);上一版按「内部类」多传了外部实例参数,构造抛异常被兜底逻辑静默吞掉,自由目标退化、官方钳制重新生效。现按正确签名构造(并兼容内部类变体);该自由吸附现由新增的「分屏比例无级调节」开关控制。 - 关闭另一个应用进入单应用分屏时比例被重置回 1:1(目标
com.android.systemui,平板):关闭应用或点把手时SoScStageCoordinator#setToDefaultSplitRatioIfNeed会调setDivideRatioForSoSc(1, …)把分割线设回 1:1;开启「解除单应用分屏比例限制」或「分屏比例无级调节」后不再重置、保持当前比例(其余调用点如进入分屏仍保持官方行为)。 - 分屏中「点左却落到右、点下却落到上」(目标
com.android.systemui):官方的方向切换过渡只改方向、保留各窗口原有的「第几侧」角色(上→左、下→右),所以补出的分屏按钮在已分屏状态下直接旋转时,落点由角色映射决定而不是点击的按钮;现在旋转前先按需用官方接口静默互换两侧位置(无额外位移),随后的旋转动画一次落到用户点击的那一侧。 - 1:9 拖拽过渡的位移曲线(目标
com.android.systemui,平板):先在「1:3 → 1:9」区间的前 90% 行程里保持小窗整窗留在屏幕内(偏移恒为 0),只有非常接近 1:9 档位的最后 10% 才用 smoothstep(3s²−2s³,两端导数为 0)平滑地把小窗移出屏幕;两端(1:3 / 1:9)形态与官方完全一致、中间不再跳变,也不再在还远离 1:9 时就把小窗挤到屏幕外。 - 小窗有部分在屏幕外时点击直接落到应用(目标
com.android.systemui,平板):自由比例下分割线停在「相邻档位 → 1:9 档位」之间时小窗已部分移出屏幕,但官方只在正好停在 1:9 档位(mSplitState为 3/4)时才挂「离屏触摸区」,其余位置点击会直接落到应用;现在检测到任一窗口有部分在屏幕外且官方未覆盖时补一层同样的触摸区——第一次点击先让该窗口滑入屏幕并成为主窗口(复用官方snapToTarget到对侧 1:9 档位,动画、分屏状态与窗口边界收尾与官方一致),触摸不再直接落到应用;窗口移回屏幕内后触摸区自动移除,之后触摸直接交给应用。 - 无级调节后靠近系统档位仍应吸附(目标
com.android.systemui,平板):「分屏比例无级调节」与「多分屏无级调节宽度」开启后,分割线在任意位置都可停留;现在补上磁吸——松手位置距系统档位小于 24dp 时仍吸附到该档位(1:1 / 1:3 / 1:9 …),方便快速回到标准比例。 - 切换上下 / 左右分屏后应用占比被重置(目标
com.android.systemui,平板):官方在initDividerPosition里按旧占比换算出的位置随后会被两处强制改掉——切到左右分屏且分割线不在 1:1 时,switchSplitDirection会按焦点把分割线强推到 1:9 档位;切换过程中桌面推送的「分割线锁定」(平板常置 true)会让onPreSoScStateChanged把布局边界钳回 1:1(单应用分屏还会直接在initDividerPosition里重置成中间)。开启新增的「切换方向保持比例」后,切换时按切换瞬间的实时占比重写分割线位置,并临时挂起以上两处强制(结束时按桌面最新一次推送恢复),换算位置非常接近 1:1 / 1:9 档位时贴回档位避免往返漂移;左右 ↔ 上下与旋屏后各应用占比保持不变。 - 单应用分屏里两个比例功能完全失效、自由比例松手动画回弹(目标
com.android.systemui,平板):平板上桌面(Launcher)会常驻把「分割线锁定」(mIsDividerFixed)推为 true,官方据此不仅钳制松手吸附目标,还会在松手的状态广播里把布局边界按 1:1 重算(onMultiWindowStateChanged走mMiddleTarget)、在拖拽预览里同样按 1:1 计算边界——于是单应用分屏里比例总被拉回 1:1,自由比例松手后也会先闪回 1:1、再跳回真实位置(观感「放大动画播到一半跳到终点」,只在非标准比例时出现)。现在开启「解除单应用分屏比例限制」或「分屏比例无级调节」后,该标志一律归一化为 false(含已存在的取值),官方按当前分割线位置计算边界。 - 自由比例松手的「放大动画」播到一半直接跳到终态(目标
com.android.systemui,平板):拖拽期间官方会把窗口整体缩放(mScaledRatio≈ 0.969 的「回缩」预览),松手后靠 fling 的每一帧把缩放平滑回 1.0——这就是用户看到的「放大」动画;自由比例松手时 fling 距离为 0,SplitLayout#flingDividerPosition走「立即返回」分支,没有逐帧更新,缩放回弹在 1~2 帧内跳完(观感「放大一半直接切到终态」)。现在自由松手会改写成一次「几乎不动」的官方 fling(起点挪到目标旁 1px、时长保持官方传入的 250ms),逐帧更新、收尾时机与标志维护全部交给官方实现:分割线视觉上不移动,放大回弹与官方档位松手一样逐帧播完。 - 「分屏比例无级调节」开启后卡片仍显示「未生效」(目标
com.android.systemui):「解除单应用分屏比例限制」与「分屏比例无级调节」共用一次挂载,但状态只按单应用键回报;现在按本次挂载时各自开关的取值分别上报,只开全局开关时对应卡片也会显示已生效。 - 「···」把手菜单靠屏幕边缘时不再自动避让(目标
com.android.systemui,平板):补出的分屏按钮把菜单加宽后,官方的屏幕边界避让仍按原宽度计算,菜单会探出屏幕;现在加宽后按屏幕边界钳制窗口位置,并同步缩放枢轴与「···」圆点动画的枢轴,收回动画与圆点放大都仍对齐菜单中心。 - 最小化单应用分屏里拖拽分割线导致系统界面崩溃(目标
com.android.systemui,平板):「分屏比例无级调节」的自由状态(snapPosition 10)会被写进SplitLayout#mSplitState,而官方在「最小化单应用分屏里拖拽分割线」的路径里会用DividerSnapAlgorithm#findSnapTarget(snapPosition)反查目标表——表里没有 10 → 返回 null →SoScUtilsImpl#sendPreSoScStateChangedIfNeed直接读.position触发 NullPointerException(wmshell.main崩溃)。现在按官方兄弟分支同款回退,把落空的查询换成mMiddleTarget。 - 从左分屏切到下分屏时两个应用的占比互换(目标
com.android.systemui,平板):把手菜单的「跟随应用」此前把点击应用在旧布局的占比直接交给比例记忆,但方向切换保留各窗口的「第几侧」角色(上→左、下→右),应用落在槽位 1(下/右)时新分割线(槽位 0)占比应是1 - 应用占比,于是两个应用的占比被互换;现在按槽位换算后再落位(落到上/左 = 原占比,落到下/右 = 1 - 原占比)。
新增
- 窗口管理 · 解除分屏方向限制(目标
com.android.systemui,平板):新增开关。系统在平板上按方向写死「竖屏只能上下分屏、横屏只能左右分屏」;开启后竖屏也可左右、横屏也可上下,分屏线菜单里的方向切换按钮会真正生效,···把手菜单同时给出左右与上下两对分屏按钮(点击时自动把方向切到对应方向),且把手菜单的分屏图标与实际方向一致(统一SplitUtilsImpl/MulWinSwitchSplitUtils的方向判定)。入口:系统界面 → 分屏与窗口 → 窗口管理,重启系统界面生效。 - 窗口管理 · 自定义多分屏数量(目标
com.android.systemui):新增总开关 + 数量滑块(3–6,默认 6 即官方值)。多分屏上限由MultipleSplitOrganizer.MAX_STAGES决定(高内存默认 6、低内存 3,官方另有系统属性覆盖口);开启开关后接管该值与解析方法,无需 Root,关闭开关则完全保持官方行为。入口:系统界面 → 分屏与窗口 → 窗口管理,重启系统界面生效。 - 窗口管理 · 解除单应用分屏比例限制(目标
com.android.systemui,平板):新增开关。只保留一个应用分屏(另一半显示桌面)时,系统会把分割线吸附目标钳到中间 1:1 / 固定值,导致比例不能自由拖动;开启后回落到正常计算的吸附目标,分割线可自由设置比例。入口:系统界面 → 分屏与窗口 → 窗口管理,重启系统界面生效。 - 窗口管理 · 分屏比例无级调节(目标
com.android.systemui,平板):新增开关(全局)。分割线可在两端档位之间任意停留(官方自由吸附目标snapPosition 10),两个应用分屏与单应用分屏都生效;「解除单应用分屏比例限制」现在只负责解锁标准档位(1:1 / 1:3 / 1:9 …)与阻止比例被重置,无级调节改由本开关控制。入口:系统界面 → 分屏与窗口 → 窗口管理,重启系统界面生效。 - 窗口管理 · 1:9 拖拽过渡(目标
com.android.systemui,平板):新增开关。1:9 档位下小窗会保持大窗口尺寸并大部分移出屏幕(可见部分是内容的一角);官方只在分割线跨过 1:9 档位的那一刻一次性加上这个「移出屏幕」偏移,于是从 1:3 拖向 1:9 时窗口会瞬间从「全在屏幕内」跳成「大部分在屏幕外」。现在先在「1:3 → 1:9」区间的前 90% 行程里保持小窗整窗留在屏幕内,非常接近 1:9 时才平滑移出屏幕(1:3 与 1:9 两端与官方完全一致,反向拖动同样平滑);小窗只要有部分在屏幕外,第一次点击会先把它移回屏幕内(见「修复」)。入口:系统界面 → 分屏与窗口 → 窗口管理,重启系统界面生效。 - 窗口管理 · 多分屏无级调节宽度(目标
com.android.systemui,平板):新增开关。多分屏(2–6 个应用)里分割线会被吸附到固定档位(snapPosition 21..34),位置校验也直接拒绝「不在任何档位上」的位置;开启后拖拽不再吸附、松手停在原地,每个应用的宽度可在最小宽度与可用空间之间任意设置(最小宽度限制仍按官方)。入口:系统界面 → 分屏与窗口 → 窗口管理,重启系统界面生效。 - 窗口管理 · 切换方向保持比例(目标
com.android.systemui,平板):新增开关。左右分屏与上下分屏互相切换时,每个应用保持各自的占比不变——按下切换那一刻的实时占比直接沿用(不按方向分别记忆、没有延迟),单个应用分屏同样生效;···把手菜单点另一方向的分屏按钮时先记录点击应用切换前的占比、再对齐侧序,落位跟随应用而不是位置。入口:系统界面 → 分屏与窗口 → 窗口管理,重启系统界面生效。
变更
- 分屏功能的设备支持调整:仅「分屏比例无级调节」对所有设备开放;其余分屏功能(解除分屏方向限制、解除单应用分屏比例限制、切换方向保持比例、多分屏数量与无级调节宽度、1:9 拖拽过渡、把手菜单双向分屏)限定平板与折叠屏——手机(直板)上界面灰显、hook 侧同步设备作用域(完全不加载,保持官方行为)。
- 移除「分屏圆角按边适配」「分割线圆角跟随屏幕」两个开关:分屏窗口四角圆角与分割线圆角完全保持系统官方行为,不再做任何改写。
1.10.1
发布于 2026-10-10
修复
- 识屏动画圆角适配在平板上不生效(目标
com.miui.voiceassist):判断是否需要改写起始圆角时错误地与卡片圆角(24dp)比较,而大屏 / 高密度设备的屏幕圆角更小(Xiaomi Pad 7 Ultra 圆角 54px、密度 440dpi ≈ 19.6dp),条件不成立直接跳过,动画仍从写死的直角开始。现改为只与「应用写死的起始圆角」比较:屏幕圆角更大即改写,动画从屏幕圆角平滑过渡到卡片圆角。入口:浏览器 → 场景。
变更
- 功能页按「作用对象」重排:一级入口改为扁平列表(不分小标题)——系统界面 / 系统应用 / 设备互联 / 安全服务 / 超级小爱 / 密码 / 浏览器 / 实验性功能,一个入口对应一整块功能;原先混在「外观」页里的音量、息屏、融合设备中心、网络、超级小爱等内容各归其位,页面层级由最深 4 层降到 3 层。
- 页面合并与改名:「外观」改为「系统界面」(页内分控制中心 / 音量 / 锁屏与息屏);「布局调整 → 音量条」两层合并为一页「音量条布局」;「顶栏渐变」页扩为「系统应用」(设置 / 短信 / 联系人等 MIUIX 应用);「密码」页内分区重新归类为「系统服务路由」「应用适配」;「实验性功能」页保留,页内以「天气」分区收纳天气高级外观。
1.10.0
发布于 2026-10-07
新增
- 融合设备中心 · 加快图标加载(目标
com.android.systemui):新增开关。开启后把设备发现的启动延迟改为 0,打开控制中心时立即读取缓存设备(含已连接设备)并刷新卡片,不再等待 1~2 秒的扫描延迟。入口:外观 → 组件 → 融合设备中心。 - 新增「网络」页 · 5G 开关(目标
com.android.systemui):新增功能页「网络」二级页(外观 → 组件 → 网络)。开启后在控制中心「移动网络」详情卡片中、SIM 卡信息下方(卡片内最下方)追加「5G 网络」开关,直接读写miui.telephony.TelephonyManager.isUserFiveGEnabled;仅对支持 5G 的设备显示。功能思路参考 Hyper5GSwitch(Apache-2.0,仅思路参考)。 - 设备互联 · 剪贴板同步加速(目标
com.milink.service):新增开关。把跨设备剪贴板(com.xiaomi.dist.universalclipboardservice)链路内部的短延迟(发布前 100ms 去抖、对方服务上线后 100ms 启动、会话处理数百毫秒延迟等)统一压缩为 0,让识别、发布、接收、写入各环节都更快(保留 2/3 分钟级清理与有效期定时)。入口:设备互联。 - 息屏电池保持原样式(目标
com.android.systemui):新增功能页「息屏」二级页。进入 AOD(全天候息屏)时,系统会把电池样式强制切成「电量数字在图标外」;开启本开关后息屏电池保持与当前设置(状态栏)一致的样式,同时保留系统基于 AOD 状态的息屏电池过渡动画。入口:外观 → 组件 → 息屏。 - 保持全屏息屏显示(目标
com.android.systemui):新增功能页「息屏」二级页开关。从锁屏相机 / 手电筒返回息屏时,系统会因锁屏被遮挡而错误进入「纯黑只显示时间」的息屏;开启后仍进入全屏(压暗锁屏内容)的息屏。入口:外观 → 组件 → 息屏。 - 息屏保留快捷功能图标(目标
com.android.systemui):新增功能页「息屏」二级页开关。进入息屏时系统会把锁屏左下角 / 右下角的快捷功能图标(手电筒、相机等)淡出隐藏;开启后图标在息屏界面保持显示,且解锁时不再重新淡入。入口:外观 → 组件 → 息屏。 - 识屏动画圆角适配(目标
com.miui.voiceassist):新增开关。超级小爱「识屏」打开时的「屏幕内容缩小成卡片」动画,起始圆角被写死为约 5px(观感为直角);开启后起始圆角改用屏幕自带圆角,消除动画起始时的直角。入口:浏览器 → 场景。
优化
- 融合设备中心 · 第 8 个设备出现更快更稳定(目标
com.android.systemui):隐藏省略号后补全第 8 个设备的逻辑改为在控制器 UI 线程上提交,排在官方的「截断到 7 个」任务之后执行,避免并发覆盖导致的第 8 个设备延迟出现或时而缺失。
修复
- 文件管理 · 开启顶栏渐变模糊后文件列表上边距过小(目标
com.android.fileexplorer):顶栏渐变接管并取消原生滚动遮罩后,文件管理文件夹页的路径栏底部间距被清零,导致文件列表上移、首个文件被路径栏遮挡。现保留原有间距;且仅修正带路径栏的文件夹页,主页 / 分类页等不再被多加上一段边距。 - 控制中心 · 5G 卡片未套用柔光玻璃(目标
com.android.systemui):移动网络详情里的「5G 网络」开关卡片是ToggleItem,系统对非列表项不套玻璃。现为其套用与「更多设置」按钮同款的柔光玻璃材质。
1.9.0
发布于 2026-10-06
新增
- 侧边音量条「自动平衡高度」开关(目标
com.android.systemui):新增竖屏 / 横屏两个开关(默认开启)。开启时,显示多应用音量入口会把整条侧边音量条整体上移「多出高度的一半」,保持平均高度不变;关闭后不再平移,音量条的高度 / 位置保持不变。入口:外观 → 美化 → 布局调整 → 音量条。 - 顶栏渐变模糊支持绿色守护(目标
com.miui.greenguard):为其全部界面启用顶栏渐变模糊。 - 顶栏渐变模糊支持查找设备(目标
com.xiaomi.finddevice):为其全部界面启用顶栏渐变模糊。 - 顶栏渐变模糊支持融合设备中心(目标
com.milink.service,进程:ui):设备互联的「融合设备中心」(CirculateWorldActivity)等 MIUIX 顶栏同样套用渐变模糊,随「顶栏渐变」总开关生效。 - 设备互联 · 提高设备发现频率(目标
com.milink.service):新增开关。开启后把 netbus 的跨设备发现频率(DiscoveryFrequency)提升到HIGH、广播频率(AdvertisingFrequency)提升到MEDIUM_HIGH,使设备发现与列表刷新更快;已是更高档位的不受影响。入口:设备互联。 - 新增「密码」页 · 通行密钥修复(目标
system/com.android.settings/com.miui.securitycenter/com.xiaomi.scanner):新增功能页「密码」二级页。含总开关与四个分项:系统服务路由(把 Credential Manager 路由到 Google 凭据界面与混合服务)、设置项显示(临时置国际版构建标记,使「设置」显示并允许选择 Google 凭据提供方)、阻止安全中心覆盖默认自动填充 / 凭据设置、阻止扫码劫持(MiFiDoBean不强制跳转内置 FIDO 应用)。需启用 Google 基础服务;system_server部分需重启设备生效。功能思路参考 HyperPasskey(GPL-3.0,仅思路参考,未复用其代码)。 - 新增「浏览器」页 · 阻止强制小米浏览器(目标
android框架 + 小米互传 / AI 引擎 / 超级小爱 / 设置 / 应用商店 / 内容捕手 / AI 视觉助手):新增功能页「浏览器」二级页,把被强制交给小米浏览器的网页链接改投系统默认浏览器。含总开关与分项:框架级跳转拦截(startActivity/execStartActivity等)、伪装小米浏览器已安装(避免链接被转成应用商店下载页)、PendingIntent创建时拦截、通知图标替换(互传 / 复制直达)、小米互传链接、小爱识屏 / 超级小爱、HyperAI 复制直达(气泡文案 / 图标 / 跳转)、设置内「管理小米路由器」。需授予system与android作用域。功能思路参考 Fxxk-MiBrowser(MIT,仅思路参考,未复用其代码)。
优化
- 妙享桌面增强 · 浮窗圆角改为相对圆角(目标
com.xiaomi.mirror):浮窗圆角不再固定为常量,而是以默认窗口尺寸为基准、按窗口大小等比缩放,窗口放大 / 缩小时圆角同步变化,与浮窗尺寸拖拽配合后观感保持一致;默认值由 9 调整为 40(贴近手机圆角)。 - 妙享桌面增强 · 修复圆角误改组件(目标
com.xiaomi.mirror):此前圆角会对窗口内容里几乎所有子视图逐一裁剪,导致最小化后的浮窗气泡图标、窗口中间连接提示文本 / 输入框等组件被错误改圆角。现只对全窗口遮罩层(画面遮罩 / 连接遮罩等)应用圆角;气泡图标恢复固定圆角,不再随浮窗圆角设置变化。 - 妙享桌面增强 · 浮窗拖动条与四角缩放提示(目标
com.xiaomi.mirror):浮窗四角新增弯曲的圆角圆弧提示(仅视觉、不拦截触摸),便于定位四角拖拽缩放的热区,减少误触到投屏画面;拖动条与四角圆弧随系统深浅色切换(深色黑 / 浅色白)。
修复
- 妙享桌面增强 · 修复开启自由浮窗后投屏画面「点按变长按」(目标
com.xiaomi.mirror):浮窗触摸 hook 在未开启任何浮窗手势时仍会吞掉ACTION_UP,导致画面只收到ACTION_DOWN而收不到ACTION_UP,远端据此判定为长按。现仅在确实处理浮窗手势(拖动 / 缩放 / 气泡)时消费事件,普通点按完整下发给画面。 - 设备互联页重新添加「跨设备通知流转设置」入口:在「设备互联」子页右上角新增按钮,直达系统「跨设备通知流转」设置页。该页面(
FeatureNotificationActivity)受签名级权限miui.permission.USE_INTERNAL_GENERAL_API保护,普通应用无法直接启动,故改为先打开目标应用的导出入口SettingActivity,再由 Hook 在同一进程内跳转到目标页。
1.8.0
发布于 2026-10-05
新增
- 顶栏渐变模糊支持指南针(目标
com.miui.compass):指南针自带新版 MIUIX,其ActionBarContainer的滚动遮罩同样由Paint+Path绘制、不再调用getCollapsedHeight。现将其纳入作用域,与设置 / 计算器等一样自动启用顶栏渐变模糊。 - 顶栏渐变模糊支持服务与反馈(目标
com.miui.bugreport):为其全部界面启用顶栏渐变模糊。 - 顶栏渐变模糊支持超级小爱(目标
com.miui.voiceassist):为其全部界面启用顶栏渐变模糊。 - 顶栏渐变模糊支持密码(目标
com.miui.passwords):为其页面启用顶栏渐变模糊。 - 侧边音量条竖直位置调节(目标
com.android.systemui):新增「位置调节」开关,开启后可按百分比分别设置竖屏 / 横屏下侧边音量条在屏幕上的竖直位置(竖屏默认 70%、横屏默认 50%;100% 上边缘贴屏幕顶部、0% 下边缘贴屏幕底部);关闭开关即为官方自动位置。多应用音量入口带来的额外高度仍按原有逻辑整体平移,保持平均高度不变。入口:外观 → 美化 → 布局调整 → 音量条。 - 侧边音量条二级面板位置调节(目标
com.android.systemui):新增「二级面板位置」开关,开启后可按百分比分别设置竖屏 / 横屏下展开后的二级面板整体在屏幕上的竖直位置(竖屏默认 70%、横屏默认 50%;100% 上边缘贴屏幕顶部、0% 下边缘贴屏幕底部),即整体上下移动整块二级面板。入口:外观 → 美化 → 布局调整 → 音量条(与「位置调节」同页)。
优化
- 通用顶栏遮罩特征兼容新版 MIUIX:
TopBarGradientHook的遮罩绘制方法匹配由「必须调用getCollapsedHeight」放宽为「旧版getCollapsedHeight」或「新版Path.addRect/Paint.setAlpha」二者其一,计算器专用 Hook 不再重复实现该特征。 - 多应用音量条玻璃与侧边一级音量条一致(含镜像其它模块效果 / 背景分层 / 性能):
- 镜像:多应用面板音量列先套与侧边 一级音量条相同的模块玻璃;再 hook 框架
View.setMiGlass(float[])/View.setMiGlassBlurRadius(int,int)(及MiGlassCompat.setMiGlassCompat),把其它模块(如 HyperLight 柔光玻璃)对 侧边一级音量列实际调用的玻璃方法按子视图路径 记录,在面板列创建时 按同一路径回放,使面板条与侧边一级条的亮度 / 模糊一致(回放命中则不再叠加模块自身玻璃;未命中才回退模块玻璃,防丢玻璃)。 - 背景分层:面板背景由「音量条面板自身的
background」改为 独立的兄弟层(放在音量条面板之后,与官方二级面板mExpandBgView+ 内容层 的结构一致),使音量条柔光玻璃取色时不再把面板背景纳入,与官方取色一致。 - 性能:
CcGlassHook.applySideVolume增加「状态签名未变则跳过」,仅音量值变化时不再重复遍历 / 套玻璃,消除调音量卡顿。
- 镜像:多应用面板音量列先套与侧边 一级音量条相同的模块玻璃;再 hook 框架
- 多应用音量面板仅在有设备时显示:删除「当前无正在播放的应用」占位,未检测到正在播放的应用时不再展开空面板。
- 百分比页面选项合并:三处百分比(控制中心音量条 / 控制中心亮度条 / 侧边音量条)页面把百分比相关选项(总开关、字号 / 字重 / 跟随颜色、显示位置等)合并到同一张卡片组,结构更紧凑。
- 长按打开音量面板不再依赖百分比开关:原交互逻辑挂在「侧边音量条百分比」总开关所在的 hook 上,关闭百分比后长按随之失效;现独立为单独的 hook,单独开启「长按打开音量面板」即可生效。
修复
- 「顶栏渐变」导致部分应用界面文本全部消失:
NestedHeaderMaskHook原先把 MIUIXNestedHeaderLayout的「容器之外的任意普通子 View」都当作滚动渐变遮罩,并对其类全局拦截onDraw;服务与反馈(com.miui.bugreport)的标题恰为直接子项TextView,被误判后TextView.onDraw在整个进程被置空,界面文本全部消失。现改为只精确匹配 MIUIX 的NestedHeaderOverlayMaskView(旧版为裸View)。 - 多应用音量入口图标错误显示为静音图标:Release 开启
shrinkResources后,按资源名动态加载(getIdentifier)的模块图标ic_app_volume被资源压缩器判定为未使用而删除,入口回退显示系统自带的静音图标。现通过res/raw/keep.xml保留该图标及同样按名引用的字符串。 - 侧边音量条百分比「音量条上方」显示不跟随整体平移:关闭「百分比显示在音量条内部」时,百分比显示在音量条上方(
miui_super_volume_collapsed及其背景);它们与对话框MiuiVolumeDialogView并列挂在窗口内容mVolumePanelView下,此前只平移对话框,故悬浮百分比不动(重复打开后仍错位)。现改为 平移整个窗口内容mVolumePanelView,从根上让音量条与悬浮百分比一起移动;多应用面板的对齐改用该容器的实际平移量。