通过 Python SDK 远程控制 IKEA Dirigera 智能家居中枢，支持灯光、插座、场景自动化及设备状态监控，需物理按键完成令牌授权。
说明：
## 核心功能
`dirigera-control` 是基于 IKEA 官方未公开 API 的 Python 封装技能，允许用户通过代码或自动化脚本控制全屋智能设备。核心能力包括：
– **设备发现与控制**：灯光开关/亮度/色温调节、插座通断、场景一键触发
– **状态监控**：设备可达性检测、电池电量查询、实时状态重载
– **批量操作**：支持按房间分组控制、多设备批量执行
– **网络诊断**：内置 IP 扫描脚本辅助定位 Hub 地址
## 显著优点
1. **原生协议支持**：直接对接 Dirigera 本地 API，无需依赖 IKEA Home smart 云服务，延迟更低且支持局域网离线控制
2. **自动化友好**：纯 Python 接口，可无缝集成 Home Assistant、Node-RED 等自动化平台
3. **设备覆盖全**：支持 Tradfri 全系灯具、Symfonisk 音箱控制器、智能插座及人体/光线传感器
4. **安全设计**：令牌生成强制要求物理按键确认，防止远程未授权访问
## 潜在局限
– **非官方 API**：基于逆向工程实现，存在 IKEA 固件更新后接口变更的风险
– **网络依赖**：Hub 与执行设备需同局域网，跨网络需自行搭建 Cloudflare Tunnel 等代理
– **令牌持久化**：令牌文件需妥善保管，无内置自动续期机制
– **硬件局限**：不支持 Dirigera 旧版网关（Tradfri Gateway），仅限第二代 Hub
## 适用人群
– 已部署 Dirigera Hub 的智能家居玩家
– 需要将 IKEA 设备集成至自定义自动化工作流的开发者
– 希望脱离手机 App 进行批量场景控制的进阶用户
## 常规风险提示
– 令牌文件（`dirigera_token.txt`）等同于设备控制权，建议设置文件权限 600 并排除在版本控制外
– 频繁调用可能导致 Hub 响应延迟，建议命令间隔 ≥500ms
– 物理按键授权流程必须人工在场，无法纯自动化部署
会员专属
