Miband-OPlusBridge

Miband-OPlusBridge

把小米运动健康能用 SPP 连上的手环接到 ColorOS 设备空间 和 OPPO 健康。

在设备空间里管理这只手环,查看连接与电量,并把步数、心率、睡眠写入 OPPO 健康;手机通知和来电可以转到手环。日常不必再打开小米运动健康。小米手环 11 已实机验证。手环 8 / 8 Pro / 9 / 9 Pro / 10 / 10 Pro 及 NFC、活力版只要官方重连是 SPP 或 GATT + WearAuthV2、且没有 OOB 额外认证,即可导入接管。

包名:io.github.miam1ku.mibandoplusbridge

源码:https://github.com/MiaM1ku/Miband-OPlusBridge

点击链接加入群聊【Miband-OPlusBridge】:https://qm.qq.com/q/eEk3EsgSH0

安装

  1. 安装 LSPosed(Zygisk)。
  2. 安装本模块 APK,在 LSPosed 中启用,作用域勾选:
    • com.heytap.mydevices(设备空间)
    • com.heytap.health(OPPO 健康)
    • com.mi.health(导入绑定时需要)
  3. 在 KernelSU 里对本应用授权。
  4. 打开「小米手环桥接」:检查 Root → 导入已配对手环 → 添加到健康。导入时会记录连接参数;若首页提示「连接参数丢失」,先恢复官方管理,再在小米运动健康中重连一次手环。
  5. 强停「设备空间」和「OPPO 健康」后再打开。 旧包名 io.github.oplusband.bridge 与本包不能共存数据。换包后需重新导入。

协议测试

首页「常用」→ 协议测试:

  • 设备信息(名称、型号、固件、电量、连接;MAC 只显示末位)
  • 测试通知 / 撤回
  • 测试来电 / 结束来电
  • 检查更新(GitHub Releases)

手环需已连接。

首页「常用」→ 发送调试日志到 QQ:生成本机连接日志并交给 QQ。日志只有阶段、型号、队列和帧类型,不含 token、MAC 或 nonce。

发布

打 tag 后 GitHub Actions 会构建并创建 Release:

git tag 3-1.0.0
git push origin 3-1.0.0

LSPosed 仓库 tag 格式:{versionCode}-{versionName}。

仓库 Secrets:

  • OPLUSBAND_KEYSTORE_BASE64
  • OPLUSBAND_STORE_PASSWORD
  • OPLUSBAND_KEY_ALIAS
  • OPLUSBAND_KEY_PASSWORD

许可证

AGPL-3.0-or-later。见 LICENSE。

Releases

v1.1.2

Stable

9/27/2026, 6:02:41 PM

1.1.2

  • SPP V1(8 Pro 等)和 BLE 写入后按真实序号确认,电量刷新以及心率、血氧、压力、睡眠文件同步不再卡在列表请求。SPP V2(10 / 10 Pro / 11)本来就有传输层 ACK,不受这个问题影响。
  • 真实应用通知仍按 OPPO 健康里的总开关和应用开关转发。开关值无论是布尔还是 0/1 都会认。
  • 手机勿扰开启时不推送普通通知,并把勿扰状态同步到手环。来电不受这条限制。
  • 健康、设备空间、小米运动健康与已验证版本不一致时只提示一次,点「我知道了」后不再出现,不强制升级。

源码:https://github.com/MiaM1ku/Miband-OPlusBridge/releases/tag/14-1.1.2

Assets

1

v1.1.0

Stable

9/27/2026, 5:08:44 PM

1.1.0

  • 尝试兼容小米手环全系里官方重连是 SPP 或 GATT + WearAuthV2、且没有 OOB 的机型:8 / 8 Pro / 9 / 9 Pro / 10 / 10 Pro / 11,以及 NFC、活力版。连接时按采集到的 profile 走 SPP V2、SPP V1 或 BLE,不再只认手环 11。
  • 修复 SPP V1(手环 8 Pro,以及所有 SppTaskQueueV1)和 BLE 加密命令缺少计数、鉴权后第一条业务命令被拒绝、界面一直离线的问题。SPP V2(手环 11、10 Pro 等)不走这条路径。
  • 首页「常用」可一键生成调试日志并发送到 QQ。日志只有阶段、型号、队列和帧类型,不含 token、MAC 或 nonce。

1.0.8

  • 恢复设备空间卡片的 XML 资源和启动图标。

1.0.7

  • 修复手环 8 / 10 Pro 导入时 token 和已采集 SPP 分帧被判失败的问题。

1.0.6

  • 手环 8 Pro 可以按已采集的 SPP V1 观察结果完成导入,不再要求先读到固件版本。

1.0.5

  • 增加手环 8 / 9 / 10 的显示名,以及 SPP V1、纯 BLE(fe95)实时会话。
  • 资源打包不再强制本机 keystore。

1.0.3

  • 不再把实时会话钉死在手环 11。官方重连是安全 SPP + WearAuthV2、无 OOB 的手环都可以导入接管。

1.0.2

  • 修复 OHealth 导入绑定,并打开原生设备面板。

1.0.1

  • 睡眠或健康库服务未就绪时仍导入心率。
  • 导入时采集 SPP 连接参数,避免接管后因快照丢失而离线。

1.0.0

  • 首个公开发布。把已绑定的小米手环接到 ColorOS 设备空间和 OPPO 健康。

Assets

1

1.0.1

Stable

9/27/2026, 9:07:54 AM

心率/血氧/压力导入不再被睡眠写入或健康库服务未就绪挡住。

导入绑定同时记录 SPP 连接参数;缺快照时首页会要求采集连接参数。

Assets

1