Fxxk-MiBrowser

最新版本 / LATEST 下载量 / DOWNLOADS

提交 ISSUE / OPEN ISSUE

一个用于 HyperOS 的 LSPosed 模块,用来阻止小米系统组件强制使用小米浏览器打开网页,并将网页链接交给系统当前设置的默认浏览器。

An LSPosed module for HyperOS. It prevents Xiaomi system components from forcing web links into Xiaomi Browser and lets Android open them with the current default browser.

个人仓库 / Source Repository · Releases

主要功能 / Main Features

  1. 小米互传分享网页链接时,系统强制调用小米浏览器。
  2. 系统设置里连接小米路由器后,“管理小米路由”入口强制跳转小米浏览器。
  3. 小爱识屏 / 复制直达识别到网页链接后,点击链接仍然调用小米浏览器。

启用模块后,上述网页链接会交给系统当前设置的默认浏览器。

  1. Mi Share forces shared web links into Xiaomi Browser.
  2. The “Manage Xiaomi router” entry in Settings forces web links into Xiaomi Browser.
  3. XiaoAi screen recognition / Copy Direct opens recognized web links in Xiaomi Browser.

With the module enabled, these web links are handed to the browser currently selected as the system default.

支持范围 / Supported Versions

v1.3.0 支持 HyperOS 3 和 HyperOS 4。下表列出已经在真机上验证过的版本组合。超级小爱或小米澎湃 AI 引擎更新后,兼容性需要重新确认。

v1.3.0 supports HyperOS 3 and HyperOS 4. The matrix below lists the combinations verified on physical devices. Compatibility should be checked again after Super XiaoAi or Xiaomi HyperAI is updated.

