这是一个针对国行小米手机的实验性 LSPosed 模块，用来恢复 Google Play 服务中的 Fast Pair / Find Hub（查找中心）配对流程，并诊断 Find Hub 在中国大陆显示 Xiaomi Tag 时的地图坐标偏移。

本项目已经在以下环境中完整跑通：手机发现 Xiaomi Tag、弹出配对页面、完成连接，并成功打开“储存最新的位置信息”。

• 手机：Redmi K80 Pro（24122RKC7C）
• 系统：国行 HyperOS OS2.0.15.0.VOMCNXM，Android 15
• Google Play 服务：26.26.34 (260400-945364269)
• Tag：国际版 Xiaomi Tag，Fast Pair model ID 15D23E
• Root + LSPosed

其他手机、系统版本、Google Play 服务版本或 Tag 型号不保证可用。

从 Xposed Modules Repo Releases 下载正式 APK。项目开发与固定签名构建源位于 leowood2000/xiaomi-tag-find-hub-lsposed。 然后：

1. 安装 APK。
2. 在 LSPosed 中启用本模块。
3. 在 LSPosed 中勾选以下作用域：
   • Google Play 服务（com.google.android.gms），用于 Fast Pair / Find Hub 配对修复。
   • Find Hub（com.google.android.apps.adm），用于地图坐标诊断。
4. 重启手机。
5. 让 Tag 重新进入配对模式；确认听到两声后，将它靠近手机。
6. 按照 Google Fast Pair / Find Hub 页面完成连接。

如果升级 APK 时提示签名不一致，请先卸载旧版模块再安装新版，然后重新在 LSPosed 中启用并重启。

国行环境中的 Google Play 服务会通过内部 Phenotype 配置关闭 Find Hub 的关键路径。本模块把以下三个开关强制设为开启：

这些是 Google Play 服务内部的服务端/Phenotype 开关，不是 Android 的普通系统属性，因此用 adb shell setprop 修改手机型号或 fingerprint 并不能直接打开它们。

除了打开上面的三个开关，模块还会：

• 仅对 Fast Pair model ID 15D23E，把定位 Tag 处理器 drhl.e(dreq) 返回的 DEVICE_NOT_SUPPORTED 改为 SUCCESS。
• 阻止 Google Play 服务在配对过程中禁用以下组件：
  • HalfSheetActivity
  • FastPairSliceProvider
  • DiscoveryService
  • DevicesListActivity
• 保留诊断日志，并自动隐藏扫描到的蓝牙 MAC 地址。

InitialPairingDeviceChecker 并不是本次 DEVICE_NOT_SUPPORTED 的根源。在已验证的 GMS 版本里，它负责扫描已经通过初步资格判断后的缓存设备/地址检查；真正需要处理的是 locator-tag 路径和上述三个内部开关。

Windows PowerShell：

adb logcat -c
adb logcat -v time | Select-String GmsFastPairDiag

也可以使用：

adb logcat -s LSPosedFramework | findstr GmsFastPairDiag

日志中的关键内容包括：

• enable_fast_pair_accessories
• enable_fast_pair_spot_integration
• enable_self_location_reporting
• bypass drhl#e DEVICE_NOT_SUPPORTED -> SUCCESS
• 被 GMS 禁用但由模块保留的 Fast Pair 组件

地图修正日志使用独立标签：

adb logcat -c
adb shell am force-stop com.google.android.apps.adm
adb shell monkey -p com.google.android.apps.adm 1
adb logcat -v time | Select-String FindHubMapFix

当前版本在 Find Hub 的地图 UI 边界对 Marker、相机聚焦和蓝色本机 位置层使用一致的坐标。该 Hook 不修改底层 Android Location 对象、 GMS 定位、网络请求或云端保存的数据。

坐标处理同时考虑位置：

中国大陆判断使用边界多边形而不是简单经纬度矩形，并显式排除香港、 澳门和台湾。已回归东京、首尔、河内、曼谷、新加坡、伦敦、纽约和 悉尼等境外坐标，Marker 与蓝色本机位置层均不会触发转换。因此正常 出国使用不会被本模块附加坐标偏移；人在国外查看留在中国大陆的设备 时，只转换位于大陆的设备坐标，境外本机位置和境外设备坐标保持 WGS-84。默认、地形、卫星和混合卫星图层均遵守同一地区边界保护。

需要 JDK 17、Android SDK，以及 Gradle 8.9：

gradle :app:assembleDebug

GitHub Actions 也会构建 APK，并将其作为 workflow artifact 上传。

• 本模块依赖 Google Play 服务 26.26.34 中的混淆类名和方法名。GMS 更新后这些名称可能变化，模块可能失效。
• 地图修正已适配 Find Hub 3.1.636-1（hfo#aN）和 3.1.664-3（hwi#aM）；Find Hub 后续更新混淆名称时仍需重新确认调用点。
• 大陆边界为简化多边形；紧邻陆地国境线的少量坐标理论上可能被误判，普通境外城市和常规旅行地点不受影响。
• 目前只支持国际版 Xiaomi Tag（model ID 15D23E），不适用于国行版 Xiaomi Tag；其他 tracker 也不在支持范围内。
• 开启 self-location reporting 后，Find Hub 会按照 Google 的产品机制保存或上报设备的最后位置。请只在理解该功能并接受其隐私影响时使用。
• Root、LSPosed、修改 Google Play 服务行为均有风险。本项目仅用于研究与个人测试，不保证适用于所有设备，也不保证通过任何完整性检查。

v0.7.0 是首个完成全流程验证的版本，包含三个 Find Hub 开关、定位 Tag 资格修复以及 Fast Pair 组件保护。

v0.8.0 增加 Find Hub 应用作用域和只读地图坐标诊断，为后续仅针对中国大陆 Tag 标点的 WGS-84 → GCJ-02 修正定位调用点。

v0.9.0 将已确认的标签 Marker/相机 UI 管线接入完整 WGS-84 → GCJ-02 算法，并增加境外保护和重复转换保护。

v0.9.1 同步修正 Find Hub 地图内置的蓝色“本机位置”层，并用中国大陆边界多边形替代会误伤邻国的粗矩形判断。

v0.9.2 增加地图类型感知：默认/地形矢量图使用 GCJ-02， 卫星/混合卫星图恢复并使用 WGS-84，切换图层时不会累计转换。

v0.9.3 将仓库、LSPosed 模块和 APK 统一命名为 Xiaomi Tag · Find Hub 修复。内部包名仍保留 com.leowood.gmsfastpairdiagnostics，确保旧版本可以直接覆盖升级， 无需重新配置 LSPosed 作用域。

v0.9.4 适配 Find Hub 3.1.664-3 的设备 Marker 和相机聚焦调用点， 并根据实机卫星底图验证，在中国大陆对所有地图图层统一使用 GCJ-02， 同时保留旧版兼容。

v0.9.5 修复点击地图准星归中设备时，镜头仍使用原始 WGS-84 坐标而 与已经修正的设备标记点错位的问题。归中修正只匹配当前已经识别到的设备 坐标，不改变用户手动拖动后的任意地图中心。

v0.9.6 修复“分享对象”页面的本机位置准星：蓝点首次归中以及后续 GPS 自动跟随更新均使用一致的坐标，不会在点击后再次被原始坐标拉偏。 持续更新修正仅在 Find Hub 明确处于 USER_LOCATION 自动跟随状态时 启用；手动拖图、设备/Tag 相机和中国大陆以外的坐标保持原有行为。