核心用法
openhue skill 是一个面向 Philips Hue 智能家居生态的 CLI 封装工具，通过调用 OpenHue 命令行工具与本地 Hue Bridge 通信，实现对灯光、房间、场景的全面控制。
初始化配置：首次使用需运行 openhue discover 发现局域网内的 Hue Bridge，随后执行 openhue setup 完成配对——此过程需要物理按下 Bridge 上的按钮以授权访问。配置完成后，所有认证信息本地存储，无需重复配对。
数据查询：支持以 JSON 格式导出当前灯光状态（openhue get light --json）、房间列表及场景配置，便于与其他自动化工具集成或进行状态监控。
设备控制：提供精细化的灯光操控能力，包括开关状态（--on//--off）、亮度调节（--brightness 0-100）、RGB 颜色设置（--rgb #RRGGBB），以及一键激活预设场景（openhue set scene <id>>）。当存在同名灯光时，可通过 --room` 参数指定房间以消除歧义。
显著优点
1. 零代码集成：纯文档化 skill 设计，无需编写任何代码即可将 Claude 与物理世界连接，大幅降低智能家居自动化门槛。
2. 官方工具背书：底层依赖 openhue.io 官方维护的开源 CLI，而非逆向工程或私有协议，兼容性与稳定性有保障。
3. 本地化隐私：所有通信局限于本地局域网，Hue Bridge 不连接外网，控制指令与设备状态不会上传至第三方云服务。
4. 声明式权限：通过 requires.bins 明确声明唯一依赖，权限边界清晰，无过度授权风险。
5. brew 标准分发：提供官方 Homebrew 安装渠道，版本管理与更新机制成熟可靠。
潜在缺点与局限性
- 硬件依赖刚性：必须拥有 Philips Hue Bridge 及配套灯具，无法兼容其他品牌 Zigbee 设备或直连灯泡。
- 网络环境限制：Bridge 与运行环境需处于同一局域网，不支持远程控制（除非额外配置 VPN 或 Hue 官方远程服务）。
- 功能覆盖边界：仅实现灯光控制核心功能，未涵盖 Hue 生态的高级特性如娱乐区域同步、传感器联动规则配置等。
- 命名冲突风险：多房间同名灯光需手动指定
--room参数，自然语言交互时可能因解析歧义导致误操作。
- T3 来源信任：skill 本身由社区开发者封装，虽无代码执行风险，但长期维护与更新依赖个人意愿。
适合的目标群体
- 智能家居爱好者：希望用自然语言替代手机 App 操作，实现"把客厅灯调暖一点"等直觉化控制。
- 开发者与极客：需要快速验证 Hue API 功能，或将灯光状态集成到更复杂的自动化工作流中。
- 无障碍需求用户：通过语音或文本指令控制物理环境，减少对传统开关的依赖。
- 家庭场景自动化：结合定时任务或传感器触发，实现起床唤醒、观影模式等场景化照明。
使用风险
- 物理设备误操作：灯光控制直接影响居住环境，自动化脚本或指令解析错误可能导致夜间意外开灯、会议中灯光变色等尴尬场景。
- 依赖项可用性：若 openhue CLI 未正确安装或版本不兼容，skill 将完全失效。建议锁定 brew 安装渠道，避免手动下载不明来源的二进制文件。
- Bridge 单点故障：Hue Bridge 离线或网络异常时，所有控制指令均无法执行，需保留传统开关作为 fallback。
- 权限持久化风险：Bridge 配对后的认证密钥本地存储，若运行环境被入侵，攻击者可控制家庭照明（虽无直接财产损失，但可能暴露居住状态）。