这是一个针对国行小米手机的实验性 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) - Tag：国际版 Xiaomi Tag，Fast Pair model ID
15D23E - Root + LSPosed
其他手机、系统版本、Google Play 服务版本或 Tag 型号不保证可用。
Important
当前版本只适用于国际版 Xiaomi Tag（Fast Pair model ID 15D23E）。
不适用于国行版 Xiaomi Tag，请勿在国行版 Tag 上使用。
从 Xposed Modules Repo Releases 下载正式 APK。项目开发与固定签名构建源位于 leowood2000/xiaomi-tag-find-hub-lsposed。 然后：
- 安装 APK。
- 在 LSPosed 中启用本模块。
- 在 LSPosed 中勾选以下作用域：
- Google Play 服务（
com.google.android.gms），用于 Fast Pair / Find Hub 配对修复。 - Find Hub（
com.google.android.apps.adm），用于地图坐标修正。
- Google Play 服务（
- 重启手机。
- 让 Tag 重新进入配对模式；确认听到两声后，将它靠近手机。
- 按照 Google Fast Pair / Find Hub 页面完成连接。
如果升级 APK 时提示签名不一致，请先卸载旧版模块再安装新版，然后重新在 LSPosed 中启用并重启。
国行环境中的 Google Play 服务会通过内部 Phenotype 配置关闭 Find Hub 的关键路径。本模块只在相关调用点打开以下开关：
| GMS 内部开关 | 本版本对应方法 | 关闭时的表现 |
|---|---|---|
EnableFindMyDeviceModule__enable_fast_pair_accessories |
jwbd.g() |
SpotFastPair.API 返回 API_UNAVAILABLE / status 17，无法连接 Find Hub 服务 |
enable_fast_pair_spot_integration |
jyxk.K() |
扫描阶段返回 DEVICE_NOT_SUPPORTED，或定位 Tag 的最终连接页面失败 |
EnableFindMyDeviceModule__enable_self_location_reporting |
jwbd.j() |
开启“储存最新的位置信息”时失败，并出现 Self location reporting is disabled |
EnableFindMyDeviceModule__enable_spot_client_actions_handler |
jwbd.k() |
网页端签名指令到达手机后不进入 SPOT 指令处理器 |
| Finder use-case 总门控 | ccnl.a() |
网页端响铃指令在 GCM 接收阶段被丢弃 |
这些是 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 服务在配对过程中禁用以下组件：
HalfSheetActivityFastPairSliceProviderDiscoveryServiceDevicesListActivity
- 仅保留必要的状态日志，并自动隐藏扫描到的蓝牙 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_accessoriesenable_fast_pair_spot_integrationenable_self_location_reportingbypass drhl#e DEVICE_NOT_SUPPORTED -> SUCCESSaccount 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 定位、网络请求或云端保存的数据。
坐标处理同时考虑位置：
| 位置 / 图层 | 默认矢量图 | 地形图 | 卫星 / 混合卫星图 |
|---|---|---|---|
| 中国大陆 | 完整 WGS-84 → GCJ-02 非线性转换 | 完整 WGS-84 → GCJ-02 非线性转换 | 完整 WGS-84 → GCJ-02 非线性转换 |
| 中国大陆以外 | 保持 WGS-84 | 保持 WGS-84 | 保持 WGS-84 |
中国大陆判断使用边界多边形而不是简单经纬度矩形，并显式排除香港、 澳门和台湾。已回归东京、首尔、河内、曼谷、新加坡、伦敦、纽约和 悉尼等境外坐标，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 相机和中国大陆以外的坐标保持原有行为。
v0.9.7 修复配对后只有首次位置写入网页、后续网页位置不再更新的问题：
通过 GMS 自带的 Spot.API 条件式同步账号侧 Find Hub 网络设置。同时
恢复网页端签名响铃指令所需的 GCM / SPOT 门控，并在主 GMS 进程启动时
通过 Google 自带服务刷新一次拥有设备缓存；不再包含测试阶段使用的强制
快速上传、Owner 响应或位置流水线诊断 Hook。