IKEA Dirigera 智能家居控制
核心用法
本技能提供完整的 IKEA 智能家居设备控制能力,基于官方 Dirigera Hub 实现。核心功能覆盖五大设备类型:
- 灯光控制:开关、亮度调节(0-100%)、色温调节(2200-4000K)、颜色设置
- 插座控制:远程开关、状态监控
- 场景触发:一键激活预设场景(如"睡眠模式")
- 控制器管理:智能开关、传感器等配件状态查询
- 电池监控:无线设备电量追踪
显著优点
1. 原生协议支持:基于 IKEA 官方逆向工程 API,非云端中转,延迟低、可靠性高
2. 完整设备覆盖:支持 TRÅDFRI 全系列及 STARKVIND、VALLHORN 等新品
3. 局域网优先:通过 IP 直连 Hub,无需互联网即可控制
4. 状态同步机制:提供 reload() 方法确保设备状态实时更新
5. 能力检测:capabilities.can_receive 预检查避免无效操作
潜在局限
| 限制项 | 说明 |
|--------|------|
| **物理认证门槛** | Token 生成必须用户按压 Hub 底部按钮,无法纯自动化 |
| **网络拓扑要求** | 控制端需与 Hub 同局域网,VPS 场景需 Cloudflare Tunnel |
| **无云端回调** | 设备状态变更无主动推送,需轮询刷新 |
| **功能边界** | 不支持 Hub 固件升级、网络配置等管理功能 |
| **生态封闭** | 仅兼容 IKEA 自家设备,不接入 Matter/Zigbee 第三方 |
适合人群
- 已部署 Dirigera Hub 的 IKEA 智能家居用户
- 需要批量/自动化控制灯光、插座的技术用户
- 希望绕过 IKEA Home app、构建自定义自动化工作流的高级用户
- 在 VPS/远程服务器上通过 Tunnel 管理家庭设备的场景
常规风险
1. Token 泄露风险:长期有效的认证令牌若被截获,可导致设备被未授权控制
2. 网络暴露风险:Cloudflare Tunnel 配置不当可能将家庭 Hub 暴露于公网
3. 操作冲突:自动化脚本与 Home app 同时操作可能导致状态竞争
4. Hub 过载:高频 API 调用可能触发 Hub 自我保护机制
建议:Token 文件设置 600 权限,Tunnel 配置零信任访问策略,关键操作前执行 is_reachable 检查。