核心功能
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
- 物理按键授权流程必须人工在场，无法纯自动化部署