把小米运动健康能用 SPP 连上的手环接到 ColorOS 设备空间 和 OPPO 健康。
在设备空间里管理这只手环，查看连接与电量，并把步数、心率、睡眠写入 OPPO 健康；手机通知和来电可以转到手环，当前播放走 OPPO 健康自己的音乐控制。首页可打开「入睡后暂停音乐」：手环报入睡后暂停手机播放，醒来不自动续播。不回报实时入睡的手环，等睡眠记录同步后再暂停。手环查找手机会走 OPPO 健康自己的响铃，健康设备页也可以让这只手环响。健康首页若在导入完成前就打开，导入结束后会再读一次，不用先点「我的」。日常不必再打开小米运动健康。小米手环 11 已实机验证。手环 8 / 8 Pro / 9 / 9 Pro / 10 / 10 Pro 及 NFC、活力版只要官方重连是 SPP 或 GATT + WearAuthV2、且没有 OOB 额外认证，即可导入接管。SPP V2、SPP V1（8 Pro）和纯 BLE（fe95）在连接时按采集 profile 分支。纯 BLE 用已导入的密钥重连，系统蓝牙配对掉了也能连；SPP 仍要求系统配对还在。
接管期间连接留在前台服务里重连。健康还在、服务被系统杀掉时，健康读卡片或转发通知会把服务拉起来。控制中心可以添加「手环」，下拉或点一下会拉起连接，不会断开。后台限制拦住时用 root 启动。服务这边把健康进程绑回来，绑不上再用 root 拉健康。会话还没就绪的通知先留着，连上后续发；普通通知最多留 60 秒，来电 15 秒。健康不会把桥接界面从后台拉起来。通知只留一条折叠的「手环已连接」，同步文件时不再改它。
包名：io.github.miam1ku.mibandoplusbridge
点击链接加入群聊【Miband-OPlusBridge】：https://qm.qq.com/q/eEk3EsgSH0
- 安装支持 libxposed API 102 的框架（Zygisk），例如 Vector。1.6.8 之后的版本是 API 102 现代模块，只支持旧版 Xposed API（≤ 100）的 LSPosed 不会加载它。
- 安装本模块 APK，在 LSPosed 中启用，作用域勾选：
com.heytap.mydevices（设备空间）com.heytap.health（OPPO 健康）com.mi.health（导入绑定时需要）com.coloros.alarmclock（时钟）
- 在 KernelSU 里对本应用授权。拿到 root 后，本应用会在 ColorOS 里给自己和 OPPO 健康打开「自启动」和「关联启动」。没有这两项，更新模块后 OPPO 健康拉不起桥接，要手动打开一次本应用。
- 打开「小米手环桥接」：检查 Root → 导入已配对手环 → 添加到健康。导入时会记录连接参数；若首页提示「连接参数丢失」，先恢复官方管理，再在小米运动健康中重连一次手环。
- 第一次安装，或从 1.6.8 及以前的版本升级时，强停「设备空间」和「OPPO 健康」后再打开。之后的更新会热重载，不用再强停。
旧包名
io.github.oplusband.bridge与本包不能共存数据。换包后需重新导入。
模块在 META-INF/xposed/module.prop 里声明 autoHotReload=true。宿主进程在运行时安装新版 APK，框架会在宿主里换成新代码，不重启宿主：旧代码先停掉自己的线程、广播接收器和内容观察者，新代码移除旧 hook 并重新装上。已经打开的页面要刷新一次才显示新代码画的内容。
- 只有 versionCode 变了才会触发。开发时用
python3 tools/build.py :app:assembleDebug -PhotReloadVersionCode=<更大的数>，再adb install -r。之后要装回正常版本号，用adb install -r -d。 - 被系统冻结的后台进程收不到热重载，下次启动时直接加载新版本。
- 1.6.8 及以前是旧版 API 模块，从它们升级的那一次不能热重载。
首页「常用」→ 协议测试：
- 设备信息（名称、型号、固件、电量、连接；MAC 只显示末位）
- 测试通知 / 撤回
- 测试来电 / 结束来电
- 同步免打扰（同步开关 + 当前状态）
- 测试闹钟响铃 / 关闭 / 稍后响
- 测试查找手机 / 停止查找（OPPO 健康自己的响铃）
- 发送测试音乐
- 检查更新（GitHub Releases）
手环需已连接。
首页「常用」→ 发送调试日志到 QQ：生成本机连接日志并交给 QQ。日志只有阶段、型号、队列和帧类型，不含 token、MAC 或 nonce。
打 tag 后 GitHub Actions 会构建，并把同一个 app-release.apk 发到两个仓库：
git tag 32-1.2.9
git push origin 32-1.2.9
- 源仓库：https://github.com/MiaM1ku/Miband-OPlusBridge
- LSPosed 仓库：https://github.com/Xposed-Modules-Repo/io.github.miam1ku.mibandoplusbridge
tag 格式：{versionCode}-{versionName}。workflow_dispatch 只更新源仓库，不镜像。
仓库 Secrets：
OPLUSBAND_KEYSTORE_BASE64OPLUSBAND_STORE_PASSWORDOPLUSBAND_KEY_ALIASOPLUSBAND_KEY_PASSWORDXPOSED_REPO_PAT：对Xposed-Modules-Repo/io.github.miam1ku.mibandoplusbridge有 Contents 写权限的 PAT。GITHUB_TOKEN不能推另一个仓库。缺这个 secret 时，tag 发布会在源 Release 之后失败。
协议对照用了这些项目：
- AstroBox-NG（AstralSightStudios）
- Gadgetbridge
AGPL-3.0-or-later。见 LICENSE。