小米MIUI强制覆盖状态栏文字颜色，需在AndroidManifest.xml中配置android:windowLightStatusBar="true"并调用plus.navigator.setStatusBarStyle，JS层设置无效。
小米手机状态栏文字颜色被系统强制覆盖
小米 MIUI 系统（尤其是 12/13/14）默认开启“深色模式跟随系统”且会忽略 JS 设置的状态栏文字样式。即使你调用 uni.setNavigationBarColor({ style: 'black' })，文字仍可能显示为白色（在浅色背景上不可见）或完全不响应。
这不是 uni-app 的 bug，而是 MIUI 对原生 Activity 的 StatusBarStyle 做了硬性劫持。关键点在于：它只认 AndroidManifest.xml 或运行时原生层的显式声明，JS 层设置只是“建议”，MIUI 选择无视。
- 必须在
manifest.json → app-plus → android → permissions中确认未误加"android.permission.WRITE_SETTINGS"（该权限仅调试用，上线后反而干扰） - 真正起效的是在
unpackage/res/android/AndroidManifest.xml的 Application 或对应 Activity 节点中添加：android:theme="@style/AppTheme.NoActionBar"，并确保该 style 定义了android:windowLightStatusBar="true" - 若使用自定义基座，需检查
build.gradle是否启用了android.enableJetifier=true，否则部分 MIUI 原生 API 调用会失败
调用 uni.setNavigationBarColor 在小米上静默失效
常见现象是 success 回调不触发、控制台无报错、状态栏颜色卡在上一页或系统默认值。根本原因是：小米部分机型（如 Redmi Note 12 系列、Xiaomi 14）要求 backgroundColor 和 frontColor 必须同时传，且 frontColor 值必须是 '#000000' 或 '#ffffff'（不能是变量或计算值），否则直接跳过渲染。
- 写死十六进制值：
frontColor: '#000000'，别用data绑定或 computed - 确保调用时机在
onReady之后，onLoad太早，plus 对象可能未初始化完成 - 避免在 tabbar 页面（如首页）中调用——小米对 tabBar 页面的导航栏控制权收得更紧，优先走 pages.json 静态配置
自定义导航栏下小米状态栏仍为白底黑字
当你设了 "navigationStyle": "custom"，uni-app 就不再接管状态栏，但小米不会自动把顶部透明区域染成你页面的背景色。结果就是：你画了一个深色 header，上面却浮着系统默认的白底黑字状态栏，视觉割裂。
小米/米家智能家居设备控制。通过MCP Server工具控制家中设备，包括灯、空气净化器、电暖气、空调、风扇、扫地机器人、窗帘等。触发场景：用户提到智能家居控制指令，如"把灯关掉"、"开空调"、"净化器调到睡眠模式"、"客厅太暗了"、"家里空气不好"等。即使未明确提及"小米"或"米家"，只要涉及家居设备控制即可触发。
解决方案不是改 JS，而是靠 CSS + 原生适配双管齐下：
- 在页面
<view>顶部插入一个固定定位 view，高度用uni.getSystemInfoSync().statusBarHeight动态获取 - CSS 中必须写
position: fixed; top: 0; width: 100%; z-index: 999;，不能用 relative 或 sticky - 额外加一行条件编译：
// #ifdef APP-PLUS，并在其中调用plus.navigator.setStatusBarBackground('#1e40af')—— 这个 API 在小米上比setNavigationBarColor更底层、更可靠
动态主题切换时小米状态栏颜色不同步
用户从浅色切到深色模式，导航栏变黑了，但状态栏文字还是白色，或者反过来。这是因为小米监听的是系统广播，而 uni-app 的 JS 主题切换没触发原生层的同步回调。
绕过它的唯一办法是主动重置原生状态栏样式：
- 监听系统主题变化（
uni.onThemeChange），但注意：小米部分机型该事件不触发，得 fallback 到定时轮询uni.getSystemInfo的theme字段 - 每次切换后，延迟 150ms 再执行：
plus.navigator.setStatusBarStyle('dark')或'light' - 不要依赖
navigationBarTextStyle动态更新——它在自定义导航栏下完全无效，在小米默认导航栏下又常被忽略
最麻烦的其实是冷启动场景：用户从桌面点击图标进入，此时 MIUI 已按上次缓存的主题渲染了状态栏，JS 层还没跑起来。这种情况下，只能接受首帧不一致，别试图用 splash 屏障遮盖——MIUI 会强制显示自己的启动图。