HyperOS 设备 / Device 系统版本 / System build Android 超级小爱 / Super XiaoAi 小米澎湃 AI 引擎 / Xiaomi HyperAI
HyperOS 4 nezha OS4.0.0.21.XPACNXM 17 8.2.3.1616 4.12.16(versionCode 2030041216
HyperOS 3 ishtar OS3.0.307.0.WMACNXM 16 7.13.33.0017 3.63.1(versionCode 2030036301

效果截图 / Screenshots

HyperOS 4

HyperOS 4:小米互传链接通知显示默认浏览器图标 / Mi Share notification showing the default browser icon

HyperOS 3

HyperOS 3:小米互传链接通知显示默认浏览器图标并通过默认浏览器打开链接 / Mi Share notification showing the default browser icon and opening the link in the default browser

小米超级岛浏览器图标替换功能来自 @189521394#2 提出的建议,并参考了原项目 com.fuckXiaomi.hookBrowser 的思路,在此感谢。

License

MIT

Releases

9/3/2026, 7:58:39 PM

下载地址 | Download Link

中文

  • 修复小米澎湃 AI 引擎 4.12.16 更新后,复制直达弹窗错误显示“小米浏览器”的问题。
  • 修复复制直达打开链接时的浏览器路由,按系统默认浏览器执行跳转。
  • 完善不同系统版本下的兼容性适配。

English

  • Fixed the Copy Direct popup regression introduced after Xiaomi HyperAI 4.12.16, where Xiaomi Browser was displayed incorrectly.
  • Corrected the browser routing for Copy Direct links so that the system default browser is used.
  • Improved compatibility across supported system versions.

兼容性验证环境 / Compatibility Verification Environments

设备 / Device 系统版本 / System build Android 超级小爱 / Super XiaoAi 小米澎湃 AI 引擎 / Xiaomi HyperAI
nezha OS4.0.0.21.XPACNXM 17 8.2.3.1616 4.12.16(versionCode 2030041216
ishtar OS3.0.307.0.WMACNXM 16 7.13.33.0017 3.63.1(versionCode 2030036301

APK

  • 普通用户下载普通版 APK;Log 版仅用于运行日志记录和问题排查。
  • 下载 Log APK | Download Log APK
  • Regular users should download the standard APK. Use the Log APK only for runtime logging and issue diagnosis.

Assets

1

8/29/2026, 11:37:18 AM

Warning

本版本尚未在 HyperOS 3 上进行真机测试,可能存在兼容性问题。HyperOS 3 用户及超级小爱版本低于8.2.3.1616的用户请谨慎更新;如果遇到问题,建议回退到 v1.2.9。

This release has not been tested on HyperOS 3 and may have compatibility problems. HyperOS 3 users or users with Super XiaoAi version lower than 8.2.3.1616 should update with caution; if you encounter issues, we recommend rolling back to v1.2.9.*

下载地址 | Download Link

中文

  • 修复超级小爱更新8.2.3.1616后,识屏后点击网页链接显示“无法打开网址”的问题。
  • 本版本只保留当前超级小爱版本的精确适配,不再包含旧版 b2/f2/s2 兼容路径或旧版本门控。如果小爱识屏的浏览器修复不能正常工作,请更新超级小爱版本。
  • 已在HyperOS OS4.0.0.17.XPACNXM、Android 17、Via (mark.via)、超级小爱 8.2.3.1616的真机环境验证通过。

English

  • Fixed an issue introduced in Super XiaoAi 8.2.3.1616 where tapping a web link after screen recognition resulted in an “Unable to open URL” error.
  • This release now provides exact compatibility only for the current Super XiaoAi version. Legacy b2/f2/s2 compatibility paths and version-gating logic for older versions have been removed.If the browser fix for XiaoAi Screen Recognition does not work properly, please update Super XiaoAi to the latest version.
  • Verified on a physical device running HyperOS OS4.0.0.17.XPACNXM, Android 17, Via (mark.via), and Super XiaoAi 8.2.3.1616.

Log APK

Assets

1

8/27/2026, 9:56:47 AM

Warning

本版本仅推荐 HyperOS 4 / Android 17 开发版用户测试,尚未在 HyperOS 3 真机测试。HyperOS 3 用户请继续使用 v1.2.9;如遇异常,请降级至 v1.2.9。

This build is recommended only for HyperOS 4 / Android 17 developer builds. It has not been regression-tested on HyperOS 3. HyperOS 3 users should remain on v1.2.9 and downgrade if problems occur.

下载地址 | Download Link

中文

  • 修复 HyperOS 4 / Android 17 开发版中,小爱识屏点击网页链接时提示“未安装该应用,请先安装”的问题。
  • 修复 HyperOS 4“一步直达”复制网页链接后仍固定显示并调用小米浏览器的问题。
  • 点击动作现在交给用户设置的系统默认浏览器。
  • 气泡中的浏览器名称和图标同步显示为用户当前的默认浏览器。
  • 已在 HyperOS OS4.0.0.17.XPACNXM、Android 17、Via (mark.via)、超级小爱 8.0.30.4121 上完成真机测试

English

  • Fix the “app not installed” toast shown when opening a screen-recognition web link on HyperOS 4 / Android 17 developer builds.
  • Fix HyperOS 4 Clipboard shortcut web cards still displaying and invoking Xiaomi Browser.
  • Route the click action to the user's current system default browser.
  • Synchronize the bubble's browser label and icon with the current default browser.
  • On-device verified on HyperOS OS4.0.0.17.XPACNXM, Android 17, Super XiaoAi 8.0.30.4121 with Via (mark.via)

Log APK

Screenshot_2026-08-27-16-33-34-790_com miui notes-edit

Assets

1

v1.2.9

Stable

7/5/2026, 10:41:38 AM

下载地址 | Download Link

中文

修复: 启用模块后小米浏览器启动崩溃的问题。

感谢 @ChenXiaoming233#11 提供崩溃日志协助定位问题。

Bug 修复

  • 修复 浏览器启动崩溃 - 模块的 PackageManager hook 在浏览器进程内拦截了自身对 getPackageInfo 的调用,返回的假 PackageInfo 缺少 signatures 字段,浏览器启动时 AppSignatureUtil.getSignature() 读取到 null 数组导致 NPE 崩溃。修复: hookPackageManager 中增加自查询放行判断,当调用进程包名等于查询目标包名时跳过拦截,放行真实数据。

调试版 APK

English

Fix: Browser crash on startup when the module is enabled.

Thanks to @ChenXiaoming233 for providing crash logs in #11 that helped identify the root cause.

Bug Fixes

  • Fix browser startup crash - the PackageManager hook intercepted the browser's own getPackageInfo call and returned a fake PackageInfo without signatures, causing AppSignatureUtil.getSignature() NPE. Fix: Added a self-query guard in hookPackageManager - when the calling package matches the queried target, skip interception and let real data through.

Debug APK

Assets

1

v1.2.8

Stable

7/3/2026, 4:14:49 PM

下载地址 | Download Link

中文

v1.2.8 修复 AI Engine 复制直达(快递、地址)聚焦通知图标被错误替换的问题。

感谢 @MrJonhShelby#8 报告此问题。

  • 修复 hookClipboardNotificationIcon 无条件将所有复制直达通知(URL、地址、快递)的图标替换为浏览器图标的问题。
  • 改为通过通知 PendingIntent 的目标、通知标题/文本内容、以及图标来源综合判断,仅在通知确认是打开浏览器时才替换图标
  • 地址类复制触发地图 App、快递类复制触发物流 App 时,聚焦通知图标保持不变。
  • 已在真机(HyperOS 3.0 / Android 16)上测试:复制 URL → 替换为默认浏览器图标 ✓,复制地址 → 保持地图图标 ✓。

这一版不改默认浏览器选择策略,也不会把非网页内容强行当成链接打开。

English

v1.2.8 fixes the AI Engine clipboard notification icon being incorrectly replaced for all "Copy Direct" actions (addresses, express tracking).

Thanks to @MrJonhShelby for reporting in #8.

  • Fix hookClipboardNotificationIcon unconditionally replacing all clipboard notification icons (URLs, addresses, express) with the browser icon.
  • Now inspects the notification's PendingIntent target, title/text content, and icon source to determine whether the action actually opens a browser. Only replaces the icon when the notification is confirmed to be about opening a browser.
  • Address copies keep their map app icon; express copies keep their logistics app icon.
  • Tested on-device (HyperOS 3.0 / Android 16): URL copy → replaced with default browser icon ✓, address copy → keeps map icon ✓.

This release does not change browser selection behavior or force non-web content to open as links.

Assets

1

v1.2.7

Stable

6/26/2026, 5:06:28 PM

下载地址 | Download Link

中文

v1.2.7 修复小米应用商店内部功能跳转被错误拦截的问题。

  • 当小米应用商店(com.xiaomi.market)通过 http/https 深链接启动内部功能(如「我的」→「手机清理」)时,模块不再将其误判为浏览器跳转而拦截。
  • 只对 Case D-G(无明确目标的隐式拦截)新增了小米应用商店白名单跳过;Case A-C(明确指向小米浏览器/应用商店的显式 intent)继续正常拦截。
  • 已在 HyperOS 真机测试,应用商店内功能跳转恢复正常。

感谢 @CunningHistorySheep#6 反馈此问题。

English

v1.2.7 fixes Xiaomi App Store internal features being wrongly intercepted.

  • When the Xiaomi App Store (com.xiaomi.market) launches internal features via http/https deep links (e.g. "我的" -> "手机清理"), the module no longer misidentifies them as browser redirects and intercepts them.
  • Only added an App Store allowlist skip for Cases D-G (implicit interception without an explicit target); Cases A-C (explicit intents targeting Xiaomi Browser/Market) continue to be intercepted as before.
  • Tested on a HyperOS device — App Store internal navigation now works correctly.

Thanks to @CunningHistorySheep for reporting this in #6.

Assets

1

v1.2.6

Stable

6/16/2026, 12:02:01 PM

mishare-browser-icon-v1 2 6

中文

v1.2.6 修复小米互传接收链接时仍显示小米浏览器图标的问题。

感谢 @189521394#2 提出功能建议并提供灵感来源;本功能参考了原项目 com.fuckXiaomi.hookBrowser 的思路。

  • 当小米互传接收链接弹窗读取小米浏览器图标时,动态替换为用户当前默认浏览器的图标。
  • 同步处理小米互传相关通知里的浏览器图标,避免链接已经交给默认浏览器但界面仍显示小米浏览器。
  • 修正 NotificationManager.notify(String, int, Notification) 参数判断,避免把 tag 误当成包名。
  • 保留 v1.2.5 的设置搜索闪退修复,继续补齐假 PackageInfo.applicationInfoApplicationInfo.sourceDir
  • 已在真机上测试小米互传链接接收弹窗,图标替换正常。

这一版只替换显示图标,不改变默认浏览器选择策略,也不会把非网页文件强行当成链接打开。

English

v1.2.6 fixes Xiaomi Browser icons still appearing in Mi Share link-receive UI.

Thanks to @189521394 for suggesting this in #2 and sharing the inspiration; this feature also references the idea from the original com.fuckXiaomi.hookBrowser project.

  • Replace Xiaomi Browser icons with the user's current default browser icon when Mi Share reads the browser icon for a received link popup.
  • Also cover Mi Share browser-icon notification paths so links handed to the default browser do not still show Xiaomi Browser branding.
  • Fix the NotificationManager.notify(String, int, Notification) argument handling so the tag is not mistaken for a package name.
  • Keep the v1.2.5 Settings-search crash fix by preserving the fake PackageInfo.applicationInfo and ApplicationInfo.sourceDir fields.
  • Tested on-device with Mi Share link receive popup icon replacement.

This release only changes displayed icons. It does not change browser selection behavior or force non-web files to open as links.

Assets

2

v1.2.5

Stable

6/16/2026, 6:05:44 AM

中文

v1.2.5 修了一个会导致设置搜索闪退的问题。

感谢 @Rakau@cow-your-sister#1 报告此问题。

  • 补齐假 PackageInfo 里缺的 applicationInfo 字段。之前模块假装小米浏览器已安装时返回的对象不完整,设置搜索遍历所有包名检查系统应用身份时读到 null 直接崩了。
  • 顺便给假 ApplicationInfo 加了 sourceDir,避免其他可能读这个字段的代码再踩空。

在小米 17 Ultra 和小米 13 Ultra 上确认过,设置搜索不再闪退,路由管理跳转也正常。

English

v1.2.5 fixes a crash when searching in Settings.

Thanks to @Rakau and @cow-your-sister for reporting in #1.

  • The fake PackageInfo returned by the module was missing its applicationInfo field. When Settings' search thread iterates all packages and reads applicationInfo.flags, the null field caused a NullPointerException.
  • Added sourceDir to the fake ApplicationInfo as well, in case other code paths read it.

Confirmed on Xiaomi 17 Ultra and Xiaomi 13 Ultra. Settings search no longer crashes, and the Xiaomi router management redirect still works.

Assets

1

v1.2.4

Stable

6/14/2026, 11:01:05 AM

中文

v1.2.4 是一次代码整理版。功能没有换方向,只把已经测试正常的跳转流程收短一点。

  • 合并 startActivityInstrumentation.execStartActivity 里重复的浏览器重定向逻辑,两个入口现在走同一段处理。
  • 精简默认浏览器候选选择逻辑,仍然优先避开小米浏览器,再交给系统默认浏览器或系统选择器。
  • 简化小米浏览器 / 应用商店包名判断,行为不变。
  • 清掉几处 Kotlin 编译器提示里的多余安全调用和不必要类型转换。
  • 已在手机上测试,现有功能正常。

这一版不改 LSPosed 推荐作用域,不改默认浏览器选择策略,也不新增任何浏览器包名。

English

v1.2.4 is a cleanup release. The behavior stays the same; the redirect path is just shorter now.

  • Merge the duplicated redirect logic used by startActivity and Instrumentation.execStartActivity.
  • Trim the default-browser candidate selection while still avoiding Xiaomi Browser first, then using the system default browser or Android chooser.
  • Simplify Xiaomi Browser / app-store package checks without changing the result.
  • Remove a few unnecessary safe calls and casts flagged by the Kotlin compiler.
  • Tested on-device after the change. Existing behavior still works.

This release does not change the recommended LSPosed scope, browser selection behavior, or add any hard-coded browser package.

Assets

1

v1.2.3

Stable

6/12/2026, 11:51:05 AM

v1.2.3 添加 android:description 属性,LSPosed 管理器现在可以显示模块描述。
v1.2.3 adds android:description attribute so LSPosed Manager can display the module description.

Assets

1

v1.2.2

Stable

6/12/2026, 2:49:09 AM

中文

v1.2.2 主要是把默认作用域收回来一点,同时保留已经验证过的三条链路。

  • 推荐作用域从 13 个缩到 9 个,去掉 com.xiaomi.mirrorcom.miui.videocom.miui.securitycentercom.android.systemui
  • 保留小米互传、小爱识屏 / 超级小爱、AI Engine、contentcatcher、AI 视觉助手,以及设置里的“小米路由管理”入口所需作用域。
  • 移除一个只用于记录日志的 PackageManager.resolveActivity hook。它不改结果,release 版里继续挂着意义不大。
  • 回归测试小爱识屏、小米互传 URL、设置里的“管理小米路由”,三项都能继续交给系统默认浏览器。

这一版没有改变默认浏览器选择逻辑,也没有硬编码任何浏览器包名。

English

v1.2.2 trims the default LSPosed scope without dropping the paths that were tested on-device.

  • Reduce the recommended scope from 13 packages to 9 by removing com.xiaomi.mirror, com.miui.video, com.miui.securitycenter, and com.android.systemui.
  • Keep the scopes needed by Mi Share, XiaoAi / Super XiaoAi screen recognition, AI Engine, contentcatcher, AI vision, and the Settings entry for Xiaomi router management.
  • Remove the PackageManager.resolveActivity hook that only logged resolver results. It did not change behavior, so it should not stay in the release build.
  • Retested XiaoAi screen recognition, Mi Share URL handling, and Settings' "Manage Xiaomi router" entry. All three still hand links to the system default browser.

This release does not change browser selection and still does not hard-code a browser package.

Assets

1