项目背景

在智能家居场景中，米家的生态还是最好的，设备相当性价比比较高。然而，很多米家设备是不支持接入homekit的，需要一个桥接层来实现互联互通。

作者作为苹果全家桶用户，家中大部分设备却来自米家生态，在实际使用中遇到了以下痛点：

• 米家 App 在 iOS 上启动缓慢，远不如通过控制中心直接使用 HomeKit 来得便捷；
• 小爱同学（小爱音箱 Play）语音体验不佳，误触率高、收音识别能力弱，与 HomePod 相比差距明显；
• 米家生态封闭，无法直接接入其他平台设备，导致跨品牌设备无法联动；而 HomeKit 支持接入第三方配件，具备更好的开放性。

为什么不用 Home Assistant 或 Home Bridge？

现有方案如 Home Assistant 或 Home Bridge 虽然功能强大，但在实际使用中存在以下问题：

• 稳定性不足：偶尔出现设备无响应，甚至需要重新配置；
• 集成度过于冗余：插件往往自动映射出大量无需控制的设备，增加管理复杂度。
• 兼容性不够 比如ha映射的窗帘设备，由于可能没有事件通知机制，导致窗帘操作时一直卡死。
• 自由度不够 比如空气净化器无法全功能接入，空调映射成了恒温器。

Olink 的设计思路

首先通过识别米家设备spec转成olink的标准设备模型再转换成homekit配件。 Olink 采用 配置化方式，通过编写 TOML 文件完成米家设备到 HomeKit 设备的精准映射。用户可以自由编辑配置文件，按需定义每个设备的服务与特性，实现：

• 灵活可控：只映射需要控制的设备，避免冗余；
• 稳定可靠：轻量级架构，减少故障点；
• 原生体验：通过 HomeKit 接入，享受控制中心与 Siri 的流畅交互。

Olink 致力于提供一种简单、稳定、低延时的智能家居桥接方案，让跨生态设备真正协同工作。

目前功能

网关支持

• 米家中枢网关：通过局域网协议稳定接入，低延迟控制
• 米家云端网关：完整支持，适用于无中枢网关场景（如仅使用小爱音箱、多模网关等设备作为网关的情况）
• 两种方式可同时启用，中枢优先，云端自动兜底，保障设备稳定在线

设备支持

Olink 已适配并测试了以下设备类型：

类别	设备类型	说明
🏠 照明	灯光（灯泡/吸顶灯/灯带等）	调光、调色温、调色
🪟 遮阳	窗帘、卷帘、晾衣架	开合控制
🌀 空气	空调、空气净化器、风扇、除湿机、取暖器	模式、温度、风速等全功能
💧 环境	加湿器、浴霸、电热毯	湿度控制、暖风、温度调节
🔌 电源	插座、开关	通断控制
📺 影音	电视	开关、音量、输入源
📡 传感	温湿度传感器、门窗磁传感器	实时数据上报
🌐 网关	米家网关（多模/中枢）	网关状态、子设备管理

以上列表中未列出的米家设备，大部分仍可通过编写映射配置文件进行适配接入。受限于米家协议升级及各设备固件差异，部分设备可能存在兼容性问题。如遇到无法正常接入的设备，欢迎加入讨论群反馈，我们会协助适配。

集成与扩展

• 小智 AI 接入：支持与小智 AI 语音助手对接，开发中
• Matter 接出：将接入的设备映射成 Matter 配件（规划中）
• MQTT 接入：提供 MQTT 接口，开发人员可通过 MQTT 协议接入自有设备或复用 Z2M、HA 生态（规划中）

适配与交流

如果你发现某款设备无法正常工作，欢迎通过以下方式反馈：

• 加入 Q 群 1094847550 讨论适配方案
• 提供设备型号与 MIoT spec 信息，我们会尽快完善映射文件