这是一个针对国行小米手机的实验性 LSPosed 模块，用来恢复 Google Play 服务中的 Fast Pair / Find Hub（查找中心）配对、云端位置更新和网页指令，并修正 Find Hub 在中国大陆显示 Xiaomi Tag 时的地图坐标偏移。

本项目已经在以下环境中完整跑通：手机发现 Xiaomi Tag、弹出配对页面、完成连接、网页位置持续更新，以及网页端让 Tag 响铃。

• 手机：Redmi K80 Pro（24122RKC7C）
• 系统：国行 HyperOS OS2.0.15.0.VOMCNXM，Android 15
• Google Play 服务：26.26.34 (260400-945364269)、26.36.35 (260400-991383798)
• 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 中启用并重启。

打开桌面的“Xiaomi Tag · Find Hub 修复”，可查看当前 GMS 完整版本、 版本代码和是否已有适配。Android 13 及以上请点击“开启未知版本通知” 并允许通知；以后 GMS 更新为未知构建时，每个构建只提醒一次。

模块按实际加载 APK 的完整版本名及版本代码选择映射。当前白名单为 26.26.34 (260400-945364269) / 262634035、 26.36.35 (260400-991383798) / 263635035、 26.37.37 (260400-994713346) / 263737035 和 26.40.32 (260400-995630914) / 264032035。未知构建会停止安装 GMS 配对、自定位和云端设置等混淆 Hook，避免误 Hook；Find Hub 地图 修正独立运行，但其自身仍有应用版本兼容范围。你实测已配对的 Tag 在 GMS 未列入适配时仍可从网页响铃；这个状态页只显示模块是否认识该构建， 不代表已配对 Tag 的网页响铃会随之失效。提示“已有适配”表示版本 在白名单内，并不代替 LSPosed 启用状态或实际运行验证。

国行环境中的 Google Play 服务会通过内部 Phenotype 配置关闭 Find Hub 的关键路径。本模块只在相关调用点打开以下开关：

GMS 26.36.35 的对应入口依次为 jsmh.e()、jvlk.N()、 jsmh.h()、jsmh.i() 和 cido.a()；国际版 Tag 资格处理器为 dzkw.e(dzhx)。模块自动选择已适配的映射。

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

部分国行环境在配对时可以向网页写入一次正确位置，但之后只更新手机 Find Hub 应用中的本地位置，网页端时间和位置不再变化。实机确认这种 情况下 Tag、Owner Key、sighting 生成和网络请求均正常，缺失的是账号侧 Find Hub 网络设置。

模块启动后会通过 Google Play 服务自带的 Spot.API 读取真实账号状态。 只有当 Find My Device / Find Hub 网络尚未完整开启时，才提交与 Google 设置页相同的“所有位置”（networkMode=2）请求；已经开启时只读取， 不会重复改写。模块不强制缩短 Google 原生上传周期，也不伪造位置或修改 上传数据。

主 GMS 进程启动时还会通过 Google 自带的 DeviceSyncService 刷新一次 当前账号拥有的设备/EID 缓存，供网页端签名响铃指令查找 Tag 使用。网页 响铃仍依赖 Tag 当时处于可被 BLE 扫描的广播窗口；偶发约 20 秒超时后 再次尝试即可，本模块不延长 Google 下发的扫描时限。

该操作会为当前 Google 账号开启 Find Hub 网络和最后位置保存。安装即 表示同意这一行为；若不希望使用云端位置网络，请停用模块后在 Google 系统设置中关闭相应功能。

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

• 仅对 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
• account Find Hub settings ready=true networkMode=2
• 被 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、26.36.35、26.37.37 和 26.40.32 的指定构建。其他版本更新混淆名称后仍可能需要重新适配；布尔门控会校验方法签名，各项 Hook 独立捕获异常。
• 地图修正已适配 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 相机和中国大陆以外的坐标保持原有行为。

v0.9.7 修复配对后只有首次位置写入网页、后续网页位置不再更新的问题： 通过 GMS 自带的 Spot.API 条件式同步账号侧 Find Hub 网络设置。同时 恢复网页端签名响铃指令所需的 GCM / SPOT 门控，并在主 GMS 进程启动时 通过 Google 自带服务刷新一次拥有设备缓存；不再包含测试阶段使用的强制 快速上传、Owner 响应或位置流水线诊断 Hook。

v0.9.8 适配 Google Play 服务 26.36.35，更新 Fast Pair、国际版 Tag 资格处理器、网页指令门控、账号设置接口与拥有设备缓存同步映射，并保留 26.26.34 兼容。布尔门控仅 Hook 精确的无参数静态 boolean 方法，各项 修复独立捕获异常，避免单个过期混淆入口中断后续配对修复。已在实机验证 新国际版 Xiaomi Tag 配对弹窗恢复并完成配对。

v0.9.9 增加完整 GMS 构建识别、未知构建保护、兼容状态页面和按构建 去重的通知提醒。未知版本不再自动套用旧混淆映射。

v0.9.10 增加 Google Play 服务 26.37.37 (260400-994713346) / 263737035 的精确映射，并保留两个旧构建支持。新版入口为 jtzg.f()（配件）、jwys.N()（SPOT 集成）、jtzg.i()（自定位）、 jtzg.j()（网页指令）、ciza.a()（Finder）、ealy.e(eaiz)（Tag 资格） 以及 chpu / chpr / chps（账号设置）。地图算法未变。 已配对 Tag 的网页响铃实测不受模块是否适配当前 GMS 构建影响。

v0.9.11 修正兼容状态页面：显示模块自身版本、当前 GMS 完整构建、 所有支持构建及版本代码。列表直接从实际适配表生成，避免文案与白名单 不同步；页面支持滚动，并明确“已有映射”不等于模块已启用或功能全部 验证。本次未改变 GMS Hook 或地图算法。

v0.9.12 增加 26.40.32 (260400-995630914) / 264032035 的精确适配， 保留三个旧构建和未知版本保护。反编译确认入口为 jyfd.f()（配件）、 jyfd.i()（自定位）、jyfd.j()（网页指令）、ckjj.a()（Finder）、 kbfk.O()（SPOT 集成）、ecvv.e(ecsn)（Tag 资格）以及 cjac / cizz / cjaa（账号设置）。地图算法未变。