Dirigera Control (IKEA smart home)

核心功能

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

核心功能与定位

本 Skill 是专为 IKEA Dirigera 智能家居生态设计的本地化控制工具，支持灯光开关与调光调色、智能插座控制、场景触发、设备状态监控及电池电量查询等完整功能。其设计理念强调纯本地运行——所有通信仅通过 HTTPS 与本地网络内的 Dirigera Hub（端口 8443）进行，无云端依赖，符合隐私优先原则。

显著优点

1. 功能完整且精准：覆盖 Dirigera 生态全部核心能力，文档详尽包含 IP 发现、Token 生成、设备控制全流程，API 封装符合 Pythonic 习惯。

2. 安全认证可靠：CLS 认证等级 A（78 分），静态分析（85 分）与依赖审计（80 分）表现优异，无已知 CVE 漏洞。采用 OAuth PKCE 标准授权流程，令牌本地存储不外传。

3. 隐私合规优秀：明确遵循 GDPR 数据最小化原则，不采集用户敏感数据，所有设备控制数据均在本地闭环处理。

4. 运维辅助完善：提供 Hub IP 自动发现脚本、Token 生成包装器、批量操作辅助库等工程化工具，降低部署门槛。

潜在局限与风险

| 风险点 | 说明 | 严重程度 |

|--------|------|----------|

| 自签名证书验证禁用 | Dirigera Hub 使用自签名证书，代码中 `verify=False` 存在中间人攻击理论风险 | 中（已知设备限制） |

| 本地网络扫描行为 | IP 发现脚本默认扫描 /24 子网，共享网络环境可能触发安全警报 | 中 |

| 令牌明文存储 | 默认写入 `dirigera_token.txt`，依赖系统文件权限，建议手动设为 600 | 低 |

| 物理操作依赖 | Token 生成必须用户按压 Hub 底部按钮，无法全自动部署 | 体验成本 |

适合人群

• IKEA 智能家居用户：已购入 Dirigera 网关及配套灯具/传感器
• 本地自动化爱好者：追求无云端、低延迟的家居控制方案
• 开发者与极客：需通过 API 集成智能家居到自定义工作流
• 隐私敏感用户：拒绝将家居数据上传至厂商云服务

使用建议

1. 网络隔离：建议在受信任的家庭局域网内使用，避免公共 Wi-Fi 环境
2. 令牌保护：生成后立即执行 chmod 600 dirigera_token.txt
3. 版本锁定：安装时指定 pip install dirigera>=1.0.0 确保兼容性
4. 扫描范围限定：使用 --subnet 参数精确限定 IP 发现范围，避免过度扫描

综合评估

这是一款功能专一、文档完善、安全可信的本地化智能家居工具。虽因 IKEA 硬件限制存在证书验证等不可规避的中等风险，但整体设计成熟、代码质量高，适合目标用户群体放心使用。CLS A 级认证与 T3 来源可信度在个人开发者项目中属较好水平。